芯步的智能墙壁电源插座支持HTTP接口直接控制，响应延迟约80-120ms，非常适合客房场景化控制的快速联动需求。以下方案以“1路智能墙壁电源插座”为执行终端，说明如何通过接口对接实现欢迎、睡眠、离店等场景控制。

主题：如何对接1路墙壁智能电源开关实现客房场景化控制

1. 概述

本方案的目标是通过对接芯步的 1路智能墙壁电源插座（86型），利用其开放的HTTP接口，将客房内单一的受控电器（如落地灯、台灯、窗帘电机、新风系统等）无缝接入酒店的智能管理系统。

通过该方案，酒店可以实现对该插座上设备的远程通断控制、定时任务及场景联动，从而以极低的改造成本实现客房的局部智能化升级，提升住客的入住体验。

2. 硬件选型：1路智能墙壁电源插座

在本方案中，硬件是芯步提供的 智能墙壁插座（10A/16A）。

• 安装方式：标准86型规格，可直接平行替换传统墙壁插座，无需重新凿墙布线，实现“无损安装”。

• 核心功能

  • 远程控制：支持继电器通断控制，即打开/关闭插座电源。

  • 功率计量（可选）：部分计量版型号支持实时上报电压、电流、功率，便于酒店进行能耗统计。

  • 响应速度：从云端下发指令到设备执行，延迟约为 80-120ms，实现即点即控的流畅感。

3. 对接设计

芯步采用标准IoT架构，接口完全开放，支持任何支持HTTP请求的编程语言（如Java, Python, PHP, Go, Node.js等）或各类SaaS平台进行对接。

• 控制链路：酒店PMS/智能客控系统 -> 互联网/局域网 -> 芯步开放API -> 智能墙壁插座 -> 受控电器。

• 核心协议：HTTP/HTTPS 或 MQTT（局域网/公网）。

• 鉴权方式：基于 AppID、AppSecret 的 MD5 签名验证（Sign算法）。

4. 核心接口对接详解

为了实现场景化控制，开发者需要重点对接以下两个核心接口：设备控制接口与标签控制接口（用于场景联动）。

4.1 设备控制接口

这是最基础的控制方式，直接针对具体的插座设备ID下发指令。

• 请求地址： http(s)://api.thingboot.com/{AppID}/device/control/

• 请求方法： POST

• 参数结构

  • device： 设备的唯一ID（字符串类型，可在控制台查看或通过接口拉取）。

  • order： 控制指令（JSON字符串）。

• 核心指令

  • 开启插座： {"power": 1}

  • 关闭插座： {"power": 0}

  • 临时供电（先通后断）： 适用于插卡取电或门磁触发时的短暂供电。

    • 示例：{"reset": 60000} （接通电源，60秒后自动断开）。

  • 循环控制{"point":{"relay":[1],"interval":5000}}（用于测试或特定场景，如5秒后断开）。

4.2 标签/场景控制接口 (Tag Control)

这是实现“场景化”的关键。在芯步后台，可以将这一个“墙壁插座”定义到某个“标签”（如“客房标准间”、“欢迎模式组”）下。通过控制标签，即可控制该插座。

• 请求地址： http(s)://api.thingboot.com/{AppID}/tag/control/

• 应用场景

  • 第一种场景：“欢迎模式”住客插卡取电或前台办理入住时，系统调用此接口。

    • 指令：{"tag": 12345, "power": 1} （标签ID 12345 包含该插座，执行开启）。

  • 第二种场景：“睡眠模式”住客说“关闭所有灯光”或按下床头睡眠按键。

    • 指令：{"tag": 12345, "power": 0} （关闭插座电源）。

5. 典型客房场景化控制流程

以下以酒店实际运营中的3个核心场景为例，演示技术实现逻辑：

第一种场景：欢迎模式

• 触发条件：住客插取电卡 / 前台确认入住 / 门磁感应开门。

• 执行逻辑

  1. 酒店管理系统检测到客房状态变为“已入住”。

  2. 系统向芯步API发起请求：

     POST /AppID/device/control/ { "device": "123456789", "order": {"power": 1} }

  3. 预期效果：连接在该插座上的“落地灯”或“装饰画电源”自动点亮，营造温馨氛围。注：结合芯步其他温控器产品，还可同时联动空调调整至舒适温度。

第二种场景：阅读模式

• 触发条件：住客点击床头面板的“阅读模式”或语音指令。

• 执行逻辑

  1. App/面板发送“阅读模式”指令。

  2. 系统控制主灯调暗（非本插座功能，略），同时控制该插座保持开启。

  3. 预期效果：插座连接的“台灯”保持点亮，提供集中照明。

第三种场景：离店/节能模式

• 触发条件：住客拔卡离开 / 前台退房结账 / 超过15分钟人体无感应。

• 执行逻辑

  1. RCU或PMS系统触发“离开模式”。

  2. 系统发送关闭指令：

     POST /AppID/device/control/ { "device": "123456789", "order": {"reset": 0} // 直接断电 或 设为0 }

  3. 预期效果：切断该插座电源，消除待机电耗（如电视盒子、饮水机、手机充电器等），实现节能降耗。

6. 安全与私有化部署

对于高星级酒店对数据安全的高要求，芯步方案支持灵活的部署方式

• 公有云模式：通过互联网调用API，开发和维护成本低。

• 私有化部署

  • 支持纯局域网环境运行，设备不经过外网。

  • 酒店可将API部署在内网服务器，所有控制指令在内网闭环，保障数据绝对安全，且不受外网波动影响，稳定性更高。

7. 实施步骤简述

1. 注册与准备：在芯步开发者平台注册账号，获取 AppID 与 AppSecret。

2. 设备配网：安装智能墙壁插座（接零火线），通过APP为其配置WiFi（2.4G）网络，使其在线。

3. 接口开发

   • 后端工程师根据上述文档集成签名算法。

   • 封装 ControlDevice 函数。

4. 场景配置

   • 在芯步控制台创建“场景”或“标签”。

   • 将该插座添加到对应的场景中。

5. 联调测试：通过调用API接口，验证“欢迎模式”开、“离店模式”关的实际物理效果。

8. 总结

通过对接芯步 1路智能墙壁电源插座 的开放接口，酒店可以：

1. 低成本快速改造：无需更换现有电器，即插即用。

2. 实现精细化场景：通过 powerreset 等命令组合，实现灵活的时序控制。

3. 提升管理效率：结合标签控制接口，轻松将传统插座纳入客房智能生态，实现节能减排与入住体验的双重提升。