1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-28 23:09:46 +01:00
RIOT/examples/spectrum-scanner
Hugues Larrive 3c465836f2 examples and tests: add atmega8 to relevent Makefile.ci
using dist/tools/insufficient_memory/add_insufficient_memory_board.sh
2023-07-11 21:22:02 +02:00
..
tools Move RIOT-applications into examples 2022-09-20 11:49:33 +02:00
main.c examples/spectrum-scanner: Fix building on PIC32 and RISC-V 2022-09-20 13:46:07 +02:00
Makefile makefiles: Adjust paths of RIOT-applications to run from examples 2022-09-20 11:49:56 +02:00
Makefile.ci examples and tests: add atmega8 to relevent Makefile.ci 2023-07-11 21:22:02 +02:00
README.md Move RIOT-applications into examples 2022-09-20 11:49:33 +02:00

About

This application is designed to run together with the script tools/plot_rssi.py to monitor energy levels on all available wireless channels. This application works with any board with a network device that supports the gnrc network stack (or precisely the gnrc parts up to the link-layer). Further, in order to get any measurements from the device, the network device and its driver needs to support the netopt options for executing a manual CCA and getting the last ED level (NETOPT_IS_CHANNEL_CLR, and NETOPT_LAST_ED_LEVEL, respectively). Finally the board needs to include auto-initialization code for the targeted network device.

Usage

Compile and flash this application to the board of your choice. You can check if everything on the RIOT side works by connecting to the board via UART and looking at the output.

Data format

The format of the data on the UART is:

[interface_number, timestamp, count] channel: ed_level, channel: ed_level, ...

where interface_number is the interface number (in RIOT's ifconfig), timestamp is the time since power on in microseconds, count is the number of measurements that were averaged, channel is a channel number, ed_level is the average energy level for that channel since the last update.

For further information on setting up the host part, see tools/README.md.