# 彩色楼梯灯控制器产品规格书

**文档编号**: CSLED-CTRL-SPEC-001  
**版本**: V1.0  
**日期**: 2025年2月27日  
**状态**: 正式发布  

---

## 1. 文档信息

| 项目 | 内容 |
|------|------|
| 产品名称 | 彩色楼梯灯控制器（彩虹款） |
| 目标设备 | PBL92 彩虹款楼梯灯控制器 |
| 控制方式 | 微信小程序 + 物理遥控器 |
| 适用灯条 | RGBW 四色灯条 |

---

## 2. 产品概述

### 2.1 产品简介
彩色楼梯灯控制器是一款专为智能家居楼梯照明设计的控制系统，支持RGBW四色灯条控制，提供丰富的灯光效果和智能化控制功能。

### 2.2 主要特性
- 支持1-100级踏步灯控制
- 支持1-280点流水灯控制
- 8种预设单色 + 千万色色条 + 4种炫彩模式
- 人体感应智能触发（支持PIR红外及雷达感应器）
- 定时控制与夜灯功能
- 场景定时自动化
- 呼吸渐变效果

### 2.3 应用场景
- 家庭楼梯照明
- 商业场所装饰
- 节日氛围营造
- 夜间安全指引

---

## 3. 技术规格

### 3.1 硬件规格

| 参数项 | 规格 |
|--------|------|
| 设备型号 | PBL92 |
| 支持灯带类型 | RGBW四路灯带 |
| 最大支持点数 | 280点（流水灯） |
| 最大支持级数 | 100级（踏步灯） |
| 通信方式 | BLE（蓝牙低功耗） |
| 电源输入 | DC 24V |
| 输出电压 | DC 24V |
| 最大输出功率 | 600W |
| 工作温度 | -20℃ ~ +70℃ |
| 存储温度 | -30℃ ~ +85℃（建议） |

### 3.2 感应器规格

**备注**：多种感应器可选，支持人体红外感应器及可调距雷达感应器

#### 3.2.1 人体红外感应器（PIR）

| 参数项 | 规格 |
|--------|------|
| 感应方式 | 被动红外感应（PIR） |
| 感应角度 | 120° |
| 感应距离 | 3-6米 |

#### 3.2.2 可调距雷达感应器

| 参数项 | 规格 |
|--------|------|
| 感应方式 | 微波雷达感应 |
| 感应角度 | 110° |
| 感应距离 | 0.1-3米（可调） |

---

## 4. 功能规格

### 4.1 踏步灯控制

#### 4.1.1 踏步级数设置
- **调节范围**: 1 - 100级
- **调节步进**: 1级
- **预览功能**: 调节时实时预览效果

#### 4.1.2 踏步亮度设置
- **调节范围**: 1 - 100%
- **调节步进**: 1%
- **预览功能**: 调节时实时预览效果

### 4.2 流水灯控制

#### 4.2.1 流水点数设置
- **调节范围**: 1 - 280点
- **调节步进**: 1点
- **预览功能**: 调节时实时预览效果

#### 4.2.2 流水灯亮度
- **调节范围**: 1 - 100%
- **颜色同步**: 与踏步灯颜色同步

### 4.3 颜色控制

#### 4.3.1 预设单色（8种）

红色、橙色、黄色、绿色、青色、蓝色、紫色、暖白色

#### 4.3.2 20种颜色库定义

红色、橙色、黄色、绿色、青色、蓝色、紫色、粉红、淡蓝色、淡绿色、淡紫色、玫瑰红、深绿色、深紫色、珊瑚红、森林绿、薄荷绿、酒红色、天蓝色、紫红色

**说明**: 以上20种颜色用于"五彩斑斓"和"彩色间歇律动"模式的颜色随机选择。

#### 4.3.3 炫彩模式（4种）

| 模式名称 | 描述 | 颜色控制支持 |
|----------|------|--------------|
| 彩虹渐变 | 按红橙黄绿青蓝紫顺序亮灯 | 支持 |
| RGB变换 | 按红绿蓝顺序亮灯 | 支持 |
| 五彩斑斓 | 从20种颜色库中随机选择 | 支持 |
| 随机颜色 | 同色模式，每次触发颜色随机（从20色库中选） | 支持 |

**特殊说明**: 
- "彩色间歇律动"和"彩色逐步叠色"两个模式为固定颜色效果，不支持炫彩颜色模式
- 当处于上述固定模式时调节炫彩色，自动切换至"逐级"模式并预览

### 4.4 时间参数设置

#### 4.4.1 逐级亮灯/灭灯间隔

**可选值**: 0.1s、0.2s、0.3s、0.4s、**0.5s**（默认）、0.6s、0.7s、0.8s、0.9s、1s、1.2s、1.5s、2s、3s、5s

