CATALOG

芯步的开放接口基于HTTP协议,签名机制清晰,支持设备状态上报和远程下发命令。以下方案围绕“感应类传感器+执行类设备”的联动逻辑,说明如何通过接口调参实现安全与节能场景的远程配置。

1. 背景与目标

在现代楼宇、学校实验室、工厂仓库等场景中,安全与节能管理往往依赖人工巡检,存在响应滞后、能耗浪费的问题。例如,无人时空调/灯光未关,或大功率设备违规接入导致火灾隐患。

本方案基于芯步的智能硬件及开放API接口,旨在实现以下目标:

  • 远程参数配置:无需进入现场,通过API远程调优传感器的灵敏度、触发延时等参数。

  • 场景联动节能:实现“人走灯灭”、“人走断电”,降低待机能耗。

  • 主动安全管理:实时监测烟雾、违规大功率电器,自动断电并告警。

2. 核心技术架构

方案基于芯步的HTTP开放接口,支持公有云或私有化部署。架构分为三层:

  1. 感知/执行层

    • 传感器:智能人体存在传感器(红外/雷达)、智能烟雾传感器。

    • 执行器:智能WiFi墙壁开关/插座、智能语音音柱。

  2. 网络层:设备直连WiFi 2.4GHz,无需网关,降低延迟

  3. 平台/应用层

    • 芯步开放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,无人时强制断电
ledLED指示灯模式rl_s(与线路同步) / blink夜间模式下关闭LED,避免光污染

4. 具体场景解决方案

4.1 第一种场景:节能降耗 —— “深度存在感应”与“人走灯灭”

痛点:办公区、卫生间灯光常亮,空调下班后未关。解决方案利用智能人体存在传感器精确探测微动(如手指打字、静坐办公),避免传统红外传感器因人体静止而误判“无人”。

远程参数配置流程

  1. 下发配置:通过API修改传感器配置,将无人延时参数调整至合适范围,避免人影晃动误关灯。

    • 请求示例:修改设备ID为820720的传感器:

  2. 联动执行:传感器探测到无人状态变化时,平台主动推送消息到客户服务器。客户的业务系统收到“无人”事件后,调用智能墙壁开关接口执行断电。

4.2 第二种场景:主动安全 —— 大功率限制与异常预警

痛点:宿舍或办公区违规使用取暖器、电煮锅,导致线路过载起火。解决方案利用智能WiFi墙壁插座的计量与限功率功能,配合烟雾传感器实现双重防护。

远程策略配置

  1. 设置功率阈值:虽然直接限制功率通常通过插座内置逻辑实现,但可通过API下发阈值配置。

    • 当监测到功率超过2000W时,插座立即物理断电并上报overload事件。

  2. 声光告警联动:一旦烟雾传感器探测到浓度变化(mq_enable触发),或插座上报过载,平台调用智能语音音柱接口。

    • 语音播报命令

    • 即便在局域网环境下,该播报指令也能通过私有化服务器毫秒级下发

4.3 第三种场景:特殊环境 —— 实验室/配电房恒温恒湿

痛点:精密仪器对环境温湿度敏感,普通空调无法及时调节。解决方案

  1. 数据上报:温湿度传感器周期性上报环境数据。

  2. 远程调参

    • 平台根据算法(如温度 > 30°C),下发命令开启排风扇或空调插座。

    • 远程调参:管理人员调用接口修改传感器的上报频率,在夏季高温时段提高采样频率,以便更灵敏地控制除湿设备

5. 实施步骤和需要注意的点

5.1 开发对接流程

  1. 准备工作:在芯步控制台创建工作台,获取AppIdAppSecret

  2. 设备配网:设备上电,通过“智能配网”或AP热点模式将设备加入WiFi。

  3. 消息推送配置:在控制台配置Callback URL,用于接收设备上报的有人/无人、烟雾、温湿度等事件

  4. 逻辑开发

    • 订阅消息:接收设备状态变更。

    • 下发配置:调用API修改设备参数(如修改传感器延时)。

    • 场景联动:根据接收的事件,调用API控制执行端(开关、音柱)。

5.2 安全与节能

  • 私有化部署:对于涉及核心安防(如金库、实验室)的场景,利用芯步支持的私有化 Broker 模式,将数据完全闭环在局域网内

  • 配置原则

    • 在“人走灯灭”场景中,无人延时设置为3-5分钟,避免短暂的离开(如上厕所)导致频繁开关损耗继电器寿命

    • 在“安全充电”监控中,切勿仅依赖功率限制,请一定要联动烟雾传感器,因为锂电池热失控往往先产生烟雾

5.3 常见问题处理

  • 参数不生效:修改配置项后需确保设备在线。配置项保存在Flash中,若设备离线,指令将无法写入

  • 信号问题:芯步设备支持设定5组WiFi网络,会优先连接信号最强的AP,部署时确保信号覆盖

6. 总结

通过芯步开放的HTTP接口,特别是针对传感器底层配置项的远程修改能力,管理者可以将“安全”与“节能”从被动响应变为主动防御。

  • 节能端:通过调节“无人延时参数”匹配人流密度,实现精细化照明管理。

  • 安全端:通过远程锁定插座功率上限并联动语音告警,消除电气火灾隐患。

开发者仅需关注业务逻辑,无需关心底层通信协议,即可快速构建出能够自学习、自适应的智能物联网系统。

人体存在传感器产品方案:
弱电间人体感应联动:怎样把吸顶式高精度红外传感器对接到项目中
查看 >>
怎样在活动现场人体感应与火灾预警中接入智能设备以实现消防预警联动
查看 >>
学校活动室安全监测:如何将智能人体存在雷达和烟雾传感器接入到软件项目中
查看 >>
智能化改造安全节能场景:怎么将壁挂式双鉴雷达烟雾报警器接入到自己的项目中
查看 >>
便利店人体感应照明:怎么将HTTP接口壁挂人体存在检测设备接入到自己的项目中
查看 >>
节能场景方案:
安全节能低压设备管理:怎样把4路直流负载控制器接入到自己的项目中
查看 >>
安全节能场景联动:如何将远程温湿度联动控制器接入到自己的项目中
查看 >>
智能化改造安全节能场景:怎么将壁挂式双鉴雷达烟雾报警器接入到自己的项目中
查看 >>
怎么在民宿房间安全监测与节能控制中集成智能设备来实现消防预警联动
查看 >>
怎样在共享棋牌室安全节能与消防联动中集成智能设备以实现多设备联动控制
查看 >>
感应用途方案:
怎样在共享茶室人体存在感应中接入智能硬件以实现感应灵敏度调节
查看 >>
怎么接入壁挂式智能双鉴感应开关来实现远程感应参数配置
查看 >>
怎样对接壁挂式双功能传感器以实现人体存在感应监测
查看 >>
如何在图书馆自习室人体存在感应中接入智能设备来实现远程人体存在状态监测
查看 >>
怎样对接吸顶式微波雷达探测器来实现存在感应数据上报
查看 >>