3. 目标系统数据采集原理
J-Scope 之所以能在目标程序全速运行时“看见”变量，并不是因为它能读懂 C 代码，而是因为它依赖三样东西：变量在 RAM 中真实存在的地址、描述这个地址含义的调试信息，以及 J-Link 通过调试接口直接访问内存的能力。理解这三者的配合关系，是排查“变量采不到、值不对、采样率上不去”等问题的前提。
一、变量在 RAM 中的存储布局
编译链接完成后，每个具有静态存储期的变量都会在 RAM 中获得一个确定的地址。以常见的 Cortex-M 工程为例，链接脚本把 RAM 划分为 .data（已初始化且初值非零的全局/静态变量）、.bss（初值为零的全局/静态变量）、堆（heap）和栈（stack）等区域。启动代码把 .data 的初值从 Flash 拷贝到 RAM，把 .bss 清零，之后这些变量就固定驻留在各自的地址上，直到程序结束。
关键点在于：J-Scope 采集的是内存地址上的原始字节，而不是变量名。例如一个 float g_motorSpeed; 位于地址 0x2000004C，占 4 字节，小端序存储。若当前转速为 1234.5，则这 4 个字节依次为 0x00 0x50 0x9A 0x45。J-Scope 读回这 4 字节后，必须知道“这是 float、小端、从 0x2000004C 开始”，才能还原出 1234.5。因此变量的类型、大小、字节序、地址缺一不可。
还有几类变量需要特别注意：
- 局部变量通常分配在栈上或寄存器中，地址随函数调用变化，甚至根本不落内存，无法稳定采集。要采集应改为
static或全局变量。 - 被编译器优化掉的变量可能不再占用独立内存，调试信息里也找不到它。此时需对该变量加
volatile，或降低优化等级。 - 结构体与数组在内存中连续排布，J-Scope 可以按成员偏移或数组下标定位到具体元素，但需要调试信息提供成员布局。
二、符号表与调试信息的作用
符号表（symbol table）记录“名字 → 地址”的映射，调试信息（DWARF 格式，通常位于 .debug_info、.debug_abbrev 等段）则进一步记录“地址 → 类型、大小、成员偏移、数组维度”的映射。二者合起来，才让 J-Scope 能把一个变量名解析成一段可解释的内存。
在工程配置中，必须保证调试信息被生成并保留：
# GCC 编译与链接示例
CFLAGS += -g3 -gdwarf-4 -O0
LDFLAGS += -Wl,--gc-sections
# 注意：不要 strip 掉 .debug_* 段
# 若使用 -flto，需确认调试信息仍完整如果只保留 .elf 而把调试段裁掉，J-Scope 只能看到地址，无法按变量名和类型解析；如果优化等级过高，变量被合并或消除，符号表里可能根本没有目标变量。因此“能采到”的第一道门槛，是带调试信息、未被过度优化的可执行文件。
.elf（或 .out）文件，而不是 .hex 或 .bin。后两者不含符号与类型信息，无法用于按变量名采集。三、J-Scope 通过 J-Link 读取实时变量的完整链路
J-Link 支持后台内存访问（background memory access）：在 CPU 全速运行、未停机的情况下，调试单元通过 AHB-AP 直接读写目标 RAM。J-Scope 正是利用这一机制，按固定周期读取指定地址区间，而不打断程序执行。
一次典型采集的链路如下：
- J-Scope 解析
.elf，得到目标变量的地址、类型与长度，例如g_motorSpeed @ 0x2000004C, float, 4B。 - 通过 J-Link 建立调试连接，选择 SWD 接口与目标器件（如 Cortex-M4）。
- 按设定采样周期（如 1 ms）发起内存读请求，J-Link 从
0x2000004C读回 4 字节。 - J-Scope 按调试信息中的类型解释字节，还原为 1234.5，并追加到时间序列。
- 数据经 USB 传到 PC，实时绘制波形或导出为 CSV。
采样周期决定了时间分辨率，但实际可达速率受 J-Link 型号、SWD 时钟、变量数量与总字节数共同限制。变量越多、单次读取字节数越大，单周期耗时越长。若发现波形时间轴被拉长或丢点，应先减少同时采集的变量数，再考虑提高 SWD 时钟。
四、采集参数与结果判读
在 J-Scope 中新建工程时，需要选择目标器件、接口（SWD）、速度（如 4000 kHz）以及 .elf 文件。随后在符号浏览器中勾选变量，设置采样周期。以下是一组可用于验证链路的示例配置（属于教学示例，非实测数据）：
| 项目 | 示例值 | 说明 |
|---|---|---|
| 目标器件 | Cortex-M4 | 与 J-Link 连接的目标一致 |
| 接口 / 速度 | SWD / 4000 kHz | 速度过高可能不稳定 |
| 变量 | g_motorSpeed (float) | 地址 0x2000004C，4 字节 |
| 采样周期 | 1 ms | 对应 1 kHz 采样率 |
| 预期结果 | 波形连续、无跳变 | 若丢点则减少变量或降速 |
判读结果时，先看波形是否连续。若出现规律性断点，通常是采样周期小于实际单次读取耗时；若数值明显异常（如恒为 0 或乱跳），应检查变量是否被优化、地址是否随固件更新而变化、类型是否选错（例如把 uint32_t 当成 float 解释）。每次重新编译烧录后，变量地址可能改变，必须重新加载最新的 .elf，否则 J-Scope 会按旧地址读取，得到的是无关内存内容。
.elf 的情况下，用旧工程去读新固件的变量。这两类错误都会表现为“能连上但数据不可信”。把这条链路记牢：变量在 RAM 中有确定地址 → 调试信息把名字和类型绑定到地址 → J-Link 通过后台内存访问读取字节 → J-Scope 按类型还原并绘制。任何一环缺失，采集都会失败或失真。