ETAS GmbH Borsigstraße Stuttgart Tel.:+49 (711) Fax:+49 (711)

Transcription

1 24!42!#% 5SER-ANUAL

2

3 #ONTACT$ETAILS (7$6*URXS ZZZHWDVJURXSFRP *HUPDQ\ ETAS GmbH Borsigstraße Stuttgart Tel.:+49 (711) Fax:+49 (711) ZZZHWDVGH -DSDQ ETAS K.K. Queen's Tower C-17F, 2-3-5, Minatomirai, Nishi-ku, Yokohama, Kanagawa Japan Tel.: +81 (45) Fax: +81 (45) ZZZHWDVFRMS.RUHD ETAS Korea Co. Ltd. 3F, Samseung Bldg Yangjae-dong, Seocho-gu Seoul Tel.: +82 (2) Fax: +82 (2) ZZZHWDVFRNU 86$ ETAS Inc Miller Road Ann Arbor, MI Tel.: +1 (888) ETAS INC Fax: +1 (734) ZZZHWDVLQFFRP )UDQFH ETAS S.A.S. 1, place des États-Unis SILIC Rungis Cedex Tel.: +33 (1) Fax: +33 (1) ZZZHWDVIU *UHDW%ULWDLQ ETAS UK Ltd. Studio 3, Waterside Court Third Avenue, Centrum 100 Burton-upon-Trent Staffordshire DE14 2WQ Tel.: +44 (0) Fax: +44 (0) ZZZHWDVXNQHW

4

5 #OPYRIGHT 4HEDATAINTHISDOCUMENTMAYNOTBEALTEREDORAMENDEDWITHOUTSPECIAL NOTIFICATIONFROM,IVE$EVICES,TD,IVE$EVICES,TDUNDERTAKESNOFURTHER OBLIGATIONINRELATIONTOTHISDOCUMENT4HESOFTWAREDESCRIBEDINITCANONLY BEUSEDIFTHECUSTOMERISINPOSSESSIONOFAGENERALLICENSEAGREEMENTOR SINGLELICENSE5SINGANDCOPYINGISONLYALLOWEDINCONCURRENCEWITHTHE SPECIFICATIONSSTIPULATEDINTHECONTRACT 5NDERNOCIRCUMSTANCESMAYANYPARTOFTHISDOCUMENTBECOPIED REPRODUCEDTRANSMITTEDSTOREDINARETRIEVALSYSTEMORTRANSLATEDINTOANOTHER LANGUAGEWITHOUTTHEEXPRESSWRITTENPERMISSIONOF,IVE$EVICES,TD #OPYRIGHT,IVE$EVICES,TD 4HENAMESANDDESIGNATIONSUSEDINTHISDOCUMENTARETRADEMARKSORBRANDS BELONGINGTOTHERESPECTIVEOWNERS $OCUMENT4$ 24!42!#%

6

7 #ONTENTS!BOUTTHIS-ANUAL 7HO3HOULD2EADTHIS-ANUAL #ONVENTIONS 24!42!#%/VERVIEW 4ARGET 24!42!#%3ERVER 24!42!#%#LIENT 4RACECONTROL 3TART&REE2UNNING4RACE 3TART"URSTING4RACE 3TART4RIGGERING4RACE 3ET4RACE2EPEAT 3TOP4RACE 'ENERAL )DENTIFERS #ATEGORIES #ONTENTS

8 #LASSES %NABLE4RACE#LASSES $ISABLE4RACE#LASSES %NABLE4RACE#ATEGORIES $ISABLE4RACE#ATEGORIES 4RACEPOINTS,OG4RACEPOINT,OG4RACEPOINT6ALUE,OG4RACEPOINT$ATA 4ASK4RACEPOINTS,OG4ASK4RACEPOINT,OG4ASK4RACEPOINT6ALUE,OG4ASK4RACEPOINT$ATA )NTERVALS,OG)NTERVAL3TART,OG)NTERVAL3TART6ALUE,OG)NTERVAL3TART$ATA,OG)NTERVAL%ND,OG)NTERVAL%ND6ALUE,OG)NTERVAL%ND$ATA -ISCELLANEOUS,OGGING,OG0ROFILE3TART,OG#RITICAL%XECUTION%ND,OG#AT)323TART,OG#AT)32%ND,OG/VERRUN(OOK 4RIGGERING #LEAR4RIGGER 4RIGGER.OW 3ET4RIGGER7INDOW 4RIGGER/N!CTIVATION 4RIGGER/N#HAIN 4RIGGER/N4ASK3TART 4RIGGER/N4ASK3TOP 4RIGGER/N)323TART 4RIGGER/N)323TOP 4RIGGER/N#AT)323TART #ONTENTS

9 4RIGGER/N#AT)323TOP 4RIGGER/N#AT)323TART 4RIGGER/N#AT)323TOP 4RIGGER/N)NIT4ASK3TART 4RIGGER/N)NIT4ASK3TOP 4RIGGER/N'ET2ESOURCE 4RIGGER/N2ELEASE2ESOURCE 4RIGGER/N3ET%VENT 4RIGGER/N4RACEPOINT 4RIGGER/N4ASK4RACEPOINT 4RIGGER/N)NTERVAL3TART 4RIGGER/N)NTERVAL%ND4RIGGER/N)NTERVAL3TOP 4RIGGER/N4IMETABLE%XPIRY 4RIGGER/N4ICK3CHEDULE 4RIGGER/N!DVANCE3CHEDULE 4RIGGER/N!LARM%XPIRY 4RIGGER/N%XPLICIT3END3TATE-ESSAGE 4RIGGER/N%XPLICIT2ECEIVE3TATE-ESSAGE 4RIGGER/N3END-ESSAGE 4RIGGER/N2ECEIVE-ESSAGE 4RIGGER/N%RROR 4RIGGER/N3HUTDOWN!0)2ESTRICTIONS )NTRODUCTION 'ENERAL0ROBLEM!PPLICABLE-ACROS%2#/3 %+!PPLICABLE-ACROS24!/3%+ #ONTENTS

10

11 !BOUTTHIS-ANUAL 24!42!#%ISASOFTWARELOGICANALYZERFOREMBEDDEDSYSTEMS#OUPLEDWITH ASUITABLYENHANCEDAPPLICATIONITPROVIDESTHEDEVELOPERWITHAUNIQUESETOF SERVICESTOASSISTINDEBUGGINGANDTESTINGASYSTEM&OREMOSTAMONGSTTHESE ISTHEABILITYTOSEEEXACTLYWHATISHAPPENINGINASYSTEMATRUNTIMEWITHA PRODUCTIONBUILDOFTHEAPPLICATIONSOFTWARE 4HISMANUALDESCRIBESTHETARGET!0)FOR24!42!#% 7HO3HOULD2EADTHIS-ANUAL )TISASSUMEDTHATYOUAREADEVELOPER9OUSHOULDREADTHISGUIDEIFYOUWANT TOFINDOUTABOUTTHETARGET!0)FOR24!42!#%4HISDOCUMENTALSOCONTAINS ATOPLEVELOVERVIEWOFTHE24!42!#%ARCHITECTUREFORREFERENCE #ONVENTIONS )MPORTANT.OTESTHATAPPEARLIKETHISCONTAINIMPORTANTINFORMATIONTHAT YOUNEEDTOBEAWAREOF-AKESURETHATYOUREADTHEMCAREFULLYANDTHAT YOUFOLLOWANYINSTRUCTIONSTHATYOUAREGIVEN 0ORTABILITY.OTESTHATAPPEARLIKETHISDESCRIBETHINGSTHATYOUWILLNEEDTO KNOWIFYOUWANTTOWRITECODETHATWILLWORKONANYTARGETPROCESSOR )NTHISGUIDEYOUmLLSEETHATPROGRAMCODEHEADERFILENAMES#TYPENAMES# FUNCTIONSAND!0)CALLNAMESALLAPPEARINTHECourierTYPEFACE7HENTHE NAMEOFANOBJECTISMADEAVAILABLETOTHEPROGRAMMERTHENAMEALSO APPEARSINTHECourierTYPEFACESOFOREXAMPLEATASKNAMED4ASK APPEARSASATASKHANDLECALLEDTask1!BOUTTHIS-ANUAL

