CATALOG

芯步的2路智能墙壁开关提供了开放的HTTP API接口,可以通过二次开发实现定时灯光和门禁联动的场景。下面是完整的解决方案,涵盖硬件选型、接口对接、定时任务设计和联动逻辑实现。

解决方案:基于芯步2路智能开关的定时灯光与门禁控制系统

1. 概述

本方案的目标是利用芯步2路智能墙壁控制开关(智能触摸墙壁开关2路)的开放HTTP API接口,结合用户自有的服务器或云平台(如Python、Node.js、PHP环境),实现以下两个核心场景:

  1. 定时灯光控制:根据预设的时间表(如日落/日出或固定时间点)自动开启/关闭第1路照明设备。

  2. 门禁联动控制:将第2路接入电插锁或电磁锁。用户可通过API控制该路通断实现远程开门,或结合刷卡/指纹读头(外部数据输入)实现无人值守门禁,并同时触发灯光(如开门亮灯)。

系统架构图逻辑:第三方服务器/脚本 -> HTTP API请求(带签名) -> 芯步云平台 -> 2.4G WiFi -> 2路智能开关 -> 执行(灯亮/灭, 锁开/关)

2. 硬件与接口准备

  • 硬件:芯步智能触摸墙壁开关2路。

    • 负载能力:阻性负载1000W/路,感性负载350W/路,可直接接入灯具。

    • 门禁适配:支持断电开锁或通电开锁两种电磁锁模式,需根据锁的类型在安装时调整接线

  • 接口核心参数

    • API地址https://api.thingboot.com/{AppId}/device/control/

    • 鉴权方式:动态MD5签名。

    • 控制命令:JSON格式,支持单控、点动(先通后断/先断后通)。

3. 二次开发核心步骤

3.1 环境准备与凭证获取
  1. 登录芯步控制台,获取 AppIDAppSecret

  2. 将2路开关配网绑定,获取 Device ID

  3. 签名算法:这是开发的关键,需实现 Sign = md5(md5(AppSecret) + ts),其中 ts 为当前Unix时间戳(秒)

3.2 接口封装(代码示例参考)

开发时需将HTTP请求封装为一个函数。以Python为例,核心逻辑如下(逻辑参考自官方文档):

  • 功能:计算签名、构建Headers、发送POST请求。

  • 命令格式

    • 控制第1路照明:{"power1": 1}(开), {"power1": 0}(关)。

    • 控制第2路门禁:{"power2": 1}(上锁/解锁,取决于接线), {"power2": 0}

    • 点动模式(非常适合门禁):{"point2": 3000} 表示第2路立刻接通(开门),3秒后自动断开(锁门),避免长时间通电烧毁电磁锁

3.3 实现“定时灯光”功能

由于硬件本身支持定时任务,二次开发可通过调用API设置或由外部Cron Job触发。

  • 方案A:云端定时任务(推荐)在服务器设置Cron表达式(例如:每天19:00执行脚本)。脚本内容:调用API,发送 {"power1":1}

  • 方案B:硬件内部定时调用API设置设备的定时属性(依赖设备固件支持,通常用于一次性倒计时)。

3.4 实现“门禁控制”

利用开关的第2路物理控制门锁:

  1. 远程开门:开发一个简单的Web页面或小程序按钮,点击时调用API发送 {"point2": 3000}(点动3秒)。此命令会使开关第2路接通3秒,电磁铁吸合/断开实现开门。

  2. 联动亮灯:在上述开门逻辑中,增加一条延时等待代码,或直接连续发送两条命令。例如:先发 {"point2": 3000} 开门,紧接着发送 {"point1": 1} 开灯。

  3. 本地触发:如果用户在开关旁,按下物理按键2可以开门。如果需要更高级的人体感应,可以通过API轮询外部传感器,再调用该开关动作。

4. 技术细节与优化

  • 门锁安全保护:电磁锁若长时间通电(DC12V/24V)极易烧毁。必须使用 point (先通后断)命令或 reset (先断后通)命令来控制门禁线路。例如,开门动作应下发 {"point2": 2000},无论服务器是否收到返回,2秒后该线路自动物理断开,这是硬件层面的保护,确保安全性。

  • 签名时效性:签名中的 ts 参数通常允许与服务器时间有5分钟左右的误差。若 ts 与服务器时间差超过阈值,请求将被拒绝,需确保机器时间同步

  • 局域网控制:如果对响应速度要求比较高(如要求门禁毫秒级响应),将开关切换至局域网模式。API请求地址可改为设备IP(需查看产品手册是否支持),无需经过云端,延迟可降至10ms以内

5. 总结

通过上述方案,利用芯步2路智能开关的API特性,开发者无需修改硬件即可实现复杂的逻辑控制:

  1. 利用 Cron计划任务 + HTTP请求 实现灯光的定时自动开关。

  2. 利用 point 点动命令 实现安全、自动复位的门禁控制。

  3. 利用 脚本串联逻辑 实现“开门即开灯”的场景联动。

这套方案不仅适用于家庭,也完全适用于共享自习室、办公室门禁改造及民宿远程管理等商用场景