如何对接12路照明控制模块以实现延时通断控制_解决方案

CATALOG

[53119] 文档版本：V1.0 更新日期：2026年5月 适用对象：软件工程师、系统集成商、智能照明项目负责人

第一章：场景痛点与解决概述

1.1 照明控制的智能化需求

在楼宇照明、景观亮化、工业厂房、会议室等场景中，照明控制不仅仅是简单的开关，还需要实现延时通断、循序启动、定时关闭等高级控制功能：

应用场景	延迟需求	业务价值
会议室灯光	人员离开后延时30分钟自动关闭	节能降耗，避免长明灯
厂房照明	多路照明循序启动（每路间隔2秒）	避免大电流冲击，保护电路
景观亮化	按设定时间自动开关	无需人工值守，自动化运营
走廊/公共区域	声控/人体感应后延时关闭	按需照明，节能环保

1.2 解决方案：12路照明控制模块

芯步智能照明控制器12路是一款专为多路照明场景设计的工业级控制器，核心特点如下：

参数项	规格详情
产品型号	UNI-KZQ-ZM-12-16A（详见产品手册）
控制路数	12路独立控制
额定电流	MAX 16A / 路
阻性负载功率	MAX 3500W / 路
感性负载功率	MAX 500W / 路
联网方式	WiFi 2.4GHz（无需网关）
接口类型	开放HTTP API
私有部署	支持自建消息服务器，可运行于纯局域网

1.3 延时通断控制的核心能力

通过软件对接12路照明控制模块，可实现以下延时控制方式：

延时类型	命令格式	说明
延时断开	`{"point1":"30000"}`	通电30秒后自动断电
延时接通	`{"reset1":"30000"}`	断电30秒后自动通电
逐一延时启动	软件循环控制	多路逐个启动，间隔自定义
定时任务	Cron表达式	按时间计划自动控制

第二章：产品规格与硬件部署

2.1 12路照明控制模块核心参数

该产品为12路独立控制的智能照明控制器，具体参数如下：

参数项	规格说明
产品尺寸	宽：210.0mm；长：99.0mm；厚：62.8mm
产品净重	448g
外壳材质	塑料
工作电压	DC 5V 2A（直流）
额定电流	MAX 10A / 路或 MAX 16A / 路（视型号）
阻性负载功率	MAX 2200W-3500W / 路（视型号）
感性负载功率	MAX 350W-500W / 路（视型号）
控制路数	12路独立控制

2.2 负载功率注意事项

不同负载类型对功率的要求不同，使用时需注意：

负载类型	最大功率	说明
阻性负载（白炽灯、电热器）	MAX 3500W/路	可满载使用
感性负载（LED灯、节能灯、电机）	MAX 500W/路	启动电流可达额定5-7倍，需降额

⚠️ 重要提示：如果负载为LED灯、节能灯等感性/容性负载，每路功率必须控制在500W以内，否则启动瞬间的冲击电流可能损坏设备或引起误动作。

2.3 网络配置要点

设备支持WiFi 2.4GHz无线网络，采用WiFi直连方式，无需额外网关

频段：仅支持2.4GHz，不支持5GHz
多网络备份：可设定5组WiFi网络，优先连接信号最强的连接
私有部署：支持自建消息服务器，可完全运行在纯局域网环境

第三章：HTTP接口协议详解

3.1 整体对接架构

芯步12路照明控制模块采用标准的HTTP请求-响应模型，设备开放HTTP接口，适用于任何支持HTTP请求的编程语言

graph LR
    subgraph 软件层
        A[照明管理系统/智能家居平台]
    end
    
    subgraph 网络层
        B[芯步API网关
api.thingboot.com]
    end
    
    subgraph 硬件层
        C[12路照明控制模块]
    end
    
    A -- "HTTP POST (带签名)" --> B
    B -- "MQTT透传" --> C
    C -- "继电器动作" --> D[照明负载]

3.2 请求地址格式

http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

URL参数说明

参数	说明	示例
`{AppId}`	应用ID，在芯步控制台获取	`10001`
`sign`	动态签名，验证请求合法性	`a1b2c3d4...`
`ts`	当前Unix时间戳（秒级）	`1746000000`

