一、咱们先聊聊这个场景
你正在做一个智能项目,可能是共享茶室、棋牌室,或者是公司的门禁考勤系统。需求很简单:有人扫码付费/刷卡成功/远程授权 → 灯亮一下 → 门锁打开。或者反过来:门关上 → 灯自动熄灭。
这时候就需要把照明和门禁联动起来。芯步的1路智能墙壁开关刚好能派上用场——它既能控制灯,也能配合电磁锁控制门。今天咱们就聊聊怎么把它快速对接到你的项目里。
二、这个开关能干啥?
芯步的1路智能墙壁开关,说白了就是一个可以远程控制的继电器。你给它发个HTTP请求,它就能接通或断开电路。
用在门禁场景下,最常见的玩法是接电磁锁或电插锁:开关闭合 → 锁通电/断电(取决于你的锁是通电开还是通电锁)→ 门打开。
它有几个挺实用的命令:
| 命令格式 | 啥意思 | 举个例子 |
|---|---|---|
{"power1":1} | 第1路接通(灯亮/锁动作) | 开门动作 |
{"power1":0} | 第1路断开(灯灭/锁复位) | 关门状态 |
{"reset1":3000} | 先断开,3秒后自动接通 | 触发开门,3秒后自动复位 |
{"point1":2000} | 先接通,2秒后自动断开 | 闪一下灯或短暂开门 |
这些命令全部通过HTTP接口下发,响应时间大概80-120毫秒,基本感觉不到延迟。
三、对接前需要准备啥?
动手之前,先把这几样东西备齐:
硬件部分
芯步1路智能墙壁开关(设备型号看你需求,触摸款或按键款都行)
如果是门禁场景,再配一个电磁锁或电插锁(注意电压和电流匹配)
86型底盒(标准装修底盒,直接替换墙上开关就行)
软件部分
注册芯步账号,登录控制台
拿到你的 AppID 和 AppSecret(在控制台的“开发设置”里找)
设备配网成功后的 Device ID(设备编号)
网络环境
2.4G WiFi(不支持5G频段,这个要注意)
四、配网步骤(手把手)
别嫌我啰嗦,这一步错了后面全白搭:
第一步:把开关接好线。零线火线别接反,安全第一,接线前记得断电。
第二步:给设备配网。两种方式任选:
电脑端:登录芯步官网 → 进入物联网控制台 → 网络配置 → 登记现场WiFi(必须2.4G)→ 点击“为设备配置此网络”
小程序端:微信搜“芯步小程序” → 登录 → 选择工作台 → 添加WiFi → 手机开热点配网
第三步:配网成功后,设备指示灯停止闪烁。在控制台的设备列表里找到这台设备,记下它的 Device ID。
五、核心代码怎么写?
1. 签名计算(最关键的一步)
芯步的接口用了双重MD5加密,签名规则是这样的
其中 ts 是当前的时间戳(秒)。简单说就是:先把你的AppSecret做一次MD5,然后拼上时间戳,再对整个字符串做一次MD5。
我写个Python示例,看着更清楚:
注意AppSecret要保密,别写在前端代码里,放后端服务。
2. 常用的几种控制方式
方式一:直接开关
适合:远程控制照明开关、手动控制门锁。
方式二:点动模式(先通后断)
适合:按一下门铃开锁3秒、扫二维码开门3秒后自动锁上。
方式三:复位模式(先断后通)
适合:某些特殊设备需要断电重启的场景。
3. Node.js版本(如果你用JS)
六、怎么跟你的项目联动?
你的项目可能是小程序、APP、Web后台,或者SaaS平台。芯步的接口支持任何能发HTTP请求的环境。
第一种场景:共享茶室/棋牌室用户小程序扫码付款 → 你的后端收到支付成功回调 → 调用芯步接口把灯打开(照明),同时给电磁锁通电(开门)→ 用户进入。
代码逻辑:
第二种场景:公司门禁考勤员工刷卡/刷脸 → 考勤机触发事件 → 你的服务调用接口 → 门锁打开3秒 → 同时办公室灯亮起。
第三种场景:智能家居你可以在后台做个定时任务,比如每天晚上6点把灯打开,早上8点关掉。用 reset 或 point 配合定时器就行。
七、常见坑点(我踩过的)
WiFi必须是2.4G:5G频段设备连不上,路由器要开双频合一的话注意一下。
AppSecret别硬编码在前端:谁都能看见,安全性全完。一定要放后端。
电磁锁别直接接开关:芯步官方明确说过“切记,请勿直接将电插锁接在出门开关上”。要用中间继电器隔离,不然容易烧设备。
时间戳是秒不是毫秒:很多新手容易写错,签名不对接口返回401。
设备ID支持批量:如果想同时控制多个设备,
device参数可以用逗号分隔,比如"820720,820721"。
八、总结一下
把芯步的1路智能墙壁开关接入项目,本质上就三步:
设备配网 → 拿到Device ID
计算签名 → 调接口发命令
业务联动 → 在你的系统里触发调用
整个过程不复杂,熟悉HTTP的话半小时能跑通第一个Demo。芯步的工程师也提供技术指导,遇到问题直接问就行。
最后提醒一句:涉及强电和门锁安装,如果没经验最好找电工帮忙,安全第一。