Zigbee2MQTT Add-on 시작 문제점 설정 정리 (SLZB-06P10, Ethernet LAN 소켓 모드)

올려주신 로그 내용을 단계별로 정리하면 아래와 같습니다.

???? 실행 로그 흐름

1. 시작 준비

    

   [17:49:09] INFO: Preparing to start... [17:49:09] INFO: Socat not enabled [17:49:09] INFO: Starting Zigbee2MQTT... Starting Zigbee2MQTT without watchdog.

2. Zigbee2MQTT 기동

    

   [2025-10-02 17:49:11] info: z2m: Logging to console, file (filename: log.log) [2025-10-02 17:49:11] info: z2m: Starting Zigbee2MQTT version 2.6.1 (commit #unknown) [2025-10-02 17:49:11] info: z2m: Starting zigbee-herdsman (6.0.4)

3. 에러 발생 (zigbee-herdsman 시작 실패)

    

   [2025-10-02 17:49:11] error: z2m: Error while starting zigbee-herdsman [2025-10-02 17:49:11] error: z2m: Failed to start zigbee-herdsman [2025-10-02 17:49:11] error: z2m: Check https://www.zigbee2mqtt.io/guide/installation/20_zigbee2mqtt-fails-to-start_crashes-runtime.html for possible solutions [2025-10-02 17:49:11] error: z2m: Exiting...

4. 구체적 원인 (USB 어댑터 발견 실패)

    

   [2025-10-02 17:49:11] error: z2m: Error: USB adapter discovery error (No valid USB adapter found). Specify valid 'adapter' and 'port' in your configuration.

   (에러 stack trace 포함)

???? 요약된 문제점

• zigbee-herdsman 초기화 단계에서 실패

• 이유: 유효한 Zigbee USB 어댑터를 찾을 수 없음

• 원인 가능성

  • configuration.yaml 에 serial.port 와 adapter 값이 지정되지 않음

  • 잘못된 포트를 지정함 (USB 대신 Ethernet 소켓 장치 사용 시 tcp://IP:6638 을 넣어야 함)

  • 장치가 실제로 연결되지 않았거나 Home Assistant Add-on에서 인식 불가

???? 정리하면, 현재 Zigbee2MQTT가 SLZB-06P10을 USB로 찾으려 하고 있지만, 실제로는 LAN/Ethernet 장치이므로 USB 장치가 없어 실패하는 상황입니다.

???? 실행 로그 흐름

1. 시작 준비

    

   [17:49:09] INFO: Preparing to start... [17:49:09] INFO: Socat not enabled [17:49:09] INFO: Starting Zigbee2MQTT... Starting Zigbee2MQTT without watchdog.

2. Zigbee2MQTT 기동

    

   [2025-10-02 17:49:11] info: z2m: Logging to console, file (filename: log.log) [2025-10-02 17:49:11] info: z2m: Starting Zigbee2MQTT version 2.6.1 (commit #unknown) [2025-10-02 17:49:11] info: z2m: Starting zigbee-herdsman (6.0.4)

3. 에러 발생 (zigbee-herdsman 시작 실패)

    

   [2025-10-02 17:49:11] error: z2m: Error while starting zigbee-herdsman [2025-10-02 17:49:11] error: z2m: Failed to start zigbee-herdsman [2025-10-02 17:49:11] error: z2m: Check https://www.zigbee2mqtt.io/guide/installation/20_zigbee2mqtt-fails-to-start_crashes-runtime.html for possible solutions [2025-10-02 17:49:11] error: z2m: Exiting...

4. 구체적 원인 (USB 어댑터 발견 실패)

    

   [2025-10-02 17:49:11] error: z2m: Error: USB adapter discovery error (No valid USB adapter found). Specify valid 'adapter' and 'port' in your configuration.

   (에러 stack trace 포함)

???? 요약된 문제점

• zigbee-herdsman 초기화 단계에서 실패

• 이유: 유효한 Zigbee USB 어댑터를 찾을 수 없음

• 원인 가능성

  • configuration.yaml 에 serial.port 와 adapter 값이 지정되지 않음

  • 잘못된 포트를 지정함 (USB 대신 Ethernet 소켓 장치 사용 시 tcp://IP:6638 을 넣어야 함)

  • 장치가 실제로 연결되지 않았거나 Home Assistant Add-on에서 인식 불가

???? 정리하면, 현재 Zigbee2MQTT가 SLZB-06P10을 USB로 찾으려 하고 있지만, 실제로는 LAN/Ethernet 장치이므로 USB 장치가 없어 실패하는 상황입니다.

따라서 configuration.yaml에서 다음과 같이 LAN 소켓 방식으로 지정해야 합니다:

serial:
  port: tcp://SLZB_IP주소:6638
  adapter: zstack

따라서 configuration.yaml에서 다음과 같이 LAN 소켓 방식으로 지정해야 합니다:

# ===============================
# Zigbee2MQTT 기본 설정
# ===============================
data_path: /config/zigbee2mqtt   # Zigbee2MQTT 데이터 저장 경로 (디바이스 DB, 로그 등 저장)

# ===============================
# Socat 설정 (사용 안 함)
# ===============================
socat:
  enabled: false                 # socat 비활성화 (USB 대신 LAN 포트 직접 사용하므로 필요 없음)
  master: pty,raw,echo=0,link=/tmp/ttyZ2M,mode=777   # (미사용) 가상 직렬 포트 생성 옵션
  slave: tcp-listen:8488,keepalive,nodelay,reuseaddr,keepidle=1,keepintvl=1,keepcnt=5
  options: "-d -d"               # (미사용) socat 디버그 모드 옵션
  log: false                     # (미사용) socat 로그 비활성화

# ===============================
# MQTT 브로커 연결 설정
# ===============================
mqtt:
  base_topic: zigbee2mqtt        # Zigbee2MQTT가 MQTT에 publish 하는 기본 토픽 prefix
  server: mqtt://core-mosquitto:1883   # Home Assistant 내 Mosquitto broker 주소
  user: mqtt_user                # MQTT 사용자 계정
  password: mqtt_pass            # MQTT 비밀번호

# ===============================
# Zigbee 어댑터 (SLZB-06P10) 연결 설정
# ===============================
serial:
  port: tcp://192.168.0.115:6639 # SLZB-06P10 LAN IP + 포트
                                 # (기본값은 6638, 현재 장치에서 6639로 설정됨)
  baudrate: 115200               # 전송 속도 (LAN 모드에서는 의미 적음, 설정 유지 가능)
  adapter: zstack                # 어댑터 타입 (SLZB-06P10 = CC2652P 칩 기반 → zstack 사용)