Catcher1 Overview...........................................................................................................3

1.1Overview of MTK Catcher MTK Catcher............................................................................................................................................................................31.2 Using Catcher: Logging mode Catcherlogging...........................................................................................................................................................51.3 Using Catcher: Off-line mode CatcherOff-line...........................................................................................................................................................7

2 Frame Window and Dialogs...................................................82.1 Trace & Primitive Log Window Trace & Primitive Log ..........................................................................................................................................................82.2 Sys Trace Window..................................................................................................................................................................................................122.3 Err Msg Window.....................................................................................................................................................................................................142.4 MSC View Window MSC...................................................................................................................................................................162.5 Filter Dialog Filter..............................................................................................................................................................................................................182.6 Engineering Mode Dialog...................................................................................................................................................................................212.7 Sim Editor Dialog Sim............................................................................................................................................................................................242.8 Exception Window ..........................................................................................................................................................................................................262.9 Statistics Window ...................................................................................................................................................................................................28

3 Menus ..............................................................................................................303.1 File menu ........................................................................................................................................................................................................................303.2 Edit menu ........................................................................................................................................................................................................................323.3 View menu......................................................................................................................................................................................................................333.4 Control menu..................................................................................................................................................................................................................353.5 Config menu ...................................................................................................................................................................................................................363.6 Advance menu ................................................................................................................................................................................................................373.7 Window menu .................................................................................................................................................................................................................393.8 Help menu .......................................................................................................................................................................................................................403.9 Tool Bar ...............................................................................................................................................................................................................................413.10 Command Tool Bar ...................................................................................................................................................................................................44

3.11 AT Command Tool Bar AT........................................................................................................................................................................................453.12 Auto-Clear Tool Bar -........................................................................................................................................................................................46

1 Overview

1.1 Overview of MTK Catcher MTK Catcher

Catcher is a PC-side tool for MTK GSM/GPRS Products. The main functionof Catcher is for logging primitives and debug information.The wireless protocol stack is composed of different modules. Each module

uses primitives (messages) to communicate with other modules through SAP(service access point). Catcher can log these primitives by setting the correctfilters. Modules also use trace functions to display the debug information onCatcher.The structures of the primitives are parsed and collected during the

target-build process. An information-database will be generated after the process,so Catcher can use the database to display primitives. Its important for catcher touse the correct database. Using a mismatched database will result in confusionand a wrong logging file.Catcher has two operation modes: logging mode and off-line mode.

Catcher PCMTK GSM/GPRS primitives debug module module

primitivesmessages SAPmodule filtersCatcher primitives logModules trace debug target-buildprimitives

catcher primitives catcher logging

Catcherlogging off-line

For logging mode, Catcher needs the database generated during the

target-build process. After setting the correct database, engineers can connect tothe target and set the filters for the information, which they want to analyze. Allthe setting can be saved in a workspace file. The primitives and debuginformation can be saved to a log-file.Engineers can open the Engineering Dialog to see the data of the mobile

phone. SIM-Editor can be used to retrieve and set the data in the SIM Card.During logging, Catcher also provides a facility to send " Proprietary

command" and "AT command" to modules of protocol stack. Protocol engineersare therefore able to instantly control the states and behaviors of modules ofprotocol stack. Engineers can also retrieve the exception and statisticsinformation of the mobile phone by using the menu commands on Catcher.For off-line mode, engineers can open a log-file and analyzed the log

information. Off-line filters can be set to display the most useful information.Catcher also supports the MSC View of the primitive log.

loggingcatcher target-build

target filtersworkspacePrimitivesdebug log Engineering Dialog

SIM SIM logging catcher

module Proprietary AT moduleCatcher exceptionOff-line log log

Off-line filtersCatcher primitive logMSCView

1.2 Using Catcher: Logging mode Catcherlogging

To enter the logging mode, users can open a pre-saved workspace in themenu [File/Open Workspace] for logging mode, or do the following steps:

1. Start Catcher and set the correct database.On the Config menu, click Set Database Path to open a database, whichmatch the target-load on the mobile phone.

2. Select the Logging mode.

Select the logging icon on the Toolbar or use the menu [Control/Mode].

3. Modify the com port settings.Select the configure RS232 icon on the Toolbar or use the menu[Config/Configure RS232].

4. Connect to the target.

Select the Connect and sync icon on the Toolbar or use the menu[Control/Connect].Make sure the serial line is connected to the target correctly before thisstep.

5. Set the filters.

logging[File/Open Workspace]workspace

1. Catcher Config/Set Database Path target-load

2. logging logging[Control/Mode]

3. com port RS232 [Config/ConfigureRS232]

