第一章：工作空间与项目创建
各位同学，欢迎来到EB tresos的实战课堂。
我是你们的老朋友，一个在汽车电子圈摸爬滚打了十几年的嵌入式工程师。今天咱们开始第一课：工作空间与项目创建。别小看这一步，我见过太多新手在这里栽跟头，一卡就是半天。
1.1 工作空间（Workspace）的概念与最佳实践
先说说工作空间。说白了，它就是EB tresos用来存放你所有项目配置、生成文件、临时缓存的一个大本营。你可以把它理解成一个“项目收纳盒”。
我个人习惯，每个芯片平台建一个独立的工作空间。比如NXP的S32K系列一个，Infineon的TC3xx系列另一个。为什么？因为不同平台的MCAL版本、配置参数差异很大，混在一起容易出乱子。
工作空间路径绝对不能有中文，也不能有空格。我曾经有个同事，把路径写成“D:\我的项目\EB workspace”，结果编译时死活报错，查了两天才发现是路径里的空格在作祟。记住：全英文、无空格、路径尽量短。
举个例子，我常用的路径格式：
D:\EB_Workspaces\S32K344_MCAL
D:\EB_Workspaces\TC397_MCAL
嗯，这里要注意：路径不要太深。我建议最多三级目录，比如 D:\Workspace\ProjectName 就够了。太深了，有时候生成文件路径超长，Windows会报错。
1.2 创建第一个EB tresos项目（基于MCAL Demo）
好，咱们动手创建一个项目。我以MCAL Demo为例，一步步来。
打开EB tresos，你会看到启动界面。点击“File” -> “New” -> “EB tresos Project”。
这时候会弹出一个对话框，让你选项目模板。我建议新手直接选“MCAL Demo”模板。为什么？因为它自带了一个完整的MCAL配置示例，包括Gpt、Dio、Port、Mcu等基础模块。你不需要从零开始配，省心很多。
创建项目时，勾选“Copy project into workspace”。这样项目文件会复制到工作空间目录下，方便管理。如果不勾选，项目文件还在原位置，万一你移动了工作空间，项目就找不到了。
项目名称我建议用“芯片型号_功能_版本”的格式。比如：
S32K344_MCAL_Demo_V1.0
这样一看就知道是什么芯片、什么用途、哪个版本。我在项目中吃过亏，项目名起得随意，半年后自己都分不清哪个是哪个。
1.3 项目结构解析
项目创建完成后，你会看到左侧的Project Explorer里多了一个项目文件夹。咱们点开看看，里面都有什么。
| 文件夹/文件 | 作用 |
|---|---|
| config | 存放模块的配置描述文件（.arxml），这是核心 |
| generated | EB tresos根据配置自动生成的代码和头文件 |
| modules | 各个MCAL模块的文件夹，里面包含模块的配置插件 |
| output | 编译输出、日志、报告等 |
| .project | Eclipse项目描述文件，不要手动修改 |
咱们重点看三个地方：
模块文件夹（modules）
这里面每个子文件夹对应一个MCAL模块。比如Dio、Port、Mcu等。每个模块文件夹里，通常包含：
- 一个 .jar 文件：模块的配置插件，EB tresos靠它来加载配置界面
- 一些 .xsd 或 .arxml 文件：定义了模块的配置参数结构
你想想看，如果没有这些插件，EB tresos根本不知道Dio模块有哪些参数可以配。所以，模块文件夹是项目的“灵魂”。
生成文件（generated）
这是EB tresos最牛的地方。你配好参数，点一下“Generate Code”，它就能自动生成C代码和头文件。生成的代码通常放在：
generated\src\
generated\include\
我建议你养成习惯：生成代码后，先看一眼生成的 .h 文件，确认配置是否生效。比如你配了Dio通道为输出，生成的代码里就应该有对应的端口初始化函数。如果发现没有，赶紧回头检查配置。
生成的文件不要手动修改！你改了，下次重新生成就会被覆盖。正确的做法是：修改配置描述文件（.arxml），然后重新生成。
配置描述文件（config）
这个文件夹里放的是 .arxml 文件。它是AUTOSAR标准的配置描述文件，记录了所有模块的配置参数。你可以把它理解成“配置的数据库”。
EB tresos启动时，会读取这些 .arxml 文件，加载到内存中，然后你才能在图形界面里看到各种配置项。
我曾经遇到过一个坑：同事把 .arxml 文件手动编辑坏了，结果EB tresos启动时直接崩溃。后来我学乖了，每次修改前先备份一份。嗯，这个习惯救过我好几次。
1.4 避坑指南
最后，我总结几个新手最容易踩的坑：
- 路径问题：工作空间和项目路径都不能有中文和空格。这是EB tresos的硬伤，没得商量。
- 项目模板选择：新手别选“Empty Project”，否则你连Dio模块都要自己手动添加，太折腾。直接用MCAL Demo模板。
- 生成代码后不检查：生成完代码，一定要去 generated 目录看一眼。我见过有人配错了时钟，生成出来的代码里时钟初始化函数是空的，结果芯片跑不起来。
- 手动修改生成文件：记住，生成的文件是“只读”的。要改配置，就去改 .arxml 文件，然后重新生成。
好了，第一章的内容就到这里。工作空间和项目创建是EB tresos的基石，基础打牢了，后面学起来就顺了。下一章咱们聊聊模块配置的通用流程，到时候见。