如何在智能公寓客房控制中接入智能硬件来实现两路照明设备控制_解决方案

CATALOG

芯步的开放接口基于标准HTTP协议，签名机制简单，通常10-20分钟即可完成对接。以下方案以“两路照明独立控制”为核心，覆盖设备选型、接口调用、场景联动及异常处理。

1. 项目目标与背景

在智能公寓场景中，实现客房内两路照明设备（如：主照明“路A”与阅读灯/氛围灯“路B”）的独立远程控制、状态查询及定时联动。

本方案基于芯步的智能硬件生态，利用其标准化的开放 HTTP API，将传统照明设备快速接入公寓管理后台或小程序。

2. 硬件选型

要实现对两路照明设备的独立控制，推荐选用芯步的多路控制类硬件。根据公寓装修环境（86底盒标准），选择 智能墙壁开关2路 或 智能照明控制器2路/4路。

推荐型号：芯步智能墙壁开关2路（标准86型）。
核心优势
- 零火线供电：确保 Wi-Fi 连接稳定，避免灯具闪烁。
- 双路独立：物理按键分控（左键对应路A，右键对应路B），且在断开物理按键的情况下，仍可通过 API 强制控制。
- 负载能力：单路 MAX 10A，适配 LED 节能灯、射灯等常见公寓灯具。
- 直接替换：无需重新布线，直接替换现有物理开关即可。

*注：如果公寓强电箱空间充足，亦可选用 智能照明控制器4路 型号 UNI-KZQ-ZM-4，将其隐藏安装在电箱内，仅保留原有物理开关的常闭状态，实现更整洁的面板设计。*

3. 接口对接架构

芯步开放平台的核心理念是“设备直连+ HTTP 协议”。本方案的对接架构如下：

flowchart LR
    subgraph A [用户控制端]
        A1[租户手机小程序]
        A2[公寓PMS管理系统]
    end

    subgraph B [云端与接口层]
        B1[芯步开放API
api.thingboot.com]
        B2[公寓业务后端
签名计算/业务逻辑]
    end

    subgraph C [公寓现场]
        C1[路由器 2.4G WiFi]
        C2[智能墙壁开关2路
硬件设备]
        C3[照明路A
主灯]
        C4[照明路B
氛围灯]
    end

    A1 -- 控制指令 --> B1
    A2 -- 控制指令 --> B2 -- 携带签名/设备ID --> B1
    B1 -- HTTP POST --> C1 -- WiFi直连 --> C2
    C2 -- 继电器吸合/断开 --> C3
    C2 -- 继电器吸合/断开 --> C4

工作流程说明

直连模式：芯步设备通过 WiFi 2.4G 直接连接路由器，无需网关，降低了公寓部署成本。
指令下发：业务系统（或小程序）通过调用芯步的公开 API https://api.thingboot.com/{AppId}/device/control/，携带设备 ID 和签名，向指定开关发送 JSON 指令。
响应速度：从指令发出到继电器动作，典型响应时间为 80-120ms，确保操控体验流畅。

4. 核心接口实现详情

在实际开发中，您需要重点关注“签名生成”与“指令数据结构”。以下是针对控制两路灯具的具体实现逻辑。

4.1 接口鉴权与签名

所有 API 请求均需携带 sign 和 ts 参数进行身份验证。计算公式如下：

参数{AppId}, 开发者密码(Secret), 时间戳(ts)
规则sign = md5( md5(开发者密码) + "." + 时间戳 )

4.2 控制两路照明（开关/关）

请求地址POST http(s)://api.thingboot.com/{YourAppId}/device/control/?sign={sign}&ts={ts}

请求头Content-Type: application/json

请求体（JSON）示例假设我们需要关闭“路A”（主灯），打开“路B”（氛围灯），设备 ID 为 820720。

(注：若使用4路控制器，power3 和 power4 可置空或不发)

4.3 进阶场景：定时与延迟（防息灯）

在公寓场景中，常有“关闭主灯后，小夜灯自动延时开启”或“人走灯灭延时”的需求。芯步接口支持在 order 中直接下发 “先通后断” 或 “先断后通” 指令，无需在服务器端做轮询。

需求：路A（卫生间灯）开启2分钟后自动关闭（防忘记关灯）。
指令

实际开发中，可查阅设备详细文档中的 point1（先通后断）和 reset1（先断后通）参数，用于实现精准的灯光闪烁提醒或延时关闭逻辑。

5. 公寓场景化业务逻辑设计

为了实现良好的入住体验，在公寓管理系统中预设以下逻辑：

5.1 租客入住/退房（权限管理）

入住自动授权：当租客办理入住后，后端系统通过接口将该房间的设备ID绑定至租客的小程序账号下。
退房重置：退房时，系统自动调用接口，执行 {"power1":0, "power2":0}，将所有照明关闭，并解除设备绑定，实现节能。

5.2 场景联动策略

为了提升智能公寓的科技感，可以利用 API 实现以下场景：

欢迎模式：租客开门（门磁联动）-> 触发 API 调用 power1=1（打开客厅主灯）。
睡眠模式：租客点击“晚安” -> 系统发送 power1=0（关主灯），延时5秒后发送 power2=1（开启起夜小夜灯弱光），利用 point 指令实现渐灭效果。
离巢模式：一键关闭所有房间的 power1 至 power2。

5.3 状态同步机制

尽管设备上报状态是即时的，但管理系统在每次控制后本地记录状态，并利用芯步的 “消息推送” 功能（Webhook）接收设备被物理按键按下的状态更新，确保 App 显示开关状态与墙上开关状态实时一致。

6. 部署注意事项

Wi-Fi 信号覆盖：由于设备使用 2.4G WiFi，且标准版不支Mesh组网（除非特定型号），需确保客房内 Wi-Fi 信号强度良好。每套公寓独立一个 AP 或使用强信号吸顶 AP，避免因墙壁阻隔导致设备离线。
设备离线处理：API 调用时，如果设备网络断开，接口会返回相应错误码。在公寓管理后台记录日志，对于频繁离线的设备进行网络排查。
本地化部署（私有化） ：若公寓方对数据安全性要求比较高，芯步支持 私有化部署。您可以将 API 接口和 MQTT 服务器部署在本地局域网甚至公寓内的服务器上，即使外网断开，局域网内的控制依然通畅。