[49957] 文档版本:V1.0 更新日期:2026年5月 适用对象:软件工程师、系统集成商、共享充电项目负责人
第一章:场景痛点与解决概述
1.1 共享充电场景的运维挑战
在共享充电宝柜、电动自行车充电桩、新能源汽车充电站等共享充电场景中,照明设备的电源状态监测是保障用户体验和设备安全的关键。然而,传统方案存在以下痛点:
| 痛点 | 具体表现 | 带来的问题 |
|---|---|---|
| 状态不可知 | 设备照明是否正常工作无法远程获知 | 故障发现依赖用户投诉,响应滞后 |
| 故障响应慢 | 照明故障需到场排查 | 运维成本高,影响充电站使用率 |
| 能耗无法监测 | 照明设备耗电情况未知 | 无法精准核算运营成本 |
| 缺乏联动控制 | 照明与充电业务独立运行 | 无法实现根据业务状态自动调节照明 |
1.2 解决方案:智能控制器实现电源状态监测
芯步智能控制器4路(UNI-KZQ-DC-4)是一款专门用于多路直流线路远程控制的工业级控制器,通过HTTP接口与共享充电管理软件对接,实现“实时状态查询-异常自动告警-远程通断控制”的完整监测闭环。
核心特点
4路独立控制:单台设备可控制4路直流线路,满足充电站多照明设备接入需求
状态实时可查:通过HTTP接口随时查询每路通断状态
开放HTTP API:适用于任何支持HTTP请求的编程语言,无缝接入现有充电管理软件
远程控制能力:支持远程开启/关闭单路或多路照明
本地操作支持:设备自带按键,支持现场手动操作(可配置禁用)
1.3 智能控制器4路核心参数
本方案选用芯步智能控制器4路,详细参数如下
| 参数项 | 规格详情 |
|---|---|
| 产品型号 | UNI-KZQ-DC-4(内置天线版/外置天线版) |
| 控制路数 | 4路独立控制 |
| 工作电压 | AC 85-265V(交流/市电) |
| 额定电流 | MAX 10A / 路 |
| 单路负载功率 | MAX 1000W / 路(阻性负载) |
| 总负载功率 | 总负载不得超过2500W |
| LED/节能灯负载 | 应小于300W / 路(感性/容性负载需降额) |
| 待机功耗 | 0.4W(全断) - 1W(全通/无负载) |
| 无线连接 | WiFi IEEE 802.11 b/g/n 2.4GHz |
| 外壳材质 | 防火V0级PC,耐高温,符合安规标准 |
| 产品尺寸 | 宽:95mm;长:90mm;厚:35mm |
| 产品净重 | 167g |
| 产品颜色 | 浅灰色 |
版本说明:提供内置天线和外置天线两个版本,外置天线版信号更强,适用于WiFi信号较弱的场景。
1.4 同一品类不同型号对比
芯步智能控制器系列包含多种规格,可根据实际需求选择
| 产品型号 | 控制路数 | 单路额定电流 | 单路阻性负载功率 | 适用场景 |
|---|---|---|---|---|
| 智能控制器4路 | 4路 | MAX 10A | MAX 1000W | 共享充电站、售货柜 |
| 智能包间控制器Mini | 4路 | MAX 10A | MAX 3500W/路 | 共享桌游室、棋牌室 |
| 智能控制器8路 | 8路 | MAX 20A | MAX 2200W | 多路照明集中控制 |
| 智能控制器16路 | 16路 | MAX 20A | MAX 2200W | 大型照明系统 |
| 智能控制器24路 | 24路 | MAX 25A | MAX 5000W | 工业级照明控制 |
第二章:照明设备接入方案
2.1 共享充电场景的照明设备类型
共享充电场景通常涉及以下几类照明设备:
| 照明设备类型 | 典型功率 | 接入 | 注意事项 |
|---|---|---|---|
| 充电柜指示灯/LED灯带 | 10-50W | 每路可接入多盏 | LED为感性负载,需降额使用 |
| 充电桩显示屏背光 | 20-100W | 独立一路控制 | 启动电流较小 |
| 充电区域照明灯 | 50-200W | 独立一路控制 | 注意功率不超1000W |
| 应急照明 | 10-30W | 独立一路控制 | 配置为常开 |
| 广告灯箱 | 100-300W | 独立一路控制 | LED灯箱需降额 |
2.2 接线方案
智能控制器4路的接线方式如下
市电输入(AC 220V)
│
┌─────────┼─────────┐
│ │ │
↓ ↓ ↓
火线L 零线N 接地PE
│ │ │
↓ ↓ ↓
┌───────────────────────────┐
│ 智能控制器4路 │
│ ┌─────────────────────┐ │
│ │ 输出1 输出2 输出3 输出4 │
│ └─────────────────────┘ │
└───────────────────────────┘
│ │ │ │
↓ ↓ ↓ ↓
照明1 照明2 照明3 照明4重要安全提示
⚠️ 接线前必须断开总闸,验电确认断电
⚠️ LED灯、节能灯等感性/容性负载,每路功率请一定要控制在300W以内
⚠️ 总负载不得超过2500W
第三章:HTTP接口协议详解
3.1 整体架构
芯步智能控制器采用标准的HTTP请求-响应模型,设备开放HTTP接口,适用于任何支持HTTP请求的编程语言,支持接入Web、APP/小程序、窗体软件、SaaS/低代码平台等任何形式的软件项目
graph LR
subgraph 软件层
A[充电管理软件/后台]
end
subgraph 网络层
B[芯步API网关
api.thingboot.com]
end
subgraph 硬件层
C[智能控制器4路]
end
A -- "HTTP POST (带签名)" --> B
B -- "MQTT透传" --> C
C -- "继电器动作" --> D[照明负载]3.2 请求地址格式
http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}URL参数说明
| 参数 | 说明 | 示例 |
|---|---|---|
{AppId} | 应用ID,在芯步控制台获取 | 10001 |
sign | 动态签名,验证请求合法性 | a1b2c3d4... |
ts | 当前Unix时间戳(秒级) | 1746000000 |
3.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]核心代码实现
3.4 控制命令集
智能控制器4路支持以下核心命令
| 命令类别 | 命令格式 | 说明 |
|---|---|---|
| 单路接通 | {"power1":"1"} | 开启第1路照明 |
| 单路断开 | {"power1":"0"} | 关闭第1路照明 |
| 状态查询 | {"get_status":""} | 查询设备状态 |
| 批量控制 | {"batch":{"relay":[1,3],"power":"1"}} | 同时开启第1、3路 |
多路独立控制
3.5 状态监测核心功能
对于电源状态监测场景,最核心的功能是查询设备状态,判断照明设备是否正常工作:
返回示例
3.6 完整请求示例
第四章:多语言代码实现
4.1 Python完整实现
4.2 Node.js实现
第五章:共享充电场景应用集成
5.1 系统集成架构
充电站照明管理系统可与充电业务系统深度集成:
graph TB
subgraph 硬件层
A[智能控制器4路]
A1[照明1-充电区A]
A2[照明2-充电区B]
A3[照明3-广告灯箱]
A4[照明4-应急照明]
end
subgraph 软件层
B[充电管理平台]
B1[充电桩管理模块]
B2[照明控制模块]
B3[状态监测模块]
B4[告警中心]
end
subgraph 用户端
C[运维APP]
D[管理后台]
end
A -->|HTTP API| B
B2 -->|控制指令| A
B3 -->|状态数据| B1
B4 -->|告警推送| C
B -->|数据展示| D5.2 第一种场景:照明设备实时状态监测
业务需求:运维人员需要远程查看各充电区域的照明设备是否正常工作。
实现逻辑
充电站管理后台定时查询设备状态
将状态数据展示在Web/移动端管理界面
异常状态自动标红告警
代码实现
5.3 第二种场景:异常自动告警
业务需求:当检测到照明设备故障或状态异常时,自动通知运维人员。
实现逻辑
定期轮询设备状态
对比预期状态与实际状态
状态不匹配时触发告警
代码实现
5.4 第三种场景:与充电业务联动控制
业务需求:根据充电站的运营状态(营业/打烊)自动控制照明。
实现逻辑
充电管理平台检测到营业时间开始/结束
自动触发照明设备的开启/关闭
同时可在高峰/低谷时段采用不同照明策略
代码实现
5.4 场景四:设备离线告警与维护
设备离线可能导致无法远程监控照明状态,因此需要及时告警
第六章:数据库设计与数据持久化
6.1 数据表设计
6.2 状态历史分析示例
第七章:故障排查与最佳实践
7.1 常见问题排查表
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 设备显示离线 | 1. 电源断开2. WiFi密码错误/信号弱3. 路由器禁用了设备MAC | 1. 检查AC 85-265V供电2. 重配网络或靠近路由器3. 检查路由器白名单 |
| 接口返回403 | 1. AppSecret错误2. 签名计算错误3. ts与服务端时间偏差>5分钟 | 1.核对AppSecret2. 确认MD5为32位小写3. 同步服务器NTP时间 |
| 状态查询返回异常 | 设备离线或网络问题 | 检查设备在线状态,确认WiFi连接 |
| 控制指令无响应 | 1. 命令格式错误2. 设备离线3. 通道号超出1-4范围 | 1. 检查JSON格式2. 确认设备在线3. 确保channel在1-4之间 |
| LED灯闪烁异常 | 感性负载功率超限 | LED灯负载需控制在300W/路以内 |
| 总功率超限跳闸 | 总负载超过2500W | 重新分配负载,确保总功率≤2500W |
7.2 负载功率注意事项
根据产品规格,负载功率需特别注意
| 负载类型 | 功率限制 | 说明 |
|---|---|---|
| 单路阻性负载 | MAX 1000W | 白炽灯、电热器等 |
| 单路LED/节能灯 | MAX 300W | 感性/容性负载需降额 |
| 总负载 | MAX 2500W | 4路总功率之和限制 |
7.3 网络部署
| 部署要点 | 推荐方案 | 说明 |
|---|---|---|
| WiFi频段 | 2.4GHz | 设备仅支持2.4GHz WiFi |
| 信号强度 | RSSI ≥ -60dBm | 确保稳定在线 |
| 天线选择 | 外置天线版 | WiFi信号较弱场景推荐 |
| 静态IP | DHCP分配固定IP | 便于网络管理 |
7.4 并发与轮询优化
第八章:总结
通过将芯步智能控制器4路接入共享充电管理软件,可以