Catcher使用说明
1Overview 3/概述
1.1OverviewofMTKCatcher 3/MTKCatcher的概述
1.2UsingCatcher:Loggingmode 5/使用Catcher：logging模式
1.3UsingCatcher:Off-linemode 7/使用Catcher：Off-line模式
2FrameWindowandDialogs 8/框架窗口和对话框
2.1Trace&PrimitiveLogWindow 8/Trace&PrimitiveLog窗口
2.2SysTraceWindow 11/系统追踪窗口
2.3ErrMsgWindow 13/错误消息窗口
2.4MSCViewWindow 15/MSC（消息序列图）视图窗口
2.5FilterDialog 17/Filter对话框
2.6EngineeringModeDialog 19/工程模式对话框
2.7SimEditorDialog 22/Sim编辑器对话框
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.11ATCommandToolBar 42/AT命令工具栏
3.12Auto-ClearToolBar 43/自动-清除工具栏
1Overview概述
OverviewofMTKCatcherMTKCatcher的概述
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进行解码
保存至文本
原始数据是否按树格式（?）保存至特定文本文档
订制
会弹出一个对话来设置哪一栏被显示
订制扩展
会弹出一个对话来设置扩展层的数目
空空白白
空白
栏描述
类型
消息类型（Trace/PrimitiveLog）
索引
消息索引在这个窗口
框#/时间
此消息的发送时间
本地时间
PChost上收到此消息的时间
源/目的地
哪个module发送消息至哪个module
消息/SAP名
消息/SAP的名称或traceclass
2.2SysTraceWindow系统追踪窗口
Thischildframewindowisdedicatedforsystem-dumpedmessages.
Userscanclicktherightmousebuttontochangesettingsorexecutecommands:
空白
Pop-upMenuDescription
Scroll
IftheviewisscrolledafterreceivingthenewSys_Tracemessages.
SaveSelectedtoClg
TheselectedSys_Traceandthosecorrespondingmessageswillbesavedtothespecificclgfile.
SaveSelectedtotext
TheselectedSys_Tracewillbesavedtothespecifictextfile.
Savealltotext
AllthereceivedSys_Tracewillbesavedtothespecifictextfile.
空白
ColumnDescription
Frame#/Time
Thesendingtimeofthismessage.
LocalTime
ThereceivedtimeofthismessageonPChost.
Message
Messagecontent.
这个子框架窗口专为系统-dump的消息。
用户可以点击鼠标右键来改变设置或执行命令。
空白
空白
弹出菜单描述
卷动
收到新Sys_Trace消息后视图是否卷动
保存选中的内容至Clg
选中的Sys_Trace和那些相应的消息是否被保存到特定的clg文件
保存选中的内容至文本
选中的Sys_Trace会被保存到特定的文本文件
保存所有内容至文本
所有被选中的Sys_Trace都会被保存至特定的文本文档
空白
空白
栏描述
框#/时间
此消息的发送时间
本地时间
PChost上此消息的接收时间
消息
消息内容
2.3ErrMsgWindow错误消息窗口
Thischildframewindowisdedicatedforcatcher-dumpederrormessages.
Userscanclicktherightmousebuttontochangesettingsorexecutecommands:
空白
Pop-upMenuDescription
Scroll
Iftheviewisscrolledafterreceivingthenewerrormessages.
SaveSelectedtoClg
Theselectederrormessagesandthosecorrespondingmessageswillbesavedtothespecificclgfile.
SaveSelectedtotext
Theselectederrormessageswillbesavedtoaspecifictextfile.
Savealltotext
Allthereceivederrormessageswillbesavedtothespecifictextfile.
空白
ColumnDescription
LocalTime
ThereceivedtimeofthismessageonPChost.
Message
Messagecontent.
这个子框窗口专为catcher-dumped错误消息。
用户可以点击鼠标右键来改变设置或者执行命令。
空白
空白
空白
弹出菜单描述
卷动
收到新的错误信息后视图是否卷动
保存选中的内容至Clg
选中的错误消息和那些相应的消息会被保存至特定的clg文件
保存选中的内容至文本
选中的错误消息会被保存至特定的文本文档。
保存所有内容至文本
所有收到的错误消息会被保存至特定的文本文档。
空白
空白
栏描述
本地时间
PChost上收到此消息的时间
消息
消息内容
2.4MSCViewWindowMSC（消息序列图）视图窗口
TheMSCView,whichisdedicatedforPrimitiveLogdisplaysthemessageflowingraphicmode.Itusesarrowstodescribethemessagedirections,andthesendingtimewillalsobeincluded.Ifthemessagenamecan’tbetotallyshown,youcanmovecursortothepositionofthemessageandthenatooltipwillbepoppedup.
空白
Furthermore,itprovidethefollowingfunctionalitiesforusers:
空白
Functionalities Description
ZoomIn/Out
Changethey-axisscalebyclickingmenuortoolbar.
Changemodules’position
Dragtheselectedmoduleanddroptoanothermodule.
Copythecurrentscreen
Clickmenu[Edit/Copy]orbutton[Copy].
SyncwithTrace&PrimitiveLogWindow
ClickthemessageinMSCView,andthenthecorrespondingPrimitiveLoginTrace&PrimitiveLogWindowwillbeselected.
ClickthePrimitiveLoginTrace&PrimitiveLogWindow,andthencorrespondingmessageinMSCViewwillbeselected.
MSC视图，专为PrimitiveLog，它以图形模式显示消息流。它使用箭头来描述消息方向，还有发送时间。如果消息名称不能完全显示，你可以移动游标到消息的位置，然后一个tooltip会被弹出。
空白
空白
另外，还为用户提供以下功能：
空白
功能描述
放大缩小
点击菜单或工具栏以改变y轴的刻度
改变module的位置
拖拽选中的module，dropto另一个module
复制当前屏幕
点击菜单Edit/Copy或按键Copy
与Trace&PrimitiveLog窗口同步
点击MSC视图里的消息，Trace&PrimitiveLog窗口对应的PrimitiveLog就会被选中。
点击Trace&PrimitiveLog窗口的PrimitiveLog，MSC视图里对应的消息就会被选中。
空白
2.5FilterDialogFilter对话框
Thefilterdialog,whichiscomposedoftwopropertypages,isusedtosetonline/offlinefiltersandbackgroundcolorforTrace&PrimitiveLogWindow.
[Onlinefilters]:Itmeansduringtheconnectionperiodintheonlinemode.
[Offlinefilters]:Itmeansintheofflinemode. Filter对话框由两个属性页组成，用来设置online/offlinefilters和Trace&PrimitiveLog窗口的背景色。
空白
Onlinefilters：意思是在online模式的连接阶段
空白
Offlinefilters：意思是在offline模式
Description Propertypage属性页 描述 ThefirstpropertypageisusedtosetfiltersforL1Trace.Youcansetfilteron/offfordifferenttraceclassesofeachL1module(class-level).
第一个属性页用来设置L1Trace的filters。你可以设置为每个L1module（class级别）的不同的traceclasses打开或关闭filter
ThesecondpropertypageisusedtosetfiltersforTrace&PrimitiveLog.Youcansetfilteron/offfordifferenttraceclassesofeachPSmodule(class-level);andchoosedifferentSAPlevelsforPSprimitivelog(SAP-level).
Inotherwords,thefilterofPSprimitiveisdeterminedbytwoconditions:iftheSAPlevelisgreaterthan0andifthesourcemodulefilterison.Furthermore,youcanconfigurethebackgroundcolors:[Trace]:Itdependsonthecolorofitstraceclass.[PrimitiveLog]:ItdependsonthecolorofitsSAP. 第二个属性页是用来为设置Trace&PrimitiveLog的filter。你可以为每个PSmodule（class-level）的不同的traceclasses打开或关闭filter；为PSPrimitivelog（SAP级）选择不同的SAP级别。换句话说，PSprimitive由两个condition决定：如果SAP级别大于0，如果源modulefilter是on。另外，你可以配置背景色：[Trace]：它取决于traceclass的颜色。[PrimitiveLog]：它取决于它的SAP的颜色。
2.6EngineeringModeDialog工程模式对话框
AfterenteringEngineeringmode,eachprotocolmoduleissupposedtoreportstatusandinformationeitherperiodicallyorwheneverinformationwaschanged.Thefollowingpropertypageswilldisplaytheinformationintextorgraphicmode. 进入工程模式之后，每个协议module应该周期性地、或者有信息变化时，来报告状态和信息。接下来的属性页会以文本或图形模式显示信息。
Description Propertypage属性页 描述 Thefirstpropertypageisusedtodisplaytheinformationofservingcell. 第一个属性页用来显示servingcell的信息。 Thesecondpropertypageisusedtodisplaytheinformationofservingcellandneighborcell. 第二个属性页用来显示servingcell和邻居cell的信息。 Thethirdpropertypageisusedtodisplaytheinformationoftop10powerlevelcell. 第三个属性页用来显示top10powerlevelcell Theforthpropertypageisusedtodisplaythepowerlevelhistoryinrecent10minutes.Whenthecellischanged,itwillshowawhite-circlewithnewarfcn.Youcanclickthe[ZoomIn/Out]buttontochangethescaleofY-axis,thenusemousewheelorleftbuttondragtomovethepicture.Besides,thevisibilityofeachcurvecanbeconfigurableattherightsideonthebottom. 第四个属性页用来显示最近10分钟的powerlevel历史。当cell被改变时，会显示一个带新arfcn的白圈。你可以点击ZoomIn/Out来改变Y轴的刻度，然后使用鼠标滚轮或左键来拖拽图片。另外，每个弧线的可视度可以在底部右端被配置。 ThefifthpropertypageisusedtodisplaytheotherrelatedinformationaboutmoduleMM,CC,SSetc. 第五个属性页是用来显示有关MM,CC,SS等module的其他相关信息。
2.7SimEditorDialogSim编辑器对话框
SimeditorprovidestwowaystoaccessthefilesofSIMcard.TheoneonthetopisthegeneralUI,whichprovidesthreefunctions:
空白
Function
Description
Input
1.Fileinformation
Getfilesizeandnumberofrecords.
Fileid
2.Read
ReadthefilecontentfromSIM.
Fileid,LengthandRecord
3.Write
WritethefilecontenttoSIM.
Fileid,Length,RecordandData
空白
空白
空白
Otherwise,italsoprovidesthededicatedUItoaccessthespecificfilesonthebottom.Itsupportsthreefunctions:空白
空白
Function
Description
Input
1.Connect
ReadoutallthesefilesfromSIM.
2.Write
WritethefilecontenttoSIM.
Data
3.Reset
Resetthefilecontentto0xff.
空白
Furthermore,bothofthedataitemcanbeselectedandusecopy/pastetoitselfortosystemclipboard. Sim编辑器提供两种访问SIM卡文件的方法。在top的一种是generalUI，它提供三种功能。
空白
功能
描述
输入
1.文件信息
取得文件尺寸和记录个数
文件id
2.读取
从SIM卡读取文件内容
文件id，长度和记录
3.写
把文件内容写入SIM卡
文件id，长度，记录和数据
空白
除此以外，还提供专门的UI来访问底部特定的文件。它支持三种功能：空白
空白
功能
描述
输入
1.连接
从SIM卡内读出所有的文件
2.写
把文件内容写入SIM卡
数据
3.复位
把文件内容复位至0xff
空白
此外，两个数据item都可以被选择，用copy/paste到自身或者到系统剪贴板。
2.8ExceptionWindow异常窗口
Afterconnectingwithtarget,iftherearevalidexceptionrecordsinNVRAM,CatcherwillreceivethenoticemessagesandshowthemintheSysTraceWindow.Itprovidestwowaystogettheinformationofexception:
空白
Type
Click
Description
Online
Advance/RetrieveException
Itisusedtoread/resetexceptionrecordsfromNVRAM.Afterusersclickthe[Read]button,CatcherwillreceivethecorrespondingPrimitiveLogthendecodetheseexceptionrecordsbydifferentstructuresaccordingtoitsexceptiontype.
Offline
Advance/ShowException
Itisusedtodecodetherawdataintotreestructures.UsershavetoselectthePrimitiveLog(READ_CNFforexception)intheTrace&PrimitiveLogWindow,andthenclickthisitemtoshowtheexceptionrecordsintreeformat.
连接目标之后，如果NVRAM里有有效的异常记录，Catcher就会收到通知消息并把它们显示在SysTrace窗口。它提供两种方法来获得异常信息。
空白
空白
类型
点击
描述
Online
高级/检索异常
用来从NVRAM读/复位异常记录。用户点击[Read]按键以后，Catcher就会接收相应的PrimitiveLog然后根据异常类型、用不同的结构来编码这些异常记录。
空白
空白
空白
Offline
高级/显示异常
用来把原始数据编码成树形结构。用户必须在Trace&PrimitiveLog窗口选择PrimitiveLog(异常时的READ_CNF)，然后点击此item来用树形格式显示异常记录。
2.9StatisticsWindow统计数据窗口
Systemstatisticsisusedtoanalysisthesysteminformationforusers.Likeexceptionhandling,italsoprovidestwowaystogettheinformationofsystemstatistics:
空白
Type
Click
Description
Online
Advance/RetrieveStatistics
Itisusedtoread/reset/clearflagforstatisticsrecordsinNVRAM.Afterusersclickthe[Read]button,CatcherwillreceivethecorrespondingPrimitiveLog,andthendecodethestatisticsrecordsbypredefinedstructures.
Offline
Advance/ShowStatistics
Itisusedtodecodetherawdataintotreestructures.UsershavetoselectthePrimitiveLog(READ_CNFforsystemstatistics)intheTrace&PrimitiveLogWindow,andthenclickthisitemtoshowthestatisticsrecordsintreeformat.
系统统计数据用来为用户分析系统信息。类似于异常handling，它也提供两种方法来取得系统统计数据的信息：
空白
空白
类型
点击
描述
Online
高级/检索统计数据
用来读/复位/清除flag为NVRAM里的统计数据记录（。。。？）用户点击[Read]键之后，Catcher会接收相应的PrimitiveLog，然后用预定义的结构编码这些统计数据记录。
Offline
高级/显示统计数据
用来把原始数据编码成树形结构。用户必须从Trace&PrimitiveLog窗口选择PrimitiveLog(系统统计数据时的READ_CNF)，然后点击这个item来以树形格式显示统计数据记录。
3Menus菜单
3.1Filemenu文件菜单
TheFilemenuoffersthefollowingcommands:
Open
Usethiscommandtoopenaexistinglogfile.
Close
Usethiscommandtoclosetheactivedocument.
OpenWorkspace
Usethiscommandtoopenaexistingworkspacefile.
SaveWorkspace
Usethiscommandtosavetheworkspace.
SaveLog
Usethiscommandtosavetheloggingmessages.
SaveLogAs
Usethiscommandtosaveastheloggingmessages.
RecentLogs
Usethiscommandtoopenarecentlogfile.
RecentWorkspaces
Usethiscommandtoopenarecentworkspacefile.
Exit
Usethiscommandtoquittheapplication 文件菜单提供如下的命令：
打开
使用此命令打开一个现存的log文件。
关闭
使用此命令关闭激活的文件
打开workspace
使用此命令打开一个现存的workspace文件
保存Workspace
使用这个命令来保存workspace
保存Log
使用此命令来保存logging消息。
另存Log为
使用此命令保存成logging消息（。。。？）
最近的Logs
使用此命令来打开一个最近的log文件
最近的Workspaces
使用此命令来打开一个最近的workspace文件
退出
使用此命令来退出该应用程序
3.2Editmenu编辑菜单
TheEditmenuoffersthefollowingcommands:
Cut
Usethiscommandtocuttheselectionandmoveittotheclipboard.
Copy
Usethiscommandtocopytheselectiontotheclipboard.
Paste
Usethiscommandtoinsertclipboardcontentsattheinsertionpoint.
Find
Usethiscommandtofindthespecifiedtext.
GoTo
UsethiscommandtomovetothespecifiedpositioninPrimitiveLogWindow.
ZoomIn
UsethiscommandtozoomintheMSCViewWindow.
ZoomOut
UsethiscommandtozoomouttheMSCViewWindow. 编辑菜单提供如下命令
剪切
使用此命令来剪切选中的内容并把它移到剪切板
复制
使用此命令来复制选中的内容到剪切板
粘贴
使用此命令在插入点插入剪切板的内容
查找
使用此命令来查找特定的文本
转到
使用此命令来移动到PrimitiveLog窗口的特定位置
空白
空白
放大
使用此命令在MSC视图窗口中进行放大
缩小
使用此命令在MSC视图窗口中进行缩小
3.3Viewmenu视图菜单
TheViewmenuoffersthefollowingcommands,whichenableyoutodisplayandhidethespecifiedwindow.Acheckmarkappearsinfrontofthemenuitemwhenthewindowisdisplayed.
空白
SYSTrace
UsethiscommandtodisplayandhidetheSysTraceWindow.
SeeSysTraceWindowtoseethedetails.
PSIntegrated
UsethiscommandtodisplayandhidetheTrace&PrimitiveLogWindow.
SeeTrace&PrimitiveLogWindowtoseethedetails.
ErrorMessage
UsethiscommandtodisplayandhidetheErrMsgWindow.
SeeErrMsgWindowtoseethedetails.
Toolbar
UsethiscommandtodisplayandhidetheToolbar,whichincludesbuttonsforsomeofthemostcommoncommandsinCatcher,suchasFileOpen.
SeeToolbarforhelponusingthetoolbar.
Command
UsethiscommandtodisplayandhidetheCommandToolbar,whichprovidesthefacilitytosendproprietarycommandtomodulesofprotocolstack.
SeeCommandToolbarforhelponusingthecommandtoolbar.
ATCommand
UsethiscommandtodisplayandhidetheATCommandToolbar,whichprovidesthefacilitytosendATcommandtomodulesofprotocolstack.
SeeATCommandToolbarforhelponusingtheATcommandtoolbar. 视图菜单提供如下命令，使你能够显示和隐藏特定的窗口。当某窗口被显示时，一个checkmark在菜单项前被显示。
空白
空白
SYSTrace
使用此命令来显示和隐藏SysTrace窗口。
查看SysTrace窗口以看到细节。
PS集成
使用此命令来显示和隐藏Trace&PrimitiveLog窗口。
查看Trace&PrimitiveLog窗口以看到细节。
空白
空白
错误消息
使用此命令来显示和隐藏错误消息窗口
查看错误消息窗口以看到细节。
工具栏
使用此命令以显示和隐藏工具栏，工具栏包括Catcher中最常用的一些命令，比如说打开文件。
查看工具栏以取得使用帮助信息
空白
空白
命令
使用此命令以显示和隐藏命令工具栏，命令工具栏提供一种功能，向协议栈module发送proprietary命令。
查看命令工具栏以取得使用帮助信息。
空白
空白
AT命令
使用此命令来显示和隐藏AT命令工具栏，AT命令工具栏提供一种功能，向协议栈modules发送AT命令。
查看AT命令工具栏以取得使用帮助信息。
3.4Controlmenu控制菜单
TheControlmenuoffersthefollowingcommands:
Mode
Usethiscommandtoenterloggingmode.
Connect
Usethiscommandtoconnecttothetarget.
Disconnect
Usethiscommandtodisconnectfromthetarget.
SetFilter
UsethiscommandtochangethefiltersettingsandbackgroundcolorforTrace&PrimitiveLogWindow.
SetDefaultFilter
UsethiscommandtosetadefaultfilterdefinedinCatcher.ini.
SeeFilterDialogforhelponsettingthefilter. 控制菜单提供如下命令：
模式
使用此命令以进入logging模式
连接
使用此命令以连接到target
断开连接
使用此命令以从target断开连接
设置Filter
使用此命令以改变filter设置和Trace&PrimitiveLog窗口的背景颜色。
空白
设置缺省Filter
使用此命令以设置定义在Catcher.ini中的缺省filter
查看Filter对话框以取得帮助信息。
3.5Configmenu配置菜单
TheConfigmenuoffersthefollowingcommands:
SetDatabasePath
Usethiscommandtospecifythedatabasepath.
ConfigureRS232
UsethiscommandtochooseCOMportandbaudrateforRS232connection.
Appearance
UsethiscommandtosetthefontsizeandtextcolorofeachdatatypeinTrace&PrimitiveLogWindow.
Option
UsethiscommandtosetthenumberofTrace&PrimitiveLogWindow.Ifusersselectthefirststyle,therewillbeonlyoneintegratedwindow;otherwisetheremaybemultipleseparatewindowstodifferentiatetheTrace&PrimitiveLogbyitssourcemodule. 配置菜单提供如下命令：
设置数据库路径
使用此命令来指定数据库路径
配置RS232
使用此命令来选择RS232连接的COMport和波特率。
空白
空白
外观
使用此命令以设置Trace&PrimitiveLog窗口中每种数据类型的字体大小和文本颜色
选项
使用此命令来设置Trace&PrimitiveLog窗口的个数。如果用户选择第一种风格，则只有一个集成窗口；否则将有若干分开的窗口来分别显示不同源module的Trace&PrimitiveLog。
3.6Advancemenu高级菜单
TheAdvancemenuoffersthefollowingcommands:
ShowMSCView
UsethiscommandtoshowtheMSCView.
SeeMSCViewWindowforhelponusingtheframewindow.
EngineeringMode
UsethiscommandtoenterEngineeringModeandshowthestatusreportedbyPSmodules.
SeeEngineeringModeDialogforhelponusingthedialog.
SimEditor
UsethiscommandtoshowtheSimEditorDialog.
SeeSimEditorforhelponusingthedialog.
DownloadDebugInfo
Usethiscommandtodownloadtargetdebuginformation.
Thiscommandwillsavedebuginformationtoafile.
RetrieveException
UsethiscommandtoshowtheExceptionWindowandgetexceptionrecordsonline.
SeeExceptionWindowforhelponusingtheframewindow.
RetrieveStatistics
UsethiscommandtoshowtheStatisticsWindowandgetsystemstatisticsonline.
SeeStatisticsWindowforhelponusingtheframewindow.
ShowException
UsethiscommandtoshowtheExceptionWindowanddecodeexceptionrecordsoffline.
ShowStatistics
UsethiscommandtoshowtheStatisticsWindowanddecodestatisticsrecordsoffline. 高级菜单提供如下命令：
显示MSC视图（消息序列图）
使用此命令来显示MSC视图
查看MSC视图窗口以取得帮助信息
工程模式
使用此命令以进入工程模式、显示PSmodules报告的状态
查看工程模式对话框以取得帮助信息。
空白
空白
Sim编辑器
使用此命令以显示Sim编辑器对话框
查看Sim编辑器以取得帮助信息
下载Debug信息
使用此命令来下载targetdebug信息
此命令将把debug信息保存到一个文件
检索异常
使用此命令以显示异常窗口和在线取得异常记录
查看异常窗口以取得帮助信息
空白
空白
检索统计数据
使用此命令以显示统计数据窗口、在线取得系统统计数据
查看系统数据窗口以取得帮助信息
空白
空白
显示异常
使用此命令以显示异常窗口、离线编码异常记录
空白
空白
显示统计数据
使用此命令以显示统计数据窗口、离线编码统计数据记录
3.7Windowmenu窗口菜单
TheWindowmenuoffersthefollowingcommands,whichenableyoutoarrangemultipleviewsofmultipledocumentsintheapplicationwindow:
空白空白
Cascade
Usethiscommandtoarrangemultipleopenedwindowsinanoverlappedfashion.
TileHorizontally
Usethiscommandtohorizontallyarrangemultipleopenedwindowsinanon-overlappedfashion.
TileVertically
Usethiscommandtoverticallyarrangemultipleopenedwindowsinanon-overlappedfashion.
1,2,...command(Windowmenu)
CatcherdisplaysalistofcurrentlyopendocumentwindowsatthebottomoftheWindowmenu.Acheckmarkappearsinfrontofthedocumentnameoftheactivewindow.Chooseadocumentfromthislisttomakeitswindowactive. 窗口菜单提供如下命令，使你能够在应用窗口安排多文件的多视图：
空白
空白
层叠
使用此命令来把多个打开的窗口安排成重叠的样式
空白
空白
水平平铺
使用此命令来水平地安排不同的打开的窗口，并且不重叠
空白
空白
垂直平铺
使用此命令来垂直地安排不同的打开的窗口，并且不重叠
空白
空白
1,2,...命令(窗口菜单)
Catcher在窗口菜单底部显示一个列表，列举目前打开的窗口。激活窗口的文档名字前面有一个checkmark。在列表中选择一个文档以激活它的窗口。
3.8Helpmenu帮助菜单
TheHelpmenuoffersthefollowingcommands,whichprovideyouassistancewiththisapplication:
HelpTopics
Offersyouanindextotopicsonwhichyoucangethelp.
About
Displaystheversionnumberofthisapplication. 帮助菜单提供如下命令，帮助你使用该应用程序：
空白
空白
帮助主题
给你提供一个索引，其中有若干帮助主题
关于
显示该应用程序的版本号
3.9ToolBar工具栏
Thetoolbarisdisplayedacrossthetopoftheapplicationwindow,belowthemenubar.ThetoolbarprovidesquickmouseaccesstomanytoolsusedinCatcher.
TohideordisplaytheToolbar,chooseToolbarfromtheViewmenu.
Click
To
Openanexistingdocument.CatcherdisplaystheOpendialogbox,inwhichyoucanlocateandopenthedesiredfile.
Savetheactivedocumentwithitscurrentname.Ifyouhavenotnamedthedocument,CatcherdisplaystheSaveAsdialogbox.
Removeselecteddatafromthedocumentandstoresitontheclipboard.
Copytheselectiontotheclipboard.
Insertthecontentsoftheclipboardattheinsertionpoint.
Enterloggingmode.
ChangethefiltersettingsandbackgroundcolorforTrace&PrimitiveLogWindow.
ChooseCOMportandbaudrateforRS232connection.
Connecttotarget.
Connectandsyncwithtarget.
Disconnectfromtarget.
Setallloggingmessagesbesuspended.Itmeansallthefilterswillbeturnedoff,souserscan’tsetfiltersinthissituation.Usershavetoclick[Resume]buttontoreturntotheoriginalstate.
Setallfiltersbethesameasoriginalsettingsbeforeenteringthe[Suspend]situation.
Clearallloggingmessages.
EnterEngineeringModeandshowthestatusreportedbyPSmodules.
ShowtheSimEditorDialog.
ZoomintheMSCViewWindow.
ZoomouttheMSCViewWindow.
工具栏显示在Catcher窗口的顶部，在菜单栏的下方。工具栏提供了Catcher中很多工具的快速鼠标访问。
空白
空白
要想隐藏或显示工具栏，在试图菜单中选择工具栏。
点击
至
打开一个已存的文档。Catcher显示“打开”对话框，在里面你可以定位和打开想要的文件。
空白
把当前文档用当前名保存起来。如果你还没有命名这个文档，那么Catcher就会显示“另存为”对话框。
空白
空白
把选中的数据从文档中搬移出来，并存到剪切板上。
把所选内容复制到剪切板上。
把剪切板上的内容插入到插入点上。
进入logging模式。
改变filter设置和Trace&PrimitiveLog窗口的背景颜色。
选择RS232连接的COMport
连接到target
连接并和target同步
同target断开
暂停所有的logging消息。意思是所有的filter会被关闭，那么在这种情况下用户不能设置filter。用户必须点击[Resume]按键才能回到之前的状态。
空白
设置所有的filter回到进入暂停之前的状况
清除所有logging消息
进入工程模式、显示PSmodule报告的状态
显示Sim编辑器对话框
放大MSC视图窗口
缩小MSC视图窗口
3.10CommandToolBar命令工具栏
Thecommandtoolbarisdisplayedacrossthetopoftheapplicationwindow,belowthetoolbar.Itisusedtosendproprietarycommandtospecificmoduleofprotocolstackwithanindexvalue.
Tohideordisplaythecommandtoolbar;chooseCommandfromtheViewmenu. 命令工具栏在Catcher窗口的顶部，在工具栏下方。它是用来发送proprietary命令到特定的、带有索引值的协议栈module。
空白
空白
若要隐藏或显示命令工具栏，从视图菜单选择Command。
3.11ATCommandToolBarAT命令工具栏
TheATcommandtoolbarisdisplayedacrossthetopoftheapplicationwindow,belowthecommandtoolbar.ItisusedtosendATcommandtoprotocolstack.
TohideordisplaytheATcommandtoolbar;chooseATCommandfromtheViewmenu. AT命令工具栏显示在Catcher窗口的顶部，在命令工具栏下方。它被用来向协议栈发送AT命令。
空白
空白
想要隐藏或显示AT命令工具栏，从视图菜单选择ATCommand。
3.12Auto-ClearToolBar自动-清除工具栏
Thetoolbarisusedtosetthedurationforautoclearing.Catcherwillclearupallkindsofloggingmessagesautomaticallyeveryperiod. 这个工具栏式用来设置自动清除的持续时间。Catcher每隔一段时间就会自动清除掉各种logging消息。
|
|
