rdk-isp-tuning

RDK ISP 画质调参

适用于板上已经存在目标 sensor 驱动、模式配置和 *_tuning.json，需要优化 RAW→ISP→NV12 的画质。没有驱动、没有 sensor index 或 I2C/MCLK 不通时，先做 sensor bring-up，不要用 tuning JSON 掩盖硬件问题。

安全边界

1. 先运行 get_isp_data -h 确认 sensor、分辨率、帧率和 index；不要凭记忆写死 index。
2. 只修改用户指定模式对应的 JSON。例如目标是 1920×1080，就不得顺手修改同 sensor 的 3264×2448 JSON。
3. 修改前记录目标 JSON 和同 sensor 其他 JSON 的 MD5，并把目标文件备份到 /userdata/moss-isp-tuning/<sensor>/<mode>/backups/。每个候选也保留独立副本。
4. cam-service 必须保持可恢复状态。采集和回灌时不要 stop/killall cam-service；加载新 JSON 时只允许短暂 systemctl restart cam-service，随后必须验证 systemctl is-active cam-service 为 active。
5. JSON 上传后先做语法校验，再覆盖正式文件。失败时立即恢复备份并重启服务。永远不要把未验证候选留在板端。
6. 不要把“画面更亮”当作“画质更好”。最佳版本必须同时检查曝光、色彩、噪声、细节、剪裁和稳定性。

建立可复现基线

调参前至少准备以下场景；手机参考图必须与板端相机尽量同机位、同构图、同光线：

• 白天室内普通照度
• 窗口或灯具在画面内的大光比
• 中性白/灰物体与常见肤色
• 文字、布料、木纹等细纹理
• 暗部或低照场景

每个候选都用同一个采集方法。不要用“另起一个进程预热、再起一个进程拍照”，因为新 ISP 实例不会继承前一个实例的 AEC/AWB 状态。使用同一个 get_isp_data 进程延时后批量抓帧：

sensor_idx="${SENSOR_INDEX:?set SENSOR_INDEX}"
settle_seconds="${SETTLE_SECONDS:?set SETTLE_SECONDS from measured convergence}"
capture_timeout_seconds="${CAPTURE_TIMEOUT_SECONDS:?set a bounded capture timeout}"
case "$sensor_idx:$settle_seconds:$capture_timeout_seconds" in
  *[!0-9:]*|:*|*::*|*:) echo "invalid numeric capture parameter" >&2; exit 2 ;;
esac
if [ "$settle_seconds" -le 0 ] || [ "$capture_timeout_seconds" -le "$settle_seconds" ]; then
  echo "capture timeout must be greater than a positive settle time" >&2
  exit 2
fi
capture_root=/userdata/moss-isp-tuning/captures
mkdir -p "$capture_root"
capture_dir=$(mktemp -d "$capture_root/run.XXXXXX") || exit 1
cd "$capture_dir" || exit 1
(sleep "$settle_seconds"; printf 'lq') \
  | timeout "$capture_timeout_seconds" \
      /app/multimedia_samples/sample_isp/get_isp_data/get_isp_data -s "$sensor_idx" -c io \
      >/dev/null 2>&1

先从基线流的 AEC/AWB 指标确定 settle_seconds，再为命令退出预留有限余量设置 capture_timeout_seconds；不要把示例等待时间当成所有 sensor 的固定收敛时间。每次采集使用新的 capture_dir，清理时也只删除该次目录，不要用 rm -f ~/handle_*.yuv 之类的宽泛通配符。