Para ativar uma porta USB em uma VM do Home Assistant no Proxmox, você precisa realizar um processo chamado USB Passthrough (Passagem de USB). Isso permite que o hardware físico (como um dongle Zigbee, Z-Wave ou Bluetooth) seja “entregue” diretamente para o sistema operacional do HA.
Conecte o dispositivo e identifique-o no Proxmox
Antes de configurar a VM, certifique-se de que o Proxmox reconheceu o hardware.
No console do Proxmox (o nó principal, não a VM), digite:
lsusbVocê verá uma lista. Procure pelo seu dispositivo (ex: Sonoff Zigbee 3.0 ou Silicon Labs). Anote o ID (ex: 10c4:ea60).
Adicionar o Hardware à VM do Home Assistant
Na interface web do Proxmox, selecione a VM do Home Assistant na barra lateral.
Clique na aba Hardware.
Clique no botão Add (Adicionar) no topo e selecione USB Device.
Escolher o modo de conexão
Você terá duas opções principais na janela que abrir:
Use USB Vendor/Device ID: Recomendado se você sempre conectará o dispositivo, mesmo que mude de porta física. Ele busca pelo “modelo” do chip.
Use USB Port: Recomendado se você tem vários dispositivos idênticos. Ele trava na porta física (ex: porta 1 do painel traseiro).
Dica: Marque a opção USB3 apenas se o seu dispositivo for comprovadamente USB 3.0 (azul). Para dongles Zigbee/Z-Wave, deixe desmarcado para evitar interferências.
Selecione o dispositivo na lista e clique em Add.
Reconhecimento no Home Assistant
Após adicionar o hardware no Proxmox, o Home Assistant deve reconhecê-lo quase instantaneamente.
Vá para o seu Home Assistant.
Vá em Configurações > Dispositivos e Serviços.
Muitas vezes, uma nova integração (como ZHA ou Zigbee2MQTT) aparecerá com o botão Configurar.
Nota Crítica: Se você estiver usando o Zigbee2MQTT, o caminho do dispositivo geralmente mudará para algo como /dev/ttyUSB0 ou /dev/serial/by-id/…. É altamente recomendável usar o caminho por ID, pois ele não muda se você reiniciar o servidor.
Resolução de Problemas (Troubleshooting)
Dispositivo não aparece: Se o dispositivo não for listado no lsusb, teste outra porta ou um cabo extensor USB (muito comum em notebooks como o seu Legion, onde as portas são muito próximas e geram interferência).
Erro de permissão: Se o HA ver o dispositivo mas não conseguir ler, pode ser necessário reiniciar a VM (Full Reboot) para que o Proxmox ancore o driver corretamente.
LXC vs VM: Se o seu Home Assistant estiver em um Container (LXC) em vez de uma VM, o processo é diferente e exige editar arquivos de texto no Proxmox (/etc/pve/lxc/ID.conf).