CATALOG

芯步的智能墙壁触摸复合开关本身已开放HTTP接口,核心对接工作主要是签名计算和设备命令下发。以下方案按“网络配置→接口对接→业务集成”的顺序展开,可根据实际开发环境直接调用。

解决方案:基于芯步开放接口的无人值守门店照明与门禁集成方案

1. 背景与选型分析

在无人值守场景(如共享自习室、24小时健身房、无人便利店)中,如何低成本实现“人来灯亮、人走断电、远程巡检”是运营的关键。传统的智能照明方案往往依赖昂贵的网关或复杂的协议(如KNX),维护成本高。

本方案选用芯步智能墙壁触摸复合开关(型号:UNI-KG-CM-CK/UNI-KG-CM-KC)。该产品的核心优势在于:直连Wi-Fi,无需网关;同时整合了照明控制和门禁功能,完美匹配单进单出的房间场景。一个设备即可解决“开门授权”和“自动通电”两个痛点。

2. 硬件接线与安装准备

在软件对接前,需完成硬件的物理安装。该设备为标准的86型墙壁开关,支持直接替换传统开关。

  • 强电接线:按照设备标识接入220V交流电。需注意,该设备的负载功率有一定要求:如果控制LED灯,单路不超过300W;若控制传统阻性负载(如白炽灯),单路可达1000W

  • 门禁接线:设备支持接入常开或常闭类型的电磁锁/电插锁。将锁的控制线接入设备背面标注的“门锁”接口,并由设备直接供电控制

  • 网络确认:设备仅支持2.4G Wi-Fi。在安装前,请确保门店该区域有稳定的2.4G信号覆盖

3. 软件对接核心技术流程

芯步采用极简的HTTP API设计,极大降低了开发门槛。对接流程分为三步:设备配网、API签名计算、指令下发。

3.1 设备配网与激活长按开关最左侧按钮6秒,进入配网模式(指示灯快闪)。设备需要通过HTTP接口进行控制,因此需将设备连接到互联网。配置完成后,在芯步开发者后台获取该设备的唯一标识符 Device ID,后续所有指令均依赖此ID。

3.2 API签名与请求构造为了保障安全,每次请求需携带签名。官方定义规则如下

  • 请求地址http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

  • 核心参数

    • AppId: 平台生成的应用ID。

    • ts: Unix时间戳(精确到秒)。

    • sign: 签名,计算公式为 md5( md5(开发者密码) + “.” + ts )

  • 请求Body (JSON): 这是一个POST请求,Body中需包含设备ID和具体的指令集。

3.3 指令集详解(关键)该复合开关内部包含两路控制逻辑:一路控制,一路控制

  • 控制“出门开关”(门锁)在无人值守场景中,用户在小程序点击“开门”,系统需模拟按下“出门开关”的动作。

    • 接口指令{“device”: 设备ID, “order”:{“power2”: 1}} (假设继电器2连接门锁,1代表触发)

    • 注意:该设备默认支持“点动模式”,即接通几秒后自动断开,这对于给电锁瞬间通电开锁非常关键。如果默认不是点动模式,可通过指令或后台配置

  • 控制“照明”(开/关灯)结合“有人探测”或“时段策略”控制灯光。

    • 开灯{“device”: 设备ID, “order”:{“power1”: 1}}

    • 关灯{“device”: 设备ID, “order”:{“power1”: 0}}

  • 获取设备状态(巡检)配合传感器或定时任务,查询设备当前是灯亮还是灯灭,用于后台监控。

4. 无人值守业务逻辑落地

将上述接口嵌入您的业务系统(如小程序后端、Python脚本或PHP管理后台),典型流程如下:

第一种场景:用户订房/进门流程

  1. 用户在微信小程序下单并支付。

  2. 系统调用API:向指定房间的门锁继电器发送“点动开锁”指令。

  3. 门锁瞬间弹开,用户进入房间。

  4. 后续动作(自动通电):在开锁的同时,通过API查询或直接调用照明继电器状态,如果原先是关闭的,立刻发送“开灯”指令,营造舒适环境

第二种场景:人体感应联动(可选)单纯依赖触摸开关属于被动控制。若要实现真正的“无接触”和节能,配合芯步的人体存在传感器(如雷达传感器)。

  • 逻辑:传感器探测到“无人”状态且持续超过15分钟。

  • 调用:后端接收到传感器的回调消息,判断房间订单状态,若为空闲或超时,则调用复合开关接口关闭灯光和排风扇

第三种场景:定时/强制断电无人值守最怕“忘记关灯”。

  • 定时任务:部署一个Cron Job脚本,每天凌晨2:00向所有未关灯的闲置房间发送 {“power1”: 0} 指令。

  • 强制控制:运营人员在后台管理页面点击“关闭”,直接下发HTTP请求,无论物理按键此时处于什么状态,都能强制覆盖。

5. 异常处理与优化

  • 断网容错:该设备即使Wi-Fi断开,物理触摸开关功能依然可用,不影响现场手动操作。但远程控制会失效。在合同中提示商家或用户,确保路由器稳定,并将设备设置为静态IP或MAC地址绑定以增强稳定性

  • 私有化部署(安全要求高):如果您的项目对数据安全极为敏感,芯步支持私有化部署。您可以将API请求指向局域网内的自建服务器,设备完全脱离外网运行,适合政府项目或高端保密空间

  • 同步状态校验:由于是WiFi设备,受信号影响可能会有毫秒级延迟,在发指令后延迟200ms再查询一次状态,确保执行成功

6. 总结

通过接入芯步的 “HTTP API + WiFi直连” 方案,您无需编写复杂的物联网底层驱动,只需在现有业务代码(PHP/Java/Python/Node.js)中增加几行Post请求代码,就能实现“智能触摸墙壁复合开关”的深度集成。这不仅实现了门禁与灯光的硬件二合一,节省了布线成本,更通过标准化的接口逻辑,让您的无人门店系统具备了商业化的闭环能力