按变量名查询变量地址与内容
read_variableReads a variable's memory address and current value by name, supports arrays and relocation offsets. Falls back to .axf symbol table + read_mem when standard read fails.
Instructions
按变量名查询变量的内存地址与当前内容（值），支持数组等类型。内部用 '&变量名' 取地址、'变量名' 取值、'sizeof(变量名)' 取大小，AI 无需手写取地址表达式即可定位变量。name 为变量名（如 'SData_UA'、'timer.sec'、'arr'）；count 可选：>0 时按数组逐元素读 name[0..count-1] 返回 elements；返回 {address, value, value_type, size_bytes, elements, memory_hex}。读 App 侧变量（运行期重定位过）时传 reloc_delta="0xF000"，或先调 set_reloc_delta 设一次全局偏移：工具会把符号的链接地址 + 偏移当作运行地址去读，返回 link_address / run_address，不必再手工换算（此时 value 按小端整数解析内存，浮点看 value_as_float）。符号解析双轨（批次48）：Keil 表达式这条路读不到时（static 变量、符号漂移、停在不相关位置），会自动改走 .axf 符号表地址 + read_mem 兜底，返回 fallback=".axf 符号表 + read_mem" 与 fallback_reason 说明为什么换了轨道；两条都不通就如实报错，不会给一个像样的假值。若返回 value_suspect/value_warning（读回整帧全 0x00/全 0xFF），不要据此判定「变量被清零」——先用 reloc_check 校验 reloc_delta 是否与实际布局相符。适合先查地址/数组内容，再配合 read_mem/write_mem 进一步读写。注意：需目标暂停（运行中读取会失败/错位）；依赖 .axf 调试符号。刚停止瞬间取值可能读到脏值。 【参数】必填: name；可选: count, read_memory, reloc_delta 【调用示例】{"name": "SData_UA"} 【参数别名】name ← arr/expression/func/function/keyword/location/pattern/query/symbol/target/var/variable/varname；count ← items/length/n/num。规范名以上方【参数】行为准；未列出的参数名会被拒绝，不会静默忽略
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| count | No | ||
| read_memory | No | ||
| reloc_delta | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |