1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00
RIOT/examples/spectrum-scanner/tools/README.md

41 lines
1.2 KiB
Markdown
Raw Normal View History

# RIOT Spectrum Scanner Application
## About
This script can be used to plot the radio signal spectrum when a connected node
is running the spectrum-scanner application application located in the parent
directory.
This node scans over the available radio channels performing CCA measurements
and outputting the measured ED level via a serial port. This output is then
parsed by the `plot_rssi.py` script included in this folder run on a host computer.
## Dependencies
The `plot_rssi.py` script requires [pyserial](https://pypi.python.org/pypi/pyserial)
for the serial port access, and [matplotlib](https://matplotlib.org) and
[numpy](http://www.numpy.org) for the plotting functionality.
Installing the dependencies:
#### Debian/Ubuntu
apt-get install python-serial python-matplotlib python-numpy
#### PIP
pip install pyserial matplotlib numpy
## Usage
General usage:
1. Flash a RIOT node with the spectrum-scanner application from
(https://github.com/RIOT-OS/applications/tree/master/spectrum-scanner)
2. Run the `plot_rssi.py` script
```
$ ./plot_rssi.py <tty> -b <baudrate>
```
### Examples
![Example screenshot](https://github.com/RIOT-OS/applications/tree/master/spectrum-scanner/tools/example.png)