芯步温湿度传感器支持纯HTTP接口接入，无需网关，可直接通过API下发阈值参数。以下方案涵盖接口对接、阈值下发和告警联动的完整流程。

1. 背景与概述

在许多物联网应用场景中（如冷链物流、机房监控、温室大棚），对环境温湿度的实时监控和阈值告警至关重要。芯步的智能温湿度传感器（型号：UNI-CGQ-WSD）具备高精度传感芯片，支持 WiFi直连（2.4GHz）和 开放HTTP接口，允许开发者无需网关即可实现设备与服务器的直连 。

本方案的目标是指导开发者如何利用该设备的开放API，实现以下核心目标：

1. 获取实时数据：设备主动上报温湿度数据至指定服务器。

2. 远程配置阈值：通过HTTP指令远程修改设备本地或云端的温湿度阈值参数。

3. 自动告警联动：当数据超限时，触发HTTP回调或联动控制。

2. 系统架构与通信流程

本方案采用典型的“设备-云-应用”架构，利用芯步设备的消息推送与指令下发机制。

核心交互流程

1. 设备注册与联网：设备通过小程序/控制台配置WiFi后上线，与芯步云保持长连接。

2. 数据上行（上报） ：设备检测到温湿度变化时，立即通过HTTP POST将JSON消息推送到用户配置的服务器URL。

3. 控制下行（设置） ：用户后端服务器或APP通过调用芯步的开放HTTP接口，携带签名，向设备下发“设置阈值”指令。

3. 接口配置与实现步骤

3.1 前期准备

• 获取凭证：登录芯步官网，注册账号并创建工作台，获取 AppId 和 AppSecret。

• 设备配网：使用“芯步”小程序为设备配置2.4G WiFi网络，确保设备在线 。

3.2 数据接收服务端配置（接收上报数据）

设备上报数据是获取当前环境值的基础。您需要准备一台公网服务器，并配置接收端点。

• 设置推送URL：在芯步控制台中，将“数据接收URL”配置为您的服务器地址（例如 http://yourdomain.com/api/wsd/callback）。

• 接收数据格式：当温度变化达到阈值或定时上报时，设备会发送如下格式数据：

  { "device_id": "1000012345", "type": "report", "data": { "temperature": 25.6, "humidity": 60.2, "battery": 95 }, "timestamp": 1700000000 }

• 处理逻辑：您的服务器解析此数据，判断温度是否超过预设阈值，若超限则触发告警。

3.3 远程阈值设置实现

要实现“远程设置”，需通过芯步提供的设备控制接口 device/control/。由于传感器端通常具备执行逻辑的能力（或由云端负责逻辑比较），这里提供两种实现方案：

方案A：下发阈值至设备本地存储

如果设备固件支持本地阈值比较，可通过控制接口下发配置。

• 请求地址http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

• 请求方法： POST

• 请求头： Content-Type: application/json

• 请求体示例（设置温度上限30度，湿度上限80%） ：

  { "device": "1000012345", "order": { "cmd": "set_threshold", "temp_max": 30.0, "temp_min": 10.0, "humi_max": 80.0, "humi_min": 20.0 } }

  注：具体 order 中的字段名请参考芯步对应传感器的最新API文档，不同固件版本字段可能略有差异。

方案B：云端逻辑判断（无本地存储）

如果传感器仅做采集，不保存阈值，阈值逻辑完全由您的业务服务器负责。

1. API调用逻辑：您不需要向设备发送“阈值”，而是向您的数据库发送“阈值”。

2. 操作步骤

   • 用户在APP设置阈值 -> 请求发送至您的业务服务器 -> 服务器存入MySQL/Redis。

   • 当设备上报温湿度数据（见3.2节）时，您的服务器查询数据库中的阈值。

   • 若 上报温度 > 数据库阈值，则触发告警。

3.4 API签名与鉴权

为了安全，芯步接口要求携带签名。标准签名算法如下：

1. 排序参数：将 AppId, ts(时间戳), Secret 等参数按字母顺序排序。

2. MD5加密：拼接字符串并计算MD5值填入 sign 参数。

3. 超时验证： ts 有效期设为5分钟以内，防止重放攻击。

代码示例（伪代码）

4. 远程阈值设置的场景应用

结合HTTP接口，您可以实现以下复杂应用场景：

4.1 动态调整策略

• 案例：办公大楼下班时间，能源管理系统自动调用HTTP接口，将空调相关区域的温湿度传感器阈值从“24℃舒适模式”调整为“28℃节能模式”，无需人工巡检。

4.2 自动化联动

通过解析上报数据并结合第三方业务系统，实现跨系统联动。

• 逻辑：传感器上报超阈值数据 -> 您的服务器捕获 -> 调用第三方API（如短信平台、钉钉机器人）。

• 代码逻辑示例

  # 接收到回调数据 temp = request.json['data']['temperature'] if temp > 30: # 调用钉钉/微信接口发送告警 send_dingtalk_alert("温度超标警告: {}".format(temp)) # 可进一步调用芯步接口，控制大功率风扇/空调的继电器开关 control_device(device_id="relay_01", power="on")

5. 关键注意事项

1. 网络稳定性：该设备仅支持 2.4G WiFi，不支持5G频段及WPA2-Enterprise加密。部署时需确保信号强度（RSSI > -70dBm）以保证指令的即时响应率 。

2. 接口调用机制：在下发“设置阈值”指令时，网络抖动可能导致指令重发。在指令中加入 seq_id（序列号），防止设备重复执行同一配置。

3. 数据安全

   • 生产环境使用 HTTPS 协议接口，防止通信内容被嗅探。

   • URL回调接口需校验请求来源，可通过校验请求头中的 X-TB-Sign 或限制服务器IP白名单（芯步回调源IP）来防止伪造数据注入。

6. 总结

通过芯步开放的HTTP接口，开发者可以非常便捷地实现“远程温湿度阈值设置”。核心逻辑集中在 “下行指令（设置阈值）” 与 “上行数据（触发告警）” 的配合上。无论是将阈值存储在云端进行逻辑判断，还是直接写入设备本地模组，该方案都能显著降低开发成本，实现快速交付。