CATALOG

智能墙壁开关不仅能控制照明,结合门磁锁具后也能管门禁。芯步的开放接口走HTTP协议,签名验证方式统一,下命令就是向指定URL POST一个JSON,响应很快,适合嵌入现有管理系统。下面按接入流程来写:

解决方案:利用芯步1路智能墙壁开关,实现照明与门禁的远程二合一控制

1. 场景设想与硬件选型

首先,咱们得明确一点:一个硬件怎么既管灯又管门?实际上,我们不是用一个开关同时控制两者,而是利用“1路”开关的干接点(继电器)特性

  • 控制照明:最简单,直接把开关串联在照明灯的火线上。

  • 控制门禁:这里的门禁通常是指“电插锁”或“磁力锁”。这类门锁在断电时开锁(或者通电时开锁,视锁型而定)。我们可以把智能开关的“输出端”串联到门禁电源的控制端上。开关一开,继电器吸合,门锁通电(或断电),门就开了。

推荐硬件:芯步的 “智能墙壁开关1路” 型号(UNI-KG-1)。选择它的原因是:

  1. 一路够用:刚好控制一个灯或一把锁,逻辑简单。

  2. 负载能力强:支持10A电流,带灯光没问题;对于门禁电源(通常12V/几安)更是小菜一碟

  3. 安装方便:标准86盒,直接替换原来的开关,无需网关,连WiFi就行

2. 准备工作:拿到开启远程控制的“钥匙”

在动手写代码前,你需要去芯步开放平台拿到三样东西,这就像你要寄快递,得知道地址和寄件人信息:

  1. AppID (应用ID) :这是你的“身份证号”。

  2. AppSecret (开发者密码) :这是你的“私章”,千万别泄露,用来生成签名。

  3. DeviceID (设备ID) :就是那个你要控制的1路开关的序列号。

小贴士:芯步的开放平台接口是免费开放的,没有额外的年费或调用费,这点对开发者很友好

3. 接入核心:接口调用与签名生成

芯步的接口非常标准化,采用 HTTP POST 请求。只要你懂一点编程(比如Python、PHP、Java或者前端JS),就能轻松搞定。

请求地址格式:http(s)://api.thingboot.com/{你的AppID}/device/control/?sign={签名}&ts={时间戳}

这个“签名”是什么?这是为了安全,防止别人随便控制你的设备。算法很简单:第一步:AppSecret 进行MD5加密,得到 Secret_md5第二步:Secret_md5 拼接上当前的 时间戳(ts),得到一个新字符串。第三步: 再把上面这个新字符串进行MD5加密,结果就是 sign

口语化解释:好比你要进门,AppID是你的工号,ts是今天的日期,sign就是用你的密码和日期算出来的一串数字,只有门禁系统认这个数字才让你进。

4. 实战演练:发送“开/关”指令

假设我们现在要 “打开灯” (或者“给门禁通电”)。

请求方法: POST数据格式: JSONBody内容:

  • power1: 代表第1路。

  • 值为 1 代表开,值为 0 代表关

具体场景操作:

  1. 场景A:远程关灯你在公司加班,突然想起家里灯没关。-> 调接口,发送 {“power1”: 0}-> 响应时间大约80-120毫秒,瞬间熄灭

  2. 场景B:远程开门(访客来了)你在工位上摸鱼,同事发消息说被关在门外了。-> 你点一下手机上的“开门”按钮(实际调用了接口)。-> 方案一:发送 {“power1”: 1}(如果是通电开锁),保持1秒后,立刻再发一条 {“power1”: 0}(断电)。-> 方案二:利用设备的“点动模式”。芯步的设备支持一个高级参数 point1,它可以实现“接通一下立刻断开”,模拟按门禁按钮的动作。-> 代码示例:{“point1”: “1000”} (意思是接通1秒后自动断开,正好适合开门)

  3. 场景C:定时控制(下班模式)想实现每天晚上10点自动关灯?-> 你可以自己写定时任务(cron job),到时间调用关灯接口。-> 或者利用芯步设备自带的定时参数。比如发送 {“power1”: 1, “reset1”: 3600000},意思是“现在打开,并在3600秒(1小时)后自动关闭”。

5. 接线与施工的小窍门(纯干货)

既然是解决方案,不能光讲代码,硬件咋接也得说清楚,稍微口语化一点别见外:

  • 对于照明(零火线/单火线)

    • 家里是新装修(有零线):接“零线”、“火线”、“灯控线”。

    • 家里是老房改造(只有火线):买单火版的芯步开关,直接替换,不用凿墙。这点芯步考虑得挺周到

  • 对于门禁(控制电锁)

    • 别直接接220V锁! 大部分门禁锁是12V的。

    • 接线逻辑:智能开关的“输出端”应该串联在门禁电源的“控制信号端”(PUSH或GND)。简单说,就是把开关当作一个“继电器”,用它去导通门禁电源的控制线,而不是直接用220V去烧锁。

6. 总结一下这个方案的好处

  1. 极简接入:不用复杂的MQTT配置,也不需要额外的网关(除非WiFi信号差),HTTP接口对任何后端语言都很友好

  2. 一机两用:特别是针对那种“门外灯+门口锁”的玄关位置,一个86盒就位,省了一个设备的钱和空间。

  3. 状态同步:即使你人在外地,通过接口查询设备状态,能知道门是锁着的还是开着的,灯是亮着还是灭着。

  4. 高性价比:芯步的1路开关价格亲民,相比专业的门禁控制器,这种方案在小微场景(如民宿、办公室)非常划算

简单来说,你只需要三步:

  1. 买个1路智能开关,交给电工按上(接灯或者接门禁电源控制端)。

  2. 在芯步后台注册,拿到AppID、密钥和设备ID。

  3. 在你现有的管理系统(比如微信小程序、PC后台)里,写几行代码,调用一下上面的HTTP地址,完事儿。