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,结果折腾了两天才发现是版本不兼容。
具体安装流程如下:
- 解压SDK:找到
ambarella_iq_tool.tar.gz,解压到你习惯的工作目录。 - 安装依赖:进入解压后的目录,运行
pip install -r requirements.txt。这里建议用虚拟环境,避免污染系统Python。 - 配置环境变量:你需要把工具路径加到
PATH里。我个人习惯在~/.bashrc里加一行export AMBA_IQ_TOOL=/path/to/iq_tool。 - 验证安装:在终端输入
amba_iq_tool --version,如果能看到版本号,就说明装好了。
小技巧: 如果你在公司内网,pip下载可能会很慢。我建议你提前把
requirements.txt 里的包名和版本号记下来,用 pip download 先下载到本地,再离线安装。这招在客户现场特别管用。
4.2 工具界面布局:别被密密麻麻的控件吓到
第一次打开IQ Tool,你可能会觉得界面有点复杂。别慌,其实它的布局逻辑非常清晰。我把它分成四个核心区域,你记住这四个区,操作起来就顺手了。
下面这张图,是我根据实际工具界面画的布局图,你对照着看会更清楚。
你看,是不是很清晰?
- 顶部菜单栏:文件操作、视图切换、工具选项都在这里。我常用的就是 View -> Layout,可以快速切换单视图或四视图。
- 左侧面板:这是你的“设备管理器”。所有连接的开发板、摄像头通道都会列在这里。双击某个通道,右侧面板就会加载对应的参数。
- 中央主视图:实时图像预览区。你可以在这里看到摄像头拍到的画面,也可以查看抓图后的静态图像。
- 右侧面板:调参的核心区域。曝光、白平衡、锐度、降噪……所有你能想到的参数,都在这里以滑块或数值框的形式呈现。
- 底部状态栏:实时显示当前的帧率、曝光时间、增益值。调参时,我习惯一直盯着这里,看参数调整对帧率有没有影响。
4.3 连接开发板:有线连接与网络配置
工具装好了,界面也熟悉了,接下来就是让工具和开发板“握手”。
安霸平台通常通过 以太网 连接。你需要一根网线,把开发板和电脑直连,或者通过交换机连接。
连接步骤:
- 设置开发板IP:开发板启动后,在串口终端里执行
ifconfig eth0 192.168.1.100。我习惯用静态IP,避免每次重启IP都变。 - 设置电脑IP:把电脑的网口IP设为同一网段,比如
192.168.1.101。子网掩码255.255.255.0。 - 测试连通性:在电脑上
ping 192.168.1.100,能通就说明物理连接没问题。 - 启动工具并连接:在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)才能打开。