小型商铺总控电路：怎么把50A带计量智能空开对接到项目中_解决方案

CATALOG

芯步的50A带计量智能空开通过HTTP接口对接，整体流程很清晰——签名认证、指令下发、状态回调三个环节就能完成集成。以下方案按实际开发顺序展开，从硬件选型确认到核心接口调用，再到数据消费和异常处理，你可以直接对照着落地。

解决方案：小型商铺总控电路对接50A带计量智能空开

1. 项目分析与硬件选型确认

在小型商铺场景中，总控电路通常承担着整个店铺的照明、插座、空调及主要设备的供电。采用 “芯步智能大功率断路器[计量数显版]” 是解决该需求的硬件。

规格确认：该设备额定电流为40A-50A，额定功率可达8000W-11000W，完全满足小型商铺（如餐饮、便利店、服装店）的总负载需求。
核心功能：支持远程开/关（分合闸）、实时电量计量（电压、电流、功率）、过载/过压保护。
对接优势：设备通过WiFi 2.4G直连网络，无需额外购买网关；开放标准HTTP接口，支持云端或本地局域网控制。

你需要将商铺进线总开关替换为该设备，并确保其所在位置WiFi信号稳定。

2. 接口对接设计

由于涉及电量计量和频繁的控制指令，推荐采用 Server-To-Cloud 的直连架构，避免通过第三方云中转带来的延迟。

设备层：智能空开通过WiFi连接互联网（或局域网）。
云平台层：芯步开放平台（负责设备连接管理与指令透传）。
应用层（你的项目） ：你的后端服务器。
- 下发指令：你的服务器调用芯步的HTTP接口 -> 芯步云 -> 智能空开。
- 数据上报：智能空开采集电量 -> 芯步云 -> 推送至你的服务器接收地址。

这种架构下，从指令下达到设备执行仅约80-120ms，且电量数据不经过第三方存储，直接落入你的数据库。

3. 核心对接流程实现

芯步的接口采用签名验证机制，你需要先在芯步控制台获取 AppId 和 AppSecret。

3.1 鉴权与签名生成

所有HTTP请求需携带签名以防止篡改。签名算法规则为：sign = MD5( MD5(AppSecret) + ts )。

ts：当前Unix时间戳（秒）。
你需要先对 AppSecret 进行一次MD5，然后拼接上时间戳，再对整个字符串做一次MD5。

3.2 控制总电路通断

这是最核心的操作，用于实现“远程闭店断电”或“营业前提前开启空调”。

请求地址https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
请求方法：POST
请求体 (JSON)

如果需要对某条特定线路控制，可使用 power1、power2 等参数。商铺总控通常是单路，使用 power 即可。

3.3 读取实时计量数据（电能监测）

小型商铺需要关注电费开支，通常需要获取电流、电压和功率数据。芯步的开放接口支持获取设备最新状态。

请求参数：通常通过查询设备状态接口获取。
返回数据示例{"code":200,"data":{"voltage":220.5, "current":12.3, "power":2700, "energy_kwh":125.6}}
应用场景：如果你的项目需要做“能耗大屏”或异常用电告警，每隔1-5分钟轮询此接口即可。若需要实时性更高的推送，配置消息推送（见下文）。

3.4 定时任务与自动化

如果你的项目需要实现“自动断电”，有两种实现方式：

项目内定时任务：在你自己的服务器设置Cron定时任务。例如：每天22：00，服务器自动执行上述HTTP请求，下发 {"power":0}。
设备自带定时：利用芯步设备特性，在指令中携带 reset 参数。例如：{"power":1, "reset": 3600000} 表示接通电源，并在1小时（3600000毫秒）后自动断开。这种方式无需服务器维护定时任务。

4. 高级特性：接收电量消息推送（Webhook）

为了实现对耗电情况的精细化记录，在你的项目中配置 “消息推送” 。

配置回调地址：在芯步控制台，设置你的服务器回调URL，例如 https://yourdomain.com/api/yoyo/callback。
接收数据：当总控空开的电压、电流或功率发生变化时（或按固定频率），芯步云会主动POST JSON数据到你的地址。
项目内处理：你的API接收到数据后，解析JSON，存入MySQL或时序数据库。这样你就能在项目后台生成“今日用电”、“本月电费”报表，甚至设置“功率超限告警”。

5. 关键代码逻辑示例

以下以Python为例，展示如何在你的项目中封装一个“总控断电”功能。注意：签名算法是正确对接的关键。

import hashlib
import time
import requests

class SmartBreakerController:
    def __init__(self, app_id, app_secret):
        self.app_id = app_id
        self.app_secret = app_secret
        self.api_base = "https://api.thingboot.com"

def _generate_sign(self, ts):
        # 签名算法:md5(md5(AppSecret) + ts)
        step1 = hashlib.md5(self.app_secret.encode()).hexdigest()
        step2 = step1 + str(ts)
        sign = hashlib.md5(step2.encode()).hexdigest()
        return sign

def control_power(self, device_id, power_status):
        """
        控制空开通断电
        :param device_id: 设备ID
        :param power_status: 1 通电, 0 断电
        """
        ts = int(time.time())
        sign = self._generate_sign(ts)
        
        url = f"{self.api_base}/{self.app_id}/device/control/"
        params = {
            'sign': sign,
            'ts': ts
        }
        payload = {
            'device': device_id,
            'order': {'power': power_status}
        }
        
        # 执行请求
        response = requests.post(url, params=params, json=payload)
        if response.json().get('code') == 200:
            print(f"指令下发成功，设备将{'通电' if power_status == 1 else '断电'}")
        else:
            print(f"控制失败: {response.text}")

# 在你的项目逻辑中调用:
# controller = SmartBreakerController("你的AppId", "你的AppSecret")
# controller.control_power("123456789", 0)  # 远程关闭商铺总闸

6. 异常处理与稳定性保障

签名过期：接口要求 ts 为当前时间戳。如果服务器时间不准会导致签名错误。：部署前同步服务器NTP时间。
设备离线：调用接口返回200仅代表指令到达云端，不代表设备执行成功。
- ：在你的项目业务逻辑中，先查询设备在线状态，或结合定时获取的电量数据变化来验证是否真的断电。
局域网直连（可选）：如果商铺局域网非常稳定，且你担心外网抖动，可以利用芯步支持的局域网控制功能。如果你的服务器与空开处于同一局域网（例如商铺本地部署的工控机），可以不经过外网云直接发送HTTP指令给设备的局域网IP，响应更快。
本地锁定：商铺场景中需防范店员误操作。该空开支持本地按钮动作自定义/屏蔽功能。在项目中，你可以下发指令屏蔽设备面板上的物理按钮，仅允许你的总控系统操控，防止人为断电。

7. 延伸：增强商铺体验

既然总控电路已智能化，你的项目还可以利用芯步的其他接口增加附加价值：

联动语音播报：当总控检测到电流剧烈波动（如大功率设备启动）或有人体传感器信号时，调用语音音箱接口播报“欢迎光临”或“设备已启动”。
照明细分管理：总控后端的分路，如果更换为芯步的智能墙壁开关，你的项目可以统一控制店内灯光场景（一键切换营业模式/打烊模式）。

通过以上步骤，你就能将50A智能空开无缝对接到你的“小型商铺总控电路”项目中，实现集安全监控、能耗统计、远程操控于一体的数字化管理。