12

13 24!42!#%/VERVIEW 24!42!#%ISASOFTWARELOGICANALYZERFOREMBEDDEDSYSTEMS#OUPLEDWITH ASUITABLYENHANCEDAPPLICATIONITPROVIDESTHEDEVELOPERWITHAUNIQUESETOF SERVICESTOASSISTINDEBUGGINGANDTESTINGASYSTEM&OREMOSTAMONGSTTHESE ISTHEABILITYTOSEEEXACTLYWHATISHAPPENINGINASYSTEMATRUNTIMEWITHA PRODUCTIONBUILDOFTHEAPPLICATIONSOFTWARE 4HE24!42!#%PRODUCTCONSISTSOFTHREELAYERSqTARGET24!42!#%3ERVER AND24!42!#%#LIENTEACHDESCRIBEDINMOREDETAILBELOW %NDTOEND24!42!#%LOOKSLIKETHIS Target Application RTA-TRACE Server RTOS Trace layer Comm. link Comm. Link DLL RTA-TRACE Client OS DLL TimeTrace visualizer Processing Buffer Statistics calculator CPU usage chart... 4ARGET 4HETARGETLAYERCONSISTSOFANAPPLICATIONASUPPORTED/3%+/3OPTIONALIF USINGTHE24!42!#%)NSTRUMENTING+IT ANDTHE24!42!#%TARGETSOFTWARE 4HE24!42!#%TARGETSOFTWARECONSISTSOFALIBRARYANDHEADERFILESALLOWING /3CALLSTOBEINTERCEPTEDASWELLASPROVIDINGAN!0)FORTHELOGGINGOFUSER GENERATEDTRACINGINFORMATIONUSING4RACEPOINTS4ASK4RACEPOINTSAND INTERVALSqSEEINDIVIDUALSECTIONSINTHISDOCUMENT $URINGTHESYSTEMBUILDPROCESSITISPOSSIBLETOENABLEANDDISABLECLASSESOF LOGDATABOTH/3ANDUSERTRACEINFORMATION THEMECHANISMFORTHISIS DESCRIBEDINTHE24!42!#%#ONFIGURATION2EFERENCE-ANUAL 4RACEDATAGENERATEDBYTHETARGETISTRANSFERREDVIAAN%#5,INKDESCRIBEDIN THE24!42!#%%#5,INK'UIDE TOTHE24!42!#%3ERVER 24!42!#%3ERVER 4HE24!42!#%3ERVERISRESPONSIBLEFORCOLLECTINGTRACEDATAGENERATEDBY THETARGETASINGLE3ERVERISCAPABLEOFCONNECTINGTOMULTIPLETARGETS SIMULTANEOUSLYWITHAPPROPRIATELICENSING ANDPROCESSINGTHETRACEDATAINTO AFORMSUITABLEFORTHE24!4RACECLIENT!PPROPRIATE$,,SFORTHE%#5,INK AND/3INUSEAREUSEDTOCONVERTUNPACKDATAINTOAFORMSUITABLEFOR DISPLAY 24!42!#%/VERVIEW

14 !LTHOUGHTHE3ERVERAPPLICATIONISSEPARATEFROMTHE#LIENTITWILLMOSTOFTEN BEEXECUTEDAUTOMATICALLYWHENTHE#LIENTISSTARTEDTHEONLYEVIDENCETHAT THE3ERVERISRUNNINGISTHEICONINTHESYSTEMTRAYOFTHEHOST0#3EETHE 24!42!#%%#5,INK'UIDETODETERMINEHOWTOMODIFYPARAMETERSOFTHE %#5,INKIFNECESSARYORPOSSIBLE 4HE24!42!#%3ERVERCANSUPPORTCONNECTIONSFROMMULTIPLE24!42!#% #LIENTSASWELLASTARGETAPPLICATIONS qeitherlocallyonthesame0# OR REMOTELYACROSSANETWORK 4HESEFEATURESARESUBJECTTOLICENSING 24!42!#%#LIENT 4HE24!42!#%#LIENTISTHEMOSTVISIBLEPORTIONOF24!42!#%SINCEITIS RESPONSIBLEFORDISPLAYINGTHERECORDEDDATACALCULATINGSTATISTICSETC4HE VARIOUSVISUALIZATIONOPTIONSARESUPPLIEDASPLUGINSWHICHMAYBESUBJECTTO ADDITIONALLICENSING 0ROCESSINGISCARRIEDOUTWHICHCONVERTSTHERAWTRACEDATAGENERATEDBYTHE TARGETINTOAMOREREADABLEFORMASDESCRIBEDBYTHEUSERDURINGTHE CONFIGURATIONPROCESS3EETHE24!42!#%#ONFIGURATION2EFERENCE-ANUAL FORDETAILSABOUTHOWTHISISDONE %XAMPLESOFPLUGINSARETHE4IME4RACEVISUALIZERALLOWINGTHETASKACTIVITYOF ANAPPLICATIONTOBEEXAMINED ANDTHE#05USAGEPIEANDBARGRAPHS ALLOWINGAVIEWOFTHE#05USAGEBYSYSTEMELEMENT 0LUGINFEATURESAREMORECOMPLETELYDESCRIBEDBYONLINEHELPFILESqAVAILABLE FROMTHEl(ELPmMENUOFTHE24!42!#%#LIENT 24!42!#%/VERVIEW

15 4RACECONTROL 4HEFOLLOWING!0)CALLSCONTROLTHEMODEINWHICH24!42!#%OPERATES 3TART&REE2UNNING4RACE void StartFreeRunningTrace(void).ONE 3TARTSTRACINGIN&REE2UNNINGMODE &REERUNNINGTRACEMODECAPTURESEVENTINFORMATION CONTINUOUSLY$ATAISUPLOADEDTOTHEHOSTASSOONASITIS AVAILABLECONCURRENTLYWITHCAPTURE )FTHETRACEBUFFERBECOMESFULLLOGGINGOFTRACEDATAIS SUSPENDEDUNTILTHEBUFFERHASBEENEMPTIED7HENTHE BUFFERISAVAILABLEAGAINTRACINGRESUMES4HISSITUATION MIGHTOCCURIFTHE%#5,INKISTOOSLOWFORTHEDESIRED VOLUMEOFTRACEDATA )FTHISCALLISMADEWHILSTTRACINGTHETRACEBUFFERIS CLEAREDANDTRACINGBEGINSAGAIN

16 3TART"URSTING4RACE void StartBurstingTrace(void).ONE 3TARTSTRACINGIN"URSTINGMODE "URSTINGTRACEMODECAPTURESEVENTINFORMATIONINTOTHE TRACEBUFFERINAlONESHOTmMANNER7HENTHEBUFFERIS FULLTRACINGSTOPSANDDATATRANSFERBEGINS.OATTEMPTIS MADETOUPLOADDATATOTHE3ERVERUNTILTHETRACEBUFFER HASFILLED )FSetTraceRepeat()SEE HASBEENUSEDTO ENABLEREPEATEDBURSTINGTRACESTRACINGRESUMESWHEN DATATRANSFERISCOMPLETE )FTHISCALLISMADEWHILSTTRACINGTHETRACEBUFFERIS CLEAREDANDTRACINGBEGINSAGAIN 3TART4RIGGERING4RACE void StartTriggeringTrace(void).ONE 3TARTSTRACINGIN4RIGGERINGMODE 4RIGGERINGTRACEMODEWAITSFORSPECIFICEVENTSBEFORE TRANSFERRINGTRACEDATATOTHEHOST4RIGGEREVENTSARESET USINGTHETriggerOn ()!0)CALLSSEEONWARD!PREANDPOSTTRIGGERBUFFERSIZECANBESPECIFIEDUSING SetTriggerWindow()SEE SOTHATONLYTHESET OFEVENTSBEFOREANDAFTERTHETRIGGEREVENTCANBESEEN SetTraceRepeat()SEE CANBEUSEDTOENABLE REPEATEDTRIGGEREDTRACES)NTHISCASEWHENDATATRANSFER HASCOMPLETEDTRACINGWILLRESUMETHENEXTTIMETHE TRIGGEREVENTOCCURS )FTHISCALLISMADEWHILSTTRACINGTHETRACEBUFFERIS CLEAREDANDTRACINGBEGINSAGAIN

