共享场馆照明系统控制：怎么将AC1-10A开关对接到自己的项目中_解决方案

CATALOG

芯步的AC1-10A智能通断器采用HTTP API驱动架构，支持单路灯光设备的远程开关控制，开发者无需处理复杂的硬件协议，只需调用标准接口即可将照明管理能力无缝嵌入共享场馆运营系统。以下是具体集成方案。

1 背景与需求分析

在共享场馆的运营场景中——包括共享健身房、共享会议室、共享办公空间、共享自习室等——照明系统管理是影响用户体验和运营成本的关键环节。场馆通常设有多个独立空间（健身区/私教房、会议室/工位区、走廊/卫生间等），传统照明管理存在以下痛点：

“人走灯不灭”造成能源浪费：用户离开现场时后忘记关灯，或运营方无法及时感知空间占用状态，导致灯光长时间开启。据统计，共享场馆照明能耗中约30%-40%源于无人时段空耗。
人工巡检效率低下：依赖保洁或管理人员逐间检查关灯，人力成本高且存在漏检。引入无人值守模式可将人力成本降低70%。
预约时段照明无法自动联动：用户通过小程序预约会议室/健身房时段后，需要运营方人工开灯或用户自行寻找开关，体验不佳。
不同场景需要不同光环境：会议模式、健身模式、清洁模式等对照明需求不同，传统开关无法灵活切换。

芯步推出的AC1-10A智能通断器（型号：UNI-TDQ-AC1-10A）是一款支持单路灯光远程控制的小功率智能开关，额定电流10A、负载功率2200W，具备HTTP接口远程控制、点动模式、定时任务、标签分组等特性。本文将提供完整的技术集成方案，帮助开发者快速实现共享场馆照明系统的智能化控制。

2 核心产品与技术规格

2.1 硬件参数

本次方案选用芯步AC1-10A智能通断器，核心参数如下

参数项	规格
产品型号	UNI-TDQ-AC1-10A
额定电流	MAX 10A
负载功率	阻性负载2200W / 感性负载约300W
工作电压	AC 85-265V（宽压输入）
待机功耗	<0.5W
联网方式	WiFi IEEE 802.11 b/g/n 2.4GHz
控制方式	HTTP接口远程控制 / 本地按钮
控制路数	1路独立控制
安装方式	标准导轨式，适配配电箱
支持命令	power（通断）、point（先通后断）、reset（先断后通）
网络容灾	支持设定5组WiFi网络，优先连接信号最强的

2.2 产品核心能力

精准匹配照明负载：10A/2200W容量可覆盖绝大多数场馆照明回路（LED灯带、筒灯、日光灯等单路总功率通常不超过1000W）。
HTTP接口零门槛集成：设备开放标准HTTP API，适用于Java、Python、PHP、Go、Node.js等任何支持HTTP请求的编程语言，支持接入小程序、APP、管理后台等多种项目形式。
多种控制模式：支持线路通断（power）、点动（point，先通后断）、复位（reset，先断后通）三种模式，满足不同场景需求。
无需网关：采用Wi-Fi直连方式，设备直接连接2.4G Wi-Fi网络，降低部署成本。
私有化部署支持：支持自建消息服务器，可在纯局域网环境下运行，满足数据安全要求。
标签分组控制：支持将多个设备绑定到同一标签，实现批量控制。

3 设计

将AC1-10A智能通断器集成到共享场馆管理系统中，采用云-端分离的四层架构：

设备感知层：AC1-10A模块安装在各场馆区域的配电箱内，控制对应区域的照明回路（健身区顶灯、会议室筒灯、走廊灯带等）。
网络传输层：设备通过Wi-Fi（2.4GHz）接入互联网，与芯步云平台保持长连接，命令下发延迟约为80-150ms。
云平台层：芯步开放API提供设备状态查询、指令下发、标签批量控制等能力。运营方也可选择私有化部署方案。
业务应用层：共享场馆运营平台（用户小程序/管理后台/运维APP）集成断路器的控制能力，实现预约联动、远程总控、定时策略、场景模式等业务功能。

