S32K3 CMake Helper
将 S32DS (S32K3xx / 314 系列) 工程迁移为 CMake 构建，并自动对齐到字节级一致。
扩展在 VS Code 左侧活动栏提供 S32K3 Build 入口，支持：导入 S32DS 工程、配置/构建、与 S32DS 参考 .srec 字节级比对、查看迁移指南。
1. 适用对象（通用化 314 系列）
- NXP S32K3xx 系列（S32K312 / S32K314 / S32K324 / S32K344 等），S32DS 3.x + GCC 10.2 for Arm 32-bit Bare-Metal。
- 任何使用 S32DS “生成式 make” 的工程（构建输出目录下含
makefile / sources.mk / subdir.mk / *.args）。
本扩展不解析 .cproject XML（结构脆弱、随版本易变），而是直接消费 S32DS 已生成的 make 系统文件——这是 K3 系列统一的构建产物，天然跨型号通用。
2. 信息源优先级
| 文件 |
提取内容 |
makefile |
链接命令 @X.args、artifact 名、-T 链接脚本 |
X.args（链接响应文件） |
OBJS 完整顺序 + 全部链接选项（-T/-L/-n/--gc-sections/-specs/库/mcpu） |
<src>.args（编译响应文件） |
每个 .c 的完整编译选项（宏 / -I / -O / -g / sections / specs） |
subdir.mk（C_SRCS +=） |
实际参与编译的源集合（已含排除规则） |
sources.mk（SUBDIRS） |
目录顺序 |
经验：直接读取 *.args 比反推 .cproject 更可靠，且天然适配不同型号/配置。
3. 必须对齐的编译选项
-O0 -g3（Debug）/ -O2 -g（Release）-ffunction-sections -fdata-sections-mcpu=cortex-m7 -mfloat-abi=hard -mfpu=fpv5-sp-d16
（-mthumb 链接时一般不影响产物，编译时必需）- 宏定义（约 9 个，含
_lint、S32K314 等，逐工程不同）
- 全部
-I include 路径（映射到相对工程根）
--specs=nosys.specs（newlib_noio），不是 nano！（nano 会改变链接产物）
4. 字节级一致的两个真正根因（本次实战结论）
- OBJS 链接顺序：S32DS 的链接顺序 =
sources.mk 的 SUBDIRS 顺序 + 目录内字母序（且 Startup_Code/*.o 在最前）。
CMake file(GLOB) 的字母序与之不同 → 段布局微移 → .data 中指向这些符号的指针常量初始化值随之变化。
解决：在 CMake 中读取 S32DS 的链接 args，按其 .o 顺序重排源文件。
-Wl,-n（--nmagic，禁止段页面对齐）：遗漏它会导致段间填充/对齐差异（本项目曾差 8 字节 text）。
只要编译/链接选项 + 上面两点对齐，重新编译出的每个 .o 与 S32DS 逐字节相同（除调试信息里的源路径），.srec 数据段即 100% 一致。
5. 验证方法
arm-none-eabi-size 对比 text/data/bss（应完全相同）。arm-none-eabi-nm 按符号名排序对比（应 0 差异）→ 证明源码集与编译选项一致。- 逐行 diff
.srec：唯一合理差异是 S0 头记录（objcopy 写入的文件名/路径元数据），不影响烧录。
- 若要 S0 也一致：让产物名 = S32DS artifact 名，或额外生成一份同名
.srec。
6. 扩展用法
- 点击左侧活动栏 S32K3 Build 图标。
- Import S32DS Project：选择 S32DS 工程根（含
src/ 与 Project_Settings/ 的目录）。
扩展会自动扫描其下 makefile、链接/编译 *.args、subdir.mk，生成：
CMakeLists.txt（内置“按 S32DS 链接顺序重排源文件”逻辑）cmake/s32ds_link_order.args（缓存的链接顺序，供排序使用）cmake/gen_srec.cmake（ELF→SREC 后处理脚本）
- Configure / Build：调用本机
cmake 完成配置与构建。
- Compare SREC with S32DS：选择 S32DS 生成的参考
.srec，自动做 size + 逐行比对，输出段大小、差异行数、S0 头提示。
- Migration & Byte-Exact Guide：在 Webview 中查看本指南。
7. 前提依赖
- 本机已安装
cmake 与 arm-none-eabi-gcc（建议与 S32DS 自带版本一致：GCC 10.2 for Arm 32-bit Bare-Metal）。
- 首次使用前执行
npm install 然后 npm run compile（或按 F5 在扩展开发宿主中调试）。
| |
