广告灯箱电路控制：怎样将35A智能空开开关接入到自己的项目中_解决方案

CATALOG

这是一个针对广告灯箱远程智能化改造的技术方案。核心原理是利用芯步35A智能断路器的直接WiFi连接特性（无需网关），通过其开放的HTTP API接口，将传统灯箱的电路控制无缝接入你自己的软件系统中。

一、准备工作：评估灯箱负载与硬件选型

在接入代码之前，首先要确保硬件匹配。

负载评估：芯步这款断路器额定电流为 35A，最大支持阻性负载 7000W。
- 适用场景：大型户外广告牌、灯杆灯箱、多组并联的灯箱群。
- 关键注意：广告灯箱属于LED感性负载（或带有驱动电源），实际承载能力约为 1100W。如果你的灯箱功率较大，一个断路器控制一组灯箱，避免过载。
网络环境：设备仅支持 2.4G WiFi。确保安装点位有稳定的2.4G信号覆盖，否则需考虑4G版本的型号。

二、硬件安装：导轨固定与接线

“接入项目”不仅是代码接入，首先是物理接入电路。

安装：该断路器采用标准 DIN导轨（35mm） 安装，直接卡入配电箱即可，无需额外螺丝固定。
接线
- 进线端（上口）：接市电火线。
- 出线端（下口）：接灯箱负载火线。
- 零线：断路器工作需要零线接入（N极），且负载的零线需与断路器零线并联或直通，确保回路闭合。

三、设备配网（关键步骤）

设备通电后，需要通过官方平台将其连入路由器，才能获得API调用地址。

零配模式：下载“芯步”或对应控制台App，使用蓝牙或“SmartConfig”模式一键配网。
AP模式：如果一键配网失败，设备会发出热点。手机连接该热点，在Web配置页面输入你店铺的WiFi密码即可。
获取唯一ID：在芯步控制台后台，找到这台“智能断路器35A”，记录下 Device ID。这是后续API调用中的唯一凭证。

四、核心开发：API接口调用流程

你的项目需要通过HTTP请求向云端发送指令，云端再转发给断路器。这是你的软件与硬件握手的过程。

1. 签名计算 (Authentication)

为防止接口被恶意调用，所有请求需携带签名。算法如下：

AppID & AppSecret：在芯步控制台的“开发设置”中获取。
ts：当前10位时间戳。
Sign = md5( md5(AppSecret) + ts )。

这段逻辑在后端完成，前端不要暴露AppSecret。

2. 核心控制代码示例

你可以使用任何编程语言（Python, PHP, Java, Node.js）发送POST请求。

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

请求参数

device：你之前记录的那串设备ID。
order：下发指令。
- 合闸（开灯）：{"power":1}
- 分闸（关灯）：{"power":0}

代码逻辑 (Python Flask示例 - 后端微服务)

import requests
import hashlib
import time

class YoYoCircuitBreaker:
    def __init__(self, app_id, app_secret, device_id):
        self.app_id = app_id
        self.app_secret = app_secret
        self.device_id = device_id
        self.base_url = f"https://api.thingboot.com/{app_id}/device/control/"

def _gen_sign(self):
        # 1. 对AppSecret进行MD5加密
        md5_secret = hashlib.md5(self.app_secret.encode()).hexdigest()
        # 2. 拼接时间戳
        ts = str(int(time.time()))
        # 3. 再次MD5得到签名
        sign_str = md5_secret + ts
        return hashlib.md5(sign_str.encode()).hexdigest(), ts

def control(self, action): # action: 1 开启, 0 关闭
        sign, ts = self._gen_sign()
        url = f"{self.base_url}?sign={sign}&ts={ts}"
        payload = {
            "device": self.device_id,
            "order": {"power": action}
        }
        response = requests.post(url, json=payload)
        return response.json()

# 项目中的调用逻辑
if __name__ == "__main__":
    # 初始化你的35A断路器
    light_box = YoYoCircuitBreaker(
        app_id="YOUR_APP_ID",
        app_secret="YOUR_SECRET",
        device_id="YOUR_DEVICE_ID_153397"
    )
    
    # 业务场景:检测到晚上18:00，开灯
    result = light_box.control(1) 
    print(result) # 若返回 {"code":200} 代表指令下发成功

3. 控制逻辑集成

将上述API集成到你现有的系统中，例如：

定时任务：在Spring Boot或Windows Task Scheduler中设置定时器，每天19:00调用 control(1)， 06:00调用 control(0)。
联动控制：如果项目有人体传感器或光照传感器，当传感器触发时，调用对应接口。

五、状态同步与异步消息（进阶）

单纯的“发指令”不够，你的项目还需要知道“灯到底亮了没有”（例如：手动按了断路器上的按钮，或者电路故障）。

你需要配置消息推送（Webhook/MQTT）

配置接收地址：在你的后端开放一个接口（例如：https://yourdomain.com/device/callback）。
在芯步后台配置转发：填入你的URL。
数据解析：当断路器状态变化时（无论是API控制还是手动按压），芯步会主动POST数据到你的服务器。你可以据此在数据库中记录“开关状态”，保持软件与硬件的状态同步。

六、部署实施检查清单

实际测试：先用Postman或Apifox测试API，确认收到 code:200 且灯箱真正亮起。
网络维稳：确认设备在线状态。该设备支持设置5组备用WiFi，可以在控制台 -> 网络配置中预设多个WiFi信号，防止因路由器重启导致设备掉线。
私有化部署（可选）：如果项目要求局域网内控制，不依赖外网，该设备支持私有化部署。你需要搭建自己的MQTT Broker（如EMQX），并在设备配网时指向你的局域网服务器IP。

总结

通过这套方案，你可以像调用普通API一样，在你的“项目代码”中直接操作220V强电电路。这不仅解决了广告灯箱的远程开关问题，也为后续基于数据的智能运维（若35A型号支持电量读取，你还可以检测灯箱故障）打下了基础。