CATALOG

共享自习室的核心运营痛点在于电费核算与电源管理——用户按小时预约座位,对应的电源需在预约时段内供电,同时精确计量每个座位的用电量。芯步的50A带计量智能电源控制断路器正好解决这个问题,其开放的HTTP API接口可让您无缝对接现有的预约系统。以下是完整的对接方案。

共享自习室电源控制对接方案:基于芯步50A智能断路器

1. 概述与设计

在共享自习室场景中,每个座位对应一个电源插座。通过集成芯步50A带计量智能电源控制断路器,您可以实现“预约即通电、超时即断电、用完即计费”的全自动化管理。

核心架构包含三个层面:

  • 感知/执行层:安装在每个座位的50A智能断路器。它负责实时采集电压、电流、功率、能耗数据,并执行通断电指令

  • 云平台层:芯步IoT平台。负责处理设备数据转发、指令签名验证和设备状态维护。

  • 应用层:您的自习室管理系统(小程序/Web后台)。通过调用芯步的开放HTTP接口,实现业务逻辑与硬件的联动。

2. 对接前的准备工作

在编写代码之前,需要进行物理与逻辑层面的配置:

设备选型确认

  • 确认申购的是带计量功能的50A规格断路器,以适应自习室多设备同时运行的负载。

  • 确认设备支持HTTP远程分合闸控制

环境与权限配置

  1. 注册与创建应用:登录芯步官网,在“物联网控制台”中创建一个新项目(如“XX自习室电源控制”)。系统将生成唯一的 AppIDAppSecret,这是后续API调用的密钥

  2. 设备配网

    • 使用“芯步”小程序或控制台,将断路器连接到现场2.4G Wi-Fi。

    • 关键步骤:控制台会生成一个临时的热点名称和密码,手机连接该热点后,设备会自动捕获并配置Wi-Fi信息

  3. 获取设备ID:配网成功后,在控制台设备列表中找到对应设备,复制其唯一的 Device ID(如 820720

3. 核心接口对接实践

芯步的接口设计遵循简单的请求-响应模式,无需复杂的SDK,任何支持HTTP的语言均可调用。

1. 签名生成规则所有接口请求都需要携带签名(sign)和时间戳(ts)以保证安全性。签名算法如下

2. 控制插座通断(开/关)这是使用最频繁的接口,用于用户扫码开座或时间到自动断电。

  • 请求地址POST http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

  • 请求体(JSON)

  • 业务逻辑映射:当用户在小程序端点击“开始学习”并支付成功后,系统立即向该设备的 power 字段发送 1;点击“结束学习”或系统检测到余额不足时,发送 0

3. 获取实时用电数据(计量功能)用于计算用户实际电费或监测大功率违规电器。

  • 芯步支持数据的主动上报。您需要先在控制台设置好数据回调URL(Webhook)。

  • 数据格式:当设备电量变化时,平台会主动向您的服务器推送JSON数据,包含 voltage(电压)、current(电流)、power(功率)和 energy(累计电能)。

  • 应用场景:后端接收数据后,每隔10分钟计算一次该座位的耗电量,并实时展示在小程序界面上(“今日已用0.5度电”)。如果检测到瞬时功率超过500W(如使用取暖器),可触发接口立即断电

4. 定时任务与延时断开自习室常有时长预约需求,可利用接口参数实现延时,无需在您的服务器上维护复杂的定时队列。

  • 用法:在 order 中传入 reset 参数。

  • 示例:用户预约了2小时。

通过这条指令,设备内部芯片会进行计时,2小时后自动跳闸,即使服务器宕机也不影响断电逻辑

4. 针对50A大功率场景的特殊配置

由于自习室总负载可能较高,50A断路器通常用于总闸或多座位并联线路,需注意:

  • 过载保护阈值:通过接口设置断路器的额定电流阈值。例如,若一根线路拖动了10个座位,可将电流上限设为 45A,超过则自动跳闸并上报“过载告警”,防止火灾隐患

  • 漏电自检:对于潮湿区域的插座,可开启定时自检功能,确保漏保功能有效

5. 系统集成与排障

  • 私有化部署(可选) :若您的自习室局域网环境稳定且对公网依赖性要求低,芯步设备支持局域网LAN口API调用,可不经过公网云平台直接在本地服务器下发指令,响应可低至10ms以内

  • 断网重连机制:设备内置了断电记忆功能。若路由器重启或断网,设备会保持断电前的状态(如保持通电),待网络恢复后自动重联,不会导致自习室突然摸黑。

  • 签名错误排查:若返回签名错误,请核对 AppSecret 是否经过两次MD5加密,且时间戳 ts 是否为秒级(10位),而非毫秒级(13位)。

通过以上对接,您将拥有一个完全自动化、数据化的共享自习室电源管理系统。用户侧体现为“入座自动通电/离座断电”,管理层则体现为清晰的“每一度电的收益报表”。