17 3ET4RACE2EPEAT void SetTraceRepeat(osTraceBool <mode>) PRGH.ONZEROVALUEENABLESREPEATMODEZERODISABLESREPEAT MODE %NABLESDISABLESREPEATFEATUREOF"URSTINGAND4RIGGERING TRACEMODES 3EEAND 3TOP4RACE void StopTrace(void).ONE 3TOPSRECORDINGOFTRACEDATATOTHETRACEBUFFER 4HISDOESNOTABORTTHEDATALINKANYDATAREMAININGIN THETRACEBUFFERISUPLOADEDTOTHEHOST 'ENERAL 24!42!#%ALLOWSTHREEDIFFERENTVISUALIZATIONAIDSTOBEDEFINEDTOAIDIN PROGRAMDEBUGGINGqTHESEARE4RACEPOINTS4ASK4RACEPOINTSAND)NTERVALS 4RACEPOINTS3ECTION AREDISPLAYEDONTHE4IME4RACEVISUALIZERON INDIVIDUALTAPES4HEYCANBELOGGEDFROMANYPOINTINAPROGRAMq PERHAPSTOINDICATESOMEGLOBALPROGRAMSTATE 4ASK4RACEPOINTS3ECTION AREDISPLAYEDONTHETAPEOFTHETASK WHICHLOGSTHEMqSOTHESEAREIDEALFORSHOWINGTHEACTIVITYOFA PARTICULARTASK )NTERVALS3ECTION CANBELOGGEDFROMANYPLACEINAPROGRAMq THEYHAVEBOTHASTARTANDANENDANDMIGHTBEUSEDTOSHOWATIME RELATEDFEATUREOFAPROGRAMIESTIMULUSRESPONSE,OGGINGANYOFTHEABOVEMARKERSCANALSOHAVESOMEDATAATTACHEDWHICH WILLBEDISPLAYEDINTHE4IME4RACEVISUALIZER EITHERASASINGLEORBIT VALUEUSINGTHE Value()VERSIONOFTHELog ()CALLS ORALARGERDATA BLOCKUSINGTHE Data()VERSIONOFTHELog ()CALLS 4HEATTACHED

18 DATAVALUEWILLBEDISPLAYEDACCORDINGTOTHEFORMATSTRINGSUPPLIEDAT CONFIGURATIONTIME3EETHE24!42!#%#ONFIGURATION'UIDEFORDETAILS %ACHMARKERDESCRIBEDABOVEHASANIDENTIFIERANDCANBELONGTOONEORMORE CATEGORIES4HESETERMSAREDESCRIBEDBELOW )DENTIFERS 4HEIDENTIFIERS)$S USEDFOR4RACEPOINTS4ASK4RACEPOINTSAND)NTERVALSHAVE ALIMITEDRANGE4WORANGESOFIDENTIFIEREXISTFOREACHOFTHESESELECTEDAT CONFIGURATIONTIME COMPACTANDEXTENDED)$S4HERANGESFOREACHOFTHESE ARESHOWNBELOW )$ #OMPACT %XTENDEDDEFAULT Tracepoint BIT BIT TaskTracePoint BIT BIT Interval BIT BIT )DENTIFIERSCANBEGENERATEDEITHERINTHECONFIGURATIONPROCESS RECOMMENDEDFOR%2#/3 %+ AND24!/3%+ ORLITERALSCANBEUSED&OR %2#/3 %+ AND24!/3%+GENERATEDIDENTIFIERSARE#defined INTHE rtatrace.hheaderfile5seofidentifiersgeneratedintheconfiguration PROCESSMEANSTHATVISUALIZATIONOFTHETRACEDATAWILLBEMOREREADILY UNDERSTOODFOREXAMPLETHE4IME4RACE6ISUALIZERWILLDISPLAY Tracepoint <name> INSTEADOF Tracepoint 5 )FA4RACEPOINTHASBEENCONFIGUREDWITHANAMEANDNUMBERSUBSEQUENTUSE OFTHELITERALNUMBERASANIDENTIFIERWILLCAUSETHENAMETOBESEENINTHE 24!42!#%#LIENTqITISTHEREFORERECOMMENDEDTHATNAMEDIDENTIFIERSBE USED 7HENUSINGTHE/3)NSTRUMENTINGKITTHISMECHANISMISSTILLAVAILABLEEXCEPT THATTHEDESCRIPTIONFILEWITHA.rtaEXTENSION MAYNEEDTOBEHAND GENERATED.OTE5SINGALog ()CALLWITHANIDENTIFIERTHATISOUTOFRANGEWILLSILENTLY FAIL #ATEGORIES %VERYUSER4ASK 4RACEPOINTBELONGSTOONEORMOREUSERDEFINEDCATEGORIES 4HISALLOWSSETSOF4ASK 4RACEPOINTSTOBETOENABLEDORDISABLEDEITHERAT RUNTIMEORATCONFIGURATIONTIME4HEREARERUNTIMECATEGORIESAVAILABLE ANDANUNLIMITEDNUMBEROFCONFIGURATIONTIMECATEGORIES!LTHOUGHITISPOSSIBLETOGENERATEAN)$OFITISNOTPOSSIBLETOTRIGGERONAN INTERVALTRACEPOINTTASKTRACEPOINTWITHAN)$OF

19 #ATEGORIESARESPECIFIEDASBITMASKSDURINGTHECONFIGURATIONPROCESS HENCEIT ISPOSSIBLETOCOMBINEMULTIPLETRACECATEGORIESUSINGTHEBITWISE/2OPERATOR l\m.ote)nalog ()CALLA4RACEPOINTISLOGGEDIFANYOFTHECATEGORIESARE ACTIVEIEFORAPARTICULAR4RACEPOINTIFARUNTIMECATEGORYISCOMBINEDWITHA CATEGORYWHICHHASBEENENABLEDATCONFIGURATIONTIMEDISABLINGTHERUNTIME CATEGORYWILLHAVENOEFFECTqTHE4RACEPOINTWILLSTILLBELOGGED.OTE)FALLOFTHECATEGORIESATTACHEDTOAPARTICULARLog ()CALLAREMARKED ASFALSEATCONFIGURATIONTIMETHELog ()CALLWILLNOTBEINSERTEDINTOTHE CODESTREAM.OTE#ATEGORIESMUSTONLYBEENABLEDORDISABLEDUSING EnableTraceCategories ANDDisableTraceCategories RESPECTIVELY WHENTRACINGISSTOPPED)FTHISISNOTDONETHE24!42!#% VISUALIZERMAYDISPLAYINCORRECTANDORMISLEADINGDATA #LASSES,OGGEDEVENTSBELONGTOPREDEFINEDCLASSESALLOWINGTHEUSERTOENABLEOR DISABLECLASSESOFEVENTSEITHERATRUNTIMEORCONFIGURATIONTIME!LISTOF CLASSESISGIVENINTHEFOLLOWINGTABLE 3INCECLASSESAREBITMASKSITISPOSSIBLETOENABLEORDISABLEASETOFCLASSESBY USINGTHEBITWISE/2OPERATOR\ 3EETHE24!42!#%CONFIGURATIONREFERENCEFORYOURPARTICULAROPERATINGSYSTEMFORDETAILSOF THECONFIGURATIONPROCESS

