IEEE 802.15.4 Transceiver

This library provides an high level API for IEEE 802.15.4 communication using the ESP32's built-in radio. It supports initializing the transceiver, transmitting and receiving frames, setting receive callbacks, and dynamically switching channels (11-26) in promiscuous mode.

This library was inspired by shoderico's esp_ieee802154-transceiver ESP-IDF component, extended and refactured for C++.

This library enables ESP32 devices to send and receive custom low-power IEEE 802.15.4 wireless packets, making it suitable for building lightweight device-to-device links such as sensor networks, telemetry systems, remote controls, or custom mesh communication without using Wi-Fi or Bluetooth.

Features

• Initialize the IEEE 802.15.4 radio in promiscuous or filtering mode for flexible frame capture.
• Transmit and receive IEEE 802.15.4 frames with support for custom frame structures.
• Register callbacks to process received frames.
• Arduino Stream integration
• Maximum thruput w/o ack is around 23100 bytes/second (=185 kbps)

Requirements

• ESP32 with IEEE 802.15.4 support (e.g., ESP32-C6, ESP32-H2).

Documentation

• Class Documentation

  • ESP32TransceiverIEEE802_15_4
  • ESP32TransceiverStreamIEEE802_15_4

• ESP API used by this project

  • ESP IDF IEEE802.15.4 API

• Examples

  • sniffer
  • transceiver
  • stream_send
  • stream_receive

Installation in Arduino

You can download the library as zip and call include Library -> zip library. Or you can git clone this project into the Arduino libraries folder e.g. with

cd  ~/Documents/Arduino/libraries
git clone https://github.com/pschatzmann/ESP32TransceiverIEEE802_15_4

I recommend to use git because you can easily update to the latest version just by executing the git pull command in the project folder.

Contributing

Contributions are welcome! Submit issues or pull requests to the repository.