芯步的门禁产品线包含智能出门开关、电子锁和密码门禁，均通过开放的HTTP/MQTT接口接受指令。以下方案聚焦如何将这些设备与人体传感器、语音播报等设备联动，实现“人来灯亮、刷卡联动、异常告警”等自动化场景。
1. 背景与目标
在现代办公环境中，传统的独立门禁系统往往存在“信息孤岛”问题，无法与办公室内的照明、空调、监控等系统形成联动。本方案的目标是利用芯步开放平台及智能硬件API接口，将办公室门禁系统改造为智慧办公的触发核心。
核心目标：
场景联动： 实现“刷卡/人脸开门即解锁”的联动效果（如：上班第一次开门自动亮灯、开空调、播放欢迎语音）。
远程智控： 管理员可通过API远程控制门禁状态（如：临时访客远程开门）。
状态感知： 结合传感器实现安防联动，检测到非法闯入时自动触发本地报警并推送通知。
2. 解决方案设计
基于芯步的开放能力，本方案采用 “云+端” 的架构模式。
设备层（感知执行层）：
门禁控制类： 芯步智能WiFi出门开关、电子锁（电插锁/磁力锁）、智能密码门禁。
传感触发类： 智能WiFi人体感应传感器（用于检测门内外人员停留）、门磁传感器（检测门开关状态）。
告警与提示类： 智能WiFi扬声器/语音台卡（用于播放“欢迎光临”或“非法闯入”语音）、智能WiFi烟雾传感器。
网络层：
所有设备通过 WiFi 2.4G 直连云端，无需网关，降低部署成本。
支持 HTTP/HTTPS API 及 MQTT 协议，保证指令下发的实时性。
平台层（芯步开放平台）：
设备管理与控制： 提供设备注册、状态查询、指令下发（
device/control）接口。消息推送： 设备事件（如刷卡、按键、人体触发）通过回调机制实时推送到企业自有服务器。
开放接口： 支持企业自有OA系统、钉钉/企业微信小程序通过API集成。
应用层：
企业OA系统（权限管理后台）。
管理员手机端（远程控制与告警接收）。
3. 核心集成逻辑与接口调用详解
要实现“场景联动”，关键在于事件触发与指令串联。以下以最常见的三种场景为例，阐述具体的集成逻辑。
3.1 第一种场景：上班签到联动（“One Touch”体验）
场景描述： 员工在上班时间通过指纹/密码/刷卡成功开门瞬间，系统自动执行：门锁打开 → 办公室灯光开启 → 空调调至适宜温度 → 语音台卡播报“早上好，XXX”。
技术实现流程：
事件回调： 员工操作智能密码门禁，验证通过。
云端推送： 芯步平台向企业服务器推送开门事件（包含设备ID、用户ID、时间戳）。
逻辑处理（业务服务器）：
接收事件，校验员工权限。
查询该员工所在的办公区域对应的智能WiFi墙壁开关（照明回路）ID和智能WiFi控制器（空调回路）ID。
指令下发： 服务器调用芯步开放接口 [向设备下发指令] 。
API地址：
http(s)://api.thingboot.com/{AppID}/device/control/请求参数示例 (JSON):
同时调用智能WiFi扬声器接口，下发TTS语音文本。
3.2 第二种场景：远程访客协助 & 临时密钥下发
场景描述： 访客到访按门铃（通过门口的人体传感器感应或物理门铃），前台或被访者通过手机小程序/App远程查看（配合摄像头）并远程开门。
技术实现流程：
触发感知： 门口的人体传感器感应到有人，将“Occupancy”状态上报至云端。
通知推送： 芯步平台推送“有人长时间停留”事件。
远程动作： 管理员点击App中的“开门”按钮。
接口调用：
服务器调用
device/control接口，指定智能出门开关（控制电锁）的ID。指令内容：
{"switch": "on"}（模拟按下出门开关）。联动效果： 电插锁断电，门打开，延迟数秒后自动上锁。
3.3 第三种场景：安防警戒联动（布防/撤防）
场景描述： 最后一人下班刷卡出门并开启“布防模式”。此时，若有人非法闯入（非正常开门），门磁传感器触发，联动高音报警器鸣叫并推送告警至安保中心。
技术实现流程：
布防设置： 最后一人刷出门卡，系统识别为“下班刷卡”，服务器记录当前门禁状态为“布防”，并下发指令关闭办公区不必要的电源。
非法闯入检测：
情况A（暴力破门）： 门磁传感器检测到门开，但无对应开门事件记录。
情况B（尾随）： 人体传感器检测到内部有人移动，但无合法进门记录。
联动告警：
服务器获取到门磁传感器或人体传感器的异常状态（通过平台消息推送）。
服务器立即调用智能WiFi控制器接口，接通报警灯电源。
调用设备控制接口，让智能语音设备最大音量播放“警报！非法闯入”。
4. 关键接口参数与设备配置清单
在整个开发集成过程中，开发者需重点关注芯步开放平台的以下核心能力：
| 功能模块 | 关键接口/参数 | 说明 |
|---|---|---|
| 设备控制 | device/control | 核心指令。支持GET和POST，支持JSON格式。可通过 order 字段传入power、switch等具体属性值 。 |
| 批量操作 | device 参数 | 支持在 device 字段中用竖线 | 或逗号 , 连接多个设备ID，实现一键执行“开门+关灯+关空调”等场景 。 |
| 异步回调 | extra 字段 | 在下发指令时，可在 order 中包含 extra 字段。设备执行结果推送时会原样返回，用于解决“请求超时”或“需要确认设备是否真正执行”的场景 。 |
| 设备选型 | 智能出门开关 | 核心执行器。按下后门锁打开一段时间后自动上锁，也支持远程强制控制 。 |
| 设备选型 | 智能密码门禁[触摸] | 支持WiFi直连，开放HTTP接口，员工可直接输入密码触发开门事件 。 |
| 扩展传感 | 人体感应传感器 | 用于检测门内门外是否有人，是启动“迎宾模式”或“防盗模式”的关键触发器 。 |
5. 典型部署流程（集成开发视角）
若要将上述方案落地，技术团队可参考以下四步流程：
硬件安装与配网：
在办公室大门安装电插锁 + 智能出门开关（室内侧）。
室内侧顶部安装人体传感器，前台附近安装智能语音台卡。
通过“芯步”小程序/控制台将所有设备配置连接至办公室WiFi（注意仅支持2.4G频段）。
平台注册与API准备：
登录芯步开放平台，获取
AppID和App Secret用于生成签名sign。获取各个设备的唯一
device ID（通常在设备外壳或控制台查看）。
后端业务逻辑开发：
接收消息： 配置消息推送服务器URL，接收门禁按键事件。
控制逻辑： 实现“如果接收到DeviceA的开门成功事件，则调用Control接口给DeviceB下发Power=1指令”。
联调与优化：
注意异步性： 芯步接口返回
code 200仅代表指令下达成功，不代表设备实际动作成功（如设备可能离线）。对于关键联动（如开门），请一定要监听设备的事件上报来确认门确实开了。
6. 总结
统一生态： 无需购买第三方网关，门禁、照明、传感设备均基于芯步WiFi协议栈，统一在控制台管理。
高可靠性： 电磁锁与出门开关分离设计，即使网络中断，室内物理开关依然有效；网络恢复后，云端指令自动同步。
灵活扩展： 未来若需增加会议室预约联动，只需新增设备ID，现有控制逻辑无需大幅修改。
该方案不仅解决了“开门”这一基本需求，更将办公室门禁变为智慧办公的神经中枢。通过集成芯步的开放接口，开发者可以像搭积木一样，自由组合超过30种不同类型的智能硬件，构建出符合特定企业文化的高效、安全、智能的办公空间。