📚 课程目录第4章 HSM固件开发环境搭建

4. HSM固件开发环境搭建：AURIX Development Studio配置、HSM固件工程模板创建、编译器与链接脚本注意事项

好，咱们进入实操环节。前面聊了那么多HSM的理论和架构，现在该动手了。搭建开发环境这事儿，说难不难，说简单吧，坑也不少。我见过不少同事，上来就卡在环境配置上，折腾一两天，心态都崩了。

这一章，我就带你一步步把环境搭起来。咱们用英飞凌官方的AURIX Development Studio（简称ADS），配合HSM固件工程模板，把编译器、链接脚本这些关键点都捋清楚。

4.1 AURIX Development Studio 配置要点

ADS是英飞凌基于Eclipse打造的IDE，免费，功能也够用。我个人习惯用它的原因是：开箱即用，不用像Eclipse那样自己装一堆插件。

4.1.1 下载与安装

去英飞凌官网下载最新版ADS。安装时注意几点：

路径不要有中文和空格。我见过有人装在“D:\程序\ADS”下面，结果编译报错，查了半天是路径问题。
安装时勾选所有组件，尤其是“AURIX MCU Support”和“TASKING Compiler”。
安装完成后，建议重启电脑，让环境变量生效。

4.1.2 工作空间设置

启动ADS后，它会让你选工作空间（Workspace）。我的建议是：

单独建一个文件夹，比如 D:\Workspace\HSM_Project。
不要用默认的 C:\Users\...\workspace，因为有些编译中间文件会占用C盘空间。

4.1.3 导入HSM SDK

英飞凌提供了HSM的SDK，里面包含了驱动、库文件和示例工程。导入步骤：

点击 File → Import → General → Existing Projects into Workspace。
选择SDK解压后的目录，勾选所有工程。
导入后，你会看到类似 HSM_Example_Tricore 和 HSM_Example_SCR 这样的工程。

小提示： 导入后先编译一下示例工程，看看环境是否正常。如果报错，多半是编译器路径没配好。

4.2 HSM固件工程模板创建

示例工程是拿来参考的，真正干活时，你得自己建工程模板。我一般会建两个工程：一个给Tricore主核，一个给SCR（HSM的专用核）。

4.2.1 创建Tricore工程

点击 File → New → AURIX Project。
输入工程名，比如 MyHSM_App_Tricore。
选择芯片型号，比如 TC3xx 系列。
选择编译器为 TASKING。
点击 Finish。

建好后，你会看到一堆自动生成的文件夹。别慌，核心文件就这几个：

文件/文件夹	说明
`Src/`	放你的应用代码，比如 `main.c`
`Lcf_Tasking_Tricore_Tc.lsl`	链接脚本，这个很重要，后面细说
`Config/`	存放MCU配置，比如时钟、中断

4.2.2 创建SCR工程

SCR工程稍微特殊一点，因为它跑在HSM的专用核上，编译器不一样。

点击 File → New → AURIX Project。
工程名比如 MyHSM_App_SCR。
芯片型号同样选 TC3xx。
编译器选 TASKING，但注意：要手动修改编译选项，指定为SCR核。

怎么指定？在工程上右键 → Properties → C/C++ Build → Settings → TASKING C/C++ Compiler → Miscellaneous，在 Other options 里加上 --core=scr。

注意： 如果不加 --core=scr，编译器默认会生成Tricore的指令，SCR核根本跑不了。我曾经有个同事，忘了改这个，调试了一整天，最后发现是编译器选项没改。

4.3 编译器与链接脚本注意事项

这部分是坑最多的地方。编译器选项和链接脚本配不好，轻则编译不过，重则程序跑飞。

4.3.1 编译器选项

除了上面说的 --core=scr，还有几个关键选项：

选项	说明	建议值
`--optimize`	优化等级	调试阶段用 `--no-optimize`，发布用 `-O2`
`--debug`	调试信息	建议开启，方便调试
`--misrac`	MISRA-C检查	HSM固件建议开启，安全要求高
`--no-warnings`	屏蔽警告	不建议用，警告里可能藏着问题

4.3.2 链接脚本（LSL文件）

链接脚本决定了代码和数据怎么放到内存里。HSM固件有两个核，内存分配必须分开。

下面是一个简化的LSL文件片段，展示了如何为SCR核分配内存：

// 定义SCR核的专用内存区域
memory scr_ram
{
    mau = 8;
    size = 64k;
    type = ram;
    map (dest=bus:scr_bus, dest_offset=0x70000000);
}

// 定义SCR核的代码段
section_layout :scr
{
    group scr_code (ordered, contiguous, align=4)
    {
        select "*.text.scr*";
    }
    group scr_data (ordered, contiguous, align=4)
    {
        select "*.data.scr*";
    }
}

这里有几个关键点：

memory scr_ram：定义了一块64KB的RAM，地址从0x70000000开始，这是SCR核的专用内存。
section_layout :scr：指定了SCR核的代码段和数据段。
select "*.text.scr*"：只选择名字里带 scr 的函数，避免把Tricore的代码也链接进来。

    避坑指南： 我曾经犯过一个错，把Tricore和SCR的代码段混在一起了。结果SCR核启动时，执行了Tricore的指令，直接触发Hard Fault。排查了好久才发现是链接脚本的问题。

4.3.3 启动文件与中断向量表

每个核都有自己的启动文件和中断向量表。SCR核的启动文件通常叫 crt0_scr.s，里面做了几件事：

初始化栈指针。
清零BSS段。
拷贝数据段。
跳转到 main 函数。

中断向量表要放在SCR核能访问到的地址。一般放在 0x70000000 开头的位置。在LSL文件里要指定：

// 中断向量表放在SCR RAM的起始位置
section_layout :scr
{
    group scr_vectors (ordered, contiguous, align=256)
    {
        select "*.intvec.scr*";
    }
}

4.4 整体流程梳理

说了这么多，咱们用一张图把整个流程串起来：

4.5 验证环境是否正常

环境搭好了，怎么知道对不对？我的习惯是跑一个最简单的程序：点个灯。

在Tricore工程里写一个GPIO翻转的程序。
在SCR工程里写一个空循环，或者一个简单的状态机。
分别编译两个工程，确保没有错误。
用调试器下载到芯片，观察LED是否按预期闪烁。

如果LED亮了，恭喜你，环境搭好了。如果没亮，别急，按下面几步排查：

检查编译器选项，特别是 --core=scr 有没有加。
检查链接脚本，确认代码段和数据段分配正确。
检查启动文件，看看中断向量表有没有放对位置。

小技巧： 调试时，可以在SCR工程的 main 函数第一行加个死循环，然后用调试器看PC指针是否停在那里。如果停了，说明启动文件和链接脚本没问题。

嗯，环境搭建这部分就这些。说白了，就是三个步骤：装工具、建工程、配脚本。每一步都有坑，但只要你按我说的来，应该能顺利搞定。接下来，你就可以开始写真正的HSM固件代码了。