ModusToolbox 实战入门- 项目配置篇

本文介绍如何对您的项目应用程序进行各种更改，包括：
◍  修改代码
◍  配置器的使用
◍  使用集成终端
◍  刷新快速面板
◍  应用程序重命名
◍  恢复共享目录 

大多数范例代码按原样工作，无需添加或修改代码来构建或编程它们。
但是，如果您想更新和更改应用程序以执行其他操作，或者如果您正在开发自己的应用程序，请在代码编辑器中打开相应的文件。

在 Project Explorer 中，双击 main.c 文件。



Note:  如果范例中显示 “unresolved inclusions” ，可能是文件位于 mtb_shared 文件夹中。 IntelliSense 的这个和其他问题在构建后得到解决。

当您在文件中键入内容时，文件选项卡中将出现一个星号 (*)，表示已进行了更改。 保存/另存为命令也将可供选择。

 

ModusToolbox™ 软件提供称为配置器的图形应用程序，可以更轻松地配置硬件模块。
但是，在对配置器中的设置进行更改之前，应首先将配置信息复制到应用程序并覆盖 BSP 配置或创建自定义 BSP。
如果您对标准 BSP 库进行更改，它将导致 repo 变脏。
此外，如果 BSP 位于共享资产存储库中，则更改将影响使用 BSP 共享的所有应用程序。 有关详细信息，请参阅 ModusToolbox™ user guide。

每个配置器都提供一个单独的指南，可从配置器的帮助菜单中获得。

要从 Eclipse IDE 启动配置器，请在 Project Explorer 中右键单击 <app-name> 项目，选择 ModusToolbox™，然后选择适当的配置器。


Note:  您还可以从快速面板中的链接启动可用的配置器。

根据您的应用程序中启用的资源，可能有多个配置器可供启动。

◍  如果您从 IDE 启动设备配置器，您将打开项目的 design.modus 文件，该文件负责保存所有 BSP 配置信息。 它包含以下内容：

◆  选定的设备

◆  资源参数

◆  约束(Constraints)

◍  如果您从 IDE 启动任何其他配置器，它们将使用该配置器的配置文件（design.cycapsense、design.cyseglcd 等）打开。
   这些文件特定于给定资源，它们可能依赖于 design.modus 文件中的配置数据。

要在不使用 IDE 的情况下启动任何配置器，请参阅适用的配置器指南以获取有关配置信息的详细信息。
您可能需要打开一个配置文件或创建一个新的。
因此较不建议采用此方法。

 

ModusToolbox™ 软件的 Eclipse IDE 包括一个集成终端，您可以在其中为所选项目输入各种命令。
要查看终端，请单击底部窗格中的 Terminal 选项卡。 然后，在 Project Explorer 中选择一个项目，在项目目录中打开一个 shell。

Note:  您可以在 Window > Preferences >Terminal 下为 Workspace 配置终端颜色。

当切换项目时，Eclipse IDE 会创建额外的选项卡并在它们之间自动切换，因此当前项目目录中的 shell 始终处于焦点位置。
要禁用此自动切换，请取消选择终端工具栏中的 “Track Current Project” 按钮。

默认情况下，终端使用您在 Linux 和 macOS 上的登录 shell，或在 Windows 上安装 ModusToolbox™ 工具时提供的 “modus-shell” Cygwin bash shell。
您可以从 Window > Preferences > ModusToolbox™ Tools 中指定不同的 shell。

默认情况下，本地终端使用您的用户主目录作为初始工作目录。
您可以从 Window > Preferences > Local Terminal 指定不同的选项。

您还可以通过单击终端工具栏中的 Open a Terminal 按钮，通过串行、远程登录或 SSH 连接到远程机器或 PCB 板。

 

当使用 Eclipse IDE 外部的工具（例如库管理器或设备配置器）时，Eclipse IDE 很可能不会刷新以检测在这些其他工具中所做的更改。
使用此链接刷新 Eclipse IDE。 可以在快速面板中，发现到新的文档链接或新的 Active BSP，这表明您的应用程序具有新的库和/或组件。

 

ModusToolbox™ 软件的 Eclipse IDE 使用标准的 Eclipse 重命名功能。 也就是说，右键单击应用程序并选择 Rename。
如果您使用重命名功能，您将需要更新应用程序的启动配置。 最简单的方法是使用快速面板中的 “Generate Launches…” 链接。
 

重命名应用程序后，在 Project Explorer 中选择它，注意 Launches 下只有一项。
单击 “Generate Launches for...“ 链接。 片刻之后，生成过程完成。
在 Project Explorer 中再次单击该应用程序，并注意所有项目都显示在 Quick Panel 的 Launches 下。

                  →                   

 

从 ModusToolbox™ 2.2 版本开始，共享 BSP、库和版本位于与您的应用程序目录相邻的共享目录（默认名为 mtb_shared）中。
您可以随时删除 mtb_shared 目录，因为它可以重新创建。
例如，您可以在共享应用程序时这样做。 共享目录仅包含已受控制和版本控制的文件，因此您不应将其检入修订控制系统。

使用 Eclipse IDE 时，如果从磁盘中删除共享库目录，然后重新生成，该目录将无法正常恢复。
这是因为 Eclipse IDE 所需的几个文件没有像创建应用程序时那样恢复。 要解决此问题：
1.  使用 make getlibs 或 Library Manager 在磁盘上重新生成 mtb_shared 目录和各种库。
2.  在 Eclipse IDE 中，删除 Project Explorer 中显示的“mtb_shared”文件夹。

3.  然后，选择 File > Import > C/C++ > Existing Code as Makefile Project 并单击 Next >

4. 在导入现有代码页面:  

a.  在 Existing Code Location 下，单击 Browse…，导航到应用程序的根目录，选择“mtb_shared”文件夹，然后单击 Select Folder。

b.  在 Toolchain for Indexer Settings 下，选择 ARM Cross GCC。

c.  单击 Finish 。

5. 导入完成后，构建应用程序。