This is the first test release of LoRa Gateway Bridge v3, which adds compatibility with the Semtech Basic Station packet-forwarder. LoRa Server v2.7 will be released shortly, which will be compatible with both LoRa Gateway Bridge v2 and v3 (v2 support will be dropped as soon as LoRa Server v3 is release).
v3.0.0-testing.1
Features
Basic Station packet-forwarder support
The LoRa Gateway Bridge has been refactored to support multiple packet-forwarder backends. Next to the Semtech UDP packet-forwarder, support has been added to support the Basic Station packet-forwarder. This backend implements the Basic Station LNS protocol.
Updated payload formats
The uplink payload contains a context
field, used to store gateway specific context data (like the internal counter).
The downlink frame contains a timing
field which can be either IMMEDIATELY
, DELAY
or GPS_EPOCH
. Based on the timing
value, an additional object must be given with the additional timing information. Refer to Commands for more details.
Upgrading
LoRa Gateway Bridge v3.0.0 include a couple of changes that are not backwards compatible. You need to re-generate the configuration file and update it where needed. LoRa Gateway Bridge v3 is compatible with LoRa Server v2.7+. Below a summary:
MQTT topics
The MQTT topic configuration has been updated from:
uplink_topic_template="gateway/{{ .MAC }}/rx"
downlink_topic_template="gateway/{{ .MAC }}/tx"
stats_topic_template="gateway/{{ .MAC }}/stats"
ack_topic_template="gateway/{{ .MAC }}/ack"
config_topic_template="gateway/{{ .MAC }}/config"
To:
event_topic_template="gateway/{{ .GatewayID }}/event/{{ .EventType }}"
command_topic_template="gateway/{{ .GatewayID }}/command/#"
Event types are: up
, stats
and ack
.
Commands are: down
and config
.
Please note that LoRa Gateway Bridge v3 is compatible with LoRa Server v2.7+, but you will need to update the MQTT topics in your loraserver.toml
file. Example snippet:
uplink_topic_template="gateway/+/event/up"
stats_topic_template="gateway/+/event/stats"
ack_topic_template="gateway/+/event/ack"
downlink_topic_template="gateway/{{ .MAC }}/command/down"
config_topic_template="gateway/{{ .MAC }}/command/config"
Backends
With LoRa Gateway Bridge v2 you would configure the MQTT backend under the [backend...]
section. This has changed and the [backend...]
section is now used for selecting and configuring the packet-forwarder backends.
Integrations
The MQTT integration configuration has moved to the new [integration...]
section. This allows for adding new integrations in the future besides MQTT.
Debian / Ubuntu users
Please use the 3.x
testing repository:
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 1CE2AFD36DBCCA00
sudo echo "deb https://artifacts.loraserver.io/packages/3.x/deb testing main" | sudo tee /etc/apt/sources.list.d/loraserver.list
sudo apt-get update
Docker users
Please see the available Docker tags: https://cloud.docker.com/u/loraserver/repository/docker/loraserver/lora-gateway-bridge/tags.
Downloads
Please see: https://artifacts.loraserver.io/downloads/lora-gateway-bridge/.