CATALOG

“门店灯光门禁联动控制”是很多实体店(特别是无人店、工作室、连锁商铺)刚需的场景。芯步的这款 2路智能墙壁开关 是WiFi直连、带HTTP接口的产品,非常适合做这种集成。

下面这份方案主要面向开发者或项目集成负责人,聊一聊怎么把这个硬件“软件化”。

1. 这块“开关”到底是什么角色?

首先得搞清楚这个硬件是啥。咱们说的这个“芯步 2路智能墙壁开关”,从外观上看,就是个标准86型的墙壁开关(跟你家里墙上那个一样大),直接换掉原来的开关就行。

但它牛就牛在肚子里的“脑子”。它里面有两个“通道”(也就是所谓的“2路”)。

  • 第1路(通常是左边或标1):我们用来控制灯光。比如门店大厅的主照明。

  • 第2路(右边或标2):我们用来控制门锁。注意,它不是直接去捅锁眼,而是相当于一个“电子开关”,串联到门禁电源或者电磁锁的控制线上,扮演一个“远程手指”的角色,模拟按了一下开门键。

简单说,这一个小开关,既管灯又管门,帮你省了一套专门的门禁控制器的钱

2. 它凭什么能被你的软件“使唤”?

要把这个开关集成到你自己做的软件里(不管是小程序、App还是后台管理系统),依赖的就是它的 HTTP API接口

这玩意儿是个啥意思?你就理解成:这个开关在Wi-Fi网络里有个专属的“网址”。你的软件只要往这个“网址”发一条特定的消息(指令),它就得乖乖听话。

它支持局域网(纯内网控制,响应快、不要钱)和公网(在外地控制门店)两种模式。这块开关通电后连上你店里的2.4G Wi-Fi,你的服务器就能通过云端给它发命令了。

3. 动手前,先搞清楚命令格式

在写代码之前,咱们得知道怎么“叫”它。芯步的接口设计得比较直接,核心就是构造一个 HTTP POST 请求。

请求地址大概长这样:https://api.thingboot.com/{你的AppID}/device/control/?sign={签名}&ts={时间戳}

别看这一长串,关键的其实就是 Body 里的参数:你需要发给它一个 JSON 格式的数据包,告诉它“谁是目标”和“要干嘛”。

核心数据结构示例:

这里有个细节:device 是硬件的唯一ID,power1/power2 分别对应灯和门

4. 实战“灯光+门禁”联动编程

假设我们现在写代码,实现“管理员在手机上点一下‘开门’并自动亮灯”的逻辑。

我们先封装一个通用的控制函数(这里用伪代码/JavaScript逻辑示意,核心是看数据是怎么拼的):

第一种场景:员工上班开门

需求:员工到店,扫码后,门打开,灯自动亮,不用摸黑去找开关。

代码实现:扫描枪或小程序识别身份后,调用 controlSwitch(true, true)

  • power1"1" -> 灯亮。

  • power2"1" -> 门锁通电(打开)。

第二种场景:下班关灯锁门

需求:员工离店,点击“关门”,灯灭,门锁上。

代码实现:调用 controlSwitch(false, false)

  • power1"0" -> 灯灭。

  • power2"0" -> 门锁断电(闭合)。

第三种场景:利用“点动模式”开锁

需求:电磁门锁如果长时间通电 power2:1 容易烧线圈。它只需要通电0.5秒,听到“滴”一声门开了就要立刻断电。

机智方案:不用你自己写定时器(网络延迟如果卡了就尴尬了)。芯步的开关支持 “先通后断” 指令

如果你用 order 里的 point2 代替 power2

这样既安全又专业,不用后台费劲去维护状态。

5. 安装布线的“坑”与“路”

硬件集成除了写代码,还有现场的活,有几点需要注意:

  1. 分清零火线:老房子如果开关盒里没有零线,买的时候要选“单火版”;新装修选“零火版”更稳定。买错了装不上或者会闪灯。

  2. 门锁接线:如果你不是电工,让专业人士操作。思路就是:把这个开关的第2路输出线,串联到门禁电源的“控制端”或者锁的回路里。它就是一个 “常开触点” ,你发“开”指令,触点闭合,门就通了。

  3. Wi-Fi信号:这玩意儿走2.4G Wi-Fi,虽然不用网关很方便,但如果你把开关装在金属的配电箱里,信号大概率会屏蔽掉,一定要让它露出来或者确认信号满格

6. 总结一下这个方案的节奏

如果你想把这个方案落地到你的项目里,分三步走就行:

  1. 硬件上墙:买个“2路智能墙壁开关”,让电工装好,接好灯线、门锁线,连上Wi-Fi。

  2. 注册拿钥匙:在芯步后台注册账号,把设备加到你的名下,拿到 AppIDDeviceID 这几把“钥匙”。

  3. 写代码:按照上面的 HTTP POST 格式,在你软件里封装好开关灯和开关门的函数。

这么一来,你的软件就能彻底控制门店的物理世界了,一个开关搞定光与门,既省了单独买门禁控制器的钱,也让员工少走几步路。