简介：这份资料是高通 Qualcomm Test Sequencing System（QSEQ）的官方概览文档，面向从事高通平台射频与通信测试的工程师、产线测试开发人员及需要搭建自动化测试序列的技术人员，用于解决测试序列如何设计、组织与执行的问题。压缩包内共 1 个 PDF 文件，大小约 2.58MB，为英文技术文档，按 Overview、XTT/XML、Running QSEQ、Logging、Code、Factory Implementation、Parameters、Diversity Test、Manual Debug 等章节组织，并附修订历史与参考资料，便于按主题定位。目前已有 1028 人学习下载。文档系统梳理了 QSEQ 的整体框架，说明序列文件的 XML/XTT 描述方式、运行与日志记录机制、工厂实现路径及参数配置要点，并给出与测试设备 Aux 端口配合的分集测试方法以及手动调试思路；读者可据此理解测试序列从设计、环境与参数设定到执行、结果分析、版本管理的完整链路，并结合 QRCT 对射频资源的控制方式，快速上手排查测试失败与告警问题。
1. 装 QSEQ 之前先把版本对上：80-N2330-2 Rev. G 这套环境缺什么
上周有人把一台产测机推过来：QDART 装完，XTT 打开，树里干干净净，右键翻不到 Start QSEQ Session；另一台机器上序列跑到第三段，payload 直接超时。高通 QSEQ 从来不是双击下一步就能装完的东西，它是 QDART 里的一个 C++ 源码工程，靠 SubSysVFS 包加一份 QSEQ_DeviceConfig.XML 把手机、仪表和资源串起来，版本对不上就是白装。手上这份 80-N2330-2 Rev. G 是 2018 年 1 月的改版，配 QDART、QPST、VS2010、MSXML 4.0 SP2 这一套，机器上通常还躺着 QRCT。下面按装包、改配置、拼序列、排错、验证的顺序走一遍，给要搭 FTM 非信令 list mode 环境的人。
2. 装环境与选版本：QDART 安装包、SubSysVFS 和 VS2010 的先后顺序
装这套东西最容易犯的错，是把 QDART 当普通桌面软件——双击、下一步、完成，然后打开 XTT 发现树是空的。QSEQ 的依赖链比它看起来长：底下是 USB 驱动和 QPST 的串口枚举，中间是 NI-VISA 的仪表会话，上面才是 QDART 里的 SubSysVFS 与 XTT。顺序反了不会当场报错，会在你跑第一条序列的时候，以“连不上设备”的形式还回来，而且报错信息永远指向错误的那一层。这一章把宿主、安装包、运行时依赖和装完的基线备份按我实际装机的顺序捋一遍，能照着做完再往下走。
2.1 先垫宿主：USB 驱动、QPST、NI-VISA 的安装次序
我的固定次序是：USB 驱动 → QPST → NI-VISA → MSXML 4.0 SP2 → VS2010（或 VC++2010 运行库）→ QDART/SubSysVFS。理由很实际：QDART 安装器只校验一部分依赖，缺了的那些不拦你，等你打开 XTT 加载序列时才炸，而那时候的错误信息跟真正的原因隔了三四层。
| 组件 | 版本/来源 | 在这套环境里的作用 | 装完怎么确认 |
|---|---|---|---|
| USB 驱动 | QDART 安装包自带或单独装 | 让 DUT 枚举出诊断口 | 设备管理器出现 HS-USB Diagnostics |
| QPST | 与 QDART 配套的版本 | CONNECT=QPST 走它的端口枚举 | QPST Configuration 里能看到端口 |
| NI-VISA | 与仪表驱动的要求一致 | GPIB/USBTMC 会话 | NI MAX 里扫得到仪表资源名 |
| MSXML 4.0 SP2 | 微软独立安装包 | 序列 XML 的解析 | 注册表里有 4.0 的 CLSID |
| VS2010 或运行库 | 2012 Q1 之后的 release 要求 | 编译源码或加载运行库 | 能打开 QSEQ 的 C++ 工程 |
| QDART / SubSysVFS | 见 2.2 | XTT、XML 与 QSEQ 源码 | 见 2.2 的目录核对 |
先确认底层这三样，用两条命令就能把问题分层：
# 1) DUT 有没有枚举成诊断口（高通的口通常叫 HS-USB Diagnostics / NMEA / DM） Get-PnpDevice -Class Ports | Where-Object { $_.FriendlyName -match "Qualcomm|HS-USB" } | Select-Object Status, FriendlyName, InstanceId # 2) QPST 相关服务是否在跑 Get-Service | Where-Object { $_.Name -match "^QPST|Qualcomm" } | Select-Object Name, Status第一条没有输出，问题在驱动，不在 QDART，重装工具链是白费工夫。第二条里 QPST 相关服务没起来，XTT 里写 CONNECT=QPST:COM23 一定超时，而且超时时间会耗满你配的那个秒数，看起来像“序列卡死”。COM 号不要凭记忆写，去设备管理器的“端口 (COM 和 LPT)”里看实际编号——换一个 USB 口编号就变，这是产测机上“昨天还好好的”最常见的来源。我的做法是给每个工位的 USB 口贴标签，配置里写死对应 COM，物理上别让人随便拔。
再确认 VISA 这一层：
# VISA 运行时的存在性检查，缺了它仪表会话根本建立不起来 if (Test-Path "$env:SystemRoot\System32\visa32.dll") { "VISA runtime OK" } else { "VISA 未安装，先去装 NI-VISA" }GPIB 卡驱动装好之后，在 NI MAX 里能扫到仪表的资源字符串，形如 GPIB0::19::INSTR。这个字符串后面要原样抄进配置文件，不要自己按“总线::地址”的格式手敲，少一个冒号报的是“设备未找到”，不会告诉你格式错了。
2.2 两条安装路线：QDART Installer 与 SubSysVFS 独立包
拿包有两条路，选错了会多折腾半天。QDART Installer 给的是整套 QDART，路径在 Documents and Downloads / Software Tools / QDART Software Code (Tools Suite) 下面，含 XTT 和 QSPR test executive；SubSysVFS Installer 是 QSEQ 的独立包，路径在 QDART VFS (QSEQ) Software Code 下面，只更新 XTT/XML 和源码。另外平台侧还有 TPP 包，放在 CreatePoint 里，各平台之间差别不大。
我的选择标准很直接：新机器、从零搭，走 QDART Installer，一次性把 QSPR 那套 C# 的 test executive 也带进来；机器上已经有 QDART、只是想更新序列文件或源码，用 SubSysVFS 覆盖，别为了几十份 XML 把整条工具链换一遍——工具链一换，之前调好的 QSPR 侧脚本、仪表驱动版本全得重新对。
装完的默认落点是C:\Program Files (x86)\Qualcomm\QDART\XTT\SubSysVFS\。装完立刻核一遍：
$xtt = "C:\Program Files (x86)\Qualcomm\QDART\XTT\SubSysVFS" # 列技术目录，目录名要和你在 XTT 里选的技术对得上 Get-ChildItem $xtt -Directory | Select-Object Name, LastWriteTime # 数一遍 XML：正常是几十份，为 0 说明包没铺开或者是精简包 Get-ChildItem "$xtt\LTE" -Recurse -Filter *.xml -ErrorAction SilentlyContinue | Measure-Object | Select-Object Count第一行的输出里应该能看到 LTE、WCDMA、GSM/EDGE、CDMA2000 这些技术目录，QSEQ 2.0 覆盖的制式就是 CDMA2000、1xEV-DO、GSM/EDGE、WCDMA、LTE-FDD、LTE-TDD、TD-SCDMA。第二行统计的是 LTE 下的 XML 份数，为 0 时别急着怀疑安装包损坏，先确认Program Files (x86)和Program Files下面是不是各有一份 QDART——两份并存是我见过最费时间的坑，XTT 读的和你改的不是同一份。
注意：
Program Files (x86)是 32 位落点。64 位系统上别去Program Files下找 XTT，找到了也是另一个安装。
2.3 MSXML 4.0 SP2 与 VS2010：两个被忽略的硬依赖
MSXML 4.0 是 side-by-side 组件，跟系统自带的 3.0、6.0 共存，装 6.0 替代不了它。序列 XML 的解析走 4.0 的 DOMDocument，缺了它 XTT 加载序列的时候抛 COM 异常，错误码跟 XML 内容毫无关系，第一反应都会以为是自己写的 XML 有问题，然后花一小时去查一个语法完全正确的文件。
VS2010 是 2012 年 Q1 之后 release 的编译与调试依赖。只跑不编译的机器，至少要有 VC++2010 运行库，否则 XTT 启动就崩。两个都缺的时候，崩的顺序是先运行库后 COM，看起来非常玄学——同一份配置，A 机器能跑 B 机器秒退，差的往往就是这两个。
# 查 MSXML 4.0 是否注册：DOMDocument 4.0 的 CLSID $clsid = "{88D96A05-F192-11D4-A65F-0040963251E5}" foreach ($root in "HKLM:\SOFTWARE\Classes\CLSID", "HKLM:\SOFTWARE\WOW6432Node\Classes\CLSID") { if (Test-Path "$root\$clsid") { "MSXML 4.0 已注册: $root" } }两条路径分别对应 64 位和 32 位视图。QDART 是 32 位进程，WOW6432Node那条有输出才算真装上了——只看到第一条输出而第二条没有，说明装的是 64 位组件，32 位进程照样加载不到。没有输出就重装 msxml4 SP2，装完重启，不要指望修复模式能补上注册项。
2.4 装完先做基线：Databases 和 XTT 各留一份
QSEQ 的配置几乎全压在QDART\Databases\QSEQ_DeviceConfig.XML和 XTT 目录下面，改坏是常态，回滚比 debug 快得多。所以装完第一件事不是跑序列，是备份。
# 需要管理员权限：Program Files 下的目录普通账户读得动写不动 $stamp = Get-Date -Format "yyyyMMdd_HHmm" $db = "C:\Program Files (x86)\Qualcomm\QDART\Databases" $xtt = "C:\Program Files (x86)\Qualcomm\QDART\XTT\SubSysVFS" New-Item -ItemType Directory -Path "D:\backup" -Force | Out-Null Copy-Item $db "D:\backup\QDART_Databases_$stamp" -Recurse -Force Copy-Item $xtt "D:\backup\QDART_XTT_$stamp" -Recurse -Force备份放非系统盘，理由不用多说。改完配置之后用Compare-Object跟备份比一遍，能立刻看出动过哪几行，比事后靠着记忆猜强。同一台机器上不同工位用不同的校准表时，备份目录里我会按工位号再分一层，避免把 A 工位的 cal 文件推到 B 工位上去。
3. 配 QSEQ_DeviceConfig.XML：手机端、仪表端与 Resources 三段怎么写
配置入口只有一个文件：C:\Program Files (x86)\Qualcomm\QDART\Databases\QSEQ_DeviceConfig.XML，XTT 里的 “Start QSEQ Session” 节点引用的就是它。它干三件事：告诉 QSEQ 手机怎么连、仪表怎么连、有哪些跨设备共享的资源（路径损耗表就是其中一个）。两个前置动作务必做到：用管理员权限编辑，并且改之前把 XTT 关掉——XTT 开着的时候改这个文件，改动不会生效，你会以为配置写错了，其实是进程里还是旧的那份。
3.1 手机设备的 CONNECT 串：三种连接类型怎么选
手机端配置的核心是一个 ConfigString，格式在文档里写得很清楚：CONNECT=<A>:<B>|TIMEOUT_SEC=<C>。外层标签名各版本略有差异，以你机器上 Databases 目录里的样例为准，下面只保留要改的那行：
<!-- 结构示意：外层 DeviceGroup/Device 的标签名照抄本机样例，别自己造 --> <ConfigString>CONNECT=QPST:COM23|TIMEOUT_SEC=30</ConfigString>A 是连接类型，只能取 QPST、QPHONEMS、USER_DEFINED 三个值之一；B 是 COM 口号；C 是超时秒数。三者的取舍：
- QPST：最常用，走 QPST 的端口枚举，台面上只有一台 DUT 时基本都用它。
- QPHONEMS：老的非信令通道，只在特定平台或老工具链上还需要保留，新环境不必主动选。
- USER_DEFINED：走厂商私有通道或自写驱动，连接串的具体格式由提供驱动的那一方定义，别照抄别人的。
TIMEOUT_SEC 别抠门。我给 30 秒起步，冷启动的 DUT 有时候要二十几秒才响应，写 5 秒的结果是偶发失败，而且失败信息只有一句“连接超时”，很容易被当成线材问题去换线。多工位并行时这段配置要一机一份，COM 号各不相同，共用一份配置文件的结果是两个工位抢同一个口，谁先连上谁跑，另一个随机失败。
3.2 仪表连接串：GPIB :: :: ::INSTR 与 RF_PORT_IDS
仪表端的 ConfigString 结构一样，但内容由仪表厂家的驱动决定，文档给的推荐格式是 VISA：
<ConfigString>CONNECT=GPIB0::19::0::INSTR|RF_PORT_IDS=MAIN,MAIN</ConfigString>X 是 GPIB 板卡号，单卡就是 0；Y 是仪表的主地址；Z 是次地址，多数综测仪次地址填 0；INSTR 表示这是一条消息型会话而不是寄存器型。RF_PORT_IDS是 RX0/RX1 的射频口映射，MAIN,MAIN表示两路都取仪表的主口。
做分集测量时这里要改：第二链路走仪表的 AUX 口，就得写成RF_PORT_IDS=MAIN,AUX，同时把仪表侧的第二路输出物理接到 AUX 上。两边必须一致，只改配置不改线（或者反过来），结果是读数比预期低十几二十个 dB，看起来像接收机坏了，实际只是信号从没接上的那个口出去。
提示：VISA 资源字符串从 NI MAX 直接复制。冒号数量、大小写错一处，报的是“设备未找到”，不会提示格式错误。
3.3 ResponsePayloadConfig：压缩和同步是绑在一起的
同一份文件里还有一段控制响应负载：
<!-- 默认值：不压缩、异步 --> <ResponsePayloadConfig>UNCOMPRESSED|ASYNC</ResponsePayloadConfig>这个标签接受两个字符串，用|分隔。第一个只能取 UNCOMPRESSED 或 COMPRESSED，第二个只能取 ASYNC 或 SYNC，默认就是上面这组。压缩的收益是负载变小、传输时间变短，经验数据大概是 1:4 的压缩比；代价是必须配 SYNC——压缩后的响应要等接收端重组完整才能解析，ASYNC 下接收端不等重组就往下走，边界靠运气，表现是偶发解析失败或者日志里出现半截数据。
<!-- 序列长、单段响应大的场景 --> <ResponsePayloadConfig>COMPRESSED|SYNC</ResponsePayloadConfig>我的做法是先用默认值把链路跑通，确认每个 segment 都有结果，再切压缩跑一遍对比总时长。一上来就开压缩，出问题时分不清是压缩引起的还是序列本身写错了，排查成本翻倍。
3.4 Resources 与 Path Loss Manager：那段相对路径
Resources 是 QSEQ Core 里的一套资源扩展机制：自定义资源类继承 QSEQ_Resource，向 QSEQ_ResourceFactoryManager 注册，每次创建 device group 时按类型实例化一份挂在组上，组内设备用字符串标识取用。Path Loss Manager 就是官方给的现成例子：
<Resources> <Resource name="QSEQ_RESOURCE_PATHLOSSMANAGER" config="..\Databases\calDB_NET.xml"></Resource> </Resources>问题就出在这个config。它是相对路径，基准是 XTT 的当前工作目录，不是这个 XML 文件所在的目录。同一份配置，从不同目录启动 XTT，结果不一样，表现是路径损耗全变 0 dB，或者直接加载失败。我一般改成绝对路径：
<Resource name="QSEQ_RESOURCE_PATHLOSSMANAGER" config="C:\Program Files (x86)\Qualcomm\QDART\Databases\calDB_NET.xml"></Resource>多工位各有各的校准表时，把这份 XML 按工位复制一份，只改这一行，别在一个文件里塞多套配置再靠环境变量切换——切换失败的时候，你拿到的是别人的校准值，数据看着正常，其实是错的。
4. 拼 XTT/XML 序列：从 AlgorithmSegment 到最终脚本
配置通了，接下来是序列本身。QSEQ 的模型不复杂：XTT 是树，XML 是内容，工具侧把若干份 XML 合成一个最终脚本再执行。麻烦的是“合成”这件事没有强约束，全靠目录结构和命名习惯，接手别人搭好的环境时，经常找不到哪一段改过功率。这一章按目录、段、挂载、扫描顺序四步走。
4.1 XTT 目录结构：为什么 FDD/TDD 分家、ILPC 与 DRx 被单独拆出来
每种技术一个测试目录，这是最基本的。LTE 的 FDD 和 TDD 是分开的，因为波形不同；WCDMA 的 ILPC 也被拆开，同样是因为波形；DRx 单独拆，是因为在非信令 FTM 下 QTI 没法在 list mode 里激活链路，链路必须在各个 segment 里单独设置。这个拆分顺带带来一个好处：AUX 可以作为第二链路的输出口，做分集的时候不用再另起一套序列。
# 看每个技术目录下到底有多少份序列，空壳目录一眼就能看出来 $lte = "C:\Program Files (x86)\Qualcomm\QDART\XTT\SubSysVFS\LTE" Get-ChildItem $lte -Directory | ForEach-Object { [pscustomobject]@{ Tech = $_.Name XmlNum = (Get-ChildItem $_.FullName -Recurse -Filter *.xml).Count } }输出里 FDD 和 TDD 是两个平级目录，别在 FDD 下面找 TDD 的 band 文件，找不到是正常的。文件数为 0 的目录基本是空壳，说明这个包只带了部分技术，要做全制式验证得换完整包。
4.2 一份 XML 里的多个 AlgorithmSegment
一个 XML 可以包含多个 AlgorithmSegment，一个 AlgorithmSegment 对应一个 segment，做一件具体的事——建立呼叫、测 BLER、改参数再测。文档里 MP LTE FDD band 的例子是三步：先做一次 handover，再改 RB 与调制方式并测量，然后把目标功率改到 -36.8 dBm 再测一遍。
<!-- 结构示意：真实标签名照抄 TPP 包里的样例，这里只保留排查时会看的字段 --> <Sequence technology="LTE_FDD" band="1"> <AlgorithmSegment name="Handover"> <!-- 切到目标 band/小区，建立连接 --> </AlgorithmSegment> <AlgorithmSegment name="RB_Mod_Sweep"> <!-- 改 RB 数与调制方式，逐点测量 --> </AlgorithmSegment> <AlgorithmSegment name="TargetPower_m36p8"> <!-- 目标功率拉到 -36.8 dBm，复测同一组点 --> </AlgorithmSegment> </Sequence>三段共用一次连接，不要在每段里重连。把“改参数”和“测量”放在同一个 segment 里，日志里能对上；拆
本文还有配套的精品资源，点击获取
