Menu

πŸ”Ž How to upgrade Zigbee firmware in ZHA and Z2M

Overview

When SONOFF Zigbee devices are integrated into ZHA or Zigbee2MQTT (Z2M), they can be updated via OTA (Over-The-Air) if the latest firmware has been published to the respective platform's repository. This guide explains how to perform the firmware upgrade.

*Note

  • Due to the different scopes of application of firmware changes, the firmware versions in open-source platforms may differ from those available in the eWeLink app.
  • For models that have not had any firmware updates released yet, ZHA will display the firmware information as “Unknown.”

Zigbee Home Automation (ZHA)

HA Settings Menu

Acquired updates will appear directly at the top of the settings menu.

After clicking the update reminder, you can choose to skip this version or start the update.

Device Information Page

After clicking the device you want to update in the device list, you will be redirected to the information page of this device. At this time, click the firmware section to see the pop-up window for executing the upgrade.

Zigbee2MQTT (Z2M)

OTA Section

The OTA option can be seen at the top of the Z2M frontend.

After you actively click Check for Updates or the platform responds to a device request, an Update Firmware button will appear on the right side of the device where an update is available.

After initiating the update, the upgrade progress and estimated remaining time will be displayed where the upgrade button originally was.

Previous
πŸ”Ž How to add zigbee devices with Home Assistant using ZHA integration
Next
πŸ”Ž How to mount ERBS with SONOFF MINI-RBS
Last modified: 2025-07-24