SimpleLinkTM Sensor and Actuator Plugin Getting Started Guide

Table of Contents

1. Introduction

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 SAIL Plugin and lists the various other tools required to get started with your first application.

2. Prerequisites

The user is expected to have the following:

3 SAIL Plugin - Download and Installation

3.1 Using the SAIL Plugin Online

A quick and easy way to start working with the SAIL Plugin is to use TI Resource Explorer. This online tool lets you explore the contents of the SAIL Plugin. You can build the examples directly using the cloud version of Code Composer Studio. If you choose to use the SAIL Plugin online, there is no need to download anything to your local computer or install any tools.

3.2 Installing the SAIL Plugin

You can also download the SAIL Plugin from TI Resource Explorer or the software product page on TI’s website.

4. Quick Start for CCS IDE (CCS or GCC Projects)

This section is going to cover the required settings for a CCS installation and how to build and load examples

4.1 Download and Installation

Download CCS

During the installation, the following options are recommended:

4.1.1 Discovering the SAIL Plugin in CCS

SAIL Plugin is a zip package.User can extract the SAIL package to destination of his will, The preferred directory will be - C:\ti.If user extracts the SAIL package to any other directory then that has to be added to the CCS Product Discovery Path as shown below (optionally user can hit rediscover/install button). After that restart the CCS. CCS will automatically detect the latest install.

4.2 Running Your First Example

This section will show how to import, build and load an example in SAIL Plugin.SAIL Plugin ships pre-built library sail.lib for all combinations of RTOS, compiler and platform supported.It has to be ensured that the sail.lib for the respective platform/rtos/compiler is present in \source\ti\sail\lib.Please see section Makefile for building SAIL library which details on building SAIL library.

4.2.1 TI Resource Explorer

A quick and easy way to start working with the SAIL Plugin is to use the TI Resource Explorer. Step by step instructions are available here.

4.2.2 Import via CCS IDE

5. Quick Start for IAR IDE

This section is going to cover the required settings for a IAR installation and how to build and load examples.

5.1 Download and Installation

Download and install IAR Embedded Workbench for ARM. You can get IAR for ARM here.

5.1.1 Configuring Custom Argument Variables

Before starting to work with any of the projects in the SAIL, you need to load a set of variables that will be set for your current workspace (the custom argument variables file from the SDK of interest is selected):

5.2 Running Your First Example / Importing Your First project

This section will show how to import, build and load an example

Directly accessing workspace from example folder All Code Examples that are shipped with the SDK come with an IAR workspace. Double-Clicking the specific workspace allows you to open the project on disk and build it.

Browse the example list

Make/Build the Example Project Make [(Project->Make) Shortcut F7]. For RTOS based Projects - Note that the RTOS(kernel) build is a dependent project which is automatically pre-built before the example project builds.

The RTOS kernel(TI-RTOS or FreeRTOS build) project is linked to the workspace but the Example Project is copied into the workspace. SO the RTOS kernel needs to be built only once within the scope of the SDK but each workspace has its own copy of the example project.

For noRTOS Projects - There is not RTOS(kernel) build dependent project imported into the workspace

www.ti.com/lit/pdf/slau574 has more details on IDE specific of MSP432

7. Quick Start for Makefile Users

The SAIL examples and RTOS configuration projects(in the Interested SDK) ship Makefiles in addition to IDE specific projects.There is a makefile available to build the SAIL library also.

7.1 Update imports.mak

7.2 Build RTOS config

The RTOS config must be built first. The makefile for RTOS config are available in

<SDK_INSTALL_DIR>\kernel\<tirtos/freertos>\builds\MSP_EXP432P401R\<debug/release>\<ccs/gcc/iar>

For example: <SDK_INSTALL_DIR>\kernel\tirtos\builds\MSP_EXP432P401R\release\ccs\makefile

7.3 Build SAIL.lib using makefile

For building Driver library, there is no projectspec available now and one has to manually build using the makefile available for library build. The makefile for building SAIL library is available at <SAIL\_INSTALL\_DIR\>\\source\\ti\\sail.

use gmake help or make help command to understand the supported targets by the makefile.You should see a help menu similar to this on gmake help or make help

7.3 Build the makefile

8. Quick Start for TI Resource Explorer Users

User can navigate to the Sensor and Actuator Plugin folder in resource explorer. The sections following will explain on how to use resource explorer and work with the Sensor and Actuator plugin.

Landing page and Documentation folder

The landing page of the Sensor and Actuator plugin in the resource explorer looks as shown below. The image describes various windows/widgets found on the landing page.

The user can click the Documents folder on the left pane/main window to navigate to various documents provided in SAIL plugin. The image below shows the documentation folder contents of the Sensor and Actuator plugin.

The below image shows examples directory structure.

On navigating through examples and selecting specific example user can see the documentation related to the example. The image below shows this.

More on Examples

Sensor and Actuator Plugin supports multiple SimpleLink Platforms, by navigating through the examples directory user can select the example for different RTOS such as freeRTOS or TIRTOS and he can also select example for specific compiler. After selecting the example the user will be able to launch the example on CCS cloud too. The image below explains this in more detail.

on clicking the import to CCS cloud icon the CCS cloud will be launched and the dependent projects will be imported as shown below (NOTE: importing a project imports example project as well as the project to build the dependent OS). The user can run the example by clicking the run icon as shown in the image. (First time user may have to register, need to have a TI account)