Un adaptador USB Bluetooth no tiene nada de especial desde el punto de vista de la capa de virtualización: primero el host ZimaOS debe enumerar el dispositivo USB y, después, la máquina virtual debe recibir ese dispositivo del host mediante passthrough. Si el host no puede verlo, no hay nada que el invitado pueda reclamar.
Separa la detección del host del passthrough al invitado
Empieza comprobando si el adaptador USB existe en el host. Si el dispositivo es visible allí, pero no aparece dentro de la máquina virtual, pasa a la capa de asignación de ZVM/libvirt. Si no está presente en el host, cambiar la configuración de Home Assistant dentro del invitado no lo solucionará.
El passthrough USB entrega el dispositivo a un solo invitado
La documentación oficial de passthrough de dispositivos del host de libvirt describe este mecanismo y señala que un dispositivo pasado mediante passthrough no puede ser utilizado simultáneamente por el host y por un invitado activo. Esto es importante para los dongles Bluetooth y de radio, porque normalmente el invitado necesita acceso exclusivo mientras la máquina virtual está en ejecución.
Los requisitos de las máquinas virtuales ofrecen el contexto actual sobre la virtualización y el passthrough en ZimaOS, mientras que la configuración de Home Assistant en una máquina virtual explica específicamente por qué Zigbee, Z-Wave y las radios USB deben pasarse a una máquina virtual con Home Assistant OS.
El contenedor de Home Assistant y la máquina virtual HAOS son diferentes
Los requisitos de Home Assistant distinguen entre un despliegue de Home Assistant en contenedor y HAOS. En un contenedor, el hardware se asigna a Docker; en una máquina virtual, el dispositivo USB debe asignarse a través de la capa de virtualización. Los dos procedimientos no son intercambiables.
Las opciones de Home Assistant para máquinas virtuales documentan por separado las rutas de instalación basadas en máquinas virtuales y las instalaciones en contenedores, por lo que primero debes confirmar qué tipo de instalación de Home Assistant estás utilizando realmente.
Orden práctico para solucionar problemas
- Confirma que el adaptador USB Bluetooth sea visible en el host ZimaOS.
- Apaga la máquina virtual de destino antes de cambiar la asignación del dispositivo si la interfaz lo requiere.
- Añade a la máquina virtual el dispositivo USB correcto del host en lugar de depender únicamente de un controlador USB genérico.
- Inicia la máquina virtual y verifica el adaptador dentro del invitado.
- Si desaparece después de reiniciar, vuelve a comprobar si cambió el identificador del host o si el dispositivo fue reclamado en otro lugar.
En resumen
Para una máquina virtual con Home Assistant, trata el dongle Bluetooth como un dispositivo USB que requiere passthrough. Primero debe funcionar la detección en el host; después, ZVM/libvirt debe asignar el dispositivo al invitado, y solo entonces Home Assistant podrá utilizarlo. En el hilo original no hay pruebas de que exista un interruptor independiente de ZimaOS para «activar el Bluetooth».