20 OS4RACE#LASSES4YPE TRACE_ACTIVATIONS_CLASS TRACE_OSEK_MESSAGES_CLASS TRACE_RESOURCES_CLASS TRACE_INTERRUPT_LOCKS_CLASS TRACE_SWITCHING_OVERHEADS_CLASS TRACE_TASKS_AND_ISRS_CLASS TRACE_PROCESSES_CLASS TRACE_EXPLICIT_STATE_MESSAGES_CLASS TRACE_ERRORS_CLASS TRACE_TASK_TRACEPOINT_CLASS TRACE_TRACEPOINT_CLASS TRACE_INTERVALS_CLASS TRACE_MESSAGE_DATA_CLASS TRACE_STARTUP_AND_SHUTDOWN_CLASS TRACE_ALARMS_CLASS TRACE_TIMETABLES_CLASS TRACE_SCHEDULES_CLASS TRACE_OSEK_EVENTS_CLASS TRACE_NO_CLASSES TRACE_ALL_CLASSES %2#/3 %+ #USTOM %2#/3 %+ %2#/3 %+ 24!/3%+ 24!/3%+#USTOM.OTE#LASSESMUSTONLYBEENABLEDORDISABLEDUSING EnableTraceClasses ANDDisableTraceClassesRESPECTIVELY WHEN TRACINGISSTOPPED)FTHISISNOTDONETHE24!42!#%VISUALIZERMAYDISPLAY INCORRECTANDORMISLEADINGDATA

21 %NABLE4RACE#LASSES void EnableTraceClasses( ostraceclassestype <mask>) PDVN -ASKOFONEORMOREEVENTCLASSESTOENABLE 4HISCALLENABLESONEORMORECLASSESOFTRACEEVENTSATRUN TIME 4HEDUALTO #LASSESNOTLISTEDINTHECALLWILLBELEFTINTHEIRCURRENT STATE $ISABLE4RACE#LASSES void DisableTraceClasses( ostraceclassestype <mask>) PDVN -ASKOFONEORMOREEVENTFAMILIESTODISABLE 4HISCALLDISABLESONEORMOREFAMILIESOFTRACEEVENTSAT RUNTIME 4HEDUALTO #LASSESNOTLISTEDINTHECALLWILLBELEFTINTHEIRCURRENT STATE

22 %NABLE4RACE#ATEGORIES void EnableTraceCategories( ostracecategoriestype <mask>) PDVN!NEVENTCATEGORYMASK #AUSESAUSERSPECIFIEDSUBSETOFUSER4RACEPOINTSTOBE ENABLED 4HEDUALTO %VERYUSER4RACEPOINTBELONGSTOONEORMORECATEGORIES #ATEGORIESNOTLISTEDINTHECALLWILLBELEFTINTHEIRCURRENT STATE $ISABLE4RACE#ATEGORIES void DisableTraceCategories( ostracecategoriestype <mask>) PDVN!NEVENTCATEGORYMASK #AUSESAUSERSPECIFIEDSUBSETOFUSER4RACEPOINTSTOBE DISABLED 4HEDUALTO %VERYUSER4RACEPOINTBELONGSTOONEORMORECATEGORIES #ATEGORIESNOTLISTEDINTHECALLWILLBELEFTINTHEIRCURRENT STATE

23 4RACEPOINTS 4RACEPOINTSAREDISPLAYEDINTHE4IME4RACEVISUALIZERONTHEIROWNTAPES 4RACEPOINTIDENTIFIERSCANBENAMEDDURINGTHECONFIGURATIONPROCESSAND 4IME4RACEWILLDISPLAYTHENAME ORLITERALNUMERICALVALUESCANBEUSED INSTEAD,OG4RACEPOINT void LogTracepoint( <TpointId>, ostracecategoriestype <catmask>) 7SRLQW,G )DENTIFIESA4RACEPOINTSIZEVARIESqSEE FDWPDVN 4HECATEGORYORCATEGORIESTHATTHIS4RACEPOINTBELONGSTO,OGSA4RACEPOINTAGAINSTITSDESIGNATEDTASK,OGGINGISSUBJECTTOTHETRACE_TRACEPOINT_CLASS CLASSANDONEORMOREOFTHECATEGORIESIN<catmask> BEINGENABLED

24 ,OG4RACEPOINT6ALUE void LogTracepointValue( <TpointId>, XLQW<val>, ostracecategoriestype <catmask>) 7SRLQW,G )DENTIFIESA4RACEPOINTSIZEVARIESqSEE YDO.UMERICALVALUETOBESENTWITHTHE4RACEPOINT4HESIZE OFVALORBIT DEPENDSUPONTHESIZEOFTHESYSTEM TIMESELECTEDDURINGCONFIGURATIONqSEETHE24!42!#% #ONFIGURATION2EFERENCE-ANUALFORFURTHERINFORMATION FDWPDVN 4HECATEGORYORCATEGORIESTHATTHIS4RACEPOINTBELONGSTO,OGSA4RACEPOINTAGAINSTITSDESIGNATEDTASKALONGWITH ANUNSIGNEDORBITINTEGERVALUE,OGGINGISSUBJECTTOTHETRACE_TRACEPOINT_CLASS CLASSANDONEORMOREOFTHECATEGORIESIN<catmask> BEINGENABLED

25 ,OG4RACEPOINT$ATA void LogTracepointData( <TpointID>, PTR(ByteType) <dataptr>, osuinttype <length>, ostracecategoriestype <catmask>) 7SRLQW,' )DENTIFIESA4RACEPOINTSIZEVARIESqSEE GDWD3WU 0OINTSTOADATABLOCKTOBESENTWITHTHE4RACEPOINT OHQJWK,ENGTHOFTHEDATABLOCKPOINTEDTOBY<dataPtr>IN BYTES FDWPDVN 4HECATEGORYORCATEGORIESTHATTHISCALLBELONGSTO,OGSA4RACEPOINTAGAINSTITSDESIGNATEDTASKALONGWITH ARBITRARYBINARYDATA,OGGINGISSUBJECTTOTHETRACE_TRACEPOINT_CLASS CLASSANDONEORMOREOFTHECATEGORIESIN<catmask> BEINGENABLED

26 4ASK4RACEPOINTS 4ASK4RACEPOINTSAREDISPLAYEDINTHE4IME4RACEVISUALIZERONTHETAPEOFTHE TASKTHATISSUEDTHELogTaskTracepoint ()CALL4ASK4RACEPOINT IDENTIFIERSCANBENAMEDDURINGTHECONFIGURATIONPROCESSAND4IME4RACEWILL DISPLAYTHENAME ORLITERALNUMERICALVALUESCANBEUSEDINSTEAD,OG4ASK4RACEPOINT void LogTaskTracepoint( <TTpointId>, ostracecategoriestype <catmask>) 77SRLQW,G )DENTIFIESA4ASK4RACEPOINTSIZEVARIESqSEE FDWPDVN 4HECATEGORYORCATEGORIESTHATTHIS4ASK4RACEPOINT BELONGSTO,OGS4ASK4RACEPOINT<TTPointID>AGAINSTITS DESIGNATEDTASK,OGGINGISSUBJECTTOTHE TRACE_TASK_TRACEPOINT_CLASSCLASSANDONEOR MOREOFTHECATEGORIESIN<catmask>BEINGENABLED

27 ,OG4ASK4RACEPOINT6ALUE void LogTaskTracepointValue( <TTpointId>, XLQW<val>, ostracecategoriestype <catmask>) 77SRLQW,G )DENTIFIESA4ASK4RACEPOINTSIZEVARIESqSEE YDO.UMERICALVALUETOBESENTWITHTHE4ASK4RACEPOINT4HE SIZEOFVALORBIT DEPENDSUPONTHESIZEOFTHE SYSTEMTIMESELECTEDDURINGCONFIGURATIONqSEETHE24! 42!#%#ONFIGURATION2EFERENCE-ANUALFORFURTHER INFORMATION FDWPDVN 4HECATEGORYORCATEGORIESTHATTHIS4ASK4RACEPOINT BELONGSTO,OGS4ASK4RACEPOINT<TTPointID>AGAINSTITS DESIGNATEDTASKALONGWITHANUNSIGNEDORBIT INTEGERVALUE,OGGINGISSUBJECTTOTHE TRACE_TASK_TRACEPOINT_CLASSCLASSANDONEOR MOREOFTHECATEGORIESIN<catmask>BEINGENABLED

