CMSIS-View  
Record program events, display status information, and analyze execution faults
 
Loading...
Searching...
No Matches
/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>