# Zigbee MAC Interface
This crate contains the required MAC layer primitives of the IEEE 802.15.4 standard used by the Zigbee's protocol higher layers.
The `Mlme` trait is the seam between the stack and the radio: everything above it
is generic over the implementation, so the stack itself stays free of any chip or
vendor dependency.
## Contents
| MLME | `Mlme` — scan, associate, transmit and receive primitives driven by the NWK layer |
| Configuration | `MacConfig`, `ScanType`, `ScanResult`, `PanDescriptor`, `AssociationResponse` |
| Addressing | `Address`, `ExtendedAddress`, `PanId`, `MacShortAddress`, re-exported from [`ieee802154`](https://crates.io/crates/ieee802154) |
| Errors | `MacError` |
## Radio backends
| ESP32-C6 | `esp32c6` | available, hardware-tested |
| ESP32-H2 | `esp32h2` | available, hardware-tested |
| ESP32-C5 | `esp32c5` | available, compile-tested only |
| any other radio | — | implement `Mlme` yourself |
These three are the only Espressif SoCs with an 802.15.4 radio.
They share one `esp-radio` backed backend (`zigbee_mac::esp`), and the chip feature only selects
which chip the `esp-*` crates are built for. The features are mutually exclusive, and no backend is enabled by default.
Implementing `Mlme` is the only thing a new platform needs; nothing above this crate has to change.
## 🏛️ License
Licensed under either of:
- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)
## 🧩 Contribution
This is a free and open project and lives from contributions of the community.
See our [Contribution Guide](CONTRIBUTING.md)