Skip to content

Commit 1a98362

Browse files
committed
Improve bad network stability/range notes.
1 parent 0e3180b commit 1a98362

File tree

2 files changed

+13
-8
lines changed

2 files changed

+13
-8
lines changed

docs/advanced/zigbee/02_improve_network_range_and_stability.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,20 @@
44
# Improve network range and stability
55
In case you are experiencing an unstable or bad network range you can do the following things to improve your network.
66

7+
## Adapter
8+
Use a [recommended](../../guide/adapters/README.md) adapter, especially the CC2530 and CC2531 are known to perform poorly.
9+
710
## USB based adapter
8-
### Connect the adapter using an USB extension cable
911
The range of these adapters can greatly be improved when connecting them with an USB extension
1012
cable instead of directly plugging it into the computer (e.g. Raspberry Pi). When plugged directly into the computer, the antenna suffers from interference of radio signals and electrical components of the computer. Also be sure not to position the adapter too close
11-
to any other radio transmitting devices (e.g. a Wi-Fi router) or an SSD. A USB extension cable of 50 cm is already enough to reduce the interference.
13+
to any other radio transmitting devices (e.g. a Wi-Fi router) or an SSD.
14+
15+
A **USB extension cable** of 50 cm is already enough to reduce the interference. Preferably get one with shielding as this may give better results ([source](https://www.reddit.com/r/homeassistant/comments/10ebkis/psareminder_about_zigbee_interference/?utm_source=share&utm_medium=ios_app&utm_name=iossmf)).
1216

1317
**Do not underestimate this!** Placing your adapter close to an USB port can kill the radio signal entirely as demonstrated in [this article](https://www.unit3compliance.co.uk/2-4ghz-intra-system-or-self-platform-interference-demonstration/).
1418

19+
Aditionally, it may help to plug the adapter to a USB 2 instead of USB 3 port.
20+
1521
### Try different orientations of the adapter
1622
RF connection between the adapter and other devices also depends on the way it is oriented in space. You might be having very poor `linkquality` reports and intermittent ping failures but once the adapter is rotated a little it all can change greatly without re-locating the coordinator far away. Try to experiment with positioning and orienting the adapter in space while monitoring the `linkquality` values reported. You might find it useful to buy a small rotating USB connector like this:
1723

@@ -29,3 +35,6 @@ Any device using the open 2.4 GHz spectrum could interfere with Zigbee such as B
2935

3036
## Adding more routers to your network
3137
In a Zigbee network, each router will extend the range of the network ([read more about this](./01_zigbee_network.md)). Almost all AC powered devices will serve as a router.
38+
39+
## Hardware
40+
Although Zigbee2MQTT does not require many resources, the hardware you are running Zigbee2MQTT on can impact the performance. This is especially true when using low-power hardware like the Raspbery Pi 3. Make sure that enough resources (CPU/memory) is free. For example, running Home Assistant + Zigbee2MQTT Home Assistant addon on the Raspberry Pi 3 may give bad performance.

docs/guide/faq/README.md

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,12 +6,8 @@ sidebarDepth: 0
66

77
[[toc]]
88

9-
## Unstable networks and poor performance
10-
If you experience timeouts, crashes, unable to add new devices or poor performance this mostly caused by:
11-
- Using a [non-recommended adapter](../adapters/README.md)
12-
- [Wifi or Bluetooth interference](../../advanced/zigbee/02_improve_network_range_and_stability.md#reduce-wifi-interference-by-changing-the-zigbee-channel)
13-
- Poor host hardware (e.g. running too much in the single computer, Raspberry Pi model 3 running Home Assistant addon, too little memory)
14-
- If using a Raspberry Pi, try plugging the adapter into the USB 2 instead of USB 3 port
9+
## My network is unstable and/or performs poorly, what can I do?
10+
Read [Improve network range and stability](../../advanced/zigbee/02_improve_network_range_and_stability.md)
1511

1612
## Why does my device not or fail to pair?
1713
This problem can be divided in 2 categories; no logging is shown at all OR interview fails.

0 commit comments

Comments
 (0)