---
title: 特色-分段调光
summary: 吸顶灯通过墙壁开关实现亮度色温分段切换，含 segment_dimming DP 协议。
---

## 特色-分段调光

### 功能介绍
- 传统吸顶灯产品，可通过墙壁开关（通断电）实现亮度和色温的变化，硬件通过检测断电时间来实现，比如断电后5s内再上电，则调整亮度和色温到预设的下一个值，如果断电时间超过5s则保持关灯前的状态，如此不断循环。一般亮度色温预设值会有3到4个。常用的分段调光硬件方案如明微SM2213EK等。该功能国内市场普及度较高，为迎合客户使用习惯，智能吸顶灯增加该功能。

### DP 协议
|DPID_wifi	| DPID_zigbee| 	DPID_sigmesh|	功能名称	|code	|传输类型	|类型	|功能点属性|
|---|---|---|---|---|---|---|---|
|52	|||分段调光|	segment_dimming|	rw|	raw	|{ "type": "raw", "maxlen": 255 }|

- 协议格式

|版本号	| 分段调光开关	|分段数量	|色相H	|饱和度S	|明度V	|亮度B	|色温T|
|---|---|---|---|---|---|---|---|
|1byte|	1byte	|1byte	|2byte	|2byte|	2byte	|2byte	|2byte|

- 协议字段说明：

|序号	|字段	|长度（Byte）|	数据代表说明|
|---|---|---|---|
|1|	版本号|	1|	0x00: 初始版本|
|2|	分段调光开关|	1	|0x00: 关闭，0x01:打开|
|3|	分段数量|	1|	分段数量，范围：2~5段|
|4|	色相H	|2	|HEX格式, 范围 0x0000 ~ 0x0168（即0~360）|
|5|	饱和度S|	2	|HEX格式, 范围 0x0000 ~ 0x03E8（即0~1000）|
|6|	明度V	|2|	HEX格式, 范围 0x0000 ~ 0x03E8（即0~1000）|
|7|	亮度B|	2	|HEX格式, 范围 0x0000 ~ 0x03E8（即0~1000）|
|8|	色温T|	2	|HEX格式, 范围 0x0000 ~ 0x03E8（即0~1000）|

**备注：如果分3段调光，则序号4~8字段重复3次，以此类推。**

### 如何开发
- 根据 UI 交互进行 DP 的监听上报与下发
  - [具体监听与下发示例](/cn/miniapp/solution-panel/ability#dp-上报监听)

### 注意事项
- 注意与通电反应/断电记忆的影响
  - 分段调光功能与通电反应 实质上都是在定义设备上电点亮的状态，通电反应状态与分段调光状态只能有一个生效。当用户仅选取了分段调光dp点，而未同时选取断电记忆dp点，则 APP 控制面板提供开启/关闭分段调光功能的选项，默认为关闭状态。

### 相关物料
- 【功能页】：无
- 【组件】：无
- 【教程】：无
- 【SDK】：无
- 【API】：无