Texas Instruments SimpleLink CC3200 Wi-Fi Manual

CC3200 SimpleLink™ Wi-Fi®and IoT Solution, a
Single Chip Wireless MCU
Programmer's Guide
Literature Number: SWRU369D
June 2014–Revised May 2018

2SWRU369D–June 2014–Revised May 2018
Submit Documentation Feedback
Copyright © 2014–2018, Texas Instruments Incorporated
Table of Contents
Contents
1 Introduction......................................................................................................................... 6
1.1 Overview .................................................................................................................. 6
1.2 Software Components................................................................................................... 6
1.3 CC3200 LaunchPad Platform .......................................................................................... 8
2 Foundation SDK – Getting Started ......................................................................................... 9
2.1 Installation................................................................................................................. 9
2.2 Package Components Overview...................................................................................... 11
2.3 Prerequisite: Tools to be Installed.................................................................................... 13
3 Foundation SDK – Components........................................................................................... 14
3.1 SimpleLink Component Library....................................................................................... 14
3.2 Peripheral Driver Library............................................................................................... 21
3.3 Reference Applications ................................................................................................ 22
3.4 CC3200 PinMux Utility................................................................................................. 24
4 Getting Started With the CC3200 LaunchPad......................................................................... 25
5 Foundation SDK – Development Flow................................................................................... 26
5.1 Simple Networking Applications ...................................................................................... 26
5.2 SimpleLink APIs ........................................................................................................ 40
5.3 Compilation, Build and Execution Procedure....................................................................... 40
5.4 Flashing and Running the .bin Using the Uniflash Tool ........................................................... 67
6 CC3200 ROM Services ........................................................................................................ 67
6.1 CC3200 Bootloader .................................................................................................... 67
6.2 CC3200 Peripheral Driver Library Services in ROM............................................................... 68
7 Additional Resources.......................................................................................................... 71
Revision History.......................................................................................................................... 72

www.ti.com
3
SWRU369D–June 2014–Revised May 2018
Submit Documentation Feedback Copyright © 2014–2018, Texas Instruments Incorporated
List of Figures
List of Figures
1 CC3200 Overview of Peripherals.......................................................................................... 6
2 CC3200 Software Components............................................................................................ 7
3 CC3200 LaunchPad Platform.............................................................................................. 8
4 CC3200 SDK Installation 1................................................................................................. 9
5 CC3200 SDK Installation 2................................................................................................. 9
6 CC3200 SDK Installation 3 ............................................................................................... 10
7 SimpleLink Modular Composition ........................................................................................ 14
8 CC3200 SimpleLink IAR Config Switch ................................................................................. 16
9 CC3200 CCS SimpleLink Config Switch................................................................................ 17
10 File Search Path............................................................................................................ 18
11 Edit Directory Path ......................................................................................................... 19
12 Edit SimpleLink Library Path.............................................................................................. 20
13 Edit SimpleLink Library Path.............................................................................................. 20
14 Linking Code Example 1 .................................................................................................. 21
15 Linking Code Example 2 .................................................................................................. 21
16 CC3200 Programmer Guide Device Manager.......................................................................... 25
17 TCP Socket Terminal...................................................................................................... 33
18 UDP Socket Terminal...................................................................................................... 37
19 CC3200 Transceiver Application on the Hyperterminal............................................................... 39
20 CC3200 Programmer Guide IAR Project Options ..................................................................... 41
21 CC3200 IAR Compiling Project........................................................................................... 41
22 CC3200 IAR Linker Project ............................................................................................... 42
23 CC3200 IAR Linker Config................................................................................................ 43
24 CC3200 IAR Generating Binary.......................................................................................... 44
25 CC3200 IAR Executing ................................................................................................... 45
26 CC3200 IAR Download and Run......................................................................................... 45
27 CCS App Center............................................................................................................ 46
28 TI-PinMux Tool ............................................................................................................. 47
29 Select CCS Projects to Import ........................................................................................... 48
30 CC3200 CSS Editing Existing Project................................................................................... 49
31 CC3200 CCS Creating Project ........................................................................................... 50
32 CC3200 CCS Compiling Project ......................................................................................... 51
33 CC3200 CCS Compiling Project 1....................................................................................... 52
34 CC3200 CCS Compiling Project 2....................................................................................... 53
35 CC3200 CCS Linking Project 1 .......................................................................................... 54
36 CC3200 CCS Linking Project 2 .......................................................................................... 55
37 TI-RTOS OS Dependency ................................................................................................ 56
38 CC3200 CCS Generating Binary......................................................................................... 57
39 CC3200 CCS Executing 1 ................................................................................................ 58
40 CC3200 CCS Executing 2 ................................................................................................ 58
41 CC3200 CCS Launch Config ............................................................................................. 59
42 Target Configuration ....................................................................................................... 60
43 CC3200 CCS Executing 4 ................................................................................................ 60
44 CC3200 CCS Executing 5 ................................................................................................ 61
45 Cygwin Setup............................................................................................................... 62
46 Zadig Options............................................................................................................... 63
47 Replace Driver.............................................................................................................. 63

