芯步8路智能分体远程电源控制箱采用HTTP API接口，可轻松集成到民宿管理系统中。以下方案围绕“设备联动”与“场景自动化”展开，涵盖接口对接架构、核心代码实现及典型民宿场景配置。

1. 背景与需求分析

在民宿运营中，能源浪费（如客人外出未关空调、灯光）与入住体验的个性化（如欢迎模式、睡眠模式）一直是痛点。传统民宿改造往往面临布线复杂、成本高的问题。

利用 芯步8路智能分体远程电源控制箱，结合其开放的 HTTP API 接口，开发者可以无需改动现有强电线路，快速将民宿的灯光、空调、热水器、窗帘电机等8路独立设备接入统一的软件管理系统 。

核心目标

• 远程智控：通过PMS（物业管理系统）或小程序，远程关闭未使用的电源。

• 场景联动：结合传感器（门磁、人体存在传感器），实现“人来灯亮、人走断电”的自动化。

• 成本控制：利用WiFi直连或局域网私有化部署，降低网关成本和月租费。

2. 核心技术架构

本方案基于 SaaS + 终端直连 的混合架构，确保指令的实时性与数据的安全性。

2.1 系统架构图 (文字描述)

• 设备层：部署8路智能控制器（UNI-KZQ-TY-8），连接房间内的灯光、插座、热水器等。同时部署智能传感器（如人体雷达、温湿度传感器）。

• 网络层：设备通过 WiFi 2.4GHz 直连民宿路由器。支持设定多组备用WiFi，信号自动切换 。

• 云平台层：芯步开放平台（处理设备心跳、指令转发） + 开发者自建的业务服务器（处理民宿订单逻辑、场景联动规则）。

• 应用层：民宿管家后台（PC端）、保洁/前台APP、住户小程序。

2.2 接口对接机制

芯步的开放接口基于 HTTP/HTTPS 协议，数据格式为 JSON，签名验证机制简单，适合快速开发 。

3. 软件开发集成步骤

3.1 设备初始化与绑定

在集成8路控制器时，首要任务是建立“设备ID”与“民宿物理位置”的映射。

1. 获取设备ID：通过芯步控制台或配网接口，获取每台控制器的唯一标识 device_id。

2. 通道映射：控制器支持8路独立控制，API调用时通过 channel 参数指定1-8路。

   • 例如：Channel 1 映射为“客厅射灯”，Channel 2 映射为“卧室插座（热水器）”。

3.2 核心接口调用逻辑

在代码层面，封装一个 ThingBootService 类来处理鉴权和请求。

• 签名生成规则：一般需要对 AppId、ts（时间戳）和 SecretKey 进行MD5或Hash加密。

• 指令下发示例

  • 场景：保洁阿姨在打扫房间时，需要一键开启所有灯光和排气扇进行通风。

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

  • Payload 逻辑：遍历1-4路（灯光），发送 {"device": "设备ID", "order":{"power":1}}。

  • Payload 逻辑：遍历其余路断电，或根据具体需求设置状态。

3.3 接收设备状态与联动

为了配合传感器做自动化，必须启用 消息推送机制。

• 配置回调URL：在芯步控制台设置 Callback URL（即你的后端服务器地址）。

• 处理传感器消息：当智能人体传感器检测到“无人”状态时，平台会主动推送数据到你的服务器。

• 联动逻辑实现：你的服务器收到“无人”事件后，自动调用8路控制器的 断电接口，需注意：热水器等负载断电，保留路由器供电。

4. 民宿关键场景解决方案

基于8路分体控制箱的特性，可以设计以下高价值场景：

第一种场景：智能入住与退房（与PMS系统联动）

• 需求：客人线上下单后，自动分配房号与门锁权限。

• 集成点：对接PMS系统。当客人办理入住时，调用接口 Channel X（总开关）开启房间总电源。

• 退房保洁：客人退房后，触发“保洁模式”。

  • 控制逻辑：关闭 TV电源（Channel 3）、关闭 空调电源（Channel 5）。开启 排气扇（Channel 6）和灯光（Channel 1/2），方便保洁打扫。

第二种场景：节能策略（离房断电）

• 硬件组合：8路控制器 + 智能人体存在传感器。

• 软件逻辑

  • 监听传感器的“无人持续时长”事件（如15分钟）。

  • 调用控制器接口，断开 Channel 5（空调插座）和 Channel 2（照明回路）。

  • 人性化设计：若传感器检测到“有人移动”，迅速恢复供电。

  • 通过8路控制器的精准断电，可以将单间民宿的日均耗电降低30%以上。

第三种场景：高功率负载管理（防止跳闸）

• 需求：民宿同时使用大功率电器（空调+热水器+电磁炉）可能导致跳闸。

• 集成优势：利用8路控制器的负载监测能力。

  • 策略A：在软件端设定互锁逻辑。例如：开启电磁炉插座（假设为 Channel 8）时，后台自动检测热水器状态（Channel 7），若均在运行，则发出预警或暂时降低非关键负载功率，确保总功率不超过 4400W 的额定总负载 。

场景四：私有化部署（可选）

对于连锁高端民宿，数据安全是首要考虑。芯步设备支持 局域网纯本地控制。

• 操作：你的业务服务器部署在民宿前台本地。

• 优势：即便外网断开，前台系统依然可以控制客房灯光，PMS系统依然可以正常办理入住退房。

5. 预期收益

1. 极低的上手门槛：由于采用标准HTTP协议，无需钻研复杂的MQTT Broker搭建或嵌入式底层开发，后端工程师可在 1天内 完成API对接与基础控制功能开发。

2. 施工成本降低60%：相较于传统485有线客控，无线部署无需开墙布线，仅需将8路控制器替换原有空气开关或放置在配电箱内即可。

3. 差异化服务：通过集成此方案，你的民宿软件将具备“能源分析”、“设备自检”、“自动场景”等特色功能，提升房源在OTA平台上的竞争力。

通过上述集成，开发者不仅完成了一个“开关”的功能，更是构建了一套覆盖 “入住-在住-离店” 全生命周期的智慧民宿能源生态体系。