# 集控产品 V0.1 开发文档

> **版本**: V0.1  
> **用途**: 功能验证与演示  
> **创建日期**: 2026-06-05  
> **文档类型**: 内部开发文档

---

## 一、产品概述

### 1.1 产品定位
集控产品是一款支持多设备分组控制的智能照明控制系统，通过主机+载波的方式控制多个灯具，支持场景模式和群组色温调节。

### 1.2 版本说明
- **版本号**: V0.1
- **性质**: 功能验证与演示版本
- **灯具类型**: 双色温灯具（支持色温调节）
- **默认效果**: 场景为正白光效果，支持通过遥控器调节色温

---

## 二、硬件配置

### 2.1 设备清单

| 设备编号 | 设备类型 | 连接方式 | 功率/说明 |
|---------|---------|---------|----------|
| L0 | 灯带 | 主机自带 | 200W |
| L1 | 筒射灯 | 载波控制 | - |
| L2 | 筒射灯 | 载波控制 | - |
| L3 | 筒射灯 | 载波控制 | - |
| L4 | 筒射灯 | 载波控制 | - |
| L5 | 筒射灯 | 载波控制 | - |
| L6 | 球泡灯 | 载波控制 | 外形不同，控制方式与筒射灯相同 |

**总计**: 7个可控点位

### 2.2 通信方式
- **L0 (灯带)**: 主机自带，直接控制
- **L1-L6 (筒射灯/球泡灯)**: 通过载波方式控制

---

## 三、群组定义

| 群组编号 | 群组名称 | 包含设备 | 说明 |
|---------|---------|---------|------|
| 群组1 | GROUP 1 | L0 - 灯带 | 主机自带灯带 |
| 群组2 | GROUP 2 | L1 - 筒射灯 | 单个筒射灯 |
| 群组3 | GROUP 3 | L3 + L5 - 筒射灯组合 | 两个筒射灯编组 |
| 群组4 | GROUP 4 | L6 - 球泡灯 | 球泡灯 |

**注**: L2和L4未编入群组，仅支持场景控制

---

## 四、场景定义

### 4.1 场景一：明亮模式
**场景描述**: 整体明亮，适合日常活动、会客

| 设备 | 亮度 | 状态 |
|-----|------|------|
| L0 灯带 | 65% | 开启 |
| L1 筒射灯 | 80% | 开启 |
| L2 筒射灯 | 60% | 开启 |
| L3 筒射灯 | 70% | 开启 |
| L4 筒射灯 | 60% | 开启 |
| L5 筒射灯 | 70% | 开启 |
| L6 球泡灯 | 50% | 开启 |

### 4.2 场景二：温馨模式
**场景描述**: 柔和温暖，适合家庭聚会、放松

| 设备 | 亮度 | 状态 |
|-----|------|------|
| L0 灯带 | 30% | 开启 |
| L1 筒射灯 | 65% | 开启 |
| L2 筒射灯 | 35% | 开启 |
| L3 筒射灯 | 70% | 开启 |
| L4 筒射灯 | 40% | 开启 |
| L5 筒射灯 | 70% | 开启 |
| L6 球泡灯 | 30% | 开启 |

### 4.3 场景三：休闲模式
**场景描述**: 局部照明，适合观影、休息

| 设备 | 亮度 | 状态 |
|-----|------|------|
| L0 灯带 | 40% | 开启 |
| L1 筒射灯 | 0% | **关闭** |
| L2 筒射灯 | 60% | 开启 |
| L3 筒射灯 | 70% | 开启 |
| L4 筒射灯 | 30% | 开启 |
| L5 筒射灯 | 70% | 开启 |
| L6 球泡灯 | 50% | 开启 |

### 4.4 场景四：品酒模式
**场景描述**: 暗调氛围，适合品酒、浪漫晚餐

| 设备 | 亮度 | 状态 |
|-----|------|------|
| L0 灯带 | 5% | 开启 |
| L1 筒射灯 | 30% | 开启 |
| L2 筒射灯 | 15% | 开启 |
| L3 筒射灯 | 70% | 开启 |
| L4 筒射灯 | 10% | 开启 |
| L5 筒射灯 | 70% | 开启 |
| L6 球泡灯 | 20% | 开启 |

---

## 五、遥控器按键映射

