CATALOG

芯步的2路钢化玻璃面板开关支持HTTP API直接控制,可以通过签名鉴权机制安全接入各类软件项目。以下方案涵盖硬件选型、接口对接、门禁联动逻辑及落地注意事项。

1. 项目概述与需求分析

在现代办公室改造或智慧办公升级项目中,往往面临一个痛点:如何在不大动墙体、不更换原有强电线路的前提下,实现照明与门禁的集中控制? 传统方案往往需要布设复杂的继电器或专用总线,施工周期长且成本高。

本方案的目标是利用芯步智能触摸墙壁开关2路产品,通过其标准的开放接口(HTTP API),快速将其接入现有的办公室管理系统(如OA后台、小程序或SCADA系统)。该方案不仅支持对照明(两路)的远程开关,还可利用其“线路通断”的原理,模拟门禁控制器的开门信号(如控制门磁或电插锁),从而在同一面板上实现“照明+门禁”的双重功能,保持墙面整洁统一。

2. 硬件选型与接口特性

2.1 硬件:智能触摸墙壁开关2路

该设备是一款标准86型钢化玻璃面板开关,可直接替换办公室原有墙壁开关,无需重新布线。其核心接口能力如下:

  • 控制路数:支持2路独立控制(对应办公室的主照明和辅助照明,或一路照明一路门禁)。

  • 通信方式:Wi-Fi(2.4GHz)直连,无需额外网关,降低了项目中的单点故障风险。

  • 核心API能力:支持通过芯步开放平台进行HTTP请求控制,兼容公网与局域网(私有化部署)

2.2 接口鉴权机制

芯步的开放接口采用双重MD5签名机制,保证了API调用的安全性。接入前需准备以下三个关键凭证:

  1. AppID:应用唯一标识。

  2. AppSecret:开发者密码。

  3. 动态签名Sign = md5( md5(AppSecret) + ts )(其中ts为Unix时间戳)。

注:这一机制确保了即使请求在公网传输,Token也不易被劫持伪造

3. 接口接入开发指南

要将该面板集成到项目中,主要分为两大部分:控制指令下发(关灯/开门)与状态同步

3.1 API请求接入流

你的服务器可以通过向芯步的API发送POST请求来控制开关。

  • 请求地址https://api.thingboot.com/{AppId}/device/control/?sign={YourSign}&ts={ts}

  • 请求方法:POST

  • 请求头Content-Type: application/json

  • 核心参数

    • device:目标设备ID(可在控制台获得)。

    • order:具体指令,该型号设备支持以下功能

功能场景order JSON 结构说明
开启第1路{"power1":1}1为开启,0为关闭。常用于照明开灯。
关闭第2路{"power2":0}控制灯光关闭或门禁断电。
瞬间点动{"point1":"500"}线路1接通500毫秒后自动断开。(此指令非常适合用于门禁控制,模拟按一下按钮就松开的动作)
状态保持{"power1":{"keep":1,"revert":10}}强制保持开启状态10秒后恢复。

3.2 实战代码片段(伪代码/Python思路)

在后端集成时,重点在于签名的生成和指令的封装。以下是一个典型的接口调用逻辑,用于实现“刷门禁卡后,点动开门”:

4. 落地:场景联动策略

为了实现“智慧办公室”体验,不仅是简单的远程开关,更重要的是联动

4.1 第一种场景:照明与人体感应联动

需求:员工进入办公室,灯光自动亮起;人员离开,自动关闭。实现

  1. 在办公室部署芯步的“人体存在传感器”。

  2. 联动逻辑:当传感器上报有人(order:{"radar_enable":1}时,你的后端服务捕获该消息后,立即向“2路玻璃面板”下发开启照明指令(order:{"power1":1})。

  3. 当传感器持续上报无人超过10分钟,下发关闭指令(order:{"power1":0}),实现节能。

4.2 第二种场景:门禁与照明深度集成

需求:加班晚归的员工刷卡进门时,灯光自动亮起,无需摸黑找开关或用手机开灯。实现传统门禁是独立的,但在本方案中,门禁读卡器(或二维码扫码器)触发开门事件时,调用芯步API。执行流程

  1. 员工在门禁机上刷卡/扫码成功。

  2. 门禁系统向后台请求开锁。

  3. 联动控制:后台向门锁发送开门信号的同时,并行向“智能触摸墙壁开关2路”发送指令 order:{"power1":1}

  4. 结果:门开,灯亮。如果该面板第二路接的是窗帘电机,甚至还可以联动打开窗帘。

5. 实施注意事项与经验总结

在实际项目实施中,为了确保系统稳定性,以下几点值得特别留意:

  1. Wi-Fi信号强度是关键:由于该设备依赖2.4G Wi-Fi,对于安装在配电箱内或金属底盒上的开关,金属屏蔽效应可能导致信号衰减。在安装前用手机连接该位置Wi-Fi测试信号强度,确保RSSI值大于-60dBm。

  2. 门禁适配(电路对接)

    • 该开关输出的为继电器干接点信号

    • 如果办公室门锁是断电开(如电插锁),利用开关的常闭触点接入回路;如果门禁需要点动信号(如门禁控制器的开门按钮接口),请一定要使用上文提到的 point1 指令,防止长时间通电烧毁门禁控制板。

  3. 私有化部署:对于金融或高科技企业的办公室,出于数据安全考虑,可利用芯步支持的局域网私有化方案。由于办公室设备数量通常在几十至几百台,私有化部署可以消除外网延迟依赖,即使外网断网,内网系统依然可以控制灯光和门禁

  4. 用户体验细节:钢化玻璃面板虽然美观,但触摸灵敏度较高。在设定“门禁”功能时,在面板上贴一个微标的门禁指示贴纸,避免来访客人因不熟悉而误触导致门禁异常。

6. 方案总结

通过将芯步2路钢化玻璃面板开关的开放接口集成至办公室管理后台,实现了一种 “低成本、高整合、易部署” 的智能化改造方案。它成功打破了传统强电开关与弱电门禁系统之间的壁垒,仅需通过HTTP API调用,即可在现有软件系统上实现照明集控、门禁点动及场景联动。

这套方案不仅提升了办公室的科技感,更通过人体感应联动功能,有效解决了“长明灯”等能源浪费问题,是构建现代化智慧办公空间的可靠选择