CATALOG

共享场所的智能化改造常踩两个坑:一是用户忘记关灯导致电费浪费,二是系统过于复杂反而难用。芯步这款86型墙壁开关的开放接口,恰好能通过“HTTP API下发指令+状态保持功能”同时解决这两个问题——既实现了远程控制,又能在用户手动操作后自动复位,非常适合按使用时长计费的共享场景。

1. 背景与分析

在共享自习室、共享茶室、共享棋牌室或共享公寓的运营中,“1路”通常指控制室内的主照明。通过将这款86型墙壁开关(UNI-KG-1)集成到项目中,主要解决三个痛点:

  • 能源浪费:用户离开后忘记关灯,导致电费持续损耗。

  • 计费不透明:传统设备只能通过总闸控制,无法与订单状态联动。

  • 改造难度大:施工方担心破坏原有墙面布线。

产品核心优势:该产品支持标准86型底盒安装,无需重新布线,直接替换传统开关;同时提供开放HTTP API接口,支持Wi-Fi 2.4GHz连接,且具备“状态保持”功能(用户手动按键后数秒自动复原),非常适合商用计费场景

2. 系统架构

本项目采用“端-云-管”的一体化架构。

  • 感知/执行层:部署芯步1路智能墙壁开关。控制灯具或特定插座。即使在网络断开的情况下,用户仍可通过物理按键正常开关灯,不影响基础使用

  • 网络传输层:利用设备自带的Wi-Fi模块,通过路由器直连互联网。数据交互协议支持HTTP(请求/响应)和MQTT(发布/订阅)两种方式

  • 业务应用层:芯步开放平台(负责设备接入、指令转发)以及共享场所的SaaS系统(负责订单逻辑、计费逻辑)。

3. 集成开发流程

要将该设备集成到现有的共享项目中,开发人员需按以下步骤进行对接:

3.1 设备配网与注册

开关上电后,需通过AP配网模式将其连接到场所的Wi-Fi路由器。设备成功联网后,会在芯步控制台激活,并生成唯一的 Device ID (设备ID)。该ID是后续API控制的唯一标识。

3.2 API 对接规范

芯步的接口采用 Sign (签名) 认证 方式,无需复杂的OAuth流程,适合轻量化集成。

签名计算规则需先对 AppSecret 进行一次MD5加密,得到字符串 S1;然后将 S1 拼接上时间戳 ts 得到字符串 S2;再对 S2 进行一次MD5加密得到最终的 signsign = md5(md5(AppSecret) + ts)

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

  • 请求方法:POST

  • Content-Type:application/json

3.3 业务逻辑实现

在共享场所的场景下,核心逻辑围绕 “订单开始”“订单结束” 构建。

业务场景逻辑描述API指令示例 (order参数)
用户下单/开门订单生效,系统应自动通电。注意:开启前先将状态复位,防止残留状态。{"power1": 1} (1代表开启线路1)
使用中/物理干扰用户手动按键可能误关设备。利用 状态保持 功能,强制设备保持开启或数秒后自复位。{"power1": {"keep": "1", "revert": "3"}} (即使用户手动关闭,3秒后自动恢复开启)
用户退单/超时订单结束,强制关闭设备,避免浪费。{"power1": 0}
临时通风/清扫管理员模式,定时开启关闭。{"point1": "3000"} (先通后断,3秒后自动关闭)

4. 技术特性详解

4.1 “状态保持”功能的应用(场景关键点)

共享场所最大的问题是用户捣乱或误触。普通智能开关被物理按下就会断电,导致订单未结束但灯已灭。

  • 解决方案:芯步的开关支持 “状态锁定/保持” 模式。

  • 具体配置:下发指令 {"power1":{"keep":"1","revert":"3"}} 后,开关进入锁定状态。如果用户按墙壁按键关灯,系统会在3秒(可自定义秒数)后自动把灯再次打开。这就确保了在订单有效期内,照明始终服务于用户,或者始终保持按需计费的连续性

4.2 异步消息推送(状态同步)

虽然HTTP请求可以下发指令,但设备状态的上报(如用户手动按键关机)需要通过消息推送机制。

  • 配置:在芯步控制台设置“API接收地址”。

  • 数据用途:当用户物理操作开关时,平台会向你的服务器推送设备当前状态。服务器可以记录下这个动作,一方面用于能耗统计,另一方面可作为“退单前提醒”的触发条件(如用户试图关灯表示准备离开)。

5. 落地施工和需要注意的点

  • 负载匹配

    • 普通白炽灯/节能灯:单路不超过300W。

    • LED灯:由于LED启动电流较大且易导致闪烁,单路负载控制在150W以内,同时确保线路中连接了标配的电容(产品包装内含)以消除鬼火

  • 网络环境

    • 开关仅支持2.4GHz Wi-Fi,不支持5G频段。在部署时,请一定要确保AP热点名称(SSID)不包含中文或特殊字符。

  • 零火线要求

    • 国内常规86型开关(非智能)多为单火线控制。芯步这款产品需接入零线。在集成前,需勘察现场底盒内是否有零线(通常为蓝色线)。若无零线,需选用特定的“单火取电”版本或进行电路改造。

6. 总结

将芯步的1路86型墙壁开关集成到共享场所项目中,不仅仅是一次硬件安装,更是一次运营策略的落地。

通过 API接口 将该设备与现有的订单系统打通,结合 状态保持 这一特色逻辑,可以完美解决“人走忘关”和“用户私关”的运营痛点。这种集成方案成本低(利用现有Wi-Fi网络)、实施快(标准86盒替换)、运维稳(断网仍可手动),是共享经济落地硬件控制的首选方案之一。