CATALOG

芯步的开放接口基于标准HTTP协议,可与12路控制箱内嵌的智能继电器模块直接通信。以下方案以控制箱中任意2路作为独立回路为例,说明从硬件选型到接口调用的完整对接流程。

1. 概述与核心逻辑

在许多工业、农业或楼宇自动化场景中,需要对分布在现场的多路设备(如水泵、风机、照明、伴热带等)进行集中管理。采用12路分体智能设备控制箱,配合芯步的开放接口,可以在不改变现有强电线路的情况下,利用原有的WiFi/4G网络,实现对箱体内任意2路回路的独立远程控制。

本方案的核心逻辑是:控制箱内嵌的智能继电器模块(如芯步生态内的智能开关模块)作为执行终端,通过WiFi(2.4G)或以太网接入互联网/局域网。开发者或集成商通过调用芯步提供的标准HTTP API,向指定设备ID下发符合order规范的JSON指令,从而操控特定端口的通断。系统架构通常包含:现场设备层(12路控制箱+传感器)、网络传输层(WiFi/4G路由)和应用层(手机小程序、Web管理后台或MES系统)。

2. 硬件选型与预备工作

要实现针对“12路中的2路独立控制”,关键在于控制箱内部的模块选型。并非所有12路控制箱都支持API控制,需确保内部模块兼容芯步协议。

2.1 核心组件选择

  • 12路控制箱体:选择标准模块化结构的箱体,内部需预留DIN导轨空间。例如基于工业场景可选择具备防爆或漏电保护功能的一体化箱体;楼宇照明场景可选择标准模数化智能照明模块

  • 智能控制模块:虽然芯步有单/双路墙壁开关,但在12路箱体中,更推荐使用多路大功率继电器模块。若使用分离方案,需集成6个“智能墙壁开关2路”模块以组成12路;或采用支持Modbus-RTU转HTTP的网关配合12路IO模块

  • 网络保障:由于控制指令依赖网络,控制箱所处位置需覆盖稳定的WiFi 2.4G信号,或通过4G路由器提供热点。

2.2 接线与鉴权准备

  1. 强电接入:将12路输入总闸接入控制箱总进线。将需要远程控制的2路负载(如回路1对应“车间南区照明”,回路2对应“排风扇”)分别接在指定端口的继电器输出端。

  2. 平台注册:在芯步开放平台(ThingBoot Open)注册开发者账号,创建应用获取唯一的AppIDAppKey,这是后续API签名的凭证

  3. 设备添加:在控制台通过扫描智能模块上的二维码或手动输入,将12个回路(或两个多路模块)添加至设备列表,获取每个回路的唯一device(设备ID)。在命名时规范区分,如“Device_01_Corridor”、“Device_02_Fan”。

3. 开放接口对接实施步骤

这是解决方案的技术核心。要实现2路独立回路的远程控制,无需关心复杂的中继逻辑,直接针对目标设备的特定端口发送order指令即可。

3.1 接口调用基础

芯步采用标准的HTTP POST请求进行控制,这一点在墙壁开关和传感器产品中具有高度一致性

  • 请求地址https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

  • 数据格式:JSON

  • 必含字段

    • device:目标设备ID(即那一路开关的唯一标识)。

    • order:控制指令(JSON字符串),用于指定操作哪一路、做什么。

3.2 2路独立回路的指令设计

假设我们在12路箱体中挑选了第3路第7路作为本次独立控制对象,通过调用API分别控制这两个设备ID。

第一种场景:独立开启/关闭

  • 控制“第3路”开启{"device":"Device_03_ID", "order":{"power1":"1"}} 。这表示触发该设备的第一路继电器闭合(开启)

  • 控制“第7路”关闭{"device":"Device_07_ID", "order":{"power1":"0"}} 。这表示触发设备的继电器断开(关闭)

注:若12路箱体由6个“2路模块”组成,每个模块拥有power1power2两个控制端口,操作不同模块的power1即可控制不同的物理回路。

