/lora-gateway-bridge

LoRa Gateway Bridge abstracts the packet_forwarder protocol into JSON over MQTT

Primary LanguageGoMIT LicenseMIT

LoRa Gateway Bridge

Build Status GoDoc Gitter chat

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.

Documentation

See http://docs.loraserver.io/lora-gateway-bridge for documentation about setting up LoRa Gateway Bridge.

Compatibility

LoRa Gateway Bridge version >= 2.1 supports both version 1 and version 2 of the packet_forwarder UDP protocol.

Downloads

Building from source

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 bash

A 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 package

# build the .tar.gz file for Windows AMD64
GOOS=windows BINEXT=.exe GOARCH=amd64 make package

Alternatively, you can run the same commands from any working Go environment. As all requirements are vendored, there is no need to go get these. Make sure you have Go 1.7.x installed and that you clone this repository to $GOPATH/src/github.com/brocaar/lora-gateway-bridge.

Contributing

There are a couple of ways to get involved:

When you would like to add new features, please discuss the feature first by creating an issue describing your feature, how you're planning to implement it, what the usecase is etc...

License

LoRa Gateway Bridge is distributed under the MIT license. See LICENSE.