Bridge between Gateway Connector (protobufs over MQTT) and gRPC
Download precompiled binaries for 64 bit Linux, 32 bit Linux, ARM Linux, macOS, 64 bit Windows, 32 bit Windows.
Other requirements are:
Usage:
gateway-connector-bridge [flags]
Flags:
--account-server string Use an account server for exchanging access keys and fetching gateway information (default "https://account.thethingsnetwork.org")
--amqp stringSlice AMQP Broker to connect to (user:pass@host:port; disable with "disable")
--debug Print debug logs
--http-debug-addr string The address of the HTTP debug server to start
--id string ID of this bridge
--info-expire duration Gateway Information expiration time (default 1h0m0s)
--inject-frequency-plan string Inject a frequency plan field into status message that don't have one
--log-file string Location of the log file
--mqtt stringSlice MQTT Broker to connect to (user:pass@host:port; disable with "disable") (default [guest:guest@localhost:1883])
--ratelimit Rate-limit messages
--ratelimit-downlink uint Downlink rate limit (per gateway per minute)
--ratelimit-status uint Status rate limit (per gateway per minute) (default 20)
--ratelimit-uplink uint Uplink rate limit (per gateway per minute) (default 600)
--redis Use Redis auth backend (default true)
--redis-address string Redis host and port (default "localhost:6379")
--redis-db int Redis database
--redis-password string Redis password
--root-ca-file string Location of the file containing Root CA certificates
--route-unknown-gateways Route traffic for unknown gateways
--status-addr string Address of the gRPC status server to start
--status-key stringSlice Access key for the gRPC status server
--ttn-router stringSlice TTN Router to connect to (default [discover.thethingsnetwork.org:1900/ttn-router-eu])
--udp string UDP address to listen on for Semtech Packet Forwarder gateways
--udp-lock-ip Lock gateways to IP addresses for the session duration (default true)
--udp-lock-port Additional to udp-lock-ip, also lock gateways to ports for the session duration
--udp-session duration Duration of gateway sessions (default 1m0s)
--workers int Number of parallel workers (default 1)
For running in Docker, please refer to docker-compose.yml
.
The Things Network's gateway-connector
protocol sends protocol buffers over MQTT.
types.ConnectMessage
on topic connect
.
types.DisconnectMessage
on topic disconnect
.
ConnectMessage
.DisconnectMessage
when the gateway unexpectedly disconnects.router.UplinkMessage
on topic <gateway-id>/up
.<gateway-id>/down
and receive router.DownlinkMessage
.gateway.Status
on topic <gateway-id>/status
.⚠️ MQTT brokers should support authentication and access control:
connect
, disconnect
, <gateway-id>/up
, <gateway-id>/status
topics must only allow
<gateway-id>
.<gateway-id>/down
topics must only allow
<gateway-id>
.git clone [email protected]:YOURUSERNAME/gateway-connector-bridge.git
cd gateway-connector-bridge
make deps
make test
make build
Source code for The Things Network is released under the MIT License, which can be found in the LICENSE file. A list of authors can be found in the AUTHORS file.