ChirpStack Gateway Bridge is a service which converts LoRa® Packet Forwarder protocols into a ChirpStack Network Server common data-format (JSON and Protobuf). This component is part of the ChirpStack open-source LoRaWAN® Network Server stack.

You will find additional information about the Bridge directly on the official ChirpStack documentation. 

The Bridge can run either on the gateway directly or on the infrastructure server side.

The ChirpStack Gateway Bridge is installed by default on all gateways with LORIX OS.

Available backends

The Bridge back-end is a Packet Forwarder running on the gateway. The Bridge is compatible with three Forwarders:

  • Semtech UDP Packet Forwarder
  • Basic Station Packet Forwarder
  • ChirpStack Concentratord

On the LORIX One, the Bridge is used in combination with the Semtech UDP Packet Forwarder.

Configuration

The Antenna type must be set before configuring the ChirpStack Gateway Bridge

Bridge configuration

The bridge configuration is split into different files corresponding to different sections of the configuration:

/etc/opt/chirpstack-gateway-bridge/ 
|-- 10-general.toml
|-- 20-backend_concentratord.toml
|-- 20-backend_semtech-udp.toml
|-- 30-integration.toml
|-- 40-filters.toml
|-- 50-metrics.toml
|-- 60-metadata.toml
|-- 70-commands.toml
`-- 99-custom.toml
CODE

The 30-integration.toml file can be edited from the Manager GUI. It's generally the main file you'll have to edit as it contains the configuration of the connection to the LNS server.

The other files can be edited from the CLI.

You can edit the integration section from the LoRa > Forwarder page by pressing the edit button in the top right of the Bridge configuration panel.

Do not add filters section into the integration file from the GUI as it already exists in the filters file and the Bridge will fail to start.

Once the configuration updated, restart the Bridge with the Restart button.

The configuration files are located at /etc/opt/chirpstack-gateway-bridge/.

You can change the file from the CLI with nano:

sudo nano /etc/opt/chirpstack-gateway-bridge/40-filters.toml
BASH

You should not change 10-*.toml and 20-*.toml files, as the configuration is specific to LORIX OS and changing anything in those file may most likely break the Bridge.

Once the configuration updated, restart the Bridge with:

sudo pmcli service chirpstack-gateway-bridge-udp job gateway-bridge restart
CODE

Additional files to store metadata and commands section will be added soon!

Please refer to the ChirpStack Gateway Bridge Configuration documentation for additional information about the options.

Use a certificate

If you want to use a certificate to secure the connection, you can do it through the command line interface.

  1. Copy your certificates to /etc/opt/chirpstack-gateway-bridge
  2. Update the bridge configuration and set the path to the certificate. Use absolute paths. 
    Refer to the official ChirpStack documentation - Gateway Bridge Configuration : integration.mqtt.auth.generic section.

LoRa concentrator daemon configuration

Please refer to the UDP Packet Forwarder documentation.