Please note as of Wednesday, August 15th, 2018 this wiki has been set to read only. If you are a TI Employee and require Edit ability please contact x0211426 from the company directory.

CC3200 Provisioning AP

From Texas Instruments Wiki
Jump to: navigation, search
Cc31xx cc32xx return home.png
Cc32xx return sample apps.png

Overview and Application details

This user guide describes all the steps needed to use this example, in which the CC3200 device is used in conjunction with a Wi-Fi enabled mobile device running an application (in this case Simplelink Wi-Fi Starter Pro) and allowing it to connect to the Wi-Fi network.

NoteNote: This wiki page is only applicable for CC3200-SDK v1.2.0 and upward releases. For documentation on older SDKs' examples, refer corresponding file in<cc3200-sdk-installation-location>\cc3200-sdk\docs\examples\

The TI SimpleLink Starter Pro application can be downloaded from the App Store (iOS) or Google play (Android).

NoteNote: There are two versions of the SimpleLink Wi-Fi starter applications on the Play Store. Please make sure to choose the “Pro” version.

Prerequisites

Setup Environment

Provisioning set up is illustrated in the picture below. It consists of the SimpleLink Wi-Fi device being provisioned, a smart phone (Android or iPhone) with TI SimpleLink Starter Pro Application installed and an access point/router (for connection to the Internet).

Provisioning high level view.png

Usage

  • Connect the board to a Windows-PC and configure the terminal-program for seeing the logs - CC31xx & CC32xx Terminal Setting has detailed instructions for configuring the terminal-program. Please refer CC3200 Getting started Guide for terminal connection. This provisioning application, works only with SDK1.2
  • Install the 'provisioning add-on package' to the SDK1.2. The 'add-on' installs, provisioning library and the provisioning application. (The below pictures show the installation for CC3200 SDK).

Cc3200 provisioning addon lib location.png

Cc3200 provisioning addon example location.png

  • Open CCS workspace, import the provisioning library and application as illustrated below.

Cc3200 provisioning addon ccs import.png

  • Build provisioning library, followed by the provisioning application:

Cc3200 provisioning addon projects.png

  • After the application is built, either flash or load the application from CCS and run. The application configures the device in SimpleLink Provision mode. The device will then wait for the SimpleLink Starter Pro application to provision it to a Wi-Fi network.
  • Run TI SimpleLink Starter Pro Application on your Smartphone

Cc3100 cc3200 simplelink provisioning app 01.png

  • Configuration page pops up, on the smart phone. Select the drop-down menu for ‘Device to configure’ and select the SimpleLink device to configure.

Cc3100 cc3200 simplelink provisioning app 02.png Cc3100 cc3200 simplelink provisioning app 03.png Cc3100 cc3200 simplelink provisioning app 04.png

By default, the page displays all the access points with the name beginning with "mysimplelink-". If the device to be provisioned is named differently, select "Show all", which shows all the access points in the vicinity. And, now select the SimpleLink device to be provisioned. This takes us back to the Configuration page.

  • The next step is to select/configure the Wi-Fi network and optionally name the device. Select the drop-down menu ‘Wi-Fi network’.

Cc3100 cc3200 simplelink provisioning app 05.png Cc3100 cc3200 simplelink provisioning app 06.png

If the pop-up page does not show all the Wi-Fi routers, select ‘Show all’, this makes the SimpleLink Wi-Fi device, to send the complete scan list to the phone app.

Cc3100 cc3200 simplelink provisioning app 07.png Cc3100 cc3200 simplelink provisioning app 08.png

Select the Wi-Fi router and enter the Wi-Fi network authentication type and password. Press 'Start Configuration' button to start the provisioning process. Several status messages are displayed on the screen, as the provisioning process continues.

Cc3100 cc3200 simplelink provisioning app 09.png Cc3100 cc3200 simplelink provisioning app 10.png

  • If provisioning has succeeded, ‘Provisioning Successful’ shows up.

Cc3100 cc3200 simplelink provisioning app 11.png

  • In the event of failure, please check the following:

Cc3100 cc3200 simplelink provisioning app 12.png

  1. Ensure that the password and SSID entered for the access point are correct.
  2. The SimpleLink device is in Provisioning mode.
  3. The phone (with the running provisioning app) and the device are within the AP range.
  4. Check the console for error messages, and send the error logs using the phone app.

Cc3100 cc3200 simplelink provisioning app 13.png Cc3100 cc3200 simplelink provisioning app 14.png Cc3100 cc3200 simplelink provisioning app 15.png

In the event of failure, try couple of time by Resetting the device (For 'Reset' button location, please refer to the CC3200 Quick Start Guide)

  • On success, user can check that the device is listed in the ‘Devices’ page of the phone application and connect to it.

Cc3100 cc3200 simplelink provisioning app 16.png Cc3100 cc3200 simplelink provisioning app 17.png Cc3100 cc3200 simplelink provisioning app 18.png

  • See the logs on the terminal-program's console. On success, below message will be displayed on the terminal

Cc3200 simplelink provisioning console sample.png

Limitations/Known Issues

SDK 1.30 by default uses simplelink library builds without the provisioning external lib enabled. Make sure the following lines are uncommented in your user.h file and rebuild the simplelink library to run this example.

  1. include "provisioning_api.h"
  2. define SL_EXT_LIB_1 sl_Provisioning

Deprecated Example

CC32xx Provisioning AP (Deprecated)

Links