4. target Connect and sync [Control/Connect] target

Select the Filter icon on the Toolbar use the menu [Control/Set Filter].Be careful not to turn on too many filters that exceed the RS232bandwidth, or data lost will happen. Please refer to the setting of theFilter.

6. Start logging.

The primitives and trace information will be displayed on the Trace &Primitive Log Window.After logging, users may want to save the logged information in themenu [File/Save Log] and save all the workspace settings in [File/SaveWorkspace].

5. filters Filter[Control/Set Filter] filters RS232 Filter

6. loggingPrimitives trace Trace& Primitive Log Logging[File/Save Log] logged[File/Save Workspace]workspace

1.3 Using Catcher: Off-line mode CatcherOff-line

To enter the off-line mode, users can open a pre-saved workspace in themenu [File/Open Workspace] for Off-line mode, or do the following steps:

1. Start Catcher and open a log file (.clg).On the File menu, click Open to open a log file (.clg).

2. Set the off-line filters.Select the Filter icon on the Toolbar or use the menu [Control/SetFilter].Please refer to the setting of the Filter.You can save all the workspace settings in [File/Save Workspace].

off-line[File/Open Workspace]Off-line

1. Catcher log.clg File/Open log.clg

2. off-line filters Filter[Control/Set Filter] Filter [File/Save Workspace]workspace

2 Frame Window and Dialogs

2.1 Trace & Primitive Log Window Trace & Primitive Log

This child frame window, which split into 2 views, is dedicated for Trace &Primitive Log. The top view will display the received Traces and Primitive Logtogether, and only summary information of them are displayed. The summaryinformation includes type, index, frame number, time, source module, destinationmodule, sap/class name, and message ID. In the type column of this top view,different icon is used for identifying the type of logged information.When users select one Trace or Primitive Log in the top view, the

corresponding details will be displayed in the bottom view. In addition, if theselected item is a Primitive Log, it will show the description of each field,including its value and data type. Users can also set the text color of each datatype for the bottom view (See Filter Dialog). Besides, users can set the number ofdisplay columns for both the views by mouse right clicking.There are two different styles for this frame window. The first style shows

all the logged information in an integrated window: all the Traces and Primitive

Trace & Primitive Traces Primitive Logframemodulemodulesap/class type logged Trace Primitive Log

item Primitive Log field Filter Dialog

logged Traces Primitive Log

log are displayed in only one window. The second style shows the loggedinformation in separated windows: each window is dedicated for each module,and only shows the logging messages dumped by itself. (See Config Menu).Users can click the right mouse button to change settings or execute

commands:Upper view

Scroll If the view is scrolled after receiving new Trace or

Primitive Log.Save to Clg The selected messages and those corresponding

messages will be saved to the specific clg file.Save to Text The selected messages will be saved to the specific

text file.Customize It will pop up a dialog to set which column to be

displayed.Lower view

Expand If the tree structures of local parameter/peer bufferare expanded.

Decode Peer If the peer buffer will be decoded by MCD.Save to Text The raw data will be saved to the specific text file by

loggedmodule dump logging Config Menu

Trace Primitive Log

Clg clg

Text text

/peer buffer

Peer peer bufferMCD ?

tree format.Customize It will pop up a dialog to set which column to be

displayed.Customize Expand It will pop up a dialog to set the number of

expanding layers.Column Description

Type Message type (Trace/Primitive Log).Index The message index in this window.Frame # / Time The sending time of this message.Local Time The received time of this message on PC host.Source / Destination Which module sends message to which module.Message / SAP Name Name of message / SAP or trace class.

Trace/Primitive Log # / PC host/ modulemodule/SAP /SAP trace class

2.2 Sys Trace Window

This child frame window is dedicated for system-dumped messages.Users can click the right mouse button to change settings or execute commands:Pop-up Menu Description

Scroll If the view is scrolled after receiving the newSys_Trace messages.

Save Selected to Clg The selected Sys_Trace and those correspondingmessages will be saved to the specific clg file.

Save Selected to text The selected Sys_Trace will be saved to the specifictext file.

Save all to text All the received Sys_Trace will be saved to thespecific text file.

Column Description

Frame # / Time The sending time of this message.Local Time The received time of this message on PC host.Message Message content.

-dump

Sys_Trace

Clg Sys_Trace clg

Sys_Trace

Sys_Trace

# / PC host

2.3 Err Msg Window

This child frame window is dedicated for catcher-dumped error messages.Users can click the right mouse button to change settings or execute commands:Pop-up Menu Description

Scroll If the view is scrolled after receiving the new errormessages.

