Required packages / tools to build the HALv2:

• build-essential
• tar
• opkg-build (which can be downloaded from https://git.yoctoproject.org/cgit/cgit.cgi/opkg-utils/plain/opkg-build)

Please ensure that these files are in your $PATH.

To compile the HALv2, please use following commands:

tar xzf libloragw2-4.0.1-klk3.tar.gz
cd libloragw2_4.0.1-klk3
source /opt/toolchains/lpbs/environment-setup-cortexa9hf-neon-poky-linux-gnueabi
./configure --host=arm-poky-linux-gnueabi --prefix=/user/libloragw2

This should show something similar to:

checking for...
...
configure: creating ./config.status
config.status: creating ...
config.status: executing depfiles commands

Please ensure that you don't have errors. Then you can compile the tools:

make
make ipk # this is optional and generates the ipk required to upgrade the FPGA to v58

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)