怎么对接门禁照明一体开关以实现场景联动照明门禁控制_解决方案

CATALOG

芯步的开放接口支持HTTP和MQTT两种方式下发设备指令，配合“智能墙壁复合开关”这类多路控制设备，可以灵活实现门禁与照明的联动。以下方案从硬件选型、接口调用到场景配置，给出完整的对接路径。

本方案的目标是通过芯步的开放接口，将“智能墙壁复合开关”（集成了门禁控制和照明回路）接入第三方或自有的管理系统。核心目标是实现“人来灯亮、解锁联动、人走灯灭”的自动化场景，同时支持通过API进行远程控制和状态查询。

要同时实现门禁控制与照明联动，单纯的门禁机或单路开关无法满足“一体”需求。根据芯步的硬件库，推荐以下组合或特定设备：

智能墙壁复合开关（2路/3路）：这是方案的核心。该设备具备多路物理输出：
- 照明回路：其中一路（L1， L2）专门用于控制照明电路（220V），支持最高1000W阻性负载。
- 门禁回路：其中一路可配置为控制门锁（如电插锁、磁力锁），通过继电器通断来控制门锁电源。
- 优势：只需一个86型底盒，物理上集成了门禁和照明，布线简单，成本低。
智能密码门禁（触摸版）：负责身份识别。它本身是一个独立的入网设备，具备身份验证能力。
替代方案：如果已有普通门禁，可使用 I/O模块 接入门磁信号，但集成度不如复合开关。

芯步开放平台提供标准的 HTTP API 和 MQTT 两种对接方式。

设备端：智能复合开关和门禁设备通过WiFi 2.4GHz连接路由器，注册到芯步云。
应用端：您的服务器通过调用 https://api.thingboot.com/{AppID}/device/control/ 接口，携带sign签名和ts时间戳，向指定device（设备ID）下发指令。
通信协议：推荐使用MQTT进行实时联动以降低延迟，或使用HTTP请求进行逻辑触发。

第一种场景：刷卡/密码验证成功 -> 门锁打开 + 照明自动开启

触发点：用户在门禁机上验证成功。
云端流转
1. 门禁设备上报验证成功事件至芯步云。
2. 您的服务器需通过 消息推送 接收此事件。
3. 下发指令：服务器根据预设逻辑，调用控制接口。
  - 目标设备：智能墙壁复合开关的设备ID。
  - 命令内容
    { "device": "860", "order": { "channel_1": 1， // 开启第1路照明 "channel_2": 1 // 开启第2路门锁电源（通电开锁） } }
4. 延迟几秒后，再次下发指令关闭门锁回路：
  { "order": { "channel_2": 0 } } // 关门后断电锁门
- 实现效果：人员验证通过，灯立刻亮起，门锁打开，进入后门自动锁闭但灯保持常亮。

第二种场景：延时/无人自动关灯（节能模式）

此场景通常不需要门磁传感器，而是利用接口逻辑实现：

第三种场景：远程常开/常闭控制（管理员操作）

管理员在后台点击“开灯”或“远程开门”：

以下是调用芯步接口下发光命令的核心参数说明：

URL： http（s）：//api.thingboot.com/{AppID}/device/control/？sign={sign}&ts={ts}
Method： POST (Content-Type： application/json)
Body (JSON)
{ "gateway": ""， // 复合开关直连WiFi，通常不需要网关ID "device": "设备硬件唯一ID"， // 例如:12345678 "order": { // 如果是复合开关，参数名通常是 channel_1, channel_2, channel_3 "channel_1": 1， // 1为开启，0为关闭 "extra": "ORDER_001" // 自定义字段，用于回调时关联业务 } }
注意：返回的code：200仅代表指令下达成功，不代表设备执行成功。需通过MQTT订阅设备状态变更来确认灯具是否真的亮了。

如果您希望将门禁照明数据集成到现有的楼宇自控系统（如通过Modbus/OPC UA），可以利用芯步的HTTP接口进行中间件转发

供电问题：门禁锁（尤其是磁力锁）通常需要12V直流电，而照明是220V交流电。使用“智能墙壁复合开关”时，请一定要核对每一路的输出参数。常规复合开关输出均为220V，若需控制12V门禁，需额外加装继电器转接或选用对应的弱控型号。
网络延迟：依赖WiFi和云端下发指令，控制延迟一般在1-2秒。若对开锁响应速度要求苛刻（<500ms），在局域网内通过劫持DNS或使用芯步支持的局域网MQTT通信功能，避免经过外网。
设备ID获取：所有联动物料的核心是 device 参数，可在芯步控制台的“设备列表”中查看，确保代码中映射正确。