Skip to content

zigbee-bridge 0.2.0

Choose a tag to compare

@github-actions github-actions released this 20 Nov 02:50
· 13 commits to main since this release

zigbee-bridge 0.2.0 adds Texas Instruments Z-Stack and dresden elektronik ConBee/RaspBee coordinators, channel change, device firmware updates (OTA), and restoring a backup onto a coordinator of another family.

Status: early. Every coordinator family is tested in CI against the coordinator simulator, but no release has been tested on real hardware yet. Keep a backup of your network, and please report how it goes on your coordinator.

New

  • Texas Instruments Z-Stack coordinators (ZNP): Z-Stack 3.x.0 on CC2652 and CC1352 sticks (Sonoff ZBDongle-P, SMLIGHT SLZB-06 and others), and Z-Stack 3.0.x on CC2530/CC2531. Z-Stack Home 1.2 is refused; probe still identifies it.
  • ConBee II, ConBee III and RaspBee II with deCONZ firmware 0x26580700 or newer.
  • The coordinator family is detected. The new serial.adapter setting defaults to auto, which probes the port for EZSP, then ZNP, then deCONZ; set ezsp, znp or deconz to skip the probe. zigbee-bridge probe PORT now reports the family and product.
  • Channel change without pairing devices again: the change_channel request ({"channel": 20}) and a channel_changed event. The new channel is saved, and bridge/info gains network.update_id.
  • Device firmware updates from OTA image files you put in <data dir>/ota (or [ota] dir): ota_check and ota_update requests, with ota_available, ota_progress and ota_finished events. Nothing is offered to a device unless you ask. Tested against the simulator only: try one device first.
  • Restore across families: a backup restores onto a coordinator of any supported family, and backups written by other hosts in the open coordinator backup format can be read.

What each family cannot do

Readings a coordinator family does not provide are left out rather than guessed:

  • Z-Stack reports no signal strength, link key exchanges or ZDO delivery; Z-Stack enforces join.allow_legacy = false itself.
  • deCONZ reports no joins or leaves (the bridge learns of a device from its announce) and keeps one trust center link key, so join.install_code_only is refused and join.allow_legacy = false is not enforced.

For developers

New crates: zigbee-znp and zigbee-deconz. In zigbee-host: ZnpAdapter, DeconzAdapter, AnyAdapter, probe_any, Host::change_channel, Host::active_scan, Host::leave, the OTA server (ota, Host::ota_check, Host::ota_update). Breaking: AdapterEvent and FrameLink carry signal strength as Option, NcpKind is #[non_exhaustive], Host::network returns the network by value, and zigbee-sim's SimConfig names the family with ncp: SimNcp. The simulator plays all three families (zigbee-ncp-sim --ncp ezsp|znp|deconz).

Upgrading

Replace the binary and restart; 0.1.0 configuration files work unchanged. Static binaries for x86_64, aarch64 and mipsel, with SHA256SUMS, are attached below; the quick start and the documentation cover new installs.

Full list of changes: CHANGELOG.md.