CATALOG

[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 10AMAX 1000W共享充电站、售货柜
智能包间控制器Mini4路MAX 10AMAX 3500W/路共享桌游室、棋牌室
智能控制器8路8路MAX 20AMAX 2200W多路照明集中控制
智能控制器16路16路MAX 20AMAX 2200W大型照明系统
智能控制器24路24路MAX 25AMAX 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 -->|数据展示| D

5.2 第一种场景:照明设备实时状态监测

业务需求:运维人员需要远程查看各充电区域的照明设备是否正常工作。

实现逻辑

  1. 充电站管理后台定时查询设备状态

  2. 将状态数据展示在Web/移动端管理界面

  3. 异常状态自动标红告警

代码实现

5.3 第二种场景:异常自动告警

业务需求:当检测到照明设备故障或状态异常时,自动通知运维人员。

实现逻辑

  1. 定期轮询设备状态

  2. 对比预期状态与实际状态

  3. 状态不匹配时触发告警

代码实现

5.4 第三种场景:与充电业务联动控制

业务需求:根据充电站的运营状态(营业/打烊)自动控制照明。

实现逻辑

  1. 充电管理平台检测到营业时间开始/结束

  2. 自动触发照明设备的开启/关闭

  3. 同时可在高峰/低谷时段采用不同照明策略

代码实现

5.4 场景四:设备离线告警与维护

设备离线可能导致无法远程监控照明状态,因此需要及时告警

第六章:数据库设计与数据持久化

6.1 数据表设计

6.2 状态历史分析示例

第七章:故障排查与最佳实践

7.1 常见问题排查表

现象可能原因解决方案
设备显示离线1. 电源断开2. WiFi密码错误/信号弱3. 路由器禁用了设备MAC1. 检查AC 85-265V供电2. 重配网络或靠近路由器3. 检查路由器白名单
接口返回4031. 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 2500W4路总功率之和限制

7.3 网络部署

部署要点推荐方案说明
WiFi频段2.4GHz设备仅支持2.4GHz WiFi
信号强度RSSI ≥ -60dBm确保稳定在线
天线选择外置天线版WiFi信号较弱场景推荐
静态IPDHCP分配固定IP便于网络管理

7.4 并发与轮询优化

第八章:总结

通过将芯步智能控制器4路接入共享充电管理软件,可以

控制器产品方案:
怎样接入4路智能直流开关以实现多设备联动控制
查看 >>
怎么二次开发智能 24 路分体远程信号控制器来实现设备运行状态监控
查看 >>
怎么在店铺设备电源控制中集成智能硬件以实现8 路多通道独立控制
查看 >>
如何在共享自习室独立包间控制中对接智能设备来实现包间智能语音联动控制
查看 >>
怎么接入智能 24 路远程开关控制模块以实现自定义场景联动控制
查看 >>
共享充电场景方案:
如何在共享充电桩机柜电源控制中集成智能设备来实现过流过载保护控制
查看 >>
怎么在共享充电宝柜电路管理中集成智能硬件以实现额定功率负载控制
查看 >>
共享充电宝柜电源管理:怎样将40A智能空开集成到自己的项目中
查看 >>
共享充电桩机柜电源控制:怎么将8位机柜总控PDU接入到软件项目中
查看 >>
共享充电宝电路保护:怎么把50A导轨式数显断路器集成到自己的项目中
查看 >>
照明设备用途方案:
怎样在共享茶室照明控制中集成智能硬件来实现远程控制8路照明设备通断
查看 >>
怎么在无人售货机灯光控制中集成智能硬件来实现12路照明设备电源状态监测
查看 >>
怎么二次开发3路智能墙壁触摸控制开关来实现定时开关照明设备
查看 >>
如何在智能办公中对接智能硬件来实现单路照明设备控制
查看 >>
怎样对接4 路智能远程照明控制器来实现4路照明设备电源状态监测
查看 >>