4、第一个项目：使用ControlDesk创建一个空白项目、添加平台文件、建立与MicroAutoBox的以太网连接

好，咱们正式开始动手了。

前面几章聊了不少概念，什么RTI、DS1006、PHS总线……说实话，光听不练容易犯困。今天咱们就来点实在的——用ControlDesk跑通第一个项目。

这个项目很简单：创建一个空白项目，加载平台文件，然后连上MicroAutoBox。但你别小看这三步。我见过太多新手，第一步就卡在“平台文件是什么”上。嗯，咱们一步步来。

4.1 创建空白项目——别急着点“新建”

打开ControlDesk，你会看到一个启动界面。我个人习惯直接关掉它，因为那个“最近项目”列表往往没啥用。

真正的入口在菜单栏：File → New → Project。

弹出一个对话框，让你填项目名称和保存路径。我建议项目名用英文，别带空格。比如 MyFirstProject。路径也别太深，我吃过这个亏——有一次路径里带了中文，结果加载平台文件时死活报错。后来发现是ControlDesk对Unicode支持不太好。

点击OK，项目就创建好了。你会看到一个空白的项目树，左边是“Project”面板，右边是工作区。嗯，现在它还是个空壳子。

4.2 添加平台文件——这是项目的“身份证”

平台文件（Platform File）是什么？说白了，它就是告诉ControlDesk：你的硬件是什么型号、有几个核心、内存怎么分配的。没有它，ControlDesk就是个瞎子。

添加方法很简单：

1. 在项目树里右键点击 Platform 节点
2. 选择 Add Platform File
3. 浏览到你的平台文件（通常以 .plf 结尾）

加载成功后，项目树里会多出一个平台节点，展开后能看到CPU、内存、I/O接口等信息。这时候你的项目才算有了“灵魂”。

4.3 建立以太网连接——让PC和MicroAutoBox“握手”

平台文件加好了，接下来就是连硬件。MicroAutoBox通常通过以太网和PC通信。你想想看，如果连不上，后面所有的调试都是空谈。

连接步骤：

1. 用网线把MicroAutoBox的以太网口和PC的网口连起来
2. 给MicroAutoBox上电（注意：它需要12V直流电源，别插错）
3. 在ControlDesk里点击 Tools → Communication Settings
4. 在弹出的窗口里，选择 Ethernet 作为通信接口
5. 点击 Scan 按钮，ControlDesk会自动搜索网络里的dSPACE设备

扫描成功后，你会看到设备列表中出现了MicroAutoBox的型号和序列号。选中它，点击 Connect。这时候状态栏会变成绿色，显示“Connected”。

嗯，到这里，你的第一个项目就基本成型了。虽然还没跑任何代码，但至少ControlDesk和硬件已经“认识”了。

4.4 验证连接——别急着高兴

连接成功后，我建议你做一个小验证：在ControlDesk里添加一个虚拟仪表，随便拖一个变量进去，看看能不能读到值。

具体操作：

• 在项目树里右键点击 Instrumentation → New Instrument
• 选择 Numeric Input 或 Gauge
• 在变量列表里找一个系统变量（比如 SystemTime），拖到仪表上

如果仪表能显示数值，说明通信是通的。如果显示“---”或者“NaN”，别慌。我曾经遇到过这种情况，后来发现是平台文件里没有包含系统变量定义。重新加载一次平台文件就好了。

4.5 避坑指南——我踩过的几个坑

最后，分享几个我实际项目中遇到的坑，你遇到了可以少走弯路：

• 网线质量：别用太差的网线。有一次我用了一根老旧网线，连接时断时续，折腾了两天才发现是网线接触不良。
• 防火墙：Windows防火墙可能会拦截ControlDesk的通信。如果你连不上，试试暂时关闭防火墙，或者添加例外规则。
• 多设备冲突：如果你实验室里有多个MicroAutoBox，记得给每个设备设置不同的IP。我曾经遇到过两台设备IP冲突，结果ControlDesk连上了错误的那个，调试了半天才发现。

好了，这一章的内容就到这里。你跟着操作一遍，应该能顺利跑通第一个项目。下一章咱们会往项目里添加真正的控制算法，让MicroAutoBox动起来。