3.3 签名算法

芯步API采用双重MD5签名机制：

Sign = md5( md5(AppSecret) + ts )

签名计算步骤

3.4 单路控制命令

模块支持12路独立控制，每路对应不同的命令字段：

命令	值	说明
`{"power1":"1"}`	"1" 接通 / "0" 断开	控制第1路
`{"power2":"1"}`	"1" 接通 / "0" 断开	控制第2路
`{"power3":"1"}`	"1" 接通 / "0" 断开	控制第3路
`...`	...	第4-12路以此类推
`{"power12":"1"}`	"1" 接通 / "0" 断开	控制第12路

3.5 延时通断命令（核心功能）

3.5.1 先通后断（延时断开）

适用于：通电一段时间后自动关闭的场景（如定时照明）

{"point1":"30000"}

命令解析：第1路先通电，30000毫秒（30秒）后自动断电。支持毫秒级精度，最大可设2147483647毫秒（约24.8天）。

3.5.2 先断后通（延时接通 / 重启）

适用于：断电重启设备、远程复位的场景

{"reset1":"5000"}

命令解析：第1路先断电，5000毫秒（5秒）后自动通电。

3.5.3 多路独立延时控制

可同时对多路下发延时指令：

3.6 完整请求示例

第四章：延时通断控制多语言实现

4.1 Python完整实现

# -*- coding: utf-8 -*-
import hashlib
import time
import requests
import json
from typing import Dict, List, Optional
from datetime import datetime

# ========== 配置信息 ==========
APP_ID = "YOUR_APP_ID"           # 应用ID
APP_SECRET = "YOUR_APP_SECRET"   # 应用密钥
DEVICE_ID = "YOUR_DEVICE_ID"     # 12路控制器设备ID
API_BASE = "https://api.thingboot.com"
# =============================

def calculate_md5(s: str) -> str:
    """计算MD5（32位小写）"""
    return hashlib.md5(s.encode('utf-8')).hexdigest()

def send_command(order: dict) -> dict:
    """向设备发送命令"""
    ts = int(time.time())
    md5_secret = calculate_md5(APP_SECRET)
    sign_raw = md5_secret + str(ts)
    sign = calculate_md5(sign_raw)
    
    url = f"{API_BASE}/{APP_ID}/device/control/"
    params = {"sign": sign, "ts": ts}
    payload = {"device": DEVICE_ID, "order": order}
    
    try:
        response = requests.post(url, params=params, json=payload, timeout=5)
        return response.json() if response.ok else {"error": response.text}
    except Exception as e:
        return {"error": str(e)}

# ========== 延时通断核心功能 ==========

def delay_off(channel: int, delay_ms: int) -> dict:
    """
    延时断开:先通电，指定毫秒后自动断电
    
    参数:
        channel: 通道号 1-12
        delay_ms: 延时毫秒数
    """
    command_key = f"point{channel}"
    return send_command({command_key: str(delay_ms)})

def delay_on(channel: int, delay_ms: int) -> dict:
    """
    延时接通:先断电，指定毫秒后自动通电（重启）
    
    参数:
        channel: 通道号 1-12
        delay_ms: 延时毫秒数
    """
    command_key = f"reset{channel}"
    return send_command({command_key: str(delay_ms)})

def set_power(channel: int, on: bool) -> dict:
    """
    立即控制指定通道的通断
    
    参数:
        channel: 通道号 1-12
        on: True接通 / False断开
    """
    command_key = f"power{channel}"
    value = "1" if on else "0"
    return send_command({command_key: value})

def batch_delay_off(channels: List[int], delay_ms: int) -> dict:
    """多路同时延时断开"""
    order = {}
    for ch in channels:
        order[f"point{ch}"] = str(delay_ms)
    return send_command(order)

def batch_power_on(channels: List[int]) -> dict:
    """多路同时接通"""
    order = {}
    for ch in channels:
        order[f"power{ch}"] = "1"
    return send_command(order)

def batch_power_off(channels: List[int]) -> dict:
    """多路同时断开"""
    order = {}
    for ch in channels:
        order[f"power{ch}"] = "0"
    return send_command(order)

