ioBroker Gira-Endpoint Adapter

Gira Endpoint Adapter

Der Gira-Endpoint-Adapter verbindet ioBroker über WebSocket (WS/WSS) mit einem Gira Homeserver.
Damit können Datenpunkte in Echtzeit zwischen dem Homeserver und ioBroker ausgetauscht werden.

So lassen sich Schaltzustände, Sensorwerte oder Szenen aus dem Gira-System nahtlos in ioBroker integrieren und dort weiterverarbeiten.

Features

• Verbindung über WebSocket (WS/WSS) (performant, spart unnötigen Overhead)
• Senden und Empfangen von verscheidenen Datenpunkten
• Echtzeitkommunikation für schnelle Automatisierungen
• Einfache Integration in bestehende Smart-Home-Szenarien
• Konfigurierbare Mappings zwischen beliebigen ioBroker States und Gira-Endpunkten, wahlweise in beide Richtungen
• Optionale 0/1 ↔ true/false-Umwandlung pro Mapping -> so wird aus einem 0/1 vom HS ein False / True für andere Zwecke
• Initiale Aktualisierung beim Adapterstart pro Endpunkt einzeln deaktivierbar
• Deaktivierte Initialaktualisierung bleibt auch nach Verbindungsabbrüchen erhalten

Usage

Eingabewerte können sein: true | false | toggle | String | Number

• true / false → werden zu 1 / 0 im HomeServer umgewandelt (wenn checkox aktiv)
• toggle → schaltet den aktuellen Wert im HomeServer um
• String und Number → werden direkt durchgereicht
• Bei den Mapping Endpunkten kann ein ioBroker Objekt (z.B. 0_userdata.0.mappingtest) eines anderen Adapters angegeben werden, das dann zum HS in das angegebene KO (CO@) durchgereicht wird. Hier kann die Richtung per Checkbos ausgewählt werden falls eine Richtung nicht bedient werden soll. Mehrere Zuordnungen lassen sich in der Admin-Oberfläche in Gruppen bündeln.

Homeserver konfigurieren

1. WebSocket in den Projekteinstellungen aktivieren

• In den Projekteinstellungen unter "KO-Gateway" den WebSocket aktivieren und dem WebSocket-Benutzer Zugriff erlauben.
• 

2. WebSocket-Benutzer anlegen

• Einen Benutzer z. B. websocket erstellen und ihm Lese- und Schreibrechte für die entsprechende Benutzergruppe zuweisen.
• 

3. Kommunikationsobjekte freigeben

• Bei jedem benötigten Kommunikationsobjekt die WebSocket-Gruppe sowohl für Lesen als auch Schreiben eintragen.
• 

Installation von (Github) Solange noch Beta

Bis der Adapter Offiziell ist: Im ioBroker unter Adapter auf den Expertenmodus schalten, Github anklicken und https://github.com/dosordie/ioBroker.gira-endpoint/ bei Benutzerdefiniert eintragen

Installation (lokal) Für test ect.

Per Tarball installieren 
# im Projektordner
cd ~/iobroker.gira-endpoint
git pull --ff-only
npm run build
npm pack                   # erzeugt z.B. iobroker.gira-endpoint-0.2.0.tgz

# ins ioBroker-Verzeichnis und dort installieren (als iobroker-User)
cd /opt/iobroker
sudo -u iobroker -H npm i --omit=dev ~/iobroker.gira-endpoint/iobroker.gira-endpoint-0.2.0.tgz

# Dateien hochladen & Instanz anlegen
iobroker upload gira-endpoint
## optional hinzufügen
#iobroker add gira-endpoint

💙 Unterstützung

Ich bastle an diesem Adapter in meiner Freizeit.
Wenn er dir gefällt oder dir weiterhilft, freue ich mich über eine kleine Spende:

Lizenz

GPLv3

Changelog

0.2.9

• Preserve case for CO@ endpoint object IDs
• Validate CO@/DA@ fields without prefixes in the admin UI

0.2.8

• Validate group names and show validation hints for endpoint fields in admin UI
• Add three-dot menu for objects

0.2.7

• Preserve skipInitialUpdate across reconnects

0.2.6

• Group simple endpoints in accordion

0.2.5

• Group mapping endpoints in accordion

0.2.4

• Use accordion for mapping endpoints in admin UI

0.2.3

• Align CO@ endpoint folder structure with DA@ and move subscription status into each endpoint

0.2.2

• Fix sending adapter states without "CO@" prefix to the HomeServer
• Warning - Subscription failed for CO@..., Also ad info.subscriptions

0.2.1

• Allow disabling initial update per endpoint on adapter start not releasd

0.2.0

• Added configurable mapping between ioBroker states and Gira endpoints

0.1.0

• Adapter basically working and tested

License

GNU General Public License v3.0

Grundlage

Der Adapter wurde nachgebaut auf Basis von:
👉 node-red-contrib-gira-endpoint

---