[sdm660 android9.0]补光灯代码分析

高通相关dtsi解析

驱动程序 v2 用于在背景光线昏暗时为相机传感器提供照明以捕捉良好的画面。它也可用于手电筒/手电筒应用。
它是 Qualcomm Technologies Inc. 参考平台上 PMIC 的一部分。
主节点：
所需属性：
- 兼容：应该是“qcom，qpnp-flash-led-v2”
- reg : 闪光灯 LED 模块的基址和大小
- qcom,pmic-revid : PMIC revid 模块的模型。这用于识别 PMIC 子类型。
可选属性：
- 中断：指定与闪光灯相关的中断。
- 中断名称：指定与中断关联的中断名称。
- qcom,hdrm-auto-mode : 选择是否启用净空自动模式的布尔类型
- qcom,isc-delay-us : 指定短路延迟的整数类型。有效值为 32、64、128、192。单位为 uS。
- qcom,warmup-delay-us : 指定预热延迟的整数类型。有效值为 32、64、128、192。单位为 uS。
- qcom,short-circuit-det ：启用短路故障检测的布尔属性。
- qcom,open-circuit-det ：启用开路故障检测的布尔属性。
- qcom,vph-droop-det ：启用 VPH 下垂检测的布尔属性。
- qcom,vph-droop-hys-mv : 指定 VPH 下垂滞后的整数属性。仅在指定 qcom,vph-droop-det 时使用。有效值为 0、25、50 和 75。
单位为毫伏。
- qcom,vph-droop-thresh-mv : 指定 VPH 下降阈值的整数属性。仅在指定 qcom,vph-droop-det 时使用。有效值为 2500 到 3200，步长为 100。单位为 mV。
- qcom,vph-droop-debounce-us : 指定 VPH 下垂去抖动时间的整数属性。仅在指定 qcom,vph-droop-det 时使用。有效值为 0、8、16 和 26。单位为 uS。
- qcom,led1n2-iclamp-low-ma ：整数属性，用于指定电流钳低电平以进行缓解。单位为 mA。允许
值与 qcom,max-current 下相同。
- qcom,led1n2-iclamp-mid-ma ：整数属性，用于指定电流钳位中间电平以进行缓解。单位为 mA。允许
值与 qcom,max-current 下相同。
- qcom,led3-iclamp-low-ma ：整数属性，用于指定电流钳低电平以进行缓解。单位为 mA。允许
值与 qcom,max-current 下相同。
- qcom,led3-iclamp-mid-ma ：整数属性，用于指定电流钳位中间电平以进行缓解。单位为 mA。允许
值与 qcom,max-current 下相同。
- qcom,vled-max-uv ：闪电流预测缓解的整数属性。默认值为 3500000 uV。
- qcom,ibatt-ocp-threshold-ua ：闪电流预测缓解的整数属性。默认值为 4500000 uA。
- qcom,rparasitic-uohm：用于指示电池电阻寄生分量的闪光电流预测缓解的整数属性。默认值为 0 uOhm。
- qcom,lmh-ocv-threshold-uv ：闪存电流抢占式 LMH 缓解所需的属性。默认值为 3700000 uV。
- qcom,lmh-rbatt-threshold-uohm ：闪存电流抢占式 LMH 缓解所需的属性。默认值为 400000 uOhm。
- qcom,lmh-mitigation-sel ：配置闪存电流抢占式 LMH 缓解的可选属性。接受的值为：0：MITIGATION_DISABLED 1：MITIGATION_BY_ILED_THRESHOLD 2：MITIGATION_BY_SW
默认值为 2。
- qcom,chgr-mitigation-sel ：可选属性，用于配置闪光电流抢占式充电器缓解。
接受的值为：0：MITIGATION_DISABLED 1：MITIGATION_BY_ILED_THRESHOLD 2：MITIGATION_BY_SW   默认值为 2。
- qcom,lmh-level ：配置闪存电流抢占式 LMH 缓解的可选属性。接受的值为 0、1 和 3。默认值为 0。
- qcom,iled-thrsh-ma：可选属性，用于配置触发硬件抢占式缓解的 LED 电流阈值。单位为 mA。默认值为 1000。可接受的值在 0 - 3100 范围内，步长为 100。0 禁用自主硬件缓解。
- qcom,thermal-derate-en ：启用闪电流热缓解的布尔属性。
- qcom,thermal-derate-current ：用于散热的一系列电流限制。如果指定了 qcom,thermal-derate-en，则为必需。单位为 mA。格式是qcom，热降额电流 = <OTST1_LIMIT, OTST2_LIMIT, OTST3_LIMIT>。
- qcom,otst-ramp-back-up-dis : 在热降额触发后禁用电流斜坡备份的布尔属性
- qcom,thermal-derate-slow ：整数属性来指定缓慢降低热速率。单位在美国。允许
值为：128、256、512、1024、2048、4096、8192 和 314592。
- qcom,thermal-derate-fast ：整数属性，用于指定快速降低热速率。单位在美国。允许
值为：32、64、96、128、256、384 和512.
- qcom,thermal-debounce : 指定热去抖动时间的整数属性。仅当 qcom,thermal-derate-en 时使用被指定。

