本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# Texas Instruments CC3220SF-LAUNCHXL 入門
**重要**
此參考整合託管在已棄用的 Amazon-FreeRTOS 儲存庫上。我們建議您在建立新專案時從[這裡開始](freertos-getting-started-modular.md)。如果您已經有以現在已棄用的 Amazon-FreeRTOS 儲存庫為基礎的現有 FreeRTOS 專案，請參閱 [Amazon-FreeRTOS Github 儲存庫遷移指南](github-repo-migration.md)。 FreeRTOS
本教學課程提供 Texas Instruments CC3220SF-LAUNCHXL 入門指示。如果您沒有 Texas Instruments (TI) CC3220SF-LAUNCHXL 開發套件，請造訪 AWS Partner Device Catalog 向[我們的合作夥伴](https://devices.amazonaws.com/detail/a3G0L00000AANtaUAH/SimpleLink-Wi-Fi®-CC3220SF-Wireless-Microcontroller-LaunchPad-Development-Kit)購買。
開始之前，您必須設定 AWS IoT 和 FreeRTOS 下載，將您的裝置 AWS 連線至 雲端。如需說明，請參閱 [首要步驟](freertos-prereqs.md)。在本教學課程中，FreeRTOS 下載目錄的路徑稱為 `freertos`。
## 概觀
本教學課程包含以下入門步驟的指示：
1. 在主機機器上安裝軟體以對微控制器主機板的內嵌應用程式進行開發和除錯。
1. 將 FreeRTOS 示範應用程式跨編譯至二進位映像。
1. 將應用程式二進位映像載入主機板，然後執行應用程式。
## 設定開發環境
請依照下列步驟設定您的開發環境，以開始使用 FreeRTOS。
請注意，FreeRTOS 支援 TI CC3220SF-LAUNCHXL 開發套件的兩個 IDEs：Code Composer Studio 和 IAR Embedded Workbench 8.32 版。您可以使用這兩種 IDE 來開始使用。
### 安裝 Code Composer Studio
1. 瀏覽至 [TI Code Composer Studio](http://processors.wiki.ti.com/index.php/Download_CCS)。
1. 下載適用於主機機器平台 (Windows、macOS 或 Linux 64 位元) 的離線安裝程式。
1. 解壓縮並執行離線安裝程式。依照提示進行。
1. 針對 **Product Families to Install (要安裝的產品系列)**，選擇 **SimpleLink Wi-Fi CC32xx Wireless MCUs (SimpleLink Wi-Fi CC32xx 無線 MCU)**。
1. 在下一個頁面中，接受預設的除錯探查設定，然後選擇 **Finish (完成)**。
如果您在安裝 Code Composer Studio 時遇到問題，請參閱 [TI Development Tools Support](http://software-dl.ti.com/ccs/esd/documents/ccs_support.html)、[Code Composer Studio FAQs](http://processors.wiki.ti.com/index.php/FAQ_-_CCS) 和 [Troubleshooting CCS](http://processors.wiki.ti.com/index.php/Troubleshooting_CCSv7)。
### 安裝 IAR Embedded Workbench
1. 下載並執行 IAR Embedded Workbench for ARM 的 [8.32 版 Windows 安裝程式](http://netstorage.iar.com/SuppDB/Protected/PRODUPD/013570/EWARM-CD-8322-19423.exe)。在 **Debug probe drivers (除錯探查驅動程式)** 中，確認已選取 **TI XDS**。
1. 完成安裝程序，然後啟動程式。在 **License Wizard (授權精靈)** 頁面中，選擇 **Register with IAR Systems to get an evaluation license (註冊 IAR 系統以取得評估授權)** 或使用自己的 IAR 授權。
### 安裝 SimpleLink CC3220 軟體開發套件
安裝 [SimpleLink CC3220 軟體開發套件](http://www.ti.com/tool/SIMPLELINK-CC3220-SDK)。SimpleLink Wi-Fi CC3220 軟體開發套件包含適用於 CC3220SF 可程式化 MCU 的驅動程式、40 多種範例應用程式，以及使用範例所需的文件。
### 安裝 Uniflash
安裝 [Uniflash](http://www.ti.com/tool/UNIFLASH)。CCS Uniflash 是一種獨立工具，可用來對 TI MCU 上的晶片內建快閃記憶體進行程式設計。Uniflash 提供 GUI、命令列和指令碼界面。
### 安裝最新的 Service Pack
1. 在您的 TI CC3220SF-LAUNCHXL 中，將 SOP 跳接器調到中間的 pin (位置 = 1) 上並重設電路板。
1. 啟動 Uniflash。如果 CC3220SF LaunchPad 主機板出現在 **Detected Devices (已偵測的裝置)** 下，請選擇 **Start (開始)**。如果未偵測到您的電路板，請從**新組態**下的電路板清單中選擇 **CC3220SF-LAUNCHXL**，然後選擇**啟動映像建立器**。
1. 選擇**新專案**。
1. 在 **Start new project (開始新專案)** 頁面上，輸入您專案的名稱。針對 **Device Type (裝置類型)**，選擇 **CC3220SF**。針對 **Device Mode (裝置模式)**，選擇 **Develop (開發)**，然後選擇 **Create Project (建立專案)**。
1. 在 Uniflash 應用程式視窗的右側，選擇 **Connect (連線)**。
1. 選擇左側欄中的 **Advanced (進階)**、**Files (檔案)**，然後選擇 **Service Pack (Service Pack)**。
1. 選擇 **Browse (瀏覽)**，然後導覽至您安裝 CC3220SF SimpleLink 軟體開發套件的位置。此服務套件位於 `ti/simplelink_cc32xx_sdk_VERSION/tools/cc32xx_tools/servicepack-cc3x20/sp_VERSION.bin`。
1. 選擇 **Burn (燒錄)** (![\[Feather icon representing a lightweight or simplified feature or concept.\]](http://docs.aws.amazon.com/zh_tw/freertos/latest/userguide/images/flame.png)) 按鈕，然後選擇 **Program Image (Create & Program) (程式映像 (建立與程式設計))** 以安裝服務套件。請記得將 SOP 跳接器切換回位置 0，並重設電路板。
### 設定 Wi-Fi 佈建
若要為您的電路板進行 Wi-Fi 設定，請執行以下其中一項：
+ 設定中所述的 FreeRTOS 示範應用程式[設定 FreeRTOS 示範](freertos-prereqs.md#freertos-configure)。
+ 使用 Texas Instruments 的 [SmartConfig](http://dev.ti.com/tirex/#/?link=Software%2FSimpleLink%20CC32xx%20SDK%2FSimpleLink%20Academy%2FWi-Fi%2FWi-Fi%20Provisioning)。
## 建置並執行 FreeRTOS 示範專案
### 在 TI Code Composer 中建置和執行 FreeRTOS 示範專案
**將 FreeRTOS 示範匯入 TI Code Composer**
1. 開啟 TI Code Composer，然後選擇 **OK (確定)** 以接受預設的工作空間名稱。
1. 在 **Getting Started (入門)** 頁面上，選擇 **Import Project (匯入專案)**。
1. 在 **Select search-directory (選取搜尋目錄)** 中，輸入 `projects/ti/cc3220_launchpad/ccs/aws_demos`。預設應選取 `aws_demos` 專案。若要將專案匯入 TI Code Composer，請選擇 **Finish (完成)**。
1. 在 **Project Explorer (專案瀏覽器)** 中，按兩下 **aws\$1demos** 將專案設為作用中。
1. 從 **Project (專案)** 中，選擇 **Build Project (建置專案)**，以確保專案編譯時不會發生錯誤或警告。
**在 TI Code Composer 中執行 FreeRTOS 示範**
1. 確認 Texas Instruments CC3220SF-LAUNCHXL 的 Sense On Power (SOP) 跳接器位於位置 0。如需詳細資訊，請參閱 [SimpleLink Wi-Fi CC3x20、CC3x3x 網路處理器使用者指南](http://www.ti.com/lit/swru455)。
1. 使用 USB 纜線將 Texas Instruments CC3220SF-LAUNCHXL 接到您的電腦。
1. 在專案資源管理員中，請確定將 `CC3220SF.ccxml` 選取為作用中的目標組態。為了使其為作用中的狀態，請對該檔案按一下滑鼠右鍵，然後選擇 **Set as active target configuration (設為作用中的目標組態)**。
1. 在 TI Code Composer 的 **Run (執行)** 中，選擇 **Debug (除錯)**。
1. 當除錯工具停在 `main()` 中斷點時，請移至 **Run (執行)** 功能表，然後選擇 **Resume (繼續)**。
### 監控雲端的 MQTT 訊息
在執行 FreeRTOS 示範專案之前，您可以在 AWS IoT 主控台中設定 MQTT 用戶端，以監控裝置傳送至 AWS 雲端的訊息。
**使用 MQTT 用戶端訂閱 AWS IoT MQTT 主題**
1. 登入 [AWS IoT 主控台](https://console.aws.amazon.com/iotv2/)。
1. 在導覽窗格中，選擇**測試**，然後選擇 **MQTT 測試用戶端**以開啟 MQTT 用戶端。
1. 在**訂閱主題**中輸入 ***your-thing-name*/example/topic**，然後選擇**訂閱主題**。
當示範專案在您的裝置上成功執行時，您會看到「Hello World！」 多次傳送到您訂閱的主題。
### 在 IAR Embedded Workbench 中建置和執行 FreeRTOS 示範專案
**將 FreeRTOS 示範匯入 IAR Embedded Workbench**
1. 開啟 IAR Embedded Workbench，選擇 **File (檔案)**，然後選擇 **Open Workspace (開啟工作空間)**。
1. 導覽至 `projects/ti/cc3220_launchpad/iar/aws_demos`，並選擇 **aws\$1demos.eww**，然後選擇 **OK (確定)**。
1. 用滑鼠右鍵按一下專案名稱 (`aws_demos`)，然後選擇 **Make (設為)**。
**在 IAR Embedded Workbench 中執行 FreeRTOS 示範**
1. 確認 Texas Instruments CC3220SF-LAUNCHXL 的 Sense On Power (SOP) 跳接器位於位置 0。如需詳細資訊，請參閱 [SimpleLink Wi-Fi CC3x20、CC3x3x 網路處理器使用者指南](http://www.ti.com/lit/swru455)。
1. 使用 USB 纜線將 Texas Instruments CC3220SF-LAUNCHXL 接到您的電腦。
1. 重新組建專案。
若要重建專案，請從 **Project (專案)** 功能表中，選擇 **Make (設為)**。
1. 從 **Project (專案)** 功能表中，選擇 **Download and Debug (下載並除錯)**。如果顯示 "Warning: Failed to initialize EnergyTrace" (警告：無法初始化 EnergyTrace)，您可以將其忽略。如需 EnergyTrace 的詳細資訊，請參閱 [MSP EnergyTrace Technology](http://www.ti.com/tool/energytrace?jktype=recommendedresults)。
1. 當除錯工具停在 `main()` 中斷點時，請移至 **Debug (除錯)** 功能表，然後選擇 **Go (開始)**。
### 搭配 FreeRTOS 使用 CMake
如果您不想使用 IDE 進行 FreeRTOS 開發，您也可以使用 CMake 來建置和執行您使用第三方程式碼編輯器和偵錯工具開發的示範應用程式或應用程式。
**使用 CMake 建置 FreeRTOS 示範**
1. 建立資料夾以包含產生的建置檔案 (*build-folder*)。
1. 請確定您的搜尋路徑 (**\$1PATH** 環境變數) 包含 TI CGT 編譯器二進位檔所在位置的資料夾 (例如 `C:\ti\ccs910\ccs\tools\compiler\ti-cgt-arm_18.12.2.LTS\bin`)。
如果您是搭配 TI ARM 編譯器使用 TI 主機板，請透過下列命令從原始程式碼產生建置檔案：
```
cmake -DVENDOR=ti -DBOARD=cc3220_launchpad -DCOMPILER=arm-ti -S freertos -B build-folder
```
如需詳細資訊，請參閱[搭配 FreeRTOS 使用 CMake](getting-started-cmake.md)。
## 疑難排解
如果您在 AWS IoT 主控台的 MQTT 用戶端中看不到訊息，您可能需要設定主機板的偵錯設定。
**若要為 TI 主機板進行偵錯設定**
1. 在 Code Composer 的 **Project Explorer (專案瀏覽器)** 中，選擇 **aws\$1demos**。
1. 在 **Run (執行)** 選單中，選擇 **Debug Configurations (組態除錯)**。
1. 在導覽窗格中，選擇 **aws\$1demos**。
1. 在 **Target (目標)** 標籤中，選擇 **Connection Options (連線選項)** 下方的 **Reset the target on a connect (重設連線目標)**。
1. 選擇 **Apply** (套用)，然後選擇 **Close** (關閉)。
如果無法使用這些步驟，請查看序列終端機中的程式輸出。您應該會看到一些文字，指出問題來源。
如需 FreeRTOS 入門的一般疑難排解資訊，請參閱 [故障診斷入門](gsg-troubleshooting.md)。