# ========== 现场应用场景函数 ==========

def sequential_start(channels: List[int], interval_ms: int = 2000):
    """
    循序启动:按指定顺序依次启动各路，避免大电流冲击
    
    参数:
        channels: 通道列表（按启动顺序排列）
        interval_ms: 间隔毫秒数
    """
    import threading
    
    def start_with_delay(channel, delay):
        time.sleep(delay / 1000)
        set_power(channel, True)
        print(f"[循序启动] 第{channel}路已启动，延时{delay}ms")
    
    for idx, ch in enumerate(channels):
        delay = idx * interval_ms
        threading.Thread(target=start_with_delay, args=(ch, delay)).start()

def meeting_room_mode(duration_minutes: int = 60):
    """
    会议室模式:开启照明，指定时间后自动关闭
    
    参数:
        duration_minutes: 使用时长（分钟）
    """
    # 开启会议室所有照明（假设使用1-6路）
    for ch in range(1, 7):
        set_power(ch, True)
    
    # 延时关闭
    delay_ms = duration_minutes * 60 * 1000
    for ch in range(1, 7):
        delay_off(ch, delay_ms)
    
    print(f"[会议室模式] 灯光已开启，将在{duration_minutes}分钟后自动关闭")

def corridor_lighting(channel: int, keep_seconds: int = 30):
    """
    走廊照明模式:通电后指定秒数自动关闭
    
    参数:
        channel: 通道号
        keep_seconds: 保持时间（秒）
    """
    set_power(channel, True)
    delay_off(channel, keep_seconds * 1000)
    print(f"[走廊照明] 第{channel}路已开启，{keep_seconds}秒后自动关闭")

# ========== 调用示例 ==========
if __name__ == "__main__":
    # 示例1:单路延时30秒断开
    delay_off(1, 30000)
    
    # 示例2:单路延时5秒后接通（重启）
    # delay_on(2, 5000)
    
    # 示例3:多路循序启动（1→2→3，间隔2秒）
    # sequential_start([1, 2, 3, 4, 5, 6], interval_ms=2000)
    
    # 示例4:会议室模式（使用60分钟）
    # meeting_room_mode(60)
    
    # 示例5:走廊照明（保持30秒）
    # corridor_lighting(1, 30)

4.2 Node.js实现

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

// 配置
const config = {
    appId: 'YOUR_APP_ID',
    appSecret: 'YOUR_APP_SECRET',
    deviceId: 'YOUR_DEVICE_ID',
    apiUrl: 'https://api.thingboot.com'
};

// 计算签名
function generateSign(secret, ts) {
    const firstMd5 = crypto.createHash('md5').update(secret).digest('hex');
    const signRaw = firstMd5 + ts;
    return crypto.createHash('md5').update(signRaw).digest('hex');
}

// 发送命令
async function sendCommand(order) {
    const ts = Math.floor(Date.now() / 1000);
    const sign = generateSign(config.appSecret, ts);
    
    const url = `${config.apiUrl}/${config.appId}/device/control/`;
    const payload = { device: config.deviceId, order };
    
    try {
        const response = await axios.post(url, payload, {
            params: { sign, ts },
            timeout: 5000
        });
        return response.data;
    } catch (error) {
        return { error: error.message };
    }
}

// 延时断开
async function delayOff(channel, delayMs) {
    return sendCommand({ [`point${channel}`]: String(delayMs) });
}

// 延时接通（重启）
async function delayOn(channel, delayMs) {
    return sendCommand({ [`reset${channel}`]: String(delayMs) });
}

// 立即控制
async function setPower(channel, on) {
    return sendCommand({ [`power${channel}`]: on ? '1' : '0' });
}

// 循序启动（使用setTimeout实现）
function sequentialStart(channels, intervalMs = 2000) {
    channels.forEach((ch, idx) => {
        setTimeout(() => {
            setPower(ch, true);
            console.log(`第${ch}路已启动`);
        }, idx * intervalMs);
    });
}

