Changelog
Changelog
All notable changes to this project are documented here. The format follows Keep a Changelog, and the crates follow Semantic Versioning.
[Unreleased]
[0.3.0] - 2026-11-20
The first release on crates.io.
Changed
zigbee-typesis renamedzigbee-primitives(cratezigbee_primitives), since crates.io already has azigbee-types. Replace the dependency and theusepaths; nothing else changes.
Added
- The crates are ready for crates.io: descriptions, docs.rs links, each
crate’s README as its crates.io page, and packages that carry only the
sources, README, license and the tests that run from the package. CI dry
runs
cargo publish --workspaceon every push, and a version tag publishes the crates in dependency order.
[0.2.0] - 2026-11-20
Texas Instruments Z-Stack and dresden elektronik deCONZ coordinators, channel change, an OTA upgrade server, and backups that restore onto any coordinator family.
Added
zigbee-znp: Texas Instruments Z-Stack MT frames, typed requests and indications in both directions, and an async client, for Z-Stack 3.x.0 and 3.0.x.zigbee-host:ZnpAdapter(formation with a random link key seed, resume, install codes, raw ZDO both ways, backup and restore with the frame counter advanced, energy scan), andAnyAdapterto choose the family at run time.zigbee-host:probeidentifies Z-Stack coordinators (NcpKind::Znp,NcpIdentity::product);probe_anytries every family andprobe_streamprobes an open stream.zigbee-host: backups carry Z-Stack’s link key seed (stack_specific.zstack.tclk_seed).zigbee-deconz: the deCONZ serial protocol (ConBee, RaspBee): SLIP framing, typed requests and responses, and an async client.zigbee-host:DeconzAdapter(formation from parameters, the firmware’s queues read on every device state, the firmware watchdog refreshed, backup and restore, energy scan) andNcpKind::Deconzin the probe.zigbee-host: a device first heard of by its announce counts as joined (HostEvent::DeviceJoined), for coordinators that report no joins.zigbee-sim: ZNP and deCONZ front-ends (SimNcp::Znp,SimNcp::Deconz) on the same simulated network as EZSP;zigbee-ncp-sim --ncp.zigbee-bridge:serial.adapter(auto,ezsp,znp,deconz);autoprobes the port.zigbee-host:Host::change_channelmoves the network to another channel on every family (a network update broadcast with the next update id, then the coordinator confirmed on the new channel), withHostEvent::ChannelChangedandAdapter::network_info.zigbee-bridge: thechange_channelrequest ({"channel": 20}), thechannel_changedevent,network.update_idinbridge/info; the new channel is saved tonetwork.json.zigbee-host: an OTA Upgrade server:otareads OTA files (vendor prefixes included) from a directory and serves blocks from disk;Host::ota_checkandHost::ota_updatenotify a device and answer its query, image block and page requests and upgrade end;HostEvent::OtaQuery,OtaProgress,OtaFinished. Nothing is offered withoutota_update.zigbee-bridge:ota_checkandota_updaterequests (answered when the device responds),ota_available,ota_progressandota_finishedevents, and[ota] dir(default<data.dir>/ota).zigbee-sim: an OTA client on the simulated plug (SimFirmware).zigbee-host: a backup restores onto a coordinator of any family: the IEEE address, PAN ids, channel, network key and frame counter (advanced) always; Z-Stack’s link key seed or EmberZNet’s root key when restoring onto the same family, and the backup’s per-device link keys otherwise. Backups written by other open-coordinator-backup hosts read as well.zigbee-host:Adapter::active_scanandHost::active_scan(other networks’ beacons: EmberZNet’s network-found callbacks, Z-Stack’s network discovery; deCONZ has none),Adapter::leaveandHost::leave(erase the network from the coordinator and forget every device), andHost::set_install_codes(replace the whole list, checked first).zigbee-ezsp: thenetworkFoundHandlercallback.zigbee-znp:ZDO_NWK_DISCOVERY_REQ, beacon notifications and the discovery confirm.zigbee-sim: networks in range (SimConfig::neighbors).
Changed
zigbee-host:AdapterEvent::Message,AdapterEvent::RouteRecordandFrameLinkcarry signal strength (and, for route records, the IEEE address and link quality) asOption, since Z-Stack does not report them.AdapterInfogainsreports_key_exchange.NcpKindis#[non_exhaustive].zigbee-host:Host::networkreturns the network by value (it changes with the channel).zigbee-sim:SimConfignames the family withncp: SimNcp;SimNetworkis family-neutral (channel,pan_id, … instead of EmberZNet’s network parameters).
[0.1.0] - 2026-11-19
The first milestone: Silicon Labs EmberZNet coordinators.
Added
zigbee-types: IEEE addresses, extended PAN ids, keys redacted fromDebug, and a bounds-checked wire reader.zigbee-ash: ASHv2 framing (CRC, byte stuffing, randomization), checked against UG101’s byte examples, and the link layer as a sans-IO state machine with a tokio driver.zigbee-ezsp: EZSP frames for protocol versions 13 to 19 (EmberZNet 7.4 to 8.x) in both directions, and an async client.zigbee-zcl: ZCL data types, values, frames, global commands, and 41 clusters generated fromdata/clusters.toml.zigbee-zdo: ZDO requests and responses.zigbee-host: network formation with caller-supplied keys, Zigbee 3.0 trust center with unique link keys and install codes, a resumable interview, reporting configuration and IAS zone enrollment, the device store, backups in the open coordinator backup format and restore onto new hardware, topology from last hops, route records and neighbor scans, andprobe.zigbee-sim: an EZSP NCP simulator with simulated sensors, plugs and contact sensors, andzigbee-ncp-sim.zigbee-bridge: the standalone MQTT bridge with Home Assistant discovery.zigbee-host:HostEvent::Frame, every ZCL frame from a device exactly as received with how it arrived (endpoints, profile, cluster, group, link quality, last hop), for embedders with their own device library.zigbee-host:Host::zcl_rawandHost::zdo_rawsend caller-built frames, write the host’s own sequence number, and return the reply as received or wait for APS delivery only.zigbee-host: the interview also reads the ZCL, stack and hardware versions.