CATALOG

基于芯步的开放接口,针对园区设备机柜场景,可以通过“智能控制器”类硬件实现5台设备的独立分路电源控制。以下方案从硬件选型、接口对接、核心实现到扩展功能给出完整路径。

1. 背景与需求

在园区管理中,设备机柜(如弱电井、网络机柜、路灯控制柜)内往往部署了交换机、摄像头、路测单元、功放等多种设备。传统管理方式下,当某台设备死机或需要重启时,运维人员必须前往现场手动插拔电源或断开空开,效率低下且维护成本高。

核心需求

  • 需对机柜内5台独立设备进行远程分路控制(开/关/重启)。

  • 无需更换现有设备,仅对供电线路进行改造。

  • 支持通过园区现有网络(局域网)或公网进行远程API调用。

  • 具备故障自动恢复或定时任务能力。

2. 整体设计

基于芯步开放平台,采用 “云+端”“本地局域网+端” 的架构。

  • 控制层:园区运维系统(Web/APP)或自动化脚本。

  • 平台层:芯步开放平台(支持公有云或私有化部署,本文以私有化局域网模式为例,保障稳定性)。

  • 执行层芯步 智能控制器4路(首选方案,因需控制5台设备,可采用2台4路控制器,其中一台只用3路;或采用1台4路加1台1路)。

  • 被控设备:机柜内的5台目标设备(如设备A、B、C、D、E)。

工作流程

  1. 运维系统调用HTTP接口发送“关闭线路1”指令。

  2. 平台将指令推送给机柜内的智能控制器。

  3. 智能控制器执行继电器动作,断开对应插座的电源。

  4. 等待设定时间后,再次发送“开启线路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秒后自动通电),可以使用 pointreset 指令。这对于解决设备死机非常有效,无需写两行代码

针对第5路设备发送脉冲重启

5. 实施方案步骤

第一阶段:硬件安装

  1. 断电操作:切断机柜总电源。

  2. 设备接线

    • 智能控制器安装在机柜导轨上。

    • 输入端子接机柜输入总电(220V AC)。

    • 输出端子(COM/NO):将5台设备的电源线火线分别剪断,串联进控制器的继电器输出端。注意:零线共用。

    • 由于控制器通常只有4路,可利用1台4路控制器控3台大功率设备 + 1台1路控制器控其余2台,或使用8路继电器模块。

  3. 网络配置:通过芯步的“智慧物联”APP/工具,为控制器配置WiFi(2.4G)或有线网络,确保其能访问服务器

第二阶段:平台对接

  1. 注册/部署:如果是公有云,注册开发者账号;如果是私有化部署,搭建本地MQTT/HTTP服务。

  2. 获取凭证:在芯步控制台获取 AppIDAppSecret(用于生成sign签名)。

  3. 开发联调

    • 编写脚本,生成动态签名(通常是 MD5 或 SHA256,参数排序后拼接 Secret)。

    • 调用 设备列表 接口确认设备 deviceID 在线。

    • 测试下发 {"power1":"1"} 指令,观察继电器是否吸合。

第三阶段:策略应用

  1. 定时任务:利用芯步云平台的“定时任务”功能,设定每周自动重启一次设备,清理缓存。

  2. 故障联动:配合芯步的智能传感器(如PING检测服务器通断)。如果服务器ping不通,系统自动调用接口重启对应端口的电源

6. 技术点和需要注意的点

  1. 设备ID唯一性每个硬件的外壳上都贴有唯一的Device ID,这是API调用的关键标识

  2. 鉴权处理(Sign)接口安全性较高,所有请求必须在URL中包含签名和时间戳。注意:时间戳 ts 通常与服务器时间误差不能超过5分钟(可配置)。

    示例Sign生成逻辑(伪代码)sign = md5(AppID + AppSecret + ts + 排序后的参数)

  3. 私有化部署(局域网)园区出于安全考虑通常不允许设备上公网。芯步支持私有化部署,只需将平台服务端部署在园区服务器,设备指向内网IP即可,这样可以实现断外网情况下的稳定控制

  4. 功率限制控制器的每一路通常有电流上限(如10A/2200W)。如果机柜内有核心交换机或大功率空调,请确认设备功率是否超过继电器触点容量。若超过,应通过控制器控制交流接触器来间接控制大功率设备。

  5. 执行反馈HTTP接口返回200仅代表指令下达成功,不代表设备真的断电了。要获取真实的执行结果,需订阅MQTT消息或配置消息推送,接收设备上报的动作完成回执

7. 总结

通过采用芯步 4路智能控制器配合其HTTP开放接口,园区管理方仅需编写少量代码即可快速实现对机柜内5台设备的远程分路控制。该方案不仅解决了人工现场维护的低效问题,还预留了定时重启、故障自愈等自动化扩展能力,是实现智慧园区精细化管理的基础组件。

插排产品方案:
配电柜智能改造:怎样把8位远程控制总控PDU集成到项目中
查看 >>
车间设备机柜电源控制:怎样把5位远程控制PDU接入到自己的项目中
查看 >>
怎么接入机柜PDU(5位)以实现多设备联动控制
查看 >>
车间设备电源控制:怎样把智能5位总控PDU接入到软件项目中
查看 >>
怎样在医院设备机柜电源管理中集成智能硬件来实现5路设备电源总控
查看 >>
园区场景方案:
园区语音广播:怎么将20W 壁挂语音提醒通知音箱集成到软件项目中
查看 >>
物流园区语音通知:怎样将30W 物联网语音广播音箱对接到软件项目中
查看 >>
园区设备电源控制:怎么把1位5孔远程控制电源插座接入到项目中
查看 >>
怎么在物流园区语音通知中集成智能设备来实现场景联动语音提示
查看 >>
园区路灯电路管理:如何将40A联动控制智能空开对接到项目中
查看 >>
5台用途方案:
怎么在车间设备机柜电源控制中集成智能硬件来实现分路开关控制5台设备电源
查看 >>
如何接入分控PDU(5位)以实现分路开关控制5台设备电源
查看 >>
怎么在培训教室设备机柜电源控制中集成智能硬件来实现分路开关控制5台设备电源
查看 >>
如何在广告机设备机柜电源管理中接入智能设备以实现总开关控制5台设备电源
查看 >>
怎样在产线自动化机柜电源管理中对接智能硬件来实现分路开关控制5台设备电源
查看 >>