28 ,OG4ASK4RACEPOINT$ATA void LogTaskTracepointData( <TTPointID>, PTR(ByteType) <dataptr>, osuinttype <length>, ostracecategoriestype <catmask>) 773RLQW,' )DENTIFIESA4ASK4RACEPOINTSIZEVARIESqSEE GDWD3WU 0OINTSTOADATABLOCKTOBESENTWITHTHE4ASK4RACEPOINT OHQJWK,ENGTHOFTHEDATABLOCKPOINTEDTOBY<dataPtr>IN BYTES FDWPDVN 4HECATEGORYORCATEGORIESTHATTHIS4RACEPOINTBELONGSTO,OGS4ASK4RACEPOINT<TTPointID>AGAINSTITS DESIGNATEDTASKALONGWITHARBITRARYBINARYDATA,OGGINGISSUBJECTTOTHE TRACE_TASK_TRACEPOINT_CLASSCLASSANDONEOR MOREOFTHECATEGORIESIN<catmask>BEINGENABLED

29 )NTERVALS )NTERVALSPROVIDEAMECHANISMFORUSERSTOMEASUREELAPSEDTIMEBETWEENTWO EVENTS)NTERVALINDICATIONSAPPEARONTHEIROWNTAPESINTHE4IME4RACE VISUALIZER)NTERVALIDENTIFIERSCANBENAMEDDURINGTHECONFIGURATIONPROCESS AND4IME4RACEWILLDISPLAYTHENAME ORLITERALNUMERICALVALUESCANBEUSED INSTEAD,OG)NTERVAL3TART void LogIntervalStart( <intervalid>, ostracecategoriestype <catmask>) LQWHUYDO,G!N)NTERVALIDENTIFIERSIZEVARIESqSEE FDWPDVN 4HECATEGORYORCATEGORIESTHATTHISCALLBELONGSTO 4HISCALLSTARTSTHEINTERVALREFERENCEDBY<intervalId>,OGGINGISSUBJECTTOTHETRACE_INTERVALS_CLASS CLASSANDONEORMOREOFTHECATEGORIESIN<catmask> BEINGENABLED

30 ,OG)NTERVAL3TART6ALUE void LogIntervalStartValue( <intervalid>, XLQW<val>, ostracecategoriestype <catmask>) LQWHUYDO,G!N)NTERVALIDENTIFIERSIZEVARIESqSEE YDO.UMERICALVALUETOBESENTWITHTHE)NTERVALSTART4HESIZE OFVALORBIT DEPENDSUPONTHESIZEOFTHESYSTEM TIMESELECTEDDURINGCONFIGURATIONqSEETHE24!42!#% #ONFIGURATION2EFERENCE-ANUALFORFURTHERINFORMATION FDWPDVN 4HECATEGORYORCATEGORIESTHATTHISCALLBELONGSTO 4HISCALLSTARTSTHEINTERVALREFERENCEDBY<intervalId> ALONGWITHANUNSIGNEDORBITINTEGERVALUE,OGGINGISSUBJECTTOTHETRACE_INTERVALS_CLASS CLASSANDONEORMOREOFTHECATEGORIESIN<catmask> BEINGENABLED

31 ,OG)NTERVAL3TART$ATA void LogIntervalStartData( <intervalid>, PTR(ByteType) <dataptr>, osuinttype <length>, ostracecategoriestype <catmask>) LQWHUYDO,G!N)NTERVALIDENTIFIERSIZEVARIESqSEE GDWD3WU 0OINTSTOADATABLOCKTOBESENTWITHTHEINTERVALSTART OHQJWK,ENGTHOFTHEDATABLOCKPOINTEDTOBY<dataPtr>IN BYTES FDWPDVN 4HECATEGORYORCATEGORIESTHATTHISCALLBELONGSTO 4HISCALLSTARTSTHEINTERVALREFERENCEDBY<intervalId> ALONGWITHARBITRARYBINARYDATA,OGGINGISSUBJECTTOTHETRACE_INTERVALS_CLASS CLASSANDONEORMOREOFTHECATEGORIESIN<catmask> BEINGENABLED,OG)NTERVAL%ND void LogIntervalEnd( <intervalid>, ostracecategoriestype <catmask>) LQWHUYDO,G!N)NTERVALIDENTIFIERSIZEVARIESqSEE FDWPDVN 4HECATEGORYORCATEGORIESTHATTHISCALLBELONGSTO 4HISCALLENDSTHEINTERVALREFERENCEDBY<intervalId>,OGGINGISSUBJECTTOTHETRACE_INTERVALS_CLASS CLASSANDONEORMOREOFTHECATEGORIESIN<catmask> BEINGENABLED

32 ,OG)NTERVAL%ND6ALUE void LogIntervalEndValue( <intervalid>, XLQW<val>, ostracecategoriestype <catmask>) LQWHUYDO,G!N)NTERVALIDENTIFIERSIZEVARIESqSEE YDO.UMERICALVALUETOBESENTWITHTHE)NTERVALEND4HESIZE OFVALORBIT DEPENDSUPONTHESIZEOFTHESYSTEM TIMESELECTEDDURINGCONFIGURATIONqSEETHE24!42!#% #ONFIGURATION2EFERENCE-ANUALFORFURTHERINFORMATION FDWPDVN 4HECATEGORYORCATEGORIESTHATTHISCALLBELONGSTO 4HISCALLENDSTHEINTERVALREFERENCEDBY<intervalId> ALONGWITHANUNSIGNEDORBITINTEGERVALUE,OGGINGISSUBJECTTOTHETRACE_INTERVALS_CLASS CLASSANDONEORMOREOFTHECATEGORIESIN<catmask> BEINGENABLED

33 ,OG)NTERVAL%ND$ATA void LogIntervalEndData( <intervalid>, PTR(ByteType) <dataptr>, osuinttype <length>, ostracecategoriestype <catmask>) LQWHUYDO,G!N)NTERVALIDENTIFIERSIZEVARIESqSEE GDWD3WU!DDRESSOFADATABLOCKTOBESENTWITHTHEINTERVALEND OHQJWK,ENGTHOFTHEDATABLOCKPOINTEDTOBY<dataPtr>IN BYTES FDWPDVN 4HECATEGORYORCATEGORIESTHATTHISCALLBELONGSTO 4HISCALLENDSTHEINTERVALREFERENCEDBY<intervalId> ALONGWITHARBITRARYBINARYDATA,OGGINGISSUBJECTTOTHETRACE_INTERVALS_CLASS CLASSANDONEORMOREOFTHECATEGORIESIN<catmask> BEINGENABLED -ISCELLANEOUS,OGGING,OG0ROFILE3TART void LogProfileStart( ostraceinfotype <profileid>) SURILOH,G!0ROFILEIDENTIFIER 4HISCALLMARKSTHESWITCHOVERTOANEWRUNTIMEPROFILE,OGGINGISSUBJECTTOTHE TRACE_TASKS_AND_ISRS_CLASSCLASS 24!/3%+'ENERIC/3

34 ,OG#RITICAL%XECUTION%ND void LogCriticalExecutionEnd( ostraceinfotype <critexecid>) &ULW([HF,G!#RITICAL%XECUTION0OINTIDENTIFIER 4HISCALLMARKSTHEENDOFACRITICALEXECUTIONSECTION4HIS WILLMOSTOFTENBEUSEDTOOBSERVERESPONSETIMETOSOME STIMULUS,OGGINGISSUBJECTTOTHE TRACE_TASKS_AND_ISRS_CLASSCLASS 24!/3%+'ENERIC/3,OG#AT)323TART void LogCat1ISRStart( ostraceinfotype <IsrId>),VU,G!#ATEGORY)32IDENTIFIER 4HISCALLMARKSTHESTARTOFACATEGORY)324HISTYPEOF )32ISNOTCONTROLLEDBYTHEOPERATINGSYSTEMANDSO REQUIRESMANUALLOGGING,OGGINGISSUBJECTTOTHE TRACE_TASKS_AND_ISRS_CLASSCLASS 24!/3%+

