一、软光敏用途与场景

维度	软光敏（软件算法）	硬光敏（光敏电阻）
原理	基于图像Sensor + AE/AWB算法分析整幅画面亮度	物理光敏电阻检测单点光照
成本	低，无需额外硬件	需增加光敏电阻及电路，成本略高
反应速度	开机后需几秒稳定，切换略有延迟	毫秒级快速响应
准确性	基于整体画面判断，抗局部反光干扰能力强	易受小范围反射光、遮挡影响
稳定性	日夜切换准确度更高，误触发少	可能被车灯、手电筒等瞬间强光误触发
灵活度	可动态调整感光阈值，适配不同场景	阈值固定，调节需更换硬件
适用场景	复杂光照环境、需要精准日夜切换的监控场景	简单光照环境、需要极速响应的场景

二、软光敏关键参数说明

2.1 软光敏涉及到的参数如图所示，其中我们只提供部分参数给产测进行修改，分别为day_to_night_lum、night_to_day_lum、awb_night_dis_min、awb_night_dis_max。

2.2 还有一个关键参数部分主控可能不太一样，但不提供修改，我把知道的差异形成表格

tuya6 主控	可见光百分比non_infrared_ratio_th参数
tuya6 ev330/av100/km01	35
tuya6 av130	20

三、软光敏的参数说明和要求

3.1 调试前的说明

3.1.1 仅需修改day_to_night_lum、night_to_day_lum、awb_night_dis_max（白平衡没有进行较大改动awb_night_dis_max一般也不用修改, tuya6 默认850， tuya5默认3000）

3.1.2 目前awb_night_dis_min默认写2000,不用修改当前为无效值

3.1.3 day_to_night_lum和night_to_day_lum 均为EV值参数，分别是白天且晚上、晚上切白天使用，awb_night_dis_max用于调试夜切白的白平衡参数

3.1.4 EV值的变化跟环境亮度有关，越亮值越小，白天和晚上分别对应的EV值范围不同（彩光和黑白模式对EV值对色温的算法不同）

3.1.5 调试过程中推荐直接把day_to_night_lum调至200000000，night_to_day_lum调至100000。为什么要这么写呢？因为让白天不切换黑夜，在黑夜状态下不让切白天。目前day_to_night_lum远大，night_to_day_lum远小于需要的值。

3.2 软光敏阈值要求

3.2.1 新版本要求：切白天：≥5lux， 切黑夜：≤1lux , 要求±0.5lux

3.2.2 旧版本要求：切白天：≥3lux， 切黑夜：≤1lux , 要求±0.5lux

四、软光敏的布景说明

4.1 调试环境布景

4.1.1场景布局如果，图2实际调试过程中需要关闭室内灯

4.1.2 下图示例用的是双补光灯的方式进行调试，相对单补光灯调试方式较准一点，能够更接近实际需要的lux值

4.1.3 单补光灯的条件下，是补光灯放在设备这杯照设备對面的墙软光敏识别漫反射回来的光，只需要测试设备这边的lux满足需求即可，但是相对双补光灯偏离理想场景一点

4.1.4 双补光灯按照3.2.1需调整好设备和设备對面墙的lux值，用照度器测试出来的值差异不超过±0.2 lux

五、软光敏调试实操

本次实操软光敏调试按照新版本的阈值要求：切白天：≥5lux， 切黑夜：≤1lux , 要求±0.5lux

前提：

升级为可以调试查看软光敏参数的版本：需要在软件里添加这条代码：ak_print_set_level(MODULE_ID_VPSS, LOG_LEVEL_INFO);

这个前期是让设备在调试过程中不会切换，便于调试过程中获取实时数据和参数校验。

5.1 调白天切晚上（切黑夜）

5.1.1 固定参数参数配置为：SoftPhotoSensitive = 200000000,1000,2000,850

5.1.2 设备处于白天彩色状态下，用补光灯把环境亮度调节到1lux-0.2lux，设备打印参数如图：

5.1.3 记录上图的EV值，同时对补光灯进行反复调整色温和亮度，达到1lux-0.2lux，确认参数是否基本一致就可以了

5.1.4 从大量的测试数据，选取EV值的方法：选取相对接近实际众数的值

5.1.5 按照选中的参数进行填值和反复测试，参数更改例子：SoftPhotoSensitive = 14393700,100000,2000,850

5.2 调晚上切白天（切白天）

5.1.1 固定参数参数配置为：SoftPhotoSensitive = 14393700,1000,2000,850

5.2.2 设备处于晚上黑白状态下，用补光灯把环境亮度调节到5lux+0.2lux，设备打印参数如图：

5.2.3 记录上图的EV值，同时对补光灯进行反复调整色温和亮度，达到5lux+0.2lux，确认参数是否基本一致就可以了

5.2.4 从大量的测试数据，选取EV值的方法：选取相对接近实际众数的值

5.2.5 按照选中的参数进行填值和反复测试，参数更改例子：SoftPhotoSensitive = 14393700,25344,2000,850

5.2.6 一般最后一个参数850不用变更是为了防止夜视不能切换到白天的问题。

5.2.7 如果刚好遇到晚上切白天EV已经小于标定的参数，但是确实还没切白天的问题，我们需要注意一下，打印的数据non_infrared_ratio可见光百分比可能没有超过 35/20（参考2.2）

5.2.8 awb_night_dis_max=850 参数说明:awb_night_dis_max值越大，打印出来的non_infrared_ratio值越小