基于芯步的开放接口,针对园区设备机柜场景,可以通过“智能控制器”类硬件实现5台设备的独立分路电源控制。以下方案从硬件选型、接口对接、核心实现到扩展功能给出完整路径。
1. 背景与需求
在园区管理中,设备机柜(如弱电井、网络机柜、路灯控制柜)内往往部署了交换机、摄像头、路测单元、功放等多种设备。传统管理方式下,当某台设备死机或需要重启时,运维人员必须前往现场手动插拔电源或断开空开,效率低下且维护成本高。
核心需求
需对机柜内5台独立设备进行远程分路控制(开/关/重启)。
无需更换现有设备,仅对供电线路进行改造。
支持通过园区现有网络(局域网)或公网进行远程API调用。
具备故障自动恢复或定时任务能力。
2. 整体设计
基于芯步开放平台,采用 “云+端” 或 “本地局域网+端” 的架构。
控制层:园区运维系统(Web/APP)或自动化脚本。
平台层:芯步开放平台(支持公有云或私有化部署,本文以私有化局域网模式为例,保障稳定性)。
执行层芯步 智能控制器4路(首选方案,因需控制5台设备,可采用2台4路控制器,其中一台只用3路;或采用1台4路加1台1路)。
被控设备:机柜内的5台目标设备(如设备A、B、C、D、E)。
工作流程
运维系统调用HTTP接口发送“关闭线路1”指令。
平台将指令推送给机柜内的智能控制器。
智能控制器执行继电器动作,断开对应插座的电源。
等待设定时间后,再次发送“开启线路1”指令,实现设备重启。
3. 核心设备选型:智能控制器
为实现分路控制,需选用具备多路继电器输出的智能硬件。根据芯步产品线,推荐以下型号:
| 设备型号 | 接口类型 | 路数 | 对接优势 |
|---|---|---|---|
| 智能控制器4路 | 4G/WiFi/以太网 | 4路独立控制 | 支持HTTP/MQTT,指令响应快,支持交流/直流不同版本 |
| 智能PDU/插座 | WiFi/以太网 | 4-8位独立插孔 | 无需布线,直接插拔,适合机柜内部署 |
选型由于需求是控制5台设备,最经济的方案是采用 1台4路控制器 + 1台1路控制器(如智能墙壁开关1路),或者直接采用一台8口智能PDU(电源分配单元)。针对机柜环境,推荐使用 智能控制器4路(交流版) 组合使用。
注意:芯步的智能控制器通常提供“常开/常闭”触点,直接串联在设备的输入端即可 。
4. 接口对接详解
芯步开放接口非常简洁,基于HTTP协议,无需复杂的SDK即可集成。
4.1 接口信息
请求地址
http(s)://{您的域名或 api.thingboot.com}/{AppID}/device/control/请求方式:POST(推荐,参数较长)
鉴权方式:URL携带
sign(签名)和ts(时间戳) 。
4.2 核心指令解析(控制5台设备)
假设我们部署了两台设备:
控制器A(ID: 100001):负责控制 设备1、设备2、设备3、设备4。
控制器B(ID: 100002):负责控制 设备5。
1) 单独控制某一路
如果设备1(接在控制器A的线路1上)死机,需要重启(先关后开):
Step 1: 关闭线路1
Step 2: 等待5秒后开启
2) 批量操作(一键重启所有)
如果需要一次性重启机柜内所有5台设备(例如维护后上电)。可以利用 batch 指令 。
控制前4路
控制第5路
3) 高级指令:自动脉冲重启(Pulse)
如果想要实现类似“按一下物理按钮”的效果(立即断电,间隔1秒后自动通电),可以使用 point 或 reset 指令。这对于解决设备死机非常有效,无需写两行代码 。
针对第5路设备发送脉冲重启
5. 实施方案步骤
第一阶段:硬件安装
断电操作:切断机柜总电源。
设备接线
将智能控制器安装在机柜导轨上。
输入端子接机柜输入总电(220V AC)。
输出端子(COM/NO):将5台设备的电源线火线分别剪断,串联进控制器的继电器输出端。注意:零线共用。
由于控制器通常只有4路,可利用1台4路控制器控3台大功率设备 + 1台1路控制器控其余2台,或使用8路继电器模块。
网络配置:通过芯步的“智慧物联”APP/工具,为控制器配置WiFi(2.4G)或有线网络,确保其能访问服务器 。
第二阶段:平台对接
注册/部署:如果是公有云,注册开发者账号;如果是私有化部署,搭建本地MQTT/HTTP服务。
获取凭证:在芯步控制台获取
AppID和AppSecret(用于生成sign签名)。开发联调
编写脚本,生成动态签名(通常是 MD5 或 SHA256,参数排序后拼接 Secret)。
调用
设备列表接口确认设备deviceID在线。测试下发
{"power1":"1"}指令,观察继电器是否吸合。
第三阶段:策略应用
定时任务:利用芯步云平台的“定时任务”功能,设定每周自动重启一次设备,清理缓存。
故障联动:配合芯步的智能传感器(如PING检测服务器通断)。如果服务器ping不通,系统自动调用接口重启对应端口的电源 。
6. 技术点和需要注意的点
设备ID唯一性每个硬件的外壳上都贴有唯一的Device ID,这是API调用的关键标识 。
鉴权处理(Sign)接口安全性较高,所有请求必须在URL中包含签名和时间戳。注意:时间戳
ts通常与服务器时间误差不能超过5分钟(可配置)。示例Sign生成逻辑(伪代码)
sign = md5(AppID + AppSecret + ts + 排序后的参数)私有化部署(局域网)园区出于安全考虑通常不允许设备上公网。芯步支持私有化部署,只需将平台服务端部署在园区服务器,设备指向内网IP即可,这样可以实现断外网情况下的稳定控制 。
功率限制控制器的每一路通常有电流上限(如10A/2200W)。如果机柜内有核心交换机或大功率空调,请确认设备功率是否超过继电器触点容量。若超过,应通过控制器控制交流接触器来间接控制大功率设备。
执行反馈HTTP接口返回200仅代表指令下达成功,不代表设备真的断电了。要获取真实的执行结果,需订阅MQTT消息或配置消息推送,接收设备上报的动作完成回执 。
7. 总结
通过采用芯步 4路智能控制器配合其HTTP开放接口,园区管理方仅需编写少量代码即可快速实现对机柜内5台设备的远程分路控制。该方案不仅解决了人工现场维护的低效问题,还预留了定时重启、故障自愈等自动化扩展能力,是实现智慧园区精细化管理的基础组件。