子节点内的必需属性。智利节点包含每个单独 LED 的设置。每个 LED 硬件都需要一个自己的节点和一个开关节点来控制亮度。为了打开/关闭LED和更好的调节器控制，引入了“led:switch”节点。 “led:switch”从其他节点获取几个现有属性以简化操作。为了向后兼容，切换节点可以是可选的：
- 标签：将使用的 LED 类型，“闪光灯”或“手电筒”。
- qcom,led-name : LED 的名称。可接受的值为“led:flash_0”、“led:flash_1”、“led:torch_0”、“led:torch_1”
- qcom,default-led-trigger：触发相机闪光灯和手电筒。可接受的值为“flash0_trigger”、“flash1_trigger”、“torch0_trigger”、torch1_trigger”
- qcom,id : 每个物理 LED 的枚举 ID。可接受的值为“0”、“1”等。
- qcom,max-current : 此 LED 允许的最大电流。有效值应该是 0 到 1000 之间的整数，表示 0 到 1000 mA。
- qcom,pmic-revid : PMIC 修订 ID 源。 PMI8996 修订检查需要此属性。
子节点内的可选属性：
- qcom,current : LED 的默认电流强度。可接受的值应该是 0 t 1000 之间的整数，表示 0 到 1000 mA。
- qcom,duration : 闪光灯 LED 的持续时间。当持续时间到期时，硬件将关闭闪光灯 LED。值应为 10 ms 到 1280 ms，增量步长为 10 ms。不适用于手电筒。 LED:SWITCH 节点需要处理用作闪光灯的 LED。
- reg<n> : reg<n> (<n> 代表数字。例如 0,1,2,..) 属性是添加对多个电源的支持。它包括两个属性调节器名称和最大电压。调节器节点内的必需属性：
- max-voltage：这指定调节器的最大电压。某些开关或升压调节器不需要此属性。

补光灯有两种工作模式：
Camera flash led分flash和torch两种模式。
Flash: 拍照时闪光灯瞬间亮一下的情况，电流比较大，目前是1000mA，最大电流不能超过led的最大承受能力。
Torch: 只用于录video或者拿led当手电筒的情况，电流不能太大，例如现在用的是200mA。
Flash的开启需要先从torch过渡，也就是电流慢慢增大，减小冲击。

1.库文件：
从sdm660_camera.xml中，pmic，
其代码位于：vendor/qcom/proprietary/mm-camera/mm-camera2/media-controller/modules/sensors/flash/libs/pmic/pmic_flash.h，最终编译生成 libflash_pmic.so 库
定义 使用闪光灯和手电筒时 跳过的帧数

static flash_lib_t flash_lib_ptr = {
   
  .flash_name = "pmic",
  .flash_driver_type = FLASH_DRIVER_TYPE_DEFAULT,
  .main_flash_on_frame_skip = 3,
  .main_flash_off_frame_skip = 3,
  .torch_on_frame_skip = 2,
  .torch_off_frame_skip = 2,
};
头文件中主要是定义了在闪光灯打开时，摄像头需要跳过的帧数，及在手机筒打开时需要跳过的帧数。
还是一个比较重要的就是 flash_driver_type，
当 .flash_driver_type = FLASH_DRIVER_TYPE_DEFAULT, 时，闪光灯的相关配置是由kernel 来定义的。
当 .flash_driver_type = FLASH_DRIVER_PMIC, 和其他值时，闪光灯的相关配置需要由本lib 库来定义。

