Model ZG01 manufactured by Athom
Zigbee Gateway
Available from:
Confirmed working with
If the device is following Zigbee standards it is possible it will work with other gateway solutions, it is just not confirmed as working yet!

When flashing ESP32, Connect the data cable Hold the button and flash the Tasmota Release “Tasmota32 Sonoff-ZigbeeBridgePro” to pre-completing all required file and file system changes.

The CC2652P module is pre-installed with the latest firmware of Koenkk by default (20220219)

Working mode switching (TCP and Serial)

The device works in TCP mode by default. If you want to switch to Serial mode, you need to open the shell of the device and turn the switch inside to the position shown in the figure below (close 1, 2, open 3, 4). At this time, the Zigbee module directly communicates with the serial port Connection does not go through ESP32. Athomzbbrdg ZHA Configuration

For Home Assistant (ZHA or Zigbee2MQTT)

This mode creates a TCP bridge from the zigbee module to Home Assistant or Zigbee2MQTT. In this case Tasmota is only relaying all the messages from the zigbee module and you cannot use any Zigbee commands in Tasmota console in this mode. All setup needs to be done from the Home Assistant ZHA integration or.

After Zigbee firmware is flashed and confirmed working in ZIgbee2Tasmota mode, apply the template:

{"NAME":"Athom Zigbee Bridge","GPIO":[32,0,0,0,0,0,0,0,5472,0,5504,544,0,0,5600,0,0,0,0,5568,0,0,0,0,0,0,0,1,5792,0,0,0,0,0,0,0],"FLAG":0,"BASE":1}

Run the following command to:

  • Create a rule in tasmota to start TCPBridge on port 8888 on boot
  • Enable the above rule
  • Start TCP on port 8888
backlog rule1 on system#boot do TCPStart 8888 endon ; rule1 1 ; TCPStart 8888

You can change 8888 to a port you prefer.

Connecting to Home Assistant with ZHA

In Home Assistant (requires version 0.113+) go to Configuration - Integrations, click the + icon, search for ZHA integration and select it.

Athomzbbrdg ZHA Configuration

  1. for Radio Type choose “ZNP”
  2. choose “software” for ‘data flow control’
  3. under “Serial device path” enter socket://[athomzbbrdg_ip]:8888 replacing [athomzbbrdg_ip] with its IP address. Do not use hostnames.
    • if you changed the port number use yours
    • ensure port speed is set to “115200”
  4. when the athomzbbrdg is discovered you will get a confirmation message

Athomzbbrdg ZHA Configuration

Connecting to Home Assistant OS with Zigbee2MQTT

This assumes you already have a basic knowledge of installing custom addons in HAOS, MQTT and have an MQTT broker already configured within Home Assistant OS.

  1. Install Zigbee2MQTT Add On by adding the custom github repository.
  2. Add the following line to the Configuration > Options > Serial text field.
    • replace [athomzbbrdg_ip] with its IP address
    • if you changed the port number use the configured port
       port: tcp://[athomzbbrdg_ip]:8888
    • For serial (USB) rather than network communication, [serial_id] needs to be replaced Athomzbbrdg ZHA Configuration
      port: [serial_id]

Connecting to a separate Zigbee2MQTT installation may require further setup.

Zigbee2MQTT Remote Adapter Guide