--- title: 高级-入睡唤醒 summary: 灯光渐亮唤醒功能，在所设时间点通过渐亮变化帮助用户自然苏醒，含 wakeup_mode DP 协议说明。 --- ## 高级-入睡唤醒 ### 功能介绍 灯光唤醒功能将使灯光慢慢亮起，经过一段时间的渐亮变化，在所设时间点达到完全开灯，帮助人自然地苏醒。 - 部分参数说明如下： - 渐亮变化时间：用于设置达到所设时间点完全开灯状态所需的时间，可根据实际使用需求自主设置。 - 关灯设置：到达所设时间点灯完全打开后，默认一直开灯，可设置关灯时间，在持续一段时间后自动关灯。 - 重复周期：用于设置单次开启还是循环重复开启。选择周一到周日的任意时间，在对应时间该任务会重复执行；不选择任何时间，默认为单次开启，执行完一次后该任务自动关闭。 - 使用示例 - 设置时间 7:00 am，选择周一至周五，渐亮变化时间设置为 30 分钟，关灯时间设置为 1 小时。在每周的周一至周五的 6:30 am，灯光逐渐变亮，直至 7:00 am 时完全开灯，完全开灯后灯光保持不变，直到8:00 am 自动关灯。 ### DP 协议 - WI-FI 协议 DP： wakeup_mode |序号| 名称| 字节数 |标识|数据类型| 字段属性| 字段说明| |---|---|---|---|---|---|---| |1| 版本号| 1 |version| 枚举 |初始版本：00 || |2| 任务节点数| 1| node| 枚举| 1 个节点：01 2个节点：02 3个节点：03 4个节点：04 | 0x01：1 个节点；0x02：2 个节点；0x03：3 个节点；0x04：4 个节点| |3| 任务开关| 1| on_off| 布尔值| 0：任务关闭 1：任务打开 |0x00：任务关闭；0x01：任务打开| |4| 日期设定| 1| date| 周数据| 反算| 如果全为 0，表示单次模式，只生效一次；否则为循环模式，判断相应位是否置 1，位置 1 表示当天生效。如 0x42 表示任务在星期六和星期一生效（注意必须保证相应的任务开关是处于开启状态）| |5| 渐变步进值| 1| step| 数值| 最大值：24 最小值：1 步距：1 倍数：0| 0x10：hex 码，5 分钟一个步进，16*5=90 分钟渐变时长。取值范围：1~24| |6| 起始小时| 1| hour| 数值| 最大值：23 最小值：0 步距：1 倍数：0| 0x10：hex 码，16 点。取值范围：0~23| |7| 起始分钟| 1 |minute| 数值| 最大值：59 最小值：0 步距：1 倍数：0| 0x10：hex 码，16 分。取值范围：0~59| |8| 色调（百位）| 1 |H_hundreds| 数值| 最大值：3 最小值：0 步距：1 倍数：0 |0x03, 0x10：hex 码。大端格式，第一个字节表示百位，第二个字节表示十位，个位。实际值表示 316，取值范围：0~360| |9| 色调（十位个位）| 1 |H_tens_ones| 数值 |最大值：99 最小值：0 步距：1 倍数：0 |0x03, 0x10：hex 码。大端格式，第一个字节表示百位，第二个字节表示十位，个位。实际值表示 316，取值范围：0~360| |10| 饱和度百分比| 1 |S| 数值| 最大值：100 最小值：0 步距：1 倍数：0| 0x10：hex 码，16%；取值范围：0~100| |11| 明度百分比| 1 |V| 数值| 最大值：100 最小值：0 步距：1 倍数：0| 0x10：hex 码，16%；取值范围：0~100| |12| 亮度百分比| 1| B| 数值| 最大值：100 最小值：0 步距：1 倍数：0| 0x10：hex 码，16%；取值范围：0~100| |13| 色温百分比| 1| T| 数值| 最大值：100 最小值：0 步距：1 倍数：0| 0x10：hex 码，16%；取值范围：0~100| |14| 维持时间|1 |time_duration| 数值 | 最大值：24 最小值：0 步距：1 倍数：0| 0x10：hex 码，5 分钟一个步进。渐变完成后再持续该时间后关灯。取值范围： 0~24, 0 表示不关灯，24 表示 120 分钟后关灯| - Ble Mesh 协议 DP： wakeup_mode |序号| 名称| 字节数 |标识|数据类型| 字段属性| 字段说明| |---|---|---|---|---|---|---| |1| 版本号| 1 |version| 枚举 |初始版本：00 || |2|参数模式|1| data_mode| 枚举 | 灯光参数仅含亮度色温：01 灯光参数仅含彩光HSV：02 灯光参数包含亮度色温和彩光HSV：03| 0x01:仅含BT 0x02:仅含HSV 0x03:含HSVBT| |3| 任务节点数| 1| node| 枚举| 1 个节点：01 2个节点：02 3个节点：03 4个节点：04 | 0x01：1 个节点；0x02：2 个节点；0x03：3 个节点；0x04：4 个节点| |4| 任务开关| 1| on_off| 布尔值| 0：任务关闭 1：任务打开 |0x00：任务关闭；0x01：任务打开| |5| 日期设定| 1| date| 周数据| 反算| 如果全为 0，表示单次模式，只生效一次；否则为循环模式，判断相应位是否置 1，位置 1 表示当天生效。如 0x42 表示任务在星期六和星期一生效（注意必须保证相应的任务开关是处于开启状态）| |6| 渐变步进值| 1| step| 数值| 最大值：24 最小值：1 步距：1 倍数：0| 0x10：hex 码，5 分钟一个步进，16*5=90 分钟渐变时长。取值范围：1~24| |7| 起始小时| 1| hour| 数值| 最大值：23 最小值：0 步距：1 倍数：0| 0x10：hex 码，16 点。取值范围：0~23| |8| 起始分钟| 1 |minute| 数值| 最大值：59 最小值：0 步距：1 倍数：0| 0x10：hex 码，16 分。取值范围：0~59| |9| 亮度百分比| 1| B| 数值| 最大值：100 最小值：0 步距：1 倍数：0| 0x10：hex 码，16%；取值范围：0~100| |10| 色温百分比| 1| T| 数值| 最大值：100 最小值：0 步距：1 倍数：0| 0x10：hex 码，16%；取值范围：0~100| |11| 维持时间|1 |time_duration| 数值 | 最大值：24 最小值：0 步距：1 倍数：0| 0x10：hex 码，5 分钟一个步进。渐变完成后再持续该时间后关灯。取值范围： 0~24, 0 表示不关灯，24 表示 120 分钟后关灯| ### 如何开发 - 根据 UI 交互进行 DP 的监听上报与下发 - [具体监听与下发示例](/cn/miniapp/solution-panel/ability#dp-上报监听) ### 注意事项 暂无 ### 相关物料 - 【功能页】：无 - 【组件】：无 - 【教程】：无 - 【SDK】：无 - 【API】：无