graph TB
    subgraph 设备层
        AC1_1[AC1-10A 健身区]
        AC1_2[AC1-10A 会议室]
        AC1_3[AC1-10A 走廊]
        AC1_4[AC1-10A 更衣室]
        
        Light1[健身区照明]
        Light2[会议室照明]
        Light3[走廊照明]
        Light4[更衣室照明]
        
        AC1_1 --> Light1
        AC1_2 --> Light2
        AC1_3 --> Light3
        AC1_4 --> Light4
    end
    
    subgraph 网络层
        WiFi[2.4GHz WiFi]
    end
    
    subgraph 云平台层
        YoYoCloud[芯步云平台]
    end
    
    subgraph 业务层
        Backend[场馆运营后台]
        MiniApp[用户小程序]
        OpsAPP[运维APP]
        Dashboard[管理控制台]
    end
    
    AC1_1 -- WiFi --> YoYoCloud
    AC1_2 -- WiFi --> YoYoCloud
    AC1_3 -- WiFi --> YoYoCloud
    AC1_4 -- WiFi --> YoYoCloud
    
    YoYoCloud -- HTTP API --> Backend
    Backend --> MiniApp
    Backend --> OpsAPP
    Backend --> Dashboard

4 详细集成步骤

4.1 设备部署与注册

安装接线：将AC1-10A模块通过导轨安装在场馆配电箱内。接线方式：
- 火线输入（L_IN）：接该区域照明回路的市电火线
- 零线输入（N_IN）：接市电零线
- 火线输出（L_OUT）：接照明灯具的火线
- 零线输出（N_OUT）：接照明灯具的零线（可共用零线）
安全提示：接线工作需由持证电工操作，安装前请一定要切断总电源。
设备配网：通过芯步配网工具（支持AP配网/SmartConfig），将设备接入场馆内的2.4GHz Wi-Fi网络。设备状态指示灯含义：
- 慢闪：未联网
- 常亮：已联网且通电状态
- 常灭：已联网且断电状态
平台注册与分组：在芯步IoT平台注册账号，将设备添加到项目。为设备设置有意义的名称和标签，便于后续管理
- 标签：按区域创建，如“健身区”、“会议室A”、“走廊”
- 也可按场景创建，如“营业区”、“非营业区”

4.2 获取API凭证

在芯步控制台的“开发设置”中获取以下凭证：

AppID：应用唯一标识，用于接口路由
AppSecret：开发者密钥，用于签名计算（请妥善保管，切勿暴露在前端）

4.3 接口签名算法

芯步API采用双重MD5签名机制，确保请求的合法性和时效性。签名计算步骤如下：

对 AppSecret 进行MD5加密，得到 md5Secret = MD5(AppSecret)
获取当前Unix时间戳（秒级），记为 ts
拼接字符串：signStr = md5Secret + ts
对 signStr 再次进行MD5加密，得到最终签名 sign = MD5(signStr)

公式sign = MD5( MD5(AppSecret) + ts )

4.4 核心API接口

4.4.1 单设备控制（开关灯）

请求地址https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

请求方式：POST

请求参数

参数	类型	说明
device	string	设备ID
order	json字符串	控制命令

场馆照明场景order命令示例

命令	示例	功能说明
开关灯	`{"power":1}`	开灯
开关灯	`{"power":0}`	关灯
点动（临时开灯）	`{"point":60000}`	开灯，60秒后自动关闭（适用于走廊、卫生间）
复位重启	`{"reset":5000}`	断电5秒后自动恢复（适用于设备异常复位）

4.4.2 标签批量控制

针对共享场馆多区域管理的需求，支持通过标签（Tag）批量控制多个设备

请求地址https://api.thingboot.com/{AppID}/tag/control/?sign={sign}&ts={ts}

请求参数

参数	类型	说明
tag	int	标签ID，可同时指定多个标签（用逗号或竖线分隔）
order	json	控制命令，如`{"power":0}`

场馆场景示例

4.5 代码实现示例

