QXDM工具使用指导书.docx
《QXDM工具使用指导书.docx》由会员分享，可在线阅读，更多相关《QXDM工具使用指导书.docx（40页珍藏版）》请在冰点文库上搜索。
QXDM工具使用指导书
QXDM工具使用指导书
QXDM简介3
1.物理连接3
2.QXDM工具套件简介4
2.1.DatabaseEditor4
2.2.DLFConverter4
2.3.ISFConverter5
2.4.ItemTester5
2.5.Listen-OnlyQXDM5
2.6.QXDM5
3.Stepbystep学习QXDM的常用功能5
3.1QXDM和手机如何正确连接？
5
3.2如何保存和加载配置文件？
8
3.3如何新建和保存一个跟踪项目？
8
3.4如何重现跟踪信息？
11
3.5如何用QXDM对手机进行自动操作？
12
3.6如何查看跟踪信息？
13
3.7如何进行信令消息跟踪？
14
3.8如何使用nvbrowser对手机进行重新配置？
16
3.9如何使用nvbrowser对手机进行锁频？
19
3.10如何使用nvbrowser观察手机当前搜网状态？
19
3.11如何查看当前收发功率？
20
3.12如何观察手机终端当前网络状态？
21
3.13如何查看voip电话时延？
21
3.14图形界面中的右键菜单。
22
Clear22
Cursor22
SaveImage22
Auto-Scroll22
AxisZoomMode23
LegendVisible23
Range23
ViewChannel24
3.15滚动列表中的右键菜单。
24
3.16如何查看功控信息？
30
3.17如何查看hspa信息？
31
3.18如何查看Bler值？
31
3.19如何查看小区重选信息？
32
3.20如何查看RLC层信息？
33
3.21如何将isf中的文件转换为可以用ethereal解析的文件？
34
3.22LogView和MessageView有什么区别和联系？
35
1LogViewConfiguration（日志查看设置）35
1.1LogPackets36
1.2MessagePackets37
2MessagesView38
2.1MessageViewConfiguration（消息查看设置）38
2.1.1LogPackets39
2.1.2LogPackets（OTA）40
2.1.3MessagePackets41
2.1.4EventReports42
QXDM使用指导
QXDM简介
QXDM（TheQUALCOMMExtensibleDiagnosticMonitor）是高通公司（Qualcomm）公司发布的可以对手机终端所发数据进行跟踪有效工具，通过对数据的分析可以诊断信令流程、分析数据包的正确与否等。
在测试中有重要作用，正确合理的使用可以为我们测试提供便捷的定位手段。
下面将简要介绍一下它的使用方法。
Driver:
1.物理连接
QXDM是利用QPSTServer（Section3.3.1.1），通过USB延长线或串口连接到PC的COM端口上,如图1-1所示。
图1-1物理连接
2.
QXDM工具套件简介
下面是随QXDM一起安装的工具，在开始菜单里可以看到。
最常用的一些工具则可以通过QXDM菜单直接使用。
图2-1StartMenu–QXDM工具套件
2.1.DatabaseEditor
数据库编辑工具为用户提供了一个用户自定义接口，可以在里面设置事件跟踪、消息跟踪、日志跟踪的具体项目等。
2.2.DLFConverter
DLf文件转换器可以把DLF文件转换为ISF，转换成为ISF后就可以直接用QXDM进行分析。
（这个工具对Qualcomm公司可能很有用，但对我们几乎没用。
DLF文件是高通老版本的分析工具产生的文件）
命令：
DLFConverter
2.3.ISFConverter
该工具可以将ISF文件转换为DLF文件，这个工具对我们也没有多大用处。
命令：
ISFConverter<–pc>
2.4.ItemTester
TheItemTester是一种对QXDM数据库中items进行测试的一个有用的工具，并且支持自动生成相应测试项的测试脚本。
2.5.Listen-OnlyQXDM
在Listen-Only模式下，即监听模式下，QXDM只能对终端数据进行跟踪和捕获，而不能向终端下发指令。
2.6.QXDM
QXDM主程序，从第三解节起详细介绍。
3.Stepbystep学习QXDM的常用功能
3.1QXDM和手机如何正确连接？
在图1－1中我们可以清楚的看到，QXDM是通过QPST软件来统一管理端口连接，实现手机终端和PC用户图形界面的一个交互的功能的。
当我们通过USB延长线将手机的连接到电脑上后，如果已经正确安装该手机终端的USB驱动，那么就应该可以在“我的电脑（右键）->管理->设备管理器”中看到以下菜单：
由图3-1我们可以看到，手机终端所用的COM端口号为：
COM25号端口。
图3-1UE使用的COM端口
图3-2QPSTconfigurationglobe
在任务栏的系统托盘里我们可以看到蓝绿图案类似地球的一个图标，它就是QPST。
双击QPST图标如图3-2，就会弹出如图3-3所示界面:
图3-3QPST
我们并没有看到需要的COM25端口，此时只需要点击AddNewPort…加入新的端口之后，点击Options→Communications…dialog中菜单，然后选择COM25点击OK即可。
在此设置QXDM连接UE使用的COM端口。
图3-4Options→Communications…dialog
注：
●Timeouts（MS）
超时设置
●DIAGrequests
QXDM向UE发出DIAG请求时等待的时间（以毫秒为单位）等待回应时间。
3.2如何保存和加载配置文件？
我们知道QXDM跟踪捕获的信息量很大，但是由很多信息并不是我们想要的，此时就需要过滤一下。
但是QXDM里面的设置较为复杂，如果每次跟踪之前都要重新设置，那必将耗时耗力。
但是我们可以一次设置好之后把其设置保存为相应的设置文件然后在需要的时候导入即可以轻松完成设置。
LoadConfiguration…
加载设置文件，利用该菜单可以将原来保存的典型设置文件直接加载从而省去了重复设置的麻烦（.DMC扩展名）.
File→LoadConfiguration…
SaveConfiguration…
被选择的查看列表项以及其他设置都将会被保存到配置文件中，以便下次读入。
（.DMCextension）
File→SaveConfiguration…
3.3如何新建和保存一个跟踪项目？
NewItems…
新建一个跟踪项目。
当已经捕获了不少数据，但又要重新进行一次捕获，并且不想保存这一次已经捕获的数据数据的时候，就可以利用这个菜单，清空现在已经捕获的所有数据。
（alt＋I）。
注意
如果设置了保存选项，我们在新建的时候那么QXDM会要求我们保存，否则将会自动清除所有内容。
File→NewItems…
SaveItems…
保存跟踪数据默认目录（C:
\DocumentsandSettings\AllUsers\Documents\Qualcomm\QXDM\ISF.）（ctrl＋I）。
如果不想被保存在默认目录下，通过以下菜单可以进行修改和重设。
如图3-5所示。
图3-5Files→ItemStoreSettings…
图3-6Files→ItemStoreSettings…dialog
3.4如何重现跟踪信息？
使用QXDM可以对已保存的.isf文件进行重放：
ReplayItems…
注意
这个选项只能在QXDM没有连任何终端的时候才可以用。
用该选项可以重放以前保存下来的.isf文件。
图3-7Files→ReplayItems
图3-8Replaydialog
3.5如何用QXDM对手机进行自动操作？
如图3-9所示，在view栏我们可以找到CallManager的菜单，点击之后，可以弹出
图3-9View→CallManager
图3-10CallManagerDialog
如图3-10所示，我们可以在这里设置通话连接的各种参数而不需要手动的对手机进行操作。
此外还可以在option菜单下对手机进行重启和离线模式的操作等。
3.6如何查看跟踪信息？
在如图3-9所示中可以，可以找到ItemView,或者直接按F11也可以。
列表项查看（TheItemView）可以对QXDM跟踪过程中所产生的isf临时文件（一般在C:
\DocumentsandSettings\AllUsers\Documents\Qualcomm\QXDM\ISF目录下存放。
）中所有的列表项。
F12键（或者在view窗口中选择FilteredView）可以进入过滤模式，可以有选择性的查看现在QXDM跟踪的列表项（保存在sif文件中的数据并不会因为过滤查看模式而改变，区别与logviewconfigF5。
）
消息查看和日志查看（theMessagesViewandLogView）是预定义的过滤查看的一种。
消息查看和日志查看都可以在QXDM离线的情况下通过QXDM主菜单进行设置。
（options菜单下。
）
命令输出显示（TheCommandOutputdisplay）只会在输入和运行命令的时候对命令以及命令结果进行输出。
除了MessagesView,LogView,和CommandOutputdisplay之外，每个itemlistview都分为三个面板，最上面一个面板里滚动显示每条捕获的item；下侧左边的面板里可以显示当前选中的在上面显示的ITEM的原始数据内容；下侧右边的面板则用于显示被选择的ITEM的各个域的解析结果。
所有的item都会在ScrollingListPane里显示，包括theItemView,FilteredViews,theMessagesView,theLogView,以及theCommandOutputdisplay.在选中的ITEM上点击右键，会弹出菜单，如图3-11所示。
在这里可以对要查看的内容进行设置，查看item的内容等。
（如图3-11所示）
图3-11滚动列表菜单选项
3.7如何进行信令消息跟踪？
在列表项上点击右键会弹出以下菜单（如图3-11所示）。
然后利用RefilterItems…菜单进行过滤。
图3-12常用信令消息跟踪
选中LogPackets（OTA）然后在右面的面板里选中，WCDMA和UMTS的所有信令。
这样设置后，我们可以在新开的filter（3）窗口中可以看到通话建立的全过程的信令，如图3-13所示。
分为两个面板，在下面的一个面板里可以显示当前所选中的消息的内容。
通过信令消息的跟踪和分析，可以更容易的对问题进行定位。
对于MessagePackets，主要是对手机各个子层的debug信息，这些信息是对手机终端公司是很有用的，但对我们来说基本上没什么用处。
图3-13常用信令消息跟踪
3.8如何使用nvbrowser对手机进行重新配置？
对于高通的手机终端，很多时候要靠改写非易失性存储器中的内容来开关某个功能，即改写NV项。
如图3-14所示，在viewbar中可以找到nvbrowser选项，选中后会弹出nvbrowser的面板。
在这里可以对NV项进行读取和改写。
选中某一项，然后点击read就可以读出当前内容，然后可以双击Input栏下对应的数值，并在出现编辑框之后写入需要写入的内容，然后点击Write即可。
对于最左边的一列可以输入序号进行查找。
（注意在输入序号时，比如03525一次输入0.3..5.2.5，对于一串数字的识别是基于输入间隔时间进行的，所以输入时注意间隔时间不宜过长。
）
当然也可以通过在Commend窗口直接输入命令进行操作。
其它命令的格式也在下表中列出。
图3-14nvbrowser
Propertycommandreplacements
Propertycommand
Databasecommandreplacement
get_property
RequestItem
RequestNVItemRead
put_property
RequestItem
RequestNVItemWrite
print_property
ClickonanitemintheItemTesterApplication（Figure7-1）
list_properties
UsetheItemTesterApplication（accessiblefromtheToolsmenu,Figure3-18）
nv_read
RequestNVItemRead
nv_write
RequestNVItemWrite
图3-15nv操作
nv_read_item4173//读出nv项4173的值
nv_write_item41730x00//将nv项4173的值写为0
还可以进行批处理操作，先用UltraEdit编辑然后存贮为*.scr文件即可。
Offline
在写NV项之前，使手机处于离线模式。
Reset
写完NV项之后重新启动手机
Read
读出对应NV项的内容。
Write
将值写入目标手机的对应NV项。
3.9如何使用nvbrowser对手机进行锁频？
通过对NV项重写可以实现对手机的锁频操作。
NV项3525是一个布尔值lock_frequence_enable,把它的值改写为1时，允许手机进行锁频操作；3524存储的是要锁定的频点值。
只有在3525为1时，3524存储的频点值才生效。
3.10如何观察手机当前搜网状态？
图3-16WCDMAPilotScanner
在viewbar中我们可以找到WCDMAPilotScanner，如图3-16所示，是手机开机搜网的瞬间所搜到的不同小区的信号强度和其它参数。
然后手机会根据某些规则选择最合适的一个小区主流下来，如图3-17所示。
也可以通过以下菜单进入：
View->new->WCDMA->WCDMAPilotScanner
图3-17手机驻留小区
3.11如何查看当前收发功率？
在viewbar中我们可以找到WCDMAPower选项，在这里我们可以实时监测当前手机终端的收发功率等。
图3-18WcdmaPower
View->new->WCDMA->WCDMAPower
3.12如何观察手机终端当前网络状态？
在viewbar中我们可以找到WCDMARRCStatus,在这里我没可以看到当前上下行频点号，RRC状态、cellID、URaID、小区状态（barredornot，reservedornot），UE是否驻留在某个小区等信息，如图3-19所示。
图3-19WCDMARRCStatus
View->new->WCDMA->WCDMARRCStatus
3.13如何查看voip电话时延？
在viewbar中我们可以找到VOIPQDJStatus,打开之后，我们就可以看到VOIP电话的时延等信息。
View->new->common->VOIPQDJStatus
图3-20VOIPQDJStatus
3.14图形界面中的右键菜单。
Clear
历史绘图将会被清除。
Cursor
选中之后在图表界面上将会出现一条竖线，用鼠标可以将其移动。
并且会在右边的面板里动态显示当前位置所对应时刻的各种参数的具体值。
（如图3-20所示）
SaveImage
可以将当前窗口中的图标保存为BMP,JPG,orPNG等图象文件格式。
Auto-Scroll
自动滚动。
（alt＋S）
AxisZoomMode
调整坐标的显示范围，也可以在X或Y轴上按下鼠标左键拖动。
图3-21图形界面右键菜单
LegendVisible
在支持传统显示的图表里显示打开传统的显示方式。
对于Cursor选中时看到的数据，只有在LegendVisible同时选中时才能看到。
Range
调整X轴每单位长度所表示的间隔
ViewChannel
在这里选择要查看的具体信道。
在图3－20中选中了来自基站和其它UE的接受功率和发送功率。
3.15滚动列表中的右键菜单。
在滚动列表里点击右键，将会出现下面的菜单。
图3-22滚动列表菜单选项
3.15.1Appearance（外观显示）
在这个菜单中我们可以选择显示列表中项目的格式和内容等。
●Timestamps（时间戳）
时间戳是用格林尼治标准时间显示的（GreenwichMeanTime（GMT））并且可以被设置为包括日期和毫秒的格式。
当然也可以设置为获取得Item中所带的时间戳。
日志、事件、debug信息中等，都有从手机终端中获得的时间戳信息。
●Payload（净荷）
当Payloadcolumn被选中后，将会在列表的最右边显示数据报的负载数据内容。
图3-23ItemListAppearance
3.15.2Configuration（设置）
通过这个菜单我们可以设置显示哪些items。
在左边Items被按照不同的类型分组，可以选择我们要查看到信息的类型，在右边可以设置具体的过滤条件。
图3-24ItemListConfigdialog
下表将显示不同的类型Items的数据来源。
Table4-1Itemtypes
Itemtype
Source
DIAGMalformedPackets
Phone
DIAGRequests
QXDM,User
DIAGResponses
Phone
EventReports
Phone
GPSReports
GPSReceiver
LogPackets
Phone
LogPackets（OTA）
Phone
MessagePackets
Phone
Strings
QXDM,User
SubsystemDispatchRequests
QXDM,User
SubsystemDispatchResponses
Phone
●AcceptUnknowns
QXDM无法识别的项目也一起接收和显示。
（如果一个消息的类型和QXDM数据库中已有的类型之间没有已知的映射关系时，就不能被QXDM识别。
）
●Copying
我们可以选择整体或者部分的过滤出来的数据单独保存一个.isf文件或者是文本文件，下面的列表里给出了具体的操作方法。
Table4-2CopyingItems
Item
Description
CopyItems
CopyselecteditemstoanItemStoreFormat（.ISF）file
CopyAllItems
CopyAllItemstoanItemStoreFormat（.ISF）file
CopyText（ALT+C）
Copyselectedtexttotheclipboard
ExportText（ALT+F）
Exportselecteditemsastexttoafile
ExportAllText（ALT+A）
Exportallitemsastexttoafile
SelectAll（CTRL+A）
Selectallitems
●Searching
由于列表里的item数量很庞大，某一条具体的信息要找起可能很费力。
但是如果我们记得索引，就可以通过GOTO选项迅速定位，如果不记得索引也没关系。
只要记得名字或者消息名字的字符串，就可以迅速查找。
如图3-25所示。
●ClearItems
清除当前窗口中的所有显示。
（SHIFT+DELETE.）
注意
如果要清除所有列表里的数据，可以用快捷键，但是这样以来保存在.isfL临时文件中的所有数据都会被清空，连接被重置，重新开始捕获数据。
●MatchItems…
利用这个选项可以将某一种目标item从选中的item集中过滤出来，重新创建一个符合选项的过滤查看窗口。
选项菜单类似于Searching.
图3-25MatchItemsdialog
它们之间唯一的区别就是MatdhItems菜单中，查找方向是不可选的（事实上也不需要选），它会在您选中的区间中进行过滤。
●RefilterItems（重过滤）
可以利用这个选项进一步缩小过滤列表项的内容。
在一个列表窗口选中这个菜单选项就可以在原来过滤的条件下进一步过滤。
图3-26RefilterItemsdialog
●RawItem（原始数据）
这个选项可以对当前选中的列表项以十六进制来显示其原始数据。
在原始数据窗口，点击右键还可以显示其相应的菜单。
图3-27RawItemmenu
3.16如何查看功控信息？
在viewbar中我们可以找到WCDMAPowerContrl，打开后我没可以监测功控信息。
图3-28WCDMAPowerControl，
View->ne
升级会员 