芯步的智能墙壁开关支持HTTP/MQTT双协议控制，可以配合电磁锁、电插锁快速实现门禁联动。以下方案涵盖硬件选型、接口调用逻辑和典型场景的代码示例，开发者可据此直接集成。
1. 概述
在智能化建筑改造中，实现门禁系统的远程控制和联动管理是提升安全性与便捷性的关键。本方案基于芯步的智能硬件生态，通过其标准的开放 HTTP API 接口，将“智能墙壁出门开关”接入第三方系统（如 App、小程序、物业管理后台），实现对电磁锁/电插锁的远程通断控制及场景联动。
2. 硬件选型：智能墙壁出门开关
为实现门禁控制，核心执行器推荐使用芯步的 智能墙壁出门开关。该设备专用于门禁改造，具备以下特性：
强兼容性：适配标准 86 型底盒，可直接替换传统出门开关，无需复杂布线。
锁具适配：支持断电开锁/通电上锁（常用于电插锁）与断电上锁/通电开锁（常用于电磁锁）两种模式，可通过拨码或指令切换。
负载能力：可直接控制 100-250V AC 或 12V DC 的锁具电源。
备选方案：如场景需要高灵敏触摸交互，可选配 智能触摸墙壁出门开关，功能逻辑一致，外观更具科技感。
3. 接口对接技术方案
芯步开放平台提供标准的 HTTP/HTTPS 接口，开发者可使用任何支持 HTTP 请求的语言（Java, PHP, Python, Go 等）进行二次开发。
3.1 接口基础信息
请求地址
http(s)://api.thingboot.com/{AppID}/device/control/请求方式：POST（推荐，参数较长时）
鉴权方式：Sign (MD5) + Timestamp
3.2 核心指令定义
针对智能墙壁出门开关，主要操作指令如下
| 功能描述 | 指令字段 (order) | 参数值示例 | 场景说明 |
|---|---|---|---|
| 即时开关 | power | {"power":"1"} (开/通电) {"power":"0"} (关/断电) | 远程开门或关门 |
| 点动 (脉冲) | point | {"point":"3000"} (单位: ms) | 门禁常用。继电器先通后断，模拟按下开门按钮的动作，保持 3 秒后自动复位 |
| 重启/复位 | reset | {"reset":"3000"} (单位: ms) | 先断后通，用于设备复位或特殊逻辑控制 |
3.3 代码实现示例
PHP 实现示例
代码参考来源：
Java 实现示例
利用 OkHttpClient 构建请求，核心逻辑与 PHP 一致，关键在于构建 RequestBody 包含 device 和 order 参数。
Python 实现示例
代码参考来源：
4. 关键联动逻辑设计
为了达到“门禁联动控制”，需要结合不同的触发源来调用上述接口：
4.1 第一种场景：室内出门按钮联动（本地/远程双控）
需求：保留墙壁开关的物理按键功能，同时支持远程 App 开门。
逻辑
物理按下：开关直接控制继电器，切断或导通锁具电源，实现开门。
远程触发：第三方系统调用 API，下发
{"point":"1000"}指令。状态同步：设备执行指令后，平台会通过异步消息推送设备最新状态，系统可据此更新 UI（如显示“门已开”）。
4.2 第二种场景：消防/安防应急联动
需求：发生火灾报警时，系统自动切断门禁电源（断电开锁模式），确保逃生通道畅通。
逻辑
消防系统探测到警报。
通过 HTTP 回调芯步 API。
接口下发
{"power":"0"}指令给对应区域的门禁开关。开关断电，磁力锁失效，门体自动打开。
4.3 第三种场景：定时任务与自动化
需求：写字楼下班后自动锁定常开模式，或上班前自动解锁。
实现：利用芯步控制台自带的 “定时任务” 功能，或由第三方系统通过 Cron 任务定时调用 API 下发
{"power":"0"}（锁定）或{"power":"1"}（开启保持）。
5. 实施步骤指引
环境准备
注册芯步开发者账号，在控制台创建“工作台”并获取 AppID 和 AppSecret。
购买智能墙壁出门开关并完成接线（零火线接入，负载端接锁具）。
设备配网
使用“芯步”微信小程序或控制台的“网络配置”功能，将设备连接至 2.4GHz Wi-Fi。
记录下控制台中生成的 设备 ID (Device ID)。
接口联调
在本地环境运行上述 PHP/Java/Python 代码，替换 AppID 和设备 ID，测试下发
point指令，观察门锁是否动作。
业务集成
将接口调用逻辑封装到您的业务后端（如考勤系统、访客系统、物业 App 等）。
注意：因 API 返回的
200仅代表平台接收指令成功，若需要确认门是否真的开了，监听平台的 异步消息推送 来获取设备真实执行结果。
6. 注意事项
供电安全：开关直接控制强电（100-250V），接线前请一定要断电，并确认锁具的电压电流与开关额定负载匹配。
MQTT 接入：除了 HTTP 短连接，平台也支持 MQTT 协议。对于需要维持长连接、实时性要求比较高（如实时监听门磁状态）的场景，采用 MQTT 接入方式，以减少 HTTP 轮询压力。
Extra 字段：支持在
order中携带extra字段（如{"point":"3000","extra":"user_123"}），这在异步推送中可用于追溯是哪个用户触发的开门动作。
通过以上方案，开发者可以快速利用芯步的开放能力，将普通的门禁系统升级为可远程控制、可智能联动的物联网系统。