CATALOG

共享自习室的痛点是“无人化管理”——用户自助预约后,需要自动开门、开灯,离开后又要关门、关灯省电。2路复合开关正好解决这两个需求:一路控制门锁,一路控制照明。以下方案从设备选型到代码实现,给出完整的对接路径。

1. 行业痛点与需求分析

在无人值守的共享自习室场景中,运营方普遍面临三大痛点:

  • 能耗浪费:用户在离座后忘记关灯,导致电力空耗,通常占运营成本的15%-20%

  • 门禁管理难:传统实体钥匙难以分发给不同时段的预约用户,且存在安全隐患。

  • 改造成本高:许多老旧自习室布线简单(单火线),难以安装复杂的智能网关或重新布线。

针对上述问题,芯步推出的 2路智能墙壁复合开关 提供了低成本、高集成的解决方案。该设备不仅支持双路独立控制(如“左灯右门”模式),且无需网关,直连WiFi,完美适配共享自习室的轻量级改造需求

2. 产品选型:为什么选择2路复合开关

在对接项目前,需明确所选硬件的特性。针对自习室场景,推荐使用UNI-KG-KC型号的智能墙壁复合开关,其核心优势如下

  • 物理形态:标准86型面板,可直接替换原有的墙壁开关,无需重新凿墙布线。

  • 双路分控

    • 第1路(照明):控制自习室顶灯或台灯,支持渐亮、定时关断等照明场景。

    • 第2路(门禁):可直接串联12V电插锁或电磁锁,实现远程开门。

  • 通信方式:采用WiFi 2.4G直连,无需购买额外的网关设备,降低部署成本。

  • 核心接口:开放全量HTTP API接口,支持签名鉴权,可实现私有化部署,确保数据安全

3. 接口对接方案详解

本方案的核心在于利用 HTTP请求 将您的业务系统(小程序/公众号/Web后台)与硬件连接起来。芯步的接口设计遵循无状态原则,任何支持HTTP协议的开发语言均可接入。

3.1 准备工作

在开始编码前,需要准备以下三个关键凭证

  1. AppIDAppSecret:登录芯步控制台获取。

  2. Device ID:设备通电配网后,在控制台获取该设备的唯一标识。

  3. 网络环境:确保开关连接的WiFi网络能够访问公网(或已配置私有化域名)。

3.2 鉴权机制(签名计算)

为了防止接口被恶意篡改,所有命令下发请求均需要进行双重MD5签名校验。这是对接中最关键的一步

签名算法逻辑

  1. AppSecret 进行一次MD5加密,得到 SignStr1 = MD5(AppSecret)

  2. 获取当前Unix时间戳(秒级) ts

  3. 拼接字符串并再次加密:FinalSign = MD5( SignStr1 + ts )

代码示例(Python)

3.3 核心命令下发(开门与关灯)

对接的核心在于通过API控制开关的两路继电器。针对自习室场景,具体的命令参数(Order)至关重要

3.3.1 独立控制(基础开门/照明)

业务系统需要根据用户的操作下发对应的JSON指令:

  • 开门(第2路通电3秒后自动断)为了确保门锁不会长时间通电烧毁线圈,通常使用“点动”模式。

  • 开灯/关灯(第1路)用户预约成功后自动开灯,离开后自动关灯。

3.3.2 场景联动(状态保持)

在自习室中,常遇到用户手动物理按键开关灯的情况,如果不加干预,可能会破坏自动计费逻辑。利用“状态保持”功能可以强制锁定设备状态

  • 强制锁定照明为开启状态

    解释:强制开启照明,如果用户手动关闭了开关,系统会在5秒后自动将其重新打开。这适用于用户正在计费时段,禁止其手动关灯跑路的情况

3.4 集成到业务逻辑(以小程序为例)

在实际的共享自习室小程序中,接口调用应嵌入在具体的业务流程里

  1. 用户预约成功

    • 系统生成订单。

    • 发送命令:调用API下发 {"power1":"1"}(开灯)。

    • 发送命令:调用API下发 {"point2":"3000"}(门禁通电3秒开门)。

  2. 用户中途暂离

    • 为了节能,系统可下发 {"power1":"0"} 关灯,但保持门禁关闭,防止外人进入。

  3. 订单结束/超时

    • 发送命令:下发 {"power1":"0"} 关闭照明。

    • 安全检查:下发状态查询接口,确认设备处于断电安全状态。

以下是微信小程序端调用开门接口的完整示例,展示如何将指令封装到 wx.request

4. 高级应用与体验优化

除了基础的开关控制,利用设备的特殊指令集和私有化部署能力,可进一步提升自习室的运营效率。

4.1 防占座与节能策略

利用 “先断后通” 功能,可以在用户离线超时后,强制重置照明状态

  • 业务场景:当系统检测到用户离线超过10分钟,自动下发 {"reset1":"1000"}。该指令会让灯熄灭1秒再重新点亮,提示用户设备将被释放;若不响应,则直接彻底断电,释放座位资源。

4.2 私有化部署(局域网直连)

对于注重隐私或网络环境较差的地下自习室,芯步支持私有化部署

  • 方案:将API接口指向本地服务器地址(如 http://192.168.1.100/control)。

  • 优势:即使外网断开,自习室内部局域网依然可以正常控制灯光和门禁,保证7x24小时营业的稳定性。

5. 总结

通过将芯步 2路智能复合墙壁开关 对接入共享自习室系统,开发者能够在30分钟内实现“远程开门+自动照明”的核心物联网闭环。

该方案的高明之处在于极简集成

  1. 物理层面:利用1个86型开关替代了“门禁控制器 + 照明开关”两个设备,节约了底盒空间和布线成本。

  2. 代码层面:利用简洁的HTTP API(power1point2)完成了业务逻辑与硬件的解耦。

这套方案不仅适用于自习室,同样可快速复制到共享茶室、共享办公室、健身房更衣柜等无人值守场景。开发者直接参考芯步官方提供的 UNI-KG-KC 产品手册,获取最详细的命令词典和错误码对照表,以便快速上线