Aus Sicht der Virtualisierungsebene ist ein Bluetooth-USB-Adapter nichts Besonderes: Zuerst muss der ZimaOS-Host das USB-Gerät erkennen, anschließend muss die VM dieses Host-Gerät per Passthrough erhalten. Wenn der Host es nicht sehen kann, gibt es für den Gast nichts zu übernehmen.
Host-Erkennung und Gast-Passthrough getrennt prüfen
Prüfen Sie zunächst, ob der USB-Adapter auf dem Host vorhanden ist. Wenn das Gerät dort sichtbar ist, aber in der VM fehlt, wechseln Sie zur ZVM-/libvirt-Zuweisungsebene. Ist es auf dem Host nicht vorhanden, können Änderungen an den Home-Assistant-Einstellungen im Gast das Problem nicht beheben.
USB-Passthrough weist das Gerät einem einzigen Gast zu
Die offizielle libvirt-Dokumentation zum Passthrough von Host-Geräten beschreibt das Passthrough von Host-Geräten und weist darauf hin, dass ein durchgereichtes Gerät nicht gleichzeitig vom Host und einem aktiven Gast verwendet werden kann. Das ist bei Bluetooth- und Funk-Dongles wichtig, da der Gast normalerweise exklusiven Zugriff benötigt, solange die VM läuft.
Die Anforderungen für virtuelle Maschinen bieten aktuellen Kontext zur ZimaOS-Virtualisierung und zum Passthrough. Die Einrichtung einer Home-Assistant-VM erklärt konkret, warum Zigbee-, Z-Wave- und USB-Funkgeräte an eine Home-Assistant-OS-VM durchgereicht werden müssen.
Home Assistant als Container und als HAOS-VM sind unterschiedlich
Die Home-Assistant-Anforderungen unterscheiden zwischen einer Home-Assistant-Container-Bereitstellung und HAOS. In einem Container wird die Hardware in Docker eingebunden; in einer VM muss das USB-Gerät über die Virtualisierungsebene zugewiesen werden. Die beiden Verfahren sind nicht austauschbar.
Die VM-Optionen von Home Assistant dokumentieren die Installation in einer VM getrennt von Container-Installationen. Deshalb sollten Sie zunächst bestätigen, welche Art von Home-Assistant-Installation Sie tatsächlich verwenden.
Praktische Reihenfolge zur Fehlerbehebung
- Bestätigen Sie, dass der USB-Bluetooth-Adapter auf dem ZimaOS-Host sichtbar ist.
- Fahren Sie die Ziel-VM herunter, bevor Sie die Gerätezuweisung ändern, falls die Oberfläche dies erfordert.
- Fügen Sie der VM das richtige USB-Host-Gerät hinzu, statt sich nur auf einen generischen USB-Controller zu verlassen.
- Starten Sie die VM und überprüfen Sie den Adapter im Gast.
- Wenn er nach einem Neustart verschwindet, prüfen Sie erneut, ob sich die Host-Kennung geändert hat oder das Gerät anderweitig beansprucht wird.
Fazit
Behandeln Sie den Bluetooth-Dongle in einer Home-Assistant-VM als USB-Passthrough-Gerät. Zuerst muss die Erkennung durch den Host funktionieren, danach muss ZVM/libvirt das Gerät dem Gast zuweisen, und erst dann kann Home Assistant es verwenden. Im Quellthread gibt es keinen Hinweis auf einen separaten ZimaOS-Schalter zum „Aktivieren von Bluetooth“.
