办公设备交流电路控制：怎样把AC4-10A智能控制器集成到自己的项目中_解决方案

CATALOG

AC4-10A采用HTTP接口直接控制，无需网关中转，支持公网和纯局域网两种模式。以下从硬件选型、电气接线、接口调用到代码实战，梳理完整的集成路径。

在开始集成前，首先要明确硬件的能力边界。

核心功能：AC4-10A是一款WiFi智能通断器，本质是一个单路继电器。它通过HTTP API接口接收指令，控制交流电路的通断。
电气参数（关键） ：
- 负载能力：额定电流10A，阻性负载（如照明、热水壶）可达2200W，感性负载（如电机、投影仪升降架）不超过300W。
- 工作电压：AC 85V-265V (全球宽电压)。
- 无线协议：仅支持 2.4G WiFi (不支持5G频段)。
接口优势：物理尺寸为37mm x 74.3mm x 23.5mm，体积较小，理论上可以塞入标准的86型暗盒或设备控制柜内。

这是物理集成的第一步，涉及强电操作，由持证电工在断电状态下进行。

输入输出逻辑：设备具备“输入”和“输出”两端。将220V火线接入输入端，输出端串联至办公设备的火线回路中。零线需直接并联跨过设备。
场景应用
- 方案A（单机控制）：用于控制大功率投影幕布、展厅灯带。将设备串联进幕布控制箱的火线，保留原有的手动开关（并联）作为备用。
- 方案B（电路联动）：用于控制会议室打印机、饮水机。在配电箱内将该设备串联至对应空开的出线端。
注意事项：由于设备仅有10A额定电流，若需控制大功率空调或整排工位插座，请选择20A或30A版本的姊妹型号。

芯步的方案支持两种集成模式，需根据项目场景选择：

模式一：SaaS公网模式（适合分布式/远程控制）
- 设备通过WiFi连接互联网。
- 你的业务服务器通过调用芯步的云端API (api.thingboot.com) 下发指令。
- 优点：支持手机App远程控制，不受距离限制。
模式二：局域网直连模式（适合高安全/内网环境）
- 前提：芯步支持私有化部署。设备虽然通过WiFi连接路由器，但指令可以不经过芯步公网，而是直接在内网传输。
- 实现：如果你的项目服务器在内网，可以直接通过HTTP POST 请求向设备的局域网IP发送指令（需查阅设备的局域网API文档，通常基于透传），或者设备连接内网的MQTT Broker。
- 优点：极低延迟、断外网仍可用、数据不流出企业。

这是将该硬件融入你自有系统的关键。无论使用哪种语言，本质都是构造HTTPS请求。

（1）接口基础信息

URIhttps://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}
Method：POST
HeaderContent-Type: application/x-www-form-urlencoded
鉴权机制sign 和 ts（时间戳）是动态生成的，通常由注册后获取的 AppKey 和 AppSecret 通过MD5/SHA256算法生成，用于防止接口被恶意篡改。

（2）命令字协议 (Order JSON)这是控制逻辑的核心。对于办公设备，主要关注 power 指令：

（3）多语言集成示例假设你需要关闭设备ID为 DEV_001 的打印机电源。

将API集成到项目中后，可以实现以下 “交流电路控制” 的典型办公逻辑：

第一种场景：人体感应联动（节能）
- 你的系统定时读取会议室的人体传感器（可能是另一个传感器或API）。
- 逻辑：若会议室无人 && 时间 > 30分钟 && 设备功率 > 5W -> 调用 {"power":"0"} 切断会议平板和空调电源。
第二种场景：设备健康度监测（虽无计量版功能，但有变通方案）
- 标准版AC4-10A不具备计量功能。如果需要检测设备是否真的坏了（例如：下达了开机指令，但电流为0），选用 AC4-10A计量版。此版本支持通过接口读取实时电压/电流数据，可用于判断投影机灯泡是否真的点亮、打印机是否卡纸（通过电流波动分析）。
第三种场景：紧急熔断与恢复
- 在OA系统或工单系统中增加“一键断电”按钮。当发生短路或异味时，管理员触发后端API，切断整层楼的接入设备。

将 AC4-10A 集成到你的项目中，本质上是一次 协议对接 与 电气改造 的结合。

开发友好度：比较高。只要你的项目环境能跑通HTTP请求（无论是C#、Java、PHP还是Node.js），即可集成，无需学习复杂的MQTT协议。
电气安全：请一定要确认办公设备功率不超过2200W。对于服务器机房等关键设备，谨慎使用，因为WiFi稳定性受环境干扰可能会有毫秒级的延迟。
部署：如果项目预算允许且对隐私要求高，采购时咨询芯步关于 “私有化部署” 的授权，将数据流锁定在企业内网，这样即使公司断外网，内部的“下班断电”逻辑依然生效。