www.ti.com
4SWRU369D–June 2014–Revised May 2018
Submit Documentation Feedback
Copyright © 2014–2018, Texas Instruments Incorporated
List of Figures
48 Editing common.h .......................................................................................................... 63
49 Output Screen .............................................................................................................. 64
50 Debugging wlan_station................................................................................................... 65
51 Tera Term VT............................................................................................................... 65
52 Device Manager............................................................................................................ 66

www.ti.com
5
SWRU369D–June 2014–Revised May 2018
Submit Documentation Feedback Copyright © 2014–2018, Texas Instruments Incorporated
List of Tables
List of Tables
1 Package Contents.......................................................................................................... 11
2 CC3200 Prerequisite....................................................................................................... 13
3 End of RAM ................................................................................................................. 68
4 ROM APIs................................................................................................................... 68
5 ROM Interrupts ............................................................................................................. 68

6SWRU369D–June 2014–Revised May 2018
Submit Documentation Feedback
Copyright © 2014–2018, Texas Instruments Incorporated
CC3200 SimpleLink™ Wi-Fi®and IoT Solution, a Single Chip Wireless MCU
Programmer's Guide
SWRU369D–June 2014–Revised May 2018
CC3200 SimpleLink™ Wi-Fi®and IoT Solution, a Single
Chip Wireless MCU
1 Introduction
The CC3200 SimpleLink™ Wi-Fi®is the industry’s first single-chip microcontroller (MCU) with built-in Wi-Fi
connectivity, created for the Internet of Things (IoT). The CC3200 device is a wireless MCU that integrates
a high-performance ARM Cortex-M4 MCU, allowing customers to develop an entire application with a
single IC. This document introduces the user to the environment setup for the CC3200 SimpleLink Wi-Fi,
along with programming examples from the software development kit (SDK). This document explains both
the platform and the framework available to enable further application development.
1.1 Overview
The Texas Instruments royalty-free CC3200 Embedded Wi-Fi Foundation software development kit is a
complete software platform for developing Wi-Fi applications. It is based on the CC3200, a complete Wi-Fi
SoC (System-on-Chip) solution. The CC3200 solution combines a 2.4-GHz Wi-Fi PHY/MAC and TCP/IP
networking engine with a microcontroller, 256 kB on-chip RAM, and a comprehensive range of
peripherals.
Refer to the CC3200 Product Preview and Data Sheet (SWAS032) for more details on the CC3200 chip.
Figure 1. CC3200 Overview of Peripherals
1.2 Software Components
The CC3200 platform includes a user-programmable host, along with a comprehensive networking
solution combined with a Wi-Fi engine. The CC3200 Foundation software development kit provides an
easy-to-use framework, hosted in the on-chip microcontroller, to use the WLAN networking services, along
with a comprehensive listing of drivers for peripherals interfaced with the microcontroller. The kit also
includes a reference code for peripheral usage and a few simple applications for networking services.

