怎么对接WiFi触摸墙壁开关以实现单路照明或门禁控制_解决方案

CATALOG

芯步的WiFi触摸墙壁开关开放了标准的HTTP API接口，对接起来其实挺简单的——你只需要照着接口规范发命令就行。下面我分两种场景（照明控制和门禁控制）分别讲一下具体怎么对接。

在开始写代码之前，不管你要控制灯还是门，都需要先在芯步平台完成一些基础配置，拿到必要的凭证。这就像是你要发快递，首先得有“收货地址”和“身份验证”。

注册与创建：去芯步官网注册账号，然后在后台创建一个“工作台”（可以理解为你的项目空间）。
获取密钥：在“开发设置”里，找到两个关键字符串：
- AppID：相当于你的“用户名”，接口URL里会用到。
- AppSecret：相当于你的“密码”，千万别泄露给前端，只在后台服务器使用。
设备配网：拿到开关后，用微信小程序或电脑后台，把开关连到你家的 2.4G WiFi 上（注意不支持5G频段）。连上网后，在后台能看到这个开关的 Device ID（设备编号），这是你要控制的“目标”。
接口地址：API的固定格式是：http(s)://api.thingboot.com/{你的AppID}/device/control/

芯步的接口使用了 sign 签名验证，这是为了安全，防止接口被恶意调用。所有的命令都是通过向上述地址发送 POST 请求完成的。

签名的生成规则（以常见的MD5为例）：这是一个简单的数学题：

请求体结构：请求体必须是JSON格式，包含两个字段：

适用产品： 智能触摸墙壁开关 1路或 3路。核心需求： 开灯、关灯、短暂亮一下（如楼梯间或门锁照明）。

这是最简单的用法，只需要控制继电器的通断。以下是一段模拟后台向开关发送命令的示例代码，使用 power1 指令。

控制代码示例：

进阶玩法：点动模式（用于门禁控制的照明）如果你想让灯在按下后亮几秒自动熄灭（比如门开了照亮一下），不要用 power1，要用 point1（先通后断）或 reset1（先断后通）。

适用产品： 智能触摸墙壁复合出门开关（或者叫门禁专用开关）。核心需求： 控制电磁锁或电插锁的断电开门。

门禁控制和照明的物理接线不一样。门禁锁通常是“断电开锁”或“通电开锁”。关键点： 你需要一个先断后通（reset） 的动作。想象一下：

如果直接用 power 命令，会导致门锁一直断电，门关不上了。所以必须用 reset 命令，让继电器断开几秒后自动复位。

控制代码示例（让门开5秒）：

解析：命令下发后，设备会立即执行“断开”动作（门开了），持续5000毫秒后，自动“闭合”（门锁上）。

针对“复合开关”的注意点：有些复合开关是“一灯一门”的设计（一路控制灯，一路控制门）。

这里有一些我在调试过程中总结的经验：

关于时间（ts）：签名里的时间戳一定要和服务器时间同步。如果服务器时间和芯步云端时间相差超过几分钟（通常是5-15分钟），接口会报签名错误。
关于网络环境（局域网/私有化）：芯步的硬件是支持局域网控制的。如果你的服务器和开关在同一个网段（如小区中控室控制楼道灯），可以走内网API，延迟会低到80ms左右，而且不占用外网带宽。
关于负载（LED灯）：如果你控制的是LED节能灯，注意看一下参数，LED灯的瞬间启动电流很大，1路的智能开关LED负载不要超过300W，不然容易烧触点。

控制照明：用 power1 （开关）或 point1 （短暂点亮）。
控制门禁：用 reset （断开后自动恢复），并设置合适的延时时间（3-5秒）。
调试工具：如果你不想写代码，可以先在芯步的“物联网控制台”里直接下发指令测试，如果控制台能控制，说明硬件没问题；如果控制台可以但你的代码不行，那99%是 sign签名 算错了。