CATALOG

芯步的智能大功率断路器开放标准HTTP接口,可通过简单的API调用实现远程通断控制和计量数据读取。下面从接口接入、延时控制逻辑、计量反馈三个层面来说明具体实现方案。

一、 解决概述

本方案基于芯步智能大功率断路器[计量数显版](40A) 的开放API接口。核心思路是通过您的业务服务器或云平台,利用HTTP/HTTPS协议向设备发送指令,并在服务器端利用编程逻辑(如Sleep、计时器或定时任务)来实现精准的延时通断控制。

该方案适用于任何支持HTTP请求的编程语言(如Java, Python, PHP, Node.js, C#等)及运行环境(云服务器、局域网服务器、甚至嵌入式中控)。

组件说明交互方向
业务服务器负责执行延时逻辑,发起API请求核心控制端
芯步云平台设备接入与指令中转转发指令
40A智能断路器执行最终的通断电动作、上报计量数据被控制端

二、 接入准备工作

在编写控制代码前,需要先完成底层接口的配置,具体步骤请参考芯步开放平台的技术文档。

  1. 获取关键凭证

    • AppId: 您在芯步平台创建应用后获得的唯一ID。

    • 设备ID (Device ID): 目标40A断路器的唯一标识(例如 820720)。

    • Api Key/Secret: 用于生成接口签名(Sign)的密钥。

  2. 确认网络环境

    • 公网模式: 设备和服务器只要能访问互联网即可。

    • 局域网模式: 若对响应速度要求比较高或数据不出厂,该设备支持局域网纯本地控制,可直接通过设备IP调用接口(具体IP需在设备联网后获取)。

  3. 接口地址

    • 通常格式为:http(s)://api.thingboot.com/{AppId}/device/control/

三、 核心功能实现:延时通断控制

要实现延时通断,本质上是两次独立的API调用,中间由您的业务代码维持等待状态

1. 接口调用协议

所有控制命令均通过HTTP POST请求发送,携带签名(Sign)和时间戳(Ts)进行鉴权。

  • 请求方法: POST

  • 数据格式: JSON

核心控制命令格式示例:

2. 第一种场景:延时断电

需求:设备通电运行一段时间后(如2小时后)自动切断。逻辑:立即发送“通电”指令 -> 服务器等待/计时 -> 发送“断电”指令。

伪代码逻辑(以Python风格示例,仅供参考):

3. 第二种场景:延时通电(顺序启动)

需求:避免大功率设备同时启动冲击电网,需间隔5秒依次启动。逻辑

  • Step 1:发送“断电”指令(确保起始状态)。

  • Step 2:发送“通电”指令1。

  • Step 3:等待5秒。

  • Step 4:发送“通电”指令2。

4. 第三种场景:循环通断控制

需求:用于老化测试或周期性控制(如开10分钟,关5分钟)。逻辑:在服务器端开启定时器或While循环,交替发送 {“power”:1}{“power”:0} 指令。

四、 高级优化:基于计量数据的智能延时

40A断路器具有功率计量功能,可以实时上报电流、电压、功率等数据。利用计量数据,可以实现更智能的延时控制,这正是本方案区别于普通定时器的优势所在。

例如:“有电才断”或“无流则断”逻辑如果仅仅靠时间延时,可能会误判。例如设备程序卡死但仍在耗电,或者设备提前结束任务。

  1. 订阅数据上报: 断路器会实时将功率消息推送到您的服务器。

  2. 智能判断

    • 发送断电指令后,不要仅仅靠“时间”判断,可以读取当前的电流值

    • 逻辑示例:发送断电指令 -> 延时5秒 -> 读取实时功率。如果功率 > 50W,说明断电失败或设备内部仍有电源,系统可发出告警或重试断电。

  3. 过载保护延后断电: 检测到功率超过8000W(40A*220V)时,不立即切断(避免频繁启停损坏压缩机类设备),而是开始计时,若超功率持续超过3秒再执行断开指令。

五、 接口安全与鉴权说明

为了您的设备安全,每次调用API都需要进行签名验证,请留意以下要点:

  • 在线调试: 先使用芯步控制台自带的API调试功能,验证设备ID和控制指令的有效性。

  • 签名生成: 需要将所有参数(包含设备ID、指令内容、时间戳)与您的Secret Key进行加密拼接,生成Sign参数附加在URL中(?sign={sign}&ts={ts}),参考平台提供的代码示例进行接入。具体签名算法请以芯步官方文档为准。

  • 响应处理

    • 接口返回通常是异步的。调用成功仅代表指令下发成功,不代表设备已完成动作。若要获取设备动作后的确切状态,需配合消息推送功能,接收设备上报的动作完成回执。

综上所述,通过组合调用芯步标准的HTTP开关API与服务器端灵活的任务调度逻辑,即可轻松实现40A大功率断路器的延时通断控制。若要实现高可用的工业级定时任务,在服务器端集成Quartz(Java)或Celery(Python)等专业任务调度框架。