CATALOG

门店门禁改造有个常见痛点:想保留原有的物理开关,又要实现远程控制和系统集成。芯步的“双模式门禁控制开关”其实就是智能墙壁出门开关,支持断电开锁/通电上锁两种模式,关键是通过HTTP接口开放控制。下面直接讲怎么接、怎么调、怎么集成到你自己的项目里。

一、 这玩意儿是什么?(先把概念对齐)

你别看它名字叫“双模式门禁控制开关”,听着挺绕口,其实你就把它理解成一个装在墙上的、能联网的继电器

它长得很像普通的86型墙壁开关(就是家里灯的开关那种样子),但它的屁股后面接的不是灯,而是门锁(电磁锁、电插锁都行)。

所谓的“双模式”,指的是它兼容两种锁:

  1. 断电开锁(通电上锁):平时通电锁门,断电开门。消防要求高的地方常用。

  2. 断电上锁(通电开锁):平时不通电,通电才开门。

这玩意儿的灵魂在于: 它自带WiFi,支持HTTP接口。不管你是谁,只要往它的API地址发个请求,它“哒”的一声就吸合或断开,门就开了。

二、 改造前的准备(需要买什么?)

在动手写代码之前,硬件上你得准备这几样:

  1. 芯步的智能墙壁出门开关:这是核心。

  2. 电插锁或电磁锁:根据你的门类型买。玻璃门用电磁锁,木门/防火门用电插锁。

  3. 12V电源:给锁供电。

  4. 导线和工具:螺丝刀、剥线钳。

简单画个接线逻辑(脑补一下):电源的12V出来,先接到智能开关的输入端。智能开关的输出端,再接到门锁上。物理开关的面板控制这个通断,云端的接口也控制这个通断。

三、 核心环节:如何拿到控制权?(也就是对接接口)

这是你要看的重点。芯步的设备牛逼之处在于,它不跟你玩什么封闭的私有协议,直接用HTTP。这意味着不管你后端是Java、Python,还是前端是JavaScript,甚至是Shell脚本,都能干它

第1步:让设备上网

买回来的设备,先给它配网。一般都是用它的官方App或者小程序,把WiFi密码告诉它。注意:它一般只支持2.4G WiFi。这一步搞定了,你就能在它后台看到一个“设备ID”,那是一串数字,记下来,那是你开门的“钥匙”

第2步:搞懂它的“开锁密码”(API签名)

芯步的接口为了安全,不是随便谁都能开的,需要鉴权。公式大概是这样的:你需要把 AppSecret(你的钥匙) + 时间戳 做一个MD5加密,放到请求头里听起来复杂?其实就是几个拼接步骤,后端工程师写个工具函数就行。一般官网控制台直接能生成 signts

第3步:看看怎么“发指令”

它的地址一般长得像这样(示例):https://api.thingboot.com/{你的AppID}/device/control/?sign={计算出的签名}&ts={当前时间戳}

请求方式:POST请求体

order参数解释

  • {"power":"1"}:就是让开关接通。这时候锁通电(或者断电,看你怎么接线),门就开了。

  • {"power":"0"}:就是让开关断开。这时候门就锁上了。

  • {"reset":"3000"}:这个更智能,意思是“先接通,3秒(3000毫秒)后自动断开”。这就是典型的“点动”模式,适合门禁,按一下开几秒自动关,防止忘锁

第4步:实战演练(用curl命令测试)

你不用急着写代码,先在电脑终端(CMD或者Bash)里用curl命令试一下,看门会不会动。

如果门“咔哒”一声响了,说明HTTP通道打通了,剩下的就是把这串逻辑复制到你的项目里去

四、 集成到自己的项目中(三种常见姿势)

假设你现在已经有了一个管理系统(比如一个仓库管理系统,或者一个共享办公室的预订系统),你想让管理员在网页上点一下按钮就开门。

方案A:简单粗暴的“按钮开门”

  1. 在你的后台管理界面,加一个按钮,叫“远程开门”。

  2. 给这个按钮绑定一个点击事件,去请求你自家的后端接口。

  3. 你自己的后端收到请求后,不要直接在代码里写死上述的API调用,复用你写的“签名工具函数”和“HTTP请求库”去call芯步的云端。

  4. 收到“success”后,前端弹个窗:“门已开”。

方案B:自动化联动比如说:有人在小程序上付了款,才能开门。

  1. 支付回调成功后,触发一个事件。

  2. 这个事件调用上述的开门接口。

  3. order 参数稍微变一下:如果是一次性访客,用 {"point":"10000"}(先通后断,10秒后自动关门)。

  4. 完美实现付费即开门的逻辑。

方案C:纯局域网(私有化)如果你的项目涉密高,不想走外网。这些设备支持私有化部署。你可以搭一个本地服务器,设备WiFi连到同一个局域网,请求直接走内网IP,不经过外网,速度更快也更安全

五、 避坑指南(过来人的经验)

在写方案的时候,这几个点直接写进去,以后少踩坑:

  1. 关于“双模式”的跳线:在安装的时候,一定要根据你的锁类型,去拨一下开关上的跳线帽(或者拨码开关)。如果模式搞反了,会出现“按开门锁反而锁死”的情况

  2. 关于“关门”的逻辑:多用 reset 命令。很多人只发“开锁”指令,忘了发“关锁”指令。用 reset 命令,你只管让它开,到点它自己关,省心。

  3. 网络要稳:这东西是靠WiFi的,虽然现在WiFi很稳定,但如果仓库角落没信号,啥都白搭。先测一下信号强度再装盒子里。

  4. 安全性:千万不要在前端网页直接暴露 AppSecret(开发者密码)和签名算法。一定要在你的后端服务器中转请求,否则别人抓个包,能把你整个公司的门都刷开。

六、 总结一下这个解决方案

通过芯步的双模式开关改造门店门禁,其实就三步:

  1. 物理替换:把旧开关拆了,换上这个智能开关,接好锁和电源。

  2. 设备上网:配网,拿到设备ID。

  3. API集成:用标准的HTTP POST请求,配合签名鉴权,在你的项目里调用开门/关门命令。

这样一来,你的门禁就不再是一个孤立的硬件了,它变成了你整个项目中的一个可控资源,跟数据库里的一个字段一样可控。