You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/guide/installation/20_zigbee2mqtt-fails-to-start.md
+17-7
Original file line number
Diff line number
Diff line change
@@ -12,20 +12,19 @@ Most of the time this is caused by Zigbee2MQTT not being able to communicate wit
12
12
13
13
Configure the `serial` section as described [here](../configuration/adapter-settings.md).
14
14
15
-
## Error: `SRSP - SYS - ping after 6000ms`
15
+
## Error: `SRSP - SYS - ping after 6000ms` for zStack or `HOST_FATAL_ERROR` for EmberZNet
16
16
17
-
5 common reasons of this error:
17
+
Common reasons for this error:
18
18
19
19
1. The port of your serial adapter changed.
20
-
Check [this](../installation/01_linux.md#1-determine-location-of-the-adapter-and-checking-user-permissions) to find
21
-
out the port of your adapter.
20
+
Check [this](../installation/01_linux.md#1-determine-location-of-the-adapter-and-checking-user-permissions) to find out the port of your adapter.
22
21
2. If you are using a CC2530 or CC2531; it is a common issue for this adapter to crash (due to its outdated hardware).
23
-
Reflashing the firmware should fix the problem. If it happens often consider flashing the [source routing firmware](https://github.com/Koenkk/Z-Stack-firmware/tree/master/coordinator/Z-Stack_Home_1.2/bin/source_routing) or upgrade to
24
-
a [more powerful adapter](../adapters/README.md).
22
+
Reflashing the firmware should fix the problem. If it happens often consider flashing the [source routing firmware](https://github.com/Koenkk/Z-Stack-firmware/tree/master/coordinator/Z-Stack_Home_1.2/bin/source_routing) or upgrade to a [more powerful adapter](../adapters/README.md).
25
23
3. Your adapter requires additional configuration parameters. Check [supported Adapters](../adapters/README.md) section to find out if your adapter requires extra parameters (eg. ConBee II / RaspBee II).
26
24
4. Home Assistant's "Zigbee Home Automation" (ZHA) integration is enabled. Try to disable the ZHA integration and restart the Zigbee2MQTT add-on.
27
25
5. Your hardware adapter is flashed with the router firmware and not with the coordinator firmware.
28
26
6. Your network Zigbee adapter is not accessible over the LAN network.
27
+
7. Another software on your machine (including Home Assistant integration) is interfering with USB devices (example: [HA EDL21 integration](https://www.home-assistant.io/integrations/edl21) trying to find a USB device).
29
28
30
29
## Verify that you put the correct port in configuration.yaml
31
30
@@ -128,7 +127,7 @@ In case you see message like below when running `dmesg -w` you are using a bad p
128
127
[44889.075627] Voltage normalised (0x00000000)
129
128
```
130
129
131
-
When you have a SSD connected to the Pi, try connecting the adapter via a powered USB hub.
130
+
Also try connecting the adapter via a powered USB hub (especially if you have an SSD connected to the Pi).
132
131
133
132
## Make sure the extension cable works
134
133
@@ -190,7 +189,18 @@ The correct revision is: **E** like shown below.
190
189
191
190
All earlier version are not supported (these are development boards). Return this board to the seller immediately.
192
191
192
+
## EmberZNet coordinators only
193
+
194
+
See [EmberZNet errors](../adapters/emberznet.md#error-level).
195
+
193
196
## Multiple cheap USB-UART
194
197
195
198
If you have multiple devices connected that are running cheap USB-UART converters (CH341) they may be indistinguishable to your system, since they all possibly have the same idProduct, SerialNumber etc. so they will share the same /dev/serial/by-id.
196
199
The easiest solution is to change one of your devices to something with a different uart-usb converter. The second solution would be swapping the whole converter or adding external EEPROM memory to a chip that does not have one (like CH341) so you would be able to add a serial number.
200
+
201
+
## MQTT v5 disconnecting
202
+
203
+
If you use an MQTT broker with version 5 of the MQTT specification, you may get disconnects when something is misbehaving.
204
+
This can happen, for example, when "maximum packet size" is exceeded (large networks).
205
+
206
+
To remedy that, configure your broker accordingly, and check if Zigbee2MQTT has a corresponding setting to adjust too. See [MQTT configuration](../configuration/mqtt.md#server-connection).
0 commit comments