This guide is intended to assist users in the initial setup and demonstration of running their first sample application. The guide explains how to install the SimpleLinkTM CC3220TM SDK and lists the various other tools required to get started with the first application
The user is expected to have the following:
You can also download the SimpleLink CC3220 SDK from the Resource Explorer or from the software product page on www.ti.com
It is recommended to update the service-pack to the latest service-pack available. The service-pack can be found in <SDK_INSTALL_DIR>/tools/cc32xx_tools/servicepack-cc3x20
Download TI Uniflash and install it.
Uniflash Image Creator user guide: Uniflash Image Creator
Download CCS from CCS 7.0.0
During the installation, the following options are recommended
We recommend that you use the default installation folder
Make sure that SimpleLink CC3x Wireless MCUs is selected. You can select additional processor support options as needed.
To use a debug probe, select TI XDS Debug Probe Support and any other options you would like.
C:\ti
and Re-start CCS. CCS will automatically detect the latest install.<SDK_INSTALL_PATH>/tools/cc32xx_tools/FreeRTOS_patch/CCS
, and paste it at <FREERTOS_INSTALL_PATH>/FreeRTOS/Source/portable/CCS
<FREERTOS_INSTALL_PATH>
and them press OKChoose Window > Preferences > Code Composer Studio > products
if the window appear it means that new products have been discovered, if the products mentioned above are in the list, choose them and choose install.
This section will show how to import/build/load an example
This is not available in the SDK Beta Release. Will be available for GA release
Select the Browse button in the Import CCS Eclipse Projects dialog and select the the directory <SDK_INSTALL_DIR>/examples
The SDK provides NoRTOS, TI-RTOS and FreeRTOS based examples. TI-RTOS and FreeRTOS examples have the word “tirtos” or “freertos” in the project name
CCS picks both CCS and GCC based examples.
Importing TI-RTOS and FreeRTOS examples will bring in (import) kernel projects too in the same workspace. The kernel project is a dependent project and will be automatically built when the example is built.
Importing a NoRTOS examples will bring in (import) only the example project to the workspace, this project will be linked to a pre-compiled nortos kernel library.
For more details and how change configurations look at the <SDK_INSTALL_DIR>/docs/simplelink_mcu_sdk/Users_Guide.html
document.
Select any Code Example you would like to use. In this example network_terminal_CC3220S_LAUNCHXL_freertos_ccs is chosen and choose finish.
Build and Download.
Do not use the New Project Creation Wizard
Start with one of the example projects as shown in paragraph 4.2. Each software component and each variant of the CC3220 in the SDK comes with its own set of examples.
<SDK install dir>\tools\cc32xx_tools\iar_patch
, and paste it at <IAR_installation_dir>\arm\config
Before starting to work with any of the projects in the SDK, you need to load a set of environment variables that will be set for your current workspace
Choose Tools -> Configure Custom Argument Variables
Click Global->Import
<SDK_INSTALL_PATH>/tools/iar
directory of the SDK.In the workspace tab, import the custom argvars from the SDK.
Restart IAR.
This section will show how to import/build/load an example
For this release of the SDK, the NoRTOS and RTOS configurations are not pre-built. You will need to build the desired configurations.
Select the Tool chain, and choose the Empty project template. Click OK
Browse to the location where you want to save this project, and type a file name for the project file (*.ewp). Click Save. Each project should be saved in a separate directory.
Choose Help > IAR Information Center for ARM, choose INTEGRATED SOLUTIONS and then scrool down and choose Texas Instruments - Example projects
Click on the example applications link.
All the example projects in the SDK that available in IAR are listed in the html page.
Scroll through the page and click on the project you are interested in. In this example we choose to work with network_termianl for the CC3220SF based on FreeRTOS.
Browse to the location where you want to save this workspace, and type a file name for the workspace file (*.eww). Click Save.
right click on the project name --> options
On the output converter tab (Highlight in blue), mark the checkbox (in red), and change the output format to binary.
Now, hit OK, and later compile. The binary image should reside in: <your_IAR_workspace>\<IAR_Project location>\Debug\Exe
.
Choose Project > Make
Select Project -> options from the menu, and select the Debugger category. In the setup tab, choose TI XDS as the driver. Click OK.
In case you are working with the CC3220SF device, check the Use flash loader(s) checkbox in the Debugger -> Download tab.
Go to the TI XDS Category, choose TI XDS110 Emulator as the emulator, and JTAG (4-pin) as the interface.
The SDK examples and RTOS configuration projects ship makefiles in addition to IDE specific projects.
<SDK_INSTALL_DIR>/imports.mak
to point to actual install locations on the user’s machineBuilding the Kernel can be done in different options according to the requirements.
The User’s Guide provides details about the various RTOS configuration options. Here is a quick summary in this section
Open a command prompt. Any Kernel configuration can be built by navigating to the desired directory and running gmake command.
To build all the NoRTOS, TIRTOS and FreeRTOS config projects
cd <SDK_INSTALL_PATH>\kernel
c:\ti\xdctools_3_32_01_22_core\gmake.exe
To build only TIRTOS config project
cd <SDK_INSTALL_PATH>\kernel
Debug: c:\ti\xdctools_3_32_01_22_core\gmake.exe tirtos-debug
Release: c:\ti\xdctools_3_32_01_22_core\gmake.exe tirtos-release
To build only FreeRTOS config project
cd <SDK_INSTALL_PATH>\kernel
Release: c:\ti\xdctools_3_32_01_22_core\gmake.exe freertos-release
To build only NoRTOS config project
cd <SDK_INSTALL_PATH>\kernel
Release: c:\ti\xdctools_3_32_01_22_core\gmake.exe nortos-release
To build only specific config project
cd <SDK_INSTALL_PATH>\kernel\<OS>\builds\<Board variant>\<release or debug>\<Compiler>
Example: cd C:\ti\simplelink_cc32xx_sdk_1_02_00_01_eng\kernel\freertos\builds\CC3220SF_LAUNCHXL\release\gcc
c:\ti\xdctools_3_32_01_22_core\gmake.exe
This link can be use in order to Return to paragraph 6.2.1 Execute your First Application.
The SDK include Host Driver, MQTT or OTA libs that can be compiled after changes.
To build Host Driver lib
cd <SDK_INSTALL_PATH>\source\ti\drivers\net\wifi
Release: c:\ti\xdctools_3_32_01_22_core\gmake.exe
To build MQTT lib
cd <SDK_INSTALL_PATH>\source\ti\net\mqtt
Release: c:\ti\xdctools_3_32_01_22_core\gmake.exe
To build OTA lib
cd <SDK_INSTALL_PATH>\source\ti\net\ota
Release: c:\ti\xdctools_3_32_01_22_core\gmake.exe
This link can be use in order to Return to paragraph 6.2.1 Execute your First Application.
<SDK_INSTALL_DIR>/examples/rtos/CC3220SF_LAUNCHXL/demos/network_terminal/freertos/gcc
When using Linux machine the installation steps for the SDK and IDE’s are the same as in windows.
Quick Start for CCS IDE can be found in paragraph 4.
Quick Start for Makefile Users can be found in paragraph 6.
Note: When using Makefile in Linux machine, instead of using the gmake command, just use make.
For Example: