小型商铺的照明管理看似简单,但痛点明确:人走忘关灯、凌晨需留安保照明、无客时段常亮浪费电。芯步的智能墙壁复合开关正是针对这类场景的轻量化方案——无需网关、HTTP接口直控、支持私有化部署。以下是完整的集成方案。
一、 解决概述
本方案的核心是采用 芯步 智能墙壁复合开关,将其接入商铺现有的照明线路中,并通过调用其免费的 HTTP 开放接口,将照明控制集成到您已有的店铺管理系统(如收银系统、小程序或简单的 Web 管理后台)中。
方案优势:
极简改造:无需更换原有灯具,标准 86 盒直接替换传统开关,无需额外网关(直连 WiFi)。
开发友好:提供标准 HTTP API,支持任何编程语言,签名机制简单,且开放平台永久免费 。
场景贴合:支持“点动”(先通后断)、“状态保持”等高级功能,非常适合商铺的迎宾模式、打烊巡检等场景 。
二、 硬件选型与部署
针对“小型商铺”和“1路照明”的场景,选用 芯步 智能墙壁复合开关(1路/2路)。
选型说明:尽管商铺当前只需控制 1 路灯光,但考虑到未来扩展(如增加门头灯、灯带),选用 2路版本,成本增加极低,但为后期预留了扩展空间。
安装部署
断电安装:由电工关闭总闸,拆除原有开关。
接线:零线接入 N 端口,火线接入 L 端口,灯的控制线接入 L1/L2 端口。
配网:下载“芯步”或对应控制台 App,长按开关配网键,输入店铺 2.4G WiFi 密码完成配置 。
三、 系统集成架构
本方案不依赖复杂的云平台,采用 “店铺管理端 —— 芯步云/私有化服务器 —— 智能开关” 的短链路架构。
设备层:智能开关通过 WiFi 连接互联网。
开放平台层:芯步提供 API 网关,负责鉴权与指令转发。
业务层:您的后端服务器通过 HTTP 请求调用接口。
(若商铺内网安全要求高,可选择私有化部署方案,将消息服务器部署在店铺本地局域网内 )
四、 接口集成开发指南
这是集成的核心部分。您需要将以下逻辑封装在您的后端服务中。
1. 准备工作
注册开发者账号:在芯步官网注册账号。
获取凭证:登录工作台,获取 AppID(开发者ID) 和 AppSecret(开发者密码)。
获取设备ID:在控制台查看已配网成功的开关设备ID(Device ID)。
2. API 调用机制
所有接口调用都基于 HTTP POST 请求,核心在于 签名(Sign)计算,以防止接口被恶意篡改。
请求地址
https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}签名算法
sign = md5( md5(AppSecret) + ts )。注意:ts 为当前 Unix 时间戳(秒),需将 AppSecret 先 MD5 一次,拼接时间戳后再整体 MD5 一次。
3. 业务逻辑与代码示例
对于“小型商铺灯光管理”,您主要需要实现以下三个业务动作:
第一种场景:店员交接班 / 日常开关灯通过收银系统界面点击“开灯/关灯”,调用标准通断指令。
命令
{"power1": 1}(开) /{"power1": 0}(关) 。
第二种场景:打烊后的“寻店模式”或“延时关闭”店员离店后,需要灯光延时 30 秒关闭以便锁门,或者需要灯光闪烁一下提示清场。
先通后断(点动):发送
{"point1": "30000"}(通电 30 秒后自动断电)。先断后通(复位):发送
{"reset1": "5000"}(断电 5 秒后自动恢复通电,常用于异常重启)。
第三种场景:集成到现有系统(伪代码实现)假设您使用 Python 或 Java 开发店铺后端,逻辑如下:
Python 示例(基于 requests 库):
五、 两个特色增值功能
为了让您的商铺管理更智能,芯步的接口还支持以下特性:
状态锁定与保持(防误触)对于店铺的招牌灯,您不希望员工下班时误关。可以通过接口下发
{"power1":{"keep":"1","revert":"30"}}。这能实现:强制开启招牌灯,即使有人手动按下开关关闭,灯光也会在 30秒后自动恢复开启。多设备批量控制如果您的店铺扩张到了 2 个门面,或者需要同时控制灯光和排风扇。接口支持在一个请求中传入多个设备ID,例如
device="1878,1879",实现一键全关 。
六、 总结
通过将芯步的 1路/2路智能墙壁复合开关 集成到项目中,小型商铺能以极低的改造成本实现照明的数字化管理。核心集成工作量仅为:
替换原有物理开关。
在后端实现上述约 30 行的 HTTP 请求代码。
在店铺管理后台添加一个“关灯”按钮。
这种集成方式不仅解决了“长明灯”的电费浪费问题,更为商铺未来的全屋智能(如:人来灯亮、环境联动)打下了坚实的基础。