CATALOG

共享健身房的痛点是“有设备无管理”——灯光常亮造成浪费,或用户摸黑健身影响体验。AC1智能通断器通过HTTP接口可完美解决:用户扫码即开灯、离开现场时自动关,同时支持分时策略和能耗监测。以下是完整的接入方案。

一、 解决概述

在共享健身房场景中,灯光控制面临两个痛点:一是24小时常亮导致的电力浪费,二是用户在非高峰时段摸黑健身的安全隐患。传统改造需要复杂的布线,成本高且周期长。

芯步 AC1 智能通断器(UNI-TDQ-AC1-10A) 是该场景的最佳选择。它采用 WiFi 直连,无需网关中转,支持通过标准的 HTTP API 进行控制。本方案将指导您如何通过其开放接口,将传统灯光设备无缝接入您的共享健身房 SaaS 平台,实现“扫码亮灯、无人关灯、按需供电”的智能化闭环。

二、 系统设计

核心组件:

  1. AC1 智能通断器:安装在配电箱内,串联在照明回路上,接收云端指令执行开关动作。

  2. 芯步云平台:负责设备连接、状态转发及 API 签名验证。

  3. 开发者服务器:您的业务后端,处理用户鉴权、逻辑判断及向芯步云下发指令。

  4. 用户端(小程序/App):触发控制指令的界面。

业务流程逻辑:

  • 用户扫码:用户进入健身房,扫描设备二维码。

  • 后端鉴权:您的服务器确认用户身份/订单状态。

  • 下发指令:您的服务器构造 HTTP 请求,携带签名(Sign)和时间戳(Ts)向芯步 API 发起控制请求

  • 设备响应:AC1 接收指令,继电器吸合,灯光亮起(约 80-120ms 延迟)

  • 状态闭环:AC1 状态变更后,芯步通过消息推送机制,将“已开启”状态实时同步至您的服务器

三、 技术对接步骤

1. 环境准备与设备配网

  • 获取凭证:登录芯步开发者控制台,获取 AppID 和 AppSecret。这是后续 API 调用的安全凭证。

  • 设备配网:使用官方提供的“批量配网小程序”,将 AC1 设备连接到场地内的 2.4G WiFi 网络。记录下分配给设备的唯一标识符 device ID

2. 接口安全机制(签名算法)

为了防止 API 接口被恶意攻击,芯步采用动态签名验证。您的后端在发起请求前,必须按照以下逻辑计算出 Sign 字段

算法步骤:假设:

  • AppSecret = “abc123”

  • ts = 当前 Unix 时间戳(秒)

  1. 对 AppSecret 进行一次 MD5 加密:secret_md5 = md5(“abc123”)

  2. 拼接字符串:tmp_str = secret_md5 + ts

  3. 对拼接字符串再次进行 MD5 加密:sign = md5(tmp_str)

代码示例(Node.js):

3. 核心控制逻辑

第一种场景:用户开灯(下发命令)当用户需要通过健身房间的灯光时,您的后端需向芯步发送 POST 请求。

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

  • HeadersContent-Type: application/json

  • Body 数据包

  • 逻辑扩展:可结合订单系统,在用户“开始健身”或“开门取电”时触发该指令。

第二种场景:状态实时同步(消息推送)AC1 支持类似微信公众号的被动消息推送机制。您需要在控制台设置一个回调 URL(Webhook)。当设备状态变化时(例如:信号问题导致离线,或物理按键被人按动),芯步云会主动将消息推送到您的服务器。

接收示例:

您的服务器需解析该 JSON,更新数据库中的设备状态,确保 App 上显示与实际灯光同步。

4. 高级功能集成

  • 定时/无人关灯:结合 PIR(人体红外传感器)数据。如果传感器上报 radar_enable 状态为无人且持续 10 分钟,您的服务器自动下发 {“power”: 0} 命令

  • 自定义动作:AC1 支持 point 命令,可实现“点动模式”(如按一下亮 5 秒自动灭),适用于门禁联动或寻物场景

四、 实施注意事项

  1. 额定功率限制:AC1支持10A电流,对应阻性负载(如LED灯)约 2200W。在共享健身房中,若一个回路挂载了大量灯具,需核算总功率,切勿超载

  2. 网络稳定性:设备仅支持 2.4G WiFi。在大型场馆中,需确保该频段信号覆盖无死角。若信号弱,设备会尝试连接预先设定的 5 组备用 WiFi 中信号最强的网络

  3. 私有化部署:若您的项目对数据安全要求比较高(如政府背景的健身房),AC1 支持私有化部署与局域网纯环境运行,所有 MQTT/HTTP 流量仅在您的内网流转

  4. 异常处理:在您的代码逻辑中,必须处理接口超时或返回错误码(如设备离线)的情况,不要无限下发指令,以免对继电器造成不必要的损耗。

五、 总结

通过接入芯步 AC1 智能通断器,您的共享健身房项目可以在一周内实现标准化的 IoT 改造。该方案利用简便的 HTTP 接口大幅降低了开发门槛,同时借助动态签名和状态回调机制保障了商业数据的安全性。最终实现用户无感开灯、运营方降本增效的双赢局面。