芯步这款3路开关走的是纯HTTP接口路线，不需要网关，拿个WiFi就能直接调。下面说说怎么把它对接到你自己的系统里，顺带聊聊餐厅包房场景下的一些玩法。

一、我们先搞清楚这是个啥玩意儿？（产品画像）

在动手写代码之前，咱们得先知道手里拿的是个什么“家伙”。

芯步的这款 智能触摸墙壁开关3路 (型号：UNI-KG-CM-3) ，说白了就是一个长在墙上的、能联网的、有三路输出的继电器。

• 3路是什么意思？ 简单说，它一个面板可以独立控制三组灯（比如：1路筒灯、2路灯带、3路主吊灯）。你可以把它当成三个独立的开关挤在了一个86盒里。

• 它怎么联网？ 走的是 WiFi 2.4G。这玩意儿不需要网关，你家路由器信号好就行，省了个网关的钱和空间 。

• 开放程度怎么样？ 这是重点。它提供了 HTTP API 接口。这意味着不管你是用 Java 写后端，还是用 PHP 写网站，甚至是 Excel 的 VBA 脚本，只要你能发 HTTP 请求，就能控制它 。

二、对接前的“热身运动”（准备工作）

想让它听话，得先把下面这几样东西准备好：

1. 硬件安装：按说明书把零火线接好（注意：它需要零线，老房子要是没零线得确认一下），把灯线锁紧。装好之后，面板上的灯会亮，说明通电了。

2. 设备配网

   • 下载“芯步”的小程序或者用电脑登录控制台。

   • 这设备配网方式比较“复古”但很稳：利用手机热点。在小程序里点击配网，它会让你把手机热点改成指定的名字和密码，开关会自动抓取这个热点信息，然后连到你家的路由器上 。

   • 稍微吐槽一句：这种配网方式虽然看起来多了一步，但在餐厅那种复杂信号环境下，成功率其实比一键配网高多了。

3. 拿到三把“钥匙”

   • AppID / AppSecret：登录芯步后台，在“开发设置”里找到。这就是你的账号密码，调用接口时要用。

   • Device ID：在“设备列表”里找到你刚配好网的那个开关，那串数字就是设备的唯一ID。

三、代码实战！5分钟搞定控制（对接开发）

这是最核心的一步。你不需要搞懂复杂的 MQTT 协议，只要对着文档调接口就行了。

1. 先搞懂“签名”是怎么算的（Security）

芯步的接口为了安全，需要你做个简单的 MD5 签名。规则如下：sign = md5( md5(AppSecret) + ts )

• AppSecret：你的密钥。

• ts：当前的时间戳（秒级）。

用大白话翻译：把你的密钥做一次MD5，得到一个字符串，后面跟上时间戳，把它们拼起来，再做一次MD5。

2. 控制代码示例（比如用 Python）

假设你的包房叫“牡丹厅”，里面装了这个开关，Device ID 是 123456789。现在客人来了，你要开灯。

目标：打开第1路（筒灯）和第2路（灯带），关闭第3路（射灯）。

3. 有点意思的进阶玩法

如果你觉得只是开关太单调，这个开关还支持一点“骚操作”：

• 暂态模式 (point1)：就像按门铃一样，按一下通1秒，然后自动断开。这在餐厅用来控制“排气扇”或者“门铃”很实用，不用怕忘了关。

• 互锁模式：虽然没有直接写出来，但逻辑上你可以在自己的程序里做判断。比如按“用餐模式”，开1路关2路；按“清洁模式”，关1路开2路。物理上做不到的互锁，用代码轻轻松松就能实现。

四、真实场景：餐厅包房里的“花活”

光能亮还不够，餐厅要的是氛围和面子。把这几个开关集成到你的项目里，可以做出很多让老板觉得“这钱花得值”的效果。

1. 场景联动（一键切换）

你别让服务员去摁开关，那样太Low了。你在你的平板点餐系统或者服务员手机里加上一个“场景”页面。

• 迎宾模式：吊灯亮80%，灯带亮50%，壁灯亮100%。

• 用餐模式：吊灯亮100%，灯带亮30%（暖色），射灯关闭（避免照到客人眼睛）。

• 清扫模式：所有灯全亮（100%亮度），方便阿姨看到垃圾。

• 浪漫/生日模式：灯带变成闪烁或者调暗，配合背景音乐。

2. 预定自动准备

客人在来餐厅的路上，通过公众号预点了菜单。你的系统判断客人距离餐厅还有2公里，触发命令：打开3号包房的筒灯和空调（如果空调也接了此开关或另一个开关），等客人进门时，包房里是亮堂且凉快的，体验感拉满。

3. 服务呼叫（利用暂态）

有些餐厅包房没有服务铃。你可以把第三路接上一个蜂鸣器或者一个指示灯（甚至不接负载，只接信号）。当客人需要服务时，服务员平板上点一下“呼叫”，接口发送 {"point3":1}，蜂鸣器响一声或者门口的灯闪一下，服务员就知道进去看看了。

4. 打烊后的巡视

晚上10点，经理不用拿着钥匙串一个个去关灯。在办公室电脑上点一下“关闭所有包房”，后台程序循环跑一下所有房间的Device ID，挨个发 {"power":0} 就行了，既节能又安全。

五、避坑指南 & 小贴士

1. 关于局域网：他们家支持私有化部署和局域网通信 。如果餐厅对网络稳定性要求比较高，且不想走外网（万一餐厅宽带断了怕开不了灯），可以把 API 地址解析到内网服务器。不过这需要一点网络配置基础，但搞定了会非常稳定。

2. 异步反馈很重要：上面的代码只是发送了指令。如果想知道灯到底亮了没有（有时候设备离线），你得去接收云端的“异步消息”。简单说就是配置一个回调 URL，设备执行成功了，会给你服务器发个“我亮了”的通知。对于严格的结账系统，这一步做，防止出现“以为关了其实没关”的情况。

3. 手感问题：这个开关是触摸的，且支持物理按键。即使你的服务器炸了，服务员还是可以用手按开关。这保证了底线——灯总能关掉，不会出大事故。

总结

把芯步的3路开关接进你的项目里，技术上就是 “拿Key -> 算签名 -> POST JSON” 这三板斧。难的不是代码，而是怎么把这个开关融入到你的餐厅服务流程里去。

思路打开一点，它不仅是灯，还是传感器执行器，甚至是一个无声的服务员。只要能把 HTTP 请求搞定，剩下的就是你的想象力了。