ZiGate Wi-Fi v1.3 · Zigbee2MQTT

ZiGate Wi-Fi v1.3 with Home Assistant

Flash the ESP8266 and JN5168 firmware over USB, set up Wi-Fi, then install Zigbee2MQTT ZiGate in Home Assistant. To use the flasher, open this page in Chrome or Edge on a computer.

ZiGate Wi-Fi v1.3 in its translucent case

Install both firmware images

Module to update

USB flashing

Test version

Connect the Wi-Fi module on its own

Wi-Fi 1.1.1

  1. Unplug the ZiGate, open the case and separate the two boards.
  2. Press the small button below the pins.
  3. Plug the Wi-Fi board into USB while holding down the button.
  4. Release the button once the board is connected.
  5. Click Choose USB port, select the port, then click Install firmware.
Wi-Fi board with USB on the left and the small button below the pins on the right
Wi-Fi module button
Download .bin

1b. Set up Wi-Fi over USB

Wi-Fi firmware 1.1.1 is required. If Zigbee2MQTT ZiGate is running, stop it before setup.

  1. If the Wi-Fi module is already connected, unplug it. Connect only the Wi-Fi module, without pressing the button.
  2. Enter your router’s 2.4 GHz Wi-Fi details.
  3. Click Save Wi-Fi settings, then choose the USB port.
Wi-Fi module separated from the radio
Leave the button released.

Leave this field blank if the network is open.

The password is sent to the module over USB.

Set up via the ZiGate access point

3. Reassemble the ZiGate

  1. Unplug both boards. Remove the radio from the USB‑TTL adapter.
  2. Fit the radio onto the Wi-Fi module as shown.
  3. Plug the assembled ZiGate into USB without pressing the buttons.
  4. Find its IP address in your router’s device list.
Reassembled ZiGate with the Wi-Fi module on the left and the radio on the right
The two boards fitted together.
Set up Wi-Fi via the ZiGate access point
  1. Connect the Wi-Fi module via USB without pressing the button. If the old network is still available, turn it off temporarily. The access point appears after about 45 seconds offline.
  2. Read the access point name and key. Connect your computer to that network.

    Choose the USB port used to flash the Wi-Fi module. Leave the ZiGate plugged in and use the displayed key to join ZIGATE-….

  3. Once connected to ZIGATE-…, open 192.168.4.1. Enter the name and password of your router’s 2.4 GHz Wi-Fi network. After the restart, reconnect your computer to your router and find the ZiGate IP address in the router’s device list.

If the USB port doesn’t appear in Windows, open the Windows USB drivers page.

4. Install the Zigbee2MQTT ZiGate app

  1. Click Add the ZiGate repository, then install Zigbee2MQTT ZiGate from the Home Assistant store.
  2. Under Configuration, enter the ZiGate IP address. If you already have a Zigbee network, choose a different channel. Save the settings.
  3. Choose an MQTT broker before starting the app.

Use the address shown after USB setup or the one listed by your router.

Home Assistant Container and YAML configuration

With Home Assistant Container, run a second Zigbee2MQTT instance with its own data directory. Enter your MQTT broker’s address and choose a Zigbee channel different from the one your first network uses.

configuration.yaml
homeassistant:
  enabled: true
mqtt:
  base_topic: zigbee2mqtt_zigate
serial:
  adapter: zigate
  port: tcp://192.168.1.50:9999

5. Set up MQTT and pair your first device

Choose your MQTT setup

Keep using your current broker. Mosquitto in Home Assistant is detected automatically. For an external broker, enter its address and credentials under Zigbee2MQTT ZiGate → Configuration → External MQTT broker.

If MQTT is already connected to this broker, proceed to pairing. Otherwise, configure the MQTT integration using the same broker.

On Home Assistant OS, open the MQTT setup wizard and select the official Mosquitto broker app. Home Assistant installs Mosquitto and sets up the connection.

Open the MQTT setup wizard

On Home Assistant OS, install Mosquitto broker from the store and start it. Under Settings → Devices & services, configure the discovered MQTT integration and confirm the Mosquitto connection.

Open Mosquitto broker
  1. Start Zigbee2MQTT ZiGate, then click Open Web UI.
  2. Click Permit join, then put your device in pairing mode.
  3. Find your device under Settings → Devices & services → MQTT.

Turn on Show in sidebar in the app to access the ZiGate interface from the sidebar.