v2.0.0
> #### New features * Added support for USB interface between the HOST and the concentrator, for sx1250 based concentrator only. * Added support for Listen-Before-Talk for AS923 region, using the additional sx1261 radio from the Semtech Corecell reference design v3. * Added support for Spectral Scan with additional sx1261 radio from the Semtech Corecell reference design v3. * Added support for SX1303 chip, for further Fine Timestamping support. * Merged the master-fdd-cn490 branch to bring support for CN490 Full-Duplex reference design. It is an integration of the releases v1.1.0, v1.1.1, v1.1.2 described below. > #### Changes * HAL: Reworked the complete communication layer. A new loragw_com module has been introduced to handle switching from a USB or a SPI communication interface, aligned function prototypes for sx125x, sx1250 and sx1261 radios. For USB, a mode has been added to group SPI write commands request to the STM32 MCU, in order to optimize latency during time critical configuration phases. * HAL: Added preliminary support for Fine Timestamping for TDOA localization. * HAL: Updated AGC firmware to v6: add configurable delay for PA to start, add Listen-Before-Talk support. * HAL: Added new API function lgw_demod_setconf() to set global demodulator settings. * HAL: Added new API functions for Spectral Scan. * Packet Forwarder: The type of interface is configurable in the global_conf.json file: com_type can be "USB" or "SPI". * Packet Forwarder: Changed the parameters to configure fine timestamping in the global_conf.json. * Packet Forwarder: Added sections to configure the spectral scan and Listen-Before-Talk features. * Packet Forwarder: Added a new thread for background spectral scan example, to show how to use the spectral scan API provided by the HAL, without interfering with the main tasks of the gateway (aka Receive uplinks and transmit downlinks). * Packet Forwarder: Added "nhdr" field parsing from "txpk" JSON downlink request in order to be able to send beacon request from Network Server. * Packet Forwarder: Added chan_multiSF_All in global_conf.json to choose which spreading factors to enable for multi-sf demodulators. * Packet Forwarder: Updated PROTOCOL.md to v1.6. * Tools: added util_spectral_scan, a standalone spectral scanner utility. > #### Notes * This release has been validated on the Semtech Corecell reference design v3 with USB interface. v1.1.2 > Integrated in ***v2.0.0*** from ***master-fdd-cn490*** branch. * packet forwarder: updated global_conf.json.sx1255.CN490.full-duplex with RSSI temperature compensation coefficients, and updated RSSI offset for radio 1. v1.1.1 > Integrated in ***v2.0.0*** from ***master-fdd-cn490*** branch. * HAL: Updated SX1302 LNA/PA LUT configuration for Full Duplex CN490 reference design. * test_loragw_hal_rx/tx: added --fdd option to enable Full Duplex * packet forwarder: updated global_conf.json.sx1255.CN490.full-duplex for CN490 reference design. v1.1.0 > Integrated in ***v2.0.0*** from ***master-fdd-cn490*** branch. * HAL: Added support for CN490 full duplex reference design.
This commit is contained in:
Michael Coracin
parent
6291e62ef9
commit
2c14708bdb
107 changed files with 13516 additions and 3249 deletions
85
util_spectral_scan/readme.md
Normal file
85
util_spectral_scan/readme.md
Normal file
|
|
@ -0,0 +1,85 @@
|
|||
______ _
|
||||
/ _____) _ | |
|
||||
( (____ _____ ____ _| |_ _____ ____| |__
|
||||
\____ \| ___ | (_ _) ___ |/ ___) _ \
|
||||
_____) ) ____| | | || |_| ____( (___| | | |
|
||||
(______/|_____)_|_|_| \__)_____)\____)_| |_|
|
||||
(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.
|
||||
|
||||
```bash
|
||||
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*
|
||||
Loading…
Add table
Add a link
Reference in a new issue