Save Selected to Clg The selected error messages and those correspondingmessages will be saved to the specific clg file.

Save Selected to text The selected error messages will be saved to a specifictext file.

Save all to text All the received error messages will be saved to thespecific text file.

Column Description

Local Time The received time of this message on PC host.Message Message content.

catcher-dumped

Clg

clg

PC host

2.4 MSC View Window MSC

The MSC View, which is dedicated for Primitive Log displays the message flowin graphic mode. It uses arrows to describe the message directions, and thesending time will also be included . If the message name cant be totally shown,you can move cursor to the position of the message and then a tool tip will bepopped up.Furthermore, it provide the following functionalities for users:Functionalities Description

Zoom In / Out Change the y-axis scale by clicking menu or toolbar.Changemodulesposition

Drag the selected module and drop to anothermodule.

Copy the currentscreen

Click menu [Edit / Copy] or button [Copy].

Sync with Trace &Primitive Log Window

Click the message in MSC View, and then thecorresponding Primitive Log in Trace & PrimitiveLog Window will be selected.

Click the Primitive Log in Trace & Primitive LogWindow, and then corresponding message in MSC

MSC Primitive Log tool tip

ymodule moduledrop tomodule

Edit / Copy Copy

Trace & PrimitiveLog

MSCTrace & Primitive Log Primitive Log

Trace & Primitive Log PrimitiveLogMSC

View will be selected.

2.5 Filter Dialog Filter

The filter dialog, which is composed of two property pages, is used to setonline/offline filters and background color for Trace & Primitive Log Window. [Online filters]: It means during the connection period in the online mode. [Offline filters]: It means in the offline mode.

Filter online/offline filters Trace &Primitive LogOnline filters onlineOffline filters offline

Description Property page

The first property page is used to set filters for L1Trace. You can set filter on/off for different traceclasses of each L1 module (class-level).

L1 Trace filters L1 moduleclass traceclasses filter

The second property page is used to set filters forTrace & Primitive Log. You can set filter on/off fordifferent trace classes of each PS module(class-level); and choose different SAP levels for PSprimitive log (SAP-level).In other words, the filter of PS primitive isdetermined by two conditions: if the SAP level isgreater than 0 and if the source module filter is on.Furthermore, you can configure the backgroundcolors: [Trace]: It depends on the color of its traceclass.[Primitive Log]: It depends on the color of itsSAP.

Trace & Primitive Log filter PS moduleclass-level trace classes filter PSPrimitive logSAP SAPPS primitive conditionSAP 0module filter on[Trace] trace class[Primitive Log] SAP

2.6 Engineering Mode Dialog

After entering Engineering mode, each protocol module is supposed to reportstatus and information either periodically or whenever information was changed.The following property pages will display the information in text or graphicmode.

module

Description Property page The first property page is used to display theinformation of serving cell.

serving cell

The second property page is used to display theinformation of serving cell and neighbor cell.

serving cell cell

The third property page is used to display theinformation of top 10 power level cell.

top10 power level cell

The forth property page is used to display the powerlevel history in recent 10 minutes. When the cell ischanged, it will show a white-circle with new arfcn.You can click the [Zoom In/Out] button to changethe scale of Y-axis, then use mouse wheel or leftbutton drag to move the picture. Besides, thevisibility of each curve can be configurable at theright side on the bottom.

10 power level cell arfcn Zoom In/OutY

The fifth property page is used to display the otherrelated information about module MM, CC, SS etc.

MM, CC, SS module

2.7 Sim Editor Dialog Sim

Sim editor provides two ways to access the files of SIM card. The one on the topis the general UI, which provides three functions:

Function Description Input1. File information Get file size and number of

records.File id

2. Read Read the file content fromSIM.

File id, Length andRecord

3. Write Write the file content to SIM. File id, Length, Recordand Data

Otherwise, it also provides the dedicated UI to access the specific files on thebottom. It supports three functions:

Function Description Input1. Connect Read out all these files from

SIM.2. Write Write the file content to SIM. Data3. Reset Reset the file content to 0xff.

Sim SIM top general UI 1. id

2. SIM id

3. SIM id

UI 1. SIM

2. SIM 3. 0xff item copy/paste

Furthermore, both of the data item can be selected and use copy/paste to itself orto system clipboard.

2.8 Exception Window

After connecting with target, if there are valid exception records in NVRAM,Catcher will receive the notice messages and show them in the Sys TraceWindow. It provides two ways to get the information of exception:

Type Click DescriptionOnline Advance/Ret

rieve ExceptionIt is used to read/reset exception records fromNVRAM. After users click the [Read] button,Catcher will receive the corresponding PrimitiveLog then decode these exception records bydifferent structures according to its exceptiontype.

