MTKcatcher使用说明中英文版.docx
- 文档编号:30248166
- 上传时间:2023-08-13
- 格式:DOCX
- 页数:34
- 大小:388.93KB
MTKcatcher使用说明中英文版.docx
《MTKcatcher使用说明中英文版.docx》由会员分享,可在线阅读,更多相关《MTKcatcher使用说明中英文版.docx(34页珍藏版)》请在冰豆网上搜索。
MTKcatcher使用说明中英文版
Catcher使用说明
1Overview概述3
1.1OverviewofMTKCatcherMTKCatcher的概述3
1.2UsingCatcher:
Loggingmode使用Catcher:
logging模式5
1.3UsingCatcher:
Off-linemode使用Catcher:
Off-line模式7
2FrameWindowandDialogs框架窗口和对话框8
2.1Trace&PrimitiveLogWindowTrace&PrimitiveLog窗口8
2.2SysTraceWindow系统追踪窗口11
2.3ErrMsgWindow错误消息窗口13
2.4MSCViewWindowMSC(消息序列图)视图窗口15
2.5FilterDialogFilter对话框17
2.6EngineeringModeDialog工程模式对话框19
2.7SimEditorDialogSim编辑器对话框22
2.8ExceptionWindow异常窗口24
2.9StatisticsWindow统计数据窗口26
3Menus菜单28
3.1Filemenu文件菜单28
3.2Editmenu编辑菜单30
3.3Viewmenu视图菜单31
3.4Controlmenu控制菜单33
3.5Configmenu配置菜单34
3.6Advancemenu高级菜单35
3.7Windowmenu窗口菜单37
3.8Helpmenu帮助菜单38
3.9ToolBar工具栏39
3.10CommandToolBar命令工具栏41
3.11ATCommandToolBarAT命令工具栏42
3.12Auto-ClearToolBar自动-清除工具栏43
1Overview概述
1.1OverviewofMTKCatcherMTKCatcher的概述
CatcherisaPC-sidetoolforMTKGSM/GPRSProducts.ThemainfunctionofCatcherisforloggingprimitivesanddebuginformation.
空白
Thewirelessprotocolstackiscomposedofdifferentmodules.Eachmoduleusesprimitives(messages)tocommunicatewithothermodulesthroughSAP(serviceaccesspoint).Catchercanlogtheseprimitivesbysettingthecorrectfilters.ModulesalsousetracefunctionstodisplaythedebuginformationonCatcher.
空白
Thestructuresoftheprimitivesareparsedandcollectedduringthetarget-buildprocess.Aninformation-databasewillbegeneratedaftertheprocess,soCatchercanusethedatabasetodisplayprimitives.It‘simportantforcatchertousethecorrectdatabase.Usingamismatcheddatabasewillresultinconfusionandawrongloggingfile.
空白
Catcherhastwooperationmodes:
loggingmodeandoff-linemode.
空白
Forloggingmode,Catcherneedsthedatabasegeneratedduringthetarget-buildprocess.Aftersettingthecorrectdatabase,engineerscanconnecttothetargetandsetthefiltersfortheinformation,whichtheywanttoanalyze.Allthesettingcanbesavedinaworkspacefile.Theprimitivesanddebuginformationcanbesavedtoalog-file.
空白
EngineerscanopentheEngineeringDialogtoseethedataofthemobilephone.SIM-EditorcanbeusedtoretrieveandsetthedataintheSIMCard.
空白
Duringlogging,Catcheralsoprovidesafacilitytosend"Proprietarycommand"and"ATcommand"tomodulesofprotocolstack.Protocolengineersarethereforeabletoinstantlycontrolthestatesandbehaviorsofmodulesofprotocolstack.EngineerscanalsoretrievetheexceptionandstatisticsinformationofthemobilephonebyusingthemenucommandsonCatcher.
空白
Foroff-linemode,engineerscanopenalog-fileandanalyzedtheloginformation.Off-linefilterscanbesettodisplaythemostusefulinformation.CatcheralsosupportstheMSCViewoftheprimitivelog.
Catcher是一个在PC端的工具,用于MTKGSM/GPRS产品。
它的主要功能是记录primitives和debug信息。
空白空白
无线协议栈是由不同module组成的。
每个module使用primitives(messages)、并通过SAP与其它module进行通信。
如果设置正确的filters,Catcher能把这些primitives都log下来。
Modules还使用trace函数来显示debug信息。
空白
空白
在target-build过程中,primitives的结构被解析并被收集。
过程结束后,会生成一个信息数据库,然后catcher就使用这个数据库来显示primitives。
使用正确的数据库对catcher而言甚为重要。
使用误配的数据库会引起混乱并生成错误的logging文件。
空白
空白空白
Catcher有两种运行模式:
logging(记录)模式和off-line(离线)模式。
空白
logging模式时,catcher需要取得在target-build过程中所生成的数据库。
设置正确的数据库以后,工程师可以连接至target并针对他们想分析的信息设置filters。
所有这些设置可以被保存在一个workspace文件内。
Primitives和debug信息可以被保存至一个log文件。
空白
工程师可以打开EngineeringDialog(工程对话)以查看手机的数据。
可以使用SIM编辑器来检索和设置SIM卡内的数据。
空白
空白
在logging时,catcher也提供一种命令发送功能,即向协议栈的module发送“Proprietary命令”和“AT命令”。
于是协议工程师就能即时控制协议栈module的状态和行为。
工程师还可以使用Catcher提供的菜单命令来检索手机的exception和统计数据信息。
空白
空白
在Off-line模式,工程师可以打开一个log文件、分析log信息。
可以设置Off-linefilters来显示最有用的信息。
Catcher还支持primitivelog的MSCView。
1.2UsingCatcher:
Loggingmode使用Catcher:
logging模式
Toentertheloggingmode,userscanopenapre-savedworkspaceinthemenu[File/OpenWorkspace]forloggingmode,ordothefollowingsteps:
空白
1.StartCatcherandsetthecorrectdatabase.
OntheConfigmenu,clickSetDatabasePathtoopenadatabase,whichmatchthetarget-loadonthemobilephone.
空白
2.SelecttheLoggingmode.
SelecttheloggingiconontheToolbarorusethemenu[Control/Mode].
空白
3.Modifythecomportsettings.
SelecttheconfigureRS232iconontheToolbarorusethemenu[Config/ConfigureRS232].
空白
4.Connecttothetarget.
SelecttheConnectandsynciconontheToolbarorusethemenu[Control/Connect].
Makesuretheseriallineisconnectedtothetargetcorrectlybeforethisstep.
空白
5.Setthefilters.
SelecttheFiltericonontheToolbarusethemenu[Control/SetFilter].
BecarefulnottoturnontoomanyfiltersthatexceedtheRS232bandwidth,ordatalostwillhappen.PleaserefertothesettingoftheFilter.
空白
6.Startlogging.
TheprimitivesandtraceinformationwillbedisplayedontheTrace&PrimitiveLogWindow.
Afterlogging,usersmaywanttosavetheloggedinformationinthemenu[File/SaveLog]andsavealltheworkspacesettingsin[File/SaveWorkspace].
若要进入logging模式,用户可以在菜单[File/OpenWorkspace]中打开一个预存的workspace,或者按照以下步骤做:
空白
1.启动Catcher,设置正确的数据库。
点击菜单Config/SetDatabasePath,打开一个数据库,该数据库与手机上的target-load相匹配。
空白
2.选择logging模式。
选择工具栏上的logging图标,或者点击菜单[Control/Mode]。
空白
3.修改comport设置。
选择工具栏上的RS232图标,或者点击菜单[Config/ConfigureRS232]。
空白
4.连接至target。
选择工具栏上的Connectandsync图标,或者点击菜单[Control/Connect]。
在此步骤之前,请确保串行线路已正确连接至target。
空白
空白
5.设置filters。
选择工具栏上的Filter图标,或者点击菜单[Control/SetFilter]。
小心不要打开太多filters,以免超过RS232的带宽,或导致数据丢失。
请参考Filter的设置。
空白
空白
6.开始logging
Primitives和trace信息会显示在Trace&PrimitiveLog窗口。
Logging之后,用户可以点击菜单[File/SaveLog]来保存logged的信息,或者点击菜单[File/SaveWorkspace]来保存所有workspace设置。
1.3UsingCatcher:
Off-linemode使用Catcher:
Off-line模式
Toentertheoff-linemode,userscanopenapre-savedworkspaceinthemenu[File/OpenWorkspace]forOff-linemode,ordothefollowingsteps:
空白
1.StartCatcherandopenalogfile(.clg).
OntheFilemenu,clickOpentoopenalogfile(.clg).
空白
2.Settheoff-linefilters.
SelecttheFiltericonontheToolbarorusethemenu[Control/SetFilter].
PleaserefertothesettingoftheFilter.
Youcansavealltheworkspacesettingsin[File/SaveWorkspace].
若要进入off-line模式,用户可以点击菜单[File/OpenWorkspace],选择Off-line模式,或者按照以下步骤做:
空白
空白
1.启动Catcher,打开一个log文件(.clg)。
点击菜单File/Open来打开一个log文件(.clg)。
空白
2.设置off-linefilters。
选择工具栏上的Filter图标或者点击菜单[Control/SetFilter]。
请参考Filter的设置。
可以点击菜单[File/SaveWorkspace]来保存所有workspace设置。
2FrameWindowandDialogs框架窗口和对话框
2.1Trace&PrimitiveLogWindowTrace&PrimitiveLog窗口
Thischildframewindow,whichsplitinto2views,isdedicatedforTrace&PrimitiveLog.ThetopviewwilldisplaythereceivedTracesandPrimitiveLogtogether,andonlysummaryinformationofthemaredisplayed.Thesummaryinformationincludestype,index,framenumber,time,sourcemodule,destinationmodule,sap/classname,andmessageID.Inthetypecolumnofthistopview,differenticonisusedforidentifyingthetypeofloggedinformation.
空白
WhenusersselectoneTraceorPrimitiveLoginthetopview,thecorrespondingdetailswillbedisplayedinthebottomview.Inaddition,iftheselecteditemisaPrimitiveLog,itwillshowthedescriptionofeachfield,includingitsvalueanddatatype.Userscanalsosetthetextcolorofeachdatatypeforthebottomview(SeeFilterDialog).Besides,userscansetthenumberofdisplaycolumnsforboththeviewsbymouserightclicking.
空白
Therearetwodifferentstylesforthisframewindow.Thefirststyleshowsalltheloggedinformationinanintegratedwindow:
alltheTracesandPrimitivelogaredisplayedinonlyonewindow.Thesecondstyleshowstheloggedinformationinseparatedwindows:
eachwindowisdedicatedforeachmodule,andonlyshowstheloggingmessagesdumpedbyitself.(SeeConfigMenu).
空白
Userscanclicktherightmousebuttontochangesettingsorexecutecommands:
空白
Upperview
空白
Scroll
IftheviewisscrolledafterreceivingnewTraceorPrimitiveLog.
SavetoClg
Theselectedmessagesandthosecorrespondingmessageswillbesavedtothespecificclgfile.
SavetoText
Theselectedmessageswillbesavedtothespecifictextfile.
Customize
Itwillpopupadialogtosetwhichcolumntobedisplayed.
空白
空白
Lowerview
Expand
Ifthetreestructuresoflocalparameter/peerbufferareexpanded.
DecodePeer
IfthepeerbufferwillbedecodedbyMCD.
SavetoText
Therawdatawillbesavedtothespecifictextfilebytreeformat.
Customize
Itwillpopupadialogtosetwhichcolumntobedisplayed.
CustomizeExpand
Itwillpopupadialogtosetthenumberofexpandinglayers.
空白
空白
空白
ColumnDescription
Type
Messagetype(Trace/PrimitiveLog).
Index
Themessageindexinthiswindow.
Frame#/Time
Thesendingtimeofthismessage.
LocalTime
ThereceivedtimeofthismessageonPChost.
Source/Destination
Whichmodulesendsmessagetowhichmodule.
Message/SAPName
Nameofmessage/SAPortraceclass.
这个子框架窗口专用于Trace&Primitive,外形分裂成两个部分。
上面的部分把Traces和PrimitiveLog显示在一起,但只显示摘要信息。
摘要信息包括类型、索引、frame号、时间、源module、目标module、sap/class名称和消息号。
在type一栏内,不同的图标用来区分logged信息的类型。
空白
空白
空白
当用户在上面的部分视图选择了一个Trace或PrimitiveLog时,对应的细节会在下部视图显示出来。
另外,如果被选的item是一个PrimitiveLog时,视图中会显示每field的描述,包括值和数据类型。
用户也可以在下部视图中设置每种数据类型的文本颜色(见FilterDialog)。
而且,用户可以用鼠标右击设置上下两部分的显示的栏目数目。
空白
空白
这个框架窗口有两种不同的风格。
第一种风格是在一个集成窗口显示所有的logged信息:
所有的Traces和PrimitiveLog在一个窗口里面显示。
第二种风格是在不同的窗口显示logged信息:
每个窗口只显示一种module,而且只显示自己dump的logging消息。
(见ConfigMenu)
空白
空白
用户右键单击来改变设置或者执行命令:
空白
空白
上部分视图
空白
卷动
收到新Trace或PrimitiveLog后,视图是否卷动。
保存到Clg
选中的消息和那些对应的消息会被保存到特定的clg文件。
保存至Text
选中的消息会被保存到特定的text文件。
订制
会弹出一个对话框,可以设置显示哪些栏。
空白
下部分视图
扩展
局部参数/peerbuffer的树形结构是否展开
解码Peer
peerbuffer是否由MCD进行解码
保存至
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- MTKcatcher 使用说明 中英文