ConBee: Unterschied zwischen den Versionen

Aus FHEMWiki
(→‎Dokumentation und Setup: Setup Beschreibung erweitert)
K (diverse kleine Korrekturen)
Zeile 23: Zeile 23:
* Beschreibung der Parameter findet man versteckt im [https://github.com/dresden-elektronik/deconz-rest-plugin/wiki/deCONZ-command-line-parameters deconz Rest-Plugin Wiki]
* Beschreibung der Parameter findet man versteckt im [https://github.com/dresden-elektronik/deconz-rest-plugin/wiki/deCONZ-command-line-parameters deconz Rest-Plugin Wiki]
* Beschreibung der [https://github.com/marthoc/docker-deconz Containerinstallation] - aufschlussreich ist dort auch der Inhalt der start.sh.
* Beschreibung der [https://github.com/marthoc/docker-deconz Containerinstallation] - aufschlussreich ist dort auch der Inhalt der start.sh.
Das Setup erzeugt auf einem Pi mit Pi OS Lite 7 Services, die bis auf 2 alle disabled sind (<code>systemctl list-unit-files|grep deconz</code>).
Das Setup erzeugt auf einem Pi mit PiOS Lite sieben Services, die bis auf zwei alle disabled sind (<code>systemctl list-unit-files|grep deconz</code>).


Um den minimalen Dienst (deconz) in Betrieb zu nehmen sind noch folgende Schritte notwendig:
Um den minimalen Dienst (deconz) in Betrieb zu nehmen, sind noch folgende Schritte notwendig:
# Optionale Konfiguration (empfohlen): Die serielle Schnittstelle und das WEB-Port (Standard 80) einstellen (Siehe Problembehebung):
# Optionale Konfiguration (empfohlen): serielle Schnittstelle und WEB-Port (Standard: 80) einstellen (siehe Problembehebung)
# Start und Test: <code>sudo systemctl start deconz</code>, mit dem Browser Zugriff auf phoscon App testen http://gatewayIP:Portnummer
# Start und Test: <code>sudo systemctl start deconz</code>, mit dem Browser Zugriff auf Phoscon App testen: http://gatewayIP:Portnummer
# Funktioniert alles kann man den Service dauerhaft aktivieren: <code>sudo systemctl enable deconz</code>
# Funktioniert alles, kann man den Service dauerhaft aktivieren: <code>sudo systemctl enable deconz</code>
'''Hinweis''': Es gibt eine Ungereimtheit in der Beschreibung des Parameters '''''platform''''': es scheint aktuell (April 2021) egal zu sein, ob man <code>-platform minimal</code> oder <code>--platform minimal</code> verwendet.  
'''Hinweis''': Es gibt eine Ungereimtheit in der Beschreibung des Parameters '''''platform''''': es scheint aktuell (April 2021) egal zu sein, ob man <code>-platform minimal</code> oder <code>--platform minimal</code> verwendet.  


Mit der Phoscon Web-App kann man  
Mit der Phoscon Web-App kann man  
* Das Gateway verwalten, Firmware, Backup/Restore, Zeitzone, Sprache
* Das Gateway verwalten, Firmware, Backup/Restore, Zeitzone, Sprache
* Zigbee Geräte anmelden und verknüpfen, Scenen einrichten ...
* ZigBee Geräte anmelden und verknüpfen, Szenen einrichten ...
* Applikationen mit dem Gateway verbinden, dazu zählt auch das HUEBridge Device von FHEM
* Applikationen mit dem Gateway verbinden, dazu zählt auch das HUEBridge Device von FHEM
* Zugriff auf die alte WebApp erhalten (Hilfe Seite)
* Zugriff auf die alte WebApp erhalten (Hilfe Seite)
Um den Zugriff auf die deCONZ GUI zu erhalten muss man entweder das Setup auf einem Desktop System ausführen oder zusätzlich eine VNC Server installieren und den Dienst deconz-gui konfigurieren und aktivieren. Der Zugriff auf die GUI erfolgt mit einem VNC Viewer (RealVNC bietet eine portable Version).
:Um den Zugriff auf die deCONZ GUI zu erhalten, muss man entweder das Setup auf einem Desktop System ausführen oder zusätzlich einen VNC Server installieren und den Dienst deconz-gui konfigurieren und aktivieren. Der Zugriff auf die GUI erfolgt mit einem VNC Viewer (RealVNC bietet eine portable Version).


'''Achtung''': deconz.service und deconz-gui.service sind alternative Aufrufe der gleichen Binary - es kann nur einer von Beiden gestartet werden. Wer eine einfache Konfiguration möchte und sich mit docker auskennt sollte die docker Variante wählen.
'''Achtung''': deconz.service und deconz-gui.service sind alternative Aufrufe der gleichen Binary - es kann nur einer von Beiden gestartet werden. Wer eine einfache Konfiguration möchte und sich mit docker auskennt sollte die docker Variante wählen.
=== Problembehebung ===
=== Problembehebung ===
deCONZ verwendet offenbar beim Start auch per default die Schnittstelle /dev/ttyAMA0 (raspbee Modul). Die Kommunikation eines dort steckenden anderen Moduls wird dabei gestört.
deCONZ verwendet offenbar beim Start auch per default die Schnittstelle /dev/ttyAMA0 (raspbee Modul). Die Kommunikation eines dort steckenden anderen Moduls wird dabei gestört.
Zeile 59: Zeile 60:
* Die HUEBridge funktioniert (noch undokumentiert) auch mit Portangaben, falls nicht Standard Port 80 verwendet wird.
* Die HUEBridge funktioniert (noch undokumentiert) auch mit Portangaben, falls nicht Standard Port 80 verwendet wird.
* Der SSL Port wird im Modul von der API abgefragt und kann in der HUEBridge nicht extra angegeben werden. Dazu darf der SSL Port nicht extern umgemappt werden, sondern der deconz Service muss wissen, auf welchem Port er läuft.
* Der SSL Port wird im Modul von der API abgefragt und kann in der HUEBridge nicht extra angegeben werden. Dazu darf der SSL Port nicht extern umgemappt werden, sondern der deconz Service muss wissen, auf welchem Port er läuft.
* Die Bridge muss einmalig mit dem Gateway gepairt werden. Das FHEM Bridge Device erzeugt einen Key, in der Phoscon App muss man im Menüpunkt Gateway/erweitert/App verbinden wählen.
* Die Bridge muss einmalig mit dem Gateway gepairt werden. Das FHEM Bridge Device erzeugt einen Key, in der Phoscon App muss man im Menüpunkt Gateway/erweitert/App <code>verbinden</code> wählen.


== Links ==
== Links ==

Version vom 7. April 2021, 09:16 Uhr

Todo: Noch zu vervollständigen und zu verlinken

ConBee ist ein ZigBee USB Gateway (Interface), mit dem herstellerübergreifend ZigBee-Geräte bedient werden können. Unter der Bezeichnung RaspBee ist auch eine Variante als Raspberry Pi Modul erhältlich. Beide Geräte sind als ConBee II und RaspBee II in einer aktualisierten Version erhältlich. Im folgenden werden alle Version als ConBee bezeichnet und die Ausführungen gelten auch RaspBee; sofern es relevante Unterschiede gibt, wird das ausdrücklich erwähnt.

ConBee
frameless
Allgemein
Protokoll ZigBee
Typ Interface
Kategorie diverse Hersteller
Technische Details
Kommunikation Funk
Kanäle ?
Betriebsspannung 5V=
Leistungsaufnahme ?
Versorgung USB
Abmessungen ?
Sonstiges
Modulname HUEBridge.pm, HUEDevice.pm
Hersteller dresden elektronik, Vertrieb: Phoscon

Beschreibung

Das ConBee Gateway benötigt/hat keine Cloud-Anbindung. Eine Liste der kompatiblen ZigBee Geräte und Hersteller findet sich hier.

Dokumentation und Setup

Das Setup erzeugt auf einem Pi mit PiOS Lite sieben Services, die bis auf zwei alle disabled sind (systemctl list-unit-files|grep deconz).

Um den minimalen Dienst (deconz) in Betrieb zu nehmen, sind noch folgende Schritte notwendig:

  1. Optionale Konfiguration (empfohlen): serielle Schnittstelle und WEB-Port (Standard: 80) einstellen (siehe Problembehebung)
  2. Start und Test: sudo systemctl start deconz, mit dem Browser Zugriff auf Phoscon App testen: http://gatewayIP:Portnummer
  3. Funktioniert alles, kann man den Service dauerhaft aktivieren: sudo systemctl enable deconz

Hinweis: Es gibt eine Ungereimtheit in der Beschreibung des Parameters platform: es scheint aktuell (April 2021) egal zu sein, ob man -platform minimal oder --platform minimal verwendet.

Mit der Phoscon Web-App kann man

  • Das Gateway verwalten, Firmware, Backup/Restore, Zeitzone, Sprache
  • ZigBee Geräte anmelden und verknüpfen, Szenen einrichten ...
  • Applikationen mit dem Gateway verbinden, dazu zählt auch das HUEBridge Device von FHEM
  • Zugriff auf die alte WebApp erhalten (Hilfe Seite)
Um den Zugriff auf die deCONZ GUI zu erhalten, muss man entweder das Setup auf einem Desktop System ausführen oder zusätzlich einen VNC Server installieren und den Dienst deconz-gui konfigurieren und aktivieren. Der Zugriff auf die GUI erfolgt mit einem VNC Viewer (RealVNC bietet eine portable Version).

Achtung: deconz.service und deconz-gui.service sind alternative Aufrufe der gleichen Binary - es kann nur einer von Beiden gestartet werden. Wer eine einfache Konfiguration möchte und sich mit docker auskennt sollte die docker Variante wählen.

Problembehebung

deCONZ verwendet offenbar beim Start auch per default die Schnittstelle /dev/ttyAMA0 (raspbee Modul). Die Kommunikation eines dort steckenden anderen Moduls wird dabei gestört.

Hat man andere Module an AMA0 (UART GPIO) oder an den Standard USB Schnittstellen (ACM0 usw.), muss die Unit deconz.service mit den richtigen Schnittstellen Parametern konfiguriert werden. Am zuverlässigsten ist es, die Definition per ID einzutragen. Dazu bitte

sudo systemctl edit --full deconz

und die Zeile ExecStart um diesen Parameter ergänzten (Beispiel):

--dev=/dev/serial/by-id/usb-dresden_elektronik_ingenieurtechnik_GmbH_ConBee_II_DE1234567-if00

Der richtige Eintrag muss mit ls -lha /dev/serial/by-idabgefragt werden.

Grundsätzlich ist diese Art der Einbindung auch für alle seriellen Geräte in FHEM dringend anzuraten, wenn andere Services wie deconz auf demselben Server betrieben werden.

Unterstützung in FHEM

Info green.pngAlternativ kann man das Model ConBee II auch als Interface für zigbee2mqtt verwenden und dann die ZigBee-Geräte als MQTT2_DEVICE in FHEM einbinden.

ConBee wird über das Modul HUEBridge und über die deCONZ Software, die Wireless Light Control WebApp und die Phoscon WebApp (kommt zusammen mit deConz) in FHEM eingebunden.

Sensoren werden nicht automatisch erzeugt und müssen manuell angelegt werden.

Tipps:

  • Die HUEBridge funktioniert (noch undokumentiert) auch mit Portangaben, falls nicht Standard Port 80 verwendet wird.
  • Der SSL Port wird im Modul von der API abgefragt und kann in der HUEBridge nicht extra angegeben werden. Dazu darf der SSL Port nicht extern umgemappt werden, sondern der deconz Service muss wissen, auf welchem Port er läuft.
  • Die Bridge muss einmalig mit dem Gateway gepairt werden. Das FHEM Bridge Device erzeugt einen Key, in der Phoscon App muss man im Menüpunkt Gateway/erweitert/App verbinden wählen.

Links