Offline Advance/ShowException

It is used to decode the raw data into treestructures. Users have to select the Primitive Log(READ_CNF for exception) in the Trace &Primitive Log Window, and then click this item toshow the exception records in tree format.

NVRAMCatcher Sys Trace Online /

NVRAM/[Read]Catcher Primitive Log

Offline /

Trace& Primitive Log Primitive Log (READ_CNF) item

2.9 Statistics Window

System statistics is used to analysis the system information for users. Likeexception handling, it also provides two ways to get the information of systemstatistics:

Type Click DescriptionOnline Advance/Retrieve

StatisticsIt is used to read/reset/clear flag forstatistics records in NVRAM. After usersclick the [Read] button, Catcher willreceive the corresponding Primitive Log,and then decode the statistics records bypredefined structures.

Offline Advance/ShowStatistics

It is used to decode the raw data into treestructures. Users have to select thePrimitive Log (READ_CNF for systemstatistics) in the Trace & Primitive LogWindow, and then click this item to showthe statistics records in tree format.

handling Online / // flag NVRAM

[Read]CatcherPrimitive Log

Offline / Trace & Primitive Log Primitive Log ( READ_CNF) item

3 Menus

3.1 File menu

The File menu offers the following commands:

OpenUse this command to open a existing log file.

CloseUse this command to close the active document.

Open WorkspaceUse this command to open a existing workspace file.

Save WorkspaceUse this command to save the workspace.

Save LogUse this command to save the logging messages.

log

workspaceworkspace

Workspaceworkspace

Log logging

Save Log AsUse this command to save as the logging messages.

Recent LogsUse this command to open a recent log file.

Recent WorkspacesUse this command to open a recent workspace file.

ExitUse this command to quit the application

Log logging

Logs log

Workspacesworkspace

3.2 Edit menu

The Edit menu offers the following commands:

CutUse this command to cut the selection and move it to the clipboard.

CopyUse this command to copy the selection to the clipboard.

PasteUse this command to insert clipboard contents at the insertion point.

FindUse this command to find the specified text.

Go ToUse this command to move to the specified position in Primitive Log Window.

Zoom InUse this command to zoom in the MSC View Window.

Zoom Out

Primitive LogMSC

Use this command to zoom out the MSC View Window. MSC

3.3 View menu

The View menu offers the following commands, which enable you to display andhide the specified window. A check mark appears in front of the menu item whenthe window is displayed.SYS Trace

Use this command to display and hide the Sys Trace Window.See Sys Trace Window to see the details.

PS IntegratedUse this command to display and hide the Trace & Primitive Log Window.See Trace & Primitive Log Window to see the details.

Error MessageUse this command to display and hide the Err Msg Window.See Err Msg Window to see the details.

ToolbarUse this command to display and hide the Toolbar, which includes buttons

check markSYS Trace Sys Trace Sys Trace

PS Trace & Primitive Log Trace & Primitive Log

for some of the most common commands in Catcher, such as File Open.See Toolbar for help on using the toolbar.

Command Use this command to display and hide the Command Toolbar, whichprovides the facility to send proprietary command to modules of protocolstack.See Command Toolbar for help on using the command toolbar.

AT CommandUse this command to display and hide the AT Command Toolbar, whichprovides the facility to send AT command to modules of protocol stack.See AT Command Toolbar for help on using the AT command toolbar.

Catcher

module proprietary

AT ATATmodulesATAT

3.4 Control menu

The Control menu offers the following commands:

ModeUse this command to enter logging mode.

ConnectUse this command to connect to the target.

Disconnect

Use this command to disconnect from the target. Set Filter

Use this command to change the filter settings and background color forTrace & Primitive Log Window.

Set Default FilterUse this command to set a default filter defined in Catcher.ini.See Filter Dialog for help on setting the filter.

logging

target

target

Filter filter Trace & Primitive Log

Filter Catcher.ini filter Filter

3.5 Config menu

The Config menu offers the following commands:

Set Database PathUse this command to specify the database path.

Configure RS232Use this command to choose COM port and baud rate for RS232connection.

Appearance

Use this command to set the font size and text color of each data type inTrace & Primitive Log Window.

OptionUse this command to set the number of Trace & Primitive Log Window. Ifusers select the first style, there will be only one integrated window;otherwise there may be multiple separate windows to differentiate the Trace& Primitive Log by its source module.

RS232 RS232 COM port

Trace & Primitive Log

Trace & Primitive Logmodule Trace & Primitive Log

3.6 Advance menu

The Advance menu offers the following commands:

