CMSIS-View  
Record program events, display status information, and analyze execution faults
 
Loading...
Searching...
No Matches
/component_viewer/objects/object/.../read

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

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

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

Refer to Predefined variables.

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 Data type read from memory, following types are possible: 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 Symbol name to access memory in the target system which is used to calculate a memory address. xs:string optional
offset Offset to the attribute symbol address. If no attribute symbol is not specified, then it is the memory address. Default value is 0. xs:string optional
const Variables with attribute 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

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>