基础调光

本文档主要针对照明的基础调光的一些常见问题，梳理出对应的问题排查指引，帮助您解决一些日常问题。

照明设备怎么配网及配网后怎么移除？

照明设备手动触发配网及移除配网的操作及实现逻辑是怎么样的？

对于常见的照明设备来讲，为满足其智能化联网的需求，必然会设计一种触发配网动作的常见手段。上下电次数计数即是一种照明类设备最常用的触发联网手段。其基本操作逻辑是：设备上电后首先读取非易失性存储设备(如Flash)中的上电次数，读取成功后其次数加1，再重新存储到非易失性存储设备(如Flash)中，如果设备上电超过5s，则将存储到非易失性存储设备(如Flash)中的上电次数进行清零处理。

我的设备发生误触导致重置了怎么办？

如果设备上电后的上电次数,达到了配网重置次数，无论设备是否处于联网状态，都会触发设备进入Wi-Fi配网状态。

Wi-Fi照明设备移除配网后应用功能的设置信息会保留吗？

设备移除配网后应用上之前设置的功能设置信息都会清除，其信息恢复至出厂默认设置信息，重新激活后视为一个全新的设备。清除的信息包括但不限于以下信息：灯光亮度，色温，场景数据，灯光模式，高级功能配置信息等。APP移除配网及手动重置配网均是如此。

照明设备渐变调光的实现要求？

照明上的调光渐变对硬件资源的要求是怎么样的？

调光渐变需要使用芯片一路硬件定时器资源，要求其定时精度在ms级，不同照明产品的渐变定时时长要求略有差异，一般在2ms以上即可满足使用要求。

当前照明类设备的调光曲线是怎么样子的？

当前涂鸦照明的调光曲线为线性调光，目前正在不断优化调光曲线的设计，以达到更优的调光效果，敬请期待。

照明设备上电后开关的状态如何设置？

作为主体照明的设备，其上电到点灯的时间要求是怎样的？

根据当前照明设备的标准要求，主体照明类设备如光源、球泡灯等设备上电到设备点亮的时间不得超过500ms,其中设备上电指设备电源上电的时刻，点亮时刻指设备初次亮起的时刻，两时刻时间差值不得超过500ms。

怎么衡量上电到点灯的时间值是否满足要求？

由于智能灯具通常会配置开关渐变，其点亮时刻不适合取亮度达到最大值的时刻。由于不同的硬件设计方案对于Wi-Fi模组达到供电电压，正常启动的时间差异大，固件设计为满足不同的硬件设计要求，会进可能缩短软件启动到点亮时刻的时间。客户在拿到涂鸦免开发方案的Wi-Fi模组时，可以使用逻辑分析仪或者示波器测量固件启动点灯时间，根据固件启动时间匹配相应的硬件设计方案，满足500ms启动要求，切记留有一定的设计余量。
另外非主体照明的设计方案，如灯带，氛围灯等照明设备，对于启动时间没有强制的标准要求。

不同国家和地区对于照明类设备的待机功耗是如何要求的？

美国加州地区要求照明类设备满足待机模式下的功耗不超过0.2W；欧洲ERP新规要求照明类设备待机模式下的功耗不超过0.5W。对于照明类设备来讲，设备待机模式指关灯模式下的整机功耗，所以要满足以上标准，需要固件和硬件端共同优化设计。

照明类设备的开关状态会记忆并被使用吗？

照明类设备的开关状态在固件内部实际是进行Flash记忆存储的，其记忆值根据功能的实际要求做相应的使用，具体如下：

• 设备电源上电如墙壁开关上电，会将上次记忆的状态强制更改为开，来满足实际生活场景中的照明要求。同时强制更改后的状态会重新存储到Flash中。
• 非电源上电情况下的设备重启，如OTA升级过程的软件重启，软件异常造成的看门狗重启等，重启前后的开关状态不改变。其目的在于保证非人为操作因素造成的异常不对终端用户用电造成困扰。设想一种场景，厂商在终端用户无感知的情况下推送了一次设备强制OTA升级以解决之前的功能缺陷，OTA升级过程中有一次软件重启，OTA之前是关灯状态，OTA之后灯突然打开了，这种情况肯定是终端用户无法接受的。

在印度、南美等一些电网易波动的地区，电源上电强制开灯影响用户实际生活，比如半夜突然亮度影响入睡，这种情况应该怎么解决？

针对这种情况，涂鸦设计了一种功能勿扰模式，需要在指定时间区间内连续上下电两次才会把灯打开。该功能可以有制造厂商在OEM配置项中打开，或者通过PID中增加相应的可选dp,来打开该功能。同时注意，在这些地区，无论勿扰模式是否打开，都建议OEM配置项中设备重置配网的次数设置不要设置为3次，尽可能在5次以上，否则容易触发设备手动移除配网。

