共享茶室照明插座控制：怎么把10A智能通断器AC1接入到自己的项目中_解决方案

CATALOG

芯步的10A智能通断器AC1通过HTTP接口开放控制能力，非常适合共享茶室这类需要按需管控照明和插座的场景。以下方案从设备选型、接口对接，到与小程序/管理后台的整合，梳理了完整的技术实现路径。

1. 背景与需求分析

在共享茶室（或共享棋牌室、自习室）的运营中，“节能”与“自动化”是提升利润的关键。

痛点：顾客离开现场时后，灯光、麻将机、饮水机忘记关闭，导致电力浪费；或者顾客入场前需要管理员手动去开门开灯，体验差。
目标：利用芯步 UNI-TDQ-AC1-10A 智能通断器，实现茶室包间内照明灯、10A插座（普通电器）的远程控制。
逻辑：用户下单 -> 系统自动通电；用户退单/超时 -> 系统自动断电。

2. 设备选型：UNI-TDQ-AC1-10A

在开始对接前，需确认硬件规格满足需求：

负载能力：10A额定电流。适用于 2200W以下 的阻性负载（如白炽灯、热水壶）或 350W以下 的感性负载（如节能灯、麻将机电机）。
通信方式：直连 WiFi 2.4GHz，无需额外的网关硬件，降低了单点故障率和成本。
接口特性：支持 HTTP API，响应时间约 80-120ms，适合实时控制场景。

3. 接口对接方案 (核心开发部分)

芯步的开放接口基于 HTTP 协议，只要你的项目（无论是 Java, Python, PHP 还是前端 JS）能发起 HTTPS 请求，即可完成对接。

3.1 接口鉴权与签名机制

为了防止接口被恶意调用，所有指令都需要进行签名认证。签名生成逻辑如下：

准备参数
- AppId：平台分配的应用ID。
- AppSecret：平台分配的密钥（需妥善保管）。
- ts：当前Unix时间戳（秒）。
签名公式sign = md5( md5(AppSecret) + ts )（即：先将AppSecret进行MD5加密，得到32位小写字符串，再拼接上时间戳，最后整体进行一次MD5加密）。
请求地址POST https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

3.2 核心指令下发

由于AC1属于单路通断器，其控制指令相对简单。以下是关键的命令示例：

1. 设备开启 (通电)

2. 设备关闭 (断电)

3. 高级功能：定时断开 (常用于按时计费场景)如果希望插座在通电1小时后自动关闭，无需在服务器端设置定时任务，直接下发指令让硬件自己计数，更为稳定：

3.3 代码接入示例 (Python Flask / 后台逻辑)

假设你正在搭建一个基于 Python 的管理后台，以下是封装控制函数的伪代码：

import requests
import hashlib
import time

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

def _generate_sign(self, ts):
        # 第一步:md5(AppSecret)
        step1 = hashlib.md5(self.app_secret.encode()).hexdigest()
        # 第二步:md5(step1 + ts)
        sign_str = step1 + str(ts)
        sign = hashlib.md5(sign_str.encode()).hexdigest()
        return sign

def control_device(self, device_id, power_status, auto_off_ms=None):
        """
        power_status: 1 开, 0 关
        auto_off_ms: 毫秒，可选
        """
        ts = int(time.time())
        sign = self._generate_sign(ts)
        
        url = f"{self.base_url}/{self.app_id}/device/control/?sign={sign}&ts={ts}"
        
        order_data = {"power": power_status}
        if auto_off_ms and power_status == 1:
            order_data["reset"] = auto_off_ms
            
        payload = {
            "device": device_id,
            "order": order_data
        }
        
        response = requests.post(url, json=payload)
        return response.json()

# 在订单开始时的调用逻辑
if order_start:
    ctrl = YoyoAC1_Controller("your_app_id", "your_secret")
    # 给茶室ID为 14735 的设备通电，且设置55分钟后自动断电（预留5分钟缓冲）
    ctrl.control_device("14735", 1, auto_off_ms=3300000)

4. 系统集成策略

为了将硬件融入“共享茶室”项目中，从以下三个维度进行设计：

4.1 业务逻辑联动

支付即通电：用户在小程序完成下单支付，系统后端接收到支付回调，立即调用上述 control_device 接口，开启对应包间的总闸或照明。
倒计时断电：订单结束时间前5分钟，通过短信或小程序提醒用户。订单时间归零时，直接下发 {"power": 0} 指令。
保洁模式：保洁人员打扫卫生时，无需领取钥匙，通过管理后台的保洁按钮，临时通电照明和吸尘器插座。

4.2 状态同步与展示

前端展示：在管理后台或商家小程序中，通过拉取设备状态（或维护本地状态缓存），实时展示“1号包间：设备在线/离线/通电中”。
异常处理：当设备离线（WiFi断开）时，芯步的API会返回相应的错误码。开发时需处理此异常，并在后台提示管理员检查包间路由器状态。

4.3 局域网直连模式（低延迟方案）

芯步全系列支持私有化与局域网部署。如果你的茶室总服务台有一台本地服务器电脑，且希望断外网也能控制：

将API请求地址从公网域名改为局域网内的服务器IP。
优势：响应速度在毫秒级，不依赖宽带，更稳定。适合对稳定性要求比较高的商业场所。

5. 硬件安装注意事项

接线规范：AC1通常需要接入零线和火线（输入输出）。由于是10A设备，前端串联 10A空气开关，避免短路烧毁设备。
WiFi信号：设备必须使用 2.4G WiFi（不支持5G）。茶室包间往往封闭性强，若信号弱，需在走廊加装2.4G中继器，确保设备保持在线状态。
负载限制：虽然有2000W+的功率，但如果是控制麻将机（电机为感性负载），降额使用，或者咨询芯步技术支持确认冲击电流是否在安全范围内。

6. 总结

将芯步AC1通断器接入共享茶室项目，技术上主要通过 “签名计算 + HTTP POST请求” 即可完成，开发周期极短。一旦打通，能实现无人值守、远程管控、定时自动化的完整闭环。

通过上述方案，不仅能解决茶室照明和插座的远程控制，也为后续接入门磁锁、烟感报警器等更多传感器（芯步系列产品）打下了统一的架构基矗