www.ti.com Introduction
7
SWRU369D–June 2014–Revised May 2018
Submit Documentation Feedback Copyright © 2014–2018, Texas Instruments Incorporated
CC3200 SimpleLink™ Wi-Fi®and IoT Solution, a Single Chip Wireless MCU
Figure 2 illustrates the various software components and their form in the CC3200 Foundation SDK.
Figure 2. CC3200 Software Components

Introduction www.ti.com
8SWRU369D–June 2014–Revised May 2018
Submit Documentation Feedback
Copyright © 2014–2018, Texas Instruments Incorporated
CC3200 SimpleLink™ Wi-Fi®and IoT Solution, a Single Chip Wireless MCU
1.3 CC3200 LaunchPad Platform
The CC3200 LaunchPad board is the default hardware companion for the foundation SDK. This board
hosts the CC3200 device, with interfaces designed for application software development and debugging.
The CC3200 LaunchPad also supports the TI Booster Pack interface, allowing the user to interface with a
rich repertoire of peripheral systems.
Refer to the CC3200 Launch Pad user manual (SWRU372) for more details.
Figure 3. CC3200 LaunchPad Platform

www.ti.com Foundation SDK – Getting Started
9
SWRU369D–June 2014–Revised May 2018
Submit Documentation Feedback Copyright © 2014–2018, Texas Instruments Incorporated
CC3200 SimpleLink™ Wi-Fi®and IoT Solution, a Single Chip Wireless MCU
2 Foundation SDK – Getting Started
This section familiarizes the user with installation process and the directory structure of CC3200
Foundation SDK.
2.1 Installation
Run the installer by double-clicking the CC3200 SDK installer.
• Read and accept the license agreement to proceed.
Figure 4. CC3200 SDK Installation 1
• Choose an appropriate path to place the package (else default is chosen).
Figure 5. CC3200 SDK Installation 2

Foundation SDK – Getting Started www.ti.com
10 SWRU369D–June 2014–Revised May 2018
Submit Documentation Feedback
Copyright © 2014–2018, Texas Instruments Incorporated
CC3200 SimpleLink™ Wi-Fi®and IoT Solution, a Single Chip Wireless MCU
• Proceed with the installation and click Finish once done.
Figure 6. CC3200 SDK Installation 3

