CATALOG

芯步的25A智能断路器采用HTTP API接口设计,签名验证机制清晰,对接门槛较低。以下是完整的接入方案,涵盖鉴权、接口调用、设备配网到业务场景的全流程。

1. 解决概述

在数字户外广告迅猛发展的今天,广告灯箱的运维管理面临着能耗监控缺失、故障响应滞后、巡检人力成本高三大痛点。传统的“人为巡检+手动跳闸”模式已无法满足广告公司对媒体资源精细化管理的要求。

本方案的目标是通过集成芯步25A智能断路器,利用其开放的标准HTTP接口,将广告灯箱的电路控制能力无缝对接到现有的软件项目(SaaS平台、移动端APP或微信小程序)中。通过软件定义硬件,实现灯箱的远程实时控制、过载自动保护、定时策略执行及工况数据可视化,从而构建“云端管控、极速响应、安全节能”的智慧广告灯箱管理体系。

2. 硬件选型:25A过流保护智能断路器

本方案所选用的设备是基于芯步生态的智能断路器25A(型号:UNI-DLQ-25A)或其同品类的通断器。

该硬件具备以下与企业级软件集成强相关的特性

  • 负载能力:额定电流25A,可覆盖绝大多数户外广告灯箱、霓虹灯带及商业照明的高功率负载需求。

  • 通信与组网:支持Wi-Fi 2.4G直连,无需额外网关,减少现场故障节点;同时支持5组Wi-Fi网络热备,信号不稳时自动切换。

  • 核心接口:全面开放HTTP API接口,这意味着无论你的后端是Java、Python、Go还是前端JavaScript/TypeScript,均可通过标准的POST请求进行控制。

  • 私有化部署:支持纯局域网环境和私有化部署,满足金融级或大型广告连锁企业对数据安全性的苛刻要求。

3. 软件集成技术方案

本方案的核心在于利用芯步开放的API层,打破硬件与业务逻辑之间的壁垒。芯步的接口设计遵循极简原则,只需携带动态签名设备ID即可完成鉴权与控制

3.1 接口鉴权与请求封装

为了保证接口调用的安全性,芯步采用了双层MD5签名机制。在向 api.thingboot.com/{AppId}/device/control/ 发起请求前,必须动态计算签名。

签名生成逻辑(Signature Generation):

  1. 获取当前的Unix时间戳(秒),定义为 ts

  2. 将开发者的 AppSecret 进行一次MD5加密,得到 Secret_MD5 = md5(AppSecret)

  3. Secret_MD5ts 拼接,形成字符串 SignStr = Secret_MD5 + ts

  4. SignStr 再次进行MD5加密,得到最终的 sign

签名验证流程:软件服务端需先通过 AppID 和 AppSecret 生成带签名的请求 URL,芯步云端解密签名并验证时间戳有效性后,才会执行设备指令

代码交互示意(Python风格):

3.2 关键API指令映射

在广告灯箱场景中,除了简单的“开”和“关”,还需要应对复杂的商业场景(如按周播放、临时断电保护)。你需要根据项目需求,使用以下几种API指令组合

功能分类API指令参考 (Order参数)广告灯箱应用场景描述
即时控制{“power”: 1} (开) / 0 (关)运维人员通过手机APP远程关闭故障灯箱,或临时点亮进行巡检。
定时任务{“power”: 1, “reset”: 3600000}节能策略:下发指令开启灯箱,并设定1小时后自动关闭,避免深夜无人时段耗电。
多路管理{“power1”:1, “power2”:0}分屏控制:控制同一灯箱内的主照明(晚6点开)与辅照明(晚10点开)分时启动。
批量操作{“batch”:{“relay”:[1,2], “power”:0}}区域联动:商业体打烊时,一键关闭该区域内所有广告灯箱。
状态监测(设备主动上报)故障预警:监测到电流异常或过载跳闸时,实时推送告警至运维系统。

3.3 设备初始化与配网集成

为了降低大规模部署时的人工成本,你需要在软件项目中包含配网引导流程。芯步的25A断路器通过Wi-Fi SoftAP或蓝牙方式进行配网

  • 配置流程

    1. 软件端(App/小程序)提示用户将设备置于待配网模式(指示灯快闪)。

    2. 手机连接设备发出的热点信号。

    3. 软件将目标路由器的SSID和密码通过接口写入设备。

    4. 设备重启并连接到云端。

  • 接入策略:在软件业务逻辑中增加“设备激活”模块,将硬件底层的Device ID与业务系统的灯箱资产编号进行绑定。

4. 业务逻辑场景

将上述技术接口封装后,广告灯箱的管理软件可以实现以下深度业务逻辑:

4.1 基于日出/日落的地理位置定时

不再使用固定的北京时间开关灯。

  • 实现的方式是:软件后端获取灯箱所在地的经纬度,计算当日日落时间(如18:23)和日出时间(如06:15)。

  • 指令下发:在日落时间戳调用 {“power”:1},在日出时间戳调用 {“power”:0}。这比传统时控开关更科学,且无需人工随季节调整。

4.2 过流过载智能化自愈

灯箱内部LED电源损坏时常导致跳闸。

  • 实现的方式是:监听芯步设备上报的过载事件(通过Webhook或MQTT)。

  • 自愈策略:软件捕获到过流保护事件后,记录日志,等待30秒(电源电容放电),自动下发{“power”:0}关闭指令,再隔5秒下发{“power”:1}尝试重启。若重启后短时间内再次跳闸,软件则锁定该设备并派发维修工单。

4.3 用电能耗数据分析

虽然部分基础版专注于控制,但结合芯步生态中的计量型设备或API数据上报,软件可进行大数据分析

  • 数据价值:通过分析不同广告点位的耗电量(kWh),软件可以判断灯箱的老化程度(同样时长下功耗突增通常意味着电源模块老化)或核算广告位的真实运营成本。

5. 架构优势与总结

将25A智能断路器接入软件项目,不仅仅是“用电脑代替手按开关”,而是对广告灯箱运维体系的深度重构。基于芯步的开放接口,开发者只需关注业务逻辑(如计费、工单、策略),而无需关心底层硬件通信细节:

  1. 开发效率高:HTTP协议是Web开发的基石,任何语言都可以在数小时内完成接口对接。

  2. 响应迅速:实测指令下发到设备动作执行在80-120ms之间,点击APP开关几乎没有延迟感

  3. 部署灵活:由于支持私有化部署和局域网IP直连,该方案既适用于公有云管理的连锁广告商,也适用于要求内外网隔离的敏感环境

通过实施本方案,广告运营商能够从“被动维修”转变为“主动智能管控”,在降低电费支出与人力成本的同时,显著提升广告在线的可靠时长。