Container

The Container LRR is designed to run in a Docker environment. There are 4 different images available for deployment depending on the radio interface and the LoRa concentrator model:

• container_sx1302_tty (SX1302 with TTY interface)
  • TP_Enterprise_BS_Image_generic.GEN_SX1302.USB.1_any_2.8.101_v1.0
  • TP_Enterprise_BS_Image_rakwireless.RAK_2287.USB.1_any_2.8.101_v1.0
• container_sx1303_tty (SX1303 with TTY interface)
  • TP_Enterprise_BS_Image_generic.GEN_SX1303.USB.1_any_2.8.101_v1.0
  • TP_Enterprise_BS_Image_rakwireless.RAK_5146.USB.1_any_2.8.101_v1.0
• container_sx1302_spi (SX1302 with SPI interface)
  • TP_Enterprise_BS_Image_generic.GEN_SX1302.SPI.1_any_2.8.101_v1.0
  • TP_Enterprise_BS_Image_rakwireless.RAK_2287.SPI.1_any_2.8.101_v1.0
• container_sx1303_spi (SX1303 with SPI interface)
  • TP_Enterprise_BS_Image_generic.GEN_SX1303.SPI.1_any_2.8.101_v1.0
  • TP_Enterprise_BS_Image_rakwireless.RAK_5146.SPI.1_any_2.8.101_v1.0

Software pre-requisites and compatibility matrix

Base Station Model	LRR Version	Firmware Version
container_sx1302_tty	2.8.101	Docker
container_sx1303_tty	2.8.101	Docker
container_sx1302_spi	2.8.101	Docker
container_sx1303_spi	2.8.101	Docker

You must have Docker installed on your host machine before proceeding with the installation. gpio, i2c and spi access must be provided to the container depending on the LoRa concentrator model used for container_sx1302_spi and container_sx1303_spi.

On a Raspberry Pi host, you can enable the required interfaces using raspi-config:

sudo raspi-config

Important: Please double check that another packet forwarder is not already running on the host machine before starting the containerized LRR, as it may cause conflicts with the LoRa concentrator.

LRR installation using an executable

After downloading the base station image as described in Retrieving the base station image, you can use the provided executable file to install the containerized LRR.

It will install the embedded LRR image using Docker and run Docker compose with the appropriate configuration.

# Make the script executable
chmod 755 TP_Enterprise_BS_Image_generic.GEN_SX1302.SPI.1_any_2.8.101_v1.0
# Run the installation script
./TP_Enterprise_BS_Image_generic.GEN_SX1302.SPI.1_any_2.8.101_v1.0

# A couple of questions will be asked during the installation.
# A yaml file will be copied into `/home/actility/` and it can be modified to fit your needs (network, volumes, etc.)

Important: For SPI containers, please make sure to check the RESET_LGW script and update it if necessary to ensure that the correct GPIO chip is used for resetting the LoRa concentrator. If a new RESET_LGW script is needed, please create a volume with the new script and mount it to the container to override the default one in the docker-compose.yml file, for example:

services:
  lrr:
    environment:
      - RESET_LGW=/usr/local/bin/reset_lgw.sh
    volumes:
      - ./my_reset_lgw.sh:/usr/local/bin/reset_lgw.sh

Root access

By default, the root password is set to actilityARM64.