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. 導入完成後，構建應用程序。