35 ,OG#AT)32%ND void LogCat1ISREnd( ostraceinfotype <IsrId>),VU,G!#ATEGORY)32IDENTIFIER 4HISCALLMARKSTHEENDOFACATEGORY)324HISTYPEOF )32ISNOTCONTROLLEDBYTHEOPERATINGSYSTEMANDSO REQUIRESMANUALLOGGING,OGGINGISSUBJECTTOTHE TRACE_TASKS_AND_ISRS_CLASSCLASS 24!/3%+,OG/VERRUN(OOK void LogOverrunHook().ONE 4HISCALLMARKSTHATTHEOVERRUNHOOKWASCALLED4HISIS CALLEDIFATASKHASRUNFORTOOLONGATITSTERMINATION,OGGINGISSUBJECTTOTHETRACE_ERRORS_CLASSCLASS 24!/3%+ 4RIGGERING #LEAR4RIGGER void ClearTrigger(void).ONE #LEARSTHETRIGGERCONDITIONSOTHATNOTRACERECORDCAN CAUSETRIGGERING )FTHETRIGGERCONDITIONHASOCCURREDEVENTSWILLCONTINUE TOBELOGGED

36 4RIGGER.OW void TriggerNow(void).ONE 4RIGGERNOWREGARDLESSOFTRIGGERCONDITIONS )FTRIGGERCONDITIONSHAVEBEENSETTHISCALLWILLNOTCLEAR THEM

37 3ET4RIGGER7INDOW void SetTriggerWindow( UIntType <before>, UIntType <after>) %HIRUH.UMBEROFRECORDSTOBEUPLOADEDFROMBEFORETHE TRIGGEREVENT $IWHU.UMBEROFRECORDSTOBEUPLOADEDAFTERTHETRIGGEREVENT 3ETSTHENUMBEROFRECORDSPREANDPOSTTRIGGERTHATWILL BEUPLOADED 4HETOTALNUMBEROFRECORDSUPLOADED<before> <after> MUSTBELESSTHANTHETOTALBUFFERSIZE AVAILABLE )FTHETOTALISGREATERTHANTHEBUFFERSIZEAVAILABLE <after>istruncatedsothat<before>willfitqif <before>isgreaterthantheavailablebufferthen <before>issettotheavailablebuffersizeand <after>issettozero.otesinceeachtraceeventmaybecarriedinmultipletrace RECORDSTHENUMBEROFEVENTSBEFOREANDAFTERTHETRIGGER POINTWILLNOTMATCHTHENUMBEROFRECORDSSPECIFIEDINTHIS CALL4RUNCATIONOFTRACEEVENTSMAYOCCURFOREXAMPLEWITH Log Data()CALLS CAUSINGINCOMPLETEDATAORlMISSEDm EVENTS 3MALLVALUESOFAFTERSHOULDBEAVOIDEDCONSIDERUSING StopTrace()WHENTRIGGERINGONTERMINALEVENTSSUCHAS SYSTEMSHUTDOWN

38 4RIGGER/N!CTIVATION void TriggerOnActivation( TaskType <taskid>) WDVN,G )DENTIFIEROFTHETASKTOTRIGGERON 3ETSTHETRIGGERTOBEANATTEMPTTOACTIVATE<taskId> IEANActivateTask(<TaskId>)CALLHASBEEN MADE )F<taskId>ISSETTOOSTRACE_TRIGGER_ANYANYCALL TOActivateTask()WILLTRIGGERTRACING 4HETRIGGERWILLOCCURONEXPLICITTASKACTIVATIONANDON TASKACTIVATIONVIAATIMETABLE)TWILLOCCURONTASK ACTIVATIONVIAANALARMUNLESSLOGGINGOFALARMSIS ENABLED)TWILLNOTOCCURASARESULTOFChainTask() 3EETriggerOnChain() ORACTIVATIONOFATASKSET CONTAININGTASK<taskId>APPLIESTO24!/3%+ONLY 4RIGGER/N#HAIN void TriggerOnChain(TaskType <taskid>) WDVN,G )DENTIFIEROFTHETASKTOTRIGGERON 3ETSTHETRIGGERTOBEANATTEMPTTOCHAINTASK<taskId> IEAChainTask(<TaskId>)CALLHASBEENMADE )F<taskId>ISSETTOOSTRACE_TRIGGER_ANYANYCALL TOChainTask()WILLTRIGGERTRACING 24!/3%+%2#/3 %+

39 4RIGGER/N4ASK3TART void TriggerOnTaskStart( TaskType <taskid>) WDVN,G )DENTIFIEROFTHETASKTOTRIGGERON 3ETSTHETRIGGERTOBETHESTARTOF<taskId>. )F<taskId>ISSETTOOSTRACE_TRIGGER_ANYANYTASK STARTWILLTRIGGERTRACING 4RIGGER/N4ASK3TOP void TriggerOnTaskStop(TaskType <taskid>) WDVN,G )DENTIFIEROFTHETASKTOTRIGGERON 3ETSTHETRIGGERTOBETHEENDOF<taskId>. )F<taskId>ISSETTOOSTRACE_TRIGGER_ANYANYTASK STOPWILLTRIGGERTRACING

40 4RIGGER/N)323TART void TriggerOnISRStart(ISRType <ISRId>),65,G 4HEIDENTIFIEROFTHE)32 3ETSTHETRIGGERTOBETHESTARTOF<ISRId>. )F<ISRId>ISSETTOOSTRACE_TRIGGER_ANYANY)32 STARTWILLTRIGGERTRACING <ISRId> MUSTBETHEIDENTIFIERUSEDDURINGSYSTEM GENERATION %2#/3 %+ 4RIGGER/N)323TOP void TriggerOnISRStop(ISRType <ISRId>),65,G 4HEIDENTIFIEROFTHE)32 3ETSTHETRIGGERTOBETHEENDOF<ISRId> )F<ISRId>ISSETTOOSTRACE_TRIGGER_ANYANY)32 STOPWILLTRIGGERTRACING <ISRId> MUSTBETHEIDENTIFIERUSEDDURINGSYSTEM GENERATION %2#/3 %+

41 4RIGGER/N#AT)323TART void TriggerOnCat1ISRStart( ISRType <ISRId>),65,G 4HEIDENTIFIEROFTHE)32 3ETSTHETRIGGERTOBETHESTARTOF<ISRId>. )F<ISRId>ISSETTOOSTRACE_TRIGGER_ANYTHESTART OFANYCATEGORY)32WILLTRIGGERTRACING <ISRId> MUSTBETHEIDENTIFIERUSEDDURINGSYSTEM GENERATION 24!/3%+ 4RIGGER/N#AT)323TOP void TriggerOnCat1ISRStop( ISRType <ISRId>),65,G 4HEIDENTIFIEROFTHE)32 3ETSTHETRIGGERTOBETHEENDOF<ISRId> )F<ISRId>ISSETTOOSTRACE_TRIGGER_ANYTHESTOP OFANYCATEGORY)32WILLTRIGGERTRACING <ISRId> MUSTBETHEIDENTIFIERUSEDDURINGSYSTEM GENERATION 24!/3%+

