企业官网建设流程全解析

简介：《高通调试工具使用手册》面向高通平台开发、刷机与相机调试人员，聚焦QPM、QFIL、Chromatix、ParameterParser等常用工具的使用要点与账号、许可、文件下载等配套信息，适合需要快速熟悉工具链和排查常见问题的初中级开发者参考。压缩包内共1个doc文件，约2.45MB，以单一文档形式集中整理工具说明、流程概览、参数编译、ISP与AWB仿真、Tuning参数区分及高通case提交流程等内容，目录线索清晰，便于按模块查阅。目前已有633人学习，可作为高通调试入门与日常查阅的参考资料，帮助读者建立工具链整体认识，了解各工具在开发调试中的定位、常见注意事项与问题处理思路。

1. 从一台黑屏样机说起：这份手册解决的是哪类问题

样机黑屏，插上电脑，设备管理器里冒出一个 9008 端口，产线那边催着今天必须出图。这种时候能救场的不是文档写得多漂亮，而是你手上有没有一条完整链路：把工具装起来、把固件刷回去、把 camera 参数生成出来、编译成 bin 推到机器上验证。这份高通调试工具使用手册覆盖的正是这条链路——QPM 管工具分发和 license，QFIL 管刷机，Chromatix 管参数生成，ParameterParser 管参数编译，仿真环节负责在不动机器的前提下先看结果。它适合刚接手高通平台 camera 调试、还没自己从零配过环境的新人照着走，也适合做了几年但一直在别人搭好的工程里改参数、对目录规范和端口状态一知半解的人补齐缺口。

2. 从 QPM 到 QFIL：把工具链装起来，把机器刷下去

高通平台上的工具不是一个个单独去网上找的，它们挂在一个统一的分发入口下面。QPM 既是工具管理器，也是访问其它工具的通行证，装不上它，后面 QPST、QFIL、Chromatix 全都无从谈起。这一章把安装、license、刷机、端口这四件事串成一条线，按顺序走完，一台砖掉的机器基本能救回来。

2.1 QPM 装不上，先看 VC 运行库

QPM 的安装包要去开发者官网的 createpoint 入口，在 tools 里检索 package 就能找到，选 Windows 版本下载。下载这一步有个细节容易被忽略：点开要下载的文件后，系统是在后台给文件加水印的，真正取文件要去 download 页面。PDF 可以点开直接另存，视频文件不能直接下载，必须回到 download 里取。所有下下来的文件都带账号水印，转发给别人等于把自己的账号信息一起发出去了，这个习惯我建议从一开始就别养成。

安装界面闪一下就消失、什么都没装上，是这套工具里最经典的翻车之一。原因不玄学，就是本机缺少 QPM 运行需要的 VC 运行库。去把 VC2010 装上，再重新跑安装包即可。为了确认到底缺哪个版本，我一般先用一条命令把已装的运行库列出来看看。

# 列出本机已安装的 Visual C++ 运行库，确认 2010 版是否存在 Get-ItemProperty HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\* | Where-Object { $_.DisplayName -like "*Visual C++*" } | Select-Object DisplayName, DisplayVersion | Sort-Object DisplayName

这条命令读的是注册表卸载项，DisplayName 里能直接看到年份和架构。注意两点：一是 QPM 安装器如果是 32 位，缺的是 x86 版运行库，光装 x64 没用；二是装完运行库要重启一次再装 QPM，否则个别情况下动态库仍加载不到。列表里如果只有 2015 以后的版本，基本可以断定就是这个问题。

2.2 license 与账号的设备额度

工具能下载的前提是账号挂上了有效 license。登录 license 管理页面后，能看到所属组织的通行证代码和有效期。这里有个硬限制：QPM 上可以添加别的 license，但只要不是同一个组织，就获取不到对应权限，加了也白加，表现为包能看见但下不下来。

个人账号这一侧还有一个额度问题。同一个账号可以多设备登录，但只有两台设备能正常使用，超出部分会被限制。表现是某台机器突然登不上、或者提示无权限，人一慌就以为是密码错了。处理方式很直接：进 Licenses 页面，把当前不需要用的设备勾上 Deactivate，腾出名额再登。

我在实际项目里的顺序是这样的：先在管理页面确认 license 有效期，再确认这台机器是不是被挤掉了，最后才怀疑网络和安装包。顺序反了会浪费很多时间，尤其是赶进度的时候，很容易一上来就重装，重装完发现还是登不上。

2.3 全擦与增量：QFIL 的两套刷机流程

QFIL 不在单独的分发包里，它在 QPST 里面，从 QPM 下载安装 QPST 就能拿到。个别版本装完之后开始菜单里找不到入口，这时去安装目录把 QPST 整个文件夹复制到本地路径下直接运行，比反复重装省事。

