mirror of
https://github.com/RIOT-OS/RIOT.git
synced 2024-12-29 04:50:03 +01:00
41 lines
1.2 KiB
Markdown
41 lines
1.2 KiB
Markdown
|
# 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)
|