prefixkit Ask an engineerAsk Support RU

Error reference · Zigbee2MQTT

Zigbee2MQTT: Error while starting zigbee-herdsman

Error while starting zigbee-herdsman

What it means

Zigbee2MQTT could not talk to the coordinator stick and stopped.

Why it happens

  • Wrong serial port, or the port path changed after a reboot (/dev/ttyUSB0 ↔ /dev/ttyUSB1).
  • Wrong adapter type: zstack for TI CC2652 sticks, ember for Silicon Labs EFR32, deconz for ConBee.
  • The stick is busy: ZHA or another add-on already uses it.
  • Old or wrong firmware on the stick.

How to fix it

  1. Use the stable path: /dev/serial/by-id/usb-… (Settings → System → Hardware → All hardware).
  2. Set serial: adapter: to the type that matches the chip.
  3. Remove the stick from ZHA (or stop the other add-on) before starting Zigbee2MQTT.
  4. Update the coordinator firmware with the vendor’s flasher.

Useful tools

/zigbee-coordinator/

Other Zigbee2MQTT errors

Idea?