企业官网建设流程全解析

简介：这份高通调试工具使用手册面向高通平台开发与调试人员，聚焦工具链使用中的账号、下载、刷机与相机参数编译等实际问题，适合已有一定平台经验、希望系统梳理操作流程的开发者查阅。压缩包内仅含1个doc文档，约2.45MB，以文字说明和流程记录为主，便于按章节检索关键工具的使用要点。目前已有631人学习下载，说明其在相关调试场景中具备一定参考价值。手册覆盖QPM工具管理与许可证配置、QFIL原生刷机与9008端口进入方式、Chromatix工程创建及参数生成、ParameterParser编译验证，并延伸到ISP与AWB仿真、Tuning参数区分和高通case提交流程；对常见安装异常、账号设备限制、全擦与版本升级差异等也有提示，可帮助开发者减少摸索成本、建立较完整的调试知识框架。

1. 先装 QPM 还是先刷 QFIL：一套 QX 调试工具链的入场顺序

第一次接手 QX 平台调试机时，最容易出现的误判不是命令写错，而是把 QPM、QFIL、Chromatix 三件事的顺序弄反：账号证书没通，QPM 里连工具包都拉不下来；9008 端口没确认，QFIL 一点 Download 就停在 7%；Chromatix 工程路径带中文，生成参数时直接少文件。这套环境在相机调试、原生刷机和参数编译场景里很常见，新手照着图形界面点也能走一半，剩下那一半全靠版本和目录细节。下面按安装顺序写清 Windows 运行库、License 绑定、provision 全擦、stride 计算和仿真验证，适合刚接触 QX 调试工具使用手册的开发者，也适合被账号设备超限和 9008 端口折腾过的熟手。

2. QPM 安装与 License 绑定：Windows 运行库、账号水印和设备停用

QPM 是这套工具链的入口，也是后面下载 QPST、QFIL 和 Chromatix 相关包的通行证。很多人把 QPM 当成普通安装包，双击完发现界面闪一下就没了，或者装完登录进去发现只能看不能下，问题通常不在网络，而在 Windows 运行库和 License 组织权限这两层。把这两层先理顺，后面刷机和参数工具才不会反复返工。

2.1 安装前把 Windows 依赖和目录定下来

QPM 的 Windows 安装包在官方工具门户里检索 package 就能找到，下载时不要随手丢在桌面。安装路径、下载目录、后续 License 文件最好分成三个固定目录，路径只保留英文和数字，空格和中文能避就避。这不是洁癖，后面 QFIL 找刷机包、Chromatix 找工程目录时，路径里的空格会让一些老工具直接读不到文件。

$root = "D:\QX_Tools\QPM" New-Item -ItemType Directory -Force -Path $root | Out-Null New-Item -ItemType Directory -Force -Path "$root\downloads" | Out-Null New-Item -ItemType Directory -Force -Path "$root\license" | Out-Null # 安装包、下载缓存、License 记录分开放，后续排错时不用翻桌面

这段命令只做目录规划，$root是 QPM 的安装根目录，downloads放从门户拉下来的工具包，license放组织代码、有效期截图和排错记录。目录建好后，先确认机器里有没有 VC 运行库。手册里提到安装界面闪一下、装不上，常见原因就是缺少 QPM 运行需要的 VC 文件库，先装 VC2010 再重装 QPM，多数能过。我一般会在装 QPM 前把 VC2010 安装包也放进downloads，省得装到一半再去翻浏览器历史。

安装时右键用管理员权限运行，安装程序本身不复杂，下一步到完成即可。装完先别急着登录下载大包，打开 QPM 看工具列表能不能正常刷新，这一步能排除一半的安装残缺问题。如果界面仍然闪退，先卸掉刚装的 QPM，补 VC2010，重启后再装，不要在同一台机器上反复覆盖安装，注册表残留会让后面判断更乱。

2.2 QPM 安装和 License 组织权限

QPM 登录后能看到组织下的 License 信息，通行证管理页面里会显示组织代码和有效期限。这里有一个很容易踩的点：QPM 上可以添加别的 License，但如果不是同一组织，添加后也获取不到对应权限。表现不是报错，而是工具列表能看见、下载按钮点下去没反应，或者下载到一半提示权限不足。遇到这种情况，先回 License 管理页确认当前账号挂在哪个组织下，不要急着换账号。

