联犀开发者文档

格兰斯贝接入

约 463 字大约 2 分钟

设备接入第三方协议格兰斯贝蓝牙网关

2026-08-20

简介

格兰斯贝协议（glsbMqtt）是联犀平台对接格兰斯贝 GS200 蓝牙网关的 MQTT 直连协议，使用联犀标准式三元组认证，设备通过 MQTT 连接平台并按标准 Topic 收发数据。

应用场景

  • 格兰斯贝蓝牙网关：GS200 蓝牙网关及子设备（灯控、传感器等）接入
  • 标准物模型：设备通过标准 thing 事件 Topic 上报

前置条件

  1. 协议容器已部署：protocol-glsb 容器运行正常
  2. MQTT Broker 可访问：平台 MQTT 服务端口 1883 开放

产品配置

创建产品时选择协议 glsbMqtt（传输协议 MQTT）。

设备接入

设备详情「设备接入」Tab 展示三元组（打开即自动生成）：

设备接入

三元组（联犀标准式）

参数值
ClientID{productID}&{deviceName}
Username{ClientID};12010126;{connID 5位随机};{expiry 10天后unix秒}
PasswordHMAC-SHA256(username, base64decode(deviceSecret));hmacsha256

Topic 清单

方向Topic说明
上行/sys/{productID}/{deviceName}/thing/event/{method}/post事件上报（sensor/dimming/consumption 等）
上行/+/+/user/update用户信息更新
下行/{productID}/{deviceName}/user/get用户信息下发

技术方案

接入架构

格兰斯贝设备 ──MQTT──> protocol-glsb 容器(订阅 $share/glsb.rpc/...) ──> 联犀平台
  • 设备以标准式三元组连接 MQTT（认证走平台 MQTT broker 的标准认证链）
  • 协议订阅 /sys/+/+/thing/event/+/post 解析上行事件（method ∈ sensor/dimming/consumption/labels/neighbours/trigger/setting/beacon/current/heartbeat）
  • 下行经 /{productID}/{deviceName}/user/get 发布控制指令

注意事项

  • 三元组由配置页自动生成，过期（10 天）后可手动重新生成
  • 认证最终由平台 MQTT broker 执行，设备密钥需与平台一致

更新日志

2026/8/21 03:59
查看所有更新日志
  • 4ab8f-Merge #25 into master from docs/third-party-protocols于