芯步的智能开关开放接口确实很直接——就是标准的HTTP API，签名算一下，POST一条JSON过去，开关就动作了。下面我围绕“2路开关 + 门禁/照明联动”这个场景，把从接线到接口调用的方案串起来讲清楚。

1. 为什么是“2路”？

你可能觉得门禁和照明是两套系统，但其实通过智能墙壁开关2路，一个设备就能搞定。

• 第1路：接照明灯（走道灯或玄关灯）。

• 第2路：接门禁的门锁控制线（相当于一个“电子开关”，替代继电器）。

这样一来，物理上省了一个设备，逻辑上也统一了接口。

2. 硬件接线（这是最关键的一步）

你手上的2路开关背后有L、L1、L2（或N）接口，安装时注意：

• L（火线进）：接入墙里的220V火线。

• L1（出线）：接照明灯的控制线。

• L2（出线）：这里要接门禁的电锁控制器。注意：如果门禁锁是12V或24V的，千万不能直接把220V接上去！你需要把开关的L2当作一个“通断信号”来用，串联到门禁电源和电锁之间。

小提示：芯步的产品支持单火接线，老房子没有零线也能装。如果你不懂电工，请一定要找个师傅帮接一下，安全第一。

3. 核心接口调用：让设备“动”起来

芯步的接口非常标准化，本质就是发一个POST请求。

请求地址（记得替换AppId）：

请求体（Body）：这是最核心的部分，我们用JSON格式告诉开关要干嘛。

第一种场景：回家开门 + 亮灯

在App或小程序里点一下“回家模式”，后端发这条命令：

• power1:1 -> 第1路通电，玄关灯亮。

• power2:1 -> 第2路通电，门锁断开/吸合（视你锁的类型而定），门就开了。

• 如果你想让灯先亮，隔2秒再开门，可以用point1和point2做延时。

第二种场景：远程关门（反锁）

如果你设置了离店模式，一键关闭所有：

灯灭了，门锁断电锁上，搞定。

4. 进阶联动：人体传感器 + 2路开关

这就是你想要的“自动开门迎宾”效果。需要配合芯步的人体传感器使用。

逻辑流程

1. 传感器感知：有人走到门口，传感器检测到。

2. 传感器上报：设备向你的服务器上报“有人”事件。

3. 服务器下发命令：你的业务逻辑收到消息后，立马组织上面的JSON命令，发给2路开关。

4. 开关执行：灯亮（照明）+ 锁开（门禁）。

更优雅的做法（状态保持）如果你希望门打开10秒后自动锁上，但灯继续亮着，可以这样发命令：

5. 开发避坑指南

接口本身很简单，但实际对接时这几个地方容易踩坑：

1. 签名计算这是为了防止接口被恶意调用。芯步的签名规则是 md5(md5(你的密钥) + 时间戳)。千万别直接在客户端（App/小程序）里写死密钥！一定要在你的后端服务器计算好sign，再下发给设备，否则密钥容易被反编译泄露。

2. 设备ID格式device字段通常是一个数字，在控制台能看到。如果你要同时控制灯和门，device填那个开关的ID即可。

3. 协议选择

   • 公网HTTP：简单，适合原型和App控制。

   • 局域网：如果你想在办公室本地服务器做联动，追求极低延迟（80-120ms），芯步支持局域网IP直连控制，这样断外网也能用。

总结一套标准流程

1. 硬件准备：买个“芯步智能墙壁开关2路”，装在门边的86盒里。

2. 接线：L1接灯线，L2接门锁信号线。

3. 开发：写两行代码，POST {"power1":1, "power2":1} 到API地址。

4. 玩法升级：买个传感器，配置联动规则：if 有人靠近 then 开灯+开门。

这套方案不仅省去了单独买门禁控制器的钱，而且由于是标准HTTP协议，无论你用什么编程语言（Python, Go, PHP）都能轻松集成。