/component_viewer/events/event

Define an event that can occur for the software component. The attributes property and value can consist of ASCII characters and format specifiers.

Parent Element	Element Chain
events	/component_viewer/events
Attributes	Description	Type	Use
id	16-bit event id (message and component number) value. See Theory of operation.	xs:anySimpleType	required
level	Event severance level (OP, API, Error, Detail) used for filtering. See Theory of operation.	xs:anySimpleType	required
property	Value output shown in the Event Property column of the Event Recorder window.	xs:string	required
value	Value output shown in the Value column of the Event Recorder window.	xs:anySimpleType	optional
info	Descriptive text with additional information (comment).	xs:string	optional
doc	Explicit link to documentation.	xs:string	optional
handle	Specifies the value that identifies the object handle and is used to associated the state information. This refers for example a RTOS thread or IP socket.	xs:string	optional
hname	Specifies a human readable name that represents the handle. This could be a thread name or a file name. A name can referenced in two different ways:   hname="N[val]" val is the pointer value that addresses a const string in the address space of the target.   hname="S[val]" val is the address of a symbol name (for example a function) in a loaded ELF image.	xs:string	optional
state	Reference to a state name in the element state. When state is specified, a handle value is required.	xs:string	optional
tracking	Specifies the tracking for an event handle wiht the values:   tracking="Start"; start the state tracking for an event handle.   tracking="Stop"; stop the state tracking for an event handle.   tracking="Reset"; initialize the tracking for all event handles of that component to "Stop".	xs:string	optional
Child Element	Description	Type	Occurrence
print	Use different output formats for single line output lines. See Dynamic output formats.	PrintType	0..*

Example:

<events>
  :
  :
    <event id="0xA00" level="API"   property="InitEntry"                             info="Event on MyComp_initialize start"/>
    <event id="0xA01" level="API"   property="InitStatus"                            info="Event on MyComp_initialize return"/>
    <event id="0xA0A" level="Error" property="SendNoData"                            info="Event on MyComp_initialize return"/>
    <event id="0xA0B" level="Op"    property="SendComplete"    value="size=%d[val1]" info="Event on MyComp_send - completed"/>
    <event id="0xA0C" level="Error" property="SendFailed"      value=""              info="Event on MyComp_send - send failed"/>
    <event id="0xA15" level="Error" property="ReceiveNoData"   value=""              info="Event on MyComp_receive - no data received"/>
    <event id="0xA16" level="Op"    property="ReceiveComplete" value="size=%d[val1]" info="Event on MyComp_receive - completed"/>
    <event id="0xA17" level="Error" property="ReceiveFailed"   value=""              info="Event on MyComp_receive - receive failed"/>
</events>