Setting up a Zigbee network in HomeSeer HS4 can sometimes run into a specific hurdle: the software may fail to set the correct baud rate for your coordinator automatically. This often leads to connection failures or an unresponsive Zigbee interface.


If you are using a Z-Stick 10 Pro or a similar Silicon Labs-based coordinator, follow this specific sequence of steps to resolve the serial connection issues.



Step 1: Update Your Firmware


HomeSeer’s integration relies on Zigbee2MQTT. For the best compatibility and stability, ensure your Zigbee coordinator isrunning the latest firmware. You can find the latest update and steps to updating using Teraterm here: Z-Stick 10 Pro Update - Zigbee (V7.4.3) with Teraterm on Windows. 



Step 2: Install Latest UART Drivers


The serial connection between your hardware and Windows can be finicky if you are using generic or outdated drivers.


  1. Navigate to the Silicon Labs CP210x VCP Drivers page.

  2. Download the CP210x Universal Windows Driver (usually the top selection).

  3. Install the driver and restart your machine if prompted. This step is critical for resolving underlying serial communication errors.



Step 3: Manually Configure the Baud Rate


Since HomeSeer may not be pushing the correct baud rate to the configuration, you will need to manually edit the configuration.yaml file.


  1. Locate the ZigbeePlus Folder: Navigate to: C:\Program Files (x86)\HomeSeer HS4\Data\ZigbeePlus\zigbee2mqtt (Or wherever HomeSeer HS4 is installed in)

  2. Find your Data Folder: Open the folder named data_x. (Note: The number x may increase if you have previously deleted and recreated Zigbee networks).

  3. Edit configuration.yaml:

    Open the file in Notepad or a code editor. Under the serial: section, manually add the baud rate and flow control lines:


serial:
  port: COMx  # Your specific COM port  
  adapter: ember
  baudrate: 115200  
  rtscts: true




Step 4: Restart the Integration


Once you have saved the changes to the YAML file:


  • Go to your HomeSeer Web Control interface.

  • Disable the Zigbee plugin/integration.

  • Re-enable the Zigbee plugin.


The integration should now recognize the serial port at the correct speed and initialize the network successfully.

Note: Manually setting rtscts: true is often the missing link for hardware like the Z-Stick 10 Pro, as it ensures the hardware flow control is correctly synchronized with the driver.