共享自习室灯光电源控制：怎样把AC4-10A智能通断开关接入到自己的项目中_解决方案

CATALOG

共享自习室的运营痛点之一，是座位的电源控制——用户预约后通电、离开后断电、未使用时避免空耗。AC4-10A智能通断开关通过开放的HTTP接口，可以无缝接入你现有的自习室预约系统，实现电源与订单状态的联动。

一、解决概述

在本方案中，我们将芯步 AC4-10A 智能通断开关 作为执行终端，安装在每个自习室座位的电源线路前端。通过调用其开放的 HTTP API 接口，将你的自习室业务系统（后端服务器）与硬件设备连接起来。

核心逻辑是：

用户支付/上钟 $\rightarrow$ 系统调用“通电”接口 $\rightarrow$ 座位灯亮起，插座通电
用户点击“退座”/时间到 $\rightarrow$ 系统调用“断电”接口 $\rightarrow$ 座位断电，节能环保

二、硬件选型与参数：AC4-10A

根据芯步官方资料，AC4-10A 非常适合嵌入自习室改造项目：

体积小巧：仅 37mm x 74.3mm x 23.5mm，可以隐藏在标准的 86 底盒或照明配电箱内，不破坏现有装修。
电气性能：额定 10A 电流，对于自习室的单个插座位（电脑、台灯、手机充电）绰绰有余；阻性负载（普通照明）可达 2200W。
联网方式：支持 2.4G Wi-Fi 直连。无需额外购买网关，大幅降低多座位部署的硬件成本。
控制特性：支持 HTTP 接口远程控制，支持断电记忆，即使网络波动重连后也能保持断电状态（防止无人时灯自动亮起）。

三、接口接入流程

将 AC4-10A 接入项目的标准流程分为三步：设备配网、API 鉴权、业务逻辑调用。

第一步：设备配网

在你部署硬件前，需通过芯步官方平台将设备注册到你的账户下。

下载“芯步”小程序或登录官网控制台。
给 AC4-10A 通电，此时指示灯会“慢闪”，表示等待配网。
在小程序中输入现场的 2.4G Wi-Fi 密码，完成设备配网。
记录 ID：配网成功后，在控制台记录下该设备的唯一标识符（Device ID），后续接口调用需要用到。

第二步：API 鉴权与请求结构

芯步开放了标准的 HTTP 接口，你可以用任何编程语言（Java, Python, PHP, Go 等）调用。

请求地址https://api.thingboot.com/{AppID}/device/control/
请求方法POST
鉴权参数（放在 URL 中）：
- sign：请求签名，用于验证身份。
- ts：时间戳，用于防止请求被恶意重放。
Header
- Content-Type: application/x-www-form-urlencoded

第三步：核心 API 指令详解

在自习室场景中，你只需要关注单路通断的控制。AC4-10A 的接口 JSON 参数非常简洁

1. 通电（打开座位）前端触发：用户扫码签到成功。

注：order 需要传入 JSON 字符串，power:1 代表开启，power:0 代表关闭。

2. 断电（关闭座位）前端触发：用户点击“结束学习”或系统检测到余额不足/时间到。

3. 进阶用法：脉冲模式（防作弊/临时供电）如果自习室用于售卖临时用电（比如先通电后结算），使用point（先通后断）命令，避免用户忘记关导致的纠纷。例如：用户买电 1 小时，设备保持通电状态，实际就是直接通电；如果是测试线路，可发送点动：

注：该指令表示 通电 3 秒后自动断电（常用于测试或特定展示位灯光），标准通电时长不要用这个。

四、代码实战示例

场景模拟：用户 A 在自习室小程序支付了 2 小时，后端需要控制“座位 5”的电源开启。

以下是一个 Python 后端 的核心逻辑伪代码示例

import requests
import time
import hashlib

class AC4Controller:
    def __init__(self, app_id, app_secret):
        self.app_id = app_id
        self.app_secret = app_secret
        self.base_url = f"https://api.thingboot.com/{app_id}/device/control/"
    
    def _gen_sign(self, ts):
        # 根据官方文档规则生成签名，通常为 md5(app_secret + ts)
        return hashlib.md5(f"{self.app_secret}{ts}".encode()).hexdigest()

def control_device(self, device_id, power_status):
        """
        控制通断器
        :param device_id: 设备ID
        :param power_status: 1 开, 0 关
        """
        ts = int(time.time())
        sign = self._gen_sign(ts)
        
        # 构造请求参数
        params = {
            'sign': sign,
            'ts': ts
        }
        # 芯步接口要求 data 以 form 表单形式提交
        data = {
            'device': device_id,
            'order': f'{{"power":"{power_status}"}}'
        }
        
        response = requests.post(self.base_url, params=params, data=data)
        return response.json()

# ----- 业务逻辑集成 -----
# 假设自习室订单创建成功后触发
def on_order_paid(seat_id, device_id, duration_hours):
    # 1. 更新数据库订单状态
    print(f"用户已支付 {duration_hours} 小时，准备通电")
    
    # 2. 调用芯步接口通电
    controller = AC4Controller("你的AppID", "你的AppSecret")
    res = controller.control_device(device_id, 1)
    
    if res['code'] == 0:  # 假设 0 为成功
        print(f"座位 {seat_id} 通电成功，台灯亮起")
        # 3. 启动定时任务，N小时后自动断电
        schedule_auto_off(device_id, duration_hours)
    else:
        print(f"设备调用失败:{res['msg']}")

五、关键注意事项

为了确保项目实施顺利，请留意以下三点：

功耗与负载限制AC4-10A 的感性负载（如电机、老式镇流器灯管）最大仅支持 300W。自习室的 LED 台灯属于阻性负载，可直接使用，但切勿接入大功率取暖器（小太阳）或烧水壶，否则继电器可能粘连损坏。
网络环境设备仅支持 2.4GHz Wi-Fi。若自习室部署的是双频合一路由器，关闭 5G 融合或单独开启 2.4G SSID，确保设备稳定连接不掉线。
紧急物理开关AC4-10A 面板上自带一个 物理按键，且支持“可屏蔽”。在共享自习室场景下，不要屏蔽物理按键。这样万一服务器宕机或网络故障，管理员或用户可以通过长按/短按物理按键强制断电，符合安规。

通过上述对接，你可以将 AC4-10A 从一个简单的物理开关，升级为你自习室 SaaS 系统中的一个可控节点，实现真正的无人化、智能化运营。