[92921] 文档版本:V1.0 更新日期:2026年5月 适用对象:软件工程师、物联网集成商、户外广告运营方
第一章:场景痛点与解决概述
1.1 广告灯箱电路控制的业务挑战
在城市户外广告、商圈灯箱、公交站牌广告等场景中,广告灯箱的电路控制涉及远程开关、用电监测、故障告警等多个维度。传统管理方式面临以下痛点:
| 痛点 | 具体表现 | 带来的影响 |
|---|---|---|
| 能耗无法统计 | 灯箱实际用电量无数据支撑 | 无法核算运营成本,难以优化投放策略 |
| 故障发现滞后 | 灯箱损坏需人工巡检 | 存在广告费损失风险 |
| 远程控制缺失 | 需现场操作开关 | 无法实现集中管理和时段自动控制 |
| 改造成本高 | 加装独立电表需额外设备 | 增加硬件投入和安装复杂度 |
1.2 解决方案:计量数显断路器实现智能灯箱控制
芯步智能大功率断路器[计量数显版]40A集成了远程控制和电能计量两大核心功能,通过HTTP接口与广告管理平台对接,实现“远程通断、实时计量、异常告警、数据分析”的完整灯箱管理闭环。
核心价值
一体化设计:通断控制 + 电能计量二合一,无需额外电表
实时数据:随时查询当前功率、累计用电量
远程可控:通过HTTP接口实现集中管理
开放协议:适用于任何支持HTTP请求的编程语言
与其他方案对比
传统微型断路器(如DZ47S)仅支持手动分断,无远程控制和计量功能
普通智能开关通常不具备计量和40A大功率能力
本方案集远程控制、功率计量、大功率承载于一体
1.3 智能大功率断路器[计量数显版]40A核心参数
本方案产品详细参数如下
| 参数项 | 规格详情 |
|---|---|
| 产品型号 | UNI-DLQ-M-40A-PD |
| 额定电流 | MAX 40A |
| 阻性负载功率 | MAX 8000W(白炽灯、电热器等) |
| 感性负载功率 | MAX 1400W(LED灯、电子镇流器等) |
| 工作电压 | AC 85-265V |
| 安装方式 | 35mm DIN导轨式 |
| 联网方式 | WiFi 2.4GHz / 4G可选 |
| 待机功耗 | 0.8W |
| 外壳材质 | 防火V0级PC,耐高温,符合安规标准 |
1.4 广告灯箱负载功率说明
广告灯箱负载类型直接影响功率限制
| 负载类型 | 功率限制 | 典型设备 |
|---|---|---|
| 阻性负载 | MAX 8000W | 传统钨丝灯、电热元件 |
| 感性负载 | MAX 1400W | LED灯、电子镇流器、节能灯 |
⚠️ 重要提示:广告灯箱普遍采用LED灯作为光源,属于感性负载,总功率需控制在1400W以内。如需更高功率,升级至50A或60A版本。
1.5 版本选型
| 版本 | 额定电流 | 阻性负载 | 感性负载 | 适用场景 |
|---|---|---|---|---|
| 40A版 | MAX 40A | 8000W | 1400W | LED灯箱(推荐) |
| 50A版 | MAX 50A | 10000W | 1700W | 大功率灯箱 |
| 60A版 | MAX 60A | 12000W | 2000W | 超大面积灯箱 |
| 4G版 | 同上 | 同上 | 同上 | 无WiFi覆盖场景 |
第二章:HTTP接口协议详解
2.1 整体架构
芯步智能断路器采用标准的HTTP请求-响应模型,适用于任何支持HTTP请求的编程语言
graph LR
subgraph 软件层
A[广告管理平台/小程序]
end
subgraph 网络层
B[芯步API网关
api.thingboot.com]
end
subgraph 硬件层
C[40A计量断路器
配电箱内]
end
A -- "HTTP POST (带签名)" --> B
B -- "MQTT透传" --> C
C -- "计量数据返回" --> A性能指标:从命令下发到设备响应,端到端延迟约为80-120ms。
2.2 请求地址格式
https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}URL参数说明
| 参数 | 说明 | 示例 |
|---|---|---|
{AppId} | 应用ID,在芯步控制台获取 | 10001 |
sign | 动态签名 | a1b2c3d4... |
ts | 当前Unix时间戳(秒级) | 1746000000 |
2.3 签名算法(核心安全机制)
芯步API采用双重MD5签名机制
Sign = md5( md5(AppSecret) + ts )
签名计算步骤
flowchart LR
A[AppSecret] --> B[MD5加密]
B --> C[32位小写: md5_secret]
C --> D[拼接ts: md5_secret + ts]
D --> E[再次MD5加密]
E --> F[最终Sign]Python示例
2.4 核心命令集
同产品类型的设备命令格式统一,智能大功率断路器支持以下核心命令:
| 命令类别 | 命令示例 | 说明 |
|---|---|---|
| 接通电源 | {"power":"1"} | 闭合断路器,灯箱通电 |
| 断开电源 | {"power":"0"} | 断开断路器,灯箱断电 |
| 计量查询 | {"metering":""} | 查询功率、累计用电量等 |
| 状态查询 | {"get_status":""} | 查询通断状态和在线状态 |
2.5 计量数据查询(核心功能)
对于广告灯箱能耗统计场景,计量数据查询是最核心的功能
命令格式
返回示例(根据实际产品定义):
2.6 完整请求示例
第三章:多语言代码实现
3.1 Python完整实现
3.2 Node.js实现
3.3 Java实现
3.4 Shell脚本(cURL)实现
第四章:广告灯箱业务场景集成
4.1 系统集成架构
广告灯箱智能控制系统可与运营管理平台深度集成:
graph TB
subgraph 硬件层
A[40A计量断路器]
B[广告灯箱]
end
subgraph 采集层
C[定时采集服务]
D[计量数据API]
end
subgraph 存储层
E[时序数据库]
F[业务数据库]
end
subgraph 应用层
G[运营看板]
H[能耗报表]
I[远程控制台]
J[异常告警]
end
A -->|计量数据| C
A -->|控制指令| I
C --> D
D --> E
D --> F
E --> G
E --> H
F --> I
C --> J4.2 第一种场景:灯箱远程集中控制
业务需求:运营人员通过管理后台远程控制多个广告灯箱的开关。
实现逻辑
管理后台展示所有灯箱列表
点击开关按钮调用API
支持批量控制和分组控制
代码实现
4.3 第二种场景:灯箱能耗实时监测
业务需求:实时监测灯箱用电功率和累计用电量,为广告投放效果评估提供数据支撑。
实现逻辑
定时采集设备计量数据
存入时序数据库
可视化展示功率曲线和能耗趋势
代码实现
4.4 第三种场景:定时自动开关(节能策略)
业务需求:广告灯箱按预设时间自动开关,实现无人值守运营。
实现逻辑
配置不同灯箱的开关时段
使用定时任务框架自动执行
支持节假日特殊时段调整
代码实现
4.5 场景四:用电异常告警
业务需求:监测到灯箱功率异常(过高或过低)时自动告警。
实现逻辑
设定功率正常范围
定时采集功率数据
超出范围触发告警
代码实现