Ein paar Zigbee-Setupprobleme: Ich habe das in einige passende Communities cross-gepostet:
- Post in der LinuxContainers/Incus/IncusOS-Community
- Post in der Home Assistant-Community
- Zigbee2MQTT Diskussion auf GitHub
Ich habe überall alle Details aufgenommen, daher ist es recht lang – einfach für den Fall, dass es da jemanden unterstützen kann. Der Abschnitt „Fragen“ unten wird immer an die Fragen für diese Community angepasst.
Use case
Ich habe ein SLZB-Ultima-Gerät, das mehrere Chips für Zigbee, Matter usw. betreibt. Lassen wir zuerst Zigbee betrachten: Ich habe versucht, es per USB mit Home Assistant zu verbinden, das Zigbee2MQTT als App ausführt (also als eine App in einem Docker-Container; wird von Home Assistant aber „out of the box“ als „App“ bereitgestellt, [früher genannt add-on], daher erwarte ich keine Probleme.). Home Assistant OS läuft als VM auf IncusOS, also Virtualisierung via Incus. Ich habe das USB als Gerät an die VM weitergereicht und es dann in HA/Zigbee2MQTT „wie üblich“ konfiguriert.
Kurz gesagt ist der Stack so: Zigbee2MQTT → (Docker/HA-App) → Home Assistant OS → Incus → IncusOS
Was ich im Detail gemacht habe
-
Was die meisten Guides übersehen: Auf dem SLZB-Ultima den USB-Modus aktivieren. Gehe zu
/mode(die Hauptseite), und aktiviere den USB-Modus – dadurch wird der Netzwerkmodus deaktiviert. -
Ermitteln der Seriennummer des USB-Geräts: Das kannst du von einem anderen Gerät aus mit Tools wie
lsusb -voder ähnlichem machen.
Alternativ zeigen auch die Systemlogs (Web-Interface unter/ui/os/logs) den USB-Connect mit allen benötigten Details an. Danach kannst du die Seriennummer kopieren. -
Dann in IncusUI ein „Device“ konfigurieren („Devices“ → „Other“). Du willst offensichtlich USB-Geräte auswählen:
Das lässt sich prüfen/ist äquivalent zu:
\$ incus config show IncusOS:HAOS // .... devices: custom-device-1: attached: "true" serial: SLZB-Ultima****** type: usb(Ja, ich frage mich auch, warum
attachedein String-Typ ist, aber naja?) -
Jetzt kannst du z. B. mit
lsusbprüfen, dass die USB-Geräte tatsächlich auftauchen. Da es zwei serielle Schnittstellen bereitstellt, sind es offenbar zwei „Geräte“. Oder noch besser: Im Log-UI von IncusOS siehst du das auch:26. Juni, 17:46:04 localhost kernel: usb 2-6: New USB device found, idVendor=303a, idProduct=4002, bcdDevice= 1.00 26. Juni, 17:46:04 localhost kernel: usb 2-6: New USB device strings: Mfr=1, Product=2, SerialNumber=3 26. Juni, 17:46:04 localhost kernel: usb 2-6: Product: SMLIGHT SLZB-Ultima3 26. Juni, 17:46:04 localhost kernel: usb 2-6: Manufacturer: SMLIGHT 26. Juni, 17:46:04 localhost kernel: usb 2-6: SerialNumber: SLZB-Ultima**** -
Die Doku erklärt, wie man es dann konfiguriert, oder man nutzt das Onboarding-Web-UI in HomeAssistant.
Daher habe ich diesmal einfach das UI benutzt (und auch mit YAML ausprobiert – das hat keinen Unterschied gemacht):
Man kann auch sehen, dass es korrekt an die VM durchgereicht wird, wenn man in der VM prüft:
# lsusb
Bus 001 Device 001: ID 1d6b:0002 Linux 6.18.35-haos xhci-hcd xHCI Host Controller
Bus 002 Device 001: ID 1d6b:0003 Linux 6.18.35-haos xhci-hcd xHCI Host Controller
Bus 001 Device 002: ID 303a:**** SMLIGHT SMLIGHT SLZB-Ultima3
Bisher sieht das alles super aus und ich bin froh, dass es so gut funktioniert… aber eigentlich stimmt das nicht, denn es schlägt fehl.
Fehler für Gerät #0
Wenn ich es auswähle, um es mit /dev/ttyACM0 zu konfigurieren, kann es sich nicht einmal verbinden:
[2026-06-28 17:56:55] info: zh:zstack:znp: Skip bootloader for CC2652/CC1352
[2026-06-28 17:57:14] error: z2m: Error while starting zigbee-herdsman
[2026-06-28 17:57:14] error: z2m: Failed to start zigbee-herdsman
[2026-06-28 17:57:14] error: z2m: Check https://www.zigbee2mqtt.io/guide/installation/20_zigbee2mqtt-fails-to-start_crashes-runtime.html for possible solutions
[2026-06-28 17:57:14] error: z2m: Exiting...
[2026-06-28 17:57:14] error: z2m: Error: Failed to connect to the adapter (Error: SRSP - SYS - ping after 6000ms)
at ZStackAdapter.start (/app/node_modules/.pnpm/zigbee-herdsman@10.4.0/node_modules/zigbee-herdsman/src/adapter/z-stack/adapter/zStackAdapter.ts:95:27)
at Controller.start (/app/node_modules/.pnpm/zigbee-herdsman@10.4.0/node_modules/zigbee-herdsman/src/controller/controller.ts:146:29)
at Zigbee.start (/app/lib/zigbee.ts:70:27)
at Controller.start (/app/lib/controller.ts:117:29)
at start (/app/index.js:156:5)
Aber ich vermute auch, dass das das falsche Gerät/„Port“ ist – also der „Zigbee Router“ statt des „Zigbee Coordinators“ (vielleicht ist es auch umgekehrt?). Daher habe ich das der Vollständigkeit halber geprüft.
Fehler für Gerät #1
Wenn ich das /dev/ttyACM1-Device auswähle, bekomme ich komische PAN-ID-Fehler:
Onboarding page is available at http://0.0.0.0:8099/
[2026-06-28 17:52:29] info: z2m: Logging to console, file (filename: log.log)
[2026-06-28 17:52:29] info: z2m: External JS (converters/extensions) is disabled
[2026-06-28 17:52:29] info: z2m: Starting Zigbee2MQTT version 2.12.0 (commit #unknown)
[2026-06-28 17:52:29] info: z2m: Starting zigbee-herdsman (10.4.0)
[2026-06-28 17:52:29] info: zh:zstack:znp: Opening SerialPort with {"path":"/dev/ttyACM1","baudRate":115200,"rtscts":false,"autoOpen":false}
[2026-06-28 17:52:29] info: zh:zstack:znp: Serialport opened
[2026-06-28 17:53:30] error: z2m: Error while starting zigbee-herdsman
[2026-06-28 17:53:30] error: z2m: Failed to start zigbee-herdsman
[2026-06-28 17:53:30] error: z2m: Check https://www.zigbee2mqtt.io/guide/installation/20_zigbee2mqtt-fails-to-start_crashes-runtime.html for possible solutions
[2026-06-28 17:53:30] error: z2m: Exiting...
[2026-06-28 17:53:30] error: z2m: Error: network commissioning timed out - most likely network with the same panId or extendedPanId already exists nearby (Error: AREQ - ZDO - stateChangeInd after 60000ms
at Object.start (/app/node_modules/.pnpm/zigbee-herdsman@10.4.0/node_modules/zigbee-herdsman/src/utils/waitress.ts:68:23)
at ZnpAdapterManager.beginCommissioning (/app/node_modules/.pnpm/zigbee-herdsman@10.4.0/node_modules/zigbee-herdsman/src/adapter/z-stack/adapter/manager.ts:376:31)
at ZnpAdapterManager.start (/app/node_modules/.pnpm/zigbee-herdsman@10.4.0/node_modules/zigbee-herdsman/src/adapter/z-stack/adapter/manager.ts:90:21)
at ZStackAdapter.start (/app/node_modules/.pnpm/zigbee-herdsman@10.4.0/node_modules/zigbee-herdsman/src/adapter/z-stack/adapter/zStackAdapter.ts:135:16)
at Controller.start (/app/node_modules/.pnpm/zigbee-herdsman@10.4.0/node_modules/zigbee-herdsman/src/controller/controller.ts:146:29)
at Zigbee.start (/app/lib/zigbee.ts:70:27)
at Controller.start (/app/lib/controller.ts:117:29)
at start (/app/index.js:156:5))
at ZnpAdapterManager.beginCommissioning (/app/node_modules/.pnpm/zigbee-herdsman@10.4.0/node_modules/zigbee-herdsman/src/adapter/z-stack/adapter/manager.ts:378:23)
at ZnpAdapterManager.start (/app/node_modules/.pnpm/zigbee-herdsman@10.4.0/node_modules/zigbee-herdsman/src/adapter/z-stack/adapter/manager.ts:90:21)
at ZStackAdapter.start (/app/node_modules/.pnpm/zigbee-herdsman@10.4.0/node_modules/zigbee-herdsman/src/adapter/z-stack/adapter/zStackAdapter.ts:135:16)
at Controller.start (/app/node_modules/.pnpm/zigbee-herdsman@10.4.0/node_modules/zigbee-herdsman/src/controller/controller.ts:146:29)
at Zigbee.start (/app/lib/zigbee.ts:70:27)
at Controller.start (/app/lib/controller.ts:117:29)
at start (/app/index.js:156:5)
Hinweis: Ich habe diese Buttons bereits ausprobiert, um die IDs neu zu generieren (sie sollten also zufällig sein):
Ich habe diesen Thread gefunden, aber der scheint sich auch nur darum zu drehen, zufällige IDs neu zu generieren.
Das ist ein neues Zigbee-Netzwerk, daher habe ich weder eine Migration noch vorhandene Netzwerk-/PAN-IDs – und ich sollte das auch nicht benötigen.
Ich habe mit dem SLZB noch herumprobiert und den zweiten Chip auf „Hub mode“ gestellt, aber ja … nur für grundlegende Funktionstests, denn ich möchte das in Home Assistant integrieren
SLZB-Konfiguration
Soweit ich weiß, ist das die korrekte Konfiguration für das SLZB:
- ein Chip als Zigbee Coordinator
- und ein Chip als Zigbee Router
- und, da ich USB nutzen möchte, den USB-Modus aktivieren
Ich habe auch Zigbee-Netzwerk-IDs usw. in /zhub/config (Zigbee Hub → Settings). Ich bin mir aber unsicher, ob diese mit Zigbee2MQTT synchron sein müssen? (im Gegensatz zu allen anderen Hub-Einstellungen kann ich diese Seite zugreifen, ohne dass Hub mode aktiviert ist – daher ist das irgendwie verwirrend)
Fragen
Mache ich hier etwas falsch? Gibt es noch etwas, das man ausprobieren kann?
Ich habe natürlich keine dedizierte USB-Karte, wie dieser Thread vorschlägt. Und ja, ich würde die Option über LAN probieren, falls alles fehlschlägt – aber ich nehme an, USB sollte auch funktionieren und deutlich weniger Overhead/ Latenz bieten.
System
SLZB OS: v3.3.1
Zigbee-Coordinator Firmware-Revision: 20250212
Zigbee-Router Firmware-Revision: 20240716
incus 202606230053
Home Assistant v2026.6.4
Home Assistant OS: 18.0
| Radio 1 [EFR32MG24] Mode | Zigbee coordinator |
|---|---|
| Radio 2 [CC2674P10] Mode | Zigbee router |
| Connection mode: | USB mode |






