o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
Catcher User
Manual
_
s
n
Vogi
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
Version:
Release date:
1.9
2009-11-2323
Legal Disclaimer
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
BY OPENING OR USING THIS FILE, BUYER HEREBY UNEQUIVOCALLY ACKNOWLEDGES AND AGREES THAT
THE SOFTWARE/FIRMWARE AND ITS DOCUMENTATIONS (MEDIATEK SOFTWARE) RECEIVED FROM
MEDIATEK AND/OR ITS REPRESENTATIVES ARE PROVIDED TO BUYER ON AN AS-IS BASIS ONLY.
MEDIATEK EXPRESSLY DISCLAIMS ANY AND ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT
NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE OR NONINFRINGEMENT. NEITHER DOES MEDIATEK PROVIDE ANY WARRANTY WHATSOEVER
WITH RESPECT TO THE SOFTWARE OF ANY THIRD PARTY WHICH MAY BE USED BY, INCORPORATED IN,
OR SUPPLIED WITH THE MEDIATEK SOFTWARE, AND BUYER AGREES TO LOOK ONLY TO SUCH THIRD
PARTY FOR ANY WARRANTY CLAIM RELATING THERETO. MEDIATEK SHALL ALSO NOT BE RESPONSIBLE
FOR ANY MEDIATEK SOFTWARE RELEASES MADE TO BUYERS SPECIFICATION OR TO CONFORM TO A
PARTICULAR STANDARD OR OPEN FORUM.
BUYER'S SOLE AND EXCLUSIVE REMEDY AND MEDIATEK'S ENTIRE AND CUMULATIVE LIABILITY WITH
RESPECT TO THE MEDIATEK SOFTWARE RELEASED HEREUNDER WILL BE, AT MEDIATEK'S OPTION, TO
REVISE OR REPLACE THE MEDIATEK SOFTWARE AT ISSUE, OR REFUND ANY SOFTWARE LICENSE FEES
OR SERVICE CHARGE PAID BY BUYER TO MEDIATEK FOR SUCH MEDIATEK SOFTWARE AT ISSUE.
THE TRANSACTION CONTEMPLATED HEREUNDER SHALL BE CONSTRUED IN ACCORDANCE WITH THE
LAWS OF THE STATE OF CALIFORNIA, USA, EXCLUDING ITS CONFLICT OF LAWS PRINCIPLES.
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
Revision History
Revision
Date (mm/dd/yyyy)
Author
Comments
0.1
08/12/2003
CH Liang
1. Draft version
0.2
09/02/2003
CH Liang
0.3
10/16/2003
CH Liang
0.4
05/11/2004
CH Liang
0.5
12/16/2004
Naomi Ko
0.6
02/01/2005
KS Hsueh
0.7
06/10/2005
KS Hsueh
0.8
08/15/2005
KS Hsueh
0.9
03/02/2006
Maggie Luo
0.10
03/13/2006
Naomi Ko
1. English review.
0.11
09/26/2006
Naomi Ko
0.12
06/05/2007
Shyla Lan
1.0
07/25/2007
Shyla Lan
1.1
09/12/2007
Shyla Lan
1.2
11/30/2007
Shyla Lan
1.3
03/25/2008
Shyla Lan
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
1.4
05/14/2008
Shyla Lan
1.5
10/14/2008
Shyla Lan
Muyi Chen
1.6
04/17/2009
Shyla Lan
1.7
07/01/2009
Shyla Lan
1.8
08/20/2009
Shyla Lan
1.9
11/23/2009
Shyla Lan
MediaTek Confidential
Page 3 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
Table of Contents
Introduction ......................................................................................................................................................... 7
1.1
1.2
Overview......................................................................................................................................................... 7
Terms and Definitions ..................................................................................................................................... 7
3.1
3.1.1
3.1.2
3.2
3.3
3.4
r
o
f
e
s
a
e
Menu................................................................................................................................................................... 18
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
5.1
File ................................................................................................................................................................ 18
5.1.1
Open/Save workspace ........................................................................................................................... 18
5.1.2
New/Rename/Delete worksheet ............................................................................................................. 18
5.1.3
Save Log ................................................................................................................................................ 18
5.1.4
Save Log As ....................................................................................................................................... 19
5.1.5
Save Log As (Quick) .............................................................................................................................. 19
5.1.6
Save All PS as Text................................................................................................................................ 19
5.2
Edit ............................................................................................................................................................... 19
5.2.1
Cut / Paste ............................................................................................................................................. 19
5.2.2
Copy ....................................................................................................................................................... 19
5.2.3
Find ........................................................................................................................................................ 19
5.2.4
Find by Filter........................................................................................................................................... 19
5.2.5
Go To ..................................................................................................................................................... 20
5.2.6
Backward / Set Anchor / Forward ........................................................................................................... 20
5.2.7
Zoom In / Zoom Out ............................................................................................................................... 20
5.3
View .............................................................................................................................................................. 21
5.3.1
Toolbar ................................................................................................................................................... 21
5.3.2
Replay .................................................................................................................................................... 21
5.3.3
[Option] Compare Structure ................................................................................................................... 21
5.3.4
[Option] Auto Save ................................................................................................................................. 22
2003-2009 - 2010 MediaTek Inc.
Page 4 of 51
MediaTek Confidential
This document contains information that is proprietary to MediaTek Inc.
Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.b
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
5.3.5
[Option] Auto GDI Sanpshot ................................................................................................................... 22
5.3.6
[Option] Auto Retry When Dump Failed ................................................................................................. 22
5.4
Control .......................................................................................................................................................... 22
5.4.1
Connect / Disconnect ............................................................................................................................. 22
5.4.2
Connect (Off-line Parse)......................................................................................................................... 22
5.4.3
Open Dump File ..................................................................................................................................... 22
5.4.4
Open Dump File (Batch)......................................................................................................................... 23
5.4.5
Visible Message Filter ............................................................................................................................ 23
5.4.6
Set Filter ................................................................................................................................................. 23
5.4.7
Set Default Filter..................................................................................................................................... 27
5.4.8
File Transfer ........................................................................................................................................... 28
5.5
Config ........................................................................................................................................................... 29
5.5.1
Set Database Path ................................................................................................................................. 29
5.5.2
Configure RS232 .................................................................................................................................... 29
5.5.3
Appearance ............................................................................................................................................ 30
5.5.4
Option..................................................................................................................................................... 30
5.6
Advance........................................................................................................................................................ 31
5.6.1
MSC View .............................................................................................................................................. 32
5.6.2
Comment Table ...................................................................................................................................... 32
5.6.3
Engineering Mode .................................................................................................................................. 33
5.6.4
SIM Editor .............................................................................................................................................. 34
5.6.5
SIM/USIM Editor..................................................................................................................................... 35
5.6.6
Memory Dump ........................................................................................................................................ 36
5.6.7
Retrieve/Show Exception ....................................................................................................................... 37
5.6.8
Retrieve/Show Statistics......................................................................................................................... 37
5.6.9
Tx Power View ....................................................................................................................................... 38
5.6.10
Sleep Mode View ................................................................................................................................... 39
5.6.11
Register Catcher Handler ....................................................................................................................... 40
5.7
Window ......................................................................................................................................................... 40
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
Toolbars ............................................................................................................................................................. 41
6.1
6.1.1
6.2
6.3
6.4
6.5
7.1
Compare Message Structure ........................................................................................................................ 44
7.1.1
Compare ................................................................................................................................................ 44
7.1.2
Compare All ........................................................................................................................................ 45
7.1.3
Uncheck All Selected ............................................................................................................................. 45
7.2
Launch Catcher from command line ............................................................................................................. 46
7.2.1
Launch Catcher and open a log file ........................................................................................................ 46
7.2.2
Launch Catcher and open a workspace ................................................................................................. 46
7.2.3
Launch Catcher and enter UT mode ...................................................................................................... 46
7.2.4
Launch Catcher and connect to target in logging mode ......................................................................... 46
MediaTek Confidential
Page 5 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
7.2.5
Launch Catcher and batch convert .dmp file .......................................................................................... 46
7.3
Auto-Save for large file ................................................................................................................................. 46
7.4
Virtual Channel ............................................................................................................................................. 47
FAQ .................................................................................................................................................................... 48
8.1
8.2
8.3
8.4
8.5
8.6
8.7
8.8
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
MediaTek Confidential
Page 6 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
1 Introduction
1.1
Overview
Catcher is a PC-side application tool for MTK GSM/GPRS products, used to log primitives and debug information
passed between modules. Various information and statistics are collected to aid lab engineers in analyzing the
behavior of mobile phones.
Figure 1: Main Window.
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
1.2
Expansion/Definition
L1_Trace
MCD
Primitive log
Sys_Trace
Trace
MediaTek Confidential
Page 7 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
This chapter is a starting guide for logging messages with catcher. A database file of the target load and a workspace
file for filter setting are required. The database file is usually named BPLGUInfoCustom_XXX and is located in
mcu\tst\database_classb (mcu\tst\database) or the same directory of the bin file. The workspace file is provided by
MTK, and its file name is *.csw
To start logging, please follow the steps:
1. Open a workspace file.
3. Click the logging mode button, and then configure the RS232 Port.
4. Click the Connect Button.
5. Disable the sleep mode on target by pressing the keypad, and click the filter button on Catcher to set filter.
If all steps are correct, logged messages will be displayed on Primitive Log window.
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
MediaTek Confidential
Page 8 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
3 Window Frames
Catcher is an MDI application tool. Frames within the application window may be shown or hidden, based on the
users current needs. This chapter describes each frame and their usage.
3.1
The Trace and Primitive Log window is a two-part window: the top panel is a log of captured traces and primitives
along with their summary information; the bottom panel displays the corresponding details for the selected trace or
primitive (Figure 2).
The Trace and Primitive Log window is available in two viewing styles. The first style shows all logged information in
an integrated window: all the Traces and Primitive Logs are displayed sequentially in only one window. The second
viewing style dedicates a separate window to each selected source module and only shows trace messages
generated by that module and primitive logs exchanged with that module. The segregated viewing style may be set
via the Config menu: Config Option (refer to Section 5.5.4).
Figure 2: Trace and Primitive Log Window.
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
3.1.1
Top Panel
The top panel contains a log of the received traces and primitive logs. Their summary information is organized into the
following columns:
Page 9 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
The Type column shows a different icon for each message type for easy identification.
Right-clicking the mouse in the top panel offers the following functions (Figure 3):
Scroll: Suspend if the view is scrolling while receiving new traces or primitive logs; resume if scrolling is
suspended. (Effective only in on-line mode.)
Only Save Selected to Clg: Save the selected log messages to a Catcher log (.clg) file.
Save to Clg: Save the selected log messages and any corresponding data (system and error messages) to
a Catcher log (.clg) file.
Only Save Message Info to Text: Only save message information to a text file.
Save to Text: Save the selected log messages (including all details) to a text file.
Only Copy Message Raw Data: Copy message raw data to the system clipboard.
Add/Delete Comment: Add a comment with current log message. The corresponding hot key is Ctrl+F2.
Press Shift + F2 can jump to previous comment; Press F2 can jump to next comment. This feature can also
be used as bookmark.
Modify Comment: Modify the content of an existing comment.
Compare (Araxis Merge): Compare message structures of two primitives. (Refers to Section 7.1 for details.)
Compare All (Araxis Merge): Compare message structures of more than two primitives.
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
MediaTek Confidential
Page 10 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
3.1.2
Lower Panel
When the user selects a trace or primitive in the top panel, the corresponding details are displayed in the bottom panel.
If the selected item is a primitive log, a description of each field is shown, as well as its data structure and value.
Right-clicking the mouse in the lower panel offers the following functions (Figure 3):
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
Expand: Expand the tree structures of the local parameter and peer buffer; collapse if the view is expanded.
Decode Peer as ASCII (Current): Decode the selected peer message as ASCII.
Save to Text: Save the selected log messages (data structure and values only) to a text file.
Set Scrollbar Anchor: Anchor the vertical scrollbar when viewing primitive log details. The lower panel view
will begin at the same scrollbar position when viewing other primitive logs.
Clear Scrollbar Anchor: Remove a previously set scrollbar anchor. (Start the scrollbar at the top.)
3.2
The Sys Trace window is dedicated for system notification messages (Figure 4). These messages include status
updates and notifications as well as system error messages such as assertion failures.
MediaTek Confidential
Page 11 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
Local Time: the receive time of the message on the PC host; and,
The user can click the right mouse button to change settings or execute commands:
Scroll: Suspend if the view is scrolling while receiving new Sys_Trace messages; resume if scrolling is
suspended. (Effective only in on-line mode.)
Only Save Selected to Clg: Save the selected Sys_Trace messages to a Catcher log (.clg) file.
Save to Clg: Save the selected Sys_Trace messages and any corresponding data (log and error messages)
to a Catcher log (.clg) file.
Save to Text: Save the selected Sys_Trace messages to a text file.
Save All to Text: Save all received Sys_Trace messages to a text file.
Add/Delete Comment: Add a comment with current log message. The corresponding hot key is Ctrl+F2.
Press Shift + F2 can jump to previous comment; Press F2 can jump to next comment. This feature can also
be used as bookmark.
Modify Comment: Modify the content of an existing comment.
Figure 4: Sys Trace Window.
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
By default, the Sys Trace window is hidden. The user may open the window via the View menu: View Sys Trace.
3.3
The Error Message window is dedicated for error messages from the Catcher application tool (Figure 5). These error
messages include notifications when Catcher is unable to execute a function or command.
Error message information is organized into the following columns:
Local Time: the receive time of the message on the PC host; and,
The user can click the right mouse button to change settings or execute commands:
2003-2009 - 2010 MediaTek Inc.
MediaTek Confidential
This document contains information that is proprietary to MediaTek Inc.
Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.b
Page 12 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
Scroll: Suspend if the view is scrolling while receiving new error messages; resume if scrolling is suspended.
(Effective only in on-line mode.)
Only Save Selected to Clg: Save the selected error messages to a Catcher log (.clg) file.
Save to Clg: Save the selected error messages and any corresponding data (log and system messages) to
a Catcher log (.clg) file.
Save to Text: Save the selected error messages to a text file.
Save All to Text: Save all received error messages to a text file.
Add/Delete Comment: Add a comment with current log message. The corresponding hot key is Ctrl+F2.
Press Shift + F2 can jump to previous comment; Press F2 can jump to next comment. This feature can also
be used as bookmark.
Modify Comment: Modify the content of an existing comment
Figure 5: Error Message Window.
By default, the Error Message window is hidden. The user may open the window via the View menu: View
Error Message.
3.4
r
o
f
e
s
a
e
The GDI Snapshot Message window displays the target mobile phones GDI information.
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
After connecting to the target mobile phone, the user can request that the target capture a snapshot by pressing the
button
on the toolbar. Catcher receives a GDI Snapshot Message when the target finishes the capture. This
message, of type Snapshot, is displayed in the Primitive Log Message and GDI Snapshot Message windows (Figure
6). From the Primitive Log Message window, the user can find the frame number, system time, local time and capture
status of this snapshot message.
MediaTek Confidential
Page 13 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
Generally, if the capture status is Normal Mode, success, MNT Mode, success! or Assert Mode, success!, the
action has completed successfully. If the capture status is No Space To Save!, clean the target mobile phones file
system and re-press the button
If the capture finishes successfully, Catcher transfers the relevant captured data from the target mobile phone
automatically. This data is displayed in Primitive Log Message window with message type File Block. The user also
can see the download progress on the status bar (Figure 7). Wait until all captured data is downloaded.
Figure 7: Download Progress on Status Bar.
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
To open the GDI Snapshot Message window, select Menu View GDI Snapshot (Figure 8).
The GDI information of one snapshot includes the screen displayed on each display device and the layers of which
that display is composed. The leftmost view is the displayed data of the LCDs, and for each display device, from left to
right are the layers, ordered from bottom to top. Each layer includes the active buffer and the optional second buffer; if
a second buffer does not exist, Catcher displays a dotted frame.
The attributes for each display device and layer are shown, including image dimensions, color format (16-bit, 32-bit),
rotation angle, and offset relative to the upper-left corner of the screen, etc. The user can place the mouse over a pixel
of interest, and a pop-up bubble displays the position and color value of that pixel. When the user selects an area of
the image, the boundaries of the selected area are also displayed in the pop-up bubble.
MediaTek Confidential
Page 14 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
Figure 8: GDI Snapshot Message Window.
Main LCD
Pixel
information
Second buffer
Sub LCD
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
MediaTek Confidential
Page 15 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
4 Operating Modes
The Catcher tool supports four operating modes: off-line, replay, logging, and unit test. The availability of certain
options and functions depends on the current operating mode.
After launching this tool, the user has to choose one mode first, and then other options may be enabled depending on
the selected mode. No matter which mode is selected, the user can change font and colors (refer to Section 5.5.3),
and arrange the frame windows by different ways (refer to Section 5.7). All the 3 frame windows are created, but it
hides Sys Trace and Err Msg frame windows by default. The user can manually change settings to hide/show these
windows (refers to Section 5.3).
Figure 9: Operating Modes.
4.1
Off-line Mode
r
o
f
e
s
a
e
Off-line mode is used when the application is not connected to a target mobile phone or unit test environment. The
user can open previously saved files to view message exchanges. By default, Catcher is launched in off-line mode.
Also, by opening a log file to view (File Open), the user automatically switches Catcher to off-line mode.
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
In off-line mode, the user can set filters for L1_Trace, Trace and Primitive Log. (Refer to Section 5.4.6for details.)
No setup is necessary for off-line mode. The user need simply open log files for viewing.
4.2
Replay Mode
This is off-line mode. It wont connect to target or unit test environment. It supports the functionality to replay a
Catcher log file. Besides, users can save the new logging messages to another Catcher log file as the online mode. If
the log file contains the EM information, it will pop up the EM property pages automatically.
4.3
Logging Mode
When operating in on-line (or logging) mode, the application is connected to a target mobile phone to log message
exchanges. Thus, the user must first set up the environment and the target phone:
1.
2.
Set the path to the database containing Catchers interpreter: Config Set Database Path
Select logging mode via the Control menu: Control Mode Logging (Figure 9).
MediaTek Confidential
Page 16 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
3.
4.
Select the COM port and baud rate for the RS-232 serial connection to the target (refer to Section 5.5.2).
Note that these must match the settings on the target phone.
Establish a connection with the target: Control Connect.
Once a connection is established, the Trace and Primitive Log window automatically starts logging messages. While
connected, the user can set on-line filters for L1_Trace, Trace and Primitive Log. (Refer to Section 5.4.6 for details.)
After disconnecting (Control Disconnect), the user can save the logged messages to a file or utilize the Advance
menu operations (refer to Section 5.6).
4.4
This is on-line mode. It will connect to unit test environment on pc side, so we need to send TCL commands to
protocol stack. Then the user can communicate with unit test environment (Control Connect).
While connected, the user can set on-line filters for L1_Trace and Primitive Log. (Refer to Section 5.4.6 for details).
After disconnecting (Control Disconnect), the user can save the logging messages to a file or utilize the Advance
menu operations (refer to Section 5.6).
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
MediaTek Confidential
Page 17 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
5 Menu
There are 8 submenus: File, Edit, View, Control, Config, Advance, Window, and Help. This section mentions the
supported functionalities as following.
5.1
File
The user can open/save the Trace and Primitive Log from/to catcher log files. Besides, the user can open/save
workspace, which includes mode and all kinds of settings.
Figure 10: Menu [File].
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
5.1.1
Open/Save workspace
A workspace, with file extension .csw, includes all information in a log file, together with other settings such as mode,
font, and color settings. The user can open a workspace via the File menu (File Open Workspace). The log file is
displayed using the workspaces view settings.
5.1.2
New/Rename/Delete worksheet
Catcher supports opening different views in different worksheets. The size and position of all views will be saved in
workspace. The user can add/rename/delete a worksheet via the File menu or right click on the worksheet panel.
Figure 11: Worksheet Panel.
5.1.3
Save Log
Catcher supports saving log into the same file many times. This function is enabled only in online mode.
MediaTek Confidential
Page 18 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
5.1.4
Save Log As
This function is enabled both in online mode and offline mode.
5.1.5
When user select this function, Catcher disconnect first and then save log into specified path with serial number. (The
path can be set via the Config menu: Config Set Default log path for Quick Save).
5.1.6
Save All PS as Text
Save all messages in PS Integrated View into a text file.
5.2
Edit
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
5.2.1
Cut / Paste
These two menu items are disabled.
5.2.2
Copy
This menu item is enabled for MSC view window. The user can copy the message flow of MSC view window into the
system clipboard.
5.2.3
Find
This menu item is enabled for Sys Trace View, PS Integrated View, Error Message View, and PS Trace Peer View.
5.2.4
Find by Filter
This menu item is enabled for Sys Trace View, PS Integrated View, Error Message View, and PS Trace Peer View.
This function is provided mainly for multi-conditional search. The user can specify many conditions and define the
criteria by using & or | to combine those pre-defined conditions.
In PS Integrated View, user can choose to search string or specific element inside specific message (Figure 13). The
user can also use MSGID[x] to search specific byte of raw data. The value could be hexadecimal or decimal.
MediaTek Confidential
Page 19 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
Note: If the path includes union, please set the value of union tag first.
5.2.5
Go To
This menu item is enabled for PS Integrated View. It allows the user to jump to a particular line of the Trace and
Primitive Log window by specifying the message index. This functionality is available in both on-line and off-line
modes.
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
Figure 14: Go To Dialog.
5.2.6
The user can push Set Anchor button to record current view and index, and then push Backward / Forward button
to move to previous / next anchor.
5.2.7
These two menu items are enabled for MSC view window (refer to Section 5.6.1).
MediaTek Confidential
Page 20 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
5.3
View
This menu is used to set the display of frame windows and command toolbars. If the item is checked, the
corresponding window will be shown.
Figure 15: Menu [View].
5.3.1
Toolbar
This menu is used to set the display of command toolbars. (Refer to Section 6 for more details.)
r
o
f
e
s
a
e
5.3.2
Replay
The Replay dialog provides the facility to control the playback of replaying a Catcher log file. The user can press the
two buttons to play/pause and stop replaying, and drag on the timeline slider to seek to another time interactively.
Furthermore, the playback rate is changeable by choosing the speed in combo box.
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
Figure 16: Replay Dialog.
5.3.3
[Option] Compare Structure
This flag is used to set if Catcher provides the function of comparing message structures. (Please refer to Section 7.1
for more details.)
MediaTek Confidential
Page 21 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
5.3.4
[Option] Auto Save
This flag is used to set if Catcher needs to save log file automatically every period of time. After set the flag, Catcher
will ask the user to set file path and time interval. The function is only enable when in CONNECT state of logging
mode.
5.3.5
[Option] Auto GDI Sanpshot
This flag is used to set if Catcher needs to take GDI Sanpshot automatically every period of time. After set the flag,
Catcher will ask the user to set time interval. The function is only enable when in CONNECT state of logging mode.
5.3.6
[Option] Auto Retry When Dump Failed
This flag is used to set if Catcher needs to retry automatically when memory dump failed.
5.4
Control
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
5.4.1
Connect / Disconnect
Except the off-line mode, the user can connect to the target or unit test environment. While connected, the Disconnect
menu will be enabled.
5.4.2
This function is provided in order to solve the problem of lose log due to PC is too busy. The user press Connect (Offline Parse) menu item instead of original Connect menu item. Under this connecting mode, Catcher receives logs and
directly writes into file without parsing, so Catcher does not display any received log. The user can check the target
throughput from the status bar.
Note: Please make sure the filter setting is correct before using this connecting mode. (Refer to Section 5.4.4)
5.4.3
Under off-line Parse connecting mode, when the user click [Disconnect], Catcher save the log as dump file (*.dmp).
The user can open this kind of file via this menu item. The parsing progress information will be shown in the status bar.
Note: Please select the correct database and enter logging mode before open dump file.
MediaTek Confidential
Page 22 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
5.4.4
Open Dump File (Batch)
This function is used to convert several dump file and save as Catcher log file (.clg) automatically.
5.4.5
The user can set visible message filter via this menu item. When in off-line parse connecting mode, the Trace and
Primitive log that meet the criteria will be parsed and displayed on the Catcher views.
5.4.6
Set Filter
Filters allow the user to restrict data messages to only those satisfying certain criteria. The filters may be accessed via
the Control menu: Control Set Filter (Figure 18). The dialog can also be opened by clicking the filter button in the
Catcher Toolbar.
Figure 18: Set Filter.
Depending on the operating mode, filters have a slightly different effect. When in on-line mode, any data messages
that do not meet the criteria are discarded and unrecoverable: these messages cannot be saved.
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
In off-line mode, setting a filter causes the undesired messages to be removed from the view; however their data is
still retained in the saved log and the messages can be restored to view by toggling the appropriate filter.
Both modes support three types of filters: L1 trace filters, Protocol Stack trace filters, and Protocol Stack SAP filters.
L1_Trace and PS trace filters are class-level; primitive log filters are SAP-level.
Furthermore, the users can set the background color for Trace and Primitive Log: Trace messages depend on class
color and Primitive Log messages depend on SAP color.
Note: When operating in on-line mode, the user must press a key (any key) on the handset before clicking the OK
button for new filter settings to take effect.
5.4.6.1
L1 Filters
L1 trace filters (Figure 19) are organized by module, then by class.
To receive messages from a specific module/class:
1.
2.
Select a module to retain its messages; checkboxes will appear in front of its classes for selection.
Click on the checkbox to keep messages for the desired classes in the module.
MediaTek Confidential
Page 23 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
Clicking the right mouse button offers a few shortcuts for select all or none of a modules classes. The dialog box also
provides buttons for setting or clearing all L1 filters with one click, and a button for expanding and collapsing the filter
tree structure.
Figure 19: L1 Trace Filter.
r
o
f
e
s
a
e
5.4.6.2
PS Module/Class Filters
The PS Module/Class filters (Figure 20) extract trace messages generated by the protocol stack. These filters are
organized by module, then by trace class.
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
Select a module to retain its messages; checkboxes will appear in front of its classes for selection.
Click on the checkbox to keep messages for the desired trace classes in the module.
Clicking the right mouse button offers a few shortcuts for select all or none of a modules classes. The user can also
set the background color of each trace class by selecting Set Color from the right-click menu.
The dialog box provides several other buttons for the users convenience:
E/W On (All): Turn on Error and Warning filters for all modules.
E/W On (Mod On): Turn on Error and Warning filters for selected modules only.
MediaTek Confidential
Page 24 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
Figure 20: PS Module/Class Filters.
.
The E/W On (All) and E/W On (Mod On) buttons (Figure 21) are of particular interest since their selection includes
the error and warning traces emitted by the modules. Clicking an E/W On button will not affect the current setting of
other traces.
r
o
f
e
s
a
e
The Apply Default button (Figure 21) provides the function to set filter by applying default filter. (Refer to Section
5.4.7 for more details.)
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
MediaTek Confidential
Page 25 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
Figure 21: Buttons of PS Filter Tab.
5.4.6.3
SAP Filters
Service access point (SAP) filters are applied to primitive logs, and named after the modules between which the
primitive log is passed. All SAPs are listed in the bottom half of the PS Filter tab (Figure 20). The user can set the SAP
filter level by selecting from the drop-down menu or right-clicking the SAP item, and selecting one of the following:
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
Local refers to messages exchanged within the target mobile phone, while peer refers to messages exchanged
with the cellular network, external to the target.
Note that, to see the effect of a SAP filter, a trace filter for the PS module must be enabled in the PS Module/Class
Filters portion and the SAP level must be greater than zero. For example, to see MMI_L4C_SAP primitives, at least
one trace class of the MMI or L4C module must be selected in the PS Module/Class filters, and the MMI_L4C_SAP
filter must be level must be 1, 2, 3 or 4.
The Reset Color toggle button sets all SAP background colors (in the Trace and Primitive Log window) to white;
Restore Color restores the customized background colors. These colors may be set by choosing the Set Color
option of the right-click menu. The color box to the right of the filter trace or class reflects the current color selection.
MediaTek Confidential
Page 26 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
Figure 22: SAP Filters.
5.4.7
Set Default Filter
Catcher tool has predefined default filter lists in Catcher.ini. The user can set a default filter in the list.
r
o
f
e
s
a
e
The Default Filter Dialog (Figure 23) can be accessed via the Control menu: Control Set Default Filter (Figure 24).
The dialog can also be opened by clicking the default filters button in the Catcher Toolbar.
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
The user can import some filter settings via clicking the Import button. The new filter name will also be listed in the
dialog.
Multiple sets of default filters can be selected by holding the CTRL key and selecting the desired filters. For default
settings in each filter group, refer to the Catcher Filter Settings for MMI and Protocol Issues document.
Note that filters that are not included in the selected sets are cleared.
MediaTek Confidential
Page 27 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
Figure 23: Default Filters.
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
5.4.8
File Transfer
Catcher supports the function to transfer files between the target and the PC. The user can set transfer direction and
file path from the dialog. (Figure 25)
MediaTek Confidential
Page 28 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
Figure 25: File Transfer Dialog.
5.5
Config
5.5.1
r
o
f
e
s
a
e
Before selecting the modes, the user must first specify the database path, which is compiled by target.
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
5.5.2
Configure RS232
The user can choose COM port, baud rate and flow control type in the following dialog.
Figure 27: RS232 Configuration.
MediaTek Confidential
Page 29 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
5.5.3
Appearance
The data structure of a message is displayed in the lower panel of the Trace and Primitive Log window (refer to
Section 3.1.2). The color of different data types (integer, enumerated type, array) may be changed in the
Appearance dialog (Figure 28), which can be accessed via the Config menu: Config Appearance. Click directly on
the color box to change the color of a data type; a color palette appears for the user to select a predefined color or
define a custom color.
The typeset of incoming log messages can be changed. The new font will be applied to all window frames, including
displayed information and column headers.
In the Appearance dialog, click on the highlighted word Message in the Font box; a dialog box appears. The
customizable settings are the typeset (Arial, Times New Roman) and the font size. After clicking OK to confirm the
changes, a preview is shown in the highlighted area.
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
5.5.4
Option
To view trace and primitive logs exchanged by a particular module, the user can change the Trace and Primitive Log
window style to display messages by source module, dedicating a separate window to each selected module. This
viewing arrangement may be achieved through the Config menu: Config Option (Figure 29).
MediaTek Confidential
Page 30 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
Figure 29: Option Dialog.
5.6
Advance
Several advanced features are available to the user for analysis. These features are available through the Advance
menu (Figure 30). Clicking on an item from the menu will bring up the appropriate window.
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
Different features are available depending on the mode and connection state of Catcher. The features can be roughly
categorized as follows:
On-line and connected: Engineering Mode, SIM Editor, SIM/USIM Editor, Download Debug Info, Retrieve
Exception, and Retrieve Statistics.
Off-line or disconnected: Show MSC View, Show Exception, and Show Statistics.
MediaTek Confidential
Page 31 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
5.6.1
MSC View
The MSC View is dedicated to Primitive Log and displays the message flow in a graphic mode (Figure 31). Arrows
describe the message direction, and the send time is displayed on the left side. The user can change the order of the
modules (in blue boxes at the top of the MSC window) by dragging and dropping.
Figure 31: MSC View Window.
Modules
Message from
MOD_MPAL to MOD_AS
Send time
r
o
f
e
s
a
e
To obtain a closer view of the MSC, the user can zoom in using the Edit menu: Edit Zoom In. Similarly, the user
can zoom out for a more overall view: Edit Zoom Out.
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
The section of message flow currently viewable in the MSC window may be copied to the system clipboard as an
image. This function is available through the Edit menu (Edit Copy). The copied image may be pasted into any
drawing program (Paint, Photoshop) or into a word processor such as Microsoft Word.
5.6.2
Comment Table
The Comment Table collects all comments in this log file. The information is organized into the following columns:
Local Time: the receive time of the corresponding log on the PC host;
MediaTek Confidential
Page 32 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
Figure 32: Comment Table Window.
All comments are sorted by local time. The user can modify the content of each comment in the lower panel directly.
Right click the mouse button and select Delete can remove the selected comment. Select Export to (Import from)
text file can save (load) all comments and corresponding log into (from) a specific format text file.
5.6.3
Engineering Mode
In Engineering mode, each protocol module reports its status and information either periodically or when information
changes. Status and information are displayed in several Engineering mode views (Figure 33) in a textual or graphical
format.
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
Figure 33: Engineering Mode Menu.
MediaTek Confidential
Page 33 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
Figure 34: Engineering Mode Views.
r
o
f
e
s
a
e
5.6.4
SIM Editor
The SIM Editor window is used to access and alter the files of the target mobile phones SIM card (Figure 35). Its
three main functions, listed in the drop-down menu, are:
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
1.
2.
3.
File information: Retrieve the length of a file and the number of records.
Read: Read a file from the SIM card.
Write: Write a file to the SIM card.
To obtain the length of a file and the number of records, select File information from the drop-down menu, and fill in
the file id, leaving Length and Record fields blank.
This information must be entered while reading from or writing to the SIM file. To read a file, enter the file id, length
and number of records, and click Send. The file contents are displayed in the Data grid. The data may be edited by
clicking the byte. To write the file to the SIM card, enter the file id, length and number of records, and click Send.
The SIM Editor also provides an interface for accessing specific files, listed in the bottom portion of the window. When
the user presses the Connect button, Catcher retrieves the current file contents and displays them on screen. To
modify the file contents, the user can edit the contents on screen, and click the files Write button to submit the
changes. The user can also press Reset to write all one-bits (0xFF bytes) to the SIM file. Some files are listed for
informational purposes only and cannot be modified; thus they do not have Write and Reset buttons.
MediaTek Confidential
Page 34 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
Note: The SIM Editor is only suitable for the loads before 06A. Please use SIM/USIM Editor for other loads.
5.6.5
SIM/USIM Editor
r
o
f
e
s
a
e
The SIM/USIM Editor is similar to SIM Editor. It is used to access and alter the files of the target mobile phones
SIM/USIM card. Its three main functions, listed in the drop-down menu, are:
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
1.
2.
3.
File information: Retrieve the length of a file and the number of records.
Read: Read a file from the SIM/USIM card.
Write: Write a file to the SIM/USIM card.
MediaTek Confidential
Page 35 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
Figure 36: SIM/USIM Editor Dialog.
The User can specify a file in SIM/USIM card depends on which kind of card is inserted in the target. Choose Custom
EF and fill in the file path if the file is not standard.
5.6.6
Memory Dump
Use this command to download debugging information when target asserts a failure. The debugging information is
saved to a file. Here are the typical steps for gathering debug information for MediaTek to do further analysis.
1.
2.
3.
Boot target , enter Engineer Mode setting in idle mode and select Misc., then turn on "Memory Dump"
Reproduce the problematic scenario, there will be a message "ASSERT" or "FATAL ERROR" in SysTrace
view. Wait until the message Caution: To re-dump TST ring buffer! is appeared in SysTrace view.
Open the Memory Dump dialog via the Advance menu: Advance Memory Dump, and press the Start
button.
If Catcher is successful in memory dump, it will pop up a message Finish Memory Dump!!. Provide the
memory dump file, the matched .ELF and .SYM file that built out on the same process with target running
binary to MediaTek.
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
4.
Note: If you skip Step 1, the target will reboot in silence when target asserts, and there will be a warning message
"Target is in normal ..." when "Start" button is pressed on Step 3.
Figure 37: Memory Dump.
MediaTek Confidential
Page 36 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
5.6.7
Retrieve/Show Exception
After connecting with the target, Catcher receives notification of any valid exception records in the NVRAM and shows
them in the Sys Trace window. The user can choose Retrieve Exception (Advance Retrieve Exception) to read or
to reset NVRAM exception records while connected (Figure 38). When the user presses the Read button, Catcher
receives the corresponding primitive log messages and decodes the exception records into their data structures
according to their exception type. Pressing the Reset button deletes all exception records in NVRAM.
Catcher also provides a similar feature off-line. The user clicks on the primitive log message(s) from the Trace and
Primitive Log window, and then selects Show Exception (Advance Show Exception) to show the specific error
data in its tree format.
Figure 38: Exception Handling Window.
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
5.6.8
Retrieve/Show Statistics
The user can use statistics to analyze system information. The statistics are displayed in a System Statistics window
(Figure 39). Like the exception handling feature, in on-line mode, the information is viewed using Retrieve Statistics
(Advance Retrieve Statistics); and in off-line mode, the user selects Show Statistics (Advance Show Statistics).
MediaTek Confidential
Page 37 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
Figure 39: System Statistics Window.
The Read (NVRAM) button asks target to send statistics data saved in NVRAM to PC. The data in NVRAM will be
updated every time when power off the target. The Read (Dynamic) button asks target to send statistics data
recorded from power on this time.
The Clear Flag button clears notification of any unread statistics. No information is lost when the notification flag is
cleared.
5.6.9
Tx Power View
This view shows the Tx Power, Rx Power, TAC information in graphic mode. Users can click the right mouse button to
change settings:
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
Clicking on the mark will show the information of frame, slot, type and value, and user can zoom in / zoom out the
view via the buttons on the toolbar.
MediaTek Confidential
Page 38 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
Figure 40: Tx Power View.
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
MediaTek Confidential
Page 39 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
5.7
Window
The users can arrange the frame windows by 3 ways: cascade, tile horizontally and vertically.
Figure 43: Manu [Window].
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
MediaTek Confidential
Page 40 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
6 Toolbars
The Catcher application contains some toolbars: Catcher, Command, AT Command, and Auto-Clear. Each toolbar
may be converted into a floating toolbar by dragging it away from the top of the Catcher window. The toolbars may be
hidden or restored from the application window via the View menu (Figure 44).
Figure 44: Toolbars.
6.1
Catcher Toolbar
Catcher offers a toolbar with icons to access frequently used functions (Figure 45).
Figure 45: Catcher Toolbar.
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
Referring to Figure 45, from left to right, the toolbar icons and their corresponding functions are:
Open
Save
Save As
Save As (Quick)
Save the active document into specified path with serial number.
Cut
Copy
Paste
Clear
GDI Snapshot
Logging Mode
MediaTek Confidential
Page 41 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
Filter
Default Filter
Configure RS232
Connect
Disconnect
Engineering Mode
SIM Editor
Zoom In
Zoom Out
Backward
Set Anchor
Forward
6.1.1
Clear
6.2
Command Toolbar
The Command Toolbar (Figure 46) allows the user to send a proprietary command to a specific module of the protocol
stack. The module is selected from a drop-down menu. The sent command includes an index and a command string.
The command may only be sent when Catcher is on-line and connected to a target mobile phone. The user can save
commands in a txt file, and then load commands from file. The format of input file is as following:
MOD Index String Name
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
Figure 46: Command Toolbar.
Index
MediaTek Confidential
Page 42 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
6.3
AT Command Toolbar
The AT Command toolbar (Figure 47) allows the user to send AT commands to the protocol stack. The AT command
may only be sent when Catcher is on-line and connected to a target mobile phone. User can save AT commands in a
txt file, one command for each line, and then load AT commands from file. Please refer to the complete AT Command
Set document for command usage.
Figure 47: AT Command Toolbar.
6.4
Auto-Clear Toolbar
The Auto-Clear Toolbar (Figure 48) enables the user to have the Trace and Primitive Log window messages cleared
automatically on a periodic basis. A drop-down menu provides choices in increments of five minutes. The user can
also clear the log on demand by using the Clear button (refer to Section 6.1.1).
Figure 48: Auto-Clear Toolbar.
6.5
Auto-Dump Toolbar
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
The toolbar is used to set the path for memory dump. Catcher will dump memory automatically after system crash.
MediaTek Confidential
Page 43 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
7 Useful Functions
In addition to the menu and toolbar functions mentioned thus far, the user may find other Catcher functions useful.
7.1
Catcher supports the function of comparing message structures. The user has to install Araxis Merge first, and set
check on the sub menu item: View [Option] Compare Structure. Checkboxes will appear in front of primitives.
Right-clicking the mouse in the top panel of the PS Trace View offers three functions about comparing message
structure (Figure 50).
Figure 50: Functions about Comparing Message Structure.
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
7.1.1
Compare
The user has to select two primitives, click the right mouse button, and select the menu item: Compare(Araxis Merge)
(Figure 50), then Araxis Merge will be executed automatically (Figure 51).
MediaTek Confidential
Page 44 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
Figure 51: Araxis Merge.
7.1.2
Compare All
If the user wants to compare more than two primitives at the same time, please set check box of the compared
primitives (Figure 52). Selecting the messages and pressing the SPACE key will change state between
check/uncheck.
Clicking right mouse button and selecting the item menu: Compare All...(Araxis Merge), it will pop up a dialog for
setting base message index. All the selected messages will be compared with the base message.
Figure 52: Compare All.
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
7.1.3
This menu item provides the function to uncheck all selected messages.
MediaTek Confidential
Page 45 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
7.2
Catcher provides the function to open a log file, a workspace file, or enter some operation modes from command line.
7.2.1
After parsing the setting file, Catcher will enter logging mode and connect to target automatically.
Usage : Catcher.exe SettingFile(.ini) (full path)
The format of setting file is as following:
[Catcher]
Database = D:\catcher\Catcher_Log\BPLGUInfoCustomApp_MT6219_EV_MAUI_W07_40
Port = COM3
Baud Rate = 921600
Flow Control = Software
7.2.5
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
Catcher will read the setting in .ini file and convert .dmp files automatically
Usage : Catcher.exe SettingFile(.ini) (full path)
The format of setting file is as following:
[Catcher]
Database = D:\catcher\Catcher_Log\BPLGUInfoCustomApp_MT6219_EV_MAUI_W07_40
Dump File = D:\Catcher_Log\Test_1.dmp D:\Catcher_Log\Test_2.dmp D:\Catcher_Log\Log_for_Test\Test_3.dmp
[Note] If there is space in the file path, please use the following syntax:
Dump File = {file 1} {file 2}
7.3
Due to the limitation of log file size (2G), Catcher will save log when file size exceeds 1.5G then create a new file
automatically both in online and offline logging mode.
MediaTek Confidential
Page 46 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
7.4
Virtual Channel
Catcher is responsible for transmitting and receiving data respectively and that can be seen as a virtual channel.
Applications can inject messages to the target via Catcher and the returned information will be sent back to
applications.
Before using the function, the user should open the channel first, for example, check the Advance menu: Advance
GPS Channel (Switch On/Off). Then specify the port to listen and the applications can connect to Catcher with IP and
port number. The messages between applications and the target are identified with a special Type and Channel ID.
When Catcher receiving messages with the special Type ID from the target, it will pass the messages to the
application according to Channel ID. Catcher also will send messages to the target with special structure and Channel
ID if the application wants to inject messages.
Currently, Catcher supports one virtual channel: GPS Channel.
Tasks
Catcher
Other Apps
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
With special structure and
Channel ID
MediaTek Confidential
Page 47 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
8 FAQ
8.1
If the user wants to log in off-line parse mode, please set database, click the logging mode button, and configure the
RS232 Port first, then press Connect (Off-line Parse) menu item instead of original Connect menu item. (Please refer
to Section 5.4.2 for more details.)
8.2
If Catcher cannot open a previously saved clg file, please check the following items:
Can the provider open the file? If no, please try to log again.
If the provider can open the file, please zip the file before sending for avoiding data lose due to network
transferring, and make sure the file after unzip is complete.
8.3
When target asserts, please follow the steps to take memory dump:
1.
2.
3.
4.
Boot target , enter Engineer Mode setting in idle mode and select Misc., then turn on "Memory Dump"
Reproduce the problematic scenario, there will be a message "ASSERT" or "FATAL ERROR" in SysTrace
view. Wait until the message Caution: To re-dump TST ring buffer! is appeared in SysTrace view.
Open the Memory Dump dialog via the Advance menu: Advance Memory Dump, and press the Start
button.
If Catcher is successful in memory dump, it will pop up a message Finish Memory Dump!!. Provide the
memory dump file, the matched .ELF and .SYM file that built out on the same process with target running
binary to MediaTek.
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
Note: If you skip Step 1, the target will reboot in silence when target asserts, and there will be a warning message
"Target is in normal ..." when "Start" button is pressed on Step 3.
8.4
If Catcher always fails to take memory dump, please check the following items:
If Catcher fails at the querying stage, the most possible cause is hardware issue. Please check the status of
target and cable, and update the driver of cable.
If Catcher fails at the sending stage, please check if the PC is dual core or hyper-threading enabled, if yes,
disable these options or use USB cable to log.
Note: It is caused by Prolific UART cable drivers bug, and will lose data when transferring.
MediaTek Confidential
Page 48 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
8.5
When operating in on-line mode, the user must press a key (any key) on the handset before clicking the OK button for
new filter settings to take effect. If Catcher still fails to set filter, please disable the sleep mode via the target setting,
and check the statue of target and cable.
Note: Before sending any command to target, please make sure the target is not sleeping.
8.6
Why are there many messages Get PS Frame Fail in the trace view?
It is often caused by cable issue, please check the cable status, update driver, and check if the PC is dual core or
hyper-threading enabled, if yes, disable these options or use USB cable to log.
Note: It is caused by Prolific UART cable drivers bug, and will lose data when transferring.
8.7
Why are there many messages Catcher processing buffer full in the PS trace view?
If there are many messages Catcher processing buffer full in the PS trace view, check if the CPU loading is 100%, if
yes:
Reducing the amount of traces by changing filter setting, or logging in off-line parse mode.
If the CPU loading is not very high, please contact with the tool developer.
8.8
Generally, if the capture status is Normal Mode, success, MNT Mode, success! or Assert Mode, success!, the
action has completed successfully. If the capture status is No Space To Save!, clean the target mobile phones file
system and re-press the button
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
MediaTek Confidential
Page 49 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
Index of Figures
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
Page 50 of 51
r
o
f
ease
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
D
e
E
v
(
M
X
C
W
_
s
n
Vogi
r
o
f
e
s
a
e
l
e
R
l
a
i
t
n
e
d
i
f
n
o
C
K
E
)
r
T
o
A
I
d
n
e
v
(
MED
X
C
W
_
s
n
i
Vog
MediaTek Confidential
Page 51 of 51