第二章 创建与管理项目：新建项目、配置平台文件、添加实验、保存与加载项目结构
好，咱们正式开始动手了。这一章我带你走一遍ControlDesk项目的完整生命周期——从新建一个空项目，到配置好平台文件，再到添加实验，最后把整个结构保存下来。说白了，就是让你知道一个项目从零到一该怎么搭起来。
我刚开始用ControlDesk的时候，其实也踩过不少坑。比如项目建好了，平台文件配错了，结果实验跑不起来，折腾了半天才发现是硬件映射没对上。嗯，这些经验我都会在下面一一告诉你。
2.1 新建项目——别小看这一步
打开ControlDesk，你会看到一个启动界面。点那个“New Project”按钮，或者从菜单栏选File → New → Project。这时候会弹出一个对话框，让你填项目名称和存储路径。
我个人习惯把项目名写得有辨识度一点。比如“BMS_Calibration_V2.1”而不是“test123”。为什么？因为项目多了以后，你根本记不清哪个是哪个。我曾经在一个项目文件夹里翻出过七八个“final_final”版本，别提多崩溃了。
填好之后点“OK”，ControlDesk会自动生成一个项目文件（.cdproj）和一个项目文件夹。这个文件夹里会包含一些初始配置，比如默认的布局文件、变量列表等等。你不用管它们，后面我们会一步步往里加东西。
2.2 配置平台文件——项目的“骨架”
项目建好了，接下来要告诉ControlDesk：你连的是什么硬件？用的是哪个编译器？变量怎么映射？这些信息都写在平台文件（Platform File）里。
平台文件的后缀通常是.plx。你可以从模板创建，也可以导入已有的。我个人建议从模板开始，因为手动写容易漏掉关键参数。
操作路径：File → New → Platform File。然后选择你的硬件平台类型。比如你用的是DS1006处理器板，就选对应的模板。ControlDesk会帮你生成一个初始的.plx文件，里面包含了处理器类型、内存映射、通信接口等基本信息。
这里有个关键点：平台文件里要指定变量描述文件（.a2l或.sdf）。这个文件定义了所有可访问的变量、它们的地址、数据类型和单位。没有这个文件，ControlDesk就不知道你那些变量到底对应硬件上的哪个位置。
配置好之后，记得点一下“Verify”按钮。ControlDesk会检查平台文件有没有语法错误或者缺失的引用。嗯，这一步别偷懒，我每次都会跑一遍。
2.3 添加实验——让项目“活”起来
平台文件配好了，接下来就是添加实验（Experiment）。实验是ControlDesk里最核心的概念——它定义了你监控哪些变量、用什么控件显示、以及怎么操作。
添加实验有两种方式：
- 新建空白实验：右键项目树里的“Experiments”文件夹，选“New Experiment”。然后你会看到一个空白的布局画布，可以往上面拖拽控件。
- 从模板创建：ControlDesk自带了一些实验模板，比如“Basic Monitoring”、“Calibration Dashboard”等。选一个接近你需求的模板，再微调，能省不少时间。
我个人习惯先用模板快速搭一个雏形，然后再根据实际需求调整。比如做电机控制标定时，我会选“Calibration Dashboard”模板，它已经包含了二维表格和曲线图，省得我从零开始画。
添加实验时，ControlDesk会问你关联哪个平台文件。这里要选对，不然变量映射会乱。我建议一个项目只用一个平台文件，除非你有特殊需求（比如同时连多个硬件）。
2.4 保存与加载项目结构——别让努力白费
项目做到一半，记得保存。ControlDesk的保存逻辑有点特别：它会把项目文件（.cdproj）、平台文件（.plx）、实验文件（.cdx）分开保存。你点“Save All”或者快捷键Ctrl+Shift+S，它会一次性保存所有相关文件。
加载项目就更简单了：直接双击.cdproj文件，或者从ControlDesk里选File → Open Project。它会自动加载关联的平台文件和实验文件。但有个坑——如果平台文件或实验文件的路径变了，ControlDesk会报错，让你手动定位。
我建议你把所有文件都放在项目文件夹内，用相对路径引用。这样项目整体拷贝到别的电脑上，路径不会乱。我曾经把项目从台式机拷到笔记本上，结果因为路径不一致，折腾了半小时才把实验重新连上。
| 文件类型 | 后缀 | 作用 | 保存方式 |
|---|---|---|---|
| 项目文件 | .cdproj | 定义项目结构、引用关系 | 手动保存 |
| 平台文件 | .plx | 硬件配置、变量映射 | 手动保存 |
| 实验文件 | .cdx | 布局、控件、变量绑定 | 手动保存 |
| 变量描述文件 | .a2l / .sdf | 变量定义、地址、单位 | 由其他工具生成 |
2.5 避坑指南——我踩过的那些坑
最后，分享几个我实际项目中遇到的坑，希望能帮你少走弯路。
- 路径问题：我曾经把项目放在桌面，结果系统重装后全没了。现在我都用专门的盘符（比如D:\Projects）来存，定期备份。
- 平台文件版本：ControlDesk不同版本对.plx文件的兼容性不一样。如果你从旧版本迁移项目，记得检查平台文件是否需要升级。我遇到过.plx文件在新版ControlDesk里打不开的情况，最后只能手动重建。
- 实验文件太大：如果你在实验里放了大量控件（比如几百个显示仪表），文件会变得很大，加载也慢。我建议把功能拆分成多个实验，每个实验专注一个子系统。比如一个实验管电机控制，另一个管电池管理。
- 变量名冲突：不同模块里可能有同名变量（比如“temp”）。在.a2l文件里要确保变量名唯一，否则ControlDesk会混淆。我习惯在变量名前加模块前缀，比如“Motor_Temp”、“BMS_Temp”。
好了，这一章的内容就到这里。你学会了新建项目、配置平台文件、添加实验，以及保存和加载项目结构。下一章我们会深入实验布局，教你如何用控件把变量可视化。到时候见。