芯步的60A智能断路器开放标准HTTP API接口,支持通过简单命令实现远程通断和定时控制。以下方案涵盖设备选型、接口对接、签名计算及定时任务实现方式。
解决方案:基于芯步开放接口对接60A远程控制计量断路器实现远程定时通断
1. 选型与准备
设备选型:选择智能大功率断路器[计量数显版] 60A。该设备支持8000W大功率负载,具备电压、电流、功率实时计量功能,且其核心控制命令(
power1)与标准智能通断器完全兼容。接口文档:芯步提供统一的HTTP API接口。所有智能硬件(通断器、墙壁开关、控制器)的命令格式高度一致,仅JSON内的
order对象有所区别。前置准备
硬件安装:由专业电工将断路器接入电路(注意拧紧螺丝以防发热),确保设备通电。
网络配置:通过“芯步”小程序为设备配网(需2.4G Wi-Fi),获取设备唯一ID(Device ID)。
开发者凭证:在芯步控制台获取
AppId和AppSecret用于接口认证。
2. 接口鉴权机制
芯步接口采用动态签名(Sign)认证,核心是 md5(md5(AppSecret) + ts)。以下是签名生成逻辑(通用伪代码):
注:时间戳(ts)用于防止请求重放,前后误差通常不超过5分钟。
3. 实现远程通断控制
控制断路器最核心的操作是发送 power1 命令(针对单路大功率设备)。
请求地址
POST https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}请求头
Content-Type: application/json请求体
开启输出
{ "device": "设备ID", "order": {"power1": 1} }关闭输出
{ "device": "设备ID", "order": {"power1": 0} }
cURL 示例
发起请求后,设备响应时间约为 80-120ms,可用于集成到工单系统或自动化脚本中。
4. 实现远程“定时”通断策略
针对“定时通断”需求,芯步支持两种实现路径,推荐使用设备自带定时属性以降低服务器开销:
方案一:利用设备内置定时(推荐)
不需要使用外部的任务队列(如Quartz或Linux Crontab),只需在 order 命令中传入延迟恢复参数 reset。
适用场景:临时通电(如充电桩限时、设备重启)、几小时后自动断电。
命令示例:让断路器立即闭合(通电),并在 3600秒(1小时) 后自动断开。
设备会在执行“通”命令后,自动倒计时并在时间到达后执行“断”,即使网络中断也不影响定时执行。
方案二:应用层主动轮询与调用
若需要周期性控制(如:每天早上6点开,晚上8点关),需要在您的业务服务器上设置定时任务:
任务调度:在服务器设置Cron表达式(例如:
0 6 * * *)。执行回调:北京时间06:00,服务器发起HTTP POST请求,携带
{"power1":1};20:00发起{"power1":0}。此方式的难点:虽然实现简单,但需确保服务器时间与设备所在地时区一致,且注意Token有效期管理。
5. 拓展:状态反馈与计量数据获取
除了控制,60A计量版还具备数据上报能力,可用于节能分析。
被动查询:调用设备状态接口获取实时电压、电流和功率。
主动推送:在芯步控制台配置“数据流转”,将设备上报的计量数据通过HTTP Push或MQTT转发到您的指定服务器。
6. 注意事项
安全问题:60A断路器直接控制强电,请一定要确保接线牢固(虚接会导致发热起火)。本地测试时先断开负载或使用灯泡测试。
接口并发:芯步HTTP接口支持批量控制,如需同时控制多个回路,可使用
batch命令格式,避免多次请求造成的网络延迟。控制优先级:通过软件设置的“定时开/关”属于远程指令,物理按钮的操作同样生效。若现场有安全规定,可通过API启用“本地锁定”功能,此时物理按钮无效,仅API可控。
7. 总结
通过芯步标准化的HTTP API,对接60A断路器仅需三步:
获取凭证(AppId/Secret)和设备ID。
计算签名并发送
{"power1":1/0}命令。利用
reset参数实现精准的定时任务。
这种方案无需复杂的嵌入式开发,可在任何支持HTTP的编程语言(Python, Java, PHP, Go 等)或低代码平台(如Node-RED)中快速实现。