Catcher 使用说明
1 Overview 概述...........................................................................................................3
1.1Overview of MTK Catcher MTK Catcher 的概述............................................................................................................................................................................3
1.2 Using Catcher: Logging mode 使用 Catcher：logging 模式...........................................................................................................................................................5
1.3 Using Catcher: Off-line mode 使用 Catcher：Off-line 模式...........................................................................................................................................................7
2 Frame Window and Dialogs 框架窗口和对话框...................................................8
2.1 Trace & Primitive Log Window Trace & Primitive Log 窗口..........................................................................................................................................................8
2.2 Sys Trace Window 系统追踪窗口..................................................................................................................................................................................................12
2.3 Err Msg Window 错误消息窗口.....................................................................................................................................................................................................14
2.4 MSC View Window MSC（消息序列图）视图窗口...................................................................................................................................................................16
2.5 Filter Dialog Filter 对话框..............................................................................................................................................................................................................18
2.6 Engineering Mode Dialog 工程模式对话框...................................................................................................................................................................................21
2.7 Sim Editor Dialog Sim 编辑器对话框............................................................................................................................................................................................24
2.8 Exception Window 异常窗口..........................................................................................................................................................................................................26
2.9 Statistics Window 统计数据窗口...................................................................................................................................................................................................28
3 Menus 菜单..............................................................................................................30
3.1 File menu 文件菜单........................................................................................................................................................................................................................30
3.2 Edit menu 编辑菜单........................................................................................................................................................................................................................32
3.3 View menu 视图菜单......................................................................................................................................................................................................................33
3.4 Control menu 控制菜单..................................................................................................................................................................................................................35
3.5 Config menu 配置菜单...................................................................................................................................................................................................................36
3.6 Advance menu 高级菜单................................................................................................................................................................................................................37
3.7 Window menu 窗口菜单.................................................................................................................................................................................................................39
3.8 Help menu 帮助菜单.......................................................................................................................................................................................................................40
3.9 Tool Bar 工具栏...............................................................................................................................................................................................................................41
3.10 Command Tool Bar 命令工具栏...................................................................................................................................................................................................44
3.11 AT Command Tool Bar AT 命令工具栏........................................................................................................................................................................................45
3.12 Auto-Clear Tool Bar 自动-清除工具栏........................................................................................................................................................................................46
1 Overview 概述
1.1 Overview of MTK Catcher MTK Catcher 的概述
Catcher is a PC-side tool for MTK GSM/GPRS Products. The main function
of Catcher is for logging primitives and debug information.
空白
The wireless protocol stack is composed of different modules. Each module
uses primitives (messages) to communicate with other modules through SAP
(service access point). Catcher can log these primitives by setting the correct
filters. Modules also use trace functions to display the debug information on
Catcher.
空白
The structures of the primitives are parsed and collected during the
target-build process. An information-database will be generated after the process,
so Catcher can use the database to display primitives. It‘s important for catcher to
use the correct database. Using a mismatched database will result in confusion
and a wrong logging file.
空白
Catcher has two operation modes: logging mode and off-line mode.
Catcher 是一个在 PC 端的工具，用于 MTK GSM/GPRS 产品。它的主要
功能是记录 primitives 和 debug 信息。
空白空白
无 线 协 议 栈 是 由 不 同 module 组 成 的 。 每 个 module 使 用
primitives（messages）、并通过 SAP 与其它 module 进行通信。如果设置正确
的 filters，Catcher 能把这些 primitives 都 log 下来。Modules 还使用 trace 函数
来显示 debug 信息。
空白
空白
在 target-build 过程中，primitives 的结构被解析并被收集。过程结束后，
会生成一个信息数据库，然后 catcher 就使用这个数据库来显示 primitives。
使用正确的数据库对 catcher 而言甚为重要。使用误配的数据库会引起混乱
并生成错误的 logging 文件。
空白
空白空白
Catcher 有两种运行模式：logging（记录）模式和 off-line（离线）模式。
空白
For logging mode, Catcher needs the database generated during the
target-build process. After setting the correct database, engineers can connect to
the target and set the filters for the information, which they want to analyze. All
the setting can be saved in a workspace file. The primitives and debug
information can be saved to a log-file.
空白
Engineers can open the Engineering Dialog to see the data of the mobile
phone. SIM-Editor can be used to retrieve and set the data in the SIM Card.
空白
During logging, Catcher also provides a facility to send " Proprietary
command" and "AT command" to modules of protocol stack. Protocol engineers
are therefore able to instantly control the states and behaviors of modules of
protocol stack. Engineers can also retrieve the exception and statistics
information of the mobile phone by using the menu commands on Catcher.
空白
For off-line mode, engineers can open a log-file and analyzed the log
information. Off-line filters can be set to display the most useful information.
Catcher also supports the MSC View of the primitive log.
空白
logging 模式时，catcher 需要取得在 target-build 过程中所生成的数据库。
设置正确的数据库以后，工程师可以连接至 target 并针对他们想分析的信息
设置 filters。所有这些设置可以被保存在一个 workspace 文件内。Primitives 和
debug 信息可以被保存至一个 log 文件。
空白
工程师可以打开 Engineering Dialog（工程对话）以查看手机的数据。可
以使用 SIM 编辑器来检索和设置 SIM 卡内的数据。
空白
空白
在 logging 时 ， catcher 也 提 供 一 种 命 令 发 送 功 能 ， 即 向 协 议 栈 的
module 发送“Proprietary 命令”和“AT 命令”。于是协议工程师就能即时控制
协议栈 module 的状态和行为。工程师还可以使用 Catcher 提供的菜单命令来
检索手机的 exception 和统计数据信息。
空白
空白
在 Off-line 模式，工程师可以打开一个 log 文件、分析 log 信息。可以设
置 Off-line filters 来显示最有用的信息。Catcher 还支持 primitive log 的 MSC
View。
1.2 Using Catcher: Logging mode 使用 Catcher：logging 模式
To enter the logging mode, users can open a pre-saved workspace in the
menu [File/Open Workspace] for logging mode, or do the following steps:
空白
1.
Start Catcher and set the correct database.
On the Config menu, click Set Database Path to open a database, which
match the target-load on the mobile phone.
空白
2.
Select the Logging mode.
Select the logging icon on the Toolbar or use the menu [Control/Mode].
空白
3.
Modify the com port settings.
Select the configure RS232 icon on the Toolbar or use the menu
[Config/Configure RS232].
空白
4.
Connect to the target.
Select the Connect and sync icon on the Toolbar or use the menu
[Control/Connect].
Make sure the serial line is connected to the target correctly before this
step.
空白
5.
Set the filters.
若要进入 logging 模式，用户可以在菜单[File/Open Workspace]中打开
一个预存的 workspace，或者按照以下步骤做：
空白
1. 启动 Catcher，设置正确的数据库。
点击菜单 Config/Set Database Path，打开一个数据库，该数据库与
手机上的 target-load 相匹配。
空白
2. 选择 logging 模式。
选择工具栏上的 logging 图标，或者点击菜单[Control/Mode]。
空白
3. 修改 com port 设置。
选 择 工 具 栏 上 的 RS232 图 标 ， 或 者 点 击 菜 单 [Config/Configure
RS232]。
空白
4. 连接至 target。
选 择 工 具 栏 上 的 Connect and sync 图 标 ， 或 者 点 击 菜 单
[Control/Connect]。
在此步骤之前，请确保串行线路已正确连接至 target。
空白
空白
Select the Filter icon on the Toolbar use the menu [Control/Set Filter].
Be careful not to turn on too many filters that exceed the RS232
bandwidth, or data lost will happen. Please refer to the setting of the
Filter.
空白
6.
Start logging.
The primitives and trace information will be displayed on the Trace &
Primitive Log Window.
After logging, users may want to save the logged information in the
menu [File/Save Log] and save all the workspace settings in [File/Save
Workspace].
5. 设置 filters。
选择工具栏上的 Filter 图标，或者点击菜单[Control/Set Filter]。
小心不要打开太多 filters，以免超过 RS232 的带宽，或导致数据丢
失。请参考 Filter 的设置。
空白
空白
6. 开始 logging
Primitives 和 trace 信息会显示在 Trace& Primitive Log 窗口。
Logging 之后，用户可以点击菜单[File/Save Log]来保存 logged 的信
息，或者点击菜单[File/Save Workspace]来保存所有 workspace 设置。
1.3 Using Catcher: Off-line mode 使用 Catcher：Off-line 模式
To enter the off-line mode, users can open a pre-saved workspace in the
menu [File/Open Workspace] for Off-line mode, or do the following steps:
空白
1. Start Catcher and open a log file (.clg).
On the File menu, click Open to open a log file (.clg).
空白
2. Set the off-line filters.
Select the Filter icon on the Toolbar or use the menu [Control/Set
Filter].
Please refer to the setting of the Filter.
You can save all the workspace settings in [File/Save Workspace].
若要进入 off-line 模式，用户可以点击菜单[File/Open Workspace]，选择
Off-line 模式，或者按照以下步骤做：
空白
空白
1. 启动 Catcher，打开一个 log 文件（.clg）。
点击菜单 File/Open 来打开一个 log 文件（.clg）。
空白
2. 设置 off-line filters。
选择工具栏上的 Filter 图标或者点击菜单[Control/Set Filter]。
请参考 Filter 的设置。
可以点击菜单[File/Save Workspace]来保存所有 workspace 设置。
2 Frame Window and Dialogs 框架窗口和对话框
2.1 Trace & Primitive Log Window Trace & Primitive Log 窗口
This child frame window, which split into 2 views, is dedicated for Trace &
Primitive Log. The top view will display the received Traces and Primitive Log
together, and only summary information of them are displayed. The summary
information includes type, index, frame number, time, source module, destination
module, sap/class name, and message ID. In the type column of this top view,
different icon is used for identifying the type of logged information.
空白
When users select one Trace or Primitive Log in the top view, the
corresponding details will be displayed in the bottom view. In addition, if the
selected item is a Primitive Log, it will show the description of each field,
including its value and data type. Users can also set the text color of each data
type for the bottom view (See Filter Dialog). Besides, users can set the number of
display columns for both the views by mouse right clicking.
空白
There are two different styles for this frame window. The first style shows
all the logged information in an integrated window: all the Traces and Primitive
这个子框架窗口专用于 Trace & Primitive，外形分裂成两个部分。上面
的部分把 Traces 和 Primitive Log 显示在一起，但只显示摘要信息。摘要信息
包括类型、索引、frame 号、时间、源 module、目标 module、sap/class 名称和消息
号。在 type 一栏内，不同的图标用来区分 logged 信息的类型。
空白
空白
空白
当用户在上面的部分视图选择了一个 Trace 或 Primitive Log 时，对应的
细节会在下部视图显示出来。另外，如果被选的 item 是一个 Primitive Log 时，
视图中会显示每 field 的描述，包括值和数据类型。用户也可以在下部视图
中设置每种数据类型的文本颜色（见 Filter Dialog）。而且，用户可以用鼠
标右击设置上下两部分的显示的栏目数目。
空白
空白
这个框架窗口有两种不同的风格。第一种风格是在一个集成窗口显示所
有的 logged 信息：所有的 Traces 和 Primitive Log 在一个窗口里面显示。第二
log are displayed in only one window. The second style shows the logged
information in separated windows: each window is dedicated for each module,
and only shows the logging messages dumped by itself. (See Config Menu).
空白
Users can click the right mouse button to change settings or execute
commands:
空白
Upper view
种风格是在不同的窗口显示 logged 信息：每个窗口只显示一种 module，而
且只显示自己 dump 的 logging 消息。（见 Config Menu）
空白
空白
用户右键单击来改变设置或者执行命令：
空白
空白
上部分视图
空白
Scroll
空白
卷动
Save to Clg
Save to Text
Customize
If the view is scrolled after receiving new Trace or
Primitive Log.
The selected messages and those corresponding
messages will be saved to the specific clg file.
The selected messages will be saved to the specific
text file.
It will pop up a dialog to set which column to be
displayed.
空白
空白
Lower view
Expand
Decode Peer
Save to Text
保存到 Clg
收到新 Trace 或 Primitive Log 后，视图是否卷动。
保存至 Text
选中的消息和那些对应的消息会被保存到特定的
clg 文件。
选中的消息会被保存到特定的 text 文件。
订制
会弹出一个对话框，可以设置显示哪些栏。
空白
下部分视图
If the tree structures of local parameter/peer buffer
are expanded.
If the peer buffer will be decoded by MCD.
The raw data will be saved to the specific text file by
扩展
局部参数/peer buffer 的树形结构是否展开
解码 Peer
保存至文本
peer buffer 是否由 MCD 进行解码
原始数据是否按树格式（?）保存至特定文本文档
Customize
Customize Expand
tree format.
It will pop up a dialog to set which column to be
displayed.
It will pop up a dialog to set the number of
expanding layers.
空白
空白
空白
Column Description
Type
Index
Frame # / Time
Local Time
Source / Destination
Message / SAP Name
Message type (Trace/Primitive Log).
The message index in this window.
The sending time of this message.
The received time of this message on PC host.
Which module sends message to which module.
Name of message / SAP or trace class.
订制
订制扩展
空空白白
空白
栏描述
类型
索引
框 # / 时间
本地时间
源/目的地
消息/SAP 名
会弹出一个对话来设置哪一栏被显示
会弹出一个对话来设置扩展层的数目
消息类型（Trace/Primitive Log）
消息索引在这个窗口
此消息的发送时间
PC host 上收到此消息的时间
哪个 module 发送消息至哪个 module
消息/SAP 的名称或 trace class
2.2 Sys Trace Window 系统追踪窗口
This child frame window is dedicated for system-dumped messages.
Users can click the right mouse button to change settings or execute commands:
空白
Pop-up Menu Description
Scroll
Save Selected to Clg
Save Selected to text
Save all to text
If the view is scrolled after receiving the new
Sys_Trace messages.
The selected Sys_Trace and those corresponding
messages will be saved to the specific clg file.
The selected Sys_Trace will be saved to the specific
text file.
All the received Sys_Trace will be saved to the
specific text file.
空白
Column Description
Frame # / Time
Local Time
Message
The sending time of this message.
The received time of this message on PC host.
Message content.
这个子框架窗口专为系统-dump 的消息。
用户可以点击鼠标右键来改变设置或执行命令。
空白
空白
弹出菜单描述
卷动
收到新 Sys_Trace 消息后视图是否卷动
保存选中的内容至 Clg
选中的 Sys_Trace 和那些相应的消息是否被保存
到特定的 clg 文件
选中的 Sys_Trace 会被保存到特定的文本文件
保存 选中 的内 容至 文
本
保存所有内容至文本
所有被选中的 Sys_Trace 都会被保存至特定的文
本文档
空白
空白
栏描述
框 # / 时间
本地时间
消息
此消息的发送时间
PC host 上此消息的接收时间
消息内容
2.3 Err Msg Window 错误消息窗口
This child frame window is dedicated for catcher-dumped error messages.
Users can click the right mouse button to change settings or execute commands:
空白
Pop-up Menu Description
Scroll
Save Selected to Clg
Save Selected to text
Save all to text
If the view is scrolled after receiving the new error
messages.
The selected error messages and those corresponding
messages will be saved to the specific clg file.
The selected error messages will be saved to a specific
text file.
All the received error messages will be saved to the
specific text file.
空白
Column Description
Local Time
Message
The received time of this message on PC host.
Message content.
这个子框窗口专为 catcher-dumped 错误消息。
用户可以点击鼠标右键来改变设置或者执行命令。
空白
空白
空白
弹出菜单描述
卷动
保存选中的内容至
Clg
保存选中的内容至
文本
保存所有内容至文
本
空白
空白
栏描述
本地时间
消息
收到新的错误信息后视图是否卷动
选中的错误消息和那些相应的消息会被保存至特定
的 clg 文件
选中的错误消息会被保存至特定的文本文档。
所有收到的错误消息会被保存至特定的文本文档。
PC host 上收到此消息的时间
消息内容
2.4 MSC View Window MSC（消息序列图）视图窗口
The MSC View, which is dedicated for Primitive Log displays the message flow
in graphic mode. It uses arrows to describe the message directions, and the
sending time will also be included . If the message name can’t be totally shown,
you can move cursor to the position of the message and then a tool tip will be
popped up.
空白
Furthermore, it provide the following functionalities for users:
空白
Functionalities
Description
Zoom In / Out
Change
modules’position
Copy
the
current
screen
Sync with Trace &
Primitive Log Window
Change the y-axis scale by clicking menu or toolbar.
Drag the selected module and drop to another
module.
Click menu [Edit / Copy] or button [Copy].
Click the message in MSC View, and then the
corresponding Primitive Log in Trace & Primitive
Log Window will be selected.
Click the Primitive Log in Trace & Primitive Log
Window, and then corresponding message in MSC
MSC 视图，专为 Primitive Log，它以图形模式显示消息流。它使用箭头来描
述消息方向，还有发送时间。如果消息名称不能完全显示，你可以移动游标
到消息的位置，然后一个 tool tip 会被弹出。
空白
空白
另外，还为用户提供以下功能：
空白
功能
描述
放大 缩小
改变 module 的位置
点击菜单或工具栏以改变 y 轴的刻度
拖拽选中的 module，drop to 另一个 module
复制当前屏幕
点击菜单 Edit / Copy 或按键 Copy
与 Trace & Primitive
Log 窗口同步
点击 MSC 视图里的消息，Trace & Primitive Log
窗口对应的 Primitive Log 就会被选中。
点 击 Trace & Primitive Log 窗 口 的 Primitive
Log，MSC 视图里对应的消息就会被选中。
空白
View will be selected.
2.5 Filter Dialog Filter 对话框
The filter dialog, which is composed of two property pages, is used to set
online/offline filters and background color for Trace & Primitive Log Window.
[Online filters]: It means during the connection period in the online mode.
[Offline filters]: It means in the offline mode.
Description
Property page 属性页
Filter 对话框由两个属性页组成，用来设置 online/offline filters 和 Trace &
Primitive Log 窗口的背景色。
空白
Online filters：意思是在 online 模式的连接阶段
空白
Offline filters：意思是在 offline 模式
描述
The first property page is used to set filters for L1
Trace. You can set filter on/off for different trace
classes of each L1 module (class-level).
第一个属性页用来设置 L1 Trace 的 filters。你可以
设 置 为 每 个 L1 module （ class 级 别 ） 的 不 同 的
traceclasses 打开或关闭 filter
The second property page is used to set filters for
Trace & Primitive Log. You can set filter on/off for
different trace classes of each PS module
(class-level); and choose different SAP levels for PS
primitive log (SAP-level).
In other words, the filter of PS primitive is
determined by two conditions: if the SAP level is
greater than 0 and if the source module filter is on.
Furthermore, you can configure the background
colors: [Trace]: It depends on the color of its trace
class.[Primitive Log]: It depends on the color of its
SAP.
第二个属性页是用来为设置 Trace & Primitive Log
的 filter。你可以为每个 PS module（class-level）的
不 同 的 trace classes 打 开 或 关 闭 filter ； 为 PS
Primitive log（SAP 级）选择不同的 SAP 级别。换
句话说，PS primitive 由两个 condition 决定：如果
SAP 级别大于 0，如果源 module filter 是 on。另外，
你可以配置背景色：[Trace]：它取决于 trace class
的颜色。[Primitive Log]：它取决于它的 SAP 的颜
色。
2.6 Engineering Mode Dialog 工程模式对话框
After entering Engineering mode, each protocol module is supposed to report
status and information either periodically or whenever information was changed.
The following property pages will display the information in text or graphic
mode.
Description
The first property page is used to display the
information of serving cell.
Property page
进入工程模式之后，每个协议 module 应该周期性地、或者有信息变化时，
来报告状态和信息。接下来的属性页会以文本或图形模式显示信息。
属性页
描述
第一个属性页用来显示 serving cell 的信息。
The second property page is used to display the
information of serving cell and neighbor cell.
第二个属性页用来显示 serving cell 和邻居 cell 的
信息。
The third property page is used to display the
information of top 10 power level cell.
第三个属性页用来显示 top10 power level cell
The forth property page is used to display the power
level history in recent 10 minutes. When the cell is
changed, it will show a white-circle with new arfcn.
You can click the [Zoom In/Out] button to change
the scale of Y-axis, then use mouse wheel or left
button drag to move the picture. Besides, the
visibility of each curve can be configurable at the
right side on the bottom.
第四个属性页用来显示最近 10 分钟的 power level
历史。当 cell 被改变时，会显示一个带新 arfcn 的
白圈。你可以点击 Zoom In/Out 来改变 Y 轴的刻度
然后使用鼠标滚轮或左键来拖拽图片。另外，每
个弧线的可视度可以在底部右端被配置。
The fifth property page is used to display the other
related information about module MM, CC, SS etc.
第 五 个 属 性 页 是 用 来 显 示 有 关 MM, CC, SS 等
module 的其他相关信息。
2.7 Sim Editor Dialog Sim 编辑器对话框
Sim editor provides two ways to access the files of SIM card. The one on the top
is the general UI, which provides three functions:
空白
Function
Description
Input
1. File information Get file size and number of File id
records.
2. Read
Read the file content from File id, Length and
SIM.
Record
3. Write
Write the file content to SIM. File id, Length, Record
and Data
空白
空白
空白
Otherwise, it also provides the dedicated UI to access the specific files on the
bottom. It supports three functions: 空白
空白
Function
Description
Input
1. Connect
Read out all these files from
SIM.
2. Write
Write the file content to SIM. Data
3. Reset
Reset the file content to 0xff.
Sim 编辑器提供两种访问 SIM 卡文件的方法。在 top 的一种是 general UI，它
提供三种功能。
空白
功能
描述
输入
1. 文件信息
取得文件尺寸和记录个数
文件 id
2. 读取
从 SIM 卡读取文件内容
文件 id，长度和记录
3. 写
把文件内容写入 SIM 卡
文 件 id ， 长 度 ， 记 录
和数据
空白
除此以外，还提供专门的 UI 来访问底部特定的文件。它支持三种功能：空
白
空白
功能
描述
输入
1. 连接
从 SIM 卡内读出所有的文件
2. 写
把文件内容写入 SIM 卡
数据
3. 复位
把文件内容复位至 0xff
空白
此外，两个数据 item 都可以被选择，用 copy/paste 到自身或者到系统剪贴
空白
Furthermore, both of the data item can be selected and use copy/paste to itself or
to system clipboard.
板。
2.8 Exception Window 异常窗口
After connecting with target, if there are valid exception records in NVRAM,
Catcher will receive the notice messages and show them in the Sys Trace
Window. It provides two ways to get the information of exception:
空白
Type
Click
Description
Online
Advance/Ret
It is used to read/reset exception records from
rieve Exception NVRAM. After users click the [Read] button,
Catcher will receive the corresponding Primitive
Log then decode these exception records by
different structures according to its exception
type.
Offline
Advance/Show It is used to decode the raw data into tree
Exception
structures. Users have to select the Primitive Log
(READ_CNF for exception) in the Trace &
Primitive Log Window, and then click this item to
show the exception records in tree format.
连接目标之后，如果 NVRAM 里有有效的异常记录，Catcher 就会收到通知
消息并把它们显示在 Sys Trace 窗口。它提供两种方法来获得异常信息。
空白
空白
类型
点击
描述
Online
高级/检索 用来从 NVRAM 读/复位异常记录。用户点击[Read]
异常
按键以后，Catcher 就会接收相应的 Primitive Log
然后根据异常类型、用不同的结构来编码这些异常
记录。
空白
空白
空白
Offline
高 级 / 显 用来把原始数据编码成树形结构。用户必须在 Trace
& Primitive Log 窗口选择 Primitive Log (异常时的
示异常
READ_CNF)，然后点击此 item 来用树形格式显示
异常记录。
2.9 Statistics Window 统计数据窗口
System statistics is used to analysis the system information for users. Like
exception handling, it also provides two ways to get the information of system
statistics:
空白
Type
Click
Description
Online
Advance/Retrieve It is used to read/reset/clear flag for
Statistics
statistics records in NVRAM. After users
click the [Read] button, Catcher will
receive the corresponding Primitive Log,
and then decode the statistics records by
predefined structures.
Offline
Advance/Show
It is used to decode the raw data into tree
Statistics
structures. Users have to select the
Primitive Log (READ_CNF for system
statistics) in the Trace & Primitive Log
Window, and then click this item to show
the statistics records in tree format.
系统统计数据用来为用户分析系统信息。类似于异常 handling，它也提供两
种方法来取得系统统计数据的信息：
空白
空白
类型
点击
描述
Online
高级/检索统计数据 用来读/复位/清除 flag 为 NVRAM 里
的统计数据记录（。。。？）用户点击
[Read]键之后，Catcher 会接收相应的
Primitive Log，然后用预定义的结构
编码这些统计数据记录。
Offline
高级/显示统计数据
用来把原始数据编码成树形结构。用
户必须从 Trace & Primitive Log 窗口
选择 Primitive Log (系统统计数据时
的 READ_CNF)，然后点击这个 item
来以树形格式显示统计数据记录。
3 Menus 菜单
3.1 File menu 文件菜单
The File menu offers the following commands:
文件菜单提供如下的命令：
Open
Use this command to open a existing log file.
打开
使用此命令打开一个现存的 log 文件。
Close
Use this command to close the active document.
关闭
使用此命令关闭激活的文件
Open Workspace
Use this command to open a existing workspace file.
打开 workspace
使用此命令打开一个现存的 workspace 文件
Save Workspace
Use this command to save the workspace.
保存 Workspace
使用这个命令来保存 workspace
Save Log
Use this command to save the logging messages.
保存 Log
使用此命令来保存 logging 消息。
Save Log As
Use this command to save as the logging messages.
另存 Log 为
使用此命令保存成 logging 消息（。。。？）
Recent Logs
Use this command to open a recent log file.
最近的 Logs
使用此命令来打开一个最近的 log 文件
Recent Workspaces
Use this command to open a recent workspace file.
最近的 Workspaces
使用此命令来打开一个最近的 workspace 文件
Exit
Use this command to quit the application
退出
使用此命令来退出该应用程序
3.2 Edit menu 编辑菜单
The Edit menu offers the following commands:
编辑菜单提供如下命令
Cut
Use this command to cut the selection and move it to the clipboard.
剪切
使用此命令来剪切选中的内容并把它移到剪切板
Copy
Use this command to copy the selection to the clipboard.
复制
使用此命令来复制选中的内容到剪切板
Paste
Use this command to insert clipboard contents at the insertion point.
粘贴
使用此命令在插入点插入剪切板的内容
Find
Use this command to find the specified text.
查找
使用此命令来查找特定的文本
Go To
Use this command to move to the specified position in Primitive Log Window.
转到
使用此命令来移动到 Primitive Log 窗口的特定位置
空白
空白
放大
使用此命令在 MSC 视图窗口中进行放大
Zoom In
Use this command to zoom in the MSC View Window.
Zoom Out
Use this command to zoom out the MSC View Window.
缩小
使用此命令在 MSC 视图窗口中进行缩小
3.3 View menu 视图菜单
The View menu offers the following commands, which enable you to display and
hide the specified window. A check mark appears in front of the menu item when
the window is displayed.
空白
SYS Trace
Use this command to display and hide the Sys Trace Window.
See Sys Trace Window to see the details.
视图菜单提供如下命令，使你能够显示和隐藏特定的窗口。当某窗口被显示
时，一个 check mark 在菜单项前被显示。
空白
空白
SYS Trace
使用此命令来显示和隐藏 Sys Trace 窗口。
查看 Sys Trace 窗口以看到细节。
PS Integrated
Use this command to display and hide the Trace & Primitive Log Window.
See Trace & Primitive Log Window to see the details.
PS 集成
使用此命令来显示和隐藏 Trace & Primitive Log 窗口。
查看 Trace & Primitive Log 窗口以看到细节。
空白
空白
错误消息
使用此命令来显示和隐藏错误消息窗口
查看错误消息窗口以看到细节。
Error Message
Use this command to display and hide the Err Msg Window.
See Err Msg Window to see the details.
Toolbar
Use this command to display and hide the Toolbar, which includes buttons
工具栏
for some of the most common commands in Catcher, such as File Open.
See Toolbar for help on using the toolbar.
Command
Use this command to display and hide the Command Toolbar, which
provides the facility to send proprietary command to modules of protocol
stack.
See Command Toolbar for help on using the command toolbar.
AT Command
Use this command to display and hide the AT Command Toolbar, which
provides the facility to send AT command to modules of protocol stack.
See AT Command Toolbar for help on using the AT command toolbar.
使用此命令以显示和隐藏工具栏，工具栏包括 Catcher 中最常用的一些
命令，比如说打开文件。
查看工具栏以取得使用帮助信息
空白
空白
命令
使用此命令以显示和隐藏命令工具栏，命令工具栏提供一种功能，向
协议栈 module 发送 proprietary 命令。
查看命令工具栏以取得使用帮助信息。
空白
空白
AT 命令
使用此命令来显示和隐藏 AT 命令工具栏，AT 命令工具栏提供一种功
能，向协议栈 modules 发送 AT 命令。
查看 AT 命令工具栏以取得使用帮助信息。
3.4 Control menu 控制菜单
The Control menu offers the following commands:
控制菜单提供如下命令：
Mode
Use this command to enter logging mode.
模式
使用此命令以进入 logging 模式
Connect
Use this command to connect to the target.
连接
使用此命令以连接到 target
Disconnect
Use this command to disconnect from the target.
断开连接
使用此命令以从 target 断开连接
Set Filter
Use this command to change the filter settings and background color for
Trace & Primitive Log Window.
设置 Filter
使用此命令以改变 filter 设置和 Trace & Primitive Log 窗口的背景颜色。
空白
设置缺省 Filter
使用此命令以设置定义在 Catcher.ini 中的缺省 filter
查看 Filter 对话框以取得帮助信息。
Set Default Filter
Use this command to set a default filter defined in Catcher.ini.
See Filter Dialog for help on setting the filter.
3.5 Config menu 配置菜单
The Config menu offers the following commands:
配置菜单提供如下命令：
Set Database Path
Use this command to specify the database path.
设置数据库路径
使用此命令来指定数据库路径
Configure RS232
Use this command to choose COM port and baud rate for RS232
connection.
配置 RS232
使用此命令来选择 RS232 连接的 COM port 和波特率。
空白
空白
外观
使用此命令以设置 Trace & Primitive Log 窗口中每种数据类型的字体大
小和文本颜色
Appearance
Use this command to set the font size and text color of each data type in
Trace & Primitive Log Window.
Option
Use this command to set the number of Trace & Primitive Log Window. If
users select the first style, there will be only one integrated window;
otherwise there may be multiple separate windows to differentiate the Trace
& Primitive Log by its source module.
选项
使用此命令来设置 Trace & Primitive Log 窗口的个数。如果用户选择第
一种风格，则只有一个集成窗口；否则将有若干分开的窗口来分别显
示不同源 module 的 Trace & Primitive Log。
3.6 Advance menu 高级菜单
The Advance menu offers the following commands:
高级菜单提供如下命令：
Show MSC View
Use this command to show the MSC View.
See MSC View Window for help on using the frame window.
显示 MSC 视图（消息序列图）
使用此命令来显示 MSC 视图
查看 MSC 视图窗口以取得帮助信息
Engineering Mode
Use this command to enter Engineering Mode and show the status reported
by PS modules.
See Engineering Mode Dialog for help on using the dialog.
Sim Editor
Use this command to show the Sim Editor Dialog.
See Sim Editor for help on using the dialog.
工程模式
使用此命令以进入工程模式、显示 PS modules 报告的状态
查看工程模式对话框以取得帮助信息。
空白
空白
Sim 编辑器
使用此命令以显示 Sim 编辑器对话框
查看 Sim 编辑器以取得帮助信息
Download Debug Info
Use this command to download target debug information.
This command will save debug information to a file.
下载 Debug 信息
使用此命令来下载 target debug 信息
此命令将把 debug 信息保存到一个文件
Retrieve Exception
Use this command to show the Exception Window and get exception
检索异常
使用此命令以显示异常窗口和在线取得异常记录
records online.
See Exception Window for help on using the frame window.
Retrieve Statistics
Use this command to show the Statistics Window and get system statistics
online.
See Statistics Window for help on using the frame window.
Show Exception
Use this command to show the Exception Window and decode exception
records offline.
Show Statistics
Use this command to show the Statistics Window and decode statistics
records offline.
查看异常窗口以取得帮助信息
空白
空白
检索统计数据
使用此命令以显示统计数据窗口、在线取得系统统计数据
查看系统数据窗口以取得帮助信息
空白
空白
显示异常
使用此命令以显示异常窗口、离线编码异常记录
空白
空白
显示统计数据
使用此命令以显示统计数据窗口、离线编码统计数据记录
3.7 Window menu 窗口菜单
The Window menu offers the following commands, which enable you to arrange
multiple views of multiple documents in the application window:
空白空白
Cascade
Use this command to arrange multiple opened windows in an overlapped fashion.
Tile Horizontally
Use this command to horizontally arrange multiple opened windows in a
non-overlapped fashion.
Tile Vertically
Use this command to vertically arrange multiple opened windows in a
non-overlapped fashion.
1, 2, ... command (Window menu)
Catcher displays a list of currently open document windows at the bottom of the
Window menu. A check mark appears in front of the document name of the
active window. Choose a document from this list to make its window active.
窗口菜单提供如下命令，使你能够在应用窗口安排多文件的多视图：
空白
空白
层叠
使用此命令来把多个打开的窗口安排成重叠的样式
空白
空白
水平平铺
使用此命令来水平地安排不同的打开的窗口，并且不重叠
空白
空白
垂直平铺
使用此命令来垂直地安排不同的打开的窗口，并且不重叠
空白
空白
1, 2, ... 命令 (窗口菜单)
Catcher 在窗口菜单底部显示一个列表，列举目前打开的窗口。激活窗口的
文档名字前面有一个 check mark。在列表中选择一个文档以激活它的窗口。
3.8 Help menu 帮助菜单
Help Topics
Offers you an index to topics on which you can get help.
帮助菜单提供如下命令，帮助你使用该应用程序：
空白
空白
帮助主题
给你提供一个索引，其中有若干帮助主题
About
Displays the version number of this application.
关于
显示该应用程序的版本号
The Help menu offers the following commands, which provide you assistance
with this application:
3.9 Tool Bar 工具栏
The toolbar is displayed across the top of the application window, below the
menu bar. The toolbar provides quick mouse access to many tools used in
Catcher.
To hide or display the Toolbar, choose Toolbar from the View menu.
Click
工具栏显示在 Catcher 窗口的顶部，在菜单栏的下方。工具栏提供了 Catcher
中很多工具的快速鼠标访问。
空白
空白
要想隐藏或显示工具栏，在试图菜单中选择工具栏。
Remove selected data from the document and stores it on the
clipboard.
Copy the selection to the clipboard.
至
打开一个已存的文档。Catcher 显示“打开”对话框，在里面你可
以定位和打开想要的文件。
空白
把当前文档用当前名保存起来。如果你还没有命名这个文档，
那么 Catcher 就会显示“另存为”对话框。
空白
空白
把选中的数据从文档中搬移出来，并存到剪切板上。
Insert the contents of the clipboard at the insertion point.
把所选内容复制到剪切板上。
Enter logging mode.
把剪切板上的内容插入到插入点上。
To
Open an existing document. Catcher displays the Open dialog box,
in which you can locate and open the desired file.
Save the active document with its current name. If you have not
named the document, Catcher displays the Save As dialog box.
点击
Change the filter settings and background color for Trace &
Primitive Log Window.
Choose COM port and baud rate for RS232 connection.
进入 logging 模式。
Connect to target.
选择 RS232 连接的 COM port
Connect and sync with target.
连接到 target
Disconnect from target.
连接并和 target 同步
Set all logging messages be suspended. It means all the filters will
be turned off, so users can’t set filters in this situation. Users have
to click [Resume] button to return to the original state.
Set all filters be the same as original settings before entering the
[Suspend] situation.
Clear all logging messages.
同 target 断开
Enter Engineering Mode and show the status reported by PS
modules.
Show the Sim Editor Dialog.
改变 filter 设置和 Trace & Primitive Log 窗口的背景颜色。
暂停所有的 logging 消息。意思是所有的 filter 会被关闭，那么在
这种情况下用户不能设置 filter。用户必须点击[Resume]按键才
能回到之前的状态。
空白
设置所有的 filter 回到进入暂停之前的状况
清除所有 logging 消息
进入工程模式、显示 PS module 报告的状态
Zoom in the MSC View Window.
显示 Sim 编辑器对话框
Zoom out the MSC View Window.
放大 MSC 视图窗口
缩小 MSC 视图窗口
3.10 Command Tool Bar 命令工具栏
The command toolbar is displayed across the top of the application window,
below the toolbar. It is used to send proprietary command to specific module of
protocol stack with an index value.
To hide or display the command toolbar; choose Command from the View menu.
命令工具栏在 Catcher 窗口的顶部，在工具栏下方。它是用来发送 proprietary
命令到特定的、带有索引值的协议栈 module。
空白
空白
若要隐藏或显示命令工具栏，从视图菜单选择 Command。
3.11 AT Command Tool Bar AT 命令工具栏
The AT command toolbar is displayed across the top of the application window,
below the command toolbar. It is used to send AT command to protocol stack.
To hide or display the AT command toolbar; choose AT Command from the View
menu.
AT 命令工具栏显示在 Catcher 窗口的顶部，在命令工具栏下方。它被用来向
协议栈发送 AT 命令。
空白
空白
想要隐藏或显示 AT 命令工具栏，从视图菜单选择 AT Command。
3.12 Auto-Clear Tool Bar 自动-清除工具栏
The toolbar is used to set the duration for auto clearing. Catcher will clear up all
kinds of logging messages automatically every period.
这个工具栏式用来设置自动清除的持续时间。Catcher 每隔一段时间就会自
动清除掉各种 logging 消息。