原生版本第一次刷机必须做一次全擦，这是后面所有增量刷机的前提。全擦的参数组合是固定的：Storage type 选 UFS，勾上 provision，path 指向刷机包里带 ddr 的那个文件，xml 选 ufs22 的 xml，然后点 provision 开始。全擦成功之后，一定记得回到 configuration 把 provision 的勾取消，不然后面正常刷机也会走进擦除流程，数据全丢。

增量刷机的关键在 xml 选择上：正常情况下把几个 rawprogram 文件全部勾上，工具会自动弹出对应的几个 patch.xml，也全部选上。少选一个分区，轻则开机异常，重则卡在开机 Logo 不动，然后你以为刷坏了，回去做全擦，白白多花半小时。

2.4 9008 端口的三种进入方式

QFIL 的所有刷机动作都必须在 9008 端口下进行，端口没出来，点 download 也没用。三种进法按优先级排：最方便的是指令进，设备正常开机且 adb 可用时一条命令切过去；其次是关机状态下同时按住开机键和音量上下键；最后是主板上短接强制进入，用于前两种都失效、刷机失败开不了机的情况。

# 确认设备在线且已授权 adb devices # 直接切到 9008 下载模式 adb reboot edl

adb devices输出里设备状态必须是 device 而不是 unauthorized，否则 reboot 指令发不下去。切完之后在设备管理器里能看到 9008 端口，QFIL 的 port 列表才会出现可选项。主板短接那条路有个顺序坑：必须先用镊子一端点强制下载触点、一端点接地，保持住之后再插 USB，顺序反了检测不到端口——这一点我第一次操作时反复插拔了七八次才反应过来。

3. Chromatix 工程创建：路径规范、stride 计算与参数文件结构

参数生成这一环，翻车点几乎全在工程创建阶段，而不在后面的调参。路径里带一个中文字符、工程目录和服务器上不一致、stride 算错一位，后面生成出来的参数看着正常，合到服务器上就是冲突，或者出图颜色直接偏掉。所以这一章重点讲建工程，讲清楚每个目录是干什么的。

3.1 目录结构必须和服务器对齐

Chromatix 建工程的第一步是在本地新建一组文件夹，目的是和服务器上的工程结构保持一致，方便后期 debug 和合参数。硬性要求是：整个路径的上下层都只能有英文和数字，项目名和工程路径不要有空格、特殊字符、中文。工程存放的文件夹路径最好和服务器上完全一致，勾选让代码路径与服务器相同的那个选项，这样后面提交代码会省掉大量路径映射的麻烦。

工程里要放三类东西：第一类是平台和项目提供的参数生成依赖环境，它控制我们的参数可以有哪些区分项、各个调试模块用哪个版本；第二类是 Chromatix 文件夹本身，放到 api 目录下；第三类是 sensor 配置和工程配置文件。前两类都需要去项目服务器上获取，不能自己造。

提示：路径问题不会在创建时报错，往往在生成参数或者提交代码时才暴露。养成习惯，建目录之前先看一眼路径字符串里有没有空格和中文字符。

我一般会新建一个纯英文的顶层目录，比如D:\work\proj_x\cam，把所有工程都放在这下面，项目名用下划线连接。这个习惯看着朴素，但能挡掉后面一半的玄学问题。

3.2 sensor 配置与 stride 计算

Sensor 配置页面要填的字段不多，但每一项都影响出图。常见的是：sensor 名称、满尺寸宽高、bit 位深、sensor type、以及 stride 值。sensor type 现在基本都是 Bayer，黑白的 sensor 才可能用到 mono。其它信息在项目信息和模组 Guide 上都能查到，不需要猜。

真正需要确认的是 stride 的计算方式，因为不同客户给的计算方式不一样。常见做法是按宽度乘 5 除以 4，再除以 80 取整后向上取整，最后乘 80。

import math def calc_stride(width: int) -> int: """按 width * 5 / 4 / 80 向上取整再乘 80 计算 stride""" # 5/4 来自 10bit 数据打包成字节时的膨胀系数 # 80 是对齐粒度，不同平台可能不同，需与项目确认 return math.ceil(width * 5 / 4 / 80) * 80 # 几个常见宽度验证一下结果 for w in (1920, 3264, 4000, 4096): print(w, calc_stride(w))

这段代码里三个参数要理解清楚：width 是 sensor 输出的有效像素宽度，不是模组物理尺寸；5/4 这个系数来源于 10bit 数据打包成字节的膨胀比例，如果项目用的是 8bit 或 12bit 输出，系数要跟着换；80 是对齐粒度，换平台时要重新确认。算出来的值如果和模组 Guide 上给的差不多个位数，说明对齐粒度用对了；如果差出几十上百，先怀疑粒度，别怀疑公式。

如果手头已经有现成的 sensor 文件，可以直接 load 进来，比手工填快也不容易错。填完点 OK，工具会直接生成参数。

