[Tips]Using OpenWRT to Turn ZBDongle-E into a Zigbee Network Coordinator

Introduction #

This article will guide you through the process of installing Ser2net on an OpenWRT router to liberate ZBDongle-E from the constraints of direct USB connection to the host, allowing ZBDongle-E to operate within the network and manage your Zigbee devices more efficiently.

Required Equipment and Tools #

1、OpenWRT Router (must have a USB port, this article uses the Xiaomi Router Mini, the second-hand price is about $3.3)

3、Necessary Computer or Terminal Device

4、Putty (not necessary)

Step 1: Install OpenWRT #

The methods for flashing firmware vary across different routers. There are already a plethora of tutorials on how to flash OpenWRT online; please search on Google yourself.

Step 2: Install Software and Drivers #

You will need to install the following on your OpenWRT:

1、ser2net: Ser2net is an open-source software that allows bidirectional transparency between TCP/IP or UDP data and serial port data. In simpler terms, Ser2net can forward network data to a serial port and vice versa, bridging the network and serial port.

2、luci-app-ser2net: A visual configuration application for Ser2net

3、kmod-usb-serial-cp210x: CP2102 serial port chip driver


⚠️Note: kmod-usb-serial-cp210x is only suitable for ZBDongle-E(SONOFF Zigbee 3.0 USB Dongle Plus v2) and ZBDongle-P(SONOFF Zigbee 3.0 USB Dongle Plus) devices with a CP2102 serial port chip.

How to install software via OpenWRT #

Update the list through the software marketplace and search for installations

Step 3: Configure ZBDongle-E #

  1. If the router has only one USB port, the default serial port path is: /dev/ttyUSB0
  2. If you are unsure, have multiple USB ports, or cannot connect after configuration, you can use terminal tools like Putty to SSH into the OpenWRT router and enter the command:
dmesg | grep tty

Step 4: Configure Ser2net #

1、Go to the router management background through a browser, and then enter the ser2net configuration page

3、Navigate to the proxies settings page, configure the protocol as RAW, and set the device’s serial port path, which in this article is: /dev/ttyUSB0. Save the configuration after completion.

Step 5: Add Network Coordinator to Open Source Platforms #

Home Assistant ( Version:13.2 ) #

Enter the router IP and the port configured in Ser2net, for example: tcp://192.168.1.1:5000.

If the recognition is successful, it prompts whether you want to restore the network.

Zigbee2MQTT ( Version: 1.41.0-1 ) #

Modify the serial port information to:

Serial:
    port: tcp://192.168.1.1:5000
    adapter: ezsp
YAML




The setup is complete, start Zigbee2MQTT, and you’re done!

Troubleshooting and Optimization #

1.Are you encountering errors when configuring ZBdongle-E with Home Assistant (HA) or Zigbee2MQTT (Z2M)?

Solution 1:

Check the network environment to check whether the gateway address of the router connected to ZBDongle-E can be accessed by the host.

Solution 2:

Uninstall ser2net, luci-app-ser2net, kmod-usb-serial-cp210x software on the OpenWRT router, then reinstall and configure;

Solution 3:

Restore the factory configuration of your OpenWRT router and restart the configuration.

2. How do I determine if the device is properly recognized by the OpenWRT router?

Solution:

Using a terminal tool such as putty, log in to the OpenWRT router, and enter

ls /dev/tty*

Check whether there is /dev/ttyUSB0 or /dev/ttyUSB1, if so, it means that the device has been successfully connected and the driver is working normally.

Conclusion #

References #

What are your feelings

Updated on November 2, 2026