CATALOG

芯步的智能墙壁复合开关通过标准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去控制门锁可能存在安全隐患。推荐方案如下:

  1. 开关的 OUT 接一个 AC220V 线圈的中间继电器

  2. 继电器的常开触点接 12V 电源的正极

  3. 门禁锁的红色线接 12V 电源负极,黑色线接 继电器常开端

    • 效果:当开关通电,继电器吸合,12V回路导通,电锁通电(断电开锁型需逻辑取反)。

3. 软件对接开发指南

软件端对接步骤简单,主要分为:获取凭证、发送API指令、接收反馈。

3.1 第一步:准备工作与凭证获取

  1. 注册账号: 在芯步官网注册开发者账号。

  2. 创建工作台: 在“工作台”中创建项目,系统会生成核心凭证:

    • AppID:应用的唯一标识。

    • AppSecret:开发者密码,用于计算签名,切勿泄露。

3.2 第二步:设备配网与ID获取

  1. 将智能墙壁开关通电。

  2. 根据官方手册,通过WiFi(仅支持2.4GHz)进行配网操作,将设备连接到互联网。

  3. 在芯步控制台(物联网控制台模块)中,查看已激活设备的 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远程操控,集成到现有的管理系统中。