Vous êtes sur la page 1sur 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
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

2008 - 2010 MediaTek Inc.


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.
Specifications are subject to change without notice.

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

Catcher User Manual


Customer

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

1. Add note about setting filter

0.3

10/16/2003

CH Liang

1. Add the local time colon for each frame window.


2. Revise the auto clear toolbar.

0.4

05/11/2004

CH Liang

1. Update filter property pages and RS232 dialog.

0.5

12/16/2004

Naomi Ko

1. English review and document restructure.

0.6

02/01/2005

KS Hsueh

1. Add Download Debug Info in Advance menu.

0.7

06/10/2005

KS Hsueh

1. Add Quick Start Guide

0.8

08/15/2005

KS Hsueh

1. Add Section 5.4.7: Default filter dialog

0.9

03/02/2006

Maggie Luo

1. Add Section 3.4: GDI Snapshot Message Window

0.10

03/13/2006

Naomi Ko

1. English review.

0.11

09/26/2006

Naomi Ko

1. Add document reference and additional information to


Section 5.4.7: Default Filters.

0.12

06/05/2007

Shyla Lan

1. Update engineer mode

1.0

07/25/2007

Shyla Lan

1. Add Section 5: Menu and Section 8: FAQ

1.1

09/12/2007

Shyla Lan

1. Add Section 5.2.6: Anchor

1.2

11/30/2007

Shyla Lan

1. Add Section 5.3.4, 5.3.5: Auto-Save and Auto-GDI


Snapshot

1.3

03/25/2008

Shyla Lan

1. Add Section 5.3.6: Auto Retry When Dump Failed


2. Add Section 5.6.9, 5.6.10: Tx Power and Sleep Mode
Views

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. Add Section 5.6.11: Register Catcher Handler


2. Add Section 7.2: Launch Catcher from command line

1.5

10/14/2008

Shyla Lan
Muyi Chen

1. Update Comment Table for Import function

1.6

04/17/2009

Shyla Lan

1. Enhance Section 5.6.11: Register Catcher Handler


2. Enhance Section 7.2: Launch Catcher from command line
3. Add Section 7.3: Auto-Save for large file

1.7

07/01/2009

Shyla Lan

1. Add Section 5.4.8: File Transfer

1.8

08/20/2009

Shyla Lan

1. Add Section 7.4: Virtual Channel

1.9

11/23/2009

Shyla Lan

1. Enhance Section 7.2.5: Launch Catcher and batch


convert .dmp file

MediaTek Confidential

2003-2009 - 2010 MediaTek Inc.

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 3 of 51

Catcher User Manual


Customer

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

Legal Disclaimer ........................................................................................................................................................... 2


Revision History ........................................................................................................................................................... 3
Table of Contents ......................................................................................................................................................... 4
1

Introduction ......................................................................................................................................................... 7

1.1
1.2

Overview......................................................................................................................................................... 7
Terms and Definitions ..................................................................................................................................... 7

Quick Start Guide ................................................................................................................................................ 8

Window Frames .................................................................................................................................................. 9

3.1
3.1.1
3.1.2
3.2
3.3
3.4

Operating Modes ............................................................................................................................................... 16


4.1
4.2
4.3
4.4

Trace and Primitive Log Window .................................................................................................................... 9


Top Panel ................................................................................................................................................. 9
Lower Panel ........................................................................................................................................... 11
Sys Trace Window ........................................................................................................................................ 11
Error Message Window ................................................................................................................................ 12
GDI Snapshot Message Window .................................................................................................................. 13

Off-line Mode ................................................................................................................................................ 16


Replay Mode ................................................................................................................................................ 16
Logging Mode ............................................................................................................................................... 16
Unit Test Mode ............................................................................................................................................. 17

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

Catcher User Manual


Customer

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

Catcher Toolbar ............................................................................................................................................ 41


Clear....................................................................................................................................................... 42
Command Toolbar ........................................................................................................................................ 42
AT Command Toolbar .................................................................................................................................. 43
Auto-Clear Toolbar ....................................................................................................................................... 43
Auto-Dump Toolbar ...................................................................................................................................... 43

Useful Functions ............................................................................................................................................... 44

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

