CATALOG

这是一份基于芯步智能硬件开放接口的“民宿多设备联动:智能8路分体远程信号控制箱对接开发解决方案”

这份方案将从设备选型、设计、接口协议对接、核心场景逻辑以及稳定性保障五个维度,为你提供一个详细的技术落地指南。

1. 概述与设备选型

在民宿智能化改造中,传统布线的成本高、周期长,且后期维护困难。采用芯步智能8路分体远程信号控制箱(型号:UNI-KZQ-TY-8),你可以通过其开放的HTTP API接口,将民宿内的灯光、窗帘、门锁、安防等设备无缝对接到自有的PMS(物业管理系统)或小程序中。

核心设备特性:

  • 8路独立控制:支持8路继电器独立通断,每路最大负载2200W(阻性),总功率可达4400W,满足民宿内空调、热水器、射灯等多种大功率设备的控制需求

  • 灵活的网络适应性:支持WiFi 2.4G直连,无需额外网关;且支持私有化部署局域网通信,这意味着即使外网断开,民宿内的本地联动(如刷卡开门自动开灯)依然可以正常运行

  • 开放接口:所有控制指令均通过HTTP请求发起,兼容任何编程语言(Java, Python, Node.js, PHP等),对接门槛低

2. 系统设计

为了实现稳定的联动,采用混合通信模式(云边协同),而非单纯依赖云端。

2.1 网络拓扑结构

  1. 设备层:将8路控制箱安装于民宿强电箱内,输入端接市电,输出端分别接至射灯、窗帘电机、排风扇、门锁电源等设备。

  2. 传输层

    • 控制箱通过WiFi连接民宿内的路由器。

    • 利用芯步支持的局域网发现协议,本地服务器(民宿管家机或边缘网关)可直接通过内网IP对设备进行控制,延迟可控制在20ms以内

  3. 应用层:云端服务器作为数据汇聚中心,下发房间状态和远程策略;本地小程序/App通过API网关调用接口。

2.2 私有化部署*

鉴于民宿对用户隐私和运营稳定性的高要求,开启芯步的私有化模式。即:控制箱直接通过API上报状态至你指定的服务器地址,数据不经由芯步公有云,完全由你掌控

3. 接口对接开发实战

芯步的接口设计遵循RESTful风格,签名机制简单,无需复杂的SDK即可完成调用。

3.1 核心接口调用流程

Step 1:获取必要参数

  • AppId: 平台分配的应用标识。

  • device_id: 控制箱的唯一ID(如:820720)。

  • sign: 动态签名,由参数排序后MD5生成,防止接口被恶意篡改。

Step 2:下发控制指令(以“开启第3路灯光”为例)

  • URLhttp://{设备IP或云端域名}/{AppId}/device/control/

  • Method: POST

  • Header: Content-Type: application/json

  • Body 示例

注:如果是控制“第1路”或“第2路”,只需将 power3 替换为 power1power2 即可

Step 3:接收状态反馈(Webhook / 消息推送)当客人拔卡断电或按动墙面物理开关时,控制箱状态发生变化。你需要配置消息推送接口,芯步会主动将状态变化推送到你的服务器,实现数据同步

  • 推送示例: 当传感器检测到插座电流异常,服务器会收到 {"device":820720, "power3":0} 的状态包。

3.2 8路控制的逻辑映射表

在实际代码开发中,建立设备通道与业务逻辑的映射关系

通道号 (Channel)接口参数接入设备民宿场景联动逻辑
CH1power1总照明(射灯/主灯)有人开门/插卡即开
CH2power2氛围灯带/壁灯联动“睡眠模式”关闭
CH3power3窗帘电机(正反转需配合模块)早安模式:自动拉开
CH4power4排气扇/新风检测到湿度 >80% 自动开启
CH5power5热水器循环泵客人Check-in前15分钟预热
CH6power6空调总电源离房模式:强制断电节能
CH7power7电视/投影幕布观影模式:降下幕布,关闭CH2
CH8power8门磁锁电源(信号反馈)配合门磁检测,实现非法闯入报警

4. 核心联动场景

利用控制箱与芯步生态内的传感器(如人体传感器、门磁)配合,可以实现高级自动化

第一种场景:无卡取电与欢迎模式

  • 逻辑: 客人通过小程序下发开门指令(或密码锁验证成功) -> 你的服务器收到开门信号 -> 调用接口向8路控制箱下发 power1:1 (开灯) 和 power5:1 (热水器启动)。

  • 优势: 实现了客人“人到灯亮,热水即来”的体验,无需实体插卡取电。

第二种场景:离房节能模式

  • 逻辑: 通过安装在门口的人体传感器(门磁)。如果30分钟未检测到人体活动 -> 服务器判断为“无人” -> 批量调用接口

  • 节能效果: 杜绝了客人忘记关空调/灯光的浪费,综合节能可达30%以上

第三种场景:紧急联动(安防)

  • 逻辑: 烟雾传感器报警 -> 芯步云端/或直接由传感器触发联动 -> 向控制箱下发指令:

    1. power1:1 (打开所有照明,辅助逃生)。

    2. 切断非必要电路(如 power6 切断空调以防短路)。

    3. 同时向管家App推送告警

5. 项目落地的注意事项

在实际接线和部署中,请注意以下几点以保证系统稳定:

  1. WiFi信号强度:控制箱位于强电箱内,金属箱体会屏蔽WiFi信号。在强电箱附近部署AP(无线接入点),或选择外置天线版本的控制器,确保信号强度在-50dBm以上

  2. 负载匹配:虽然单路支持2200W,但如果是感性负载(如电机、LED变压器),启动电流较大,总负载控制在额定功率的70%以内

  3. 设备ID管理:在前期调试时,将每个控制箱的MAC地址与民宿的房间号进行录入绑定。例如扫描设备二维码获取device_id后,存入数据库并标记为“301房”,防止下发指令时串房控制。

6. 总结

通过对接芯步的8路分体远程信号控制箱,你可以在不改变原有电路结构的前提下,快速实现民宿的智能化升级。其开放的HTTP接口局域网控制能力,给予了开发者比较高的自由度。你可以利用它构建出媲美高端酒店的全套客控系统,从客人预定、入住到离店,实现全流程的设备自动化管理,从而提升入住体验并降低运营能耗