3.3 生成后的参数文件怎么读

生成完参数，界面上会分成几块：3A、ISP pipeline、simulation。落到磁盘上，STATS 文件夹下是 3A 的参数文件，IFE、IPE、BPS、SW_CONTROL 是 ISP 各段 pipeline 的参数文件。这里有个容易让人误判的地方：不同平台的 ISP 架构不一样，工具会把所有平台架构对应的文件都生成出来，看着一大堆，其实只需要保留当前项目需要的，其余删掉就行。

删文件这件事要谨慎：先确认当前平台的 ISP 架构划分，再动手。判断依据在依赖环境目录里，那里定义了调试模块的版本和架构。我见过有人图省事把不认识的目录全删了，结果编译出来的 bin 推上去相机直接起不来，回头查了半天才发现删掉了当前平台真正在用的那一段。

4. ParameterParser 与 ISP/AWB 仿真：把参数推到机器上验证

参数生成出来只是文本，机器认的是 bin。从文本到能生效的 bin，中间隔着一次编译；从 bin 到"这张图到底调得对不对"，中间隔着一次仿真。这两步做完，才算真正闭环，也才敢把改动提交上去。

4.1 exe 从哪来，bin 怎么编

ParameterParser.exe 有两种获取方式：一是去 Chromatix 安装路径下对应平台的仿真文件夹里找，二是直接从项目服务器上拷贝到本地。我一般走第二种，路径是vendor\qcom\proprietary\chi-cdk\tools\buildbins\win32下面，好处是版本和服务器上的编译环境严格一致，不会出现本地编出来和别人编出来不一样的情况。

拿到 exe 之后，load 进工具，选好保存路径和 bin 文件名，点左上角的编译按钮就能出 bin。文件名和路径不要有中文和空格，这条规则贯穿整套工具链，不是某一个环节的特殊要求。

编出来的 bin 要推到机器上验证，目标路径是相机库所在目录。

# 需要 root 权限才能写 vendor 分区 adb root adb remount # 把编好的 bin 推到相机库目录，文件名按项目实际命名替换 adb push ./sample_camera.bin /vendor/lib64/camera/sample_camera.bin # 确认推上去的文件大小和权限正常 adb shell ls -l /vendor/lib64/camera/sample_camera.bin

adb remount失败是很常见的，多数是分区未解锁或者 root 没真正生效，先看adb root的输出。push 的目标目录要按平台确认，lib 和 lib64 是两个不同的位置，推错目录的表现是"推成功但完全没效果"，这种无效劳动最消耗耐心。push 完成后重启相机服务或者直接重启机器，再看效果。

4.2 ISP 仿真：RAW 图加带 3A 信息的 JPG

ISP 仿真是把参数效果在 PC 上先看一遍，避免每次都刷机验证。需要准备的材料有两样：一张 RAW 图，和一张带有 3A 信息的 JPG 图。流程是先把 JPG 解析一遍，生成一个带数据的 xml 文件，然后依次 load RAW 图和这个 XML，点 simulate 出图。

操作上有两个坑。第一个是那个额外的 xml 一般不需要 load，如果确实要 load，得先在工具里点开 Spectra Cam Sim Config 选项，否则加载行为不对。第二个是点 simulate 之前一定要检查 stream config 里的参数，图片配置信息对不上的话，会出现两种结果：要么根本仿不出图，要么图出来了但颜色不对、字节对不齐、显示成花图。

花图这个现象特别容易被误判成参数调错了。实际原因大概率是 stream config 里的宽度、位深、stride 和 RAW 图本身不匹配。排查顺序应该是：先确认 RAW 图的分辨率和位深，再对 stream config，最后才怀疑参数文件。反过来查，很可能把一份本来正确的参数改得面目全非。

4.3 AWB 仿真：两个 DLL 与 target RGB

AWB 仿真和 ISP 仿真材料不一样，需要准备四样东西：仿真用的 DLL 文件、问题图片拍摄时对应的 BIN 文件、带 3A 信息的 JPG 图片、以及仿真结果的存放路径。DLL 一共两个，需要在服务器上获取。

使用上有两个特点值得记一下。第一，两个 DLL 必须放在同一目录下，加载其中一个时另一个会被自动加载，所以不要只拷一个过去然后疑惑为什么跑不起来。第二，解析完成后，界面上 target RGB 的值会同步被改写，这是正常行为，不是工具出错——它反映的是这次解析得到的实际结果。

仿真跑通之后，AWB 的问题定位效率会明显不一样。以前只能靠刷机看实拍图猜，现在可以先在 PC 上把几种可能性跑一遍，把范围缩小到一两个参数，再去机器上验证。我自己调 AWB 偏色的顺序一般是：先跑仿真确认参数方向对不对，再推 bin 实拍确认，两步都过才提交。