账号设备数也要注意。QX 账号可以多设备登录，但只能有两个设备正常使用，多出来的设备会被限制。出现账号登不了、QPM 提示设备超限时，去 Licenses 页面把当前不用的设备勾选 Deactivate，再重新登录。我一般会在项目交接时把常用台式机、调试笔记本和备用机列一张表，只保留两台在线，其余全部停用，避免出差现场被账号卡住。

2.3 官方文件下载与水印

官方门户下载文件时，点击目标文件后系统会在后台给文件加水印，真正下载要去 download 区域取。PDF 文件有时可以直接打开再保存，视频文件不能直接下载，必须走 download 区。下载完的文件会带账号水印，所以不要把自己下的文件转发给别人，这不是小气，水印追责时很难解释清楚。

下载 QPST、Chromatix 安装包和仿真 DLL 时，我习惯在文件名前加日期和项目代号，例如20240610_QX_Cam_Tuning，但项目代号仍然只用英文数字。水印文件不要二次压缩后外发，也不要放到公共共享目录。需要给同组人用时，让对方用自己的账号在门户下载，版本还能对得上。这个习惯看起来麻烦，真正出问题时能省掉很多解释成本。

2.4 安装后的最小验证

装完 QPM 不要直接进入刷机，先做一次最小验证：QPM 能正常登录，工具列表能检索到 QPST，License 状态显示有效，下载一个小文件能落到downloads目录。四项都过，再进入 QFIL。若只能登录不能检索，优先看组织权限；若检索到但下载失败，先看 License 有效期和设备占用；若 QPM 本身打不开，回退到 VC 运行库和安装路径。

这一步做完，QPM 就算落地了。后面 QFIL 和 Chromatix 都依赖这个入口拉包，入口不稳，后面每一步都会变成玄学。我的习惯是把 QPM 的版本、安装日期、VC2010 是否补装、License 到期时间写进项目环境记录，换机器时照着记录复现，比凭记忆可靠。

3. QFIL 刷机环境搭建：9008 端口、provision 全擦与 flat 包加载

QFIL 是原生版本刷机工具，通常包含在 QPST 里。它不复杂，但刷机包结构、provision 全擦和 9008 端口三件事必须对上。第一次刷机做一次全擦，后续升版本走 flat 刷写，顺序错了会出现刷完不开机、端口掉线、patch.xml 对不上等问题。这一章按“拿工具、认包、进端口、刷写”的顺序拆开。

3.1 QPST 与 QFIL 的获取和刷机包结构

在 QPM 里检索 QPST 并安装，QFIL 是其中的工具之一。装完后如果开始菜单找不到 QPST，去安装目录把整个文件夹复制到固定工具目录再用，手册里也提到过这种处理方式。复制时保持目录层级不变，不要只拖 QFIL 单个 exe，旁边的依赖文件丢了，打开就会报缺库。

刷机包解压后先认文件，不要急着点 Download。常见结构里会有带 ddr 的文件、ufs22 的 xml、rawprogram 系列文件和 patch.xml。第一次全擦和后续 flat 刷写用的文件不一样，混用会直接失败。

刷机包路径同样只留英文数字。我见过路径里带括号和空格的包，QFIL 能打开但加载到一半停住，换到D:\QX_Flash\project_x\下就正常。刷机前把包解压到短路径，别在压缩包里直接选文件。

3.2 第一次全擦：UFS、provision 与 XML 选择

原生版本第一次刷机要做全擦。打开 QFIL，Configuration 里选择 UFS，勾选 provision，Path 选择刷机包里带 ddr 的文件，Xml 选择 ufs22 的 xml，然后执行全擦。全擦成功后回到 Configuration，把 provision 取消勾选。这个顺序不能反，全擦没完成就取消 provision，后面 flat 刷写会带着旧分区数据，表现是能开机但相机或基带异常。

全擦前确认电量充足，USB 线直插主板后置口，不要经过扩展坞。全擦过程中不要动线，也不要切窗口。QFIL 的进度条停住时先看端口有没有掉，不要连续点 Download。全擦完成后设备可能不会立刻正常开机，这是正常现象，回到 Configuration 取消 provision 再进入下一步。