// 会议室模式
async function meetingRoomMode(durationMinutes = 60) {
    // 开启1-6路
    for (let ch = 1; ch <= 6; ch++) {
        await setPower(ch, true);
    }
    // 延时关闭
    const delayMs = durationMinutes * 60 * 1000;
    for (let ch = 1; ch <= 6; ch++) {
        await delayOff(ch, delayMs);
    }
    console.log(`会议室灯光已开启，${durationMinutes}分钟后自动关闭`);
}

// 调用示例
// delayOff(1, 30000);
// sequentialStart([1, 2, 3, 4, 5, 6], 2000);

第五章：典型应用场景集成

5.1 第一种场景：会议室/培训室智能照明

需求：人员入场时开启灯光，离开现场时后自动关闭；支持一键预设场景。

实现逻辑

用户扫码/刷卡进入会议室
系统自动开启照明（可按预设场景：演讲模式、讨论模式）
人员离开现场时后，系统延时30分钟自动关闭

5.2 第二种场景：厂房/车间循序启动

需求：多路照明同时启动电流过大，需要每隔几秒启动一路。

实现逻辑

5.3 第三种场景：景观/楼宇亮化定时控制

需求：按预设时间自动开关，支持节假日特殊模式。

实现逻辑

import schedule

class LandscapeLightingController:
    """景观亮化控制器"""
    
    def __init__(self):
        self.normal_on_time = "18:30"   # 正常亮灯时间
        self.normal_off_time = "22:00"  # 正常关灯时间
        self.holiday_off_time = "23:30" # 节假日延后关灯
        
    def turn_on(self):
        """开启所有景观照明（循序启动）"""
        for ch in range(1, 13):
            set_power(ch, True)
            time.sleep(0.5)  # 500ms间隔
        print(f"[{datetime.now()}] 景观照明已开启")
        
    def turn_off(self):
        """关闭所有景观照明"""
        batch_power_off(list(range(1, 13)))
        print(f"[{datetime.now()}] 景观照明已关闭")
        
    def setup_schedule(self):
        """设置定时任务"""
        # 正常亮灯
        schedule.every().day.at(self.normal_on_time).do(self.turn_on)
        # 正常关灯（默认）
        schedule.every().day.at(self.normal_off_time).do(self.turn_off)
        
        # 可通过API动态调整
        def update_schedule(is_holiday: bool):
            if is_holiday:
                # 切换到节假日关灯时间
                schedule.clear("turn_off")
                schedule.every().day.at(self.holiday_off_time).do(self.turn_off)

# 启动定时任务
# controller = LandscapeLightingController()
# controller.setup_schedule()
# schedule.run_continuously()

5.4 场景四：走廊/公共区域声光联动

需求：人体感应触发后开启照明，人员离开后延时关闭。

实现逻辑

5.5 场景五：远程设备重启（先断后通）

需求：远程重启路由器、监控摄像头等设备。

实现逻辑

第六章：高级功能与最佳实践

6.1 各通道独立延时配置

根据实际需求，不同通道可配置不同的延时参数：

通道用途	推荐延时	命令示例
主照明（循序启动）	2秒间隔	软件循环控制
走廊感应照明	30秒自动关	`point1:30000`
会议室模式	60分钟自动关	`point1:3600000`
设备远程重启	断电5秒恢复	`reset1:5000`
景观亮化	定时开关	Cron定时任务

6.2 延时精度说明

参数	说明
精度	毫秒级（±50ms）
最大值	2147483647毫秒（约24.8天）
最小值	0毫秒（立即执行，等效于普通开关）

6.3 并发与队列管理

当大量延时指令同时下发时，在应用层面进行队列管理：

6.4 故障排查指南

现象	可能原因	解决方案
设备离线	1. 电源断开2. WiFi密码错误/信号弱3. 路由器禁用了设备MAC	1. 检查DC 5V供电2. 重配网络或靠近路由器3. 检查路由器白名单
延时命令无效	1. 命令格式错误2. 延时值超限3. 设备固件版本过低	1. 检查`point{ch}`格式2. 确保延时≤2147483647ms3. 升级固件
第N路无响应	1. 通道号写错2. 继电器故障	1. 确认通道号1-122. 联系售后检测
负载无法启动	1. 感性负载功率超500W2. 启动电流过大	1. 检查负载类型和功率2. 感性负载需降额使用
中文播报乱码	不涉及（照明模块无语音）	本产品为纯照明控制器

