Sonoff Zigbee USB dongles (ZBDongle-P and ZBDongle-E) are popular Zigbee coordinators. This guide covers common issues.
Dongle Not Detected
USB connection issues:
- USB 2.0 port: Use USB 2.0 - USB 3.0 causes interference
- Extension cable: Use USB extension to move away from interference
- Check dmesg: On Linux, check dmesg for device detection
- Driver: May need CH340/CH341 driver on some systems
- Permissions: User may need dialout group on Linux
ZBDongle-P vs ZBDongle-E
Understanding the models:
- ZBDongle-P: CC2652P chip - good range, well-supported
- ZBDongle-E: EFR32MG21 chip - also good, different firmware
- Antenna: Both have external antenna - position for best coverage
- Firmware: Can be flashed with Zigbee2MQTT coordinator firmware
Devices Won't Pair
Pairing issues:
- Permit join: Enable permit join in Zigbee2MQTT or ZHA
- Reset device: Factory reset Zigbee device before pairing
- Close proximity: Pair devices close to dongle
- Channel: Try different Zigbee channel if issues
- Firmware: Update coordinator firmware
Zigbee2MQTT Setup
For Z2M users:
- Serial port: Configure correct serial port in Z2M
- Baud rate: Usually auto-detected, 115200 for most
- Coordinator type: Select correct adapter type in settings
- Network key: Keep network key backed up
ZHA Setup
For Home Assistant ZHA:
- Auto-discovery: ZHA may auto-discover the dongle
- Manual setup: Add integration, select serial port
- Radio type: Select correct radio type for chip
- Form network: Form new network on first setup
Interference and Range
Optimizing performance:
- USB 3.0: Keep away from USB 3.0 ports and devices
- WiFi router: Position away from 2.4GHz WiFi router
- Extension: USB extension improves range and reduces interference
- Central location: Place centrally for best mesh coverage