gateway connector bridge

Le pont de connecteur de passerelle Network Things

Installation

Téléchargez les binaires précompilés pour 64 bits Linux, Linux 32 bits, ARM Linux, MacOS, Windows 64 bits, Windows 32 bits.

Les autres exigences sont:

• Redis
• Un courtier MQTT (voir également la section de sécurité)

Usage

 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)

Pour courir dans Docker, veuillez vous référer à docker-compose.yml .

Protocole

Le protocole gateway-connector de Things Network envoie des tampons de protocole via MQTT.

• Connectez-vous à MQTT avec l'ID de votre passerelle en tant que nom d'utilisateur et clé d'accès comme mot de passe.
  • Sur les courtiers MQTT qui ne prennent pas en charge l'authentification, vous pouvez vous connecter sans authentification.
• After Connect: Envoyer types.ConnectMessage sur connect Sujet.
  • Fournir l'ID de la passerelle et la clé d'accès pour authentifier le backend
• Sur déconnecter: envoyer types.DisconnectMessage sur le sujet disconnect .
  • Fournir le même ID et la clé d'accès que dans ConnectMessage .
  • Utilisez la fonction «Will» de MQTT pour envoyer le DisconnectMessage lorsque la passerelle se déconnecte de façon inattendue.
• Sur UpLink: Envoyer router.UplinkMessage sur le sujet <gateway-id>/up .
• Pour la liaison descendante: abonnez-vous à la rubrique <gateway-id>/down et recevez router.DownlinkMessage .
• Sur l'état: Envoyer gateway.Status sur le sujet <gateway-id>/status .

Sécurité

️ Les courtiers MQTT devraient prendre en charge l'authentification et le contrôle d'accès:

• Les sujets connect , disconnect , <gateway-id>/up , <gateway-id>/status doivent seulement permettre
  • Publier pour des passerelles authentifiées avec <gateway-id> .
  • Abonnez-vous pour le pont.
• Les sujets <gateway-id>/down doivent seulement permettre
  • Publier pour le pont.
  • Abonnez-vous à des passerelles authentifiées avec <gateway-id> .

Développement

• Assurez-vous que vous avez installé (version recommandée 1.11 ou version ultérieure).
• Configurez votre environnement GO.
• Assurez-vous que Redis a installé et en cours d'exécution .
• Assurez-vous que RabbitMQ et son plugin MQTT sont installés et exécutés .
• Fourk ce référentiel sur github
• git clone [email protected]:YOURUSERNAME/gateway-connector-bridge.git
• cd gateway-connector-bridge
• make deps
• make test
• make build

Licence

Code source de The Things Network est publié sous la licence MIT, qui peut être trouvée dans le fichier de licence. Une liste des auteurs peut être trouvée dans le fichier des auteurs.