芯步40A计量版空开支持HTTP接口调用,实现远程定时控制的核心思路是:利用设备内置的“硬件定时”能力(如reset参数)避免复杂的云端任务队列,或用外部程序通过API触发。以下是具体方案:
一、 技术背景与准备
芯步的智能硬件产品(包括40A计量版断路器)核心优势在于其 免费、开放且标准化的HTTP接口。这意味着,无论您的软件项目是基于哪种编程语言(Java, Python, PHP, Node.js)或运行在何种环境中(云服务器、本地局域网、甚至树莓派),只要能够发送HTTP POST请求,即可实现对设备的控制。
在开始二次开发前,请确保完成以下准备工作:
硬件就绪: 确认40A计量版断路器已正确安装(导轨安装,接好负载线),并已通电。
网络配置: 使用芯步提供的“小程序配网”功能,将设备连接至可访问互联网的2.4GHz Wi-Fi网络(如果是局域网控制,需确保设备与服务器在同一网段且支持私有化部署)。
获取关键凭证: 登录芯步控制台,在“开发设置”中获取:
AppID: 您的应用唯一标识。
AppSecret: 用于计算动态签名,确保接口安全。
设备ID: 目标40A断路器的唯一标识(可在控制台设备列表查看)。
二、 核心逻辑:实现“远程定时任务”
实现“定时任务”通常有两种技术路径,针对40A计量版空开的特性,我们重点推荐路径一。
路径一:利用设备硬件原生定时能力(推荐,高可靠性)
芯步的断路器固件内置了定时逻辑。你只需要在发送控制命令时,附带一个时间参数(如 point 或 reset),设备端会自行计时执行。这种方式不依赖云端服务器的任务队列,即使执行命令后您的服务器断网,设备也会在设定时间执行动作,最为稳定。
应用场景: 电动车充电桩定时断电、工业设备预热后启动、定时开关灯。
路径二:云端/服务器端脚本控制(高灵活性)
如果任务逻辑比较复杂(例如:根据天气情况决定是否断电,或需频繁变动时间),可以在您的服务器上运行定时脚本(如Cron Job、Windows Task Scheduler),在指定时间调用HTTP接口发送命令。
三、 详细实施方案与代码示例
在二次开发中,您主要操作的是 控制接口。
请求地址:
https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}请求方法: POST
数据格式: JSON
第一种场景:实现“一小时后自动断开”或“延时断开”
需求: 40A空开立即闭合,持续通电1小时(3600000毫秒)后自动切断。
解决方案: 使用 order 参数中的 reset 指令。
代码示例 (Python)
第二种场景:实现“自定义时间点” 通断控制
需求: 需要支持每天固定在 08:00 开启,18:00 关闭。
解决方案: 使用云服务器上的定时任务。
步骤 1: 编写通用控制函数。步骤 2: 设置Cron表达式 (Linux) 或 计划任务 (Windows)。
代码示例 (伪代码/Node.js 思路)
第三种场景:利用计量功能实现“智能联动”
需求: 充电完成后(功率低于阈值)自动断电,保护电池。
解决方案: 调用 设备状态查询接口,获取实时功率数据进行逻辑判断。
实现思路
服务器每隔30秒获取一次设备当前功率(调用设备状态API)。
如果检测到
Current Power< 50W(待机功率)且状态为通电中,则主动调用“断电”接口。这模拟了智能插座的一种“充满自停”功能。
关键API调用
获取设备状态:
GET https://api.thingboot.com/{AppID}/device/status/?device={DeviceID}...返回数据通常包含:
power(功率),voltage(电压),electric(电量)。
四、 硬件特色功能和需要注意的点
远程控制 vs 本地手动40A断路器通常带有物理按钮。您可以通过API设置按钮行为,例如:“屏蔽物理按钮”(防止现场人员误触导致生产中断)或者“恢复物理按钮”。命令示例:
{"config":{"key":"func","value":"0"}}(根据不同固件,值代表禁用/启用)。局域网控制(私有化部署)如果您对响应速度要求比较高(如工业流水线联动)且担心外网中断,可开启局域网模式。设备会广播本地IP,您可以直接向
http://[设备IP]/...发送命令(格式与云端API类似),实现毫秒级控制。签名机制(坑点提示)接口安全要求
sign为动态值。计算公式:sign = md5( md5(AppSecret) + ts )。请注意: 是先将AppSecret进行一次MD5,拼接上时间戳ts后,再整体做一次MD5。
五、 总结
通过上述方案,开发者可以利用 芯步40A计量版断路器 的开放接口,实现从简单延时到复杂逻辑触发的各种定时任务控制。
简单定时:充分利用设备内置的
reset/point硬件定时指令,代码量最小且最稳定。复杂排程:结合服务器端的定时任务(Cron)调用API。
高级联动:结合计量数据回传,实现动态闭环控制(如充满自停、过载预警)。