CATALOG

针对校园场景中空调、热水器、机房设备等高功率电器的用电管理与节能需求,结合芯步产品的开放API能力,以下提供技术接入方案。

本方案的核心思路是:物理线路承载电力(强电),云端API传输信号(弱电),业务系统实现逻辑(策略)。

一、 硬件的“连接”与“界定”

在校园项目中,首先要明确计量版60A的安装位置与电气边界。

1. 安装拓扑

  • 位置界定:将该设备安装在校园宿舍楼层总配电箱、食堂大功率厨具专线、实验室机房或教学楼中央空调末端,以此作为节点的分路计量控制点。

  • 接线规则

    • 进线端:将原回路中的火线断开,进线接入断路器的“进线端”。

    • 出线端:出线端接至负载设备(如10台空调外机、1台热水器)。

    • 零线:必须零线跳线接入设备内部的计量模块,否则无法采集电压/电流数据。

  • 负载核算:60A @ 220V 约支持 13.2kW 纯阻性负载。对于电机、空调这类感性负载,实际带载能力约为 7-8kW(需预留3-5倍启动电流余量)。

2. 注重点:电气安全

  • 绝缘监测:接入前需遥测线路绝缘,防止因线路老化漏电导致设备误动作或损坏。

  • 互感器方向:若采用外置开口互感器,注意“P1(进)”面朝向电源侧,否则采集到的功率为负值。

二、 API接口对接模型设计

芯步的设备通常采用 SaaS API + MQTT 推送 的双通道模式。针对校园高并发场景(如全校统一熄灯),采用异步非阻塞架构。

1. 核心接口定义根据其通用接口规范(参考其8路控制器逻辑),对接实例如下:

  • 鉴权Authorization: Bearer {token}(从管理后台获取企业Key/Secret)。

  • 获取设备状态

    • Method: GET

    • Endpoint: /v1/devices/{device_id}/power_metrics

    • Response: { "voltage": 218.5, "current": 32.2, "power": 7100, "energy": 123.45 }

    • 作用:用于监控当前实时负载,判断设备是否过载或空载(判断是否无人使用待关机)。

  • 断路器控制

    • Method: POST

    • Endpoint: /v1/devices/{device_id}/control

    • Body: { "cmd": "trip" } (分闸/跳闸) 或 { "cmd": "close" } (合闸/送电)。

    • 特色功能:支持“强制合闸”与“普通合闸”参数,用于紧急状态下的远程恢复。

2. 数据流闭环

sequenceDiagram
    participant 校园App/后台
    participant 芯步云API
    participant 4G/5G网关
    participant 60A断路器

    校园App/后台->>芯步云API: POST /control (合闸指令)
    芯步云API-->>校园App/后台: 返回 command_id (指令已接收)
    芯步云API->>4G/5G网关: MQTT推送 (Publish)
    4G/5G网关->>60A断路器: 485/干接点触发 (合闸)
    60A断路器-->>4G/5G网关: 返回执行结果 (触点已吸合)
    4G/5G网关->>芯步云API: 上报最新状态 (State=ON)
    芯步云API-->>校园App/后台: Webhook回调 或 状态轮询更新

三、 校园业务场景(演示案例)

假设项目需求:“某大学研究生宿舍楼,夜间23:00后自动关闭空调插座电源,早晨6:00恢复,且当室内有人时允许临时申请长时通电。”

1. 策略配置开发

  • 定时任务(通过API创建):

    • 23:00:00:调用 /control 发送 trip(分闸)。

    • 06:00:00:调用 /control 发送 close(合闸)。

  • 联动逻辑开发

    • 编写一个Python或Node.js微服务,监听该断路器的 current 实时数据。

    • 空载检测:若电流为0且断路器处于合闸状态,判定为“负载异常脱落”或“设备未关但人已走”,后台记录告警并自动分闸以节能。

    • 过载阈值:若电流 > 55A 持续超过3分钟,调用API执行“过载保护性分闸”,并向学工系统发送通知。

2. 前端交互反馈在校园一卡通界面或微信小程序中:

  • 充电按钮:学生点击“临时通电1小时”。

  • 后端处理:接收请求 -> 校验权限(余额/时间段)-> 调用 /v1/devices/.../timer 接口设置“延时自锁”。

    • 指令示例{ "action": "close", "duration": 3600, "force": false }(合闸,1小时后自动断开,不覆盖强制节能策略)。

四、 集成过程中的关键难点与对策

1. 计量数据的实时性与延迟

  • 痛点:校园网不稳定,Wi-Fi信号弱时数据上报延迟(如秒级延迟)。

  • 对策:应开启边缘计算模式。即在校内服务器部署本地网关软件,利用芯步开放的基于TCP/UDP的局域网发现协议,使断路器数据直接发送到校内机房,而非绕行外网。这样即使用户量大时,也能保证控制的确定性在毫秒级。

2. 设备影子与状态同步

  • 痛点:手动按动断路器上的物理按钮,或者发生意外脱扣时,APP显示状态可能不同步。

  • 对策建立双向心跳机制

    • 别只依赖API查询,应在云端开启设备事件上报订阅。

    • 当设备状态变化(哪怕是被人手动按下),设备会向芯步云推送事件,芯步云应配置 Webhook 实时推送到校园业务系统,实现状态秒级同步。

3. 计量精度校正

  • 痛点:60A用于小功率负载(如单台电脑 < 0.5A)时,计量误差可能较大。

  • 对策:在代码逻辑中设置死区值。定义 if current < 0.5A: current = 0,避免空载状态下依然显示微小功耗导致的统计报表失真。

五、 总结方案架构图(文字版)

  1. 感知层:60A智能大功率断路器(采集电流、电压、功率、电能),替换传统空气开关。

  2. 网络层:利用校园已有Wi-Fi或LoRa网关,通过标准MQTT协议将数据上报至芯步开放平台。

  3. 平台层

    • 芯步云:负责设备连接管理、指令下发。

    • 校园私有云:通过调用芯步RESTful API,拉取设备列表、下发控制指令、接收事件回调。

  4. 应用层

    • 节能系统:自动根据课表/作息断送电。

    • 收费系统:基于API返回的电能数据(kWh)进行预付费扣费。

    • 安保系统:检测到异常电流波动(如宿舍违规使用大功率电器导致电流突变),API主动切断并锁定设备。

实施

第一步先做设备影子映射,即编写一个脚本循环调用 查询功率 API 并打印到控制台;第二步才是开发 Control 接口。作为解决方案,请一定要保留本地应急物理手柄,避免校园断网时完全无法恢复供电,引发管理纠纷。