www.ti.com Foundation SDK – Getting Started
11
SWRU369D–June 2014–Revised May 2018
Submit Documentation Feedback Copyright © 2014–2018, Texas Instruments Incorporated
CC3200 SimpleLink™ Wi-Fi®and IoT Solution, a Single Chip Wireless MCU
2.2 Package Components Overview
Table 1. Package Contents
Directory Name Information
docs • CC3200 Programmer’s Guide
• Documentation for hardware details present in Hardware folder
• Documentation for SimpleLink host driver in html format under docs\simplelink_api’ directory
• Application notes for all the sample application present in docs\examples directory.
• Peripheral driver library user’s guide
• Documentation for netapps libraries
• SimpleLink OTA Extlib API user's guide
driverlib • Contains the peripheral driver library source files.
• The driverlib.a is also provided in the ccs and ewarm directories.
example
•Getting Started in STA Mode: Configures the CC3200 in STA mode. It verifies the connection by
pinging the client connected to it.
•Getting Started in AP Mode: Configures the CC3200 in AP mode. It verifies the connection by pinging
the client connected to it.
•TCP Socket: Demonstrates the connection scenario and basic TCP functionality.
•UDP Socket: Demonstrates the connection scenario and basic UDP functionality.
•Scan Policy: Demonstrates the scan-policy settings in the CC3200.
•SSL: SSL certificates are designed to provide two principles, privacy and authentication. Privacy is
achieved by encryption and decryption, and authentication is achieved by signature and verification.
The application demonstrates using a certificate with SSL.
•MAC Filters (NWP Filters): The Rx-Filters feature enables the user to define and manage the Rx-
filtering process, to reduce the amount of traffic transferred to the host and achieve efficient power
management.
•File_operations: Demonstrates the use of file-system APIs.
•Transceiver_mode: Demonstrates building a proprietary protocol on top of Wi-Fi PHY layer, with the
user given full flexibility to build their own packet. The RX Statistics feature inspects the medium in
terms of congestion, distance, validation of the RF hardware, and help using the RSSI information.
•Provisioning with WPS: Demonstrates the usage of WPS Wi-Fi provisioning with the
CC31xx/CC32xx.
•Provisioning with SmartConfig: Demonstrates the usage of TI's SmartConfig™ Wi-Fi provisioning
technique.
•Hib: Showcases hibernate as a power saving tool in a networking context (in this case, as a UDP
client).
•Get Time: Connects to an SNTP server and requests for time information.
•Get Weather: Connects to Open Weather Map and requests for weather data.
•Email: Sends emails through SMTP. The email application sends a preconfigured email at the push of
a button, or a user-configured email through the CLI.
•XMPP: Demonstrates the connection scenario with an XMPP server.
•Serial Wi-Fi: Serial Wi-Fi is a capability designed to provide easy, self-contained terminal access
behavior, over a UART interface.
•Connection Policy: Demonstrates the connection policies in the CC3200. The connection policies
determine how the CC3200 connects to the AP.
•ENT Wlan: Demonstrates the connection to an enterprise network using the flashed certificate.
Certificate is flashed in SFLASH.
•HTTP server: Demonstrates the HTTP server capability of the CC3200.
•mDNS: Demonstrates the usage of mDNS functionality in the CC3200. The application showcases both
mDNS advertise and mDNS listen functionality.
•Mode config: Switches the CC3200 LP from STA to AP and vice-versa.
•LED Blink Application: Showcases the usage of GPIO DriverLib APIs. The LEDs connected to the
GPIOs on the LP are used to indicate the GPIO output.
•Timer Demo Application: Showcases the usage of timer DriverLib APIs. This application uses 16-bit
timers to generate interrupts, which in turn toggle the state of the GPIO (driving LEDs).
•Watchdog Demo Application: Showcases the usage of watchdog timer (WDT) DriverLib APIs. The
objective of this application is to showcase the watchdog timer functionality to reset the system when
the system fails.
•UART Demo Application: Showcases the usage of UART DriverLib APIs. The application
demonstrates a simple echo of anything the user types on the terminal.

