CATALOG

这是一份关于“共享球场灯光电源控制”的解决方案。结合芯步的 AC1-10A 智能通断器,我帮你梳理了整个对接思路。我会尽量写得口语化、接地气一点,方便你直接拿去跟开发团队沟通或者做技术方案参考。

一、 痛点与需求:为什么球场需要它?

如果你是球馆老板或者共享球场的开发者,可能会遇到这种场景:订了晚上8点的场,用户来了发现灯没开;或者打完球走了,灯亮了一整晚,电费哗啦啦地流。

我们要解决的,就是“谁来开、谁来关、怎么收费联动”的问题。

简单来说,我们要把传统的“摁墙开关”,变成 “手机点一下/订单支付成功/扫码即用” 的自动化控制。

主角是 芯步的 AC1-10A 智能通断器(也叫智能继电器)。这玩意个头不大,直接装在球场原来的配电箱里,串联在灯光的回路上。

二、 硬件:AC1-10A 的“硬核”本事

先说说咱们手里这块硬件

  • 10A/16A 版本:对于球场照明(LED灯或者金卤灯)来说,完全够用,额定功率支持 2200W。

  • 无网关直连:这玩意儿直接连 2.4G WiFi,不需要买那个什么“网关系列”,买回去接上线,配网就能用

  • 接口开放度:这是选它的重点。它支持 HTTP 接口Websocket。说白了,不管你的后端是用 Java、Python 还是 Go,甚至前端写几行 JS 都能控制它

三、 对接逻辑:一张图看懂流程

我们不要搞复杂了,只关注三个角色:

  1. 你的业务系统:比如小程序后端、订单系统。

  2. 芯步云平台:中间商(但免费),帮你转发指令。

  3. AC1 硬件:球场里那个物理设备。

核心逻辑:你的系统通过调用芯步的开放 API,告诉云平台“去把那个球场的灯打开”,云平台通过 WiFi 推送给硬件执行。

四、 动手对接:分步详解

既然不要附件,那我就不贴大段代码了,直接说步骤和关键点。

第一步:设备配网与注册

拿到 AC1 后,接好线。先在手机上下载厂家提供的配网小程序。把设备加入到你的账号下。这时候你会拿到一个 Device ID(设备编号),这个 ID 就是你这盏灯的“身份证号”,记下来。

第二步:熟悉“签名”机制(稍微绕一点)

要控制设备,不能随便谁都能调接口,得有安全验证。芯步这边的签名算法比较标准,但第一次接触容易晕,我帮你白话翻译一下

你调用接口时,必须带三个参数:AppIDtssign

  • AppID:相当于你的用户名。

  • ts:当前时间戳。

  • sign:这就是身份证。计算公式是:md5( md5(你的AppSecret) + ts )

    • 白话:先把你后台的密钥(AppSecret)加密一次,再加上当前时间,再整体加密一次。

  • 避坑指南:很多同学第一次调不通,99% 是因为时间戳不对,或者没搞清楚拼接顺序。直接用官方给的 Demo 代码跑一遍,看通了你再移植

第三步:下发控制命令

这是最爽的一步,代码量极少。只需要发一个 HTTP POST 请求。

接口地址https://api.thingboot.com/{你的AppID}/device/control/

请求体

发过去,如果返回 code 200,那灯就亮了

针对球场的进阶玩法如果球场很大,多盏灯怎么办?

  • 分组控制:你可以把所有“1号场”的灯设备 ID 存在数据库里。用户下单后,循环调用接口关掉?太Low了。

  • 批量指令:传参时,device 参数支持用逗号分隔,比如 device=id1,id2,id3,一条指令全亮

  • 定时关灯:如果是按小时计费的,用户买了2小时,2小时后怎么自动关?可以在订单超时逻辑里调用关灯接口。也可以利用硬件的 reset 指令,比如开灯的时候顺带说一句“60分钟后自动关”,防止程序崩了灯一直亮

第四步:状态同步

用户要是自己去配电箱按了按钮把灯关了,你的系统不知道咋办?用 消息推送你需要在后台设置一个 回调 URL。一旦设备状态变化,芯步的云平台会主动把你的地址:灯关了!灯开了!这样你的系统数据库里的状态就是准的,不会出现“系统显示开,实际灯灭”的尴尬

五、 实际应用场景

假设你是共享球场的小程序开发者,你的代码逻辑大概是这样的:

  1. 场景:用户下单支付成功

    • 动作:你的后端收到了支付回调。

    • 代码逻辑:调用 AC1 接口,参数 {"power":1}

    • 结果:球场灯亮起,用户进场。

  2. 场景:用户点击小程序内的“开/关”按钮

    • 动作:前端请求你的服务器,你鉴权(确认是这个用户在操作)后,调用接口。

  3. 场景:订单结束

    • 动作:计时结束,或用户点击“结束订单”。

    • 代码逻辑:调用 AC1 接口,参数 {"power":0}

六、 避坑与提示

  1. 供电问题AC1 需要零火线供电。球场的老配电箱里,如果只有火线(开关线)没有零线,那是装不了的。需要确认一下。

  2. WiFi 信号一般球场很大,弱电箱可能在角落里。AC1 这种小模块的 WiFi 天线不如手机强。如果信号不好,经常掉线,用 WiFi 信号中继,或者选用带网口版本的网关产品。芯步虽然 AC1 是直连 WiFi,但如果距离太远,加个路由器桥接一下更好

  3. 恢复断电测试一下“来电后设备状态”。如果晚上断电了,早上来电,灯是保持关还是自动亮?根据业务需求,在控制台设置好通电状态,避免白天浪费电。

  4. 接口免费他们的开放平台接口调用是免费的,不用怕被薅羊毛

七、 总结

AC1 智能通断器 对接到你的共享球场项目里,其实就是三步:

  1. 配网拿 ID

  2. 对着文档抄签名算法

  3. 发一条带 {"power":1} 的 HTTP 请求

预算方面,几十块钱的硬件成本 + 一下午的开发时间,就能让你的球场实现“全自动无人值守”。现在就可以在芯步的控制台里申请一个 AppID 试一下了。