弱电间门禁照明联动：如何把1路墙壁智能开关接入到软件项目中_解决方案

CATALOG

芯步的开放接口基于HTTP协议，可以快速将智能硬件能力集成到现有软件系统中。弱电间门禁+照明的联动控制，核心是“门禁事件触发→软件平台响应→向墙壁开关下发指令”这一闭环流程。以下是具体的解决方案：

在许多企业的运维场景中，弱电间（弱电井/配电室）通常处于常闭状态，且照明开关位于室内。传统模式下，运维人员在黑暗环境中摸索进入以寻找开关，不仅体验差，还存在触电或绊倒的安全风险。

本方案目标：利用芯步的1路智能墙壁开关（控制照明）结合智能门磁传感器或门禁控制器，通过集成到现有的 SaaS 或本地化运维软件 中，实现“开门即亮灯，关门延时熄灯”的全自动化管理。

基于芯步开放平台的机制，本方案不依赖第三方封闭生态，完全通过 HTTP API 进行控制。

硬件层：
- 芯步 1路智能墙壁开关：负责弱电间照明的物理通断。
- 触发源（二选一） ：
  - 方案A（无门禁系统）： 智能门磁传感器（检测门的开/闭状态）。
  - 方案B（有门禁系统）： 智能电插锁/磁力锁 + 出门开关（检测合法开门信号）。
传输层：
- 设备通过 WiFi 2.4G 直连网络，无需额外网关，通过路由器接入互联网或局域网。
平台层：
- 芯步开放平台：处理设备注册、HTTP API 鉴权、消息转发。
- 用户自建服务器（私有化部署） ：接收设备上报的事件，执行联动逻辑（Push 消息接收）。
应用层：
- 企业的内部运维系统（Web/桌面程序/APP）。

在软件集成前，需确保硬件在线并纳入平台管理。

设备安装
- 将“1路智能墙壁开关”安装在弱电间入口处，接好零火线，负载端连接照明灯。
- 在弱电间门上安装“智能门磁传感器”。
设备配网
- 登录芯步控制台，通过“网络配置”录入现场2.4G WiFi名称和密码。
- 触发设备配网模式（根据说明书操作），使其连接到网络并显示在控制台的“设备列表”中，获取唯一的 Device ID。

这是集成的关键，目的是让你们的软件能与硬件“对话”。

获取凭证
- 在芯步开放平台创建工作台，获取 App ID、App Secret 及开发者密码。
- 安全设置：配置 IP 白名单，并设置“上报消息接收地址”（即你们的服务器公网地址或内网地址，格式：http(s)://yourdomain.com/api/yoyo/callback）。
签名机制
- 接口调用需携带动态签名 sign 和时间戳 ts，防止接口被恶意攻击。

弱电间的智能化不是靠定时任务，而是靠事件触发。

场景流程：

触发：人员刷卡/按出门开关（或门磁检测到门被打开）。
上报：门禁设备/门磁将“开门事件”通过 HTTP POST 推送到你们的服务器。
逻辑处理：你们的服务器收到消息后，调用 “控制设备接口” 。
执行：向“1路智能墙壁开关”下发 “闭合（开灯）” 指令。
延时与复位
- 方案一（利用硬件特性）：下发带 keep 和 revert 参数的指令，实现“开灯后自动延时关灯”，即使服务器断网也能自动熄灯。
- 方案二（软件逻辑）：关门后，门磁发送“关门事件”，服务器计算延迟后发送“关闭”指令。

关键 API 指令示例（开灯并自动延时关闭）：针对弱电间场景，为了防止人员离开后忘记关灯导致能源浪费，软件应下发“暂态模式”指令。

(注：此指令利用设备自带的“状态保持”功能，即使软件服务器宕机，灯也会在3分钟后自动熄灭，保障了弱电间的安全节能)。

接收设备上报（消息推送处理）：你们服务器需要提供一个 POST 接口来接收门磁或开门传感器的消息：

本地优先（局域网控制） ：
- 芯步接口支持局域网通信。弱电间网络环境复杂，强烈软件部署在公司内网服务器上，通信走 http://设备内网IP 直连，不受公网断网影响，延迟可降低至20ms以内。
强制覆盖模式
- 若软件系统出现故障，运维人员可通过手机上的“芯步小程序”手动强制开启照明，或通过物理开关（墙壁开关保留物理按键功能）直接按压开灯，实现“兜底”机制。

在你们的软件项目中（如“智能运维驾驶舱”），可以为弱电间管理增加以下模块：

实时状态看板
- 图标实时显示“弱电间A”的照明状态（开启/关闭）、门磁状态（已关/开启）。
- 数据来源： 芯步设备主动上报的状态消息。
联动策略配置
- 提供可视化配置项，允许管理员设置“延迟关闭时间”（例如：从默认180秒调整为300秒），无需修改代码，直接调用API更新设备的 revert 参数即可。
日志审计
- 记录每一次“开门触发亮灯”的事件时间、持续时间、操作人员（如果有门禁卡关联）。