芯步的智能墙壁开关支持HTTP API调用，可通过签名鉴权实现远程控制。以下方案以1路开关为例，说明如何对接门禁或照明系统，核心在于区分两种场景的控制逻辑——门禁需要“点动”（通电后自动断电），照明则用标准通断即可。

一、 概述与选型

在现代智能化场景中，利用墙壁开关不仅实现传统照明控制，还可以结合电磁锁、电插锁实现门禁系统的智能化升级。本方案基于芯步（YoyoIoT） 的开放API接口，旨在指导开发者或集成商如何通过HTTP协议对接1路智能墙壁开关，实现触摸按键对门禁或照明设备的精准控制。

适用硬件选型

虽然芯步提供多路开关，针对本方案“1路控制”的核心需求，选用以下产品（均开放标准HTTP接口）：

1. 智能墙壁开关1路：标准86型，按键式，适用于照明或门禁。

2. 智能墙壁出门开关：专门为门禁系统优化，配合电磁锁/电插锁实现“按下开门”逻辑。

3. 触摸墙壁开关1路：玻璃面板，触控操作，外观更现代。

核心优势：所有设备均支持公网远程控制、本地局域网控制（无需互联网）以及私有化部署，接口响应速度在80-120ms之间，满足门禁系统的实时性要求。

二、 接口对接准备

在开始编码前，需要进行基础的环境准备，获取调用API所需的密钥凭证。

1. 获取凭证

• 注册账号：访问芯步官网注册企业/个人账号。

• 创建应用：登录工作台，进入“物联网控制台”，创建应用以获取唯一的 AppID 和 AppSecret。

• 设备ID：将智能墙壁开关通电并配网后，在控制台设备列表中可以查看到唯一的 Device ID。

2. 鉴权机制

芯步API采用双重MD5签名机制，确保接口调用安全。计算公式如下：

• 参数AppSecret（开发者密码）、ts（当前Unix时间戳，单位秒）。

• 步骤

  1. 计算 Secret_Md5 = md5(AppSecret)

  2. 拼接字符串并计算最终签名：YourSign = md5( Secret_Md5 + ts )

三、 接口对接实现

本方案的实现核心在于根据业务场景（照明或门禁）向设备下发不同的JSON命令。

1. 基础控制指令

对于1路设备，核心命令为控制其内部继电器的通断，从而控制电路（灯亮/灭 或 门锁通电/断电）。

• 开启线路{"power1": 1} 或 {"power": 1} （取决于具体型号手册）。

• 关闭线路{"power1": 0}。

2. 第一种场景：照明控制

普通照明控制逻辑较简单，直接下发“开”或“关”命令即可。

示例代码逻辑（伪代码）

3. 第二种场景：门禁控制

门禁控制通常要求“点动”：用户触摸按键时，门锁通电（开门），延迟几秒后自动断电（锁门）。

芯步接口支持设备端自带逻辑，这比云端轮询更稳定、延迟更低。

• 先通后断 (Point)：继电器先闭合（通电），延时一段时间后自动断开。

• 先断后通 (Reset)：继电器先断开，延时后闭合。常用于复位某些设备。

实现“按下开门”逻辑下发 point1 命令并附带延时毫秒数。

• 命令格式{"point1": 3000} （表示通电3秒后自动断开）。

• 业务流

  1. 用户触摸智能墙壁开关的物理按键。

  2. 后台接收到按键事件（或主动通过API触发）。

  3. 后台下发 point1 指令。

  4. 门禁锁得电打开，3秒后失电锁闭。

4. 高级特性：状态保持

在某些特殊场景（如长明灯通道或保持开门），可能需要锁定状态。

• 锁定开：无论用户物理按键如何按，继电器始终保持接通状态。

• 锁定关：无论用户物理按键如何按，继电器始终保持断开状态。

• 恢复时间：可以设置临时保持的时间（秒），之后恢复常态。

  • 示例{"power1": {"keep": 1, "revert": 10}} （保持开启状态，如果用户手动关闭，10秒后会自动再次打开）。

四、 完整对接流程步骤

以下是从零开始实现“触摸按键控制门禁/照明”的完整操作步骤：

第一步：硬件安装与配网

1. 断电安装：关闭总闸，按照产品手册连接零火线，对于门禁场景，输出端接电磁锁电源。

2. 设备配网

   • 方式A（小程序）：微信搜索“芯步”小程序，登录后选择“添加设备”，输入2.4G WiFi密码，长按开关按键进入配网模式，完成配网。

   • 方式B（控制台）：在PC端物联网控制台的“网络配置”中，登记现场WiFi信息，通过手机热点模式辅助设备入网。

第二步：接口调试

1. 获取设备ID：在控制台“设备列表”页面，找到刚才配网的开关，复制其“设备ID”（如：1878或820720）。

2. 生成签名：使用脚本或在线工具，根据上述鉴权规则生成动态sign。

3. 第一次调用

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

   • Header：Content-Type: application/json

   • Body：{"device":"设备ID", "order":{"power1":1}}

   • 预期结果：听到墙壁开关内部继电器“嗒”的一声吸合，灯光亮起或门锁得电。

第三步：业务逻辑集成

根据具体应用场景开发软件：

• 场景A（Web/App后台管理）：开发一个简单的管理系统，管理员可以远程查看开关状态（可选功能）并控制照明或远程开门。

• 场景B（门禁按钮联动）

  • 需求：用户按下墙壁物理开关 -> 门锁打开3秒 -> 自动关闭。

  • 实现：在门禁系统中注册一个HTTP回调。当物理开关状态变化（设备会上报数据，需通过平台消息推送或设备影子获取），或直接通过触发界面，调用order: {"point1": 3000}。

• 场景C（本地局域网控制）

  • 芯步设备支持局域网发现与控制。如果你的服务器/中控主机与设备处于同一局域网，可以使用设备本地的IP地址进行控制（官方支持私有化，具体参考局域网API文档），减少公网延迟。

五、 常见问题和需要注意的点

1. 负载问题

   • 用于照明：注意LED灯功率不能过小（部分小于3W的LED可能产生鬼火或闪烁），需并联包装内附带的电容。

   • 用于门禁：确认电磁锁/电插锁的工作电压，1路开关继电器默认支持10A/250V，通常足以带动门禁电源。

2. 网络稳定性

   • 设备仅支持 2.4GHz WiFi，不支持5G频段。确保覆盖范围内信号强度良好。

   • 若用于企业门禁等高可用场景，开启设备“断网执行”逻辑（如先通后断指令下发后，即使网络断开，设备也会执行完延时动作）。

3. 签名过期

   • 时间戳ts通常有有效期（一般为5分钟内），请确保服务器时间与标准时间同步，避免签名验证失败。

4. 多设备控制

   • 接口支持批量控制，device字段支持逗号分隔多个ID，order字段可构造针对不同设备的命令集，用于同时控制多个照明回路。

六、 总结

通过芯步开放的HTTP API，对接1路智能墙壁开关实现门禁或照明控制是一项技术门槛低、可操作性强的工程。开发者只需掌握基础的HTTP POST请求和MD5加密，即可在10分钟内完成从设备配网到功能调用的全过程。

推荐方案

• 照明场景：使用智能墙壁开关1路，配合power1命令，简单可靠。

• 门禁场景：使用智能墙壁出门开关或1路开关，配合point1（先通后断）命令，实现“触发-开门-延时-闭锁”的完整门禁逻辑，无需编写复杂的延时状态机。