Python实现

import hashlib
import time
import requests
import json

class LightingController:
    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):
        """生成API签名"""
        md5_secret = hashlib.md5(self.app_secret.encode()).hexdigest()
        sign_str = md5_secret + str(ts)
        return hashlib.md5(sign_str.encode()).hexdigest()
    
    def control_light(self, device_id, power_on):
        """控制单路灯光开关"""
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.api_base}/{self.app_id}/device/control/?sign={sign}&ts={ts}"
        
        order = {"power": 1 if power_on else 0}
        payload = {
            "device": str(device_id),
            "order": json.dumps(order)
        }
        
        response = requests.post(url, data=payload)
        return response.json()
    
    def point_light(self, device_id, duration_ms):
        """
        点动模式:开灯后自动关闭
        duration_ms: 亮灯持续时间（毫秒），适用于走廊、卫生间等临时照明
        """
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.api_base}/{self.app_id}/device/control/?sign={sign}&ts={ts}"
        
        order = {"point": duration_ms}
        payload = {
            "device": str(device_id),
            "order": json.dumps(order)
        }
        
        response = requests.post(url, data=payload)
        return response.json()
    
    def batch_control(self, tag_id, power_on):
        """批量控制:通过标签控制多个区域灯光"""
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.api_base}/{self.app_id}/tag/control/?sign={sign}&ts={ts}"
        
        payload = {
            "tag": tag_id,
            "order": {"power": 1 if power_on else 0}
        }
        
        response = requests.post(url, json=payload)
        return response.json()

# 使用示例
controller = LightingController("YOUR_APP_ID", "YOUR_APP_SECRET")

# 场景1:用户预约会议室，自动开灯
result = controller.control_light("device_meeting_room_a", power_on=True)
print("会议室灯光已开启:", result)

# 场景2:走廊感应亮灯，30秒后自动关闭
result = controller.point_light("device_corridor", duration_ms=30000)
print("走廊灯光将30秒后自动关闭")

# 场景3:场馆闭馆，一键关闭所有灯光
result = controller.batch_control(tag_id=10001, power_on=False)
print("全场灯光已关闭")

Node.js实现

const crypto = require('crypto');
const axios = require('axios');

class LightingController {
    constructor(appId, appSecret) {
        this.appId = appId;
        this.appSecret = appSecret;
        this.apiBase = 'https://api.thingboot.com';
    }

_generateSign(ts) {
        const md5Secret = crypto.createHash('md5').update(this.appSecret).digest('hex');
        const signStr = md5Secret + ts;
        return crypto.createHash('md5').update(signStr).digest('hex');
    }

async controlLight(deviceId, powerOn) {
        const ts = Math.floor(Date.now() / 1000);
        const sign = this._generateSign(ts);
        const url = `${this.apiBase}/${this.appId}/device/control/?sign=${sign}&ts=${ts}`;
        
        const order = { power: powerOn ? 1 : 0 };
        const payload = {
            device: String(deviceId),
            order: JSON.stringify(order)
        };
        
        const response = await axios.post(url, null, { params: payload });
        return response.data;
    }

async batchControl(tagId, powerOn) {
        const ts = Math.floor(Date.now() / 1000);
        const sign = this._generateSign(ts);
        const url = `${this.apiBase}/${this.appId}/tag/control/?sign=${sign}&ts=${ts}`;
        
        const payload = {
            tag: tagId,
            order: { power: powerOn ? 1 : 0 }
        };
        
        const response = await axios.post(url, payload);
        return response.data;
    }

async pointLight(deviceId, durationMs) {
        const ts = Math.floor(Date.now() / 1000);
        const sign = this._generateSign(ts);
        const url = `${this.apiBase}/${this.appId}/device/control/?sign=${sign}&ts=${ts}`;
        
        const order = { point: durationMs };
        const payload = {
            device: String(deviceId),
            order: JSON.stringify(order)
        };
        
        const response = await axios.post(url, null, { params: payload });
        return response.data;
    }
}

