Connecting to Open-source Platforms
Connecting to Home Assistant via Zigbee2MQTT
Table of contents
Step 1 Preparation ---- Step 2: install add-ons ---- Step 3: Configure the GW90-POE-Ti ---- Step 4: Add a Zigbee Sub-device
Step 1 Preparation
Before getting started, ensure that Home Assistant is installed and the GW70-XK is connected to the host’s USB port.
If not yet installed, please follow the Home Assistant Installation Guide.
When connecting HA through the Zigbee2MQTT Add-on, you need to install two add-ons:
1、Mosquitto broker (MQTT Broker)
2、Zigbee2MQTT
Go to Settings → Add-ons → Add-on store and install the Mosquitto broker add-on, then start it.
Install Zigbee2MQTT
Go to Settings → Add-ons → Add-on store and install the Zigbee2MQTT add-on, then start it.
Open the Zigbee2MQTT add-on→ start → Open web UI .Then configure according to the video below.
WiFi/ LAN Connection
Open the Zigbee2MQTT add-on→ Configuration→serial. Enter port and adapter information.
(port and adapter information can be find in dongle web management interface)
After completing the configuration, start the Zigbee2MQTT add-on. Wait for about two minutes,
then you can click to enter the Web UI Console to add and manage devices.
Connecting to Home Assistant via ZHA
Step 1 Preparation ---- Step 2: install Integration ---- Step 3: Configure the GW90-POE-Ti ---- Step 4: Add a Zigbee Sub-device
Step 1 Preparation
Before getting started, ensure that Home Assistant is installed and the GW90-POE-Ti is connected to WiFi router. If not yet installed,
please follow the Home Assistant Installation Guide
When connecting HA through ZHA, you need to install Zigbee Home Automation Integration.
Install Zigbee Home Automation Integration (port information can be find in dongle web management interface)
USB Connection
WiFi/ LAN Connection
Step 3: Add and manage zigbee devices
After completing the configuration, start the ZHA. Wait for about two minutes,
then you can click to enter the Web UI Console to add and manage devices.
Power Supply and Connection
Overview
Before installation, please choose a suitable connection method based on your usage habits or scenario:
Device Power Supply
before powering on the device, please check whether your router or switch supports PoE (Power over Ethernet).
Connection
The device connects to the home assistant host USB port, using the included Type-C USB cable, functioning as a USB dongle.
Use a Type-C charging cable: connect one end to the device’s Type-C port, and the other end to the host device.
Once powered on, the device power indicator icon will turn on, indicating that the device is receiving power properly.
Then press the button on the dongle, make the icon switch to USB mode.then you can Connecting to Open-source Platforms
At this point, you may proceed to the Accessing the Operating System section for the next steps.
Note: If you intend to use the WEB Console, an additional Ethernet or Wi-Fi connection is required.
The device connects wirelessly via Wi-Fi.Use a Type-C charging cable: connect one end to the device’s Type-C port,
and the other end to a power adapter.Once powered on, the device power indicator incon will turn on,
Then press the button on the dongle,make the indicator light switch to “WiFi”,
(After press the button need waiting for 3-5s switch to wifi mode) then the dongle will into wifi mode
The device’s AP hotspot is enabled by default when dongle in wifi mode. On your PC or mobile device,
search for the AP SSID such as AVATTO-GW90-TI_XXXX. The first connection does not require a password.
After connecting to the AP hotspot, the browser will automatically open the WEB interface.
If the browser does not open automatically, you can access the page manually via the default domain http://AVATTO-GW90-TI.local.
Enter the WEB interface, General---WiFi mode---Save, Then it will be redirected to the Wi-Fi scanning interface.
choose the appropriate Wi-Fi network, and connect.Wait for the device to connect to the router. once accessed successfully,
you can use all WEB functions.
After ensuring normal network communication, plug the network cable into the network port. Wait for Dongle to start.
Then access the page manually via the default domain http://AVATTO-GW90-TI.local.Configure dongle through the web management interface.
Note: Before flashing the device to Zigbee Coordinator mode, you must first upgrade the ESP32 firmware. Failure to do so will prevent the flashing process from completing successfully.
This device defaults to Zigbee Coordinator mode from the factory.
1. Correctly connect the device to a power source.
2. Connect the device to your router using an Ethernet cable.
3. Open http://avatto-gw90-ti.local/ and follow the video instructions below to upgrade the ESP32 firmware.
Note: Before flashing the device to Router mode, you must first upgrade the ESP32 firmware. Failure to do so will prevent the flashing process from completing successfully.
1. Correctly connect the device to a power source.
2. Connect the device to your router using an Ethernet cable.
3. Open http://avatto-gw90-ti.local/ and follow the video instructions below to upgrade the ESP32 firmware.
Note: Before flashing the device to Router mode, you must first upgrade the ESP32 firmware. Failure to do so will prevent the flashing process from completing successfully.
There are two methods to upgrade the ESP32 firmware:
1: Install the Silicon Labs CP2102 driver on Windows or macOS to enable proper recognition of the device connected via USB.
Download the Silicon Labs CP2102 Driver: https://www.silabs.com/software-and-tools/usb-to-uart-bridge-vcp-drivers?tab=downloads
2: Connect the GW90-POE-Ti to the computer's USB port using the supplied USB cable. Then navigate to My Computer → Device Manager to view the USB port number.
3: Open the following website: https://dongle.avattosmart.com/ to complete the upgrade.
1. Correctly connect the device to a power source.
2. Connect the device to your router using an Ethernet cable.
3. Open http://avatto-gw90-ti.local/ and follow the video instructions below to upgrade the ESP32 firmware.
Cross-Brand Compatibility ：Devices from different manufacturers, such as sensors, door locks, and bulbs, can be integrated into a single system.
Bank-Level Encryption：Communication data is fully encrypted to prevent eavesdropping and tampering.
Large Capacity and Stability：A single network supports over 250 devices, making it suitable for whole-home smart applications.
Ultra-Low Power Consumption：Battery-powered sensors (e.g., door/window sensors, temperature and humidity monitors) can operate for several years without frequent battery replacement.
Smart Home Lighting, sensors, door locks
Industrial Data Collection Temperature/humidity monitoring, pressure monitoring
Commercial Building Automation Elevator integration, energy management
Medical Monitoring Smart Agriculture, and other low-power IoT applications
However, many manufacturers do not fully comply with the open Zigbee 3.0 standard.
Instead, they add proprietary encapsulation at the application layer on top of the public protocol. This results in mutually incompatible device identification and communication mechanisms.
A manufacturer's Zigbee products can only be controlled by that manufacturer's own gateway.
They cannot be controlled by other manufacturers' gateways.
Zigbee products from different manufacturers cannot communicate directly with each other.
Manufacturer A's products → Must use Manufacturer A's gateway
Manufacturer B's products → Must use Manufacturer B's gateway
The AVATTO GW90 Zigbee 3.0 PoE Dongle is designed and manufactured to solve this exact problem. When used with the Home Assistant open-source system, it can integrate and manage Zigbee devices from different manufacturers (provided that the devices comply with the standard Zigbee protocol). All devices can be controlled through the Home Assistant App. You do not need to purchase any additional Zigbee gateway.
PoE Power Supply – No separate power adapter is required. A single Ethernet cable provides both power and network connection, making installation cleaner and simpler.
Multiple Connection Options – Supports Ethernet (including PoE), Wi-Fi, and USB. This allows flexible adaptation to different installation environments.
Plug and Play – Out of the box, the device is pre-configured as a Zigbee Coordinator, seamlessly integrating with Home Assistant for quick and easy setup.
Flashable to Router Mode – The same hardware can be re-flashed to function as a signal repeater (Router mode) to extend network coverage.
The GW90 Zigbee 3.0 PoE Dongle is ready to use out of the box. It offers three ways to connect to the Home Assistant Box: Ethernet, Wi-Fi, and USB. In addition, the device supports PoE power supply, allowing it to be placed flexibly anywhere in your home.
Once you have completed the connection and configuration between the device and your Home Assistant Box, you can use it to add Zigbee products in your home. At this point, the device functions as a Zigbee Coordinator.
If you perform a firmware update and flash the device to Router mode, the device will be transformed into:
A Zigbee Router – used for signal relaying and extending network coverage.
Important Note:
After flashing to Router mode, the device no longer functions as a Zigbee Coordinator.
You cannot add new Zigbee products through this device.
It is intended solely for extending the coverage of an existing Zigbee network.
At this point, please note the following changes:
| Functionality | Coordinator Mode (factory default) | Router Mode (after flashing) |
| Adding new Zigbee devices | ✅️ Supported | ❌️ Not supported |
| Signal Repeating / Network Extension | ❌️ Not supported | ✅ Supported |