#### 4.4.2 全亮保持时间

**可选值**: 0.5s、2s、5s、**10s**（默认）、30s、1min、3min、5min、10min、30min

### 4.5 工作模式

#### 4.5.1 感应模式（触发后亮灯）

| 子模式 | 描述 |
|--------|------|
| 逐级 | 从第一步开始逐级向上点亮 |
| 全亮 | 所有踏步同时点亮 |
| 跟随 | 灯光跟随人的移动方向 |
| 隔级 | 隔一级点亮一级 |
| 流水 | 流水灯效果跟随移动 |
| 星星 | 随机闪烁的星星效果 |

**特性**: 支持所有颜色调节，包括单色和炫彩模式

#### 4.5.2 非感应模式（持续亮灯）

| 子模式 | 描述 |
|--------|------|
| 常亮模式 | 所有灯持续常亮 |
| 循环模式 | 灯光循环流动效果 |
| 彩色间歇律动 | 整体切换颜色，间隔按保持时间设定，从20色库随机 |
| 彩色逐步叠色 | 一种颜色逐级亮到最后，再从第一步切换另一种颜色 |

### 4.6 呼吸渐变效果

| 参数 | 说明 |
|------|------|
| 功能 | 控制灯光缓亮缓灭效果 |
| 开启 | 缓亮缓灭（渐变过渡） |
| 关闭 | 直亮直灭（无过渡） |

### 4.7 感应器控制

#### 4.7.1 感应器开关
- **功能**: 开启或关闭人体感应功能
- **默认**: 开启

#### 4.7.2 定时设置
- **功能**: 设置感应器工作时间段
- **时间格式**: 24小时制，精确到分钟
- **行为**: 
  - 时间段内：可触发亮灯
  - 时间段外：不可触发亮灯
  - 调节颜色/模式可在非工作时间段预览，但不打破定时功能

#### 4.7.3 夜灯设置
| 参数 | 说明 |
|------|------|
| 功能 | 开启/关闭夜灯模式 |
| 夜灯亮度 | 可独立调节 |
| 夜灯颜色 | 跟随系统设置的颜色 |

### 4.8 场景定时

| 参数 | 规格 |
|------|------|
| 执行时间 | 24小时制，精确到分钟 |
| 重复周期 | 周一至周日可选 |
| 执行动作 | 开灯、关灯、切换模式 |
| 感应子模式 | 逐级、全亮、跟随、隔级、流水、星星 |
| 非感应子模式 | 常亮、循环、彩色间歇律动、彩色逐步叠色 |
| 执行参数 | 亮灯间隔、保持时间、亮度、颜色 |

---

## 5. 遥控器功能

### 5.1 配对方式
1. 控制器上电
2. 上电后10秒内，长按遥控器中间开关按键
3. 控制器指示灯闪烁表示绑定成功
4. **注意**: 必须在10秒内完成配对

### 5.2 遥控器按键功能定义

![遥控器功能定义图](/root/.openclaw/media/inbound/b0d38957-c428-405e-962c-73b44e7d3cea.png)

**遥控器按键功能说明：**

| 按键 | 功能 |
|------|------|
| 电源键 | 开灯开启常亮模式 / 关灯返回上一个感应模式 |
| W键 | 设置白色颜色 |
| 彩虹键 | 设置彩虹渐变颜色 |
| 五彩斑斓键 | 设置五彩斑斓颜色 |
| COLOR键 | 颜色切换（红橙黄绿青蓝紫七色） |
| 全天感应键 | 设定为全天感应工作 |
| 晚上感应键 | 设定为晚上感应工作 |
| 逐级模式键 | 设置感应逐级模式 |
| 全亮模式键 | 设置感应全亮模式 |
| 彩色律动键 | 设置彩色律动效果模式 |
| 彩色叠色键 | 设置彩色叠色效果模式 |
| 亮度+/-键 | 增加/减小踏步灯亮度 |
| 级数+/-键 | 增加/减少踏步级数 |
| 时间键 | 设置亮灯保持时间（10s/30s/60s/180s） |

---

## 6. 小程序界面功能

### 6.1 设置界面模块

1. **基本参数设置**
   - 踏步级数设置
   - 踏步亮度设置
   - 流水点数设置
   - 流水灯亮度设置

2. **灯光效果控制**
   - 彩色滑条调节（千万色选择）
   - 预设颜色选择
   - 炫彩模式选择

3. **系统参数设置**
   - 速度设置
   - 时间设置
   - 呼吸渐变开关

4. **模式设置**
   - 工作模式选择
   - 感应器开关
   - 定时与夜灯设置
   - 场景定时配置

---

**文档结束**