如果找不到 QPST 的安装目录，把整个文件夹复制到工具盘再用，不要只复制 QFIL.exe。全擦用的 ddr 文件和 Xml 文件要来自同一个刷机包，不同版本的包混用，QFIL 可能不报错但刷完起不来。我的做法是先在包目录里看一遍文件名和版本号，确认与当前项目一致，再打开 QFIL。

3.3 三种进入 9008 的方式

QFIL 刷机全部要在 9008 端口下进行。第一种是开机时按住开机键和音量上下键一起按；第二种是用指令进入，最方便；第三种是拆机找主板上的强制下载金属触点，在前两种失效、刷机失败或无法开机时使用。

adb devices # 先确认设备在线，避免对未连接设备发指令 adb reboot edl # 进入 9008 下载模式，QFIL 刷新端口后即可刷写

adb devices用来确认当前系统还能识别设备，adb reboot edl是工程机上常用的进 9008 方式。执行后设备屏幕可能黑掉，Windows 设备管理器里会出现 9008 端口。若adb devices为空，先检查驱动和线，不要反复执行重启指令。

硬件触点方式要特别小心：先用镊子一端点住强制下载点，另一端接地点，再连接 USB，顺序反了可能检测不到端口。拆机前先断电，触点位置以主板丝印为准，不要凭感觉乱点。这个办法是最后的后悔药，能不用就不用，但现场遇到机器彻底黑掉时，它确实能把设备拉回来。

3.4 flat 刷写与常见失败判断

全擦完成并取消 provision 后，进入正常刷写。Type 选择 flat，Path 仍然选刷机包里带 ddr 的文件，然后选择需要加载的 patch 文件。正常情况下把几个 rawprogram 文件全部选上，工具会自动跳出对应的几个 patch.xml，也全部选上，再点击 Download。刷写过程中看进度和端口状态，不要同时开 QPM 下载大包。

刷写失败先分三类看：端口没进 9008，回 3.3 检查线和按键；文件选错，回包目录核对 ddr、rawprogram、patch.xml 是否同一版本；全擦残留，回 Configuration 确认 provision 已取消。若刷完不开机，先重新进 9008 再刷一次 flat，不要直接拆机。连续两次失败再考虑硬件触点，避免把软件问题做成硬件问题。

QFIL 的日志窗口不要关，失败时把最后几行记下来。常见提示里，端口超时多半是线或驱动，文件校验失败多半是包不完整，patch 对不上多半是 rawprogram 和 patch.xml 版本不一致。把这些现象和包版本记在项目记录里，下次换机器能直接对照。

4. Chromatix 7.3/7.4 工程创建：路径一致、stride 计算和参数目录裁剪

Chromatix 是相机 tuning 工具，负责生成参数、调试参数和仿真。7.3 和 7.4 属于大版本升级，不少平台被分割开，同一平台在不同版本里也可能有不一样的 bug，通常影响不大，但版本选错会在生成参数时少模块。这一章从工程目录、Sensor 配置、参数目录裁剪一直写到 ParameterParser 编译 bin 和 ISP 仿真，最后补上 Tuning 端参数区分和 case 提交。

4.1 工程目录与服务器一致原则

本地新建工程目录时，目标是和服务器保持一致，方便后期 debug 合参数。整个文件夹的上下层都只能有英文和数字，项目名和工程路径不要有空格、特殊字符和中文。工程存放路径最好和服务器上一致，这样提交代码时少一层路径映射。把附件里的 chromatix 文件夹放到 api 下，三个依赖文件夹从项目服务器获取，它们决定参数区分可以有哪些、各调试模块的版本等。

创建工程时，右边有一个勾选项用于让代码路径和服务器相同，建议勾上。路径一致后，本地生成的参数文件与服务器目录能对上，提交代码时不用手工改路径。工程名不要用“测试1”“新建文件夹”这类名字，后面 case 提交和参数回溯都找不到对应项目。

4.2 Sensor 配置与 stride 计算

Sensor 配置页一般只填几个关键项，最需要确认的是 stride 值。不同客户的计算方式可能不一样，项目信息和模组 Guide 上能找到对应说明。常见算法是 width 乘 5 除 4 除 80 取整数，向上取整后再乘 80，得到最终 stride 值。