Wi-Fi灯开关的时候，从100%-0%渐变需要多久？是否可以在线配置默认时长？

目前照明部分产品如吸顶灯有设置渐变时长的专用dp,通过该 DP 可以调节渐变时长 ；其它品类不开放设置，其时长固定为800ms。但是需要注意的是800ms是0%-100%的全程渐变时间，如果是其它亮度，则渐变时间相应进行线性减小，如当前亮度为70%，则其渐变到灭灯时间为：800*（70/100）ms = 560ms 。

照明设备的亮度怎么调节？

自动化场景中灭灯条件下设置亮度，会生效吗？

自动化场景中，下发相应的亮度调节dp到设备端，设备会响应亮度值设置，但是不会改变开关状态。在开关打开后会发现灯光会变化到设置的亮度值，证明之前的亮度调节确实是生效了。

设备面板端灭灯条件下设置亮度又是怎么样的？

对于面板端设置，则根据不同设备的实际功能需求设计，来决定是否开灯同时设置亮度。但是该处理逻辑是由面板端下发相应的dp，设备端单纯进行响应来实现的，比如需求设计要求面板调亮度设置时进行开灯，设备实际下发的是亮度值+开关值两个dp触发设备端响应来实现的。
对于其它的自动化场景响应如色温，彩光等dp设置遵循一样的处理逻辑。

OEM配置项中的白光亮度最大值和白光最小值设置有何作用，实际是怎么使用的？

白光亮度最大值和最小值实际影响到的是设备实际输出的调光范围。面板端下发的亮度范围10 ~ 1000会线性转换到白光亮度最小值 ~ 最大值范围。比如白光亮度范围为10% ~ 100%，则面板端范围10 ~ 1000线性转换到100 ~ 1000。对于实际LED灯珠来讲，值低于一定程度后，其设置亮度值不足以维持灯光点亮，所以在实际配置白光亮度最小值时，不宜过小，一般来讲，不要低于5%。

白光模式下的OEM配置参数，冷暖混色最大功率的设置有何作用，灯光的亮度色温是如何变化的？

冷暖混色最大功率指冷暖混光两路同时点亮的最大输出功率。冷暖混光最大功率可配置，满足客户对CW输出大于100%功率的需求。冷暖混光最大功率iot平台配置默认100%，支持100%~200%可设，可设歩径10%。

支持路数：二路灯、五路灯

前提条件：

• PWM_CW模式：当为PWM_CCT驱动模式时，亮度通过CCT硬件驱动芯片分配到冷暖两路上，固件无法对其进行放大；
• PWM非互补输出：当采用冷暖混光最大功率大于100%时，固件会强制将冷暖两路PWM输出设置为非互补输出。
• 全范围色温不受影响：在0到100的整个色温范围内，冷暖混光功率的变化不影响灯光色温。冷暖混光功率的线性变化针对0~1000的所有亮度范围生效，而非只针对最大亮度。

照明设备的色温怎么调节？

LED灯珠的实际色温范围是2700K ~ 6500K,涂鸦公版面板的色温范围是0% ~ 100%，其实际对应关系是怎么样的？

涂鸦固件不关心实际硬件灯珠的真实色温，而是根据色温的范围0 ~ 1000，对冷光、暖光两路输出做线性分配。比如：设置25%的色温值，实际是：暖光路输出75%的占空比，冷光路设置25%的占空比。假设LED灯珠的色温范围为2700K ~ 6500K,则该点对应的实际色温为（6000K-2700K）* 25%+2700K = 3525K。

照明设备的彩光效果怎么调节？

灯具发光的彩光颜色不正应该怎么处理？

涂鸦免开发固件内置了一套gamma表，用于对彩光灯光颜色进行校正。由于不同灯珠发光的色差问题，可能部分产品灯光彩光仍会不正，这时可以调节OEM配置参数中的gamma系数和白平衡参数进行色彩校正。至于如何调整gamma系数和白平衡参数，可以详询涂鸦FAE，提供专业的调试工具及文档支持。

厂商在彩光模式做ERP频闪测试，不通过是怎么回事？

对于频闪测试，光源的方案，主要看白光和暖光，RGB作为氛围光源时不做要求，一般不做频闪测试。灯带的方案，主要是RGB。RGB作为主发光，去往欧洲的方案，要测ERP频闪。彩光模式下，RGB的默认gamma系数分别是100%，70%，75%，故RGB最大亮度情况下，红光无频闪，蓝光绿光有频闪。
若要解决该问题，对于PWM驱动来说，可以考虑提高PWM频率。

场景调节是什么？

照明情景DP的协议及具体用法？