| 按键 | 功能 | 说明 |
|-----|------|------|
| 按键1 | 场景一 - 明亮模式 | 调用明亮模式参数 |
| 按键2 | 场景二 - 温馨模式 | 调用温馨模式参数 |
| 按键3 | 场景三 - 休闲模式 | 调用休闲模式参数 |
| 按键4 | 场景四 - 品酒模式 | 调用品酒模式参数 |
| 群组选择键 | 切换群组1-4 | 选择要控制的群组 |
| 色温+ / 色温- | 调节色温 | 调节当前选中群组的色温 |

---

## 六、功能规格

### 6.1 基础功能
- [x] 4个场景模式切换
- [x] 7个设备独立亮度控制
- [x] 4个群组定义
- [x] 群组色温独立调节

### 6.2 色温规格
- **调节范围**: 2700K - 6500K
- **调节方式**: 通过遥控器按键步进调节
- **默认色温**: 4000K（正白光）
- **应用场景**: 所有场景默认正白光，可通过遥控器调节

### 6.3 控制逻辑
1. **场景切换**: 按下场景按键，所有设备按场景参数执行
2. **群组选择**: 先选择群组，再调节色温
3. **色温调节**: 仅影响当前选中群组内的设备
4. **亮度保持**: 色温调节不改变设备亮度

---

## 七、开发数据格式

### 7.1 JSON配置格式
```json
{
  "version": "0.1",
  "deviceConfig": {
    "totalDevices": 7,
    "devices": ["L0", "L1", "L2", "L3", "L4", "L5", "L6"],
    "connection": {
      "L0": "host",
      "L1-L6": "carrier"
    }
  },
  "groups": [
    {"id": 1, "name": "GROUP 1", "devices": ["L0"]},
    {"id": 2, "name": "GROUP 2", "devices": ["L1"]},
    {"id": 3, "name": "GROUP 3", "devices": ["L3", "L5"]},
    {"id": 4, "name": "GROUP 4", "devices": ["L6"]}
  ],
  "scenes": [
    {
      "id": 1,
      "name": "明亮模式",
      "keyBinding": "按键1",
      "values": [65, 80, 60, 70, 60, 70, 50]
    },
    {
      "id": 2,
      "name": "温馨模式",
      "keyBinding": "按键2",
      "values": [30, 65, 35, 70, 40, 70, 30]
    },
    {
      "id": 3,
      "name": "休闲模式",
      "keyBinding": "按键3",
      "values": [40, 0, 60, 70, 30, 70, 50]
    },
    {
      "id": 4,
      "name": "品酒模式",
      "keyBinding": "按键4",
      "values": [5, 30, 15, 70, 10, 70, 20]
    }
  ],
  "colorTemp": {
    "range": {"min": 2700, "max": 6500},
    "default": 4000,
    "step": 100
  }
}
```

### 7.2 场景参数表（数组索引对应）
| 索引 | 0 | 1 | 2 | 3 | 4 | 5 | 6 |
|-----|---|---|---|---|---|---|---|
| 设备 | L0 | L1 | L2 | L3 | L4 | L5 | L6 |

---

## 八、演示系统

### 8.1 演示页面地址
```
https://www.we-smart.cn/common/product/group-control-demo/
```

### 8.2 演示页面功能
- 场景模式切换展示
- 群组选择交互
- 色温调节演示
- 设备状态实时显示
- 遥控器参考图

---

## 九、后续版本规划

### V0.2 规划（建议）
- [ ] 增加亮度调节功能
- [ ] 支持自定义场景编辑
- [ ] 增加定时功能
- [ ] APP控制支持

### V1.0 规划（建议）
- [ ] 完整的产品化封装
- [ ] 多房间支持
- [ ] 语音控制接入
- [ ] 云端联动

---

## 十、附件

### 10.1 相关文件
- 演示页面: `https://www.we-smart.cn/common/product/group-control-demo/`
- 遥控器图片: 同目录下 `remote-control.jpg`

### 10.2 文档信息
- **创建人**: 微智助手
- **创建日期**: 2026-06-05
- **文档状态**: 内部开发文档
- **适用范围**: 深圳市微智电子有限公司内部使用

---

**深圳市微智电子有限公司 | 智步智能照明**  
*本文档仅供内部开发使用*