SimpleLink SDK Plugins are designed to work in tandem to the microprocessor specific SDK. This plugin is designed to work alongside the SimpleLink MSP432 SDK and relies on several core elements within this SDK. Without a prior installation of the SimpleLink MSP432 SDK, the SimpleLink MSP432 SDK WiFi Plugin will not work. While testing of this software package was performed on release 1.20.00.45 of the SDK, it is likely that it will also work with newer versions of the SDK.
This guide explains how to install the SimpleLinkTM MSP432 WiFi Plugin and lists the various other tools required to get started with the first application.
The user is expected to have the following:
Important note:
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/cc31xx_tools/servicepack-cc3x20
Verify that the jumpers on the CC31XXEMUBOOST should be connected as shown in the next figure:
Connect the CC3100BOOST to the CC31XXEMUBOOST as shown in the next figure:
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.<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 <Plugin_INSTALL_DIR>/examples
The SDK provides 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.
For more details and how change configurations look at the <Plugin_INSTALL_DIR>/docs/simplelink_mcu_sdk/Users_Guide.html
document.
Select any Code Example you would like to use. In this example network_terminal_MSP_EXP432P401R_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 CC3120 in the SDK comes with its own set of examples.
<Plugin install dir>\tools\cc31xx_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
The argvars are stored in a .custom_argvars file, which is located in the <Plugin_INSTALL_PATH>/tools/iar
directory of the SDK.
Restart IAR.
This section will show how to import/build/load an example
For this release of the SimpleLinkTM MSP432 WiFi Plugin. 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 scroll down and choose Texas Instruments - Example projects
Click on the example applications link.
All the example projects in the Plugin 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 MSP_EXP432P401R 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
The Plugin ships makefiles in addition to IDE specific projects.
<MSP432_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.
Before building FreeRTOS kernel , FreeRTOSConfig.h need to be copied and replaced from <Plugin_Path>\kernel\freertos\builds\MSP_EXP432P401R\release
into <MSP_SDK_INSTALL_DIR>\kernel\freertos\builds\MSP_EXP432P401R\release
Open a command prompt. Any Kernel configuration can be built by navigating to the desired directory and running gmake command.
To build all the TIRTOS and FreeRTOS projects
cd <MSP_SDK_INSTALL_PATH>\kernel
c:\ti\xdctools_3_32_01_22_core\gmake.exe
To build only TIRTOS config project
cd <MSP_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 projects
cd <MSP_SDK_INSTALL_PATH>\kernel
Release: c:\ti\xdctools_3_32_01_22_core\gmake.exe freertos-release
To build only specific config project
cd <MSP_SDK_INSTALL_PATH>\kernel\<OS>\builds\<Board variant>\<release or debug>\<Compiler>
Example: cd C:\ti\simplelink_msp432_sdk_1_20_00_45\kernel\freertos\builds\MSP_EXP432P401R\release\gcc
c:\ti\xdctools_3_32_01_22_core\gmake.exe
This link can be use in order to Return to paragraph 5.2.1 Execute your First Application.
The SDK include Host Driver or OTA libs that can be compiled after changes.
To build Host Driver lib
cd <Plugin_INSTALL_PATH>\source\ti\drivers\net\wifi
Release: c:\ti\xdctools_3_32_01_22_core\gmake.exe
To build OTA lib
cd <Plugin_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 5.2.1 Execute your First Application.
<Plugin_INSTALL_DIR>\examples\rtos\MSP_EXP432P401R\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.
When using Makefile in Linux machine, instead of using the gmake
command, just use make
.