---
title: 高级-循环定时
summary: 在设定时间段内循环开关光源，满足植物生长照明等场景，含 cycle_timing DP 协议。
---

## 高级-循环定时
### 功能介绍
循环定时功能将在所设时间段内，自动循环开启或关闭光源，满足植物生长照明等场景的使用需求。

### DP 协议
- DP Code：cycle_timing

|序号|	名称|	字节数|	标识|	数据类型|	字段属性|	字段说明|
|---|---|---|---|---|---|---|
|1|	协议版本|	1|	version|	枚举|	初始版本：00	||
|2|	节点长度|	1|	length|	数值|	最大值：255 最小值：0 步距：1 倍数：0	||
|3|	任务开关|	1|	on_off|	枚举|	任务关闭：02 任务开启：03	||
|4|	星期|	1|	week|	周数据|	反算|	如果全为 0，表示单次模式，只生效一次；否则为循环模式，判断相应位是否置 1，位置 1 表示当天生效。如 0x42 表示任务在星期六和星期一生效（注意必须保证相应的任务开关是处于开启状态）
|5|	起始时间|	2	|start_time	|数值	|最大值：1439 最小值：0 步距：1 倍数：0	0x10：hex 码，16；取值范围：0~1439|
|6|	结束时间|	2|	end_time|	数值|	最大值：1439 最小值：0 步距：1 倍数：0|	0x10：hex 码，16；取值范围：0~1439|
|7|	开启时长|	2|	on_time|	数值|	最大值：1439 最小值：1 步距：1 倍数：0|	0x10：hex 码，16；取值范围：0~1439|
|8|	关闭时长|	2|	off_time|	数值|	最大值：1439 最小值：1 步距：1 倍数：0|	0x10：hex 码，16；取值范围：0~1439|
|9|	色调（百位）|	1|	H_hundreds|	数值|	最大值：3 最小值：0 步距：1 倍数：0|	0x03, 0x10：hex 码。大端格式，第一个字节表示百位，第二个字节表示十位，个位。实际值表示 316，取值范围：0~360|
|10|	色调（十位个位）|	1|	H_tens_ones|	数值|	最大值：99 最小值：0 步距：1 倍数：0|	0x03, 0x10：hex 码。大端格式，第一个字节表示百位，第二个字节表示十位，个位。实际值表示 316，取值范围：0~360|
|11|	饱和度百分比|	1	|S|	数值|	最大值：100 最小值：0 步距：1 倍数：0|	0x10：hex 码，16%；取值范围：0~100|
|12|	明度百分比|	1	|V|	数值|	最大值：100 最小值：0 步距：1 倍数：0|	0x10：hex 码，16%；取值范围：0~100|
|13|	亮度百分比|	1|	B|	数值|	最大值：100 最小值：0 步距：1 倍数：0|	0x10：hex 码，16%；取值范围：0~100|
|14|	色温百分比|	1|	T	|数值	|最大值：100 最小值：0 步距：1 倍数：0|	0x10：hex 码，16%；取值范围：0~100|

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

### 注意事项
暂无

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