Embedded_Projects
/
SX1302_HAL
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
SX1302_HAL/util_net_downlink
History
Michael Coracin 2c14708bdb 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.
 		2020-12-09 09:21:09 +01:00
..
src v2.0.0 2020-12-09 09:21:09 +01:00
Makefile v1.0.0 2019-07-12 15:40:13 +02:00
readme.md v1.0.0 2019-07-12 15:40:13 +02:00

readme.md 

  ______                              _
 / _____)             _              | |
( (____  _____ ____ _| |_ _____  ____| |__
 \____ \| ___ |    (_   _) ___ |/ ___)  _ \
 _____) ) ____| | | || |_| ____( (___| | | |
(______/|_____)_|_|_| \__)_____)\____)_| |_|
  (C)2019 Semtech

Utility: Downlink server

1. Introduction

This utility allows to send regular downlink requests to the packet forwarder running on the gateway.

The downlinks are sent in 'immediate' mode, meaning that the SX1302 will send the incoming packet over the air as soon as it receives it.

So, the net_downlink utility will construct a JSON 'txpk' object based on given command line arguments, and send it on a UDP socket on the given port. Then the packet forwarder receives it on its downlink socket, parses the JSON object to build the packet buffer to be sent to the concentrator board.

This utility can be compiled and run on the gateway itself, or on a PC.

Optionally, the net_downlink utility can forward the received uplinks (PUSH_DATA) to another UDP server, which can be useful for uplink Packet Error Rate measurement while performing downlink testing (full-duplex testing etc...)

In can also be used as a UDP packet logger, logging all uplinks in a CSV file.

2. Dependencies

A packet forwarder must be running to receive downlink packets and send it to the concentrator board.

3. Usage

3.1. Packet Forwarder configuration

The 'global_conf.json' file provided with the packet forwarder can be used, only the 'server_address' must be set to 'localhost' if net_downlink is running on the gateway itself, or set to the IP address of the PC on which the utility is running.

3.2. Launching the packet forwarder

The packet forwarder has to be launched with the global_conf.json described in 3.1.

./lora_pkt_fwd -c global_conf.json

3.3. Launching net_downlink

The net_downlink utility can be started with various command line arguments.

In order to get the available options, and some examples, run:

./net_downlink -h

To stop the application, press Ctrl+C.