2.6 KiB
| Supported Targets | ESP32-H2 |
|---|
OpenThread radio co-processor (RCP) example
Overview
This example demonstrates an openthread radio co-processor. The RCP can receive/transmit 15.4-type packets, encode and send the packet to the host device. You can use the RCP to implement an Openthread sniffer. You cani also connect the RCP to the host device which do not have a 15.4-radio to join in an Openthread network.
To run this example, an ESP32-H2 board is required.
Config ESP32-H2 uart
Modify the file esp_ot_config.h.
In the file esp_ot_config.h, there are three parameters.
As for ESP_OPENTHREAD_DEFAULT_RADIO_CONFIG and ESP_OPENTHREAD_DEFAULT_PORT_CONFIG, modification is not recommended.
As for the parameters in ESP_OPENTHREAD_DEFAULT_HOST_CONFIG, you can refer to ESP uart example example/peripherals/uart/uart_echo/README.md
Build, Flash, and Run
Build the project and flash it to the board
idf.py -p <PORT> build flash
Now you'll get an ot-rcp (for this example, there is no output in console).
OpenThread sniffer example (Linux or macOS based)
Overview
This example is about how to run a sniffer to capture Thread packet, which refers to openthread.io. Openthread group just supports Linux and macOS.
How to use example
Hardware connection
To run this example, you need an ESP32-H2 borad flashed with ot-rcp application.
Set up the sniffer environment
The sniffer tool connects to an openthread RCP device and converts it into a promiscuous packet sniffer. RCP will encode and send the packet to host after capturing a 15.4-type packet. On the host, Pyspinel should be run for decoding the packet and generating a pcap (packet capture) stream to be saved or piped directly into Wireshark.
Clone and install Pyspinel and dependencies, refer to openthread.io.
Install and config Wireshark
For installing the Wireshark, refer to Espressif Wireshark User Guide.
You need to config Wireshark with some properties for the Thread network. For Wireshark configuration, refer to openthread.io.
Run the sniffer
For example, to sniff on Channel 15 using a device mounted at /dev/ttyUSB0 with the baudrate 115200 in the Wireshark output:
cd ~/pyspinel
python sniffer.py -c 15 -u /dev/ttyUSB0 --crc -b 115200 | wireshark -k -i -