Repository navigation
zigbee-bridge 0.2.0
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;
probestill identifies it. - ConBee II, ConBee III and RaspBee II with deCONZ firmware 0x26580700 or newer.
- The coordinator family is detected. The new
serial.adaptersetting defaults toauto, which probes the port for EZSP, then ZNP, then deCONZ; setezsp,znpordeconzto skip the probe.zigbee-bridge probe PORTnow reports the family and product. - Channel change without pairing devices again: the
change_channelrequest ({"channel": 20}) and achannel_changedevent. The new channel is saved, andbridge/infogainsnetwork.update_id. - Device firmware updates from OTA image files you put in
<data dir>/ota(or[ota] dir):ota_checkandota_updaterequests, withota_available,ota_progressandota_finishedevents. 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 = falseitself. - 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_onlyis refused andjoin.allow_legacy = falseis 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.