CATALOG

芯步智能开关的开放接口支持通过HTTP API进行二次开发,这意味着你可以把原本只控制照明的开关,改造成同时能触发门禁的智能终端。以下方案围绕硬件接线、API调用和业务逻辑展开。

基于芯步1路智能开关的触摸按键门禁与照明联动控制方案

1. 概述与原理

本方案的目标是利用芯步1路智能墙壁触摸开关,在不破坏原有装修美观的前提下,通过二次开发实现“触摸按键开门”与“照明控制”的融合。

  • 核心原理:利用智能开关的 “点动模式”“状态保持” 模式。当触摸开关时,设备不仅控制内部继电器的通断,同时向云平台发送状态变化事件。我们通过接管API,识别这一动作,并执行开门逻辑。

  • 双控逻辑

    • 场景A(控制照明):直接触摸按键,继电器吸合/断开,控制灯亮/灭。

    • 场景B(控制门禁):触摸按键(如长按或双击,或特定模式下),继电器瞬间闭合(如0.5秒)并断开,模拟按下门禁按钮的动作;或者直接通过API触发门禁系统的HTTP接口。

2. 硬件准备与接线改造

要利用开关控制门禁,通常不需要拆解门禁主机,而是利用开关的干接点特性。

  • 接线示意图

    • L(火线):接220V市电火线输入。

    • L1(控制线)

      • 照明模式:接灯具火线。

      • 门禁模式:接门禁系统开门按钮接线柱的两端(注意:门禁按钮通常是短路开锁,开关需设置为“NO”常开模式)。

  • 电气隔离

    • 门禁读头电压通常为12V/24V直流电,而智能开关为220V交流电。严禁直接连接!必须加装中间继电器进行电气隔离。

    • 接线流程:智能开关L1端接继电器线圈正极,N线(零线)接继电器线圈负极;利用继电器的常开触点(NO和COM)连接门禁的开门信号线。

3. 云端API开发配置

这是实现“二次开发”的核心环节。芯步开放了标准的HTTP API接口,支持签名验证和设备控制

第一步:获取API凭证在芯步控制台获取 AppIDAppSecret,并获取设备的唯一ID(Device ID)。

第二步:识别触摸动作(轮询/回调机制)为了获取“有人按了开关”这一事件,你需要调用API查询设备状态或设置webhook。

  • 命令下发:当触摸开关时,设备会执行动作。你的服务器可以主动向设备下发命令,也可以通过API监控设备状态变化。

  • 关键命令格式(针对1路开关):

    • 控制照明{"power1": 1} (开灯) / {"power1": 0} (关灯)

    • 控制门禁(点动模式):这里需要让开关瞬间通电并断开。通过API发送:{"point1": "500"} (表示先接通后断开,间隔500毫秒,适合模拟按键)

    • 状态保持模式:防止用户误关灯导致门禁系统断电。{"power1":{"keep":"1","revert":"10"}} (即使关灯,10秒后自动恢复,或用于实现自动延时关门)

4. 业务逻辑二次开发(代码示例)

你可以通过任何后端语言(PHP/Java/Python)或前端(小程序)调用接口。

场景实现:触摸开关 -> 开门 -> 灯不亮(或闪烁一下)用户希望按开关时门打开,但室内的灯不要一直亮,或者短暂亮一下作为反馈。

开发流程逻辑

  1. 用户触摸开关。

  2. 智能开关向云端上报状态。

  3. 你的服务器接收到状态变化(或用户通过小程序触发了特定场景)。

  4. 服务器判断:执行门禁开门动作。

  5. 安全校验:为防止恶意刷开门,加入频率限制(如同一个设备5秒内只触发一次)。

示例代码:使用Shell/Python调用API实现开门

5. 高级应用与体验优化

  • 联动场景设置利用“先通后断”命令。例如设置开门时,{"point1":"2000"},门禁通电2秒,同时照明也亮2秒,2秒后自动熄灭,方便夜间看清门口环境

  • 本地局域网控制(私有化部署)如果你担心网络延迟或断网风险,芯步设备支持局域网HTTP API控制。在APP/控制台中获取设备的局域网IP,直接在局域网内发送POST请求,可以实现毫秒级的开门响应,无需经过外网云服务器

  • 状态同步可以开发一个小程序或Web后台,实时显示当前开关的状态(门是开是关,灯是亮是灭),并记录谁在什么时间按了开关开门,形成门禁日志。

6. 总结

通过二次开发芯步1路智能墙壁开关,你可以将传统的机械门禁升级为智能门禁,且保留物理触摸手感,成本极低。

  • 功能总结:一个按键实现 “单击开灯/关灯”“长按/双击开门”(需配合智能场景设置),或者直接通过API逻辑实现 “按开关=开门+灯光闪烁提示”

  • 技术总结:利用芯步开放的HTTP API(特别是point1点动命令和keep保持命令),可以轻松将开关的继电器转换为门禁的触发信号,实现设备间的无缝协同。

该方案特别适合办公室改造、智能民宿部署或家庭智能化升级等场景。