包间设备能耗分析的难点在于：空调、麻将机、照明等设备功率差距大（从10A到30A），且用电行为分散。这篇方案以芯步MINI控制器的4路独立接口为基础，说明如何通过API采集状态数据并落地到实际分析场景中。
1. 背景与目标
在棋牌室、茶室、剧本杀馆等共享经济场景中，包间内的电费支出往往是运营成本的重要组成部分。传统的管理方式无法区分空调、麻将机、照明等具体设备的用电情况，导致无法精准核算单包间成本或识别设备空转浪费。
本方案的目标是利用芯步4路智能包间控制器MINI的开放HTTP API接口，通过二次开发，实现对包间内4路关键设备（空调、麻将机/饮水机、照明、门锁）的独立能耗数据采集、状态监测与可视化分析。
2. 硬件选型与部署
本方案硬件为芯步 UNI-KZQ-BJ-MINI（含TTS语音版可选）。
2.1 设备带载分配策略
为了精准分析“哪类设备最耗电”，将包间内的电器按下表接入控制器的4路输出：
| 线路通道 | 额定负载 | 接入设备 | 数据分析目标 |
|---|---|---|---|
| 第1路 | 16A / 3500W | 照明、换气扇、吸烟灯 | 分析营业时长与基础照明能耗的关系 |
| 第2路 | 16A / 3500W | 麻将机、饮水机、电视 | 分析娱乐设备的使用频率与空闲时段待机能耗 |
| 第3路 | 10A / 2200W | 门禁电磁锁 | 记录门锁状态，用于判断包间使用率（非能耗） |
| 第4路 | 30A / 6600W | 2匹空调 | 核心分析项：分析空调用电占比及预冷浪费情况 |
2.2 网络与部署架构
网络连接：设备支持WiFi 2.4GHz，无需网关。需确保包间内WiFi信号覆盖，每个控制器拥有唯一Device ID。
供电：DC 5V1A供电，可隐蔽安装于天花板检修口或设备柜内。
3. 开放接口集成方案
芯步提供了标准的HTTP API，支持公网、局域网及私有化部署。开发者可通过任何支持HTTP请求的语言（Java, Python, PHP, Node.js等）对接。
3.1 接口鉴权与请求流程
API核心地址为：https://api.thingboot.com/{AppId}/device/control/
签名算法（必选）为了安全性，每次请求需携带签名。算法规则为：Sign = md5( md5(AppSecret) + ts )。
AppSecret：开发者密钥（需在后台获取）。ts：当前Unix时间戳（秒）。
3.2 关键命令下发（控制与查询）
由于本方案重点是“能耗数据分析”，核心操作是查询设备当前状态及读取历史功耗。
3.2.1 查询实时状态
通过接口获取每一路的当前开关状态（0表示关，1表示开）。这是计算瞬时功率的基础。
3.2.2 控制策略下发
结合算法得出结论后，实现远程节能控制（如：人走自动断电）。
3.2.3 接收设备上报数据
设备状态变化时，芯步平台支持向开发者配置的服务器地址推送消息。将此作为主要数据采集方式，避免轮询造成的API压力。
4. 能耗数据分析模型
本方案的核心是数据分析层。由于控制器直接输出开关量，要分析“能耗”，需结合时间维度与设备额定功率模型。
4.1 数据采集表设计
在业务数据库中建立如下表存储原始数据：
记录字段
device_id,relay_channel(1-4路),status(0/1),duration_seconds(持续时长),create_time。采集频率：状态变化时实时记录；若无变化，每5分钟心跳记录一次。
4.2 核心分析指标计算
基于开关状态的时间累积，可以计算出理论能耗。
公式单路能耗 (kWh) = (设备运行时长 / 60) * (设备功率 / 1000)
4.2.1 单包间电费明细报表
场景：顾客退单后，系统自动拉取本次订单时间内各路设备的用电时长和估算电费。
数据支撑：第4路空调如果运行了3小时（假设空调功率2000W），则电费约为 3h * 2kW * 1.2元/度 = 7.2元。
价值：向B端商户展示精细化成本核算，或向C端用户收取合理的电费附加费。
4.2.2 空置率与待机能耗分析
场景：分析凌晨0点至6点包间无订单时，第2路麻将机或第1路排风扇是否仍在通电。
结论输出：如果大量包间存在夜间待机现象，系统可通过API自动下发
{"power":0}指令，实现“人走电断”，预计可节省5%-10%的待机电费。
4.2.3 设备健康度预警
如果第4路空调持续高负载运行时间过长（超过阈值），结合控制器温度数据（如果API返回），判断是否存在散热不良或设备老化导致的能效比下降。
5. 落地实施流程
第一步：环境配置（1小时）
在芯步开发者后台创建应用，获取
AppID和AppSecret。将MINI控制器通电，通过配网模式将其连接至包间WiFi。
在后台将设备绑定至该应用下，获取
Device ID。
第二步：软件开发对接（3-5天）
鉴权模块：实现MD5签名生成函数。
控制服务：编写设备状态查询及开关控制的微服务。
数据汇聚：配置消息接收接口（Callback URL），接收设备状态变更的实时推送。
前端看板：开发简单的管理后台，展示包间实时状态及历史能耗曲线。
第三步：策略优化（持续）
A/B测试：对比未改造包间与改造包间的月度电费单，验证节能策略有效性。
联动逻辑：结合TTS语音播报（如：“您的订单即将结束，空调即将关闭，请及时离开”），提升用户体验，避免差评。
6. 总结
高精度负载匹配：第4路支持6600W大功率，完美覆盖商业空调，避免了普通智能插座过载烧毁的风险。
架构轻量：直连WiFi，无需额外网关，降低了IoT硬件投入成本。
数据私有化：支持局域网API调用，数据不经过芯步公有云（可私有化部署），保障商户核心经营数据隐私。
通过以上方案，集成商或商户可以快速将普通的电气线路升级为具备边缘计算能力的能耗感知节点，从而实现共享包间电费的精细化管理与节能降耗。