gateway connector bridge

Мост разъема сетевого шлюза сети

Установка

Загрузите предварительные двоичные файлы для 64 -битных Linux, 32 -битный Linux, Arm Linux, MacOS, 64 -битные Windows, 32 -битные Windows.

Другие требования:

• Редис
• Брокер MQTT (см. Также раздел безопасности)

Использование

 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)

Для работы в Docker, пожалуйста, обратитесь к docker-compose.yml .

Протокол

Протокол gateway-connector сети вещей отправляет буферы протокола над MQTT.

• Подключитесь к MQTT с идентификатором вашего шлюза в качестве имени пользователя и ключа доступа в качестве пароля.
  • На брокерах MQTT, которые не поддерживают аутентификацию, вы можете подключиться без аутентификации.
• После Connect: отправить types.ConnectMessage на теме connect .
  • Поставьте идентификатор шлюза и ключ доступа к аутентификации с помощью бэкэнда
• На Disconnect: отправить types.DisconnectMessage по теме disconnect .
  • Предоставьте тот же идентификатор и ключ доступа, что и в ConnectMessage .
  • Используйте функцию MQTT «Will», чтобы отправить DisconnectMessage , когда шлюз неожиданно отключается.
• На oplink: отправить router.UplinkMessage на тему <gateway-id>/up .
• Для нисходящей линии связи: подпишитесь на тему <gateway-id>/down и получите router.DownlinkMessage .
• На статусе: отправить gateway.Status по теме <gateway-id>/status .

Безопасность

️ Брокеры MQTT должны поддерживать аутентификацию и контроль доступа:

• Темы connect , disconnect , <gateway-id>/up , <gateway-id>/status должны только разрешать
  • Публикуйте для аутентифицированных шлюзов с <gateway-id> .
  • Подпишитесь на мост.
• <gateway-id>/down темы должны только разрешать
  • Публикуйте для моста.
  • Подпишитесь на аутентифицированные шлюзы с <gateway-id> .

Разработка

• Убедитесь, что вы установили (рекомендуется версия 1.11 или более поздней версии).
• Установите свою среду GO.
• Убедитесь, что у вас установлен Redis и работает .
• Убедитесь, что у вас установлен и запуск плагин MQTT.
• Разветвляется этот репозиторий на GitHub
• git clone [email protected]:YOURUSERNAME/gateway-connector-bridge.git
• cd gateway-connector-bridge
• make deps
• make test
• make build

Лицензия

Исходный код для сети TIEWERS выпускается по лицензии MIT, который можно найти в файле лицензии. Список авторов можно найти в файле авторов.