가상화 계층의 관점에서 Bluetooth USB 어댑터는 특별하지 않습니다. 먼저 ZimaOS 호스트가 USB 장치를 인식해야 하며, 그다음 VM이 패스스루를 통해 해당 호스트 장치를 전달받아야 합니다. 호스트에서 장치를 확인할 수 없다면 게스트가 사용할 장치도 없습니다.
호스트 감지와 게스트 패스스루를 구분하세요
먼저 USB 어댑터가 호스트에 존재하는지 확인하세요. 호스트에서는 장치가 보이지만 VM 내부에서 보이지 않는다면 ZVM/libvirt 할당 계층을 확인해야 합니다. 호스트에 장치가 없다면 게스트 내부의 Home Assistant 설정을 변경해도 해결되지 않습니다.
USB 패스스루는 장치를 하나의 게스트에 제공합니다
공식 libvirt 호스트 장치 패스스루 문서는 호스트 장치 패스스루를 설명하며, 패스스루된 장치는 호스트와 실행 중인 게스트가 동시에 사용할 수 없다고 안내합니다. 게스트는 일반적으로 VM이 실행되는 동안 독점적으로 액세스해야 하므로 이는 Bluetooth 및 무선 동글에 특히 중요합니다.
가상 머신 요구 사항에는 현재 ZimaOS 가상화 및 패스스루 관련 내용이 설명되어 있으며, Home Assistant VM 설정에서는 Zigbee, Z-Wave 및 USB 무선 장치를 Home Assistant OS VM에 전달해야 하는 이유를 구체적으로 설명합니다.
Home Assistant 컨테이너와 HAOS VM은 서로 다릅니다
Home Assistant 요구 사항에서는 Home Assistant 컨테이너 배포와 HAOS를 구분합니다. 컨테이너에서는 하드웨어를 Docker에 매핑하지만, VM에서는 가상화 계층을 통해 USB 장치를 할당해야 합니다. 두 절차는 서로 바꿔 사용할 수 없습니다.
Home Assistant의 Home Assistant VM 옵션에는 컨테이너 설치와 별도로 VM 기반 설치 방법이 설명되어 있습니다. 따라서 먼저 현재 어떤 유형의 Home Assistant 설치를 사용 중인지 확인해야 합니다.
실용적인 문제 해결 순서
- USB Bluetooth 어댑터가 ZimaOS 호스트에 표시되는지 확인합니다.
- 인터페이스에서 장치 할당을 변경할 때 필요하다면 대상 VM을 종료합니다.
- 일반 USB 컨트롤러에만 의존하지 말고 올바른 USB 호스트 장치를 VM에 추가합니다.
- VM을 시작한 다음 게스트 내부에서 어댑터가 인식되는지 확인합니다.
- 재부팅 후 장치가 사라진다면 호스트 식별자가 변경되었는지 또는 다른 곳에서 장치를 점유했는지 다시 확인합니다.
결론
Home Assistant VM에서는 Bluetooth 동글을 USB 패스스루 장치로 취급해야 합니다. 먼저 호스트에서 장치가 인식되어야 하고, 그다음 ZVM/libvirt가 장치를 게스트에 할당해야 하며, 이후에야 Home Assistant가 장치를 사용할 수 있습니다. 제공된 스레드에는 별도의 ZimaOS “Bluetooth 활성화” 스위치가 있다는 근거가 없습니다.
