The HAL provided by Kerlink is based on new Semtech HAL lora_gateway_v2.
Main modifications aim to adapt HAL to Kerlink boards:

• Multi-board support
• Calibration parameters can now be parsed as an overload config file (similarly to local_conf.json) named /tmp/calib_loraloc.json

As Loraloc architecture is much more complex, this HAL is quite different from HAL v1.

To compile it, please use following commands:

cd lora_gateway_v2
source /opt/toolchains/keros/environment-setup-cortexa9hf-neon-poky-linux-gnueabi
make SPI_HOST=imx

To simplify deployment on board, Kerlink provides a script called build_package.sh.
This tool script make all tools and prepare an OPKG package including them.

The main modification in tools since HALv1 is the '-d' argument.
As this HAL is mainly designed to handle multiple RF chips, this optional argument allows to specify which spidevice to use.

Kerlink provides a automatic discovery script at startup to handle correctly plugged boards.

By default, if a WAN module is provided, loraloc modules are mapped from slot 2.

So to use tools with this Loraloc module, please specify on tool's command-line -d /dev/slot/2/spidev0.
For example:

./pkt_logger -d /dev/slot/2/spidev0

Due to architecture, the configuration is quite more complex than HAL v1:

• board keyword means “Loraloc board” or “LoraLoc module” (one “board” by slot)
• each board includes 2 chip configs (i.e. sx1301 configs)
• each board includes 2 rfchain configs

This configuration must include SX1301 channel config.
These channels can be configured through “sx1301ar_conf_chan” function.
Please note that this function takes as “channel number” the concatenation of chip number and channel. (see function description in sx1301ar_hal.h)

This configuration is mainly used to correct RSSI and TX power values.
Corresponding calibration values are set in Production by Kerlink and extracted during board startup in /tmp/calib_loraloc.json file.

Thanks to ad9361 transceiver chip. We are able to get +-0.25 dBm precision on real TX power.
As a consequence, up to 32 power steps (tx_lut) are generated and calibrated in production.

The JSON configuration file has been improved to simplify software by using JSON tables.
Indeed:

• The main Radio config object “SX1301_array_conf” is now a table to support multiple boards
• “rf_chain_conf” is also a 2-objects-sized table
• “SX1301_conf” is a 2-objects-sized table
• “tx_lut” is a variable table (up to 32 objects)

The radio scanner can be addressed by a serial port from host CPU. The COM port can be retreived in the platform json description file /tmp/sys_startup_status.json, modem COM port is contained inside the field “module”.“acm_path”. The modem is identified by its physical location given in the field “module”.“position”.

The command to enable an spectrum scanning is sx1239 with the following parameters:

• scan mode : need to be fl
• number of path : need to be 1 for Lora Dual modem
• start frequency in Hertz
• stop frequency in Hertz
• frequency step in Hertz (should be 62500)
• frequency bandwith in Hertz (should be 62500)
• Bitrate (should be 600)
• loop number, set to 0 for an infinite scanning

Example:

sx1239 fl 1 863000000 870000000 62500 62500 600 0\r

The spectrum data are returned line by line separated by a \r\n, each line correspond to a complete scan of the band. The format is ASCII and respects the following protocol:

[PATH] : [DURATION] : [DATA] [FIN]

Where :

• [PATH] : radio path number : 0 or 1 (always 0 for Lora Dual modem)
• [DURATION] : duration of the scan of the full band expressed in milli-seconds coded as a decimal
• [DATA] : N x data coded as hexascii between 00 and FF, it expresses the opposite of the received power (-RSSI)
• [FIN] : synchro character: \r\n (0x0D 0x0A)

Exemple

0:915:7F7F807F80807F80807F7F7F7F7F7E7E777E7F7E7F7F807F7F7F7F80807F7F7F807F7F7F807F7F7F807F7F7F807F7F80807F7F7F7F807F807F7F7F7F807F7F7F7F807F7F7F7F7F7F7F7F7F7F80807F7F7F7F7F7F7F7F7F807F7F7F807F807F7F7F7F7F7F7F7F7F807F807F807F7F7F7F7E
0:915:7F7F8080807F7F7F7F807F7F7F7F7E7E777E7F7F7E7F7F7F807F7F807F807E807F7F7F7F7F7F7F7F7F807F7F7F7F7F80807F7F80807F807F80807F7F807F807F807F7F7F807F7F7F7F7F80807F7F7F7F7F807F7F7F80807F7F7F7F7F7F807F7F807F7F7F7F7F7F7F807F7F7F807F7F7F7F
0:915:7F807F807F7F80807F807F7F7F7F7F7E787E7E7F7F7F807F7F7F7F80808080807F7F7F7F8080807F8080807F808080807F80807F807F80807F7F7F8080807F7F807F7F80807F7F807F8080808080807F7F80807F80807F7F7F807F7F7F7F7E807F7F7F7F807F807F7F7F7F807F7F7F7F7F
0:915:7F7F807F807F7F7F7F7F7F7F807F7F7E777E7E7E7F7F7F7F7E7F7E807F8080807F7F7F7F807F7F7F80807F807F8080807F7F7F7F7F7F7F7F7F80807F7F7F7F7F807F7F80807F7F7F7F807F7F8080807F7F7F807F7F80807F7F80807F7F7F7F7F807F808080807F7F7F807F7F807F807F7E
0:915:7F807F7F807F807F7F8080807F7F7E7F777E7E7F7F7F7F80807F7F8080807F8080807F7F7F7E8080807F807F7F80807F7F807F7F807F8080807F7F7F80807F7F807F807F7F7F807F7F7F8080807F807F7F7F80807F7F7F7F7F7F807F7F7F7F807F7F7F7F7F7F80807F7F807F807F7F7F7F
0:915:7F7F807F7F7F7F7F7F7F7F7F7F7E7F7F777E7E7F7E7F7F7F807F7F7F807F808080808080807F7F7F80807F7F807F80807F7F7F7F807F807F7F8080807F7F807F807F7F7F7F7F7F7F807F7F7F807F807F80807F807F7F7F7F807F7F7F7F8080807F7F7F7F7F7F7F7F7F7F7F7F807F807F7F
0:915:7F7F7F7F807F807F80807F7F7F7F7E7E777E7E7E7F7F7F7F7F807F7F807F807F7F80808080807F80807F7F8080807F807F7F807F7F7F7F7F7F80807F7F807F7F7F7F807F807F7F7F807F7F7F80807F8080807F7F7F807F7F80807F7F7F807F807F7F7F7F80807F7F80807F7F807F7F7F7F

To stop a scan, simply enter CTRL-C value.