本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 德州仪器 CC322 0SF-LAUNCHXL 入门
**重要**
该参考集成托管在已弃用的 Amazon-FreeRTOS 存储库中。当您创建新项目时，我们建议[从此处开始](freertos-getting-started-modular.md)。如果您已经有一个基于现已弃用的 Amazon-FreeRTOS 存储库的 FreeRTOS 项目，请参阅 [Amazon-FreeRTOS Github 存储库迁移指南](github-repo-migration.md)。
本教程提供了德州仪器 CC322 0SF-LAUNCHXL 入门指南。[如果您没有德州仪器 (TI) CC322 0SF-LAUNCHXL 开发套件，请访问Amazon合作伙伴设备目录从我们的合作伙伴处购买。](https://devices.amazonaws.com/detail/a3G0L00000AANtaUAH/SimpleLink-Wi-Fi®-CC3220SF-Wireless-Microcontroller-LaunchPad-Development-Kit)
在开始之前，您必须进行配置Amazon IoT并下载 FreeRTOS 才能将您的设备连接到云端。Amazon有关说明，请参阅[初始步骤](freertos-prereqs.md)：在本教程中，FreeRTOS 下载目录的路径称为 `freertos`。
## 概述
本教程包含有关以下入门步骤的说明：
1. 在主机上安装软件来开发和调试微控制器主板的嵌入式应用程序。
1. 将 FreeRTOS 演示应用程序交叉编译为二进制映像。
1. 将应用程序二进制映像加载到您的主板上，然后运行该应用程序。
## 设置开发环境
按照以下步骤设置您的开发环境，以便开始使用 FreeRTOS。
请注意，FreeRTOS 支持 IDEs 两个 T CC322 I 0SF-LAUNCHXL 开发套件：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. **要安装产品系列，请**选择 **SimpleLink Wi-Fi CC32xx 无线 MCUs**。
1. 在下一页上，接受调试探测器的默认设置，然后选择 **Finish (完成)**。
如果您在安装 Code Composer Studio 时遇到问题，请参阅 [TI 开发工具支持](http://software-dl.ti.com/ccs/esd/documents/ccs_support.html)、C [ode Composer Studio FAQs](http://processors.wiki.ti.com/index.php/FAQ_-_CCS) 和 [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 CC322 0 软件开发工具包
安装 [SimpleLink CC3220 软件开发工具包](http://www.ti.com/tool/SIMPLELINK-CC3220-SDK)。 SimpleLink Wi-Fi CC322 0 SDK 包含 CC322 0SF 可编程 MCU 的驱动程序、40 多个示例应用程序以及使用示例所需的文档。
### 安装 Uniflash
安装 [Uniflash](http://www.ti.com/tool/UNIFLASH)。CCS Uniflash 是一款用于在 TI 上对片上闪存进行编程的独立工具。 MCUsUniflash 具有一个 GUI、命令行和脚本编写界面。
### 安装最新的 Service Pack
1. 在 TI CC322 0SF-LAUNCHXL 上，将 SOP 跳线放在中间的一组引脚（位置 = 1）上，然后重置电路板。
1. 启动 Uniflash。如果您的 CC322 0SF 看 LaunchPad 板出现在 “**检测到的设备**” 下，请选择 “**开始**”。**如果未检测到您的主板，请从 “**新配置**” 下的看板列表中选择 **CC3220SF-LAUNCHXL，然后选择 “启动**图像创建器”。**
1. 选择**新项目**。
1. 在 **Start new project (启动新项目)** 页面上，输入项目名称。对于 “**设备类型**”，选择 **CC3220SF**。对于 **Device Mode (设备模式)**，选择 **Develop (开发)**，然后选择 **Create Project (创建项目)**。
1. 在 Uniflash 应用程序窗口的右侧，选择 **Connect (连接)**。
1. 从左栏中，选择 **Advanced (高级)**、**Files (文件)**，然后选择 **Service Pack**。
1. 选择 “**浏览**”，然后导航到您安装了 CC322 0 SimpleLink SF SDK 的位置。Service Pack 位于 `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.amazonaws.cn/freertos/latest/userguide/images/flame.png)) 按钮，然后选择 **Program Image (Create & Program) (编程映像(创建并编程))** 来安装 Service Pack。请记住将 SOP 跳线切换回位置 0 并重置主板。
### 配置 Wi-Fi 预置
要为您的主板配置 Wi-Fi 设置，请执行以下操作之一：
+ 按[配置 FreeRTOS 演示](freertos-prereqs.md#freertos-configure)中所述配置 FreeRTOS 演示应用程序。
+ 使用德[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. 从**项目**中，选择**生成项目**以确保项目成功编译，没有错误或警报。
**在 TI Code Composer 中运行 FreeRTOS 演示**
1. 确保德州仪器 CC322 0SF-LAUNCHXL 上的 Sense On Power (SOP) 跳线位于位置 0。有关更多信息，请参阅《[ CC3x3x 网络处理器用户指南》中的 SimpleLink Wi-Fi CC3x2 0](http://www.ti.com/lit/swru455)。
1. 使用 USB 电缆将德州仪器 CC322 0SF-LAUNCHXL 连接到计算机。
1. 在项目资源管理器中，确保已选择 `CC3220SF.ccxml` 作为活动的目标配置。要使其成为活动状态，请右键单击该文件并选择 **Set as active target configuration (设置为活动的目标配置)**。
1. 在 TI Code Composer 的 **Run (运行)** 中，选择 **Debug (调试)**。
1. 当调试器在 `main()` 中的断点停止时，转到 **Run (运行)** 菜单，然后选择 **Resume (恢复)**。
### 在云上监控 MQTT 消息
在运行 FreeRTOS 演示项目之前，您可以在控制台中Amazon IoT设置 MQTT 客户端，以监控您的设备发送到云端的消息。Amazon
**使用 MQTT 客户端订阅 M Amazon IoT QTT 主题**
1. 登录 [Amazon IoT 控制台](https://console.amazonaws.cn/iotv2/)。
1. 在导航窗格中选择**测试**，然后选择 **MQTT 测试客户端**，以便打开 MQTT 客户端。
1. 在 **Subscription topic (订阅主题)**中，输入 ***your-thing-name*/example/topic**，然后选择 **Subscribe to 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. 确保德州仪器 CC322 0SF-LAUNCHXL 上的 Sense On Power (SOP) 跳线位于位置 0。有关更多信息，请参阅《[ CC3x3x 网络处理器用户指南》中的 SimpleLink Wi-Fi CC3x2 0](http://www.ti.com/lit/swru455)。
1. 使用 USB 电缆将德州仪器 CC322 0SF-LAUNCHXL 连接到计算机。
1. 重新生成您的项目。
要重新生成项目，请从 **Project (项目)** 菜单，选择 **Make (生成)**。
1. 从 **Project (项目)** 菜单，选择 **Download and Debug (下载并调试)**。如果显示 “警告：初始化失败” EnergyTrace，则可以将其忽略。有关的更多信息 EnergyTrace，请参阅 [MSP EnergyTrace 技术](http://www.ti.com/tool/energytrace?jktype=recommendedresults)。
1. 当调试器在 `main()` 中的断点停止时，转到 **Debug (调试)** 菜单，然后选择 **Go (执行)**。
### CMake 与 FreeRTOS 一起使用
如果您不想使用 IDE 进行 FreeRTOS 开发，也可以 CMake 使用来生成和运行使用第三方代码编辑器和调试工具开发的演示应用程序或应用程序。
**要使用构建 FreeRTOS 演示 CMake**
1. 创建一个包含生成的构建文件的文件夹 (*build-folder*)。
1. 确保您的搜索路径（**\$1PATH** 环境变量）包含 TI CGT 编译器二进制文件所在的文件夹（例如 `C:\ti\ccs910\ccs\tools\compiler\ti-cgt-arm_18.12.2.LTS\bin`）。
如果您在 TI 主板上使用 TI ARM 编译器，请使用以下命令从源代码生成构建文件：
```
cmake -DVENDOR=ti -DBOARD=cc3220_launchpad -DCOMPILER=arm-ti -S freertos -B build-folder
```
有关更多信息，请参阅 [CMake 与 FreeRTOS 一起使用](getting-started-cmake.md)。
## 问题排查
如果您在Amazon 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)。