CATALOG

芯步的智能分体控制器支持HTTP接口调用,可以灵活实现多路独立控制。以下方案围绕接口鉴权、指令构建和联动触发三个核心环节展开,你可根据实际场景(如展厅、教室、工厂)调整配置参数。

解决方案:基于芯步开放接口实现24路智能分体控制器的自定义场景联动

1. 解决概述

芯步的智能分体控制器系列(如2路、4路、8路等型号)开放了标准的HTTP API接口,支持任何支持HTTP请求的编程语言或SaaS平台进行对接

为了实现“24路”及“自定义场景联动”,本方案采取 “积木式组合”“服务端编排” 的策略:

  • 硬件层:由于单台设备常见为4路或8路,24路通常意味着你需要组合使用 3台8路设备6台4路设备

  • 接口层:通过芯步的统一的 https://api.thingboot.com/{AppID}/device/control/ 接口,统一管理这组设备

  • 逻辑层:由你的业务服务器(或SaaS编排引擎)接收传感器信号(如人体雷达、温湿度传感器),执行联动逻辑(如“有人进入-开启第1-24路中的特定回路”),对硬件进行批量控制。

2. 核心接口与鉴权机制

在对接前,你需要确保已在芯步控制台获取以下凭证:AppID(应用ID)、AppSecret(开发者密码)以及 设备ID

接口地址(所有控制命令均指向此Endpoint):

POST https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

鉴权算法(重要)签名计算方式为 MD5( MD5(AppSecret) + ts )

  • ts:当前Unix时间戳(秒)。

  • 请求头需携带 Content-Type: application/json

3. 自定义场景联动的三大核心指令

针对24路输出,你需要熟练掌握以下三种命令格式,以实现复杂的自动化场景。

3.1 单路精准控制

这是最基础的指令。针对一台4路控制器,你可以单独控制每一路的通断。对于24路场景,你需要维护一个 设备ID -> 线路号 的映射表。

  • 指令示例:关闭设备“12345”的第3路。

注:power1powerN 对应第N路,值 1 代表通,0 代表断

3.2 批量同步控制(实现“一键全开/全关”)

当你需要在一个特定场景(如“下班模式”)下同时关闭24路(或其中特定的某几路)时,使用 batch 参数可以单次HTTP请求控制单台设备上的多个回路,减少网络开销。

  • 指令示例:关闭设备“67890”的第1路和第3路。

注:relay 数组代表要控制的线路集合

若有3台设备共24路需要联动,则需分别对这3台设备发起3次HTTP请求(或将逻辑封装在后端异步处理)。

3.3 时序脉冲控制(实现“触发器”效果)

在某些自定义场景中,你需要实现类似“点动”或“复位”的效果(例如控制自动卷闸门、电磁锁或复位设备)。这时候需要用到 point(先通后断)或 reset(先断后通)指令,并设置时间间隔。

  • 指令示例:让设备“abcde”的第2路接通1000毫秒后自动断开(模拟按下按钮)。

4. 构建“自定义场景联动”的技术实现流程

要实现基于环境变化的自动化联动(例如:温度高于30度 -> 自动开启24路中的风扇回路),请参考以下架构:

步骤一:配置消息接收服务器芯步的传感器(如温湿度传感器)支持实时状态上报。你需要在控制台配置 “消息推送” 地址(Your Server Webhook)。当传感器数据发生变化时,平台会主动POST数据到你的服务器。

步骤二:编写业务逻辑(联动规则引擎)在你的后端服务器中,接收传感器上报的数据,编写判断逻辑。例如:

步骤三:调用接口执行动作在业务逻辑触发点,调用芯步的控制API。以下是利用curl调用接口控制24路设备(示例控制其中一路)的通用代码示例

5. 典型场景案例:智能展厅/会议室

假设你有24路灯光和设备,将其分为3组(每台设备负责8路,设备ID分别为:A、B、C)。

  • 场景A:“迎宾模式”

    • 触发:人体存在雷达传感器探测到人。

    • 动作:后端同时调用设备A、B、C的接口,使用 batch 命令开启预设的1-10路筒灯。

    • 指令关键参数{"batch":{"relay":[1,2,3,4,5,6,7,8], "power":1}}

  • 场景B:“观影模式”

    • 触发:手机APP/面板点击。

    • 动作1:关闭部分灯光(发送 {"power1":"0"} 等)。

    • 动作2:如果24路中包含电动幕布或窗帘控制器,可采用 point 指令发送一个1000ms的脉冲信号,驱动电机运行。

6. 注意事项

  1. 私有化部署支持:如果你的业务涉及数据安全,芯步支持私有化部署方案。在局域网环境下,你可以将请求地址修改为自建服务器的IP,无需经过公网

  2. 设备配网:首次使用需通过“芯步控制台”或小程序进行WiFi配网(仅支持2.4G频段),确保设备与服务器网络通畅

  3. 超时与重试:24路同时响应涉及多台设备的并发控制。在你的后端使用异步任务队列,避免因单台设备响应慢导致整个场景控制超时。

  4. 多设备管理:当控制24路(多台物理设备)时,需在代码中循环调用接口或构造多线程并发请求,平台接口设计为单次请求控制单台设备

通过以上方案,你可以基于芯步的开放API,将物理上分散的24路继电器逻辑整合,实现高度自定义的软件定义联动。

控制器产品方案:
如何接入8路包间综合管理控制器以实现包间消费时长电源联动
查看 >>
如何接入共享空间智能控制器以实现自定义联动操作
查看 >>
怎样在照明控制中对接智能硬件以实现多达24路独立线路控制
查看 >>
无人售货机两路设备控制:如何把智能2路交流远程控制模块集成到软件项目中
查看 >>
如何二次开发4 路智能照明控制器来实现定时开关照明设备电源
查看 >>
联动场景方案:
怎么在共享台球厅人体感应联动中集成智能设备以实现故障告警通知
查看 >>
智能家居情景模式联动:怎样把DIY色彩氛围灯控制器接入到项目中
查看 >>
如何在弱电间空调联动中接入智能设备以实现空调风力调节
查看 >>
怎么在创客工坊门禁管理中集成智能设备来实现门禁系统联动控制
查看 >>
怎么二次开发双路智能墙壁控制开关以实现门禁与照明联动控制
查看 >>
场景用途方案:
怎样对接智能直流控制器4路以实现联动场景逻辑控制
查看 >>
如何二次开发AC4-30A 低压控制开关以实现场景联动控制
查看 >>
怎么接入智能 24 路远程开关控制模块以实现自定义场景联动控制
查看 >>
怎么接入2路智能墙壁开关以实现场景联动照明门禁控制
查看 >>
如何接入8位总控PDU插排以实现场景联动总控电源
查看 >>