Geräteprofil · Beschattung

Becker CentralControl CC31 / CC41 / CC51

Hinweis: Becker veröffentlicht für die CentralControl keine Schnittstelle. Dieses Profil beruht auf der lokalen JSON-RPC-Schnittstelle der CentralControl. Zwei Punkte kann nur ein Test klären, siehe Hinweise.

Voraussetzungen

1. Eine eingerichtete Becker CentralControl CC31, CC41 oder CC51 im lokalen Netz, in der die Empfänger (Centronic, CentronicPLUS, B-Tronic) bereits angelernt und zu Gruppen zusammengefasst sind.
2. Die Gruppen-ID (group_id) der Gruppe, die in nomos erscheinen soll. Ein nomos Gerät entspricht genau einer Gruppe der CentralControl.
3. Ein nomos Controller mit einem Daemon, der die HTTP-Methode pro Befehl kennt (1.2.9 oder neuer) – die Schnittstelle arbeitet ausschließlich mit POST.

Gruppen-ID ermitteln

Die Oberfläche der CentralControl zeigt die IDs nicht an. Auf einem Rechner im selben Netz:

curl -s -H "Content-Type: text/plain" \
     -d '{"jsonrpc":"2.0","id":0,"params":{"list_type":"groups"},"method":"deviced.deviced_get_item_list"}' \
     http://<IP-der-CentralControl>/cgi-bin/cc51rpc.cgi

Die Antwort enthält je Gruppe item_id, name und device_type:

{"jsonrpc":"2.0","id":0,"result":{"item_list":[
  {"item_id":1,"item_type":"group","name":"Wohnzimmer Süd","device_type":"shutter"},
  {"item_id":2,"item_type":"group","name":"Küche","device_type":"venetian"}]}}

Die item_id ist die Gruppen-ID. Geeignet sind die Typen shutter, venetian, awning, screen, sun_sail und roof_window.

Einrichtung

1. Der CentralControl im Router eine feste IP-Adresse geben
2. Skills → Add-ons: Profil importieren
3. Je Gruppe ein Gerät anlegen und eintragen:
   • IP-Adresse der CentralControl
   • Port – Standard 80
   • GROUPID – die Gruppen-ID aus dem Schritt oben

Datenbereich

Abgefragt wird alle 30 Sekunden der Gruppenzustand (deviced.group_get_state); das Intervall lässt sich ändern. Die CentralControl meldet von sich aus nichts.

• Position (position) 0–100 %: 0 ist offen, 100 ist geschlossen – dieselbe Richtung wie in nomos
• Fährt (active): mindestens ein Empfänger der Gruppe fährt
• Störung (malfunction): die Gruppe meldet mindestens einen Fehler (error_flags nicht leer), z. B. ein Empfänger ohne Rückmeldung
• Anzahl der auf- und abfahrenden Empfänger sowie der Gruppenmodus (ausgeblendet)
• Erreichbarkeit (reachable): aus dem Erfolg der HTTP-Abfragen

Schreibbar sind Auf/Ab, Stop, die Position in 5-%-Schritten, die beiden Zwischenpositionen (Preset 1 und 2) und bei Jalousien die Lamellen um je einen Schritt (ausgeblendet).

Hinweise

• Zwei Punkte muss der erste Test klären. Die CentralControl erwartet über ihr eigenes Portal zwei Dinge, die ein Add-on-Profil nicht nachbilden kann:
  1. ein Null-Byte am Ende des JSON-Bodys. nomos sendet den Body ohne dieses Zeichen.
  2. die Kopfzeilen Origin: https://gw.b-tronic.net und Host: gw.b-tronic.net. nomos sendet die normalen Kopfzeilen für die lokale Adresse.

  Beides dürfte nur für den Weg über das Becker-Portal nötig sein. Antwortet die CentralControl auf einen Befehl aus nomos nicht oder mit einem Fehler, ist das die erste Stelle, an der zu suchen ist.

• Nur Gruppen, keine einzelnen Empfänger. Befehle gehen an group_send_command, wie in der CentralControl selbst. Eine Gruppe darf aus einem einzigen Empfänger bestehen.
• Jalousien: keine absolute Lamellenstellung. Die Schnittstelle kennt für Lamellen nur Schritte (step), keinen Winkelwert. Deshalb gibt es keine Lamellen-Anzeige, sondern nur die zwei Aktionen „einen Schritt offen” und „einen Schritt geschlossen”.
• Preset 2 bei Dachfenstern bedeutet laut Schnittstelle nicht eine Zwischenposition, sondern ein zeitgesteuertes Schließen.
• Keine Rückmeldung ohne Rückkanal. Centronic-Empfänger ohne Rückkanal melden ihre Position nicht; die CentralControl rechnet sie dann aus der Laufzeit. Nach einer Handbedienung am Sender kann die angezeigte Position daher von der tatsächlichen abweichen.
• Zwischen zwei Anfragen liegen 300 ms, damit das CGI der CentralControl nicht überfahren wird.
• Nicht im Profil enthalten: Dimmer-, Schalt- und Thermostatgruppen, Szenen (scene_invoke), Klimazonen, Sonnen-, Wind- und Regensensoren sowie das Auflisten der Gruppen aus nomos heraus.