MTK catcher使用说明中英文版.docx

1、MTK catcher使用说明中英文版Catcher使用说明1 Overview概述1.1Overview of MTK Catcher MTK Catcher的概述Catcher is a PC-side tool for MTK GSM/GPRS Products. The main function of Catcher is for logging primitives and debug information.空白The wireless protocol stack is composed of different modules. Each module uses primit

2、ives (messages) to communicate with other modules through SAP (service access point). Catcher can log these primitives by setting the correct filters. Modules also use trace functions to display the debug information on Catcher.空白The structures of the primitives are parsed and collected during the t

3、arget-build process. An information-database will be generated after the process, so Catcher can use the database to display primitives. Its important for catcher to use the correct database. Using a mismatched database will result in confusion and a wrong logging file.空白Catcher has two operation mo

4、des: logging mode and off-line mode.空白For logging mode, Catcher needs the database generated during the target-build process. After setting the correct database, engineers can connect to the target and set the filters for the information, which they want to analyze. All the setting can be saved in a

5、 workspace file. The primitives and debug information can be saved to a log-file.空白Engineers can open the Engineering Dialog to see the data of the mobile phone. SIM-Editor can be used to retrieve and set the data in the SIM Card.空白During logging, Catcher also provides a facility to send Proprietary

6、 command and AT command to modules of protocol stack. Protocol engineers are therefore able to instantly control the states and behaviors of modules of protocol stack. Engineers can also retrieve the exception and statistics information of the mobile phone by using the menu commands on Catcher.空白For

7、 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.Catcher是一个在PC端的工具，用于MTK GSM/GPRS产品。它的主要功能是记录primitives和debug信息。空白空白无线协议栈是由不同module组成的。每个module使用

8、primitives（messages）、并通过SAP与其它module进行通信。如果设置正确的filters，Catcher能把这些primitives都log下来。Modules还使用trace函数来显示debug信息。空白空白在target-build过程中，primitives的结构被解析并被收集。过程结束后，会生成一个信息数据库，然后catcher就使用这个数据库来显示primitives。使用正确的数据库对catcher而言甚为重要。使用误配的数据库会引起混乱并生成错误的logging文件。空白空白空白Catcher有两种运行模式：logging（记录）模式和off-line（离线

9、）模式。空白logging模式时，catcher需要取得在target-build过程中所生成的数据库。设置正确的数据库以后，工程师可以连接至target并针对他们想分析的信息设置filters。所有这些设置可以被保存在一个workspace文件内。Primitives和debug信息可以被保存至一个log文件。空白工程师可以打开Engineering Dialog（工程对话）以查看手机的数据。可以使用SIM编辑器来检索和设置SIM卡内的数据。空白空白在logging时，catcher也提供一种命令发送功能，即向协议栈的module发送“Proprietary命令”和“AT命令”。于是协议工程

10、师就能即时控制协议栈module的状态和行为。工程师还可以使用Catcher提供的菜单命令来检索手机的exception和统计数据信息。空白空白在Off-line模式，工程师可以打开一个log文件、分析log信息。可以设置Off-line filters来显示最有用的信息。Catcher还支持primitive log的MSC View。1.2 Using Catcher: Logging mode使用Catcher：logging模式To enter the logging mode, users can open a pre-saved workspace in the menu File

11、/Open Workspace for logging mode, or do the following steps:空白1. Start Catcher and set the correct database.On the Config menu, click Set Database Path to open a database, which match the target-load on the mobile phone.空白2. Select the Logging mode.Select the logging icon on the Toolbar or use the m

12、enu 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 cor

13、rectly before this step.空白5. Set the filters.Select the Filter icon on the Toolbar use the menu Control/Set Filter.Be careful not to turn on too many filters that exceed the RS232 bandwidth, or data lost will happen. Please refer to the setting of the Filter.空白6. Start logging.The primitives and tra

14、ce information will be displayed on the Trace & Primitive Log Window.After logging, users may want to save the logged information in the menu File/Save Log and save all the workspace settings in File/Save Workspace.若要进入logging模式，用户可以在菜单File/Open Workspace中打开一个预存的workspace，或者按照以下步骤做：空白1. 启动Catcher，设置

15、正确的数据库。点击菜单Config/Set Database Path，打开一个数据库，该数据库与手机上的target-load相匹配。空白2. 选择logging模式。选择工具栏上的logging图标，或者点击菜单Control/Mode。空白3. 修改com port设置。选择工具栏上的RS232图标，或者点击菜单Config/Configure RS232。空白4. 连接至target。选择工具栏上的Connect and sync图标，或者点击菜单Control/Connect。在此步骤之前，请确保串行线路已正确连接至target。空白空白5. 设置filters。选择工具栏上的Fil

16、ter图标，或者点击菜单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使用Catcher：Off-line模式To enter the off-lin

