4、IQ Tuning工具入门:安霸IQ Tuning Tool安装、工具界面布局、连接开发板、实时预览与抓图

好,咱们进入第四讲。这一讲很关键,是真正动手前的最后一步理论准备。说白了,就是让你学会怎么把安霸的IQ Tuning工具跑起来,并且能和开发板正常“对话”。

我见过不少新人,算法理论背得滚瓜烂熟,结果卡在工具安装和环境配置上,一卡就是一整天。这其实最冤枉。所以这一章,咱们把流程拆开揉碎,你跟着走一遍,基本就不会出问题。

4.1 工具安装与环境准备

安霸的IQ Tuning工具,官方叫法通常是 Ambarella IQ Tool 或者 Ambarella Tuning Tool。它不是一个独立的安装包,而是集成在SDK里的。你拿到SDK后,在 host/tools/ 目录下就能找到。

安装步骤其实很简单,但有几个坑我得提前跟你说。

注意: 安霸工具对Python版本有严格限制。我建议你使用 Python 3.6 到 3.8 之间的版本。太高或太低,都会导致依赖库安装失败。我曾经在一个项目里用了Python 3.10,结果折腾了两天才发现是版本不兼容。

具体安装流程如下:

  1. 解压SDK:找到 ambarella_iq_tool.tar.gz,解压到你习惯的工作目录。
  2. 安装依赖:进入解压后的目录,运行 pip install -r requirements.txt。这里建议用虚拟环境,避免污染系统Python。
  3. 配置环境变量:你需要把工具路径加到 PATH 里。我个人习惯在 ~/.bashrc 里加一行 export AMBA_IQ_TOOL=/path/to/iq_tool。
  4. 验证安装:在终端输入 amba_iq_tool --version,如果能看到版本号,就说明装好了。
小技巧: 如果你在公司内网,pip下载可能会很慢。我建议你提前把 requirements.txt 里的包名和版本号记下来,用 pip download 先下载到本地,再离线安装。这招在客户现场特别管用。

4.2 工具界面布局:别被密密麻麻的控件吓到

第一次打开IQ Tool,你可能会觉得界面有点复杂。别慌,其实它的布局逻辑非常清晰。我把它分成四个核心区域,你记住这四个区,操作起来就顺手了。

下面这张图,是我根据实际工具界面画的布局图,你对照着看会更清楚。

安霸IQ Tuning Tool 界面布局图 安霸IQ Tuning Tool 界面布局 顶部菜单栏 (File / View / Tools / Help) 左侧面板 设备列表 / 通道管理 参数树 (Sensor / ISP / 3A) 中央主视图 实时预览画面 / 抓图显示 直方图 / 波形图 右侧面板 参数调节滑块 寄存器读写 底部状态栏 (FPS / 曝光时间 / 增益 / 连接状态)

你看,是不是很清晰?

  • 顶部菜单栏:文件操作、视图切换、工具选项都在这里。我常用的就是 View -> Layout,可以快速切换单视图或四视图。
  • 左侧面板:这是你的“设备管理器”。所有连接的开发板、摄像头通道都会列在这里。双击某个通道,右侧面板就会加载对应的参数。
  • 中央主视图:实时图像预览区。你可以在这里看到摄像头拍到的画面,也可以查看抓图后的静态图像。
  • 右侧面板:调参的核心区域。曝光、白平衡、锐度、降噪……所有你能想到的参数,都在这里以滑块或数值框的形式呈现。
  • 底部状态栏:实时显示当前的帧率、曝光时间、增益值。调参时,我习惯一直盯着这里,看参数调整对帧率有没有影响。

4.3 连接开发板:有线连接与网络配置

工具装好了,界面也熟悉了,接下来就是让工具和开发板“握手”。

安霸平台通常通过 以太网 连接。你需要一根网线,把开发板和电脑直连,或者通过交换机连接。

连接步骤:

  1. 设置开发板IP:开发板启动后,在串口终端里执行 ifconfig eth0 192.168.1.100。我习惯用静态IP,避免每次重启IP都变。
  2. 设置电脑IP:把电脑的网口IP设为同一网段,比如 192.168.1.101。子网掩码 255.255.255.0。
  3. 测试连通性:在电脑上 ping 192.168.1.100,能通就说明物理连接没问题。
  4. 启动工具并连接:在IQ Tool里,点击 File -> Connect,输入开发板的IP地址和端口号(默认是 5000)。
关键点: 连接成功后,左侧面板的设备列表里会出现你的开发板。如果没出现,先检查防火墙。Windows防火墙经常会拦截安霸工具的通信端口。我建议你直接把 amba_iq_tool.exe 加入防火墙白名单。

4.4 实时预览:让图像“动”起来

连接成功后,你就可以看到实时画面了。在左侧面板双击你的摄像头通道,中央主视图就会开始显示视频流。

这里有几个操作你需要知道:

  • 暂停/恢复预览:按空格键可以暂停画面,方便你仔细观察某个细节。再按一次恢复。
  • 缩放:滚动鼠标滚轮可以放大/缩小画面。按住 Ctrl 键再滚轮,可以精细调节。
  • 全屏:按 F11 进入全屏模式,调参时我经常用这个模式,视野更大。
避坑指南: 我曾经遇到过预览画面卡顿、掉帧的情况。后来发现是电脑的网卡开启了“节能模式”。你可以在设备管理器里找到网卡,在“电源管理”选项卡里,取消勾选“允许计算机关闭此设备以节约电源”。这个问题很隐蔽,但影响很大。

4.5 抓图:保存你的调试成果

调参过程中,你肯定需要保存当前画面,用来做前后对比,或者发给同事确认。抓图功能就在工具栏上,一个相机图标。

抓图有两种模式:

模式 快捷键 说明 文件格式
快速抓图 Ctrl + S 直接保存当前预览帧,适合快速记录 JPEG / PNG
原始数据抓图 Ctrl + Shift + S 保存未经ISP处理的RAW数据,用于深度分析 RAW (Bayer格式)

我个人强烈建议你养成一个习惯:每次调整关键参数后,都抓一张图。并且给文件命名时带上参数信息,比如 20240520_AE_Target_100_ISO_200.raw。这样后期复盘时,你才能清楚地知道每张图对应的参数状态。

注意: 原始数据抓图生成的RAW文件非常大,一张4K分辨率的RAW图可能超过50MB。请确保你的硬盘有足够空间。另外,RAW文件需要用专门的工具(如DCRAW或安霸自带的RAW Viewer)才能打开。