一. 前置知识
前言
出于对 Matter 标准协议及第三方设备接入的可拓展性等方面考虑，照明 Matter 模型面板的功能点定义会与照明的 DP 模型有所不同，因此本文会着重介绍照明 Matter 面板的功能点定义及与 DP 模型的区别，以方便面板小程序开发者快速接入。
名词解释
在这里我们介绍一下本文档中可能出现的一些名词：
- 一路灯（C）：C 为 Cool 的缩写，代表一路白光灯，即可以调节亮度的灯具。
- 二路灯（CW）：CW 为 Cool Warm 的缩写，代表二路冷暖白光灯，即可以调节亮度和冷暖色的灯具。
- 三路灯（RGB）：RGB 色彩模式是工业界的一种颜色标准，通过对红（Red）、绿（Green）、蓝（Blue）三个颜色通道的变化，以及相互之间的叠加来得到各式各样的颜色的方式。因此 RGB 灯代表三路彩光灯，指能调节颜色的灯具。
- 四路灯（RGBC）：代表四路彩光灯，具体由三原色和冷白光组成，即可以调节颜色和白光亮度的灯具。
- 五路灯（RGBCW）：代表五路彩光灯，具体由三原色和冷暖白光组成，即可以调节颜色、亮度和冷暖的灯具。
二. 开发一路灯
参考原型
功能介绍
- 开关：控制灯具的开关状态。
- 模式：控制灯具的工作模式，包括白光、彩光、场景、音乐模式，在一路灯下，设备灯具只允许上报 white 白光模式。
- 亮度调节：控制灯具的白光亮度，数值越大则亮度越高。
功能定义
| DP ID | 功能点名称 | 标识符 | 数据传输类型 | 数据类型 | 功能点属性 | |
| 20 | 开关 | switch | 可下发可上报（rw） | bool | ||
| 21 | 模式 | work_mode | 可下发可上报（rw） | enum | 枚举值: white, colour, scene, music | |
| 85 | 亮度调节 | brightness_control | 可下发可上报（rw） | value | 数值范围: 1-254, 间距: 1, 倍数: 0, 单位: | |
👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。
与 DP 模型的区别
- 开关的功能点标识符不一致，在 Matter 模型下标识符为
switch，DP 模型下为switch_led。 - 亮度的功能点标识符不一致，在 Matter 模型下标识符为
brightness_control，DP 模型下为bright_value。 - 亮度的功能点数值范围不一致，在 Matter 模型下范围为 10-1000，DP 模型下为 1-254。
| DP ID | 功能点名称 | 标识符 | 数据传输类型 | 数据类型 | 功能点属性 | |
| 20 | 开关 | switch_led | 可下发可上报（rw） | bool | ||
| 21 | 模式 | work_mode | 可下发可上报（rw） | enum | 枚举值: white, colour, scene, music | |
| 22 | 白光亮度 | bright_value | 可下发可上报（rw） | value | 数值范围: 10-1000, 间距: 1, 倍数: 0, 单位: | |
三. 开发二路灯
参考原型
功能介绍
- 开关：控制灯具的开关状态。
- 模式：控制灯具的工作模式，包括白光、彩光、场景、音乐模式，在二路灯下，设备灯具只允许上报 white 白光模式。
- 亮度调节：控制灯具的白光亮度，数值越大则亮度越高。
- 色温调节：控制灯具的冷暖色温，数值越大则 Kelvin 值越小，则对应灯具的色温越暖。
功能定义
| DP ID | 功能点名称 | 标识符 | 数据传输类型 | 数据类型 | 功能点属性 | |
| 20 | 开关 | switch | 可下发可上报（rw） | bool | ||
| 21 | 模式 | work_mode | 可下发可上报（rw） | enum | 枚举值: white, colour, scene, music | |
| 85 | 亮度调节 | brightness_control | 可下发可上报（rw） | value | 数值范围: 1-254, 间距: 1, 倍数: 0, 单位: | |
| 86 | 色温调节 | color_temp_control | 可下发可上报（rw） | value | 数值范围: 153-370, 间距: 1, 倍数: 0, 单位: | |
与 DP 模型的区别
在 DP 模型下，开光、亮度调节和色温调节的功能点标识符不一致，开关的标识符为 switch_led，亮度调节的标识符为 bright_value，色温调节的标识符为 temp_value，除此之外，亮度调节和色温调节的数值范围也有所区别，分别在 10-1000 和 0-1000。
- 开关的功能点标识符不一致，在 Matter 模型下标识符为
switch，DP 模型下为switch_led。 - 亮度的功能点标识符不一致，在 Matter 模型下标识符为
brightness_control，DP 模型下为bright_value。 - 亮度的功能点数值范围不一致，在 Matter 模型下范围为 10-1000，DP 模型下为 1-254。
- 色温的功能点标识符不一致，在 Matter 模型下标识符为
color_temp_control，DP 模型下为temp_value。 - 色温的功能点数值范围不一致，在 Matter 模型下范围为 0-1000，DP 模型下为 153-370。
| DP ID | 功能点名称 | 标识符 | 数据传输类型 | 数据类型 | 功能点属性 | |
| 20 | 开关 | switch_led | 可下发可上报（rw） | bool | ||
| 21 | 模式 | work_mode | 可下发可上报（rw） | enum | 枚举值: white, colour, scene, music | |
| 22 | 白光亮度 | bright_value | 可下发可上报（rw） | value | 数值范围: 10-1000, 间距: 1, 倍数: 0, 单位: | |
| 23 | 冷暖值 | temp_value | 可下发可上报（rw） | value | 数值范围: 0-1000, 间距: 1, 倍数: 0, 单位: | |
注意事项
- 色温调节数值范围为 153-370，对应的
kelvin=1000000/色温值，例如色温值为 153，则 kelvin 值为 6536。
-
👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。
-
小程序面板开发教程｜开发照明 Matter 面板步骤（二）
-
小程序面板开发教程｜开发照明 Matter 面板步骤（三）
