芯步的开放接口基于HTTP协议,签名机制清晰,支持设备状态上报和远程下发命令。以下方案围绕“感应类传感器+执行类设备”的联动逻辑,说明如何通过接口调参实现安全与节能场景的远程配置。
1. 背景与目标
在现代楼宇、学校实验室、工厂仓库等场景中,安全与节能管理往往依赖人工巡检,存在响应滞后、能耗浪费的问题。例如,无人时空调/灯光未关,或大功率设备违规接入导致火灾隐患。
本方案基于芯步的智能硬件及开放API接口,旨在实现以下目标:
远程参数配置:无需进入现场,通过API远程调优传感器的灵敏度、触发延时等参数。
场景联动节能:实现“人走灯灭”、“人走断电”,降低待机能耗。
主动安全管理:实时监测烟雾、违规大功率电器,自动断电并告警。
2. 核心技术架构
方案基于芯步的HTTP开放接口,支持公有云或私有化部署。架构分为三层:
感知/执行层
传感器:智能人体存在传感器(红外/雷达)、智能烟雾传感器。
执行器:智能WiFi墙壁开关/插座、智能语音音柱。
网络层:设备直连WiFi 2.4GHz,无需网关,降低延迟。
平台/应用层
芯步开放API(
api.thingboot.com)负责设备状态上报与指令下发。用户自有的SaaS平台或App接收消息推送,并执行联动逻辑。
3. 关键接口与参数配置详解
要实现“远程感应参数配置”,核心在于利用接口修改传感器的配置项,这些配置存放在设备Flash中,允许实时下发且无需重启。
3.1 接口调用基础
请求地址
http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}请求方法:POST (JSON)
签名机制
sign = md5( md5(AppSecret) + ts ),保障接口调用安全。核心参数
device:目标设备ID。order:具体命令或配置内容。
3.2 核心配置参数解析(以人体存在传感器为例)
芯步的设备支持精细化参数调节,以适应不同场景需求。
| 配置项 | 功能说明 | 典型取值范围 | 场景应用举例 |
|---|---|---|---|
radar_enable | 雷达模块开关 | 1(开) / 0(关) | 办公时间开启,下班后关闭以节能 |
infrared_change_1 | 有人触发持续时间 | 0(马上) ~ 5(秒) | 设为0,实现毫秒级响应开灯 |
infrared_change_0 | 无人触发持续时间 | 30s ~ 600s(10分钟) | 节能场景:设为120,即无人2分钟后关灯,避免频繁开关 |
relay_change_0 | 无人时线路动作 | 0(关) / 1(开) / no | 安全场景:设为0,无人时强制断电 |
led | LED指示灯模式 | rl_s(与线路同步) / blink | 夜间模式下关闭LED,避免光污染 |
4. 具体场景解决方案
4.1 第一种场景:节能降耗 —— “深度存在感应”与“人走灯灭”
痛点:办公区、卫生间灯光常亮,空调下班后未关。解决方案利用智能人体存在传感器精确探测微动(如手指打字、静坐办公),避免传统红外传感器因人体静止而误判“无人”。
远程参数配置流程
下发配置:通过API修改传感器配置,将无人延时参数调整至合适范围,避免人影晃动误关灯。
请求示例:修改设备ID为
820720的传感器:
联动执行:传感器探测到无人状态变化时,平台主动推送消息到客户服务器。客户的业务系统收到“无人”事件后,调用智能墙壁开关接口执行断电。
4.2 第二种场景:主动安全 —— 大功率限制与异常预警
痛点:宿舍或办公区违规使用取暖器、电煮锅,导致线路过载起火。解决方案利用智能WiFi墙壁插座的计量与限功率功能,配合烟雾传感器实现双重防护。
远程策略配置
设置功率阈值:虽然直接限制功率通常通过插座内置逻辑实现,但可通过API下发阈值配置。
当监测到功率超过
2000W时,插座立即物理断电并上报overload事件。
声光告警联动:一旦烟雾传感器探测到浓度变化(
mq_enable触发),或插座上报过载,平台调用智能语音音柱接口。语音播报命令
即便在局域网环境下,该播报指令也能通过私有化服务器毫秒级下发。
4.3 第三种场景:特殊环境 —— 实验室/配电房恒温恒湿
痛点:精密仪器对环境温湿度敏感,普通空调无法及时调节。解决方案
数据上报:温湿度传感器周期性上报环境数据。
远程调参
平台根据算法(如温度 > 30°C),下发命令开启排风扇或空调插座。
远程调参:管理人员调用接口修改传感器的上报频率,在夏季高温时段提高采样频率,以便更灵敏地控制除湿设备。
5. 实施步骤和需要注意的点
5.1 开发对接流程
准备工作:在芯步控制台创建工作台,获取
AppId和AppSecret。设备配网:设备上电,通过“智能配网”或AP热点模式将设备加入WiFi。
消息推送配置:在控制台配置
Callback URL,用于接收设备上报的有人/无人、烟雾、温湿度等事件。逻辑开发
订阅消息:接收设备状态变更。
下发配置:调用API修改设备参数(如修改传感器延时)。
场景联动:根据接收的事件,调用API控制执行端(开关、音柱)。
5.2 安全与节能
私有化部署:对于涉及核心安防(如金库、实验室)的场景,利用芯步支持的私有化 Broker 模式,将数据完全闭环在局域网内。
配置原则
在“人走灯灭”场景中,无人延时设置为3-5分钟,避免短暂的离开(如上厕所)导致频繁开关损耗继电器寿命。
在“安全充电”监控中,切勿仅依赖功率限制,请一定要联动烟雾传感器,因为锂电池热失控往往先产生烟雾。
5.3 常见问题处理
参数不生效:修改配置项后需确保设备在线。配置项保存在Flash中,若设备离线,指令将无法写入。
信号问题:芯步设备支持设定5组WiFi网络,会优先连接信号最强的AP,部署时确保信号覆盖。
6. 总结
通过芯步开放的HTTP接口,特别是针对传感器底层配置项的远程修改能力,管理者可以将“安全”与“节能”从被动响应变为主动防御。
节能端:通过调节“无人延时参数”匹配人流密度,实现精细化照明管理。
安全端:通过远程锁定插座功率上限并联动语音告警,消除电气火灾隐患。
开发者仅需关注业务逻辑,无需关心底层通信协议,即可快速构建出能够自学习、自适应的智能物联网系统。