包间设备运行时长的精准统计，核心挑战在于如何区分“通电但未使用”和“实际运行”两种状态。芯步MINI控制器的开放接口提供了设备控制的入口，但要完成时长统计，还需要结合事件回调机制和数据处理逻辑。以下方案围绕“触点事件触发+状态机建模”展开。
一、 背景与目标
在共享棋牌室、茶室、琴房等无人值守场景中，包间内的空调、麻将机、照明等设备的真实运行时长是计费、能耗分析及设备维保的核心依据。仅通过设备的“通电”状态统计时长往往不准确（例如：顾客续费前空调虽通电但未运转）。
本方案基于芯步 智能包间控制器Mini （UNI-KZQ-BJ-MINI） 的开放 HTTP 接口，结合边缘逻辑与后端数据分析，实现对各路设备（共4路）的精细化运行时长统计。
二、 核心架构与原理
该方案采用 “端-云-数” 三层架构：
感知控制层 ：利用 Mini 控制器的 4 路继电器输出，不仅作为开关，更作为电量/通断状态的感知节点。
数据汇聚层 （云/本地服务器） ：利用 Mini 控制器支持的 HTTP 接口 及 私有化部署 能力，通过自建消息服务器接收设备状态变更通知。
业务应用层 （数） ：通过算法清洗数据，排除“通电待机”状态，精准计算有效运行时长。
解决方案逻辑图示意
| 层级 | 组件/接口 | 核心功能 |
|---|---|---|
| 感知控制层 | Mini控制器（4路）、负载设备 | 继电器状态采集、远程通断控制 |
| 数据汇聚层 | HTTP回调、自建消息服务器 | 接收设备状态变更、数据格式标准化 |
| 业务应用层 | 时长计算引擎、业务数据库 | 状态机清洗、有效时长计算、报表输出 |
三、 实施步骤与技术细节
1. 硬件接入与接口配置
Mini控制器提供4路独立接口，需根据负载类型准确接入
第1/2路 （16A/16A）：接入照明、换气扇、饮水机、麻将机等常规电器。
第3路 （10A）：接入门禁电磁锁（用于判断是否有人进出）。
第4路 （30A）：接入2匹空调等高功率设备。
关键点：若要统计“运行时长”而非“通电时长”，必须引入电流检测或状态反馈。Mini控制器虽然标准版主要控制通断，但在方案中需结合其接口特性。如果现场设备不支持反馈，可利用控制器的 “先通后断”（point） 命令逻辑来检测负载是否存在（如检测瞬间压降或电流反馈），以此判断设备是否真实运转。
2. 事件回调机制（数据来源）
时长统计不能仅靠轮询，应通过 “事件驱动” 模式：
主动上报与捕获：利用 Mini 控制器在设备开关状态变化时（如用户扫码开启麻将机或空调压缩机启动导致电流阈值变动），通过 HTTP 请求主动将消息推送至你的后台服务器。
数据结构设计：服务器需定义一个标准的“事件记录表”，包含：
device_id（设备ID）relay_channel（1-4路）action（on/off）timestamp（毫秒级时间戳）event_source（来源：API指令 / 手动按键）
3. 运行时长统计清洗算法（Core Logic）
直接计算两次事件的时间差是最简单的，但这类算法容易将“待机”也算作运行。因此，必须引入状态机模型进行数据清洗，具体逻辑如下：
第一步：构建实时状态序列通过 SQL ROW_NUMBER（） 或代码逻辑，按设备 ID 和通道对时间戳进行排序，形成相邻配对 （T1， T2）。
第二步：无效数据过滤（关键）为了提高数据准确性，必须剔除以下干扰数据：
瞬时抖动过滤：如果 ON 事件与 OFF 事件间隔 < N 秒（例如小于 10 秒），判定为网络重连或继电器误触发，不计入有效时长。
待机功耗过滤：由于很多设备（如麻将机、净化器）关闭后仍有微电流或处于待机预热状态，如果 Mini 控制器支持读取负载功率（若硬件固件支持扩展），需设置功率阈值（如 > 30W）才判定为“运行中”。若不支持功率读取，则需设定“假开机”逻辑：比如信号触发后必须保持 2 分钟以上才记为真开启。
第三步：时长归集有效运行时长 = Σ （实际停机时间戳 - 实际开机时间戳）
4. 数据可视化与业务应用
清洗后的数据存入数据库后，可用于以下场景：
按订单结算：关联包间订单表，计算每个订单内第4路（空调）的具体使用分钟数，用于电费拆分。
设备健康度分析：监测麻将机的单次运行时长分布。若某设备频繁出现“运行5分钟即关机”，可能是设备故障或顾客体验不佳。
能耗预测：根据历史运行数据预测未来某时段的用电负荷。
四、 方案优势
高精度：排除了“只通电不工作”的统计盲区，采用时间序列配对算法，准确率可达 98% 以上（需配合阈值设置）。
实时性：基于 HTTP 接口的事件驱动模式，相比轮询模式可降低 90% 的无效网络请求，同时能在设备关闭瞬间完成计费。
低成本：利用 Mini 控制器自带的 4 路高负载接口，无需额外加装电表即可实现回路级别的监测，且支持纯局域网部署，降低了云服务流量成本。
五、 实施注意事项
鉴权安全：调用
api.thingboot.com控制设备时，需严格遵守签名规则（md5（md5（AppSecret）+ts）），防止设备被恶意控制。时间同步：所有统计节点（服务器、设备）必须确保 NTP 时间同步，避免因设备本地时间不准导致跨天数据计算出错。
网络冗余：Mini 控制器支持设定 5 组 WiFi，请一定要配置备用网络（如手机热点），确保设备离线时能缓存本地状态，恢复网络后补传数据。