avsFineTuningTool

FineTuing工具使用说明

作者：康家琦 时间：2025年1月9日

该程序用于调整和更新AVS（全景视频拼接）参数，并且可以实时通过web或者VLC完成查看微调结果。以下是使用说明：

注意：本文档仅适用于AVS FineTuningTool程序.
当前程序仅适用于CD3403芯片作为微处理器，且使用拼接通道0，通道内pipe数量为4的情况。
该情况可以通过查看指定调试信息查看
cat /proc/umap/avs

编译

编译该工程需要cd3403的交叉编译工具链，并且位于linux虚拟机中为佳。编译命令如下： 编译虚拟机中的工程，需要先有cd3403的SDK，如果cmake报错，请尝试修改CMakeLists.txt中的路径。

cmake .
cmake --build .

确保已经把程序目录下的文件准备完毕

需要一个文件夹./calibration/，里面包含了cal文件，通过PQtool生成，生成的详细方法查看《嵌入式标定流程一览》。 当前的cal文件仅支持一种名称：4eye_2688x1520.cal，如果名称与之不一致会导致无法正常使用.

如果出现了提示无权限的情况，可以通过以下命令解决：

chmod +x ./avsFineTuningTool 

运行

运行程序时需要提供以下参数：

./avsFineTuningTool -INDEX <value> -YAW <value> -PITCH <value> -ROLL <value> -OFFSETX <value> -OFFSETY <value> -DISTANCE <value> -PATH <value>

参数说明

• -INDEX <value>: 设置索引值。
• -YAW <value>: 设置偏航角度。
• -PITCH <value>: 设置俯仰角度。
• -ROLL <value>: 设置滚转角度。
• -OFFSETX <value>: 设置X轴偏移量，需要注意的是某些情况下图像是经过倒放后进行投影的，需要考虑offsetx和offsety的转换。
• -OFFSETY <value>: 设置Y轴偏移量。
• -DISTANCE <value>: 设置拼接距离，值必须在0.5到10000之间。
• -PATH <value>: 设置保存路径,保存index对应的LUT文件到指定路径，如果没有路径，则会保存到当前目录下。

示例

./avsFineTuningTool -INDEX 1 -YAW 10.5 -PITCH 5.2 -ROLL 3.1 -OFFSETX 0.5 -OFFSETY 0.3 -DISTANCE 100 -PATH /path/to/save

注意事项

• 确保所有参数都已正确提供，否则程序将输出错误信息并退出。
• -INDEX 必须存在，用以指定需要生成的LUT文件, 参数的值必须在0到3之间。
• -DISTANCE 参数的值必须在0.5到10000之间，否则程序将输出错误信息并退出。
• 提供的参数值必须是整数，在后台会*100。
• 最少提供一个INDEX加上任意一个参数，否则程序将输出错误信息并退出。

功能

程序将根据提供的参数进行以下操作：

1. 设置拼接距离。
2. 设置索引对应的偏航、俯仰和滚转角度。
3. 设置索引对应的X轴和Y轴偏移量。
4. 设置AVSP LUT保存路径。
5. 生成LUT文件。
6. 更新组属性。

可以查看程序输出信息，以确认是否成功生成LUT文件。