Z2M 2.0.0: USB adapter discovery error (No valid USB adapter found)

[Koenkk]

TL;DR

Add adapter (likely zstack, see docs for more info) to your Zigbee2MQTT configuration.yaml, example:

serial:
  adapter: zstack # <-- Add this line
  port: /dev/ttyACM0

What changed?

Koenkk/zigbee-herdsman#1197 brings improvements to the adapter discovery feature. This feature allows Zigbee2MQTT to automatically detect your adapter (preventing the need for a serial section in configuration.yaml).

In case Zigbee2MQTT could not automatically detect the type of adapter, it would default to zstack. This gives issues to people using other adapters. When not specifying the adapter and when using e.g. an EZSP adapter, Zigbee2MQTT will fail to start with Error: SRSP - SYS - ping after 6000ms instead of a clear error message. This behaviour has now been changed. Starting from 1.41.0, in case Zigbee2MQTT cannot automatically detect your adapter, you have to explicitly specify the serial port and adapter.

This change in behaviour has 1 drawback. In case Zigbee2MQTT defaulted to zstack before in your setup, it will now fail to start with USB adapter discovery error (No valid USB adapter found). Specify valid 'adapter' and 'port' in your configuration.. This can be fixed by adding adapter: zstack to your Zigbee2MQTT configuration.yaml as described above.

The full documentation can be found here.

[sammyke007]

FYI, this is the correct link to the docs:

https://github.com/Koenkk/zigbee2mqtt.io/blob/master/docs/guide/configuration/adapter-settings.md

[Koenkk]

fixed, thanks!

[gklank]

Hi,

I don't get it running in docker...
--> z2m: Error: Cannot discover TCP adapters at this time. Specify valid 'adapter' and 'port' in your configuration.

I used the docker image: "koenkk/zigbee2mqtt:latest-dev"
and

serial:
port: 'tcp://192.168.1.16:20108'

H/W: CC26X2R1 + USR-TCP232-T2 Serial TTL to Ethernet

Any tipps?

Regards

Gerhard

[upandabout]

OK, I dont get it, I allready have an adapter installed, it was working, the update messed it all up, I tried adding the line:
adapter: zstack # <-- Add this line
With out "<-- Add this line"
It did not fix it.
Right now this part of my zigbee2mqtt configuration yaml is looking like this and it's not helping:

serial:
  port: >-
    /dev/serial/by-id/usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_16937884d19ded11887ecfa5a7669f5d-if00-port0
    adapter: zstack #

[djurny]

Hi @upandabout,
Rewrite it as follows:

serial:
    adapter: zstack
    port: /dev/serial/by-id/usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_16937884d19ded11887ecfa5a7669f5d-if00-port0

The indentation matters a lot in YAML. (port and adapter need to be aligned with same amount of leading whitespace.)
Grt,

[upandabout]

Will try it, the way you put it.
For the record, I only changed the line that said change this line. I have no coding knowledge, as you imeadetly spotted :-D So in my deffence I don't think I had any chance of knowing to change the other line, when it clearly said to only change that line.
Thanks for helping out. 👍

[upandabout]

And once again thanks, it's now working again. 💯 👍 :-)

[Buzon02]

serial:
adapter: zstack
port: /dev/serial/by-id/usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_16937884d19ded11887ecfa5a7669f5d-if00-port0

you don't know me but after hours and hours of trying to fix my issues, this helped me. i owe you!!!! thankyou.

[gklank]

Hi,

Thx for answering soon.

But I did the configuration as described in the docu as shown in my description above.

serial:
port: 'tcp://192.168.1.16:20108'

So that shouldn't be the issue
Any other ideas?

Regards

Gerhard

[Koenkk]

Adapter should also be present under the serial config, you only have port there

[gklank]

got it after hours of searching...

the additional part of serial: with "adapter: zstack" was not easy to find.

May be about my english capabilities...
But a piece more in the documentation would be helpful.

Thank you and regards

Gerhard

[MSL-DA]

I think everything is well described ... so well that it's better than you can expect.

https://www.zigbee2mqtt.io/guide/adapters/

[Goz2K]

Hi I am wondering if you can help ?

Zigbee2MQTT fails to start now ...

Here is the following from the log ...

