芯步的“智能墙壁复合开关”系列（左灯右门、左门右灯、左门右2灯等型号）正是为“照明+门禁”复合场景设计的——一路接门锁、两路接照明，通过统一HTTP接口即可实现远程双控。以下方案涵盖设备选型、接口对接逻辑和典型命令示例。

解决方案：基于芯步开放接口的3路智能开关远程控制系统

1. 项目概述与选型

在很多场景下（如出租屋、民宿、办公室独立间），需要同时远程控制室内灯光和入户门锁。传统的方案需要安装一个单路门禁控制器和一个多路开关面板，不仅占用墙面空间，布线也复杂。

推荐方案：采用芯步 “智能墙壁复合开关”系列产品。该系列产品专门针对“照明+门禁”融合场景设计，常见型号包括：

• 左灯右门型：1路照明 + 1路门禁

• 左门右2灯型：1路门禁 + 2路照明（契合3路需求）

核心优势

• 二合一：一个86型开关面板同时控制门磁锁和灯光，节省空间。

• 接口统一：无需区分门禁协议或照明协议，全部通过标准HTTP API控制。

• 安全性：门禁控制支持“先断后通”脉冲模式（如断电开锁几秒后自动复位），确保门锁安全。

2. 硬件接线与核心逻辑

在开始对接接口前，需要明确硬件的物理接法，这决定了软件逻辑：

• 接线准备

  • L/N：接入220V交流电。

  • L1（或Out1）：接照明灯具（如吸顶灯）。

  • L2（或Out2）：接照明灯具（如壁灯/走廊灯）。

  • NC/COM（门禁接口）：串联在门禁电源和电磁锁/电插锁之间。

• 逻辑定义

  • 照明：标准的继电器开关，power命令控制通断（开/关）。

  • 门禁：通常设置为“点动模式”，即收到开门指令后，继电器吸合（断电开锁）2-5秒，然后自动断开（恢复上锁）。

3. 接口对接准备

芯步开放标准HTTP接口，这是对接的核心。

步骤一：获取凭证

1. 注册芯步账号并登录控制台。

2. 在“开发设置”中获取 AppID 和 AppSecret（开发者密码）。

3. 将3路智能开关通电并配置好2.4G WiFi（设备不支持5G频段）。

步骤二：签名计算每次请求API都需要携带签名（Sign）和时间戳（Ts）以防篡改。算法逻辑如下（伪代码）：

1. 将 AppSecret 进行 MD5 加密 -> encrypt_secret
2. 拼接字符串:sign_str = encrypt_secret + ts (当前Unix时间戳，秒级)
3. 最终签名:sign = MD5(sign_str)

4. 远程控制指令集实现

假设你的设备ID为 100012345，AppID 为 your_id，构造请求地址：https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

第一种场景：远程控制照明（普通开关）需求：关闭走廊灯（假设接在第2路）接口调用时，order 参数传递标准JSON。

• 关灯命令{"power2":0} (0=关, 1=开)

• cURL示例

  curl -X POST "https://api.thingboot.com/your_id/device/control/?sign=xxxx&ts=xxxx" \ -H "Content-Type: application/json" \ -d '{"device":"100012345", "order":{"power2":0}}'

• 逻辑：执行后，第2路继电器状态切换，灯具熄灭。

第二种场景：远程控制门禁（脉冲模式）需求：按下App按钮，门锁弹开3秒，门关闭后自动重新锁住。这里不能使用简单的 power 命令（因为如果是通电开锁模式，power=0会一直关着门，不安全），必须使用脉冲命令。

• 开门命令{"reset":3000} （含义：先断开线路（开锁），维持3000毫秒，再接通（锁门））注：如果门禁接的是常闭型（通电上锁，断电开锁），reset命令逻辑刚好符合；如果接反了，可使用 point 命令。

• Java示例

  // 使用 OkHttp 库 String json = "{\"device\":\"100012345\", \"order\":{\"reset\":3000}}"; RequestBody body = RequestBody.create(MediaType.parse("application/json"), json); Request request = new Request.Builder() .url("https://api.thingboot.com/...") .post(body) .build(); // 执行后门锁物理弹开3秒

第三种场景：复合控制（开门亮灯 / 离家关灯锁门）需求：通过一个“回家模式”按钮，实现打开门锁 + 点亮客厅灯。由于HTTP接口是无状态的短连接，你可以同时在业务后端串联两个命令，或者并发调用接口（设备ID支持传入多个，但order仅支持单一命令，并发请求）。

• 逻辑伪代码

  # 并发调用两个请求，或者顺序调用 open_door() # 发送 {"reset":3000} turn_on_light() # 发送 {"power1":1}

5. 高级功能与最佳实践

状态保持功能（防误触）对于门禁区域，为了避免用户通过App误操作把门锁长期断开（导致门关不上），强烈配置自动回位或使用脉冲命令。不要直接使用{"power":0}来控制门禁常开。

私有化部署（局域网）如果你对公网稳定性要求比较高，或者处于纯内网环境（如政府单位、实验室），该系列开关支持局域网直接控制。你无需通过云端API，直接在局域网内发送POST请求到设备的IP地址即可，延迟可降低至10ms以内。

6. 总结

通过芯步的3路复合开关，开发者只需要掌握简单的 HTTP POST 请求和 MD5签名 计算，即可在10分钟内完成“照明+门禁”的远程控制集成。

1. 照明路：用 power1/power2 直接开关。

2. 门禁路：用 reset（先断后通）实现安全的远程开门。

3. 拓展：结合小程序、Web后台或自动化规则（如定时关门），可快速构建完整的智能空间管理系统。