catcher_user_manual_for_customer_full.pdf

Version: 1.9 Release date: 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.

Catcher User Manual MEDIATE

K Confidential Re

lease for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Legal Disclaimer

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.

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer

MediaTek Confidential 2003-2009 - 2010 MediaTek Inc. Page 3 of 51 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

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

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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



Table of Contents

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

Revision History ........................................................................................................................................................... 3

Table of Contents ......................................................................................................................................................... 4

1 Introduction ......................................................................................................................................................... 7

1.1 Overview ......................................................................................................................................................... 7 1.2 Terms and Definitions ..................................................................................................................................... 7

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

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

3.1 Trace and Primitive Log Window .................................................................................................................... 9 3.1.1 Top Panel ................................................................................................................................................. 9 3.1.2 Lower Panel ........................................................................................................................................... 11

3.2 Sys Trace Window ........................................................................................................................................ 11 3.3 Error Message Window ................................................................................................................................ 12 3.4 GDI Snapshot Message Window .................................................................................................................. 13

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

4.1 Off-line Mode ................................................................................................................................................ 16 4.2 Replay Mode ................................................................................................................................................ 16 4.3 Logging Mode ............................................................................................................................................... 16 4.4 Unit Test Mode ............................................................................................................................................. 17

5 Menu................................................................................................................................................................... 18

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

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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

6 Toolbars ............................................................................................................................................................. 41

6.1 Catcher Toolbar ............................................................................................................................................ 41 6.1.1 Clear ....................................................................................................................................................... 42

6.2 Command Toolbar ........................................................................................................................................ 42 6.3 AT Command Toolbar .................................................................................................................................. 43 6.4 Auto-Clear Toolbar ....................................................................................................................................... 43 6.5 Auto-Dump Toolbar ...................................................................................................................................... 43

7 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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



7.2.5 Launch Catcher and batch convert .dmp file .......................................................................................... 46 7.3 Auto-Save for large file ................................................................................................................................. 46 7.4 Virtual Channel ............................................................................................................................................. 47

8 FAQ .................................................................................................................................................................... 48

8.1 How to log in off-line parse mode? ............................................................................................................... 48 8.2 Why cant Catcher open a clg file saved by others? ..................................................................................... 48 8.3 How to take memory dump? ......................................................................................................................... 48 8.4 Why does Catcher fail to take memory dump? ............................................................................................. 48 8.5 Why does Catcher fail to set filter? ............................................................................................................... 49 8.6 Why are there many messages Get PS Frame Fail in the trace view? ...................................................... 49 8.7 Why are there many messages Catcher processing buffer full in the PS trace view? ................................ 49 8.8 Why is the capture status No Space to Save! in GDI Snapshot view? ....................................................... 49

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

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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.

1.2 Terms and Definitions

In this document, the following terms are used: Abbreviation/Term Expansion/Definition

L1_Trace Text message dumped by the targets Layer 1 program.

MCD MediaTek Coder and Decoder, for decoding peer messages.

Primitive log Log of IPC information exchanged between modules.

Sys_Trace Text messages dumped by the system (may be generated by the application of by the phone).

Trace Text message dumped by target program.

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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.

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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.

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;

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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.

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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):

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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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.


Modify Comment: Modify the content of an existing comment.

Figure 4: Sys Trace Window.

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:

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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.


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

The GDI Snapshot Message window displays the target mobile phones GDI information. 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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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.

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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



Figure 8: GDI Snapshot Message Window.

Sub LCD

Main LCD

Active raw data

Second buffer

Pixel information

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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

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. 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. Set the path to the database containing Catchers interpreter: Config Set Database Path 2. Select logging mode via the Control menu: Control Mode Logging (Figure 9).

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



3. 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.

4. 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).

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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].

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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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].

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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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.

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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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.)

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.

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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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].

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 (Off-line 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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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. 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. Select a module to retain its messages; checkboxes will appear in front of its classes for selection. 2. Click on the checkbox to keep messages for the desired classes in the module.

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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.

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. To receive trace messages from a specific module/class:

1. Select a module to retain its messages; checkboxes will appear in front of its classes for selection. 2. 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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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. 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.)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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);

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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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. 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. 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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



Figure 23: Default Filters.

Figure 24: Set Default Filter.

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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



Figure 25: File Transfer Dialog.

5.5 Config

Figure 26: Menu [Config].

5.5.1 Set Database Path

Before selecting the modes, the user must first specify the database path, which is compiled by target.

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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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.

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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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].

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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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.

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. 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.

Send time

Modules

Message from MOD_MPAL to MOD_AS

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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.

Figure 33: Engineering Mode Menu.

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



Figure 34: Engineering Mode Views.

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:

1. File information: Retrieve the length of a file and the number of records. 2. Read: Read a file from the SIM card. 3. 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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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

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:

1. File information: Retrieve the length of a file and the number of records. 2. Read: Read a file from the SIM/USIM card. 3. Write: Write a file to the SIM/USIM card.

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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. Boot target , enter Engineer Mode setting in idle mode and select Misc., then turn on "Memory Dump" 2. 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. 3. Open the Memory Dump dialog via the Advance menu: Advance Memory Dump, and press the Start

button. 4. 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.

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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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.

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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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:

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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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.

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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].

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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.

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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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

Figure 46: Command Toolbar.

Index

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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

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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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.

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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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.

7.1.3 Uncheck All Selected

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

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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

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 Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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.

Catcher

Tasks

Other Apps

With special Type and Channel ID

With special structure and Channel ID

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

MEDIATEK Confid

ential Release for

Vogins_WCX(vend

or)

Catcher User Manual

Customer



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. Boot target , enter Engineer Mode setting in idle mode and select Misc., then turn on "Memory Dump" 2. Reproduce the problematic s

catcher_user_manual_for_customer_full.pdf

Documents

mediatek andor

mediatek software releases

ch liang

shyla lan

release date

software license fees

additional information

naomi ko