6.5 私有化部署架构

对于对数据安全有严苛要求的场景，芯步支持私有化部署

┌─────────────────────────────────────────────────┐
│                   企业内网                       │
│  ┌─────────┐    ┌──────────┐    ┌─────────────┐ │
│  │ 业务系统 │───▶│ 消息服务器 │───▶│ 12路控制器 │ │
│  └─────────┘    └──────────┘    └─────────────┘ │
│                                                 │
│  所有控制指令在内网完成，数据不出园区            │
└─────────────────────────────────────────────────┘

第七章：总结

通过将芯步12路照明控制模块接入软件项目，可以构建"毫秒级精度、多路独立控制"的智能照明系统。

核心要点回顾

硬件规格：12路独立控制、16A/路、支持感性负载500W
延时断开{"point1":"30000"} — 通电30秒后自动断电
延时接通{"reset1":"5000"} — 断电5秒后自动通电（重启功能）
循序启动：软件层循环控制，避免大电流冲击
多路并发：支持同时对12路下发独立的延时指令

对接工作量评估：熟悉HTTP接口的开发者可在2小时内完成基础功能对接，包括单路延时、多路循序启动等核心场景。

典型应用场景

会议室/培训室 — 延时关灯，节能降耗
厂房/车间 — 循序启动，保护电路
景观亮化 — 定时控制，自动化运营
走廊/公共区域 — 感应联动，按需照明
远程设备重启 — 先断后通，远程运维

安全注意事项

⚠️ 感性负载（LED灯、节能灯）功率请一定要控制在500W/路以内
⚠️ 接线前请确认电源已断开
⚠️ 设备采用DC 5V供电，请使用配套电源适配器

让每一路照明都"智能可控、精准延时"——这是12路照明控制模块赋能智能化场景的核心价值。

第一章：场景痛点与解决概述

1.1 照明控制的智能化需求

1.2 解决方案：12路照明控制模块

1.3 延时通断控制的核心能力

第二章：产品规格与硬件部署

2.1 12路照明控制模块核心参数

2.2 负载功率注意事项

2.3 网络配置要点

第三章：HTTP接口协议详解

3.1 整体对接架构

3.2 请求地址格式

3.3 签名算法

3.4 单路控制命令

3.5 延时通断命令（核心功能）

3.5.1 先通后断（延时断开）

3.5.2 先断后通（延时接通 / 重启）

3.5.3 多路独立延时控制

3.6 完整请求示例

第四章：延时通断控制多语言实现

4.1 Python完整实现

4.2 Node.js实现

第五章：典型应用场景集成

5.1 第一种场景：会议室/培训室智能照明

5.2 第二种场景：厂房/车间循序启动

5.3 第三种场景：景观/楼宇亮化定时控制

5.4 场景四：走廊/公共区域声光联动

5.5 场景五：远程设备重启（先断后通）

第六章：高级功能与最佳实践

6.1 各通道独立延时配置

6.2 延时精度说明

6.3 并发与队列管理

6.4 故障排查指南

6.5 私有化部署架构

第七章：总结

照明控制器产品方案：

怎样在共享棋牌室照明管理中接入智能设备来实现延时通断控制

共享台球厅：怎样将12路智能分路照明控制器对接到软件项目中

如何在智能办公中集成智能硬件来实现分路控制灯光与电器

怎样在共享茶室照明控制中集成智能硬件来实现远程控制8路照明设备通断

酒店客房照明控制：怎么将8路照明控制模块接入到软件项目中

通断用途方案：

怎么二次开发20A智能空开来实现延时通断控制

怎么接入60A带计量远程控制断路器来实现定时通断控制

怎样对接 8 路智能交流控制模块以实现交流负载通断控制

怎样在居家电器控制中集成智能硬件来实现设备电源远程通断

如何对接1路智能墙壁触摸开关以实现延时通断控制