// 使用示例
const controller = new LightingController('YOUR_APP_ID', 'YOUR_APP_SECRET');

// 定时任务:每晚22:00全场关灯
async function scheduledLightsOff() {
    const result = await controller.batchControl(10001, false);
    console.log(`[${new Date().toISOString()}] 全场灯光已关闭`, result);
}

Java实现

import okhttp3.*;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;

public class LightingController {
    private String appId;
    private String appSecret;
    private OkHttpClient client = new OkHttpClient();
    
    public LightingController(String appId, String appSecret) {
        this.appId = appId;
        this.appSecret = appSecret;
    }
    
    private String md5(String input) {
        try {
            MessageDigest md = MessageDigest.getInstance("MD5");
            byte[] digest = md.digest(input.getBytes());
            StringBuilder sb = new StringBuilder();
            for (byte b : digest) {
                sb.append(String.format("x", b));
            }
            return sb.toString();
        } catch (NoSuchAlgorithmException e) {
            throw new RuntimeException(e);
        }
    }
    
    private String generateSign(long ts) {
        String md5Secret = md5(appSecret);
        String signStr = md5Secret + ts;
        return md5(signStr);
    }
    
    public String controlLight(String deviceId, boolean powerOn) throws Exception {
        long ts = System.currentTimeMillis() / 1000;
        String sign = generateSign(ts);
        String url = "https://api.thingboot.com/" + appId + "/device/control/?sign=" + sign + "&ts=" + ts;
        
        String order = powerOn ? "{\"power\":1}" : "{\"power\":0}";
        RequestBody body = new FormBody.Builder()
            .add("device", deviceId)
            .add("order", order)
            .build();
        
        Request request = new Request.Builder().url(url).post(body).build();
        Response response = client.newCall(request).execute();
        return response.body().string();
    }
    
    public String batchControl(int tagId, boolean powerOn) throws Exception {
        long ts = System.currentTimeMillis() / 1000;
        String sign = generateSign(ts);
        String url = "https://api.thingboot.com/" + appId + "/tag/control/?sign=" + sign + "&ts=" + ts;
        
        String order = powerOn ? "{\"power\":1}" : "{\"power\":0}";
        RequestBody body = new FormBody.Builder()
            .add("tag", String.valueOf(tagId))
            .add("order", order)
            .build();
        
        Request request = new Request.Builder().url(url).post(body).build();
        Response response = client.newCall(request).execute();
        return response.body().string();
    }
}

5 共享场馆业务场景应用

5.1 用户预约-灯光联动

场景描述：用户通过小程序预约会议室/健身房时段，系统在预约时段开始前自动开启对应区域灯光。

实现逻辑

用户在小程序选择时段并完成支付，订单状态变为“已预约”
运营后台调用灯光控制接口，开启对应区域灯光
用户到达后即可直接使用，无需手动开灯
预约时段结束后，系统自动关闭该区域灯光

5.2 全场一键控制

场景描述：运营人员通过管理后台，可一键开启/关闭全场灯光，适用于营业开始/结束、紧急情况等场景。

实现逻辑

使用芯步标签（Tag）功能，将所有场馆区域的设备绑定到“全场”标签
管理后台提供“全场开灯”“全场关灯”按钮，调用标签批量控制API

5.3 定时开关策略

场景描述：场馆有固定营业时间（如健身房06:00-23:00），系统自动执行定时开关灯，无需人工操作。

实现逻辑

使用芯步平台自带的定时任务功能，或由业务后端通过cron定时调用API
定时任务示例：
- 每日05:50：执行开灯（营业前准备）
- 每日23:10：执行关灯（营业结束后）

5.4 人感联动（节能模式）

场景描述：在走廊、卫生间等低频区域，配置人体传感器（需第三方配合），检测到有人时自动开灯，人离开后延时关闭。

实现逻辑

传感器检测到人，触发业务后端调用点动模式：{"point": 60000}（亮灯60秒）
60秒内若再次检测到人，可重新计时
避免长时间无人时的能源浪费

5.5 多场景模式切换

