LoRa Gateway Bridge is a service which abstracts the packet_forwarder UDP protocol running on most LoRa gateways into JSON over MQTT. It enables you to use MQTT for receiving data from and sending data to your gateways. This project is part of LoRa Server.
See http://docs.loraserver.io/lora-gateway-bridge for documentation about setting up LoRa Gateway Bridge.
The table below shows the compatibility between LoRa Gateway Bridge and the packet_forwarder UDP protocol versions:
| LoRa Gateway Bridge | packet_forwarder protocol version | Note |
|---|---|---|
| 1.x.x | 1 | |
| 2.0.x | 2 | This protocol is used since version 3.0.0 of the packet_forwarder |
| >= 2.1.x | 1 & 2 simultaneously | Both protocol versions are supported and auto-detected |
Pre-compiled binaries are available from the releases page:
- Linux (including ARM / Raspberry Pi)
- OS X
- Windows
Source-code can be found at https://github.com/brocaar/lora-gateway-bridge.
The easiest way to get started is by using the provided docker-compose environment. To start a bash shell within the docker-compose environment, execute the following command from the root of this project:
docker-compose run --rm gatewaybridge bashA few example commands that you can run:
# run the tests
make test
# compile
make build
# cross-compile for Linux ARM
GOOS=linux GOARCH=arm make build
# cross-compile for Windows AMD64
GOOS=windows BINEXT=.exe GOARCH=amd64 make build
# build the .tar.gz file
make package
# build the .tar.gz file for Linux ARM
GOOS=linux GOARCH=arm make build
# build the .tar.gz file for Windows AMD64
GOOS=windows BINEXT=.exe GOARCH=amd64 make buildAlternatively, you can run the same commands from any working
Go environment. As all requirements are vendored,
there is no need to go get these, but make sure vendoring is enabled for
your Go environment or that you have Go 1.6+ installed.
Issues or feature-requests can be opened at https://github.com/brocaar/lora-gateway-bridge/issues.
LoRa Gateway Bridge is distributed under the MIT license. See LICENSE.