CATALOG

芯步的AC5-10A智能通断器核心优势在于开放HTTP接口,可直接通过API调用控制,无需专属网关。下面从硬件选型、接口对接、场景联动到落地部署,给出完整方案。

1. 解决概述

在酒店客房照明控制中,传统的改造方案往往面临着布线复杂、协议封闭、需要专用网关等问题。利用芯步 AC5-10A 智能通断器,你可以通过其开放的 HTTP API 接口,绕过复杂的嵌入式开发,直接通过你的云端或本地服务器控制客房内的 220V 照明线路。

方案价值点:

  • 快速接入:无需编写设备固件,只要设备连接 WiFi,即可通过任何开发语言(Java, Python, PHP, Node.js 等)发送 HTTP 请求控制开关。

  • 高兼容性:支持 100V-250V 宽电压,10A 额定电流(最大 2000W 阻性负载),适配绝大多数的酒店天花板灯、射灯、床头灯回路

  • 支持本地化:支持私有化部署和局域网通信,即使外网断开,只要局域网通畅,依然可以控制,这符合酒店行业对稳定性的苛刻要求

  • 双向反馈:设备支持外接物理开关(如原有的墙壁复位开关),同时状态实时上报,解决了“APP 显示关但灯还亮”的同步难题

2. 硬件选型与部署

2.1 硬件:智能通断器 AC5-10A

  • 功能:控制 1 路照明线路的通断。

  • 安装位置:通常隐藏在酒店的吊顶内(吸顶灯上方)、开关底盒内(需确认空间)或强电断路器的旁边。

  • 接线说明

    • 输入端(L IN, N IN):接 220V 火线进线、零线进线。

    • 输出端(L OUT, N OUT):接灯具的火线出线、零线出线。

    • 开关接口(SW1):接传统的回弹式墙壁开关(用于本地物理控制)。

2.2 辅助硬件(可选)

  • 人体传感器:配合通断器实现“人来灯亮、人走延时熄灭”的节能场景。

  • 门磁传感器:实现“开门联动灯光亮起”的迎宾模式。

3. 技术对接:接口调用与签名机制

芯步开放平台的核心理念是 “设备即服务” 。你不需要管理 TCP 长连接,只需要调用标准的 HTTPS 接口。

3.1 准备工作

  1. 注册芯步开发者账号,获取 AppIDAppSecret

  2. 将 AC5-10A 通断器上电,通过扫码配置 WiFi(配网成功后,在控制台获取唯一标识 DeviceID)。

3.2 API 接口详情

  • 请求地址https://api.thingboot.com/{AppID}/device/control/

  • 请求方法: POST

  • 鉴权方式: URL 参数签名(Sign)。

    • ts:当前 Unix 时间戳(秒)。

    • signmd5(md5(AppSecret) + ts)

3.3 命令下发示例

假设你需要实现“退房自动断电”功能(关闭所有灯光):

  • 设备 ID1234567

  • 命令(Order){“power”: 0} (0 代表关闭,1 代表开启)

业务流程:

  1. PMS 系统触发退房事件。

  2. 你的后端服务器计算签名: sign = md5(md5(‘你的AppSecret’) . ‘当前时间戳’)

  3. 向芯步发起 POST 请求,Body 包含 {“device”: “1234567”, “order”: {“power”: 0}}

代码逻辑示意(伪代码):

3.4 状态同步与事件监听

为了保证灯光状态与实际一致,芯步支持 “消息推送” 功能

  • 配置回调 URL:在你的服务器设置一个 API 接口(例如 http://yourdomain.com/light_callback)。

  • 数据流向:当客人按下墙壁开关(SW1 接口)或通过 APP 控制时,设备会将状态上报给芯步云,芯步云会立即 POST 一个 JSON 数据包到你的服务器。

  • 作用:你可以利用这个机制更新本地数据库中的“灯状态”,或者在灯被物理开启时,自动触发其他联动(如关窗帘)。

4. 酒店场景

4.1 场景 1:插卡取电联动

痛点:传统酒店插卡取电只通断总电源,智能化程度低。实施方案将 AC5-10A 通断器安装在“受控插座”或“灯光回路”上。逻辑代码逻辑取电开关(RCU 或读卡器) 检测到有效房卡插入时,调用芯步 API:

  • 命令: {“power”: 1} 打开所有灯光回路。

  • :启动一个定时任务,5分钟后如果无人操作,自动关闭非必要照明,保留廊灯(利用 {“power”: 0})。

4.2 场景 2:睡眠模式(一键关总灯)

痛点:客人睡前要爬起来关走廊灯、床头灯等多个开关。实施方案在床头安装一个“场景开关”或“无线按钮”触发你的系统逻辑。逻辑代码逻辑当点击“睡眠”按钮:

  1. 循环调用 API,关闭客房里所有安装了 AC5-10A 的设备(卫生间灯、廊灯、射灯)。

  2. 保留夜灯回路(如果有单独通断器则设为开启,或保持关闭但通过其他传感器触发)。优势:HTTP 接口允许你同时发送多个请求(或串行发送),实现一键全关。

4.3 场景 3:退房/离房节能模式

痛点:客人退房后,服务员忘记关灯导致电力浪费。实施方案当 PMS 系统执行“CO(Check Out)”操作时,或者门磁传感器检测到客人离开房间超过 15 分钟且未返回时。逻辑代码逻辑调用 {“power”: 0} 强制切断该客房所有照明回路。注意:为了体验,在软件层面设置“维护模式”,避免客人只是去走廊吸烟就被断电。

5. 高级集成:环境联动

除了单纯的通断,芯步的方案还能实现更复杂的自动化场景。例如,利用其生态内的 人体存在传感器

  1. 部署:在卫生间安装芯步的人体存在传感器。

  2. 逻辑:传感器检测到“有人”,向你的服务器推送数据。

  3. 动作:你的服务器收到“有人”数据后,立即向 AC5-10A 发送 {“power”: 1} 开启排风扇或灯光。

  4. 延时:传感器检测到“无人”持续 5 分钟后,发送 {“power”: 0} 关闭设备。这种方案取消了传统人体开关必须“原地接线”的限制,你可以通过软件配置延时长短,非常灵活。

6. 总结

通过对接 芯步 AC5-10A,你可以将繁琐的硬件开发工作简化为纯粹的 API 调用工作。这款设备特别适合 存量酒店智能化改造 的场景:

  1. 免布线:直接串接在灯具线路上,利用原有 WiFi 网络。

  2. 全语言支持:无论你的 PMS 是用 C#, Java 还是 PHP 开发的,都能轻松对接。

  3. 性价比:相比于动辄几千元的传统客控系统,这种轻量级 API 控制方案能以极低成本实现 80% 的核心照明控制功能。

下一步,你前往芯步官网控制台,创建应用并获取虚拟设备ID,通过Postman工具测试power命令,验证响应速度(通常在100ms以内)