소프트웨어/Home Assistant

[Zigbee2MQTT] 2025년 업데이트 이후 502 Bad Gateway 에러

충무로술겜마 2025. 1. 7. 00:08

삽질 기록용으로 작성합니다.

 

 

어제부터 Zigbee2MQTT addon이 제대로 작동하지 않음을 알았습니다.

 

오늘 시간이 좀 나서, addon 페이지의 로그를 확인했습니다.

Error: USB adapter discovery error (No valid USB adapter found). Specify valid 'adapter' and 'port' in your configuration.

 

https://www.zigbee2mqtt.io/guide/configuration/adapter-settings.html

 

Adapter settings | Zigbee2MQTT

In case Zigbee2MQTT cannot automatically detect your adapter (fails to start with: USB adapter discovery error (No valid USB adapter found). Specify valid 'adapter' and 'port' in your configuration.) we need to configure the serial section in the configura

www.zigbee2mqtt.io

일단 USB 어댑터가 꽂혀있다는 전제 하,

 

ls -l /dev/serial/by-id 명령어를 통해 해당 어댑터 이름을 알 수 있습니다.

이렇게해서 알아낸 이름을, zigbee2mqtt/configuration.yaml 파일 내부에 추가해줍니다.

 

serial:
  # https://www.zigbee2mqtt.io/guide/configuration/adapter-settings.html#basic-configuration
  # Location of the adapter
  # USB adapters - use format "port: /dev/serial/by-id/XXX"
  # Ethernet adapters - use format "port: tcp://192.168.1.12:6638"
  port: /dev/serial/by-id/usb-Texas_Instruments_TI_CC2531_USB_CDC___0X00124B0014D9
  # Adapter type, allowed values: `zstack`, `ember`, `deconz`, `zigate` or `zboss`
  adapter: zstack

 

제 경우에는, 이상한 어댑터 포트가 기존에 작성되어 있었는데, 어떻게 잘 작동하고 있었는지 의문이네요;; 왜 된거지?

 

암튼 이렇게 수정하면 제대로 어댑터를 물고 애드온 시작이 가능해집니다!

 

 

저만 이렇게 문제가 생긴건 아닌지, 에러에도 2 버전 업데이트 이후에 발생하는 문제면

https://github.com/koenkk/zigbee2mqtt/discussions/24364

 

Z2M 2.0.0: `USB adapter discovery error (No valid USB adapter found)` · Koenkk zigbee2mqtt · Discussion #24364

TL;DR Add adapter (likely zstack, see docs for more info) to your Zigbee2MQTT configuration.yaml, example: serial: port: /dev/ttyACM0 adapter: zstack # <-- Add this line What changed? Koenkk/zigbee...

github.com

를 참고해보라고 하네요.

 

도움이 되었으면 좋겠습니다.