05416800cd
> #### Updates The fine timestamping feature has been fully validated with this release. > #### Changes * HAL: Adjusted the freq_offset field of received packets, to take into account the channel IF resolution error. * HAL: Refined the fine timestamp offset compared to Gateway v2, by taking into account the frequency offset of the received packet. * HAL: Fixed the preamble length for FSK downlinks * MCU: Removed the binary compiled in debug mode. * util_spectral_scan: actually use the nb_scan input argument which was ignored. |
||
|---|---|---|
| .. | ||
| src | ||
| Makefile | ||
| plot_rssi_histogram.py | ||
| readme.md | ||
readme.md
______ _
/ _____) _ | |
( (____ _____ ____ _| |_ _____ ____| |__
\____ \| ___ | (_ _) ___ |/ ___) _ \
_____) ) ____| | | || |_| ____( (___| | | |
(______/|_____)_|_|_| \__)_____)\____)_| |_|
(C)2020 Semtech
Spectral Scan Utility
1. Introduction
This software allows to scan the spectral band using the additional sx1261 radio of the Semtech Corecell reference design. It computes a RSSI histogram on several frequencies, that will help to detect occupied bands and get interferer profiles. It logs the histogram in a .csv file.
2. Command line options
2.1. General options
-h
will display a short help and version informations.
2.2. SPI options
-d spidev_path
specifies the spi_dev path to be used to acces the sx1261 radio.
2.3. USB options
-u -d tty_path
specifies the tty path to be used to acces the MCU which will redirect commands
to the sx1261 radio.
3. Usage
This utility is autonomous and will perform a full initialization of the concentrator. So it cannot be run in parallel of the packet forwarder.
It will scan channels as specified on the command line, the first channel being the given frequency (-f argument) and the other channels (number given with -n argument) shifted by 200kHz from the previous one.
It then generates a CSV file with the RSSI histogram for each channel.
4. Plotting the results
In order to have a visual representation of the spectral scan results, a python script is provided here. rssi_histogram.csv is the file generated by the spectral_scan utility.
python3 plot_rssi_histogram.py rssi_histogram.csv
The python script uses pylab and numpy packages, so both have to be installed
prior to using the plot_rssi_histogram.py script.
5. Legal notice
The information presented in this project documentation does not form part of any quotation or contract, is believed to be accurate and reliable and may be changed without notice. No liability will be accepted by the publisher for any consequence of its use. Publication thereof does not convey nor imply any license under patent or other industrial or intellectual property rights. Semtech assumes no responsibility or liability whatsoever for any failure or unexpected operation resulting from misuse, neglect improper installation, repair or improper handling or unusual physical or electrical stress including, but not limited to, exposure to parameters beyond the specified maximum ratings or operation outside the specified range.
SEMTECH PRODUCTS ARE NOT DESIGNED, INTENDED, AUTHORIZED OR WARRANTED TO BE SUITABLE FOR USE IN LIFE-SUPPORT APPLICATIONS, DEVICES OR SYSTEMS OR OTHER CRITICAL APPLICATIONS. INCLUSION OF SEMTECH PRODUCTS IN SUCH APPLICATIONS IS UNDERSTOOD TO BE UNDERTAKEN SOLELY AT THE CUSTOMER'S OWN RISK. Should a customer purchase or use Semtech products for any such unauthorized application, the customer shall indemnify and hold Semtech and its officers, employees, subsidiaries, affiliates, and distributors harmless against all claims, costs damages and attorney fees which could arise.
EOF