CATALOG

芯步的开放接口基于标准HTTP协议,采用MD5签名验证,将20A断路器的控制集成到现有软件项目中,在技术上只需实现“签名计算→指令下发”两个步骤。以下方案涵盖设备选型、接口对接流程、代码实现和联动策略。

解决方案:基于芯步开放接口的20A应急照明电源管理系统

1. 解决概述

在应急照明系统中,传统的20A断路器往往只具备过载和短路保护功能,无法实现远程监控和定时管理。本方案采用芯步智能通断器AC4-20A 替换传统断路器(或串接在回路中),利用其开放的HTTP API接口,将电源管理能力无缝对接到原有的或新建的智慧楼宇/消防软件平台中

通过本方案,管理人员不仅可以在软件后台实时查看应急照明回路的通断状态,还能精确执行“定时控制”、“按需点亮”或“能耗统计”,确保在紧急情况下照明系统可用,在日常情况下节能降耗。

2. 硬件选型:智能通断器 AC4-20A

针对“20A”这一核心参数,本方案选用芯步 AC4-20A 智能通断器。该设备支持最广泛的Wi-Fi 2.4G通信,无需额外购置网关,可直连路由器接入公网或局域网

  • 电气参数:支持20A额定电流,4400W总额定功率,完全覆盖单路应急照明回路负载需求。

  • 控制能力:支持远程分合闸,响应速度快,配合控制系统可实现精准的定时开关。

  • 接口优势:支持HTTP API、Mqtt等通用协议,提供标准的RESTful API,签名机制简单(MD5),适配Windows、Linux、ARM等各类服务器环境及Web、小程序、APP等前端

3. 软件对接技术实现

芯步的接口设计遵循极简原则,无论您的软件项目是基于Java、Python、PHP还是Node.js开发,均可通过以下流程完成对接。

3.1 接口协议与鉴权

所有控制指令均通过 POST 请求发送至芯步云端或私有化部署的网关。为了安全,每一次请求都需要携带动态签名(Sign)。

  • 请求地址http(s)://api.thingboot.com/{AppId}/device/control/

  • 鉴权参数

    • AppId: 应用唯一标识。

    • ts: 当前Unix时间戳,用于防止重放攻击。

    • sign: 由 AppSecretts 组合计算的MD5值。

签名生成逻辑(核心安全步骤)为了避免因网络抓包导致设备被恶意控制,签名算法采用了双层MD5加密:

  1. 先将 AppSecret 进行一次MD5加密,得到 SignKey

  2. SignKey 拼接上当前时间戳 ts

  3. 对拼接后的字符串再次进行MD5加密,得到最终的 sign*公式:sign = MD5( MD5(AppSecret) + ts )*

3.2 应急照明回路控制指令下发

通过HTTP请求向指定设备ID下发JSON格式的命令。

第一种场景:日常定时关闭(节能模式)通常在非工作时间,软件平台可自动触发指令关闭应急照明回路(但保留充电回路,视具体接线而定,通常指关闭灯具供电)。

  • 请求Body示例

  • 参数解析“power”:0 代表断开输出(断开断路器),“power”:1 代表闭合接通

第二种场景:消防演练/紧急维护(先断后通)为了测试应急照明蓄电池的放电能力,系统可以执行“先断后通”指令,模拟市电停电。

  • 请求Body示例

  • 逻辑说明reset 指令使设备先断开,等待10秒后自动重新闭合,用于模拟断电测试

3.3 状态同步与事件监听(Webhook)

软件项目不应仅仅具备“下发”能力,还需具备“感知”能力。

  • 机制:芯步平台支持 消息推送 机制。

  • 配置:在芯步控制台中配置您软件的接收URL(Callback URL)。

  • 数据价值:当断路器因过载跳闸或被人为触碰时,平台会实时将设备当前电压、状态推送到您的服务器,您的数据库可以记录下“某年某月某日,应急照明回路因过压跳闸”,实现故障运维智能化

4. 定时任务的软件逻辑设计

针对“电源管理”中的定时需求,有以下两种实现路径:

路径A: 软件层轮询(推荐用于少量设备)在您的软件项目内部(如Windows Service或Linux Cron Job)设定定时任务。

  • 代码逻辑:每日20:00,调用上述HTTP接口发送 {“power”: 1} 开启照明;每日06:00发送 {“power”: 0} 关闭照明。

  • 优势:完全由您的主控逻辑决定,无需依赖第三方平台界面。

路径B: 设备内置定时(利用设备属性)查阅设备文档可以发现,此类设备往往支持“定时器”或“点动”功能。

  • 操作:在对接时,可以通过发送特定参数(如 point 指令)实现“点动”,即接通2秒后自动断开,用于特定的脉冲控制场景

5. 私有化部署与网络架构方案

对于应急照明系统,数据安全性和网络稳定性至关重要。

  • 标准模式 (Cloud) :设备通过WiFi连接互联网,您的软件项目通过调用芯步云端API控制设备。适合需要异地远程运维的连锁酒店、大型园区。

  • 私有化模式 (LAN) :这是本方案的亮点。芯步设备支持纯局域网通信

    • 实施:部署一台本地服务器,在该服务器上运行您的软件项目。设备与服务器处于同一路由器下的局域网段。

    • 价值:控制指令不经过外网,时延低至毫秒级(80-120ms),且即便外部网络断开,应急照明系统的定时与联动依然正常工作,极大提高了医院、数据中心等关键场所的可靠性

6. 总结

将20A定时控制断路器接入软件项目的核心在于利用芯步标准化的 “设备ID + 指令集” 模型。开发者只需关注业务逻辑(何时开、何时关),无需编写底层硬件驱动。通过简单的HTTP集成,即可使应急照明系统具备物联网属性,实现从“被动保护”向“主动智能管理”的升级。