共享健身房强调自助体验和氛围营造,灯光控制的难点在于:如何在无需改造现有线路的前提下,让云端能可靠地控制低压灯带、跑马灯等设备的通断。以下方案基于芯步的开放接口与继电器硬件,实现低成本、可扩展的闭环控制。
1. 背景与需求分析
在共享健身房场景中,氛围灯不仅是照明工具,更是引导用户、营造运动氛围和实现节能的关键。不同于传统家用,共享健身房具有“无人值守、按次使用、分区控制”的特点。
痛点:
无法感知状态: 传统智能插座只能断网控制,无法实时反馈灯带的真实通断状态,导致后台显示与现场实际不符。
低压驱动难匹配: 健身房多使用 12V 或 24V 的 LED 灯带(低压直流),市面上很多智能开关是基于 220V 交流设计的,直控高压端可能损坏低压变压器,且不够精细。
联动逻辑单一: 需要根据雷达传感器(探测有人/无人)、音乐节奏或时段自动切换,而非单纯的手动开关。
解决目标:利用 芯步 的开放接口能力,结合其生态内的 雷达传感器 与 继电器控制模块,实现对低压直流灯带(12V/24V)的云端通断控制、状态实时反馈及场景联动。
2. 整体设计
本方案采用“端-云-管”的轻量级架构,复用共享健身房现有的 4G/Wi-Fi 网络环境。
感知与控制层
芯步 智能继电器模块:集成在灯带的低压供电线路上。
芯步 人体存在雷达传感器:用于检测对应健身仓/区域是否有人。
负载设备:低压直流灯带(24V)、RGB 灯带控制器。
网络传输层
设备通过 Zigbee/Wi-Fi 接入网关,或通过 4G 直连。
基于 HTTP/HTTPS 协议与芯步云通信。
平台与应用层
芯步开放平台:负责设备状态上报、指令下发。
共享健身房 SaaS 后台:接收 Webhook 推送,执行业务逻辑(如:用户扫码开锁成功后,自动开灯)。
运营商后台:通过调用芯步的 API 接口进行批量控制。
3. 设备选型与接口对接方案
本方案重点对接两类硬件:
3.1 低压直流负载控制核心
控制对象是 12V/24V LED 灯带。由于灯带是感性/阻性负载,且电压较低,直接使用交流继电器容易产生拉弧或接触电阻过大发热。
推荐方案: 使用芯步生态中的 “大电流直流继电器模块” 或 “MOSFET 通断模块”(内置在智能控制器中)。
接口对接逻辑:芯步的控制器通常提供“线路 (power)”控制接口。根据开放平台文档,控制继电器闭合/断开的指令格式如下
请求地址:
http(s)://api.thingboot.com/{AppId}/device/control/指令示例(开灯)
指令示例(关灯)
电路设计关键在于:将 220V 接入智能继电器模块的输入端,但不直接接灯带。220V 经过模块内置的恒压电源转换为 12V/24V,或者模块外接电源适配器,利用继电器的触点控制直流回路的通断。
3.2 有人/无人状态感知
为了实现“人来灯亮,人走灯灭”的极致节能,必须依赖传感器。
设备: 芯步智能人体存在雷达传感器(吸顶式)。
特点: 相较于普通红外,雷达传感器能检测微动(如正在撸铁但动作幅度小的人),防止“误关灯”。
数据上报处理:当传感器检测到状态变化时,会自动向您的服务器推送数据。
接收路径配置:在芯步控制台配置您的
Webhook URL。接收数据示例
处理逻辑:您的服务器收到
value:true后,立即调用上述控制接口,向继电器模块下发power:1指令。
4. 业务逻辑实现
以下是针对“共享健身房”场景的几个典型逻辑流程:
第一种场景:用户扫码启用 + 自动亮灯(静态控制)
用户通过小程序扫描健身仓二维码。
小程序调用业务后台 API 完成开锁。
业务后台 调用芯步开放接口
device/control下发power:1给对应的灯控设备。预期效果:健身仓内灯带亮起,营造迎宾氛围。
容错设计:下发指令后,调用查询接口获取设备最新状态,若返回
power:0(未开启),则重试一次,防止因网络抖动导致用户摸黑。
第二种场景:节能模式联动(自动控制)
雷达传感器 检测到区域持续 10 分钟为“无人”状态。
传感器通过 HTTP 推送
occupancy:false到业务后台。业务后台执行逻辑:先下发
power:0关闭主照明灯带。闭环验证:系统读取设备的最后上报数据,确认
power状态为0,记录本次节能日志。如果灯具老化导致卡死(电流异常),平台可触发告警通知运维。
第三种场景:动态氛围(高频PWM调光)
如果需求更高级(如动感单车跟随音乐律动),单纯的继电器通断不够用。此时需要在芯步生态中选用 PWM调光模块。
由于芯步开放接口极其灵活,支持任意自定义命令。对于调光模块,order 字段可以包含亮度参数:
指令
{"dimming": 80}(设置亮度80%)实现:设备端 MCU 解析这个命令后,输出对应占空比的 PWM 波,控制 MOSFET 管高速通断直流电,实现无极调光。
5. 技术细节
5.1 低压直流控制的特殊处理
电弧抑制:直流继电器关断时比交流更容易产生电弧。方案要求控制模块内部必须并联 续流二极管 或 RC 吸收电路,保护继电器触点,防止其粘连 。
电压适配:确认灯具是恒压型(12V/24V)还是恒流型。本方案针对恒压型灯带最简便;若为恒流型,需控制驱动器的 EN 使能脚,而非直接切断主线。
5.2 通信延时优化
文档显示接口响应时间在 80-120ms。为了提升用户体验:
在本地局域网部署私有化服务器(芯步支持私有化部署),通过局域网 IP 直接控制设备,延时可降至 10ms 以内,彻底杜绝“按了开关灯没反应”的迟滞感。
5.3 配网与部署
在规模化部署中,可采用 “识别转发” 技术
通过快速通断 AC 开关特定的次数(如快按 5 次),由电源内的 MCU 检测到该序列,自动转换成配网指令广播给所有并联在直流母线上的灯具,实现一键批量配网,免去每盏灯单独蓝牙配网的繁琐。
6. 数据交互时序图 (Mermaid)
为了更直观地展示控制流,以下是用户扫码开灯的完整数据流:
sequenceDiagram
participant User as 用户小程序
participant Biz_Cloud as 共享SaaS后台
participant YoYo_Cloud as 芯步开放平台
participant Gateway as 智能网关/4G
participant Device as 直流继电器模块
participant Lamp as 12V/24V氛围灯带
User->>Biz_Cloud: 1. 扫码开锁成功
Biz_Cloud->>YoYo_Cloud: 2. POST /device/control (power=1)
Note over YoYo_Cloud: 鉴权(Sign/AppId/Ts)
YoYo_Cloud->>Gateway: 3. 透传下行指令
Gateway->>Device: 4. 无线射频/Zigbee信号
Device->>Lamp: 5. 继电器吸合 (导通直流回路)
Lamp-->>Device: 6. 灯带亮起 (状态改变)
Device->>Gateway: 7. 上报当前状态 (power=1)
Gateway->>YoYo_Cloud: 8. 状态上报
YoYo_Cloud->>Biz_Cloud: 9. Webhook 推送状态更新
Biz_Cloud->>User: 10. 显示"已启动",计时开始7. 总结
本方案通过利用芯步 API 中的 power 指令 与 传感器事件上报,构建了一个高可靠的低压直流负载控制闭环。
对于开发者:无需关心复杂的无线射频协议,通过简单的 HTTP POST 请求即可完成对 12V/24V 灯带的通断控制。
对于运营商:实现了“有人则亮、无人则熄”的精细化管理,同时解决了低压灯带在大电流工况下的安全通断问题。
扩展性:该接口同样适用于控制共享健身房的其他低压设备,如香薰机、除湿机等。