芯步的2路智能墙壁开关支持通过HTTP接口独立控制每一路输出,非常适合双路照明或门禁+照明的组合控制场景。以下方案涵盖硬件选型、接口对接逻辑,以及两种典型场景的具体实现方式。
1 解决概述
本方案基于芯步的智能触摸墙壁开关2路产品,通过其开放的标准化HTTP API接口,实现对两路独立线路的远程智能化控制。该方案无需复杂的网关配置,只要有Wi-Fi网络覆盖,即可将传统的墙壁开关升级为具备远程控制、定时任务和逻辑联动能力的智能节点。
无论是需要分别控制两盏灯实现不同的氛围照明,还是将其中一路用于门禁电磁锁的通断管理,该2路开关都能通过独立的命令精准控制,互不干扰。其核心优势在于每路通道在逻辑上完全独立,开发者可通过API发送简单的JSON指令来控制指定线路的通断,如同调用一个简单的云函数。
2 硬件选型与准备
要实现上述方案,硬件是芯步的 “智能触摸墙壁开关2路” 型号。该设备为标准86型底盒设计,可直接替换家中原有的墙壁开关,无需重新布线。
双路独立控制:该开关内部集成两路继电器,物理上对应背后的L1和L2接线柱。这意味着它可以独立控制两个不同回路的电器设备,如左侧控制餐厅灯,右侧控制客厅灯,或一路控制照明、一路控制门禁。
负载能力:该设备支持总额定功率2000W左右的电器接入。如果用于门禁控制,驱动12V的电磁锁或电插锁的电源适配器完全没有问题;如果用于照明,足以覆盖常见的家居或办公照明回路。
通信方式:设备自带Wi-Fi模组,仅支持2.4GHz频段的Wi-Fi网络。在安装前,请确认现场Wi-Fi信号覆盖良好且密码已知。
在开始软件对接前,需要先将设备配网并注册到云端。可通过“芯步”官方小程序轻松完成:扫描说明书上的二维码进入小程序,登录账号后为设备配置现场的Wi-Fi名称和密码。成功后,可在“物联网控制台”的“设备管理”中查看到这台新设备并获取唯一标识符 Device ID,后续所有API调用都需要依赖这一ID来定位设备。
3 开放接口对接指南
芯步的开放接口遵循标准的HTTP协议,这意味着无论后端使用Java、Python,还是前端JavaScript,都可以轻松集成。接口采用AppID+动态签名的验证机制以保障安全。
3.1 接口鉴权
所有控制请求都需要通过签名验证。你需要先在芯步控制台获取你的AppID和AppSecret。请求时必须携带当前时间戳ts和计算出的签名sign。签名的核心算法逻辑为:sign = MD5( MD5(AppSecret) + ts ) 。其中ts为当前的Unix时间戳(秒级),MD5加密后的字符串均为小写。
3.2 核心API调用示例
双路开关的核心控制逻辑是通过向 /device/control/ 接口发送POST请求,并在Body中携带目标设备的device ID 和具体的命令 order。
以下是针对双路开关的典型命令格式
| 功能描述 | order JSON参数 | 说明 |
|---|---|---|
| 第一路接通 | {"power1": 1} | 控制第一路继电器吸合,线路通电 |
| 第一路断开 | {"power1": 0} | 控制第一路继电器断开,线路断电 |
| 第二路接通 | {"power2": 1} | 控制第二路继电器吸合,线路通电 |
| 第二路断开 | {"power2": 0} | 控制第二路继电器断开,线路断电 |
例如,若需要开启设备ID为“2路设备ID”的第一路照明,并关闭其第二路门禁,HTTP请求构造如下:
请求地址
https://api.thingboot.com/{你的AppID}/device/control/?sign={动态签名}&ts={当前时间戳}请求方式:POST
请求头
Content-Type: application/json请求Body
注意:你可以通过组装不同的order字典,在一个请求内同时控制两路的状态,也可以分开发送以简化逻辑。
3.3 进阶控制命令
除了简单的开关,该接口还支持一些延时控制功能,这在门禁控制(如按一下开锁,5秒后自动锁上)或楼道照明中非常实用
先通后断 (Point):模拟“点动”效果。
{"point1": "2000"}表示第一路先接通电源,持续2000毫秒(2秒)后自动断开。适合控制门禁电磁锁或楼道声光控灯。先断后通 (Reset):模拟“重启”效果。
{"reset1": "3000"}表示第一路先断开电源,持续3秒后自动重新接通。
4 典型应用场景实现
基于上述接口能力,针对主题中的两种典型需求,具体的实现逻辑如下。
4.1 第一种场景:双路照明独立控制
需求描述:办公室或客厅有两组灯(如灯带与主灯),希望在一个面板上分别控制,并接入现有的办公管理系统(如钉钉/企业微信),实现定时或远程关灯。
解决方案将两组灯的零火线分别接入智能开关的L1(第一路)和L2(第二路)接线柱。当系统需要执行“下班全关”动作时,业务后端只需调用接口发送 {"power1": 0, "power2": 0} 即可。如果需要定时在每天18:00关闭灯带(第一路),可利用系统自带的定时任务模块,将该命令封装后定时推送给API接口。若希望实现人来灯亮的自动化,可搭配芯步的“人体存在传感器”,当传感器检测到有人且环境光较暗时,由服务器逻辑判断后向该开关发送相应的power1或power2开指令。
4.2 第二种场景:门禁控制与照明联动
需求描述:公司后门通道,需要既控制门禁锁,又控制通道照明。希望员工在APP点击“开门”时,门锁打开同时照明灯亮起,方便夜间通行。
解决方案将门禁电源适配器的输入端接入开关的第一路,将通道照明灯接入第二路。当接收到开门指令时,若需要门禁点动(按下开启几秒后自动落锁),避免长期通电烧毁电磁锁,使用点动命令。业务服务器调用 {"point1": "3000"},这会使第一路接通门锁电源3秒后自动断开,实现“按需开锁”。同时,可立即发送 {"power2": 1} 将照明开启。可以设定一个联动逻辑:开门动作触发后,照明自动保持开启10分钟(600秒),随后调用 {"power2":0} 自动关闭,实现节能。这一套逻辑不需要人工干预,完全由API指令集自动化完成。
5 总结
芯步的2路智能墙壁开关凭借其开放、标准的HTTP接口,为开发者和集成商提供了极大的灵活性。无论是管理复杂的办公照明环境,还是集成安全门禁系统,开发者仅需关注业务逻辑层的实现,无需关心底层通信协议,通过简单的HTTP请求即可完成对物理世界的控制。