Foundation SDK – Getting Started www.ti.com
12 SWRU369D–June 2014–Revised May 2018
Submit Documentation Feedback
Copyright © 2014–2018, Texas Instruments Incorporated
CC3200 SimpleLink™ Wi-Fi®and IoT Solution, a Single Chip Wireless MCU
Table 1. Package Contents (continued)
Directory Name Information
example
•Interrupt Application: Showcases the usage of interrupt DriverLib APIs. This is a sample application
to showcase interrupt preemption and tail-chaining capabilities.
•I2C Demo: Showcases the usage of I2C DriverLib APIs. It provides a user interface to read-from or
write-to the I2C devices on the LaunchPad.
•MCU Sleep: Exercises the sleep functionality of the MCU.
•uDMA Application: Showcases the usage of UDMA DriverLib APIs. Various DMA mode functionalities
are shown in this application.
•FreeRTOS Demo Application: Showcases the FreeRTOS features, such as multiple task creation and
intertask communication using queues.
•AES Demo Application: Showcases the usage of AES Driverlib APIs. Provides a user interface to
exercise various AES modes.
•DES Demo Application: Showcases the usage of DES Driverlib APIs. Provides a user interface to
exercise various DES modes.
•CRC Demo Application: Showcases the usage of CRC Driverlib APIs. Provides a user interface to
exercise various CRC modes.
•SHA-MD5 Demo Application: Showcases the usage of SHA-MD5 Driverlib APIs. Provides a user
interface to exercise various SHA-MD5 modes.
•ADC Demo Application: Showcases the functionality of the CC3200 ADC module by using the
Driverlib APIs.
•PWM Demo Application: Showcases general 16-bit pulse-width modulation (PWM) mode feature
supported by purpose timers (GPTs).
•SD Host Application: Showcases the basic use case of initializing the controller to communicate with
the attached card, reading and writing SD card block.
•SD Host FatFS Application: Uses the FatFS to provide the block-level read/write access to the SD
card, using the SD host controller on the CC3200.
•SPI Demo Application: Displays the required initialization sequence to enable the CC3200 SPI
module in full duplex 4-wire master and slave modes.
•Wi-Fi Audio App: Demonstrates bi-directional audio application on a CC3200 LaunchPad setup. This
application requires the audio boosterpack.
•Camera Application: Demonstrates the camera feature on the CC3200. The user can invoke the
image capture command on the web browser hosting on the CC3200 device. This application requires
the camera boosterpack.
•UART DMA Application: Showcases use of UART, along with uDMA and interrupts.
•Antenna Selection: Gives the option to select an antenna with more signal for APs using a web-
browser.
•Out of Box Application: Demonstrates how the user can view different demo and SDK web links on
their web-browser.
•Peer to Peer Application: Demonstrates the Wi-Fi direct feature on the CC3200.
•Timer Count Capture: Showcases the count capture feature of the timer to measure the frequency of
an external signal.
•Idle Profile: Exercises hibernation using power management framework (middleware).
•Sensor Profile: Exercises low power modes (LPDS) using Power Management Framework
(middleware).
•Watchdog System Demo: Illustrates full system recovery using watchdog, including the network
subsystem.
•TFTP Client: Demonstrates file transfer using TFTP (Trivial File Transfer Protocol). Requires a TFTP
server running on a connected device such as a PC or smart phone.
•WebSocket Camera: Demonstrates websocket HTTP server functionality by transmitting continuous
JPEG frames to a websocket client. This application requires a camera boosterpack and a connected
PC or smartphone with a browser supporting HTML 5.
•Application Bootloader: Showcases the secondary bootloader operations, to manage updates to
application image.
•HTTP Client Demo: Illustrates the usage of the HTTP client library, to enable the device as an HTTP
client.
•Idle Profile (Non OS): Exercises the low power modes (LPDS) using power management framework in
a non-OS environment.
•MQTT Client: Showcases the device acting as a MQTT client in a fully-functional MQTT network.
•MQTT Server: Showcases the device acting as an MQTT server capable of managing multiple local
clients, and allowing the local clients to communicate with remote MQTT clients.
•Power Measurement: Allows the user to measure the current consumption for various low-power
modes.