42 4RIGGER/N#AT)323TART void TriggerOnCat2ISRStart( ISRType <ISRId>),65,G 4HEIDENTIFIEROFTHE)32 3ETSTHETRIGGERTOBETHESTARTOF<ISRId>. )F<ISRId>ISSETTOOSTRACE_TRIGGER_ANYTHESTART OFANYCATEGORY)32WILLTRIGGERTRACING <ISRId> MUSTBETHEIDENTIFIERUSEDDURINGSYSTEM GENERATION 24!/3%+ 4RIGGER/N#AT)323TOP void TriggerOnCat2ISRStop( ISRType <ISRId>),65,G 4HEIDENTIFIEROFTHE)32 3ETSTHETRIGGERTOBETHEENDOF<ISRId> )F<ISRId>ISSETTOOSTRACE_TRIGGER_ANYTHESTOP OFANYCATEGORY)32WILLTRIGGERTRACING <ISRId> MUSTBETHEIDENTIFIERUSEDDURINGSYSTEM GENERATION 24!/3%+

43 4RIGGER/N)NIT4ASK3TART void TriggerOnInitTaskStart( AppModeType <mode>) PRGH!NAPPLICATIONMODE 3ETSTHETRIGGERTOBETHESTARTOFTHEINITTASKIN APPLICATIONMODE<mode> 4HEINITTASKISRUNWHENAPPLICATIONMODE<mode>IS ENTERED %2#/3 %+ 4RIGGER/N)NIT4ASK3TOP void TriggerOnInitTaskStop( AppModeType <mode>) PRGH!NAPPLICATIONMODE 3ETSTHETRIGGERTOBETHEENDOFTHEINITTASKIN APPLICATIONMODE<mode> 4HEINITTASKISRUNWHENAPPLICATIONMODE<mode>IS ENTERED %2#/3 %+

44 4RIGGER/N'ET2ESOURCE void TriggerOnGetResource( ResourceType <ResourceId>) 5HVRXUFH,G )DENTIFIEROFRESOURCE 3ETSTHETRIGGERTOBEANATTEMPTTOGETTHERESOURCE <ResourceId>IEAGetResource( <ResourceId> )CALLHASBEENMADE )F<ResourceId>ISSETTOOSTRACE_TRIGGER_ANY ANYCALLTOGetResource()WILLTRIGGERTRACING 4RIGGER/N2ELEASE2ESOURCE void TriggerOnReleaseResource( ResourceType <ResourceId>) 5HVRXUFH,G )DENTIFIEROFRESOURCE 3ETSTHETRIGGERTOBEANATTEMPTTORELEASETHERESOURCE <ResourceId>IEAReleaseResource( <ResourceId>)CALLHASBEENMADE )F<ResourceId>ISSETTOOSTRACE_TRIGGER_ANY ANYCALLTOReleaseResource()WILLTRIGGERTRACING

45 4RIGGER/N3ET%VENT void TriggerOnSetEvent ( TaskType <TaskId>) 7DVN,G )DENTIFIEROFTASK 3ETSTHETRIGGERTOBEASetEvent()CALLTARGETINGTHE SPECIFIEDTASK )F<TaskId>ISSETTOOSTRACE_TRIGGER_ANYANYCALL TOSetEvent()WILLTRIGGERTRACING 24!/3%+#USTOM/3.OTEREMEMBERTHATTHISCALLREQUIRESA4ASK)$NOTAN%VENT )$ 4RIGGER/N4RACEPOINT void TriggerOnTracepoint( ostracetracepointtype <point>) SRLQW!4RACEPOINT)$ 3ETSTHETRIGGERTOBETHELOGGINGOF4RACEPOINT<point> )F<point>ISSETTOOSTRACE_TRIGGER_ANYANYCALL TOLogTracepoint ()WILLTRIGGERTRACING

46 4RIGGER/N4ASK4RACEPOINT void TriggerOnTaskTracepoint( ostracetasktracepointtype <point>, TaskType <task>) SRLQW!4ASK4RACEPOINT)$ WDVN!TASK)$ 3ETSTHETRIGGERTOBETHELOGGINGOF4ASK4RACEPOINT <point>fromtasktask )F<task>ISSETTOOSTRACE_TRIGGER_ANYACALLOF LogTaskTracepoint ()FROMANY4ASKWILLTRIGGER TRACING 4RIGGER/N)NTERVAL3TART void TriggerOnIntervalStart( ostraceintervaltype <intervalid>) LQWHUYDO,G!N)NTERVALIDENTIFIER 3ETSTHETRIGGERTOBETHESTARTOFTHEINTERVALREFERENCED BY<intervalId>. )F<intervalId>ISSETTOOSTRACE_TRIGGER_ANY ANYCALLTOLogIntervalStart ()WILLTRIGGERTRACING

47 4RIGGER/N)NTERVAL%ND4RIGGER/N)NTERVAL3TOP void TriggerOnIntervalEnd( ostraceintervaltype <intervalid>) void TriggerOnIntervalStop( ostraceintervaltype <intervalid>) LQWHUYDO,G!N)NTERVALIDENTIFIER 3ETSTHETRIGGERTOBETHEENDOFTHEINTERVALREFERENCEDBY <intervalid>. )F<intervalId>ISSETTOOSTRACE_TRIGGER_ANY ANYCALLTOLogIntervalEnd ()WILLTRIGGERTRACING 4RIGGER/N4IMETABLE%XPIRY void TriggerOnTimetableExpiry( TimeTableType <tt>) WW )DENTIFIEROFTHETIMETABLETOTRIGGERON 3ETSTHETRIGGERTOBETHEEXPIRYOFANYPOINTINTIMETABLE <tt> )F<tt>ISSETTOOSTRACE_TRIGGER_ANYTHEEXPIRYOF ANYPOINTINANYTIMETABLEWILLTRIGGERTRACING %2#/3 %+

48 4RIGGER/N4ICK3CHEDULE void TriggerOnTickSchedule ( ScheduleType <sched>) VFKHG )DENTIFIEROFTHESCHEDULETOTRIGGERON 3ETSTHETRIGGERTOBETHEEXPIRYOFANYPOINTINSCHEDULE <sched> )F<sched>ISSETTOOSTRACE_TRIGGER_ANYTHE EXPIRYOFANYPOINTINANYSCHEDULEWILLTRIGGERTRACING 24!/3%+ 4RIGGER/N!DVANCE3CHEDULE void TriggerOnAdvanceSchedule ( ScheduleType <sched>) VFKHG )DENTIFIEROFTHESCHEDULETOTRIGGERON 3ETSTHETRIGGERTOBETHEEXPIRYOFANYPOINTINSCHEDULE <sched> )F<sched>ISSETTOOSTRACE_TRIGGER_ANYTHE EXPIRYOFANYPOINTINANYADVANCEDSCHEDULEWILLTRIGGER TRACING 24!/3%+

49 4RIGGER/N!LARM%XPIRY void TriggerOnAlarmExpiry( AlarmType <alarm>) DODUP )DENTIFIEROFTHEALARMTOTRIGGERON 3ETSTHETRIGGERTOBETHEEXPIRYOF<alarm> )F<alarm>ISSETTOOSTRACE_TRIGGER_ANYTHE EXPIRYOFANYALARMWILLTRIGGERTRACING 4RIGGER/N%XPLICIT3END3TATE-ESSAGE void TriggerOnExplicitSendStateMessage( STATEMESSAGE <messageid>) PHVVDJH,G )DENTIFIEROFTHESTATEMESSAGETOTRIGGERON 3ETSTHETRIGGERTOBETHESENDINGOFSTATEMESSAGE <messageid> )F<messageId>ISSETTOOSTRACE_TRIGGER_ANY SENDINGANYSTATEMESSAGEWILLTRIGGERTRACING <messageid> MUSTBETHEIDENTIFIERUSEDDURINGSYSTEM GENERATION %2#/3 %+

