gateway connector bridge

สะพานเชื่อมต่อเกตเวย์เครือข่ายของสิ่งต่างๆ

การติดตั้ง

ดาวน์โหลด Binaries Precompiled สำหรับ 64 บิต linux, 32 บิต linux, arm linux, macOS, windows 64 บิต, 32 บิต windows

ข้อกำหนดอื่น ๆ คือ:

• Redis
• นายหน้า 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 ของ Network Network ส่งบัฟเฟอร์โปรโตคอลผ่าน MQTT

• เชื่อมต่อกับ MQTT ด้วยรหัสของเกตเวย์ของคุณเป็นชื่อผู้ใช้และปุ่มเข้าถึงเป็นรหัสผ่าน
  • บนโบรกเกอร์ MQTT ที่ไม่รองรับการตรวจสอบสิทธิ์คุณสามารถเชื่อมต่อได้โดยไม่ต้องรับรองความถูกต้อง
• After Connect: ส่ง types.ConnectMessage ในหัวข้อ connect
  • จัดหารหัส ID ของเกตเวย์และการเข้าถึงเพื่อตรวจสอบสิทธิ์ด้วยแบ็กเอนด์
• บน disconnect: ส่ง types.DisconnectMessage ในหัวข้อ disconnect
  • จัดหา ID และรหัสการเข้าถึงเดียวกันเช่นเดียวกับใน ConnectMessage
  • ใช้คุณสมบัติ "Will" ของ MQTT เพื่อส่ง DisconnectMessage เมื่อเกตเวย์ตัดการเชื่อมต่อโดยไม่คาดคิด
• บน Uplink: ส่ง router.UplinkMessage ในหัวข้อ <gateway-id>/up
• สำหรับ downlink: สมัครรับหัวข้อ <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 และ ทำงานอยู่
• ตรวจสอบให้แน่ใจว่าคุณมี RabbitMQ และปลั๊กอิน MQTT ติดตั้ง และ ทำงาน
• แยกที่เก็บนี้ใน GitHub
• git clone [email protected]:YOURUSERNAME/gateway-connector-bridge.git
• cd gateway-connector-bridge
• make deps
• make test
• make build

ใบอนุญาต

ซอร์สโค้ดสำหรับเครือข่ายสิ่งต่าง ๆ ถูกเผยแพร่ภายใต้ใบอนุญาต MIT ซึ่งสามารถพบได้ในไฟล์ใบอนุญาต รายชื่อผู้เขียนสามารถพบได้ในไฟล์ผู้เขียน