情景模式控制数据格式如下：类型：字符 Value: 0011223344445555666677778888
数据解释（Tuya 公版APP）：
00：情景号
11：单元切换间隔时间（rang：40-100，unit：100ms）
22：单元变化时间（rang：40-100，unit：100ms）
33：单元变化模式（0静态1跳变2渐变）
4444：H（色度：0-360，0X0000-0X0168）
5555：S (饱和：0-1000, 0X0000-0X03E8)
6666：V (明度：0-1000，0X0000-0X03E8)
7777：白光亮度（0-1000）
8888：色温值（0-1000）
备注：当前Tuya公版APP可设定8个情景，每个情景中可设定8个单元，该数据最长长度为 8*26 + 2 = 210(byte)情景设置参数及实际效果：

1. 单元变化模式；① 静态（static）变化模式 – 情景中单位仅存在一个单元，仅渐变显示成该单元的颜色。② 跳变（jump）变化模式 – 情景中至少存在两个单元，单元之间按照设定的单元切换间隔时间来跳变切换。③ 呼吸（dynamic）变化模式 – 情景中至少存在两个单元，单元之间按照设定的单元切换时间间隔来渐变切换。
2. 单元切换间隔时间和变化时间；①单元切换间隔Time设置值和变化的时间Speed设置值，在Tuya公版面板中，下发的数值相同，并且数值与实际调光速度呈负相关，对应的实际物理单位：100ms。② 数值和调光效果的转化公式：呼吸（dynamic）变化模式Time = （110 – Time设置值）* 100ms ；Speed = Time / 2 ；跳变（jump）变化模式Time = （105 – Time设置值）* 100ms ；Speed = Time ；
3. 具体解释：在呼吸变化时，最小的单元切换间隔为1000ms，其中单元变化时间为500ms，最大的单元切换间隔为7000ms，其中单元变化时间为3500ms。在跳变变化时，最小单元切换间隔时间为500ms，最大单元切换间隔为6500ms，单元变化时间无实际意义。
   呼吸变化示意图
   跳变变化示意图

音乐模式是什么？

音乐模式的实现过程是怎样的，要实现灯光的实时音乐变化效果，要注意到哪些方面？

当前的音乐模式为App音乐模式，其实现过程是：打开涂鸦App，切换到面板音乐模式，播放手机音乐，App端进行手机麦克风拾音，通过一定的算法将拾音数据转换为RGB彩光数据，实时下发到照明设备，照明设备按照下发数据进行灯光实时变化。
要注意必须将照明设备切换到音乐模式，下发的实时音乐RGB数据才会生效。当前音乐RGB数据约150ms下发一次。

SDK支持的Wi-Fi协议的密码长度是多少？扫描路由的SSID是多少？

扫描路由ssid不超过32字节，密码长度0~64字节（0字节表示免密设置）。

BK公版固件从Wi-Fi切换到蓝牙控制，功能会不会变化，如果有变化，有哪些变化?

总体来讲不会有变化，特定功能细节及执行逻辑会有差别。具体差别如下：

• 需要获取本地时间的任务，在纯蓝牙控制时不能拉取时间到本地，功能失效。如入睡唤醒，生物节律，设备定时。验证方法是：使用蓝牙发现进行wifi配网成功后，设置入睡唤醒任务，按照进入蓝牙控制的方式断开wifi，待蓝牙控制正常后，重新断电上电，此时进入纯蓝牙数据通信，由于设备拉取不到网络时间，时间到达后入睡唤醒类任务不会执行。
• 蓝牙控制模式下，情景单元不要设置为8个。情景模式当前蓝牙允许的数据最大长度为200个字节，8个情景单元超出了允许范围，无法下发执行。
• 蓝牙控制模式下，断电上电后设备首次上报到面板的状态无法与设备同步。原因是拉取不到dp schema。
• Wi-Fi群组功能不可用。之前调研过双模的灯类产品，目前的双模是支持 Wi-Fi + 单点蓝牙，蓝牙只在Wi-Fi断网时使用。并且此蓝牙并不是 mesh ，而是手机一对一单点连接，一般性能较好的手机，最多支持链接7个单点蓝牙设备。（实测可以先创建1个群组，然后通过app的一键执行添加群组，在蓝牙控制时下可以一键控制所有设备，这个属于APP客户端的处理逻辑，如果设备有蓝牙能力，会通过蓝牙进行补偿执行）。

Raw、String类型 DP 的编码方式，上报下发格式问题？

base64编解码：基于64个可打印的字符来表示二进制的数据的一种方法。可以将 AQAAAzIyAQAA 放进编码器转换观察一下。

1. raw上报下发的数据是经过Base64编码的数据，这样既减小了数据量，又有一定加密能力，也能编解码各种非英文以外的其他语言。照明DP上报前原数据为HEX格式。
2. string类型dp，照明DP而言，就是通过字符型直接传输，下发上报过程中未经过base编解码。上报前原数据为文本格式或者说字符串格式。