CATALOG

芯步的86型智能墙壁开关采用标准HTTP API接口,控制指令通过签名机制验证身份,整个过程不依赖专用网关,设备直连Wi-Fi即可。以下方案涵盖从硬件准备、接口对接、签名算法到民宿场景的联动逻辑设计。

解决方案:民宿房间智能控制 —— 接入芯步1路/2路86型智能墙壁开关

1. 项目概述与选型分析

在民宿智能化改造中,86型智能墙壁开关是核心执行单元,用于替代传统机械开关,控制灯光、排气扇等设备。

为何选择芯步?

  • 开放式API:提供标准的HTTP API接口,无需私有SDK,支持任何后端语言(Java, Python, PHP, Node.js)

  • 高性价比部署:设备直连Wi-Fi(2.4GHz),不需要购买网关(Zigbee网关通常数百元),极大降低多房间改造成本

  • 私有化支持:支持局域网和私有化部署,即使民宿外网断开,内网依然可控制,保障稳定性

2. 硬件准备与安装

  • 设备型号:UNI-KG-1(1路)或 UNI-KG-2(2路)

  • 安装准备:标准86底盒(需零线,如果家中为单火线布线需确认是否支持单火版)。

  • 接线示意

    • L接口:接入220V火线。

    • L1接口:接入灯具控制线(对应第1路)。

    • L2接口:接入另一路灯具或排气扇(对应第2路)。

  • 上电配网

    1. 安装后,打开断路器电源。

    2. 长按开关面板5秒,直到指示灯“快速闪烁”。

    3. 使用“芯步”微信小程序,输入民宿房间的Wi-Fi密码完成配网

3. 开发对接:核心接口与鉴权

接入项目的核心是处理 动态签名(Sign) 防盗用机制。

3.1 API基础信息

  • 请求地址(正式环境)https://api.thingboot.com/{AppId}/device/control/

  • 请求方式:POST

  • 参数格式:application/json

3.2 签名计算规则(关键步骤)为了防止接口被恶意调用,芯步使用动态MD5签名。计算公式为:

sign = md5( md5(AppSecret) + ts )

代码逻辑示例(Python/Node.js):

4. 功能实现:场景化控制指令

根据民宿运营需求,开关支持多种指令模式,不仅仅是简单的“开/关”:

  • 基础通断控制:用于客人手动或APP点击。

    • {"power1": 1}:打开第1路灯光。

    • {"power1": 0}:关闭第1路灯光。

  • 临时保持/“请勿打扰”模式

    • 场景:客人按了开关,但保洁或管家不想关灯。可实现“用户关3秒后自动恢复”。

    • 指令:{"power1": {"keep": 1, "revert": 3}}(1代表保持开启,用户手动关闭3秒后会自动弹起开启)

  • 定时关闭/“离家延时”

    • 场景:客人出门,一键关闭所有设备,但需要留廊灯30秒用于照明出门。

    • 指令:{"reset1": 30000}(先断开第1路,30秒后自动恢复闭合——注意:这里reset通常指“先断后通”,具体逻辑需根据产品手册,通常是用于排气扇延时关或门禁)。

    • 更正应用:对于普通灯光延时关闭,可用point1或定时任务。例:{"point1": 60000}(先通保持,60秒后自动断开)。

  • 全开/全关策略

    • 可传入多设备:device=ID1,ID2,ID3

    • 指令:{"power": 0}(全部关闭,用于“退房清扫”或“离店模式”)。

5. 系统架构集成方案

在实际民宿管理系统中,采用 “云-边-端”“App-云-设备” 架构:

  1. 前端交互层(客人端)

    • 小程序/APP界面显示“客厅灯”、“卧室灯”。

    • 按钮点击 -> 调用后台接口 -> 后台计算Sign -> 转发至芯步云端 -> 推送到设备。

  2. 自动化场景层(管理端)

    • 入住欢迎:当PMS系统办理入住成功后,自动调用接口 {"power1":1} 打开房间灯光和欢迎语(如有语音模块)。

    • 退房清扫:保洁按门铃触发(或APP点击) -> 调用接口关闭该房间所有灯光和电器({"power":0}),避免能源浪费

  3. 状态同步

    • 在本地Redis缓存设备状态,避免频繁调用API查询。由于开关支持 “局域网控制”,如果民宿前台和房间在同一局域网,可将API请求地址指向局域网内网IP(私有化部署),实现毫秒级响应且不受外网波动影响

6. 故障排查和需要注意的点

  • 设备离线问题:确认民宿Wi-Fi是否为2.4G(不支持5G WiFi)。设备支持配置5组备用Wi-Fi,将隔壁房间或公区Wi-Fi也填入备用列表,增强漫游稳定性

  • 负载安全:1路开关额定电流10A。如果民宿使用的是大功率射灯或LED灯带,单路总功率不要超过300W(LED感性负载),否则可能造成继电器粘连

  • 接口调试:可利用 curl 命令快速测试:

通过以上步骤,开发者可以快速将芯步的硬件集成到民宿管理系统中,利用其开放的HTTP接口,实现远程控制、自动场景联动,提升民宿的科技感和运营效率。