CATALOG

芯步的60A智能断路器开放标准HTTP API接口,支持通过简单命令实现远程通断和定时控制。以下方案涵盖设备选型、接口对接、签名计算及定时任务实现方式。

解决方案:基于芯步开放接口对接60A远程控制计量断路器实现远程定时通断

1. 选型与准备

  • 设备选型:选择智能大功率断路器[计量数显版] 60A。该设备支持8000W大功率负载,具备电压、电流、功率实时计量功能,且其核心控制命令(power1)与标准智能通断器完全兼容

  • 接口文档:芯步提供统一的HTTP API接口。所有智能硬件(通断器、墙壁开关、控制器)的命令格式高度一致,仅JSON内的order对象有所区别

  • 前置准备

    • 硬件安装:由专业电工将断路器接入电路(注意拧紧螺丝以防发热),确保设备通电。

    • 网络配置:通过“芯步”小程序为设备配网(需2.4G Wi-Fi),获取设备唯一ID(Device ID)

    • 开发者凭证:在芯步控制台获取 AppIdAppSecret 用于接口认证。

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点关),需要在您的业务服务器上设置定时任务:

  1. 任务调度:在服务器设置Cron表达式(例如:0 6 * * *)。

  2. 执行回调:北京时间06:00,服务器发起HTTP POST请求,携带 {"power1":1};20:00发起 {"power1":0}

  3. 此方式的难点:虽然实现简单,但需确保服务器时间与设备所在地时区一致,且注意Token有效期管理。

5. 拓展:状态反馈与计量数据获取

除了控制,60A计量版还具备数据上报能力,可用于节能分析。

  • 被动查询:调用设备状态接口获取实时电压、电流和功率。

  • 主动推送:在芯步控制台配置“数据流转”,将设备上报的计量数据通过HTTP Push或MQTT转发到您的指定服务器

6. 注意事项

  • 安全问题:60A断路器直接控制强电,请一定要确保接线牢固(虚接会导致发热起火)。本地测试时先断开负载或使用灯泡测试

  • 接口并发:芯步HTTP接口支持批量控制,如需同时控制多个回路,可使用 batch 命令格式,避免多次请求造成的网络延迟

  • 控制优先级:通过软件设置的“定时开/关”属于远程指令,物理按钮的操作同样生效。若现场有安全规定,可通过API启用“本地锁定”功能,此时物理按钮无效,仅API可控

7. 总结

通过芯步标准化的HTTP API,对接60A断路器仅需三步:

  1. 获取凭证(AppId/Secret)和设备ID

  2. 计算签名并发送 {"power1":1/0} 命令。

  3. 利用 reset 参数实现精准的定时任务。

这种方案无需复杂的嵌入式开发,可在任何支持HTTP的编程语言(Python, Java, PHP, Go 等)或低代码平台(如Node-RED)中快速实现