芯步的3路智能墙壁开关支持HTTP直连和局域网控制，无需网关即可对接酒店现有PMS系统。以下是基于其开放接口的具体对接方案。
1. 背景与选型分析
在酒店客房智能化改造中，墙壁开关的更换往往是施工最繁琐、对客服务影响最大的环节。传统改造方案通常需要重新布线或更换为485协议的客控主机（RCU），不仅需要专业电工长时间作业，还可能破坏墙面装修。
芯步的 UNI-KG-3 3路智能墙壁开关 采用 标准86型 设计，可直接平行替换原有墙壁开关，无需重新凿墙或更换底盒，施工简单快捷。其核心优势在于支持 HTTP 协议，可直接接入局域网，无需专用网关，这对于酒店IT部门来说意味着极低的运维复杂度和成本。
为何选择该开关：
零布线改造：直接替换传统开关，利用现有强电线（火零线），无需布设弱电控制线。
开源协议：芯步开放完整的HTTP API接口，且支持私有化部署，酒店数据留在本地服务器，保障住客隐私与数据安全。
独立控制：单设备支持3路物理控制，可分别控制射灯、灯带、主灯等不同照明回路。
状态保持机制：独有的“状态保持”和“先通后断”指令，非常适合酒店场景（如：客人离开后，保洁未到时，通过系统锁定开关状态；或控制门铃/勿扰指示灯的短暂触发）。
2. 系统设计
本次改造不依赖云端，采用 “端-边-云/本地” 混合架构，以确保客房控制的高实时性和断网可用性。
2.1 拓扑结构
设备层：部署 UNI-KG-3 开关，连接 WiFi 2.4GHz 网络。
传输层：利用酒店现有 WiFi 信号覆盖，设备直接连接至客房 AP 或走廊 AP。
应用层：酒店本地服务器或 PMS 系统接管。
2.2 核心逻辑流程图
场景：客人插入取电卡 -> 灯光自动亮起 -> 空调启动
取电：插卡取电开关（第三方）发送信号至酒店 PMS。
触发：PMS 或中间件收到信号，识别房间号。
指令：服务器调用芯步 HTTP 接口。
执行：开关接收命令，闭合第1路继电器（如廊灯/总控）。
3. 接口对接详细说明
开发者需参考芯步开放平台机制，通过编程调用接口控制开关。
3.1 准备工作：签名计算
芯步的接口采用动态 MD5 签名机制，这是对接的第一步。调用任何接口前，必须生成 sign。
AppId / AppSecret：在开发者后台获取。
ts：当前 Unix 时间戳（秒）。
计算公式
Sign = md5( md5(AppSecret) + ts )
3.2 核心接口实战：控制3路开关
请求地址（支持局域网或公网）：https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
针对 UNI-KG-3 型号，通过 order 参数下发 JSON 指令
| 功能描述 | JSON 指令 (order 字段) | 适用场景 |
|---|---|---|
| 开启第1路 | {"power1":1} | 控制射灯/主灯 |
| 关闭第2路 | {"power2":0} | 控制灯带 |
| 点动/门铃 (第3路) | {"point3":1} | 先通后断，适合门铃或短暂提醒 |
| 状态锁定 (第1路) | {"power1":2, "time1":60} | 保洁模式：锁定开启状态60秒 |
| 全开/全关 | {"power1":1,"power2":1,"power3":1} | 欢迎/离家模式 |
重点说明：若需对接酒店 PMS 的“退房待清洁”或“勿扰”指示灯，但该开关控制的是照明线路，通常在强电回路中接入一个 220V 指示灯即可实现状态反馈。
3.3 对接 PMS 实现联动 (示例伪代码)
软件开发人员需在酒店本地服务器中编写逻辑模块。以下为控制客房的逻辑示例：
4. 酒店场景实施步骤
4.1 硬件配置
安装：断电后拆下旧开关，接上 UNI-KG-3。
注意：确认零线（N）接入。传统开关如果是单火线，需检查底盒是否有零线；若无，在灯头处并联芯步提供的电容以取电。
配网：长按开关按键进入配网模式。使用芯步物控 APP 或通过 HTTP 接口下发 WiFi 配网信息（SSID & Password）。
：为酒店 IoT 设备划分独立的 2.4G WiFi SSID，关闭“双频合一”以避免干扰。
4.2 软件开发与集成
设备注册：安装完成后，通过接口
device/list获取该房间新装开关的唯一 Device ID，并在酒店管理系统中绑定房间号。本地化部署：鉴于酒店客房控制对实时性要求高，且网络波动可能导致客诉，强烈部署 “芯步私有化服务” 或 “本地自建HTTP中转服务” 。确保当外网断开时，前台本地服务器仍能控制客房灯光。
5. 典型场景控制逻辑
| 触发事件 | 执行动作 (UNI-KG-3 响应) | 业务价值 |
|---|---|---|
| 前台办理入住/插卡取电 | 开启第1路 (廊灯)，第2路延时2秒开启 (氛围灯)。 | 避免突然全亮刺眼，制造温馨氛围。 |
| 客人按下“睡眠总控” | 全部回路关闭 (power1=0, power2=0, power3=0)。 | 无需起身关灯，提升体验。 |
| 退房/离店 | 系统检测到退房，下发全关指令。 | 节能，防止长明灯。 |
| 保洁/维修模式 | 下发 {"power2":2, "time2":1800} (锁定第2路开启30分钟)。 | 保洁阿姨进入房间后保证灯光不灭。 |
6. 关键注意事项
负载兼容性：UNI-KG-3 每路最大支持 1200W，但如果是 LED 节能灯，单路负载需控制在 300W 以内，否则可能因启动容性负载太大导致开关损坏或闪烁。改造时需统计每路灯具总功率。
断电记忆：该开关具备断电记忆功能。酒店一旦停电后再来电，开关会恢复到断电前的状态。开发者需根据酒店政策，考虑是否在 PMS 中配置“上电默认状态”以防止半夜来电全屋亮灯惊扰客人。
干接点转换：如果酒店大堂或走廊需要连接传统的物理门磁或紧急按钮，UNI-KG-3 主要控制强电，需配合芯步的 IO 模块 或 传感器 来采集干接点信号，再通过逻辑控制该开关。