2. SEGGER Embedded Studio工程创建

在上一节中，我们已经了解了SEGGER工具链的整体构成。本节将进入实际动手环节：使用SEGGER Embedded Studio（以下简称SES）从零创建一个可编译的嵌入式工程。整个过程涉及工程向导的使用、目标器件的选择、编译选项的配置，以及对SES工程目录结构的理解。完成本节后，读者应当能够独立建立一个针对具体芯片型号的可编译工程骨架，并清楚每个配置项的作用。

一、工程创建入口与向导流程

SES启动后，通过菜单栏 File → New Project 进入工程创建向导。向导的第一步是选择工程模板。SES提供了多种模板类型，常见的有：

• Executable：生成可执行文件，适用于大多数裸机或RTOS应用开发。
• Library：生成静态库或动态库，适用于模块化开发。
• External Build：使用外部构建系统（如Makefile），SES仅作为编辑器与调试前端。

对于嵌入式固件开发，通常选择 Executable 模板。向导随后会要求指定目标器件。SES内置了来自各家半导体厂商的器件数据库，涵盖Nordic、ST、NXP、Silicon Labs、Renesas等主流品牌。选择器件时，应准确匹配实际使用的芯片型号，因为器件选择会直接影响后续的启动文件、链接脚本、外设寄存器定义以及调试配置。

以Nordic nRF52840为例，在器件搜索框中输入“nRF52840”，选择对应的具体封装型号（如 nRF52840_xxAA）。SES会自动加载该器件的内存映射、中断向量表和外设定义。如果目标板使用的是自定义硬件，也可以选择“Generic”器件后手动配置内存布局，但这种方式需要额外提供链接脚本和启动代码。

二、编译选项配置

工程创建完成后，需要检查并配置编译选项。在SES中，右键工程节点选择 Options，或通过菜单 Project → Options 打开配置对话框。关键配置项分布在以下几个类别中：

• Code → Compiler：设置优化等级（-O0至-O3或-Os）、C标准版本（C99/C11）、预处理宏定义、头文件搜索路径。调试阶段建议使用-O0或-Og，发布阶段可切换至-Os以减小代码体积。
• Code → Linker：指定链接脚本文件（.ld或.icf）、库搜索路径、附加库文件。SES会根据所选器件自动生成默认链接脚本，但自定义内存布局时需要手动替换。
• Code → Assembler：配置汇编器选项，通常保持默认即可。
• Debug → Debugger：选择调试探针类型（J-Link）、目标接口（SWD/JTAG）、复位方式等。

一个常见的配置示例：在 Preprocessor Definitions 中添加 DEBUG=1 和 NRF52840_XXAA，在 Include Directories 中添加 $(ProjectDir)/inc 和 $(ProjectDir)/config。这些宏和路径会在编译时被展开，影响条件编译和头文件查找。

三、工程目录结构解析

创建完成后，SES会在磁盘上生成一套标准的工程目录。理解这些目录的用途，有助于后续的代码组织和版本管理。典型的目录结构如下：

MyProject/
├── MyProject.emProject        # SES工程文件（XML格式）
├── MyProject.emSession        # 调试会话配置
├── src/
│   ├── main.c                 # 用户主程序入口
│   └── ...
├── inc/
│   └── ...
├── config/
│   ├── sdk_config.h           # SDK配置头文件
│   └── ...
├── linker/
│   └── nrf52840_xxAA.ld       # 链接脚本
├── startup/
│   └── startup_nrf52840.s     # 启动汇编文件
└── Output/
    └── Debug/
        ├── MyProject.elf      # 可执行文件（含调试信息）
        ├── MyProject.hex      # Intel HEX格式烧录文件
        └── MyProject.map      # 链接映射文件

其中，.emProject 文件是SES的核心工程描述文件，采用XML格式，记录了源文件列表、编译选项、调试配置等全部信息。该文件应当纳入版本控制。Output 目录存放编译产物，通常不需要提交到代码仓库。linker 目录中的链接脚本定义了Flash和RAM的地址范围、段布局以及堆栈大小，是工程能否正确运行的关键文件之一。

四、编译与结果验证

配置完成后，通过 Build → Build Solution（快捷键F7）触发编译。SES会依次调用编译器、汇编器和链接器。编译成功后，在 Output/Debug 目录下会生成 .elf 和 .hex 文件。此时可以观察 Build 窗口的输出信息，确认没有错误和警告。

为了验证工程确实可编译且链接正确，可以检查 .map 文件中的内存占用情况。例如，一个简单的LED闪烁程序在nRF52840上编译后，.text 段可能占用约8KB Flash，.data 和 .bss 段合计占用约2KB RAM。这些数值会因优化等级和SDK配置不同而变化，但可以作为判断链接脚本是否合理的参考。

上图展示了从新建工程到编译产出的完整链路，以及工程目录中各个文件夹的层级关系。左侧的目录树对应磁盘上的实际结构，右侧的步骤框对应SES中的操作顺序。两者结合，可以帮助读者建立“操作—配置—文件”之间的对应关系。

五、常见问题与检查要点

在首次创建工程时，容易遇到以下几类问题：

• 器件型号不匹配：如果选择的器件型号与实际芯片的Flash/RAM大小不一致，链接阶段可能报“region overflow”错误。此时应核对数据手册中的内存规格，或改用自定义链接脚本。
• 头文件路径缺失：编译时报“cannot open source file”，通常是因为 Include Directories 中未添加SDK或用户头文件所在目录。SES支持 $(ProjectDir) 等宏变量，建议使用相对路径以提高工程可移植性。
• 启动文件未加入编译：如果工程中没有包含 startup_*.s 文件，链接时会缺少复位向量，导致程序无法启动。应在工程树中确认启动文件已添加到 Source Files 分组。
• 调试配置未指定J-Link：如果 Debug → Debugger 中未选择J-Link，调试会话无法建立。应确认探针型号与目标接口（SWD）设置正确。