isys::CTraceConfigWizard Class Reference

This class can be used to configure trace in a similar way as it is done via GUI wizard. More...

#include <CTraceConfigWizard.h>

Public Types
enum	EAccessType {   ERead , EWrite ,   EReadWrite }
	Variable access type. More...
enum	EDataWidthType {   EWidthAny , EWidth1 ,   EWidth2 , EWidth4 }
	Data width type. More...
enum	EEdgeType { ERisingEdge , EFallingEdge , EAUXState }
	Edge type for AUX trace trigger. More...
enum	ERecordingContent {   ERecordEverything , ERecordProgramFlow ,   ERecordDataAccess , ERecordInstrumentationMsgs }
	Type of trace recording to perform. More...
enum	ERecordingDuration { EAllTheTime , EBetweenTwoEvents }
	Type of recording duration. More...
enum	ESamplesOffset {   ESamplesBefore , ESamplesAfter ,   ESamplesBeforeAndAfter }
	Type of sampling of additional samples. More...

Public Member Functions
void	setProcess (const std::string &name)
	This method sets process name.
void	setRecordingAttibutes (ESamplesOffset samplesOffsetType, ERecordingDuration recordingDuration)
	This method sets additional recording properties.
void	setRecordingContent (ERecordingContent recType, const std::string &identifierOrStartAddr="", const std::string &identifierOrEndAddr="", EAccessType accessType=EReadWrite)
	If this method is not called, then 'Record Everything' is configured.

Static Public Member Functions
static CTraceConfigWizardSPtr	createCodeExecTrigger (const std::string &funcName)
	This method creates trigger configuration for code execution event.
static CTraceConfigWizardSPtr	createDataAccessTrigger (const std::string &varName, bool isCoverEntireObject, const std::string &endAddress, EAccessType accessType)
	This method creates trigger configuration for data access event.
static CTraceConfigWizardSPtr	createDataAccessTrigger (const std::string &varName, bool isCoverEntireObject, const std::string &endAddress, EAccessType accessType, EDataWidthType dataWidth, DWORD value, DWORD mask)
	This method creates trigger configuration for data access event.
static CTraceConfigWizardSPtr	createImmediateTrigger ()
	This method creates trigger configuration equal to selecting 'Trigger Immediately' radio button in trace wizard GUI.

Detailed Description

This class can be used to configure trace in a similar way as it is done via GUI wizard.

To get instance of this class, use one of the static factory methods.

Python example: test_ctrace_config_wizard.py

Member Enumeration Documentation

EAccessType

enum isys::CTraceConfigWizard::EAccessType

Variable access type.

Enumerator
ERead	read access
EWrite	write access
EReadWrite	read-write access

EDataWidthType

enum isys::CTraceConfigWizard::EDataWidthType

Data width type.

Enumerator
EWidthAny	any width
EWidth1	width of 1 MAU
EWidth2	width of 2 MAUs
EWidth4	width of 4 MAUs

EEdgeType

enum isys::CTraceConfigWizard::EEdgeType

Edge type for AUX trace trigger.

Enumerator
ERisingEdge	rising edge
EFallingEdge	falling edge

ERecordingContent

enum isys::CTraceConfigWizard::ERecordingContent

Type of trace recording to perform.

Enumerator
ERecordEverything	record everything
ERecordProgramFlow	record program flow
ERecordDataAccess	record data access
ERecordInstrumentationMsgs	record instrumentation messages OTM/ITM

ERecordingDuration

enum isys::CTraceConfigWizard::ERecordingDuration

Type of recording duration.

Enumerator
EAllTheTime	record all the time
EBetweenTwoEvents	record between two events

ESamplesOffset

enum isys::CTraceConfigWizard::ESamplesOffset

Type of sampling of additional samples.

Enumerator
ESamplesBefore	record few samples before
ESamplesAfter	record few samples after
ESamplesBeforeAndAfter	record few samples before and after

Member Function Documentation

createCodeExecTrigger()

CTraceConfigWizardSPtr isys::CTraceConfigWizard::createCodeExecTrigger ( const std::string & funcName )

static

This method creates trigger configuration for code execution event.

Parameters

funcName

name of a function or literal address, where execution triggers trace recording

Python example: test_ctrace_config_wizard.py

createDataAccessTrigger() [1/2]

CTraceConfigWizardSPtr isys::CTraceConfigWizard::createDataAccessTrigger ( const std::string & varName, bool isCoverEntireObject, const std::string & endAddress, EAccessType accessType )

static

This method creates trigger configuration for data access event.

Parameters

varName	name of a variable or literal address, where access triggers trace recording
isCoverEntireObject	if true, access to entire object is monitored
endAddress	name of variable or literal address, where monitoring for trigger ends
accessType	type of memory access

createDataAccessTrigger() [2/2]

CTraceConfigWizardSPtr isys::CTraceConfigWizard::createDataAccessTrigger ( const std::string & varName, bool isCoverEntireObject, const std::string & endAddress, EAccessType accessType, EDataWidthType dataWidth, DWORD value, DWORD mask )

static

This method creates trigger configuration for data access event.

Parameters

varName	name of a variable or literal address, where access triggers trace recording
isCoverEntireObject	if true, access to entire object is monitored
endAddress	name of variable or literal address, where monitoring for trigger ends
accessType	type of memory access
dataWidth	data width type
value	value that triggers trace recording
mask	bit mask - 0 ignore, 1 consider

setProcess()

void isys::CTraceConfigWizard::setProcess

(

const std::string &

name

)

This method sets process name.

Parameters

name	process name

setRecordingAttibutes()

void isys::CTraceConfigWizard::setRecordingAttibutes	(	ESamplesOffset	samplesOffsetType,
		ERecordingDuration	recordingDuration )

This method sets additional recording properties.

Parameters

samplesOffsetType	defines any additional samples to record
recordingDuration	defines the recording duration

setRecordingContent()

void isys::CTraceConfigWizard::setRecordingContent	(	ERecordingContent	recType,
		const std::string &	identifierOrStartAddr = "",
		const std::string &	identifierOrEndAddr = "",
		EAccessType	accessType = EReadWrite )

If this method is not called, then 'Record Everything' is configured.

If more detailed configuration is required, call it for each ERecordingContent, which you want to record.

Parameters

recType	if set to ERecordEverything, then all other recording settings are reset. Other function parameters are ignored.
identifierOrStartAddr	name of function or variable (depending on recType), or literal start address of area to trace
identifierOrEndAddr	name of function or variable (depending on recType), or literal end address of area to trace
accessType	memory access type, used only when recType == ERecordDataAccess.