MQTT 订阅协议 V1.5 —— 网关类设备直连客户 MQTT 服务器的数据上传规范。

1. 协议概述

本协议针对本公司传感器数据通过 MQTT 协议上传云端的数据格式进行了规范，适用于本公司网关类设备直连客户 MQTT 服务器的场景。

2. 基本规约

3. 消息格式

消息质量为 QoS1，消息体采用 UTF-8 编码的 JSON 文本格式。

4. 消息头

消息头固定包含 SN 码及时间戳：

5. 数据体

数据体由传感器测量项的名称及数据组成，字段含义见《MQTT传感器字段表》。示例：

{
    "ts":1640775699,
    "sn":"2305181126000001",
    "data":
    {
        "BV":12.5,
        "AT":27.5,
        "AH":52,
        "ILL":460,
        "AP":1002.5,
        "CO2":839,
        "WSP":0,
        "WA":123.4,
        "RFD":1,
        "RFH":1
    }
}

6. 多传感器区分说明

若同一网关下存在多个相同传感器，会在参数名后加下划线及 485 地址以作区分。例如在同一网关下接入 4 个 485 空气温湿度传感器，上传消息如下：

{
    "ts":1640775699,
    "sn":"2305181126000001",
    "data":
    {
        "BV":12.5,
        "AT_1":27.5,
        "AH_1":52,
        "AT_2":27.5,
        "AH_2":52,
        "AT_3":27.5,
        "AH_3":52,
        "AT_4":27.5,
        "AH_4":52
    }
}

7. 修订记录

您的系统通过调用平台开放的 RESTful API，按需主动拉取设备数据与状态信息。

完整的接口列表、鉴权方式、请求示例请查看在线 API 文档：

平台在设备数据产生时，主动将数据 POST 推送到您指定的回调地址。

推送配置、报文格式、签名验证等完整说明，请查看在线 API 文档中的「数据推送」部分：

针对行业私有协议或特殊集成需求，提供定制化对接开发服务。

1. 支持范围

• 传输层协议：TCP、UDP、WebSocket、串口（经网关转换）等；
• 行业协议：Modbus、OPC UA、JT/T 808、GB/T 28181 等（视具体需求评估）；
• 私有化部署：支持平台整体或接入层的私有化交付。

2. 合作流程

1. 需求沟通：您提供协议文档或对接需求说明；
2. 方案评估：我方在 3 个工作日内给出技术方案与工作量评估；
3. 开发联调：双方按约定周期进行开发与联合调试；
4. 验收上线：提供测试报告，验收后正式上线。

3. 如何申请

请联系您的销售经理，我们将尽快安排技术同学与您对接。