全彩产品开发包

更新时间：2024-07-26 07:55:04下载pdf

为了帮助您快速实现全彩类照明产品的开发，并低门槛打磨出更具差异化的爆款产品，涂鸦基于联网单品开发框架推出了 全彩照明产品开发包。该产品开发包支持 1-5 路调光调色，您可基于包内提供的各种服务，快速开发多种场景模式、音乐模式以及各种定时计划等。

资源需求

硬件资源

外设	个数	说明
PWM	2~5	用于 PWM 类调光器驱动。如果不注册这类驱动，则无需该驱动。
GPIO	2	用 GPIO 模拟 I2C，用于 I2C 类调光器驱动。如果不注册这类驱动，则无需该驱动。
ADC	1	采集声音，用于本地音乐。如果不开启本地音乐功能，则无需该驱动。
TIMER	1	硬件定时器，色彩渐变任务需要依靠一个硬件定时器调度。
UART	1	和涂鸦上位机通讯，用于模组产测。如果不使用涂鸦上位机产测工具，则无需该驱动。

软件资源

资源	大小
ROM	约 70 KB
RAM	约 15 KB，随着设置的定时任务增加，内存消耗也会增大。

能力地图

业务逻辑

能力	说明
产品启动流程	实现应用入口函数，管理应用启动的必要流程。
事件处理机制	提供应用事件调度驱动，通过触发事件的机制，处理各个产品功能模块之间的逻辑。
功能配置管理	产品开发包引入了 Kconfig 功能，让功能模块的配置可视化，菜单化。

涂鸦产品功能

能力	说明
计算上电次数	很多光源类产品没有带按键功能。此时设备通过连续上电 N 次可重置设备，让设备进入配网状态或者解除和云端绑定。
成品产测	扫描指定测试路由器（默认为：`tuya_mdev_test1`，`tuya_mdev_test2`，可自定义），进入老化测试和成品功能测试。
设备初始状态	设备上电后的灯光状态支持配置成多种模式，例如勿扰模式、出厂默认模式、记忆模式和用户自定义模式。
开关管理	管理设备总开关状态，开关数据状态上报等。
网络指示	提供灯的快闪和慢闪模式，来指示不同的网络状态。
模式管理	管理设备的白光、彩光、场景和音乐这四种模式，记录和上报当前设备的模式状态。
全彩调光调色	冷光点亮日常起居，暖光营造浪漫氛围，可变幻 1600 万种色彩，支持用户调节到任意色温、亮度和颜色，让灯光成为最好的装饰。通过手机 App，即可在卧室控制客厅灯光开启和关闭，调整明暗和色彩。
全彩场景模式	预设阅读、工作、休闲和晚安等多种不同模式，简单至上，一键切换，更符合消费者实际使用需求。
全彩音乐模式	灯光随着音乐高低进行变化，支持在线音乐和本地音乐，给生活增添趣味和灵动。
倒计时	设置一段时间，计时到点后，对当前设备开/关状态取反。在设备打开状态时设置倒计时，计时到点后设备关。在设备关闭时设置倒计时，计时到点后设备开。
循环定时	循环定时主要用来解放劳动力，用于植物照明、灯光场景控制等。也就是说，设置一段总的循环时间（设置时间必须 ≥2 分钟），在此总的循环时间段内，用户可以自定义设置开启时长和关闭时长。开启时间段灯的状态可用户自定义颜色、亮度，之后将以此时间循环开启和关闭。
随机定时	满足用户长时间外出时，模拟家里有人的场景，起到防盗的效果。设置的一段时间 T1-T2 内，无论当前状态，先随机地开一次，后随机地关一次。当您度假或外出时，可以设置灯光看家，灯具会在所设的时间内随机自动开灯关灯，模拟主人在家，让聪明的灯光守护家园。
生物节律定时	生物节律功能可以模拟一天当中自然光亮度和色温的变化，使人感受回归自然的灯光。将自然光的概念通过设备带到室内：将一天设为 `N` 个时刻(1 ≤ `N` ≤ 8)，并设置各自对应的亮度和色温。设备一天内模拟太阳，自动按照这 `N` 个时刻来渐变。
入睡定时	灯光助眠功能将在所设时间点开始，经过一段时间的渐暗变化，直至关灯，帮助人更好地入睡。
唤醒定时	灯光唤醒功能将使灯光慢慢亮起，经过一段时间的渐亮变化，在所设时间点达到完全开灯，帮助人自然地苏醒。

基础服务

能力	说明
全彩本地场景服务	开发包内置的多种场景，同时支持您添加属于自己的全彩场景。
全彩本地音乐服务	提供了常用的音乐律动模式，同时也支持扩展新的音乐律动模式。
照明数据存储	存储各个产品功能模块的记忆数据。
延时存储服务	为了避免频繁存储，支持在一定时间（例如 5 秒钟）内触发的存储动作，只存储最后一次状态的数据。
生物节律定时服务	提供生物节律的定时服务，支持将一天的时间划分成多个时间点。到达对应时间点时，通过回调函数通知上层应用。
随机/循环定时服务	提供随机/循环定时服务，达到时间节点后，通过回调函数通知上层应用。
倒计时服务	提供倒计时服务，达到倒计时计数为 0 后，通过回调函数通知上层应用。
色彩渐变服务	设置当前颜色、目标颜色和变换时间，渐变服务将自动为您计算每一次步进的颜色值。您可基于该渐变服务完成灯的呼吸、渐变调光调色等功能。
基础定时服务	支持周循环定时，为随机、循环和入睡唤醒等复杂定时提供基础定时服务。
色彩转换服务	提供 HSVBT 和 RGBCW 两种颜色格式的相互转换、Gamma 计算以及功率限制等接口。

产品驱动

能力	说明
全彩调光器驱动	支持 PWM、BP1658CJ 和 SM2x35EGH 等多款调光器驱动，提供统一的操作接口。
声音采集	支持 ADC 采集音频高低。

上一篇产品开发包

下一篇产品功能问题