CATALOG

这是一个针对广告灯箱场景的专业解决方案。利用芯步提供的开放接口,你可以通过简单的 HTTP 请求MQTT 协议,将这款大功率通断器无缝集成到你现有的控制系统(如广告管理SaaS、微信小程序、PC上位机)中。

以下是详细的实施方案:

一、 硬件的选型与电力分析

在开始接线之前,请先确认你的广告灯箱与所选硬件的电气参数匹配。

根据芯步的产品规格,推荐使用型号 UNI-TDQ-AC5-10A 的智能通断器

  • 负载计算

    • 阻性负载 (如卤素灯、发热丝):最大支持 2200W

    • 感性/容性负载 (如LED驱动电源、节能灯、电机):必须降额使用,最大仅支持 350W

    • 结合你的需求:2200W 指的是纯阻性负载的最大上限。如果控制的是 LED 灯箱,需确认驱动电源的类型。预留 20% 的余量,感性负载控制在 300W 左右,以免继电器触点粘连。

  • 接线方案

    • 输入端:L(火线)接 L in,N(零线)接 N in

    • 输出端L out 接灯箱火线,N out 接灯箱零线。

    • 注意:该设备支持 100-250V AC,无需区分输入输出零线,但火线必须按规定接入

二、 对接流程与接口调用逻辑

芯步的开放平台提供免费的 API 接口,核心流程分为:注册应用 -> 绑定设备 -> 调用控制

1. 前期准备:获取凭证

你需要在芯步控制台完成以下操作:

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

  2. 将硬件通电配网,获取唯一的 Device ID (设备ID)。

  3. 设置 IP 白名单:将你服务器的公网 IP 加入白名单,防止签名错误或访问被拒

2. 签名算法

每次 HTTP 请求都需要携带 signts 参数,这是保证接口安全的关键:

  • ts:当前时间的 Unix 时间戳(秒),必须是北京时间。

  • sign:计算规则 md5( md5(AppSecret) + ts )

    • 注意:是先对 Secret 做一次 MD5,得到的字符串再拼接上时间戳,最后整体再做一次 MD5。

3. 下发控制指令

接口地址:POST http(s)://api.thingboot.com/{AppID}/device/control/

关闭灯箱 (2200W 通断器) 为例,完整的调用逻辑如下:

请求参数示例:

返回参数示例:

高频错误处理:若返回 5006 代表签名错误,检查 MD5 计算顺序;返回 5009 代表请求超限(限制 1次/秒),需在前端做防抖处理

三、 代码实现方案

无论你的后端用什么语言,只需具备 HTTP 请求能力即可。以下是两个核心场景的代码逻辑:

第一种场景:基础控制(Python / Node.js 示例)

用于后台管理系统,直接控制灯箱开关。

Python (Flask) 逻辑示例:

第二种场景:高级定时策略(广告行业的刚需)

广告灯箱通常需要分时段开关。利用接口的 resetpoint 参数,无需在服务器维护定时任务队列,直接让硬件自动执行

  • 晚上 18:00 开灯,凌晨 2:00 关灯你只需要在 18:00 调用开启指令。如果你想实现“按一下开关,亮 2 小时后自动关闭”,可以调用如下指令:

  • PWM/调光应用 (进阶)如果你的项目需要调节灯箱亮度(非单纯开关),直接使用简单的通断器无法实现,需要配合可控硅调光模块。但通断器层面可配合“先通后断”功能实现闪烁警示:

四、 项目落地中的关键优化

为了确保商用稳定性,针对 2200W 负载,你需要关注以下三点:

  1. 设备状态同步 (MQTT 推荐)虽然 HTTP 简单,但在高并发或网络抖动时可能丢包。芯步支持 MQTT 协议(服务器地址:mapi.thingboot.com,端口:1883)

    • 架构:你的后端订阅设备状态主题。当灯箱物理按钮被按下或遥控操作时,MQTT 会推送状态变化,保证数据库里的“开关状态”与“实际灯箱”永远一致。

  2. 本地局域网控制(低延迟)如果灯箱位于商场、展厅等局域网环境,且你的服务器在内网,可以开启 局域网推送 功能。此时指令无需经过云端,直接从你的内网服务器到设备,延迟可降至 <10ms,且断外网也能控制。

  3. 安全保护逻辑2200W 接近设备满载。请一定要在代码逻辑中加入“看门狗”机制:定期(如每 30 秒)读取设备的电量数据(如果购买的是计量版),若发现电流异常飙升,立即触发 power=0 指令进行软件保护,配合空开完成双重保护。

五、 总结

接入芯步 2200W 通断器只需三步:

  1. 接线:严格按照 10A 标准接入灯箱电路。

  2. 获取凭证:在控制台拿到 AppID 和 Device ID。

  3. 发指令:利用 md5(md5(密钥)+时间戳) 签名,向 /device/control/ 接口 POST {"power":"1"}

这种方案可以让你在 30 分钟内 完成从拆箱到第一个开关指令的下发,快速实现商用广告灯箱的远程智能化改造。