# Getting started with the Texas Instruments CC3220SF-LAUNCHXL
Texas Instruments CC3220SF-LAUNCHXL
**Important**
This reference integration is hosted on the Amazon-FreeRTOS repository which is deprecated. We recommend that you [start here](freertos-getting-started-modular.md) when you create a new project. If you already have an existing FreeRTOS project based on the now deprecated Amazon-FreeRTOS repository, see the [Amazon-FreeRTOS Github Repository Migration Guide](github-repo-migration.md).
This tutorial provides instructions for getting started with the Texas Instruments CC3220SF-LAUNCHXL. If you do not have the Texas Instruments (TI) CC3220SF-LAUNCHXL Development Kit, visit the AWS Partner Device Catalog to purchase one from our [ partner](https://devices.amazonaws.com/detail/a3G0L00000AANtaUAH/SimpleLink-Wi-Fi®-CC3220SF-Wireless-Microcontroller-LaunchPad-Development-Kit).
Before you begin, you must configure AWS IoT and your FreeRTOS download to connect your device to the AWS Cloud. See [First steps](freertos-prereqs.md) for instructions. In this tutorial, the path to the FreeRTOS download directory is referred to as `freertos`.
## Overview
This tutorial contains instructions for the following getting started steps:
1. Installing software on the host machine for developing and debugging embedded applications for your microcontroller board.
1. Cross compiling a FreeRTOS demo application to a binary image.
1. Loading the application binary image to your board, and then running the application.
## Set up your development environment
Follow the steps below to set up your development environment to get started with FreeRTOS.
Note that FreeRTOS supports two IDEs for the TI CC3220SF-LAUNCHXL Development Kit: Code Composer Studio and IAR Embedded Workbench version 8.32. You can use either IDE to get started.
### Install Code Composer Studio
1. Browse to [TI Code Composer Studio](http://processors.wiki.ti.com/index.php/Download_CCS).
1. Download the offline installer for the platform of your host machine (Windows, macOS, or Linux 64-bit).
1. Unzip and run the offline installer. Follow the prompts.
1. For **Product Families to Install**, choose **SimpleLink Wi-Fi CC32xx Wireless MCUs**.
1. On the next page, accept the default settings for debugging probes, and then choose **Finish**.
If you experience issues when you are installing Code Composer Studio, see [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), and [Troubleshooting CCS](http://processors.wiki.ti.com/index.php/Troubleshooting_CCSv7).
### Install IAR Embedded Workbench
1. Download and run the [ Windows installer for version 8.32](http://netstorage.iar.com/SuppDB/Protected/PRODUPD/013570/EWARM-CD-8322-19423.exe) of the IAR Embedded Workbench for ARM. In **Debug probe drivers**, make sure that **TI XDS** is selected.
1. Complete the installation and launch the program. On the **License Wizard** page, choose **Register with IAR Systems to get an evaluation license**, or use your own IAR license.
### Install the SimpleLink CC3220 SDK
Install the [SimpleLink CC3220 SDK](http://www.ti.com/tool/SIMPLELINK-CC3220-SDK). The SimpleLink Wi-Fi CC3220 SDK contains drivers for the CC3220SF programmable MCU, more than 40 sample applications, and documentation required to use the samples.
### Install Uniflash
Install [Uniflash](http://www.ti.com/tool/UNIFLASH). CCS Uniflash is a standalone tool used to program on-chip flash memory on TI MCUs. Uniflash has a GUI, command line, and scripting interface.
### Install the latest service pack
1. On your TI CC3220SF-LAUNCHXL, place the SOP jumper on the middle set of pins (position = 1) and reset the board.
1. Start Uniflash. If your CC3220SF LaunchPad board appears under **Detected Devices**, choose **Start**. If your board is not detected, choose **CC3220SF-LAUNCHXL** from the list of boards under **New Configuration**, and then choose **Start Image Creator**.
1. Choose **New Project**.
1. On the **Start new project** page, enter a name for your project. For **Device Type**, choose **CC3220SF**. For **Device Mode**, choose **Develop**, and then choose **Create Project**.
1. On the right side of the Uniflash application window, choose **Connect**.
1. From the left column, choose **Advanced**, **Files**, and then **Service Pack**.
1. Choose **Browse**, and then navigate to where you installed the CC3220SF SimpleLink SDK. The service pack is located at `ti/simplelink_cc32xx_sdk_VERSION/tools/cc32xx_tools/servicepack-cc3x20/sp_VERSION.bin`.
1. Choose the **Burn** (![\[Feather icon representing a lightweight or simplified feature or concept.\]](http://docs.aws.amazon.com/freertos/latest/userguide/images/flame.png)) button, and then choose **Program Image (Create & Program)** to install the service pack. Remember to switch the SOP jumper back to position 0 and reset the board.
### Configure Wi-Fi provisioning
To configure the Wi-Fi settings for your board, do one of the following:
+ Configure the FreeRTOS demo application described in [Configuring the FreeRTOS demos](freertos-prereqs.md#freertos-configure).
+ Use [SmartConfig](http://dev.ti.com/tirex/#/?link=Software%2FSimpleLink%20CC32xx%20SDK%2FSimpleLink%20Academy%2FWi-Fi%2FWi-Fi%20Provisioning) from Texas Instruments.
## Build and run the FreeRTOS demo project
### Build and run the FreeRTOS demo project in TI Code Composer
**To import the FreeRTOS demo into TI Code Composer**
1. Open TI Code Composer, and choose **OK** to accept the default workspace name.
1. On the **Getting Started** page, choose **Import Project**.
1. In **Select search-directory**, enter `projects/ti/cc3220_launchpad/ccs/aws_demos`. The project `aws_demos` should be selected by default. To import the project into TI Code Composer, choose **Finish**.
1. In **Project Explorer**, double-click **aws\$1demos** to make the project active.
1. From **Project**, choose **Build Project** to make sure the project compiles without errors or warnings.
**To run the FreeRTOS demo in TI Code Composer**
1. Make sure the Sense On Power (SOP) jumper on your Texas Instruments CC3220SF-LAUNCHXL is in position 0. For more information, see [SimpleLink Wi-Fi CC3x20, CC3x3x Network Processor User's Guide](http://www.ti.com/lit/swru455).
1. Use a USB cable to connect your Texas Instruments CC3220SF-LAUNCHXL to your computer.
1. In the project explorer, make sure the `CC3220SF.ccxml` is selected as the active target configuration. To make it active, right-click the file and choose **Set as active target configuration**.
1. In TI Code Composer, from **Run**, choose **Debug**.
1. When the debugger stops at the breakpoint in `main()`, go to the **Run** menu, and choose **Resume**.
### Monitoring MQTT messages on the cloud
Before you run the FreeRTOS demo project, you can set up the MQTT client in the AWS IoT console to monitor the messages that your device sends to the AWS Cloud.
**To subscribe to the MQTT topic with the AWS IoT MQTT client**
1. Sign in to the [AWS IoT console](https://console.aws.amazon.com/iotv2/).
1. In the navigation pane, choose **Test**, then choose **MQTT test client** to open the MQTT client.
1. In **Subscription topic**, enter ***your-thing-name*/example/topic**, and then choose **Subscribe to topic**.
When the demo project successfully runs on your device you see "Hello World\$1" sent multiple times to the topic that you subscribed to.
### Build and run FreeRTOS demo project in IAR Embedded Workbench
**To import the FreeRTOS demo into IAR Embedded Workbench**
1. Open IAR Embedded Workbench, choose **File**, and then choose **Open Workspace**.
1. Navigate to `projects/ti/cc3220_launchpad/iar/aws_demos`, choose **aws\$1demos.eww**, and then choose **OK**.
1. Right-click the project name (`aws_demos`), and then choose **Make**.
**To run the FreeRTOS demo in IAR Embedded Workbench**
1. Make sure the Sense On Power (SOP) jumper on your Texas Instruments CC3220SF-LAUNCHXL is in position 0. For more information, see [SimpleLink Wi-Fi CC3x20, CC3x3x Network Processor User's Guide](http://www.ti.com/lit/swru455).
1. Use a USB cable to connect your Texas Instruments CC3220SF-LAUNCHXL to your computer.
1. Rebuild your project.
To rebuild the project, from the **Project** menu, choose **Make**.
1. From the **Project** menu, choose **Download and Debug**. You can ignore "Warning: Failed to initialize EnergyTrace," if it's displayed. For more information about EnergyTrace, see [MSP EnergyTrace Technology](http://www.ti.com/tool/energytrace?jktype=recommendedresults).
1. When the debugger stops at the breakpoint in `main()`, go to the **Debug** menu, and choose **Go**.
### Using CMake with FreeRTOS
If you prefer not to use an IDE for FreeRTOS development, you can alternatively use CMake to build and run the demo applications or applications that you have developed using third-party code editors and debugging tools.
**To build the FreeRTOS demo with CMake**
1. Create a folder to contain the generated build files (*build-folder*).
1. Make sure your search path (**\$1PATH** environment variable) contains the folder where the TI CGT compiler binary is located (for example `C:\ti\ccs910\ccs\tools\compiler\ti-cgt-arm_18.12.2.LTS\bin`).
If you are using the TI ARM compiler with your TI board, use the following command to generate build files from source code:
```
cmake -DVENDOR=ti -DBOARD=cc3220_launchpad -DCOMPILER=arm-ti -S freertos -B build-folder
```
For more information, see [Using CMake with FreeRTOS](getting-started-cmake.md).
## Troubleshooting
If you don’t see messages in the MQTT client of the AWS IoT console, you might need to configure debug settings for the board.
**To configure debug settings for TI boards**
1. In Code Composer, on **Project Explorer**, choose **aws\$1demos**.
1. From the **Run** menu, choose **Debug Configurations**.
1. In the navigation pane, choose **aws\$1demos**.
1. On the **Target** tab, under **Connection Options**, choose **Reset the target on a connect**.
1. Choose **Apply**, and then choose **Close**.
If these steps don’t work, look at the program's output in the serial terminal. You should see some text that indicates the source of the problem.
For general troubleshooting information about Getting Started with FreeRTOS, see [Troubleshooting getting started](gsg-troubleshooting.md).