Show MSC ViewUse this command to show the MSC View.See MSC View Window for help on using the frame window.

Engineering ModeUse this command to enter Engineering Mode and show the status reportedby PS modules.

See Engineering Mode Dialog for help on using the dialog.

Sim EditorUse this command to show the Sim Editor Dialog.See Sim Editor for help on using the dialog.

Download Debug InfoUse this command to download target debug information.This command will save debug information to a file.

Retrieve ExceptionUse this command to show the Exception Window and get exception

MSCMSCMSC

PS modules

Sim Sim Sim

Debug target debug debug

records online.See Exception Window for help on using the frame window.

Retrieve StatisticsUse this command to show the Statistics Window and get system statisticsonline.

See Statistics Window for help on using the frame window.

Show ExceptionUse this command to show the Exception Window and decode exceptionrecords offline.

Show StatisticsUse this command to show the Statistics Window and decode statisticsrecords offline.

3.7 Window menu

The Window menu offers the following commands, which enable you to arrangemultiple views of multiple documents in the application window:CascadeUse this command to arrange multiple opened windows in an overlapped fashion. Tile HorizontallyUse this command to horizontally arrange multiple opened windows in anon-overlapped fashion.

Tile VerticallyUse this command to vertically arrange multiple opened windows in anon-overlapped fashion.

1, 2, ... command (Window menu)Catcher displays a list of currently open document windows at the bottom of theWindow menu. A check mark appears in front of the document name of theactive window. Choose a document from this list to make its window active.

1, 2, ... ()Catcher check mark

3.8 Help menu

The Help menu offers the following commands, which provide you assistancewith this application:

Help TopicsOffers you an index to topics on which you can get help.

About Displays the version number of this application.

3.9 Tool Bar

The toolbar is displayed across the top of the application window, below themenu bar. The toolbar provides quick mouse access to many tools used inCatcher.

To hide or display the Toolbar, choose Toolbar from the View menu.

Click ToOpen an existing document. Catcher displays the Open dialog box,in which you can locate and open the desired file.Save the active document with its current name. If you have notnamed the document, Catcher displays the Save As dialog box.

Remove selected data from the document and stores it on theclipboard.Copy the selection to the clipboard.

Insert the contents of the clipboard at the insertion point.

Enter logging mode.

CatcherCatcher

Catcher Catcher

Change the filter settings and background color for Trace &Primitive Log Window.Choose COM port and baud rate for RS232 connection.

Connect to target.

Connect and sync with target.

Disconnect from target.

Set all logging messages be suspended. It means all the filters willbe turned off, so users cant set filters in this situation. Users haveto click [Resume] button to return to the original state.Set all filters be the same as original settings before entering the[Suspend] situation.Clear all logging messages.

Enter Engineering Mode and show the status reported by PSmodules.Show the Sim Editor Dialog.

Zoom in the MSC View Window.

Zoom out the MSC View Window.

logging

filter Trace & Primitive Log

RS232 COM port

target

target

target

logging filter filter[Resume] filter

logging

PS module

Sim

MSC

MSC

3.10 Command Tool Bar

The command toolbar is displayed across the top of the application window,below the toolbar. It is used to send proprietary command to specific module ofprotocol stack with an index value.

To hide or display the command toolbar; choose Command from the View menu.

Catcher proprietarymodule Command

3.11 AT Command Tool Bar AT

The AT command toolbar is displayed across the top of the application window,below the command toolbar. It is used to send AT command to protocol stack.

To hide or display the AT command toolbar; choose AT Command from the Viewmenu.

AT CatcherATATAT Command

3.12 Auto-Clear Tool Bar -

The toolbar is used to set the duration for auto clearing. Catcher will clear up allkinds of logging messages automatically every period.

Catcher logging

1 Overview1.1 Overview of MTK Catcher MTK Catcher1.2 Using Catcher: Logging modeCatcherlogging1.3 Using Catcher: Off-line modeCatcherOff-line

2 Frame Window and Dialogs2.1 Trace & Primitive Log Window Trace & Primitive Log 2.2 Sys Trace Window2.3 Err Msg Window2.4 MSC View Window MSC2.5 Filter Dialog Filter2.6 Engineering Mode Dialog2.7 Sim Editor Dialog Sim2.8 Exception Window 2.9 Statistics Window

3 Menus 3.1 File menu 3.2 Edit menu 3.3 View menu3.4 Control menu3.5 Config menu 3.6 Advance menu 3.7 Window menu 3.8 Help menu 3.9 Tool Bar 3.10 Command Tool Bar 3.11 AT Command Tool Bar AT3.12 Auto-Clear Tool Bar -