17、e mode, users can open a pre-saved workspace in the menu File/Open Workspace for Off-line mode, or do the following steps:空白1. Start Catcher and open a log file (.clg).On the File menu, click Open to open a log file (.clg).空白2. Set the off-line filters.Select the Filter icon on the Toolbar or use th

18、e menu Control/Set Filter.Please refer to the setting of the Filter.You can save all the workspace settings in File/Save Workspace.若要进入off-line模式，用户可以点击菜单File/Open Workspace，选择Off-line模式，或者按照以下步骤做：空白空白1. 启动Catcher，打开一个log文件（.clg）。点击菜单File/Open来打开一个log文件（.clg）。空白2. 设置off-line filters。选择工具栏上的Filter图标或

19、者点击菜单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

20、Traces and Primitive Log together, and only summary information of them are displayed. The summary information includes type, index, frame number, time, source module, destination module, sap/class name, and message ID. In the type column of this top view, different icon is used for identifying the

21、type of logged information.空白When users select one Trace or Primitive Log in the top view, the corresponding details will be displayed in the bottom view. In addition, if the selected item is a Primitive Log, it will show the description of each field, including its value and data type. Users can al

22、so set the text color of each data type for the bottom view (See Filter Dialog). Besides, users can set the number of display columns for both the views by mouse right clicking.空白There are two different styles for this frame window. The first style shows all the logged information in an integrated w

23、indow: all the Traces and Primitive log are displayed in only one window. The second style shows the logged information in separated windows: each window is dedicated for each module, and only shows the logging messages dumped by itself. (See Config Menu).空白Users can click the right mouse button to

24、change settings or execute commands:空白Upper view空白ScrollIf the view is scrolled after receiving new Trace or Primitive Log.Save to ClgThe selected messages and those corresponding messages will be saved to the specific clg file.Save to TextThe selected messages will be saved to the specific text fil

25、e.CustomizeIt will pop up a dialog to set which column to be displayed.空白空白Lower viewExpandIf the tree structures of local parameter/peer buffer are expanded.Decode PeerIf the peer buffer will be decoded by MCD.Save to TextThe raw data will be saved to the specific text file by tree format.Customize

26、It will pop up a dialog to set which column to be displayed.Customize ExpandIt will pop up a dialog to set the number of expanding layers.空白空白空白Column DescriptionType Message type (Trace/Primitive Log).IndexThe message index in this window.Frame # / TimeThe sending time of this message.Local TimeThe

27、 received time of this message on PC host.Source / DestinationWhich module sends message to which module.Message / SAP NameName of message / SAP or trace class.这个子框架窗口专用于Trace & Primitive，外形分裂成两个部分。上面的部分把Traces和 Primitive Log显示在一起，但只显示摘要信息。摘要信息包括类型、索引、frame号、时间、源module、目标module、sap/class名称和消息号。在type

28、一栏内，不同的图标用来区分logged信息的类型。空白空白空白当用户在上面的部分视图选择了一个Trace或Primitive Log时，对应的细节会在下部视图显示出来。另外，如果被选的item是一个Primitive Log时，视图中会显示每field的描述，包括值和数据类型。用户也可以在下部视图中设置每种数据类型的文本颜色（见Filter Dialog）。而且，用户可以用鼠标右击设置上下两部分的显示的栏目数目。空白空白这个框架窗口有两种不同的风格。第一种风格是在一个集成窗口显示所有的logged信息：所有的Traces和Primitive Log在一个窗口里面显示。第二种风格是在不同的窗口显

29、示logged信息：每个窗口只显示一种module，而且只显示自己dump的logging消息。（见Config Menu）空白空白用户右键单击来改变设置或者执行命令：空白空白上部分视图空白卷动收到新Trace或Primitive Log后，视图是否卷动。保存到Clg选中的消息和那些对应的消息会被保存到特定的clg文件。保存至Text选中的消息会被保存到特定的text文件。订制会弹出一个对话框，可以设置显示哪些栏。空白下部分视图扩展局部参数/peer buffer的树形结构是否展开解码Peerpeer buffer是否由MCD进行解码保存至文本原始数据是否按树格式（?）保存至特定文本文档订制会

30、弹出一个对话来设置哪一栏被显示订制扩展会弹出一个对话来设置扩展层的数目空空白白 空白栏描述类型消息类型（Trace/Primitive Log）索引消息索引在这个窗口框 # / 时间此消息的发送时间本地时间PC host上收到此消息的时间源/目的地哪个module发送消息至哪个module消息/SAP名消息/SAP的名称或trace class2.2 Sys Trace Window系统追踪窗口This child frame window is dedicated for system-dumped messages.Users can click the right mouse butto

31、n to change settings or execute commands:空白Pop-up Menu DescriptionScrollIf the view is scrolled after receiving the new Sys_Trace messages.Save Selected to ClgThe selected Sys_Trace and those corresponding messages will be saved to the specific clg file.Save Selected to textThe selected Sys_Trace will be saved to the specific text file.Save all to textAll the received Sys_Trace will be saved to the specific text file.空白Column DescriptionFrame # / Time