Starting Zigbee2MQTT without watchdog.
[03:11:29] INFO: Preparing to start...
[03:11:29] INFO: Socat not enabled
[03:11:30] INFO: Starting Zigbee2MQTT...
Starting Zigbee2MQTT without watchdog.
[2025-01-04 03:12:12] error: z2m: Error while starting zigbee-herdsman
[2025-01-04 03:12:12] error: z2m: Failed to start zigbee-herdsman
[2025-01-04 03:12:12] error: z2m: Check https://www.zigbee2mqtt.io/guide/installation/20_zigbee2mqtt-fails-to-start_crashes-runtime.html for possible solutions
[2025-01-04 03:12:12] error: z2m: Exiting...
[2025-01-04 03:12:12] error: z2m: Error: USB adapter discovery error (No valid USB adapter found). Specify valid 'adapter' and 'port' in your configuration.
at discoverAdapter (/app/node_modules/.pnpm/[email protected]/node_modules/zigbee-herdsman/src/adapter/adapterDiscovery.ts:523:15)
at processTicksAndRejections (node:internal/process/task_queues:105:5)
at Function.create (/app/node_modules/.pnpm/[email protected]/node_modules/zigbee-herdsman/src/adapter/adapter.ts:68:33)
at Controller.start (/app/node_modules/.pnpm/[email protected]/node_modules/zigbee-herdsman/src/controller/controller.ts:132:24)
at Zigbee.start (/app/lib/zigbee.ts:69:27)
at Controller.start (/app/lib/controller.ts:142:13)
at start (/app/index.js:161:5)
[2025-01-04 03:12:12] error: z2m: If this happens after updating to Zigbee2MQTT 2.0.0, see #24364

My configuration.yaml has the following specified ...

serial:
port: >-
/dev/serial/by-id/usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_129149266cafed11b8ee374e71c9e8b5-if00-port0
adapter: zstack

But it still fails to start ? Any help would be appreciated.

[H7ukka]

Had same error with same adapter.
Turned out, it was script format error.
"adapter: zstack" has to be placed correctly in the script

[Goz2K]

Thanks @H7ukka. It turns out it was a placement, indentation, formatting issue in my config it should have been as follows

I now have the issue that my Hue occupancy sensors now no longer report lux levels on the dashboard, which is no biggie on the dashboard side of things, but something is off with my NodeRed flows when it comes to switching on and off lamps. I wrote a flow to automatically set dimmer value on a light and switch it on or off depending on feedback from the occupancy sensor. It appears to report illuminance in NodeRed so there's probably something funky going on that I will need to debug when I get a bit more time.

[Ruta40Patagonia]

adapter: zstack

It worked for me.. Thanks

[g1pete]

@Goz2K , thanks for posting that code snippet, that is exactly what I had todo today to get my Zigbee running again after the update this morning

[JohnnycUK]

adapter: zstack

this worked for me aswell.

[jason1980p]

Please help! My Zigbee2Mqtt if failing after latest update