www.ti.com Foundation SDK – Getting Started
13
SWRU369D–June 2014–Revised May 2018
Submit Documentation Feedback Copyright © 2014–2018, Texas Instruments Incorporated
CC3200 SimpleLink™ Wi-Fi®and IoT Solution, a Single Chip Wireless MCU
Table 1. Package Contents (continued)
Directory Name Information
example •OTA Update: Illustrates over-the-air (OTA) updates of the service pack, user application, and user files.
•Dynamic Library Loader: Exercises an approach to enable dynamic loading of an application-binary
from non-volatile memory while the program is being executed.
Inc • Contains the register definition header files.
Oslib • Contains the interface file to configure Free-RTOS or TI-RTOS.
Middleware • Contains power management framework to provide a simple infrastructure for developers to create a
power aware solution.
NetApps •http: Contains the HTTP (Hyper Text Transfer Protocol) client and server library
•smtp: Contains the SMTP (Simple Mail Transfer Protocol) client library
•tftp: Contains the TFTP (Trivial File Transfer Protocol) client library
•xmpp: Contains the XMPP (Extensive Messaging and Presence Protocol) client library
•json: Contains JSON parser library
•mqtt: Contains the MQTT (Message Queue Telemetry Transport) client and server library
Simplelink • Contains SimpleLink host driver code.
Simplelink_extlib • Contains the OTA (over the air) library
Documents • Documentation for netapps libraries
Third_
party FatFS • Contains the FatFS source files.
FreeRT
OS • Contains the FreeRTOS source files. Current SDK supports FreeRTOS v8.0.1.
Ti_rtos • Contains the Ti RTOS config file and CCS, IAR , GCC projects to support TI-RTOS with all three IDEs.
Current SDK supports TI-RTOS v2.15.00.17.
Tools •ccs_patch – Contains the files required for CCS-FTDI-LP connection.
•iar_patch – Contains the files required for IAR-FTDI-LP connection.
•ftdi - Contains FTDI PC driver.
•gcc_scripts - Contains the scripts to use GCC and openocd with CC3200.
2.3 Prerequisite: Tools to be Installed
Table 2. CC3200 Prerequisite
Tools Remarks Location
Equipment
Computer Running Microsoft® Windows® 7 OS N/A
Development Environment
IAR IAR version 7.20 onwards must be installed. After the
installation, follow the tools\iar_patch\readme.txt to
debug over FTDI.
Installation:
http://www.iar.com/Products/IAR-
Embedded-Workbench/ARM/
Or/and
CCS CCS 6.1.1 version and TI v5.2.6 compiler version. After
the installation, follow the tools\ccs_patch\readme.txt to
debug over FTDI.
Installation:
http://www.ti.com/tool/ccstudio
CC3200 Support package in
CCSv6.1 Though CCS 6.1.1 provides an option to install this add-on during installation, the user must check and
install if a newer version is available.
Refer to Section 5.3.2.1
Or/and
GCC To enable CC3200 SDK development on a Linux
environment. Refer to Section 5.3.3

Foundation SDK – Components www.ti.com
14 SWRU369D–June 2014–Revised May 2018
Submit Documentation Feedback
Copyright © 2014–2018, Texas Instruments Incorporated
CC3200 SimpleLink™ Wi-Fi®and IoT Solution, a Single Chip Wireless MCU
Table 2. CC3200 Prerequisite (continued)
Tools Remarks Location
CC32xx PinMux Utility
CC32xx PinMux Utility.exe Utility to assign a desired personality to the general
purpose pins available at the CC3200 device boundary. Installation: http://processors.wiki.ti.com/index.php/TI_
PinMux_Tool or refer to Section 5.3.2.2
CC32xx Programmer Utility
Uniflash Tool to download firmware, application images, and
certificates to the CC3200 device. http://www.ti.com/tool/uniflash
Support Tools
HyperTerminal or Teraterm Serial communication tool to communicate over the
UART with the CC3200 device.
Iperf A useful tool for measuring TCP and UDP bandwidth
performance.
FTDI Driver FTDI Windows drivers must be installed for a
successful connection to the CC3200 LP over USB.
This FTDI connection can be used for debugging over
JTAG/SWD and communicating over UART.
tools\ftdi
3 Foundation SDK – Components
The CC3200 Foundation SDK package includes two main building blocks:
• SimpleLink Library – This library hosts APIs that serve the connectivity features.
• Peripheral Driver Library – This library hosts APIs to access MCU peripherals.
This section also lists the sample and reference applications packaged in the software development kit.
3.1 SimpleLink Component Library
3.1.1 SimpleLink Modular Decomposition
Figure 7. SimpleLink Modular Composition
TI SimpleLink Framework provides a wide set of capabilities, including basic device management through
wireless network configuration, BSD socket services, and more. For better design granularity, these
capabilities are segregated into individual modules. Each module represents different functionality or
capability of the SimpleLink Framework.

