CATALOG

芯步AC1智能通断器通过开放的HTTP API接口,可以方便地集成到图书馆阅览室的电源管理系统中。以下方案涵盖设备选型、接口接入流程、核心功能实现逻辑以及状态同步机制。

解决方案:基于芯步AC1智能通断器的图书馆阅览室电源管理系统集成

1. 背景与需求分析

在图书馆阅览室管理中,占座行为和用电浪费(如无人时灯光、插座通电)是常见痛点。

  • 需求:管理员需要远程批量控制某区域插座断电,或通过软件实现“入座供电、离座断电”。

  • 设备选型芯步AC1-10A智能通断器

    • 适配性:10A额定电流,2200W功率,完全满足阅览室单个工位(电脑、台灯、充电器)的负载需求

    • 通信方式:直连WiFi 2.4G,无需额外网关,部署成本低

    • 接口开放度:提供标准的HTTP API,支持任何主流后端语言(Java, Python, PHP, Node.js等)调用

2. 系统架构拓扑

本方案采用 “设备端 — 云平台 — 业务系统” 的三层架构:

  1. 感知/执行层:AC1通断器接入阅览室插座线路,通过WiFi连接互联网。

  2. API接入层:芯步开放平台。业务系统不直接穿透内网,而是通过调用平台API下发指令,平台同时通过回调机制推送设备状态。

  3. 业务应用层:图书馆现有的座位管理系统、微信小程序或后台管理软件。

3. 接入软件项目的核心流程

要将AC1集成到软件中,需依次完成以下三个技术步骤,其中API签名算法是接入的关键。

第一步:获取凭证与设备ID在芯步控制台获取以下三个核心要素:

  • AppID:标识你的应用。

  • AppSecret:接口通信的加密密钥(严禁硬编码在前端)。

  • Device ID:现场安装的AC1通断器唯一标识。

第二步:实现签名算法为了防止接口被恶意篡改,每次请求必须携带动态签名 sign。算法逻辑如下(兼容所有后端语言):

  1. AppSecret 进行第一次MD5加密:secret_md5 = md5(AppSecret)

  2. 获取当前Unix时间戳(秒级):ts

  3. 拼接字符串并再次MD5:sign = md5(secret_md5 + ts)

  4. 最终请求URL为:https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

注:时间戳ts必须与签名计算时使用的严格一致,服务器会校验收发时间差以防重放攻击。

第三步:编写控制逻辑(以Python/Java伪代码为例)在业务代码中,封装一个控制设备通断的函数:

4. 业务场景功能实现

4.1 远程批量控制与定时任务
  • 场景:每晚22:00图书馆闭馆后,自动切断所有阅览座位的电源。

  • 实现方案

    • 在芯步控制台预设定时任务(简单场景)。

    • 或在业务系统数据库中维护设备ID列表,利用系统的定时任务(如Quartz)遍历调用上述 control_ac1_power(device_id, 0) 接口,实现批量断电。

4.2 联动座位管理系统(核心场景)

通过将AC1设备的power状态与座位的“占用”逻辑绑定,实现物理断电防占座:

  • 入座流程:用户刷码或刷卡选座 -> 系统判定选座成功 -> 自动调用接口 将该座位对应的AC1设备 power 置为 1(通电) -> 插座供电,用户可正常使用。

  • 离座流程:用户点击“退座” -> 系统判定释放 -> 自动调用接口 将该座位AC1设备 power 置为 0(断电) -> 插座断电,笔记本电脑充电口、台灯等全部失效,有效防止资源浪费。

5. 状态同步机制

为了保证软件界面上显示的开关状态与设备真实状态一致,利用状态回调机制

AC1支持状态变化主动推送(Webhook)。如果用户手动按下了AC1设备上的物理按键,设备状态改变了,但软件系统不知道,就会出现状态不同步。

  • 配置回调URL:在芯步控制台设置一个接口地址(如 http://yourdomain.com/api/device/callback )。

  • 处理回调:当设备状态变化时,芯步平台会向该地址发送JSON数据。业务系统接收到数据后,更新数据库中对应的座位状态。这样,无论用户是通过APP关电还是手动按按钮关电,图书馆大屏上的座位图都能实时同步为“空闲”。

6. 部署和需要注意的点

  1. 网络要求:AC1仅支持2.4G WiFi,部署时需确保阅览室信号覆盖

  2. 数据安全

    • AppSecret隔离:签名计算必须在后端(Server端)完成,前端(Web/小程序)只能请求后端接口,严禁在前端代码中暴露AppSecret。

    • HTTPS:生产环境请一定要使用HTTPS协议调用 api.thingboot.com

  3. 负载功率限制:单路最大2200W。一般阅览室插座接1台笔记本电脑(约150W)+ 1部手机充电(20W)完全足够。若需接大功率设备,请选用16A规格的设备。

通过以上方案,开发者无需关注底层硬件通信细节,只需利用AC1标准的HTTP接口,即可在现有图书馆软件系统中快速落地“按需供电、远程管控”的智能化电源管理功能。