gateway connector bridge

El puente del conector de la puerta de enlace de la red de las cosas

Instalación

Descargue binarios precompilados para Linux de 64 bits, Linux de 32 bits, brazo Linux, macOS, ventanas de 64 bits, ventanas de 32 bits.

Otros requisitos son:

• Rehacer
• Un corredor de MQTT (ver también la sección de seguridad)

Uso

 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)

Para ejecutar en Docker, consulte docker-compose.yml .

Protocolo

El protocolo gateway-connector de la red Things envía búferes de protocolo a través de MQTT.

• Conéctese a MQTT con la ID de su puerta de enlace como nombre de usuario y clave de acceso como contraseña.
  • En los corredores MQTT que no admiten la autenticación, puede conectarse sin autenticación.
• Después de conectar: ​​enviar types.ConnectMessage en el tema connect .
  • Suministrar la identificación de la puerta de enlace y la clave de acceso para autenticarse con el backend
• En desconexión: enviar types.DisconnectMessage en disconnect del tema.
  • Suministra la misma ID y clave de acceso que en ConnectMessage .
  • Use la característica "Will" de MQTT para enviar la DisconnectMessage cuando la puerta de enlace se desconecta inesperadamente.
• En el enlace ascendente: enviar router.UplinkMessage en el tema <gateway-id>/up .
• Para el enlace descendente: suscríbase al tema <gateway-id>/down y reciba router.DownlinkMessage .
• En el estado: Enviar gateway.Status on Topic <gateway-id>/status .

Seguridad

️ Los corredores MQTT deben admitir la autenticación y el control de acceso:

• El connect , disconnect , <gateway-id>/up , <gateway-id>/status solo deben permitir
  • Publicar para puertas de enlace autenticadas con <gateway-id> .
  • Suscríbete para el puente.
• Los temas <gateway-id>/down solo deben permitir
  • Publicar para el puente.
  • Suscríbase para puertas de enlace autenticadas con <gateway-id> .

Desarrollo

• Asegúrese de haber instalado (versión 1.11 recomendada o posterior).
• Configure su entorno Go.
• Asegúrese de que Redis esté instalado y en funcionamiento .
• Asegúrese de tener RabbitMQ y su complemento MQTT instalado y en funcionamiento .
• Bifurca este repositorio en Github
• git clone [email protected]:YOURUSERNAME/gateway-connector-bridge.git
• cd gateway-connector-bridge
• make deps
• make test
• make build

Licencia

El código fuente para la red Things se publica bajo la licencia MIT, que se puede encontrar en el archivo de licencia. Se puede encontrar una lista de autores en el archivo de autores.