小程序面板开发教程｜开发照明 Matter 面板步骤（一）

一. 前置知识

前言

出于对 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 面板步骤（三）