CATALOG

芯步的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 接口鉴权

所有控制请求都需要通过签名验证。你需要先在芯步控制台获取你的AppIDAppSecret。请求时必须携带当前时间戳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接口。若希望实现人来灯亮的自动化,可搭配芯步的“人体存在传感器”,当传感器检测到有人且环境光较暗时,由服务器逻辑判断后向该开关发送相应的power1power2开指令

4.2 第二种场景:门禁控制与照明联动

需求描述:公司后门通道,需要既控制门禁锁,又控制通道照明。希望员工在APP点击“开门”时,门锁打开同时照明灯亮起,方便夜间通行。

解决方案将门禁电源适配器的输入端接入开关的第一路,将通道照明灯接入第二路。当接收到开门指令时,若需要门禁点动(按下开启几秒后自动落锁),避免长期通电烧毁电磁锁,使用点动命令。业务服务器调用 {"point1": "3000"},这会使第一路接通门锁电源3秒后自动断开,实现“按需开锁”。同时,可立即发送 {"power2": 1} 将照明开启。可以设定一个联动逻辑:开门动作触发后,照明自动保持开启10分钟(600秒),随后调用 {"power2":0} 自动关闭,实现节能。这一套逻辑不需要人工干预,完全由API指令集自动化完成。

5 总结

芯步的2路智能墙壁开关凭借其开放、标准的HTTP接口,为开发者和集成商提供了极大的灵活性。无论是管理复杂的办公照明环境,还是集成安全门禁系统,开发者仅需关注业务逻辑层的实现,无需关心底层通信协议,通过简单的HTTP请求即可完成对物理世界的控制。