5. 踩坑排查：五条从闪退安装到仿真花图的真实排查线

这套工具链的问题有个共同特征：报错信息极少，多数时候只是"没反应""没效果""图不对"。所以排查靠的是固定顺序，而不是靠猜。下面五条是我在实际项目里反复遇到的，每条按现象、原因、解决三步写，遇到同类问题时可以直接对号入座。

第一条：QPM 安装界面闪一下就消失。现象是双击安装包，窗口一闪，进程退出，没有任何提示。原因是本机缺少 QPM 依赖的 VC2010 运行库，安装器加载动态库失败后静默退出。解决办法是先装 VC2010 的 x86 版本，重启，再跑安装包。判断依据用前面那条 PowerShell 命令列一遍已装运行库即可，如果列表里最老的是 2015 版，基本可以确诊。这里容易走的弯路是反复重新下载安装包，以为文件损坏——实际上换十个包也是同样的结果。

第二条：刷完开不了机，或者卡在 Logo。现象是 QFIL 显示 download 成功，但机器起不来。原因通常有两个：一是这台机器是原生版本首次刷机，没做全擦就直接走了增量流程；二是增量刷机时 rawprogram 和 patch.xml 没有全部选上，漏了分区。解决办法是回到全擦流程重来一遍：UFS 加 provision，path 选带 ddr 的文件，xml 选 ufs22，擦完取消 provision 勾选，再走 flat 增量。血泪经验是：只要机器来源不明或者状态不确定，第一次一律全擦，别图快。

第三条：Chromatix 建完工程，参数死活合不进服务器。现象是本地生成正常，提交时冲突，或者服务器上编译报错。原因是本地工程路径和服务器不一致，或者路径里混进了中文、空格、大小写不统一。解决办法是重建目录，严格对齐服务器路径，并且勾选让代码路径与服务器相同的那个选项。这条坑的隐蔽之处在于它不会在建工程时报错，可能过了两三天才在合代码时爆出来，那时候改动已经很多了，重建成高。

第四条：bin 推上去完全没效果。现象是 push 显示成功，重启后相机行为和改之前一模一样。原因有三个层次：推错目录（lib 和 lib64 混了）、remount 没真正生效导致写入被丢弃、或者文件名里带了空格导致实际路径和预期不符。解决办法是按顺序查：先adb shell ls -l确认文件在且大小对，再对比目录是不是当前平台实际加载的那个，最后核对文件名。注意adb remount成功输出不代表可写，用adb shell touch在目标目录建个临时文件试一下最稳。

第五条：仿真出花图，或者根本仿不出图。现象是点 simulate 之后要么空白，要么图像错位、颜色错乱。原因是 stream config 里的参数和 RAW 图本身不匹配，常见的是宽度、位深、stride 三者之一对不上，另外也可能是多 load 了本不该 load 的 xml。解决办法是先核对 RAW 图的实际规格，再逐项对 stream config，需要加载额外 xml 时先开 Spectra Cam Sim Config 选项。这条坑最忌讳的做法是直接去改参数文件——花图几乎从来不是调参调出来的。

6. Tuning 参数区分与 case 提交：把问题交给对的人

参数区分这件事，正常情况下需要客户提供一个 XSD 文件。原因不复杂：有些客户用的是自研算法或者第三方算法，参数需要按他们的维度拆开，工具本身不知道这些维度。在工具里点那支笔，弹出的窗口右侧会列出可添加的可区分参数模式，这个列表完全由 XSD 文件控制，XSD 里没定义的维度，你在界面上是找不到的。所以当有人问"为什么我这里没有这个区分项"，答案往往不在工具版本，而在 XSD。拿到 XSD 之后放在工程对应位置，重开工程，笔的弹窗里就会多出对应选项。参数修改时的选择也是在这个窗口里做，选错维度的后果是参数写到了不该写的地方，编译能过，实拍没变化。

问题确认是工具或者平台侧的原因之后，走 case 提交。流程是先选问题模块创建一个 case，然后在 quick case 里填。几个字段的填法值得说清楚：

Problem 这一栏选对很关键，因为平台会根据问题类型派发跟进的处理人，选错模块的直接后果是转了一圈又被打回来重新提交，一来一回就是两三天。Subject 我一般控制在二十字以内，写清"什么场景下、什么现象、影响到什么"，比如某分辨率下暗光偏绿这种，比写"画质有问题帮忙看看"有效得多。

干这行久了，我养成一个固定动作：任何一次刷机之前，先确认端口是不是 9008、provision 勾选状态对不对、rawprogram 和 patch 是不是全选上了，这三项确认完再点按钮。这套动作看着啰嗦，但它是被卡 Logo 卡出来的习惯，从那以后我每次动手前都强制走一遍，救回来的时间远比花掉的多。希望帮到你。

本文还有配套的精品资源，点击获取