2.通用代码vendor/qcom/proprietary/mm-camera/mm-camera2/media-controller/modules/sensors/flash/module/flash.c
vendor/qcom/proprietary/mm-camera/mm-camera2/media-controller/modules/sensors/module/module_sensor_offload.c
flash open动作是在 module_sensor_offload_open()中调用打开 闪光灯节点的。
flash 初始化是由 module_sensor_offload_init_config() 中来调用的

void module_sensor_offload_init_config( void* param1,  void* param2,  void* param3 __attribute__((unused)),
                      void* param4 __attribute__((unused)))
{
   
  // 初始化闪光灯 ，调用 flash_init(),打开闪光灯 lib 库
  SLOW("flash subdev id = %d",
  status = module_sensor_flash_init(s_bundle);
  
  // 获取使用闪光灯时，跳过的帧数，如果没设置，默认过滤 2 帧
  /* Get led frame skip timing parameters */
  SENSOR_SUB_MODULE_PROCESS_EVENT(s_bundle, SUB_MODULE_LED_FLASH, LED_FLASH_GET_FRAME_SKIP_TIME_PARAMS, s_bundle, rc);
  if (rc < 0) {
   
    SERR("failed to get led off frame skip time");
    s_bundle->main_flash_on_frame_skip = 2;
    s_bundle->main_flash_off_frame_skip = 2;
    s_bundle->torch_on_frame_skip = 2;
    s_bundle->torch_off_frame_skip = 2;
  }
}

2.1 初始化：flash_init()
vendor/qcom/proprietary/mm-camera/mm-camera2/media-controller/modules/sensors/module/module_sensor.c
module_sensor_flash_init()

vendor/qcom/proprietary/mm-camera/mm-camera2/media-controller/modules/sensors/module/module_sensor.c
boolean module_sensor_flash_init(module_sensor_bundle_info_t *s_bundle)
{
   
  /* Get flash name from camera config read from daemon init */
  a_name = s_bundle->sensor_common_info.camera_config.flash_name;

  SENSOR_SUB_MODULE_PROCESS_EVENT(s_bundle, SUB_MODULE_LED_FLASH, LED_FLASH_INIT, a_name, rc);
  return TRUE;
}

可以看出，在 module_sensor_flash_init() 中主要是调用 flash_init() 来做初始化的。—LED_FLASH_INIT
flash_init()

根据传递的name ，拼凑lib 库的字符串，此处为 libflash_pmic.so，同步将 pmic_flash.h中的结构体内容保存在 flash_ptr->driver_lib_data 中。
解析 pmic 参数信息，及 flash_driver_type 信息。
配置 I2C 地址信息
解析上下电信息，准备下发到 Kernel 中
下发 CFG_FLASH_INIT 命令到 Kernel 中，相关信息保存在 .flash_init_info 中

tatic int32_t flash_init(void *ptr, void *data)
{
   
  sensor_flash_data_t *flash_ctrl = (sensor_flash_data_t*)ptr;
  struct msm_flash_init_info_t flash_init_info;
  struct msm_flash_cfg_data_t flash_cfg;
  struct msm_camera_i2c_reg_setting_array *flash_init_settings = NULL;
  struct msm_sensor_power_setting_array *power_setting_array = NULL;

  SDBG("Enter");

  /* memset flash init info */
  memset(&flash_init_info, 0, sizeof(flash_init_info));

  // 1. 根据传递的name ，拼凑lib 库的字符串，此处为 libflash_pmic.so，同步将 pmic_flash.h中的结构体内容保存在 flash_ptr->driver_lib_data 中
  /* Load flash library */
  rc = flash_load_lib(ptr, name);
  // 2. 解析 pmic 参数信息。
  flash_update_settings_size(flash_ctrl->driver_lib_data);
  // 3. 解析 flash_driver_type 信息
  switch (flash_ctrl->driver_lib_data->flash_driver_type) {
   
    case FLASH_DRIVER_TYPE_PMIC:
        flash_init_info.flash_driver_type = FLASH_DRIVER_PMIC;
        break;
    case FLASH_DRIVER_TYPE_I2C:
        flash_init_info.flash_driver_type = FLASH_DRIVER_I2C;
        break;
    case FLASH_DRIVER_TYPE_GPIO:
        flash_init_info.flash_driver_type = FLASH_DRIVER_GPIO