import math def calc_stride(width): unit = math.ceil(width * 5 / 4 / 80) return unit * 80 # width 为 sensor 输出行宽，单位像素；80 为对齐粒度 # 例如 width=4000 时，先算 4000*5/4/80=62.5，向上取整为 63，再乘 80 得 5040 print(calc_stride(4000))

这段代码只负责按手册公式算 stride，width必须用当前 sensor 的实际输出宽度，不能拿预览分辨率代替。math.ceil做向上取整，80是对齐粒度。算完后和项目 Guide 上的值对一遍，不同客户的计算方式不一样时，以项目确认为准，不要直接套别的项目。

Sensor type 现在基本都是 Bayer，黑白 sensor 可能会用到 mono。如果有现成的 sensor 文件，可以直接 load，不必从零填。填完点击 OK 保存，工具会生成参数。生成前再检查一次工程路径，路径里带中文时，工具可能生成到一半停住，或者生成出来的目录缺文件。

4.3 生成参数后的目录裁剪

生成参数后界面会分成 3A、ISP pipeline、simulation 几块。本地参数文件里，STATS 文件夹下是 3A 的参数文件，IFE、IPE、BPS、SW_CONTROL 是 ISP 对应 pipeline 的参数文件。不同平台的 ISP 架构不一样，工具会把所有平台架构的文件都生成出来，当前项目只需要保留自己平台需要的，别的可以删除。

删除前先确认当前平台架构，不要看着文件名顺眼就留。多留文件不会让编译立刻报错，但后面合参数时容易拿错版本。我的做法是生成后先复制一份原始目录做备份，再按项目平台裁剪，裁剪完用 ParameterParser 编译一次，能过再进入调试。

4.4 ParameterParser 编译 bin

ParameterParser.exe 是参数编译工具，有两种获取方式：去 Chromatix 安装路径下找对应平台仿真文件里的 exe，或者从项目服务器固定工具目录的buildbins\win32子目录复制到本地。推荐从服务器拿，版本和项目匹配。复制到本地后放在英文路径下，文件名和路径都不要有中文和空格。

adb root adb remount adb push ./camera_params.bin /vendor/lib64/camera/camera_params.bin adb shell ls -l /vendor/lib64/camera/camera_params.bin

adb root和adb remount在工程机上常用，用来获得写权限；adb push把编译出的 bin 推到相机目录；最后一条ls -l看文件时间戳和大小，确认推入成功。不同项目的 bin 文件名不一样，按当前项目命名，不要直接覆盖别人的文件。推入后重启相机服务或重启机器，让参数生效。

编译时点击左上角的选择按钮，选好保存路径和 bin 文件名。路径里不要有中文和空格，文件名也不要带特殊字符。编译失败先看参数目录是否裁剪过头，再看 ParameterParser 版本是否和 Chromatix 对应。服务器拿的 exe 一般不会错，出错多半是本地参数目录少文件。

4.5 ISP 仿真与 AWB DLL

ISP 仿真需要 RAW 图和带有 3A 信息的 JPG 图。第一步先把 JPG 图解析一下，生成带数据的 XML 文件，然后依次 load RAW 图和 XML，点击 simulate。一般仿真不需要 load 红框 4 里的 XML，如果想 load，需要在 load 前点击 Spectra Cam Sim Config 选项。点击 simulate 前检查 stream config 里的参数，图片配置信息不对会有两种表现：不能仿出图，或者仿出的图颜色不对、字节对不齐、显示花图。

AWB 仿真需要准备仿真 DLL 文件、问题图片拍照时的 BIN 文件、带 3A 信息的 JPG 图片和仿真结果存放路径。DLL 文件一共两个，需要在服务器获取。两个 DLL 放在同一目录，加载一个时另一个会被自动加载，点击 Run 进行仿真解析。解析完之后，红框内的 target RGB 值会同步被改写。WB 仿真可以对照参考文档走，路径和 DLL 版本要一致。

4.6 Tuning 端参数区分和 case 提交

Tuning 端参数区分正常情况下需要客户给出 XSD 文件，因为有些客户用自研或三方算法。工具里点击红框的笔，弹出窗口，右边能添加的可区分参数模式由上面的 XSD 文件控制。参数修改时先选区分模式，再改具体参数，不要直接在默认模式里改完再切，容易丢改动。