www.ti.com Foundation SDK – Components
15
SWRU369D–June 2014–Revised May 2018
Submit Documentation Feedback Copyright © 2014–2018, Texas Instruments Incorporated
CC3200 SimpleLink™ Wi-Fi®and IoT Solution, a Single Chip Wireless MCU
The following list enumerates the different components in the SimpleLink Framework:
Components Functionality
device • Initializes the host
• Controls the communication with the network processor
wlan • Connection to the access point
• Scan access points
• Add or remove access point profiles
• WLAN security
socket • UDP/TCP client socket
• UDP/TCP server socket
• UDP/TCP Rx/Tx
netapp • DNS resolution
• Ping remote device
• Address resolution protocol
netcfg • IP and MAC address configuration
fs • File system read/write
3.1.2 Using the TI SimpleLink Framework
The TI SimpleLink Framework provides a rich, yet simple set of APIs. For detailed information on the APIs
and their usage, refer to the document docs\simplelink_api\programmers_guide.html available in the SDK.
The TI SimpleLink Framework has a ready-to-use port available in the CC3200 Foundation SDK. The
source code is also shared if further customization is desired by the developer. The following note
describes simple possible customizations and the associated procedure.
NOTE: All modifications and adjustments to the driver should be made in the user.h header file only,
to ensure a smooth transaction to future versions of the driver.
•Modify user.h file – Modify the user.h file that includes the default configurations and adjustments.
•Select the capabilities set required for your application – TI has focused on building a set of
predefined capability sets that fit most target applications. TI recommends trying and choosing one of
these predefined capabilities sets before building a customized set. Once a compatible set is found,
skip the rest of this step. The available sets are:
– # SL_TINY – Compatible with platforms with very limited resources. Provides the best-in-class
footprint in terms of code and data consumption.
– # SL_SMALL – Compatible with most common networking applications. Provides the most common
APIs with a balance between code size, data size, functionality, and performance.
– # SL_FULL – Provides access to all SimpleLink functionalities.
•Memory management model – The SimpleLink driver supports two memory models:
– Static (default)
– Dynamic
The CC3200 default configuration is static. In the dynamic model, the configuration uses the malloc
and free, as defined by the operating system. To define your own memory management, define
these interfaces.
•Asynchronous event handlers routines – The SimpleLink device generates asynchronous events in
certain situations. These asynchronous events can be masked. Provide handler routines to catch these
events. If a handler routine was not provided and the event is received, the driver drops this event
without any indication of a drop.

Foundation SDK – Components www.ti.com
16 SWRU369D–June 2014–Revised May 2018
Submit Documentation Feedback
Copyright © 2014–2018, Texas Instruments Incorporated
CC3200 SimpleLink™ Wi-Fi®and IoT Solution, a Single Chip Wireless MCU
•Interface communication driver – The CC3200 host driver implements an SPI communication
interface. The interface for this communication channel includes four simple access functions:
1. open
2. close
3. read
4. write
The CC3200, SPI implementation uses DMA to increase the utilization of the communication
channel.
•OS adaptation – The SimpleLink driver can run on two kinds of platforms:
– Non-OS / single-threaded (default)
– Multi-threaded
The CC3200 SimpleLink host driver is ported on both non-OS and multi-threaded OS
environments. The host driver is made OS-independent by implementing an OS abstraction layer.
Reference implementation for OS abstraction is available for FreeRTOS and TI-RTOS.
To work in a multi-threaded environment under a different operating system, provide some basic
adaptation routines to allow the driver to protect access to resources for different threads (locking
object) and to allow synchronization between threads (sync objects). In addition, the driver support
runs without a dedicated thread allocated solely to the SimpleLink driver. To work in this mode,
supply a spawn method that enables functions to run on a temporary context.
3.1.3 Switch Between OS, NON-OS, and Debug Configurations
IAR: Choose configuration options from menu Project->Edit configurations-
>OS/NON_OS/PM_Framework/NON_OS_PM/OS_debug/NON_OS_debug/PM_Framework_debug/NON_
OS_PM_debug, as indicated in Figure 8.
Figure 8. CC3200 SimpleLink IAR Config Switch

