En Samba-delning kan inte skicka en fysisk Zigbee-adapter till HAOS
Det ursprungliga problemet gäller en seriell USB-enhet, inte en mapp. En Samba-delning kan exponera filer för en virtuell maskin, men den kan inte få en ConBee-, Sonoff-, Nortek- eller liknande radioenhet att visas som USB-hårdvara i gästen. Den fungerande lösningen i communityt ansluter värdens USB-enhet till ZVM-gästen via libvirt.
Detta är fortfarande en kommandoradsbaserad lösning och inte en bekräftad ZVM-väljare för USB-enheter. Säkerhetskopiera den virtuella maskinens XML och stäng av Home Assistant OS innan du redigerar den permanenta hårdvarukonfigurationen. En felaktig XML-redigering eller en saknad dongel kan hindra gästen från att starta, så behåll en kopia som kan återställa den tidigare konfigurationen.
Identifiera dongeln utan att kopiera någon annans ID:n
Anslut till ZimaOS via den stödda SSH- och behörighetsvägen och kör sedan lsusb. Leta reda på dongelns leverantörs- och produktpar, till exempel 1a86:55d4 i exemplet. ID:na för din ConBee-, Sonoff- eller Nortek-enhet kommer att vara annorlunda.
Koppla från och anslut dongeln igen en gång om listan är tvetydig. Matchning via leverantör och produkt kan också vara tvetydig när två identiska adaptrar är anslutna. libvirts format för värdenheter beskriver matchning via VID/PID och mer specifik USB-adressering.
Notera den virtuella maskinens exakta libvirt-namn eller UUID med virsh list --all. Använd inte ett exempel-ID från tråden. Exportera den aktuella definitionen med virsh dumpxml VM_NAME innan du ändrar den.
Lägg till ett hostdev-block i gästens enhetssektion
Öppna definitionen med virsh edit VM_NAME när gästen är avstängd. Lägg till <hostdev mode='subsystem' type='usb' managed='yes'><source><vendor id='0xVID'/><product id='0xPID'/></source></hostdev> i det befintliga elementet <devices> och ersätt VID och PID med värdena från din värd.
Lägg till ett komplett hostdev-avsnitt per fysisk enhet. Skapa inte en andra omslutning med <devices> och klistra inte in blocket efter den avslutande taggen </devices>. Spara och kontrollera sedan XML-koden igen innan du startar den virtuella maskinen.
Starta gästen och kontrollera virsh list --all. Om det misslyckas läser du det första libvirt-felet. Återställ den sparade XML-koden i stället för att lägga till fler ändringar. Resultatet ”device not found” pekar på värdens enhetsidentifiering eller matchning, medan ett XML-tolkningsfel pekar på placering eller syntax.
Verifiera enheten i HAOS innan du ändrar Zigbee2MQTT
Öppna Inställningar → System → Hårdvara i Home Assistant och leta efter den nya USB- eller serieenheten. Gränssnittsnamn som /dev/ttyACM0 kan ändras. När HAOS visar en post av typen /dev/serial/by-id/... använder du den stabila identiteten i Zigbee2MQTT.
Först när HAOS ser enheten ska du ange Zigbee2MQTT:s serial.port. Starta om tillägget och kontrollera loggen efter en lyckad adapteranslutning. Om HAOS ser dongeln men Zigbee2MQTT inte kan öppna den fungerar genomkopplingen redan, och felet har flyttats till adaptertyp, seriell konfiguration eller åtkomst för tillägget.
Starta om HAOS och starta sedan om ZimaOS för att testa att konfigurationen består. Bekräfta att samma by-id-sökväg kommer tillbaka och att Zigbee2MQTT återansluter. ZVM-resursändringar kan skriva över manuell XML i vissa versioner, så kontrollera XML-koden igen efter att du har ändrat processor, minne eller diskar eller uppgraderat plattformen.
Vanliga frågor
Var lagras XML-filen?
Du behöver inte hitta en fil manuellt. Använd virsh edit VM_NAME för att redigera den registrerade domändefinitionen och virsh dumpxml för att säkerhetskopiera den.
Kan flera USB-enheter skickas till samma virtuella maskin?
Ja, tråden visar ett hostdev-block per enhet. Varje block måste matcha avsedd hårdvara utan tvetydighet.
Varför ändrades USB-sökvägen efter omstart?
Korta enhetsnamn kan ändras när Linux identifierar hårdvara. Föredra HAOS-sökvägen med by-id efter genomkopplingen, men kontrollera XML-koden igen om hela enheten försvinner.
De HAOS-specifika kommandona och det senare XML-exemplet finns i diskussionen om USB-delning på ZVM.