Using '/app/data' as data directory
Starting Zigbee2MQTT without watchdog.
[2025-01-03 23:28:18] info: z2m: Logging to console, file (filename: log.log)
[2025-01-03 23:28:18] info: z2m: Starting Zigbee2MQTT version 2.0.0 (commit #060ae99cff715cc9ef6a0cfa7cae0cdcb17f0c8a)
[2025-01-03 23:28:18] info: z2m: Starting zigbee-herdsman (3.2.1)
[2025-01-03 23:28:19] error: z2m: Error while starting zigbee-herdsman
[2025-01-03 23:28:19] error: z2m: Failed to start zigbee-herdsman
[2025-01-03 23:28:19] error: z2m: Check https://www.zigbee2mqtt.io/guide/installation/20_zigbee2mqtt-fails-to-start_crashes-runtime.html for possible solutions
[2025-01-03 23:28:19] error: z2m: Exiting...
[2025-01-03 23:28:19] error: z2m: Error: USB adapter discovery error (No valid USB adapter found). Specify valid 'adapter' and 'port' in your configuration.
at discoverAdapter (/app/node_modules/.pnpm/[email protected]/node_modules/zigbee-herdsman/src/adapter/adapterDiscovery.ts:523:15)
at processTicksAndRejections (node:internal/process/task_queues:105:5)
at Function.create (/app/node_modules/.pnpm/[email protected]/node_modules/zigbee-herdsman/src/adapter/adapter.ts:68:33)
at Controller.start (/app/node_modules/.pnpm/[email protected]/node_modules/zigbee-herdsman/src/controller/controller.ts:132:24)
at Zigbee.start (/app/lib/zigbee.ts:69:27)
at Controller.start (/app/lib/controller.ts:142:13)
at start (/app/index.js:161:5)
[2025-01-03 23:28:19] error: z2m: If this happens after updating to Zigbee2MQTT 2.0.0, see #24364

[anhnvme]

Don't you know read ?

[khoanong]

error after update :
[2025-01-04 12:19:45] error: z2m: If this happens after updating to Zigbee2MQTT 2.0.0, see #24364
[12:21:44] INFO: Preparing to start...
[12:21:44] INFO: Socat not enabled
[12:21:44] INFO: Starting Zigbee2MQTT...
Starting Zigbee2MQTT without watchdog.
[2025-01-04 12:21:46] info: z2m: Logging to console, file (filename: log.log)
[2025-01-04 12:21:46] info: z2m: Starting Zigbee2MQTT version 2.0.0 (commit #unknown)
[2025-01-04 12:21:46] info: z2m: Starting zigbee-herdsman (3.2.1)
[2025-01-04 12:21:46] error: z2m: Error while starting zigbee-herdsman
[2025-01-04 12:21:46] error: z2m: Failed to start zigbee-herdsman
[2025-01-04 12:21:46] error: z2m: Check https://www.zigbee2mqtt.io/guide/installation/20_zigbee2mqtt-fails-to-start_crashes-runtime.html for possible solutions
[2025-01-04 12:21:46] error: z2m: Exiting...
[2025-01-04 12:21:47] error: z2m: Error: USB adapter discovery error (No valid USB adapter found). Specify valid 'adapter' and 'port' in your configuration.
at discoverAdapter (/app/node_modules/.pnpm/[email protected]/node_modules/zigbee-herdsman/src/adapter/adapterDiscovery.ts:523:15)
at processTicksAndRejections (node:internal/process/task_queues:105:5)
at Function.create (/app/node_modules/.pnpm/[email protected]/node_modules/zigbee-herdsman/src/adapter/adapter.ts:68:33)
at Controller.start (/app/node_modules/.pnpm/[email protected]/node_modules/zigbee-herdsman/src/controller/controller.ts:132:24)
at Zigbee.start (/app/lib/zigbee.ts:69:27)
at Controller.start (/app/lib/controller.ts:142:13)
at start (/app/index.js:161:5)
[2025-01-04 12:21:47] error: z2m: If this happens after updating to Zigbee2MQTT 2.0.0, see #24364

[robymo]

I'm confirm same error after update

[08:06:17] INFO: Preparing to start...
[08:06:17] INFO: Socat not enabled
[08:06:17] INFO: Starting Zigbee2MQTT...
Starting Zigbee2MQTT without watchdog.
[2025-01-04 08:06:19] info: z2m: Logging to console, file (filename: log.log)
[2025-01-04 08:06:19] info: z2m: Starting Zigbee2MQTT version 2.0.0 (commit #unknown)
[2025-01-04 08:06:19] info: z2m: Starting zigbee-herdsman (3.2.1)
[2025-01-04 08:06:19] error: z2m: Error while starting zigbee-herdsman
[2025-01-04 08:06:19] error: z2m: Failed to start zigbee-herdsman
[2025-01-04 08:06:19] error: z2m: Check https://www.zigbee2mqtt.io/guide/installation/20_zigbee2mqtt-fails-to-start_crashes-runtime.html for possible solutions
[2025-01-04 08:06:19] error: z2m: Exiting...
[2025-01-04 08:06:19] error: z2m: Error: USB adapter discovery error (No valid USB adapter found). Specify valid 'adapter' and 'port' in your configuration.
at discoverAdapter (/app/node_modules/.pnpm/[email protected]/node_modules/zigbee-herdsman/src/adapter/adapterDiscovery.ts:523:15)
at processTicksAndRejections (node:internal/process/task_queues:105:5)
at Function.create (/app/node_modules/.pnpm/[email protected]/node_modules/zigbee-herdsman/src/adapter/adapter.ts:68:33)
at Controller.start (/app/node_modules/.pnpm/[email protected]/node_modules/zigbee-herdsman/src/controller/controller.ts:132:24)
at Zigbee.start (/app/lib/zigbee.ts:69:27)
at Controller.start (/app/lib/controller.ts:142:13)
at start (/app/index.js:161:5)
[2025-01-04 08:06:19] error: z2m: If this happens after updating to Zigbee2MQTT 2.0.0, see #24364

Please help us.
Thank you

[patrickmoll83]

ADD adapter: zstack in the config works for me

[robymo]

no for me

[robymo]

Actualy I'm back to previous version with backup

[stegemanGit]

Adding "adapter: zstack # <-- Add this line" to docker/zigbee2mqtt/configuration.yaml on my Synology NAS works for me.

configuration.yaml:
homeassistant:
enabled: true
frontend:
enabled: true
mqtt:
base_topic: zigbee2mqtt
server: mqtt://192.168.2.3
serial:
port: /dev/ttyACM0
adapter: zstack # <-- Add this line
advanced:
network_key:
..

[Daximino]

But i'm using ember?
I Need to change in zstack?
I am using slzb-06m

[Jacksoldano]

Had this issue and added
"adapter: zstack"

to my serial config in Z2M options and everything started up again, was a little scared for a moment! thanks for the thread with help

format of my config below for reference

port: >-
/dev/serial/by-id/usb-Silicon_Labs_Sonoff_Zigbee_3.0_USB_Dongle_Plus_0001-if00-port0
adapter: zstack

[Cedric29]

Adding the line works fine for me on Synology NAS Z2M docker with SONOFF ZigBee 3.0 USB Dongle Plus, TI CC2652P

[vikheide]

just adding adapter: zstack worked

[plaiddk]

I have a zigbee_sonoff_dongle_plusv2. I have added zstack as adapter. But now I get the following error:

[2025-01-04 10:16:53] info: z2m: Logging to console, file (filename: log.log)
[2025-01-04 10:16:53] info: z2m: Starting Zigbee2MQTT version 2.0.0 (commit #unknown)
[2025-01-04 10:16:53] info: z2m: Starting zigbee-herdsman (3.2.1)
[2025-01-04 10:16:54] info: zh:zstack:znp: Opening SerialPort with {"path":"/dev/serial/by-id/usb-ITEAD_SONOFF_Zigbee_3.0_USB_Dongle_Plus_V2_20240218153241-if00","baudRate":115200,"rtscts":false,"autoOpen":false}
[2025-01-04 10:16:54] info: zh:zstack:znp: Serialport opened
[2025-01-04 10:16:55] info: zh:zstack:znp: Writing CC2530/CC2531 skip bootloader payload
[2025-01-04 10:16:56] info: zh:zstack:znp: Skip bootloader for CC2652/CC1352
[2025-01-04 10:16:56] error: z2m: Error while starting zigbee-herdsman
[2025-01-04 10:16:56] error: z2m: Failed to start zigbee-herdsman
[2025-01-04 10:16:56] error: z2m: Check https://www.zigbee2mqtt.io/guide/installation/20_zigbee2mqtt-fails-to-start_crashes-runtime.html for possible solutions
[2025-01-04 10:16:56] error: z2m: Exiting...
[2025-01-04 10:16:56] error: z2m: Error: Error: Not supported, cannot set

[arnaud42]

I use the web based tool at https://darkxst.github.io/silabs-firmware-builder/ for that.
I gonna try and let you know.

[arnaud42]

I updated the firmware to the last version (Zigbee (EZSP) 7.4.4.0 build 0) and it's working fine. No more error !

[plaiddk]

I updated the firmware to the last version (Zigbee (EZSP) 7.4.4.0 build 0) and it's working fine. No more error !

same here!! :)

[Minores]

I use the web based tool at https://darkxst.github.io/silabs-firmware-builder/ for that. I gonna try and let you know.

For some reason, it didn't work for me with zstack, but if I put ember back on, it works after the update

upd. Now it works

serial:
  port: /dev/serial/by-id/usb-ITEAD_SONOFF_Zigbee_3.0_USB_Dongle_Plus_V2_20230504194419-if00
  adapter: zstack

[yakzuu]

What fixed the problem for me:
I updated the firmware to the last version Zigbee(EZSP)7.4.4.0 build 0
And do not modify the Zigbee2mqtt Configuration.Yaml file (it prevented startup).

[Smiley-k]

yes, it work. my device jethub h1

thanks

[Enigma2k4]

OK, So I have been struggling with this for a good 8x hours now. and finally (at the cost of much of my sanity), I have this resolved.

I have a Sonof ZB Dongle P, plugged into my Synology NAS, and I am running HA + Docker to install. Everything was working perfectly until the upgrade. Everything was supposed to be simple, just add the adapter and I should have been good to go. That couldn't be further from the truth. It just wouldn't recognise the device, no matter what I did. So, in the end, these are the steps I followed:

1. Full removal of Z2M, and mosquito. (I backed up config files just in case). Full removal of all files.
2. Flashed my Sonof dongle to latest firmware
3. re-installed mosquito (new clean image downloaded)
4. re-installed Z2M - same story. It wouldn't work (I had ember selected as adapter) - also new clean image downloaded
5. Changed to zstack as the adapter (even tho my dongle should be using Ember) and boom. It worked
6. I re-added my devices to the config file, sadly, it didnt recognise them'.
7. I manually had to add my devices 1by1 (BUT, thankfully as soon as they connected, it pulled all the settings back)

[Powermaniaxx]

What is your configuration file?

[Enigma2k4]

homeassistant:
enabled: true
mqtt:
base_topic: zigbee2mqtt
server: mqtt://192.168.xxx.xxx:xx83
serial:
port: /dev/ttyUSB0
adapter: zstack
frontend:
enabled: true
port: xx81
host: 192.168.xxx.xxx
device_options: {}
devices:
'0xa4c138198415b7e5':
friendly_name: Amplifier Switch
homeassistant:
name: Amplifier Switch
optimistic: true
'0xf082c0fffec00157':
friendly_name: Moes 3x switch
'0x282c02bfffeac23a':
friendly_name: Outside motion sensor
description: External motion sensor
'0xb0c7defffe16a21d':
friendly_name: Exterior Light Dimmer
version: 4

[Powermaniaxx]

Unfortunately it doesn't work for me.

[Powermaniaxx]

it works. Running containers with high priority was missing

[Powermaniaxx]

I'm trying to reflash the stick, but I can't get it to work

The stick is connected in bootloader mode, but I cannot flash

Anyone have any idea what could be causing this?

ls -l /dev/serial/by-id

lsusb

Can I flash with https://dongle.sonoff.tech/sonoff-dongle-quick-flasher/ ???

[OmegaWolfProjects]

I was getting the same errors as people here such as "Error: Failed to connect to the adapter (Error: SRSP - SYS - ping after 6000ms)".
Turns out I stupidly installed the "Router" firmware rather than the "coordinator" firmware onto the Sonoff 3.0 USB Dongle Plus.

[PhilNS]

Ok, so trying to summarise the above, since I'm having the same issue but finding too many different solutions proposed without a clear path.

1. with latest Z2M version, it's been introduced auto discovery of device, that for the (many ?) ones which it doesn't discover anything, it reports : z2m: Error: USB adapter discovery error (No valid USB adapter found). Specify valid 'adapter' and 'port' in your configuration.

2. My Coordinator Key ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus , flashed at latest 7.4.4, is recognized by the system:
   - ls -l /dev/serial/by-id : usb-ITEAD_SONOFF_Zigbee_3.0_USB_Dongle_Plus_V2_20221202104101-if00 -> ../../ttyACM0

Now the proposed different solutions flavours are about:

Solution A) placing correct Serial entries in configuration.yaml (even if it worked previous but it doesn't anymore)
- adapter should be and was : "ember" but some had to use now "zstack" and some others even the deprecated "ezsp"
[ok, Which One ? ] , of course I've used all of them and still getting the No valid USB adapter found.

 **- port:** some use the logical , i.e. /dev/ttyACM0, some others the by-id, i.e. /dev/serial/by-id, 
       in my case : usb-ITEAD_SONOFF_Zigbee_3.0_USB_Dongle_Plus_V2_20221202104101-if00 
   _[ok, Which One  ?]_  I suppose they are equivalent, unless it is  linked to the Docker run --device command ? 

   sudo docker run --init -d --name="zigbee2mqtt" -p ........... **--device=/dev/serial/by-id/usb-ITEAD_SONOFF_Zigbee_3.0_USB_Dongle_Plus_V2_20221202104101-if00:/dev/ttyACM0** --network host --restart always koenkk/zigbee2mqtt

Solution B: add a variable in OS environment ZIGBEE2MQTT_CONFIG_SERIAL_ADAPTER=zstack
[never seen it mentioned, I will not try this one]

Solution C) Nuke Z2M & MQTT and reinstall all from scratch ... and add a mix of all solution flavours above.
[to solve one element upgrade issue? ok, THANKS, BUT NO THANKS :) unless I get stuck in this outage for 2 weeks]

So now I'm running with the following configuration, 2 spaces indent checked, and still get the error message.
serial:
port: /dev/ttyACM0
adapter: ember

I guess the solution lies in the correct combination of the 4 elements, even if I tried mostly all combinations:

- firmware flashed on key: --> (7.4.4 on usb-ITEAD_SONOFF_Zigbee_3.0_USB_Dongle_Plus_V2)
- configuration.yaml adpater: --> ember, but I also tried zstack and ezsp
- configuration.yaml port: --> /dev/ttyACM0 , but tried also /dev/serial/by-id/***
- docker run specified device: -> /dev/serial/by-id/usb-ITEAD_SONOFF_Zigbee_3.0_USB_Dongle_Plus_V2_20221202104101-if00:/dev/ttyACM0

So anybody has any further solution or troubleshooting hint ?

My humble opinion .. this zigbee configuration looks a bit too fragile when you have plenty of devices connected and suddenly you risk to have to start from scratch again and again and reconfigure all devices one by one at worst.

thanks
Phil

[OmegaWolfProjects]

Have you definitely flashed the "coordinator" firmware and not the "Router" firmware onto the device?

Yes I know this sounds like a stupid question but this is the very mistake I made. The Zigbee2mqtt webpage was recognizing my USB device as being valid/correct and yet the terminal zigbee2mqtt software was throwing the error:
"Error: Failed to connect to the adapter (Error: SRSP - SYS - ping after 6000ms)".

It took me a while to realize that I had accidentally flashed the "Router" firmware to the USB device rather than the "Coordinator" firmware!!

[Hummy9991]

Is there a way to rollback to an earlier version of Z2M? I've tried everything in this thread and it still won't work, just getting the same "No Valid USB adapter found". My dongle is flashed to the latest zstack version and I've tried every combination of serial config. I don't want to waste any more time on this.

[Hummy9991]

What ended up working for me was just a total reboot after flashing the latest firmware onto my dongle

[PaffcioStudio]

I had the same issue with the latest Z2M 2.3.0-1. I had to downgrade to version 1.41.0-1, and for now I’m sticking with it, because surprisingly everything works. I don't see any reason to update.

[casafccloss]

Team. Everything looks much better for now. Followed the directions given and things are running absolutely fine.

[achelak]

In kubernetes env this one is working fine.
serial:
port: "/dev/ttyUSB0"
adapter: zstack

[Cyberlytical-LLC]

The fact this is from Oct 2024 with no fix still is extremely concerning.

[Arie6414]

I am getting also a lot of errors
Flashed everything again
recreated the container,
Even updated my server,
Still the same errors.
All of this started to happen after a planned power outage.

[2025-06-13 11:56:57] error: z2m: Error while starting zigbee-herdsman
[2025-06-13 11:56:57] error: z2m: Failed to start zigbee
[2025-06-13 11:56:57] error: z2m: Check https://www.zigbee2mqtt.io/guide/installation/20_zigbee2mqtt-fails-to-start.html for possible solutions
[2025-06-13 11:56:57] error: z2m: Exiting...
[2025-06-13 11:56:57] error: z2m: Error: SRSP - SYS - getExtAddr after 6000ms

[2025-06-13 11:58:06] error: z2m: Error while starting zigbee-herdsman
[2025-06-13 11:58:06] error: z2m: Failed to start zigbee
[2025-06-13 11:58:06] error: z2m: Check https://www.zigbee2mqtt.io/guide/installation/20_zigbee2mqtt-fails-to-start.html for possible solutions
[2025-06-13 11:58:06] error: z2m: Exiting...
[2025-06-13 11:58:06] error: z2m: Error: Failed to connect to the adapter (Error: SRSP - SYS - ping after 6000ms)

[2025-06-13 12:04:22] error: z2m: Error while starting zigbee-herdsman
[2025-06-13 12:04:22] error: z2m: Failed to start zigbee
[2025-06-13 12:04:22] error: z2m: Check https://www.zigbee2mqtt.io/guide/installation/20_zigbee2mqtt-fails-to-start.html for possible solutions
[2025-06-13 12:04:22] error: z2m: Exiting...
[2025-06-13 12:04:22] error: z2m: RangeError: offset is out of bounds

zh:zstack:znp: Error while parsing to ZpiObject 'TypeError: Cannot read properties of undefined (reading 'find')
at Function.fromUnpiFrame (/app/node_modules/zigbee-herdsman/src/adapter/z-stack/znp/zpiObject.ts:57:49)
at Znp.onUnpiParsed (/app/node_modules/zigbee-herdsman/src/adapter/z-stack/znp/znp.ts:93:38)
at Parser.emit (node:events:517:28)
at Parser.parseNext (/app/node_modules/zigbee-herdsman/src/adapter/z-stack/unpi/parser.ts:45:26)
at Parser._transform (/app/node_modules/zigbee-herdsman/src/adapter/z-stack/unpi/parser.ts:19:14)
at Parser.Transform._write (node:internal/streams/transform:175:8)
at writeOrBuffer (node:internal/streams/writable:392:12)
at _write (node:internal/streams/writable:333:10)
at Parser.Writable.write (node:internal/streams/writable:337:10)
at SerialPort.ondata (node:internal/streams/readable:809:22)'
[2025-06-13 12:02:59] debug: zh:zstack:unpi:parser: --- parseNext []
[2025-06-13 12:03:05] error: z2m: Error while starting zigbee-herdsman
[2025-06-13 12:03:05] error: z2m: Failed to start zigbee
[2025-06-13 12:03:05] error: z2m: Check https://www.zigbee2mqtt.io/guide/installation/20_zigbee2mqtt-fails-to-start.html for possible solutions
[2025-06-13 12:03:05] error: z2m: Exiting...
[2025-06-13 12:03:05] error: z2m: Error: SRSP - SAPI - readConfiguration after 6000ms

[2025-06-13 12:14:01] error: z2m: Error: SRSP - APP_CNF - bdbStartCommissioning after 40000ms

[2025-06-13 12:19:51] error: z2m: Error while starting zigbee-herdsman
[2025-06-13 12:19:51] error: z2m: Failed to start zigbee
[2025-06-13 12:19:51] error: z2m: Check https://www.zigbee2mqtt.io/guide/installation/20_zigbee2mqtt-fails-to-start.html for possible solutions
[2025-06-13 12:19:51] error: z2m: Exiting...
[2025-06-13 12:19:51] error: z2m: RangeError: Attempt to access memory outside buffer bounds

[Arie6414]

This is a summary of errors which I receive. I can not find the relation between all those errors.

[DennisSnep]

I still can't get it to work. This is the logfile:

Starting Zigbee2MQTT without watchdog.
[2025-06-16 15:28:05] info: z2m: Logging to console, file (filename: log.log)
[2025-06-16 15:28:06] info: z2m: Starting Zigbee2MQTT version 2.4.0 (commit #unknown)
[2025-06-16 15:28:06] info: z2m: Starting zigbee-herdsman (4.1.0)
[2025-06-16 15:28:06] info: zh:ember: Using default stack config.
[2025-06-16 15:28:06] info: zh:ember: ======== Ember Adapter Starting ========
[2025-06-16 15:28:06] info: zh:ember:ezsp: ======== EZSP starting ========
[2025-06-16 15:28:06] info: zh:ember:uart:ash: ======== ASH Adapter reset ========
[2025-06-16 15:28:06] info: zh:ember:uart:ash: RTS/CTS config is off, enabling software flow control.
[2025-06-16 15:28:06] info: zh:ember:uart:ash: ASH COUNTERS since last clear:
[2025-06-16 15:28:06] info: zh:ember:uart:ash: Total frames: RX=0, TX=0
[2025-06-16 15:28:06] info: zh:ember:uart:ash: Cancelled : RX=0, TX=0
[2025-06-16 15:28:06] info: zh:ember:uart:ash: DATA frames : RX=0, TX=0
[2025-06-16 15:28:06] info: zh:ember:uart:ash: DATA bytes : RX=0, TX=0
[2025-06-16 15:28:06] info: zh:ember:uart:ash: Retry frames: RX=0, TX=0
[2025-06-16 15:28:06] info: zh:ember:uart:ash: ACK frames : RX=0, TX=0
[2025-06-16 15:28:06] info: zh:ember:uart:ash: NAK frames : RX=0, TX=0
[2025-06-16 15:28:06] info: zh:ember:uart:ash: nRdy frames : RX=0, TX=0
[2025-06-16 15:28:06] info: zh:ember:uart:ash: CRC errors : RX=0
[2025-06-16 15:28:06] info: zh:ember:uart:ash: Comm errors : RX=0
[2025-06-16 15:28:06] info: zh:ember:uart:ash: Length < minimum: RX=0
[2025-06-16 15:28:06] info: zh:ember:uart:ash: Length > maximum: RX=0
[2025-06-16 15:28:06] info: zh:ember:uart:ash: Bad controls : RX=0
[2025-06-16 15:28:06] info: zh:ember:uart:ash: Bad lengths : RX=0
[2025-06-16 15:28:06] info: zh:ember:uart:ash: Bad ACK numbers : RX=0
[2025-06-16 15:28:06] info: zh:ember:uart:ash: Out of buffers : RX=0
[2025-06-16 15:28:06] info: zh:ember:uart:ash: Retry dupes : RX=0
[2025-06-16 15:28:06] info: zh:ember:uart:ash: Out of sequence : RX=0
[2025-06-16 15:28:06] info: zh:ember:uart:ash: ACK timeouts : RX=0
[2025-06-16 15:28:06] info: zh:ember:uart:ash: ======== ASH stopped ========
[2025-06-16 15:28:06] error: zh:ember:uart:ash: Failed to init port with error Error: Error: No such file or directory, cannot open /dev/serial/by-id/usb-ITEAD_SONOFF_Zigbee_3.0_USB_Dongle_Plus_V2_20231009115357-if00
[2025-06-16 15:28:06] error: z2m: Error while starting zigbee-herdsman
[2025-06-16 15:28:06] error: z2m: Failed to start zigbee-herdsman
[2025-06-16 15:28:06] error: z2m: Check https://www.zigbee2mqtt.io/guide/installation/20_zigbee2mqtt-fails-to-start_crashes-runtime.html for possible solutions
[2025-06-16 15:28:06] error: z2m: Exiting...
[2025-06-16 15:28:06] error: z2m: Error: Failed to start EZSP layer with status=HOST_FATAL_ERROR.
at EmberAdapter.initEzsp (/app/node_modules/.pnpm/[email protected]/node_modules/zigbee-herdsman/src/adapter/ember/adapter/emberAdapter.ts:666:19)
at EmberAdapter.start (/app/node_modules/.pnpm/[email protected]/node_modules/zigbee-herdsman/src/adapter/ember/adapter/emberAdapter.ts:1548:24)
at Controller.start (/app/node_modules/.pnpm/[email protected]/node_modules/zigbee-herdsman/src/controller/controller.ts:133:29)
at Zigbee.start (/app/lib/zigbee.ts:71:27)
at Controller.start (/app/lib/controller.ts:102:13)
at start (/app/index.js:149:5)

My configuration:
data_path: /config/zigbee2mqtt
socat:
enabled: false
master: pty,raw,echo=0,link=/tmp/ttyZ2M,mode=777
slave: tcp-listen:8485,keepalive,nodelay,reuseaddr,keepidle=1,keepintvl=1,keepcnt=5
options: "-d -d"
log: false
mqtt: {}
serial:
serial:
adapter: zstack
port: >-
/dev/serial/by-id/usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_aa28e42803e7ed11af0cd6770b2af5ab-if00-port0

Anybode that can help please?

[plaiddk]

Have you checked the options with the options that has been posted in here?

[vascodegraaff]

Yo yo, i found out the solution. Assuming you're running a docker container for Home assistant, you need to make sure you pass the usb ports so HA detects the device. update your docker-compose.yaml with something like this.

version: '3'
services:
  homeassistant:
    container_name: homeassistant
    image: homeassistant/home-assistant:stable
    devices:
      - /dev/ttyUSB0:/dev/ttyUSB0
      - /dev/serial:/dev/serial
    volumes:
      - /run/udev:/run/udev:ro
    privileged: true
    ... (other configuration)```

[danielo515]

Thank you and thanks to the one who has the idea to put this in the logs

[dougle03]

So this made it 'easier' for some, but broke a lot of installations, particularly docker based where passing a USB coordinator is concerned...
One has to wonder just how 'useful' this change really was, and who was asking for it...?
I know I'm not going to get the last 30 mins back getting to the bottom of why my install stopped working... grr.....

[UseN1bble]

After a few hours I still can't get it to work on Openhabian.

I started on version 1.43.0 and updated to 2.6.1.
After this I can't get it to run.

• Flashing the SonOFF stick to the latest version.
• Removed Zigbee2MQTT en started over with a clean install with minimal config.
• Upgrading again to 2.6.1.
• First error is with the missing, USB device (don't know why though, this hasn't changed), but fixed with adapter: zstack

Stil I get the error that could not start.

The full debug log is:
[2025-09-27 15:28:04] debug: z2m: Removing old log directory '/var/log/zigbee2mqtt/2025-09-27.15-22-42al'
[2025-09-27 15:28:04] info: z2m: Logging to console, file (filename: log.log)
[2025-09-27 15:28:04] debug: z2m: Loaded state from file /opt/zigbee2mqtt/data/state.json
[2025-09-27 15:28:04] info: z2m: Starting Zigbee2MQTT version 2.6.1 (commit #d44463a3)
[2025-09-27 15:28:04] info: z2m: Starting zigbee-herdsman (6.0.4)
[2025-09-27 15:28:04] debug: z2m: Using zigbee-herdsman with settings: '"{"network":{"panID":31237,"extendedPanID":[221,221,221,221,221,221,221,221],"channelList":[25],"networkKey":"HIDDEN"},"databasePath":"/opt/zigbee>
[2025-09-27 15:28:04] debug: zh:adapter:discovery: Connected devices: [{"path":"/dev/ttyACM0","manufacturer":"ITEAD","serialNumber":"20230221151926","pnpId":"usb-ITEAD_SONOFF_Zigbee_3.0_USB_Dongle_Plus_V2_20230221151926-if00","vendor>
[2025-09-27 15:28:04] debug: zh:adapter:discovery: Unable to match USB adapter: zstack | /dev/serial/by-id/usb-ITEAD_SONOFF_Zigbee_3.0_USB_Dongle_Plus_V2_20230221151926-if00
[2025-09-27 15:28:05] debug: zh:controller: Starting with options '{"network":{"networkKeyDistribute":false,"networkKey":"HIDDEN","panID":31237,"extendedPanID":[221,221,221,221,221,221,221,221],"channelList":[25]},"serialPort":{"path>
[2025-09-27 15:28:05] info: zh:zstack:znp: Opening SerialPort with {"path":"/dev/serial/by-id/usb-ITEAD_SONOFF_Zigbee_3.0_USB_Dongle_Plus_V2_20230221151926-if00","baudRate":115200,"rtscts":false,"autoOpen":false}
[2025-09-27 15:28:05] info: zh:zstack:znp: Serialport opened
[2025-09-27 15:28:05] debug: zh:zstack:znp: --> SREQ: SYS - ping - {"capabilities":1}
[2025-09-27 15:28:05] debug: zh:zstack:unpi:writer: --> frame [254,0,33,1,32]
[2025-09-27 15:28:05] info: zh:zstack:znp: Writing CC2530/CC2531 skip bootloader payload
[2025-09-27 15:28:05] debug: zh:zstack:unpi:writer: --> buffer [239]
[2025-09-27 15:28:06] debug: zh:zstack:znp: --> SREQ: SYS - ping - {"capabilities":1}
[2025-09-27 15:28:06] debug: zh:zstack:unpi:writer: --> frame [254,0,33,1,32]
[2025-09-27 15:28:06] info: zh:zstack:znp: Skip bootloader for CC2652/CC1352
[2025-09-27 15:28:06] error: z2m: Error while starting zigbee-herdsman
[2025-09-27 15:28:06] error: z2m: Failed to start zigbee-herdsman
[2025-09-27 15:28:06] error: z2m: Check https://www.zigbee2mqtt.io/guide/installation/20_zigbee2mqtt-fails-to-start_crashes-runtime.html for possible solutions
[2025-09-27 15:28:06] error: z2m: Exiting...
[2025-09-27 15:28:06] error: z2m: Error: Error: Operation not supported, cannot set

My config is the following:
frontend:
enabled: true
port: 8081
homeassistant:
enabled: false
mqtt:
base_topic: zigbee2mqtt
server: mqtt://localhost
user:
password:
serial:
adapter: zstack
port: /dev/serial/by-id/usb-ITEAD_SONOFF_Zigbee_3.0_USB_Dongle_Plus_V2_20230221151926-if00
advanced:
network_key:
- 231
- 84
- 97
- 166
- 138
- 38
- 90
- 36
- 36
- 155
- 111
- 54
- 190
- 230
- 212
- 146
pan_id: 31237
log_level: debug
channel: 25
output: attribute_and_json
log_directory: /var/log/zigbee2mqtt/%TIMESTAMP%al
homeassistant_legacy_entity_attributes: false
homeassistant_legacy_triggers: false
legacy_api: false
legacy_availability_payload: false
device_options:
legacy: false
version: 4

[rios0rios0]

Any workarounds?