怎么对接3路远程控制墙壁触摸开关来实现远程打开关闭照明与门禁_解决方案

CATALOG

芯步的3路智能开关接口挺直接的，用HTTP POST加上签名就能控制每一路。照明和门禁的接线逻辑不同——照明直接接负载，门禁需要配合断电开锁的锁，这篇从接线、接口调用到代码示例都讲清楚了。

在开始写代码之前，咱们得先把硬件理清楚。这里说的“3路远程控制墙壁触摸开关”，简单理解就是一个86型墙壁开关（就是墙上那个方盒子），但它连了网，而且里面有三个独立的继电器。

硬件清单：

芯步智能触摸墙壁开关（3路）：这是核心。它支持 WiFi，直接用 2.4G 网络，不需要额外买网关。
照明设备：普通的 LED 灯、吸顶灯都行。
门禁设备：注意，这里的“门禁”通常是指电插锁或电磁锁（一般配合门禁电源使用）。这个开关不能直接接大功率的门禁电机，但控制锁的通断是绰绰有余的。

关键思路：

第1路（照明）：接走廊或办公室的灯。
第2路（照明）：接室内灯。
第3路（门禁）：接门禁锁。通常门禁锁是“断电开锁”或“通电开锁”，这里为了安全，一般把开关设置为“点动模式”（即按下开门，给锁通电1-2秒后自动断开），防止一直通电烧坏线圈。

这块稍微提一句，虽然不用附件，但逻辑得通。

零火线：芯步这款开关一般需要零火线供电（单火版也有，但零火更稳）。如果你家（或工地）底盒里只有火线没有零线，要选单火版，或者从灯口借零线过来。
负载接线
- L1 接照明灯 1 的控制线。
- L2 接照明灯 2 的控制线。
- L3 接门禁锁的电源控制端（一般是串联在门禁电源的 GND 和锁的 GND 之间）。

芯步的接口设计得比较友好，不是那种复杂的私有协议，就是标准的 HTTP 请求。你不需要懂 Socket 或者 MQTT，只要会 POST 就行。

接口地址（API URL）：

https://api.thingboot.com/{你的AppID}/device/control/?sign={签名}&ts={时间戳}

请求体（Body）：我们重点关注 order 里的内容。

很多人在控制门禁时有个误区，以为要发很复杂的指令。其实不用，门禁锁就是个简单的通电/断电过程。

比如下班了，发现办公室灯没关。你只需要发：

（这里 power1 和 power2 设为 0，就是关闭第一路和第二路照明）。

如果你直接用 {"power3":1} 开门，然后忘了关，锁会一直通电。对于电插锁来说，长时间通电会严重发烫，线圈很容易烧坏。解决方案：利用开关的 “点动”功能（即先通后断）。看官方文档，point 系列命令就是专门干这个的。

这段指令的意思是：第三路接通，持续 2000 毫秒（2秒）后自动断开。这正好是“嘀”一声门开，人推门进去，然后锁自动又锁上的完美节奏。

比如晚上安保巡逻完，要确认所有门禁都锁死，或者所有灯都关了。你可以一次性控制多个设备（只要在 device 里用逗号隔开）

关于签名（sign）这一步可能是唯一麻烦点的地方。芯步用的签名算法是 MD5(MD5(AppSecret) + ts)。口语化解说：就是把你的密钥 MD5 加密一次，再拼接上当前时间戳，再整体 MD5 加密一次。千万别直接把密钥明文放在 URL 里。小技巧：在调试阶段，你可以先不用代码，用 Postman 配合在线 MD5 工具算好了再发，先把业务逻辑跑通，再写代码逻辑。
门禁的“地线”问题很多电工师傅会把智能开关的零线和门禁电源的零线搞混。一定要共地。如果不确定，找专业电工配合，因为涉及到强电，安全第一。
状态反馈如果你想让你的软件界面上的开关状态是准确的（比如别人手动按了开关，你的网页上要实时显示关），你需要接收芯步平台的消息推送（Webhook）。如果暂时不需要做那么复杂，最简单的就是每次进界面时，调用一下设备状态查询接口，懒人做法，也能用。
复合开关的妙用其实芯步有一款叫“智能墙壁复合开关”的产品，专门有一路是给门禁用的，那个接线更标准，甚至可以直接输出12V，那样配合起来更专业。如果你是大规模做门禁控制，可以问问客服那款，如果是普通场景，就用我们上面说的3路开关控制继电器通断也没问题。