提交 case 时先选择问题模块创建一个 case，然后在 quick case 里提交。Custom Project 选问题所在的项目名，Chip 选芯片平台，Problem 选问题模块。画质问题归属于多媒体图像质量模块，最后选择具体的 tuning 问题，系统会根据问题类型派发跟进处理问题的 CE。Subject 用一句话描述问题，不要写“看看”“有问题”这种无法检索的标题。

5. 避坑排查：QPM、QFIL、Chromatix 链路上最容易翻车的 5 个点

这套工具链的坑有个共同点：图形界面看起来都正常，失败点藏在依赖、端口和路径里。下面 5 条是我在装机和刷机时反复遇到的，每条按现象、原因、解决写，照着排查能少走很多弯路。

5.1 安装与账号类问题

现象：QPM 安装界面闪一下就消失，程序没装上去。原因：机器缺少 QPM 运行需要的 VC 文件库，尤其是老系统或刚重装的 Windows。解决：先下载 VC2010 安装，重启后再装 QPM；装完先打开一次，确认工具列表能刷新。若仍然闪退，卸载 QPM 后换安装目录，路径只留英文数字。

现象：QPM 能登录，工具列表也能看见，但下载按钮没反应。原因：当前账号挂的组织与 License 不是同一组织，或者账号设备数超过两台被限制。解决：去 License 管理页核对组织代码和有效期，再到 Licenses 列表把不用的设备 Deactivate，只保留两台常用设备在线。不要在同一台机器上反复切换账号，设备占用会越来越乱。

5.2 刷机类问题

现象：QFIL 点 Download 后进度停在 7% 或端口超时。原因：设备没真正进入 9008，或者 USB 线经过扩展坞导致端口掉线。解决：先用adb reboot edl重新进 9008，换主板后置 USB 口，不用扩展坞；若设备已黑屏，用镊子先点强制下载点再插 USB。端口没出现在设备管理器里，不要连续点 Download。

现象：全擦完成后刷 flat 包失败，提示 patch 对不上。原因：rawprogram 和 patch.xml 不是同一版本，或者全擦后 provision 没有取消。解决：回 Configuration 取消 provision，重新选同一刷机包里的 rawprogram 和自动带出的 patch.xml，全部选上再 Download。刷机包解压到短英文路径，别在压缩包里直接选文件。

5.3 参数生成与仿真类问题

现象：Chromatix 生成参数到一半停住，或者生成目录缺文件。原因：工程路径带中文、空格或特殊字符，和服务器路径不一致。解决：把工程移到D:\QX_Work\project_x\这类纯英文短路径，重新创建工程，勾选代码路径与服务器一致。生成前确认三个依赖文件夹都从项目服务器拿齐。

现象：ISP 仿真出花图或颜色不对。原因：stream config 参数和 RAW/JPG 配置不匹配，或者仿真前多 load 了红框 4 的 XML。解决：点击 simulate 前检查 stream config，确认 RAW 宽高和图片配置；需要 load 红框 4 的 XML 时，先点 Spectra Cam Sim Config 再 load。AWB 仿真则检查两个 DLL 是否同目录、BIN 文件和 JPG 是否来自同一问题场景。

6. 装完怎么验证：从 9008 端口到相机 bin 生效的一条检查链

装完不要只看工具能不能打开，按一条链走一遍：QPM 能检索 QPST，QFIL 能识别 9008，刷机后能正常开机，Chromatix 能生成参数，ParameterParser 能编译 bin 并推入设备，仿真能出图。每一项都有观察点，不要跳步。

adb devices adb shell ls -l /vendor/lib64/camera/ adb reboot edl # 先确认设备在线，再查相机目录 bin 时间戳，最后进 9008 验证刷机端口

adb devices看设备是否在线，ls -l看推入的 bin 时间戳和大小，adb reboot edl验证 9008 端口能否再次进入。bin 推入后要重启相机服务或重启机器，否则看到的还是旧参数。仿真验证时先跑一张已知正常的 RAW，确认工具链本身没问题，再换问题图，避免把工具配置问题当成画质问题。

从那以后我每次装完这套环境，都强制走一遍这条检查链，尤其是 9008 端口和 bin 时间戳这两步，不靠“应该生效了”判断。希望帮到你。

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