第二种场景:定时与脉冲控制在实际应用中,有时需要让某一回路通电几秒后自动关闭(如给电磁阀放水)。

  • 第3路“先通后断”(开启2秒后自动关闭):{"device":"Device_03_ID", "order":{"point1":"2000"}} 。该指令让1路导通2000毫秒后自动切断,非常适合控制闸门或警示灯

  • 状态保持:如果需要防止现场人员误触导致工艺中断,可以设置锁定。{"device":"Device_07_ID", "order":{"power1":{"keep":"1","revert":"3"}}} 。此指令强制该回路保持开启状态,即使现场有人手动关闭开关,3秒后也会自动恢复开启状态

3.3 代码实现示例(伪代码/逻辑)

在后端系统(如Node-RED、Python或Java后端)中,只需封装一个函数,动态传入设备ID和指令即可。

当用户在Web界面点击“开启3路”按钮时,前端调用该函数,传入第3路对应的设备ID,即可瞬间完成控制。

4. 高级应用与数据闭环

仅仅控制通断是不够的,一套完整的解决方案必须包含状态反馈安全保护

4.1 状态同步反馈

传统的机械开关存在“盲控”风险,即你不知道灯到底亮了没有。芯步的智能设备在继电器动作后或状态变化时,会上报消息至消息服务器。开发者需配置消息推送接口(Callback URL),当控制箱状态发生变化时,平台会主动将device和当前order状态推送到企业自有服务器,从而实现App上按钮状态与现场物理状态的实时同步

4.2 传感联动(智能化升级)

在12路控制箱中接入传感器(如芯步的智能人体存在雷达传感器)。

  • 联动逻辑:当雷达传感器探测到“有人”时,通过服务器脚本调用API,自动将第3路(照明)power1置为“1”;无人值守时,调用API关闭第7路(设备电源)。这种“传感器上报 -> 业务系统决策 -> API下发控制”的闭环,是实现智慧节能的核心手段

4.3 故障与应急处理

  • 本地应急:虽然强调远程,但12路控制箱应保留本地手动强制切换功能。当网络故障或服务器维护时,现场人员应能通过箱体上的机械应急按键直接操作,以确保生产安全

  • 断电记忆:在通过API配置参数时,可设定设备的“上电状态”。比如设定断电重启后,所有回路恢复为“关”,防止恢复供电时瞬时电流过大跳闸

5. 总结

对接芯步开放接口来控制12路分体智能设备控制箱,本质上是一个软件定义硬件的过程。通过标准化的HTTP API,开发者绕过了复杂的TCP/UDP透传或私有协议栈,直接通过简单的deviceorder参数组合,即可实现精细化权限管控。

针对“2路独立回路远程控制”这一目标,本方案证明:利用芯步平台的多路设备管理能力,通过携带签名的POST请求分别指定对应的设备ID和端口参数(power1/power2),并辅以合理的脉冲指令和状态保持机制,即可快速构建出响应速度快、逻辑清晰、且具备现场总线扩展能力的智能控制系统。

控制器产品方案:
高端会所包间设备管理:怎样把8 路包间场景联动控制器接入到项目中
查看 >>
怎样在店铺照明设备控制中集成智能设备以实现4路独立线路控制
查看 >>
校园公共照明控制:怎样将8路智能配电箱接入到软件项目中
查看 >>
怎么二次开发24 路智能分体远程控制设备联动模块以实现多达24路独立线路控制
查看 >>
怎么在店铺设备电源控制中集成智能硬件以实现8 路多通道独立控制
查看 >>
回路场景方案:
办公室插座回路保护:怎么将35A远程开关控制器集成到软件项目中
查看 >>
4路包间多回路控制模块MINI:怎么把4路包间电源智能控制器MINI对接到软件项目中
查看 >>
怎么在4路包间多回路控制模块MINI中集成智能设备来实现空调电源控制
查看 >>
实验室多回路设备集中控制:如何把16路分体智能配电控制箱对接到软件项目中
查看 >>
如何在养老社区两路公共区域电源管理中接入智能设备以实现两路回路状态查询
查看 >>
2路用途方案:
怎么在便利店照明管理中集成智能设备以实现2 路独立照明控制
查看 >>
怎么在物联网设备供电管理中接入智能设备来实现2路独立直流线路控制
查看 >>
怎样在共享麻将馆门禁照明联动中集成智能硬件以实现2路独立线路控制
查看 >>
怎么二次开发2路智能门禁照明开关以实现2路独立功能控制
查看 >>
怎样接入两路触摸控制开关以实现2 路独立照明控制
查看 >>