50 4RIGGER/N%XPLICIT2ECEIVE3TATE-ESSAGE void TriggerOnExplicitReceiveStateMessage( STATEMESSAGE <messageid>) PHVVDJH,G )DENTIFIEROFTHESTATEMESSAGETOTRIGGERON 3ETSTHETRIGGERTOBETHERECEPTIONOFSTATEMESSAGE <messageid> )F<messageId>ISSETTOOSTRACE_TRIGGER_ANY RECEPTIONOFANYSTATEMESSAGEWILLTRIGGERTRACING <messageid> MUSTBETHEIDENTIFIERUSEDDURINGSYSTEM GENERATION %2#/3 %+ 4RIGGER/N3END-ESSAGE void TriggerOnSendMessage( SymbolicName <messname>) PHVV1DPH 3YMBOLICNAMEOFTHE/3%+#/-MESSAGE 3ETSTHETRIGGERTOBETHESENDINGOF/3%+#/-MESSAGE <messname> )F<messName>ISSETTOOSTRACE_TRIGGER_ANY SENDINGOFANY/3%+#/-MESSAGEWILLTRIGGERTRACING SUPPORTING#/- 4HISINCLUDESMESSAGESLOGGEDBYTHE/3INSTRUMENTING KIT

51 4RIGGER/N2ECEIVE-ESSAGE void TriggerOnReceiveMessage( SymbolicName <messname>) PHVV1DPH 3YMBOLICNAMEOFTHE/3%+#/-MESSAGE 3ETSTHETRIGGERTOBETHERECEPTIONOF/3%+#/- MESSAGE<messName> )F<messName>ISSETTOOSTRACE_TRIGGER_ANY RECEPTIONOFANY/3%+#/-MESSAGEWILLTRIGGERTRACING SUPPORTING#/- 4HISINCLUDESMESSAGESLOGGEDBYTHEINSTRUMENTINGKIT 4RIGGER/N%RROR void TriggerOnError(StatusType <err>) HUU %RRORCODE 3ETSTHETRIGGERTOBETHEERROR<err> )F<err>ISSETTOOSTRACE_TRIGGER_ANYGENERATION OFANYERRORWILLTRIGGERTRACING %RRORCODESARELISTEDINTHEDOCUMENTATIONFORTHE PARTICULAR/3INUSE 4RIGGER/N3HUTDOWN void TriggerOnShutdown(StatusType <stat>) VWDW %XITCODE 3ETSTHETRIGGERTOBETHESHUTDOWNOFTHEAPPLICATION

52

53 !0)2ESTRICTIONS )NTRODUCTION 24!42!#%REDEFINESMANY24!/3%+AND%2#/3 %+!0)SYMBOLSASMACROSIN ORDERTOINSTRUMENTTHEOPERATINGSYSTEM)NTHEGREATMAJORITYOFCASESTHIS ISCOMPLETELYTRANSPARENTTOTHEUSER(OWEVERITISPOSSIBLEINRARECASESTO BECAUGHTOUTBYASUBTLEISSUEOUTLINEDHERE 'ENERAL0ROBLEM )NA#definedMACROWITHPARAMETERSIFAFORMALPARAMETERAPPEARSMORE THANONCETHENTHEREAREAFEWPOSSIBLEWRONGORSUBOPTIMALOUTCOMES )FTHESUPPLIEDPARAMETERHASSIDEEFFECTSANDISEVALUATEDMORETHAN ONCETHENTHESIDEEFFECTWILLOCCURMULTIPLETIMESANDMAYCONSTITUTEA BUG )FTHESUPPLIEDPARAMETERISACALLTOAFUNCTIONOFSIGNIFICANTRUNTIMEAND ISEVALUATEDMORETHANONCETHENTHEOVERHEADISMULTIPLIED )FTHEPARAMETERISITSELFAMACROTHENEVENIFITISNOTEVALUATEDMORE THANONCEEGTHEMACROEXPANDSTOANifORswitchSTATEMENT THEN THEREISAMULTIPLYINGOFCODESIZEOVERHEAD &ORTHESEREASONSITISUNDESIRABLEFORAMACROSARGUMENTSTOAPPEARMORE THANONCEINTHEMACROBODY)NSOMECASESHOWEVERITISNOTSENSIBLY AVOIDABLE!PPLICABLE-ACROS%2#/3 %+ 4HEFOLLOWINGIDENTIFIERSEXPANDONEORMOREOFTHEIRARGUMENTSMORETHAN ONCE)NEACHCASETHEREPLICATEDARGUMENTISSHOWNINBOLD ActivateTask(WDVN) GetResource(UHV) ReleaseResource(UHV) ChainTask(WDVN) TriggerOnActivation(WDVN) TriggerOnChain(WDVN) TriggerOnTaskStart(WDVN) TriggerOnTaskStop(WDVN) TriggerOnGetResource(UHV) TriggerOnReleaseResource(UHV) TriggerOnTaskTracepoint(point, WDVN) SendMessage(msg, SRLQWHU) ReceiveMessage(msg, SRLQWHU)!0)2ESTRICTIONS

54 !PPLICABLE-ACROS24!/3%+ 4HEFOLLOWINGIDENTIFIERSEXPANDONEORMOREOFTHEIRARGUMENTSMORETHAN ONCE)NEACHCASETHEREPLICATEDARGUMENTISSHOWNINBOLD ActivateTask(WDVN) ActivateTaskset(WDVNVHW) ChainTask(WDVN) ChainTaskset(WDVNVHW) TickSchedule(VFKHGXOH) AdvanceSchedule(VFKHGXOH, status) SendMessage(PVJ, SRLQWHU) ReceiveMessage(msg, SRLQWHU) GetResource(UHV) ReleaseResource(UHV) SetEvent(task, mask) WaitEvent(PDVN) ClearEvent(PDVN) ShutdownOS(PRGH)!0)2ESTRICTIONS

55 )NDEX # #ATEGORIES #LASSES #LEAR4RIGGER $ $ISABLE4RACE#ATEGORIES $ISABLE4RACE#LASSES % %NABLE4RACE#ATEGORIES %NABLE4RACE#LASSES ) )DENTIFERS,,OG#RITICAL%XECUTION%ND,OG)NTERVAL%ND,OG)NTERVAL%ND$ATA,OG)NTERVAL%ND6ALUE,OG)NTERVAL3TART,OG)NTERVAL3TART$ATA,OG)NTERVAL3TART6ALUE,OG0ROFILE3TART,OG4ASK4RACEPOINT,OG4ASK4RACEPOINT$ATA,OG4ASK4RACEPOINT6ALUE,OG4RACEPOINT,OG4RACEPOINT$ATA,OG4RACEPOINT6ALUE 3 3ET4RACE2EPEAT 3ET4RIGGER7INDOW 3TART"URSTING4RACE 3TART&REE2UNNING4RACE 3TART4RIGGERING4RACE 3TOP4RACE 4 4RIGGER.OW )NDEX

56 4RIGGER/N!CTIVATION 4RIGGER/N!DVANCE3CHEDULE 4RIGGER/N!LARM%XPIRY 4RIGGER/N#HAIN 4RIGGER/N%RROR 4RIGGER/N%XPLICIT2ECEIVE3TATE-ESSAGE 4RIGGER/N%XPLICIT3END3TATE-ESSAGE 4RIGGER/N'ET2ESOURCE 4RIGGER/N)NIT4ASK3TART 4RIGGER/N)NIT4ASK3TOP 4RIGGER/N)NTERVAL3TART 4RIGGER/N)NTERVAL3TOP 4RIGGER/N)323TART 4RIGGER/N)323TOP 4RIGGER/N2ECEIVE-ESSAGE 4RIGGER/N2ELEASE2ESOURCE 4RIGGER/N3END-ESSAGE 4RIGGER/N3ET%VENT 4RIGGER/N4ASK3TART 4RIGGER/N4ASK3TOP 4RIGGER/N4ASK4RACEPOINT 4RIGGER/N4ICK3CHEDULE 4RIGGER/N4IMETABLE%XPIRY 4RIGGER/N4RACEPOINT )NDEX

57 3UPPORT &ORPRODUCTSUPPORTPLEASECONTACTYOURLOCAL%4!3REPRESENTATIVE /FFICELOCATIONSANDCONTACTDETAILSCANBEFOUNDONTHE%4!3'ROUPWEBSITE WWWETASGROUPCOM 3UPPORT