CATALOG

共享健身房的痛点是“人走灯亮”的能源浪费和人工巡检的低效。本文基于芯步AC4-30A智能通断器的开放接口,提供一套完整的灯光设备对接方案。该设备支持HTTP接口远程控制,功率高达6600W,无需网关即可直连WiFi,适合低成本、快速落地的智能化改造需求

1. 背景与需求分析

在共享健身房/自助健身房场景中,灯光控制面临三大痛点:

  • 能源浪费:用户离开后忘记关灯,导致全天24小时照明。

  • 管理滞后:依赖人工巡检或定时器,无法根据实际占用情况动态调整。

  • 改造成本:许多商用LED灯具功率较大,普通智能插座无法承载(易烧毁)。

目标:通过集成芯步 智能通断器 AC4-30A,实现健身房的灯光远程控制、无人自动关灯以及与预约系统的联动。

2. 硬件选型与技术特性

UNI-TDQ-AC4-30A 是该方案的核心执行单元。

2.1 核心参数

  • 负载能力:MAX 30A / 6600W(阻性负载)。

    • 优势:无需额外接触器,可直接控制大功率场地灯、射灯组或排气扇

  • 网络连接:WiFi 2.4GHz(无需网关,直连路由器)

  • 工作电压:AC 85-265V(宽电压,适应市电波动)。

2.2 接口开放能力

该设备开放了标准的 HTTP API,这意味着我们可以用任何后端语言(Java, Python, Go, PHP)或前端小程序直接调用。

3. 对接设计

本方案采用 “云云对接”“端到云” 的简易架构,避免复杂的硬件嵌入式开发。

  • 设备层:AC4-30A 通断器嵌入健身房配电箱,接在照明回路前端。

  • 网络层:设备连接场地 WiFi(支持设置5组备用WiFi,防止网络波动)

  • 云平台层:芯步开放平台(负责设备连接与指令转发)。

  • 应用层:你的共享健身房 SaaS / 小程序后端。

4. 详细对接步骤

4.1 环境准备与凭证获取

  1. 登录芯步开放平台控制台。

  2. 创建应用,获取 AppIDAppSecret(开发者密码)。

  3. 将 AC4-30A 设备添加至平台,获取唯一标识 Device ID

4.2 接口签名机制(鉴权)

所有API调用需携带签名 sign 和时间戳 ts,确保安全性。签名算法如下

sign = md5( md5(AppSecret) + ts )

注意:ts 为秒级时间戳(10位数字)。

4.3 业务逻辑对接

第一种场景:用户扫码开灯(即时控制)

流程:用户通过小程序下单 -> 服务器校验权限 -> 调用开灯接口。

API 调用示例

  • URLhttps://api.thingboot.com/{AppID}/device/control/

  • Method: POST

  • 参数

    • ts: 当前时间戳

    • sign: 计算出的签名

    • deviceId: 设备的ID

    • power1(开启) / 0(关闭)

代码逻辑(伪代码)

第二种场景:人走灯灭与订单关联

逻辑:用户点击“结束运动”或订单超时自动关灯。

  • 监听订单状态变更为“已结束/超时”,调用上述 API 传入 power=0

第三种场景:定时巡检与异常关断

逻辑:为了防止用户下单后忘记点击结束导致长明灯,设置定时任务。

  • 设定每天晚上 23:00,系统自动调用 API 查询设备状态,或直接下发关灯指令进行“复位”。

5. 高级功能:设备私有化与局域网控制

对于对响应速度和数据安全要求比较高的场景,AC4-30A 支持局域网控制(LAN Mode)。

  • 适用场景:健身房网络稳定,且无需经过外网中转。

  • 原理:设备与服务器处于同一局域网时,可不经云路由,直接在局域网内下发 UDP 或 HTTP 指令。

  • 优势无延迟,即使外网断开,内部系统依然可控。实现方式参考平台“局域网开发文档”将API请求域名解析到设备内网IP。

6. 注意事项与最佳实践

6.1 额定功率限制

虽然设备标称 30A (6600W),但在共享健身房场景中,如果是LED灯节能灯,负载功率需降至 < 1200W。因为容性负载启动电流大,容易损坏继电器触点:如果单路灯光总功率超过1000W,通过AC4-30A控制交流接触器,由接触器带动大功率灯具,以延长设备寿命。

6.2 网络配置

设备仅支持 2.4G WiFi

  • 如果场地使用5G/2.4G混合路由器,请确保手机配网时处于2.4G频段,或开启双频分离。

  • 失败重试机制:接口调用时,请请一定要处理返回的错误码(如 5006 签名错误, 5008 IP白名单问题)

6.3 用户体验优化

  • 物理按键屏蔽:用户通常无权触碰配电箱开关。可通过接口设置,屏蔽设备上的物理按钮,使其仅接受远程指令,防止用户手动关闭后系统无法开启

  • 状态同步:在用户小程序端实时显示“灯光状态”,如果设备掉线,及时提醒场地管理员。

7. 总结

通过对接芯步 AC4-30A,开发者可以在 1天内 完成从注册到代码调用的完整流程。该方案解决了共享健身房高功率设备控制的难点,且 HTTP 接口的通用性使得它能够无缝集成到现有的会员管理系统中,是实现无人值守运营的关键基础设施。