芯步的智能墙壁复合开关通过标准HTTP接口开放控制能力,开发者只需调用API即可实现门禁或照明的远程遥控。下面从硬件选型、接口对接、场景应用到部署要点,给出完整方案。
1. 解决概述
本方案的核心是利用芯步提供的标准HTTP接口,对接智能墙壁复合开关,实现对门禁(电子锁)或照明设备的远程控制。
适用设备: 芯步智能墙壁复合开关(1路/2路/3路)。
核心优势: 无需复杂的嵌入式开发,任何支持HTTP请求的编程语言(如Java, PHP, Python, Go, Shell等)均可快速集成,API接口响应速度约80-120ms。
业务场景:
远程门禁: 管理员手机远程点击“开锁”,释放门禁电磁锁/电插锁,实现远程开门。
远程照明: 手机App控制楼道、庭院或公共场所的灯光开关。
2. 硬件选型与接线方案
在开始对接前,需要根据控制对象选择合适的硬件型号。
2.1 硬件选型
若控制照明:选用 智能墙壁开关(1路/2路/3路) ,直接替换原有86型墙壁开关即可,支持灯、排风扇等阻性/感性负载。
若控制门禁:选用 智能墙壁复合开关 或 智能控制器4路。因为门禁锁(如电插锁、电磁锁)通常需要12V直流供电,普通的墙壁开关输出是220V交流,需要特别注意电压匹配,或通过加装中间继电器转换。
2.2 接线示意图
场景 A:控制 220V 照明电路
| 设备端 | 接线说明 | 负载端 |
|---|---|---|
| L 接口 | 接 220V 火线输入 | 空气开关/电源 |
| N 接口 | 接 220V 零线输入 | 空气开关 |
| OUT1 接口 | 接灯的控制线(火线出) | 照明灯泡 |
场景 B:控制 12V 门禁锁(适配说明)
注意: 智能墙壁开关输出的是标准交流电,而电锁需要直流电,且直接通断220V去控制门锁可能存在安全隐患。推荐方案如下:
开关的
OUT接一个 AC220V 线圈的中间继电器。继电器的常开触点接 12V 电源的正极。
门禁锁的红色线接 12V 电源负极,黑色线接 继电器常开端。
效果:当开关通电,继电器吸合,12V回路导通,电锁通电(断电开锁型需逻辑取反)。
3. 软件对接开发指南
软件端对接步骤简单,主要分为:获取凭证、发送API指令、接收反馈。
3.1 第一步:准备工作与凭证获取
注册账号: 在芯步官网注册开发者账号。
创建工作台: 在“工作台”中创建项目,系统会生成核心凭证:
AppID:应用的唯一标识。
AppSecret:开发者密码,用于计算签名,切勿泄露。
3.2 第二步:设备配网与ID获取
将智能墙壁开关通电。
根据官方手册,通过WiFi(仅支持2.4GHz)进行配网操作,将设备连接到互联网。
在芯步控制台(物联网控制台模块)中,查看已激活设备的 Device ID(设备ID)。
3.3 第三步:接口调用实战
芯步的接口采用标准的HTTP POST请求,签名机制保证了接口调用的安全性。
请求地址:
http(s)://api.thingboot.com/{AppId}/device/control/认证方式: URL参数携带签名。
签名计算规则(以PHP伪代码为例):
3.4 第四步:下发控制命令
这是最核心的部分,通过构造不同的 order 参数来实现功能。
1. 远程锁门/开门(控制门禁)
对于门禁,通常需要模拟“按下按钮松开的动作”(点动),即通电1-2秒后自动断开,防止锁体线圈烧坏。命令示例: 先通后断,接通2000毫秒(2秒)后自动关闭。
释义:让第一路先接通,持续2秒后自动断开;适用于控制门禁按钮或锁体供电。
2. 远程开关灯(控制照明)
开灯命令:
关灯命令:
释义:power1 代表第一路,1是开启(闭合),0是关闭(断开)。
3. 特殊场景:状态锁定(防误触)
在某些公共场所(如走廊),为了防止本地人员手动把灯关掉,支持“锁定”功能,用户手动关闭后,开关会在设定秒数内自动恢复开启状态。
释义:强制锁定开启,如果有人手动关闭了开关,5秒后会自动重新打开。
4. 深度应用:状态监听与联动
仅仅能遥控是不够的,专业的系统需要知道“灯到底开了没”或“继电器是否吸合”。
消息推送机制:你需要准备一台公网可访问的服务器(或使用云函数),在芯步工作台设置“上游消息接收地址”(Webhook URL)。
数据流:当开关状态发生变化(手动按压或遥控成功)时,平台会主动向你的服务器推送当前设备的状态JSON数据。
应用:你可以在服务器端接收数据,存入数据库,从而在手机App上实时显示“门锁已开”或“灯已亮”的状态,或者结合传感器实现自动化场景(如:检测到人走开 -> 请求接口关灯)。
5. 开发集成要点
网络环境
设备仅支持 2.4GHz WiFi,不支持5G频段。部署前请确认现场WiFi信号强度,避免安装在金属配电箱内。
安全机制
所有的API调用必须使用动态签名(MD5嵌套+时间戳),不可将AppSecret明文写在客户端代码(如手机App)中,由业务后端代理请求。
门禁适配
绝大多数电插锁/磁力锁属于 断电开 型。如果使用上述“先通后断”命令(
point),逻辑是:通电 -> 上锁 -> 2秒后断电 -> 开锁。此逻辑通常符合消防安规。
测试工具
在正式开发前,可以直接登录芯步的 物联网控制台 网页,在网页上手动点击按钮控制开关的通断,以此先排除硬件接线问题,确认设备在线后再进行代码开发。
通过以上步骤,你可以快速利用芯步的开放能力,实现1路智能墙壁复合开关的设备上云与手机APP远程操控,集成到现有的管理系统中。