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 |
Use different output formats for single line output lines. See Dynamic output formats. | PrintType | 0..* |
Example: