Event Recorder  Version 1.0.0
MDK Debugger Views for Status and Event Information
 All Files Functions Macros Groups Pages
/component_viewer/objects/object/.../read

Read values of scalar variables or arrays from target system. A redefinition of a <read> element is not permitted and creates an error.

<read> manages a <member> variable with the following name:

  • [member name]._count — number of element in an array (0 .. n-1).

Refer to Predefined Variables.

Example:

<objects>
<object name="MyObject">
<read name="MySymbol" type="MyType" symbol="mysymbol" const="0"/>
</object>
<object name="Threads">
<read name="main" type="uint8_t" symbol="main" size="64" const="1" />
<read name="szText" type="uint8_t" symbol="szText" size="64" const="1" cond="0" info="ignored because of condition" />
<read name="My_TCB" type="Thread_CB" offset="adr_os_idle_TCB + 4" info="indirect address via offset-expression" />
<list name="Tsk_List">
<read name="cur_tsk" type="uint32_t" symbol="os_tsk" offset="0" info="index current running task" />
<read name="next_tsk" type="uint32_t" symbol="os_tsk" offset="4" info="index task that will run next" />
</list>
<object>
<objects>
Todo:
add example with _count.  
Parent Element Element Chain
object /component_viewer/objects/object
list /component_viewer/objects/object/.../list
Attributes Description Type Use
name Name of variable. Can be used in Expressions. xs:string required
type Can be: xs:string required
size Is an Expressions representing the array size or the number of values to read from target. The maximum array size is limited to 512. Default value is 1. xs:string optional
symbol Enter the symbol name from the target image. Calculates the address. xs:string optional
offset Offset to the symbol address. In case symbol is not specified, then it is the offset to the memory address. Default value is 0. xs:string optional
const Variables with const set to "1" are constants that are read only once after debugger start. Default value is 0. xs:int optional
info Descriptive text with additional information (comment). xs:string optional
cond Conditional execution: element is executed when expression result is not 0. Default value is 1. xs:string optional
endian Endianness for scalar data types. endian="L" — little endian. endian="B" — big endian. Default is automatic. xs:string optional