2003-2009 - 2010 MediaTek Inc.

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 5 of 51

Catcher User Manual


Customer

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

How to log in off-line parse mode? ............................................................................................................... 48


Why cant Catcher open a clg file saved by others? ..................................................................................... 48
How to take memory dump? ......................................................................................................................... 48
Why does Catcher fail to take memory dump? ............................................................................................. 48
Why does Catcher fail to set filter? ............................................................................................................... 49
Why are there many messages Get PS Frame Fail in the trace view? ...................................................... 49
Why are there many messages Catcher processing buffer full in the PS trace view? ................................ 49
Why is the capture status No Space to Save! in GDI Snapshot view? ....................................................... 49

Index of Figures .......................................................................................................................................................... 50

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

2003-2009 - 2010 MediaTek Inc.

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 6 of 51

Catcher User Manual


Customer

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

Terms and Definitions

In this document, the following terms are used:


Abbreviation/Term

Expansion/Definition

L1_Trace
MCD
Primitive log
Sys_Trace

Text message dumped by the targets Layer 1 program.


MediaTek Coder and Decoder, for decoding peer messages.
Log of IPC information exchanged between modules.
Text messages dumped by the system (may be generated by the
application of by the phone).
Text message dumped by target program.

Trace
MediaTek Confidential

2003-2009 - 2010 MediaTek Inc.

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 7 of 51

Catcher User Manual


Customer

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

2 Quick Start Guide

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.

2. In menu config, set the database 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

2003-2009 - 2010 MediaTek Inc.

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 8 of 51

Catcher User Manual


Customer

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

Trace and Primitive Log Window

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:

Type: the message type (Trace, Primitive, or Error);


Index: the message index in the window;

Frame #: the frame during which the message was sent;

Time: the time at which the message was sent;

Local Time: the receive time of the message on the PC host;

Source: the module that transmitted the message;


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 9 of 51

Catcher User Manual


Customer

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

Destination: the module receiving the message;

SAP: the SAP class; and,

Message: the name of the message (data structure type).

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.

Customize: Select the set of columns to display.

Only Copy Message Content: Copy MessageID to the system clipboard.

Only Copy Message Raw Data: Copy message raw data to the system clipboard.

Copy Message Structure: Copy message structure to the system clipboard.


Display Unicode String: Use kal_buffer_trace to print Unicode string in the Unicode panel.

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.

Uncheck All Selected: Uncheck all selected messages.

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

2003-2009 - 2010 MediaTek Inc.

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 10 of 51

Catcher User Manual


Customer

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 3: Trace and Primitive Log Window (Right-Click Menus).

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 (Always): Decode the peer message by MCD.


Decode Peer (Current): Decode the selected peer message by MCD.

Decode Peer as ASCII (Always): Decode the peer message as ASCII.

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.

Save in Decimal: Save the primitives to text file in decimal format.

Customize: Select the set of columns to display.


Customize Expand: Set the number of layers to expand.

Display Unicode String: Print Unicode string in the Unicode panel.

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

Sys Trace Window

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

2003-2009 - 2010 MediaTek Inc.

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 11 of 51

Catcher User Manual


Customer

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

System trace information is organized into the following columns:

Frame #: the frame during which the message was sent;


Time: the time at which the message was sent;

Local Time: the receive time of the message on the PC host; and,

Message: the message content.

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

Error Message Window

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,

Message: the message content.

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

Catcher User Manual


Customer

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

GDI Snapshot Message Window

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

2003-2009 - 2010 MediaTek Inc.

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 13 of 51

Catcher User Manual


Customer

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 6: Received Snapshot Message and Captured Data.

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

2003-2009 - 2010 MediaTek Inc.

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 14 of 51

Catcher User Manual


Customer

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.

Active raw data

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

2003-2009 - 2010 MediaTek Inc.

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 15 of 51

Catcher User Manual


Customer

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

2003-2009 - 2010 MediaTek Inc.

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 16 of 51

Catcher User Manual


Customer

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

Unit Test Mode

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

2003-2009 - 2010 MediaTek Inc.

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 17 of 51

Catcher User Manual


Customer

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

2003-2009 - 2010 MediaTek Inc.

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 18 of 51

Catcher User Manual


Customer

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

Save Log As (Quick)

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

Figure 12: Menu [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

2003-2009 - 2010 MediaTek Inc.

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 19 of 51

Catcher User Manual


Customer

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.

Figure 13: Search Specific Element inside Specific Message.

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

Backward / Set Anchor / Forward

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

Zoom In / Zoom Out

These two menu items are enabled for MSC view window (refer to Section 5.6.1).

MediaTek Confidential

2003-2009 - 2010 MediaTek Inc.

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 20 of 51

Catcher User Manual


Customer

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

2003-2009 - 2010 MediaTek Inc.

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 21 of 51

Catcher User Manual


Customer

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

Figure 17: Menu [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

Connect (Off-line Parse)

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

Open Dump File

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

2003-2009 - 2010 MediaTek Inc.

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 22 of 51

Catcher User Manual


Customer

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

Visible Message Filter

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

2003-2009 - 2010 MediaTek Inc.

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 23 of 51

Catcher User Manual


Customer

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

To receive trace 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 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:

All On: Set all PS Module filters.

All Off: Clear all PS Module filters.

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.

Expand/Collapse: Expand or collapse the module and class filter tree.


Apply Default: Set filter by applying default filter.

MediaTek Confidential

2003-2009 - 2010 MediaTek Inc.

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 24 of 51

Catcher User Manual


Customer

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

2003-2009 - 2010 MediaTek Inc.

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 25 of 51

Catcher User Manual


Customer

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:

Level 0: Off (the message is completely discarded);

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

Level 1: Message Header;

Level 2: Message Header + Local Parameters;

Level 3: Message Header + Peer Message; or,

Level 4: Message Header + Local Parameters + Peer Message.

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

2003-2009 - 2010 MediaTek Inc.

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 26 of 51

Catcher User Manual


Customer

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

2003-2009 - 2010 MediaTek Inc.

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 27 of 51

Catcher User Manual


Customer

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.

Figure 24: Set Default Filter.

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

2003-2009 - 2010 MediaTek Inc.

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 28 of 51

Catcher User Manual


Customer

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

Figure 26: Menu [Config].

5.5.1

Set Database Path

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

2003-2009 - 2010 MediaTek Inc.

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 29 of 51

Catcher User Manual


Customer

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.

Figure 28: Appearance Property Page.

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

2003-2009 - 2010 MediaTek Inc.

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 30 of 51

Catcher User Manual


Customer

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.

Figure 30: Menu [Advance].

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

2003-2009 - 2010 MediaTek Inc.

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 31 of 51

Catcher User Manual


Customer

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:

Type: the type of corresponding log (System, Primitive, Error);

Local Time: the receive time of the corresponding log on the PC host;

Index : the index of corresponding log; and,

Message: the comment content.

MediaTek Confidential

2003-2009 - 2010 MediaTek Inc.

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 32 of 51

Catcher User Manual


Customer

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

2003-2009 - 2010 MediaTek Inc.

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 33 of 51

Catcher User Manual


Customer

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

2003-2009 - 2010 MediaTek Inc.

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 34 of 51

Catcher User Manual


Customer

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.

Figure 35: SIM Editor Dialog.

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

2003-2009 - 2010 MediaTek Inc.

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 35 of 51

Catcher User Manual


Customer

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

2003-2009 - 2010 MediaTek Inc.

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 36 of 51

Catcher User Manual


Customer

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

2003-2009 - 2010 MediaTek Inc.

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 37 of 51

Catcher User Manual


Customer

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

Scroll: If the view is scrolled after receiving new messages.


All Slot: Show the message information of all slots.
Slot 0~3: Only show the message information of slot 0~3.

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

2003-2009 - 2010 MediaTek Inc.

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 38 of 51

Catcher User Manual


Customer

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.

5.6.10 Sleep Mode View


This view shows the sleep mode information in table format. User can right click on each table to set if the table is
scrolled after receiving new messages.
Figure 41: Sleep Mode 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

2003-2009 - 2010 MediaTek Inc.

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 39 of 51

Catcher User Manual


Customer

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.11 Register Catcher Handler


Catcher supports the function to register window handler to other applications. For example, if the user inputs
NetSim in the dialog, Catcher will send its handler to NetSim, and NetSim should provide some function to handle
the message. The user also can input Catcher.exe register NetSim when launch Catcher from command line.
To get the window handler from Catcher by your own application, please input the registered window class name of
the application first. Then Catcher will send a WM_COPYDATA message and pass a COPYDATASTRUCT to your
application. In the COPYDATASTRUCT, dwData will be 0, and lpData will be pointer to the window handler of Catcher.

Figure 42: Register Handler Dialog.

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

2003-2009 - 2010 MediaTek Inc.

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 40 of 51

Catcher User Manual


Customer

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

Open a previously saved log file.

Save

Save the active document to a Catcher log (.clg) file.

Save As

Save the active document to another name.

Save As (Quick)

Save the active document into specified path with serial number.

Cut

Cut the message selection to the Clipboard. (Disabled)

Copy

Copy the message selection to the Clipboard. (MSC View only)

Paste

Paste the Clipboard contents. (Disabled)

Clear

Clear the current log buffer. (Refer to Section 6.1.1)

GDI Snapshot

Request the target to capture a snapshot. (Refer to Section 3.4)

Logging Mode

Change to on-line Logging Mode.

Unit Test Mode

Change to Unit Test Mode.

MediaTek Confidential

2003-2009 - 2010 MediaTek Inc.

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 41 of 51

Catcher User Manual


Customer

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

Configure the filters. (Refer to Section 5.4.6)

Default Filter

Configure the filters by applying default filters. (Refer to Section 5.4.7)

Configure RS232

Configure the settings for RS232 (for on-line mode).

Connect

Connect to the target mobile phone (begin logging).

Disconnect

Disconnect from the target mobile phone (stop logging).

Engineering Mode

Open the Engineering Mode dialog. (Refer to Section 5.6.3)

SIM Editor

Open the SIM Editor dialog. (Refer to Section 5.6.4)

Zoom In

Zoom in for a closer view. (MSC View only)

Zoom Out

Zoom out for a farther view. (MSC View only)

Backward

Back to the previous anchor

Set Anchor

Set anchor at current position

Forward

Move to the next anchor

6.1.1

Clear

The Clear button


immediately clears all messages in the Trace and Primitive Log window. The user can also clear
the log periodically by using the Auto-Clear toolbar (refer to Section 6.4).

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

2003-2009 - 2010 MediaTek Inc.

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 42 of 51

Catcher User Manual


Customer

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.

Figure 49: Auto-Dump Toolbar.

MediaTek Confidential

2003-2009 - 2010 MediaTek Inc.

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 43 of 51

Catcher User Manual


Customer

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

Compare Message Structure

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

2003-2009 - 2010 MediaTek Inc.

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 44 of 51

Catcher User Manual


Customer

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

Uncheck All Selected

This menu item provides the function to uncheck all selected messages.

MediaTek Confidential

2003-2009 - 2010 MediaTek Inc.

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 45 of 51

Catcher User Manual


Customer

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

Launch Catcher from command line

Catcher provides the function to open a log file, a workspace file, or enter some operation modes from command line.
7.2.1

Launch Catcher and open a log file

Usage : Catcher.exe ClgFile(.clg)


7.2.2

Launch Catcher and open a workspace

Usage : Catcher.exe WorkspaceFile(.csw)


7.2.3

Launch Catcher and enter UT mode

Usage : Catcher.exe Database


7.2.4

Launch Catcher and connect to target in logging mode

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

Launch Catcher and batch convert .dmp 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

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

Auto-Save for large file

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

2003-2009 - 2010 MediaTek Inc.

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 46 of 51

Catcher User Manual


Customer

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.

With special Type and


Channel ID

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

2003-2009 - 2010 MediaTek Inc.

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 47 of 51

Catcher User Manual


Customer

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

This section lists some frequently asked questions.

8.1

How to log in off-line parse mode?

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

Why cant Catcher open a clg file saved by others?

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

How to take memory dump?

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

Why does Catcher fail to take memory dump?

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

2003-2009 - 2010 MediaTek Inc.

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 48 of 51

Catcher User Manual


Customer

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

Why does Catcher fail to set filter?

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.

Closing unnecessary applications.

If the CPU loading is not very high, please contact with the tool developer.

8.8

Why is the capture status No Space to Save! in GDI Snapshot view?

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

2003-2009 - 2010 MediaTek Inc.

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 49 of 51

Catcher User Manual


Customer

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

Figure 1: Main Window. .................................................................................................................................................. 7


Figure 2: Trace and Primitive Log Window. .................................................................................................................... 9
Figure 3: Trace and Primitive Log Window (Right-Click Menus)................................................................................... 11
Figure 4: Sys Trace Window......................................................................................................................................... 12
Figure 5: Error Message Window. ................................................................................................................................ 13
Figure 6: Received Snapshot Message and Captured Data......................................................................................... 14
Figure 7: Download Progress on Status Bar................................................................................................................. 14
Figure 8: GDI Snapshot Message Window. .................................................................................................................. 15
Figure 9: Operating Modes. .......................................................................................................................................... 16
Figure 10: Menu [File]................................................................................................................................................... 18
Figure 11: Worksheet Panel. ........................................................................................................................................ 18
Figure 12: Menu [Edit]. ................................................................................................................................................. 19
Figure 13: Search Specific Element inside Specific Message. ..................................................................................... 20
Figure 14: Go To Dialog. .............................................................................................................................................. 20
Figure 15: Menu [View]. ................................................................................................................................................ 21
Figure 16: Replay Dialog. ............................................................................................................................................. 21
Figure 17: Menu [Control]. ............................................................................................................................................ 22
Figure 18: Set Filter. ..................................................................................................................................................... 23

r
o
f
e
s
a
e

Figure 19: L1 Trace Filter. ............................................................................................................................................ 24


Figure 20: PS Module/Class Filters. ............................................................................................................................. 25

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 21: Buttons of PS Filter Tab. ............................................................................................................................. 26


Figure 22: SAP Filters. ................................................................................................................................................. 27
Figure 23: Default Filters. ............................................................................................................................................. 28
Figure 24: Set Default Filter. ......................................................................................................................................... 28
Figure 25: File Transfer Dialog. .................................................................................................................................... 29
Figure 26: Menu [Config]. ............................................................................................................................................. 29
Figure 27: RS232 Configuration. .................................................................................................................................. 29
Figure 28: Appearance Property Page. ........................................................................................................................ 30
Figure 29: Option Dialog............................................................................................................................................... 31
Figure 30: Menu [Advance]........................................................................................................................................... 31
Figure 31: MSC View Window. ..................................................................................................................................... 32
Figure 32: Comment Table Window. ............................................................................................................................ 33
Figure 33: Engineering Mode Menu. ............................................................................................................................ 33
Figure 34: Engineering Mode Views. ............................................................................................................................ 34
Figure 35: SIM Editor Dialog......................................................................................................................................... 35
Figure 36: SIM/USIM Editor Dialog............................................................................................................................... 36
MediaTek Confidential

2003-2009 - 2010 MediaTek Inc.

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 50 of 51

Catcher User Manual


Customer

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 37: Memory Dump. ............................................................................................................................................ 36


Figure 38: Exception Handling Window. ....................................................................................................................... 37
Figure 39: System Statistics Window. .......................................................................................................................... 38
Figure 40: Tx Power View............................................................................................................................................. 39
Figure 41: Sleep Mode view. ........................................................................................................................................ 39
Figure 42: Register Handler Dialog. ............................................................................................................................. 40
Figure 43: Manu [Window]. ........................................................................................................................................... 40
Figure 44: Toolbars. ..................................................................................................................................................... 41
Figure 45: Catcher Toolbar. .......................................................................................................................................... 41
Figure 46: Command Toolbar. ...................................................................................................................................... 42
Figure 47: AT Command Toolbar. ................................................................................................................................ 43
Figure 48: Auto-Clear Toolbar. ..................................................................................................................................... 43
Figure 49: Auto-Dump Toolbar. .................................................................................................................................... 43
Figure 50: Functions about Comparing Message Structure. ........................................................................................ 44
Figure 51: Araxis Merge. .............................................................................................................................................. 45
Figure 52: Compare All................................................................................................................................................. 45

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

2003-2009 - 2010 MediaTek Inc.

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 51 of 51