www.ti.com Foundation SDK – Components
17
SWRU369D–June 2014–Revised May 2018
Submit Documentation Feedback Copyright © 2014–2018, Texas Instruments Incorporated
CC3200 SimpleLink™ Wi-Fi®and IoT Solution, a Single Chip Wireless MCU
CCS: Choose configuration options from menu Project->Build Configurations->Set active, or as indicated
in Figure 9:
Figure 9. CC3200 CCS SimpleLink Config Switch
3.1.4 Development versus Deployment Scenario
To support the usage of the reloading of application image using the debugger without having to reset the
device (LaunchPad), the implementation in the cc_pal* (simplelink) file requires a NwpPowerOnPreamble
routine to stop networking services, and a delay in the NwpPowerOn() function must be introduced for
proper operation.
This is required, as a core reset from the debugger only resets when the APPs processor and the
networking engine are still active. Thus, on the next debug session, the networking engine must be
gracefully stopped and started again. This results in additional delays and greater overall current
consumption. As these additional steps and delay are required only for debugging purposes, they should
not be a part of the deployment applications.
For ease of use, the CC3200 SDK latest package provides separate configurations of SimpleLink library
for the development (debug) and deployment scenarios. The following four items should be used for the
deployment scenario (this does not include the additional steps and delay) as per use-case.
• NON_OS – SimpleLink for NON-OS environment
• OS – SimpleLink for OS environment
• PM_Framework – SimpleLink with power management framework for OS environment
• NON_OS_PM – SimpleLink with power management framework hook
All of these configurations are pre-built in the SDK package, along with their generated output library. By
default, all of the networking examples link to one of these configurations.
The corresponding debug configurations are also present as part of the project.
• NON_OS_debug – SimpleLink for NON-OS environment with debug support
• OS_debug – SimpleLink for OS environment with debug support
• PM_Framework_debug – SimpleLink with power management framework for OS environment with
debug support

Foundation SDK – Components www.ti.com
18 SWRU369D–June 2014–Revised May 2018
Submit Documentation Feedback
Copyright © 2014–2018, Texas Instruments Incorporated
CC3200 SimpleLink™ Wi-Fi®and IoT Solution, a Single Chip Wireless MCU
• NON_OS_PM_debug – SimpleLink with power management framework hook with debug support
These configurations are not pre-built; the user must build them first before linking them to their
application. Note that this will result in overall greater current consumption. Link the networking example to
the debug configurations of the SimpleLink library while debugging to enhance the user experience.
Follow these steps to link the application to the debug configuration.
3.1.4.1 Relinking to the SimpleLink Library in CCS
1. Compile the relevant debug configuration for SimpleLink library.
2. Right-click on the application, and navigate to Properties>ARM Linker>File Search Path.
3. Edit the SimpleLink library path as shown in Figure 10 and Figure 11.
Figure 10. File Search Path

www.ti.com Foundation SDK – Components
19
SWRU369D–June 2014–Revised May 2018
Submit Documentation Feedback Copyright © 2014–2018, Texas Instruments Incorporated
CC3200 SimpleLink™ Wi-Fi®and IoT Solution, a Single Chip Wireless MCU
Figure 11. Edit Directory Path
3.1.4.2 Relinking to the SimpleLink Library in IAR
1. Compile the relevant debug configuration for the SimpleLink library.
2. Right-click on the application, and navigate to Options>Linker>Library.
3. Edit the SimpleLink library path as shown in Figure 12 and Figure 13.

Foundation SDK – Components www.ti.com
20 SWRU369D–June 2014–Revised May 2018
Submit Documentation Feedback
Copyright © 2014–2018, Texas Instruments Incorporated
CC3200 SimpleLink™ Wi-Fi®and IoT Solution, a Single Chip Wireless MCU
Figure 12. Edit SimpleLink Library Path
Figure 13. Edit SimpleLink Library Path