场景描述：共享空间（如会议室）需要根据不同使用场景切换灯光模式——会议模式（主灯亮）、投影模式（主灯灭/氛围灯亮）、清洁模式（全部开启）。

实现逻辑

为同一空间的不同灯光回路配置多个AC1-10A设备
业务后端定义“场景配置”，一键执行多设备控制

6 高级功能与优化

6.1 断网容灾设计

AC1-10A支持设定5组WiFi网络，优先连接信号最强的进行连接。在场馆部署时：

确保2.4G Wi-Fi信号覆盖配电箱位置
为设备配置备用WiFi网络（如相邻区域的AP）
对于网络不稳定场景，可选用4G版本

6.2 私有化部署（数据安全场景）

对于对数据安全要求较高的场景（如企业内部的共享会议室），芯步支持私有化部署方案：

设备通过内网MQTT或HTTP直连企业自建消息服务器
所有控制指令和状态数据均不经过芯步公网云
满足企业数据合规要求

6.3 数据可视化仪表盘

对接后可搭建场馆照明管理仪表盘，实时展示：

各区域灯光实时状态（开关/功率）
今日/本周照明用电量统计
异常长亮预警（同一区域连续开启超过12小时）
各区域节能排名

6.4 与门禁系统联动

共享场馆可实现门禁与灯光的深度联动

用户刷卡/扫码入场 → 对应区域自动开灯
最后一人离开现场时 → 全场自动关灯
夜间时段门禁触发 → 走廊引导灯自动亮起

7 总结与效益分析

芯步AC1-10A智能通断器通过“硬件轻量、接口标准、控制灵活”的设计理念，为共享场馆提供了一套完整的照明智能化解决方案。

核心价值总结

痛点	解决方案	预期效益
人走灯不灭，能源浪费	预约联动+定时关灯+人感点动	预计节省30-40%照明能耗
人工巡检关灯效率低	远程批量控制+自动策略	引入无人值守，人力成本降低70%
预约时段需手动开灯	预约订单联动灯光自动开启	提升用户体验，减少运营介入
多场景光环境切换不便	场景模式一键切换	灵活适配会议/健身/清洁等不同需求

通过实施本方案，共享场馆运营商将实现照明系统的自动化、精细化管理，在提升用户体验的同时显著降低运营成本，打造真正“聪明”的共享空间。

1 背景与需求分析

2 核心产品与技术规格

2.1 硬件参数

2.2 产品核心能力

3 设计

4 详细集成步骤

4.1 设备部署与注册

4.2 获取API凭证

4.3 接口签名算法

4.4 核心API接口

4.4.1 单设备控制（开关灯）

4.4.2 标签批量控制

4.5 代码实现示例

Python实现

Node.js实现

Java实现

5 共享场馆业务场景应用

5.1 用户预约-灯光联动

5.2 全场一键控制

5.3 定时开关策略

5.4 人感联动（节能模式）

5.5 多场景模式切换

6 高级功能与优化

6.1 断网容灾设计

6.2 私有化部署（数据安全场景）

6.3 数据可视化仪表盘

6.4 与门禁系统联动

7 总结与效益分析

通断器产品方案：

共享场馆照明系统控制：怎样将4400W 线路控制器对接到自己的项目中

怎么接入AC4-30A 物联网开关以实现单路交流负载控制

怎样接入AC5-10A 低压控制开关来实现能耗数据统计控制

药店冷藏柜电源控制：怎样将6600W 智能限流开关接入到项目中

如何在创客项目电源控制场景中接入智能设备以实现远程参数配置管理

共享场馆场景方案：

共享场馆大功率照明系统控制：怎么将30A智能线路断路器对接到自己的项目中

如何在共享场馆照明系统控制中对接智能设备以实现多设备联动控制

共享场馆照明系统控制：怎样把AC1-10A 电源控制模块接入到软件项目中

共享场馆照明系统控制：怎么将AC1-10A开关对接到自己的项目中

共享场馆照明系统控制：怎样把AC2-10A 低压控制开关集成到软件项目中