CC3200 SimpleLink Wi-Fi and Internet-of-Things Solution, a single-chip wireless MCU

Transcription

1 CC3200 SimpleLink Wi-Fi and Internet-of-Things Solution, a single-chip wireless MCU Pre-production devices and Software Development Kit (SDK) v0.5.1 Release Notes PAGE: 1/20

2 TABLE OF CONTENTS 1 INTRODUCTION GETTING STARTED RELEASE CONTENT DIRECTORY STRUCTURE OF SDK NETWORKING FEATURES WI-FI NETWORKING PROTOCOLS ADVANCED FEATURES POWER MODES ADVANCED INFORMATION NETWORKING SAMPLE APPLICATIONS ANTENNA SELECTION CONNECTION POLICIES SEND ENTERPRISE NETWORK CONNECTION FILE SYSTEM GET TIME GET WEATHER GETTING STARTED IN AP MODE GETTING STARTED IN STA MODE HTTP SERVER MDNS MODE CONFIGURATION NWP FILTERS P2P (WI-FI DIRECT) PROVISIONING AP PROVISIONING WITH SMARTCONFIG PROVISIONING WITH WPS SCAN POLICY SSL/TLS TCP SOCKET TRANSCEIVER MODE UDP SOCKET XMPP CLIENT FILE DOWNLOAD DEEP-SLEEP PAGE: 2/20

3 7.26 HIBERNATE SERIAL WI-FI OUT OF BOX APPLICATION WI-FI AUDIO CAMERA APPLICATION SENSOR PROFILE IDLE PROFILE MCU SAMPLE APPLICATIONS LED BLINK TIMER DEMO WATCHDOG DEMO UART DEMO INTERRUPT APPLICATION I2C DEMO MCU SLEEP-DS UDMA APPLICATION FREERTOS DEMO AES DEMO DES DEMO CRC DEMO SHA-MD5 APPLICATION ADC DEMO APPLICATION PWM DEMO SD HOST DEMO SDHOST FATFS DEMO SPI DEMO UART DMA TIMER COUNT CAPTURE ERRATA FUNCTIONALITY PRE-REGULATED 3.3V TO PIN POWER CONSUMPTION INCREASE RAM SIZE MCU LOW-POWER DEEP SLEEP (LPDS) PERIPHERALS DRIVER LIBRARY NETWORK PROCESSOR PERFORMANCE WI-FI KNOWN ISSUES NETWORKING KNOWN ISSUES HOST APPLICATIONS KNOWN ISSUES APPLICATIONS KNOWN ISSUES PAGE: 3/20

4 1 Introduction This document describes the pre-production Software Development Kit (SDK) version for use with the pre-production CC3200 SimpleLink Wi-Fi MCU device mounted on the CC3200 LaunchPad evaluation kit. This pre-production release of the SDK and the CC3200 device has minor performance limitations which are listed as errata in section 9 of this document. Texas Instruments will release the production version of the CC3200 device with updated development boards and an updated SDK during summer of Getting Started Please follow the on-line CC3200 Quick Start Guide to start using the CC3200 LaunchPad development platform. Please download the CC3200 Getting Started Guide to get started with your project development. PAGE: 4/20

5 3 Release Content Item Version Type Device XCC3200ZH Pre-production device Development boards CC3200-LAUNCHXL Rev3.2 Orderable from TI SDK Installer CC3200SDK windows-installer.exe For Windows 7 and Windows XP Provided with a click wrap license Firmware Binary, pre-flashed on the CC3200LAUNCHXL board Network Processor host Version Source code driver MCU Version Source code Peripherals Drivers Power Management Version Source code Framework Library Supported IDE IAR version : 7.20 Delivered separately CCS version : 6.0 Demo Embedded HTML web-site Pre-flashed on LaunchPad and source code provided User guides CC3200 Getting started guide CC3200LAUNCHXL User Guide SimpleLink Host Driver Programmer s PDF PDF Doxygen HTML Guide Tools USB driver for CC3200LAUNCHXL for Windows7 and Windows XP Executable PAGE: 5/20

6 4 Directory structure of SDK Double-Click on the package to copy the directories (and files) to the preferred location. The first level directory structure is as shown in the table below. Directory Name Content Docs SimpleLink Host Driver Programmer s Guide Peripheral Driver Library User s Guide Power Management Framework Guide Application notes for sample applications Examples Example application in source code Driverlib Peripheral driver library source files The driverlib.a is also provided in CCS and IAR directories Inc Register definition header files middleware Power management framework providing an easy to use infrastructure for power aware solution Oslib Interface file to configure Free-RTOS or TI-RTOS SimpleLink The SimpleLink host driver code. simplelink.a, simplelink_nonos.a and simplelink_pm are available in CCS and IAR directories. For GCC compiler simplelink.a and simplelink_nonos.a are available in gcc folder. third_party FatFS source files FreeRTOS souce files ti_rtos Abstraction layer files for TI-RTOS tools ccs_patch Files required for CCS-FTDI-LP connection Iar_patch Files required for IAR-FTDI-LP connection ftdi- Contains CC3200 FTDI-USB driver for Windows PAGE: 6/20

7 5 Networking features 5.1 Wi-Fi Standards b/g/n Station and Wi-Fi Direct Client Supported Channels 1-13 Personal Security WEP, WPA and WPA2 Enterprise Security WPA-2 Enterprise EAP Fast, EAP PEAPv0 MSCHAPv2, EAP PEAPv0 TLS, EAP PEAPv1 TLS, EAP TLS, EAP TTLS TLS, EAP TTLS MSCHAPv2 Provisioning SmartConfig TM technology Wi-Fi Protected Setup (WPS2) Access Point mode with internal HTTP Web Server Standards b/g Access Point and Wi-Fi Direct Group Owner Clients 1 Personal Security WEP, WPA and WPA2 5.2 Networking protocols IP Transport Cross-Layer Application Transport Layer Security IPv4 UDP TCP RAW ICMP DHCP ARP DNS mdns DNS-SD HTTP 1.0 web server SSLV3 SSL_RSA_WITH_RC4_128_SHA SSLV3 SSL_RSA_WITH_RC4_128_MD5 TLSV1 TLS_RSA_WITH_RC4_128_SHA TLSV1 TLS_RSA_WITH_RC4_128_MD5 TLSV1 TLS_RSA_WITH_AES_256_CBC_SHA TLSV1 TLS_DHE_RSA_WITH_AES_256_CBC_SHA TLSV1 TLS_ECDHE_RSA_WITH_RC4_128_SHA TLSV1 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA TLSV1_1 TLS_RSA_WITH_RC4_128_SHA TLSV1_1 TLS_RSA_WITH_RC4_128_MD5 TLSV1_1 TLS_RSA_WITH_AES_256_CBC_SHA PAGE: 7/20

8 User application sockets 5.3 Advanced Features Transceiver Traffic Filters TLSV1_1 TLS_DHE_RSA_WITH_AES_256_CBC_SHA TLSV1_1 TLS_ECDHE_RSA_WITH_RC4_128_SHA TLSV1_1 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA TLSV1_2 TLS_RSA_WITH_RC4_128_SHA TLSV1_2 TLS_RSA_WITH_RC4_128_MD5 TLSV1_2 TLS_RSA_WITH_AES_256_CBC_SHA TLSV1_2 TLS_DHE_RSA_WITH_AES_256_CBC_SHA TLSV1_2 TLS_ECDHE_RSA_WITH_RC4_128_SHA TLSV1_2 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA Up to 8 open sockets Up to 2 secured application sockets: - One server (listen socket and accept socket) + client (data socket) - Up to two clients (data socket) Transmit and Receive raw Wi-Fi packets with full control over payload. Wi-Fi disconnect mode. Can be used for general-purpose applications (e.g. tags, sniffer, RF tests) Embedded filters to reduce power consumption and Wake-on-LAN trigger packets (IP and MAC layer) 5.4 Power modes MCU Power Management framework library allows user applications to exploit the following device power management modes: Sleep Low Power Deep Sleep Hibernate The Wi-Fi network processor core supports the following low power policies Low Power mode Configurable Power Policies Uses Power Save and Device Deep Sleep Power with three user configurable policies Normal (Default) - Best tradeoff between traffic delivery time and power performance Low power Used only for Transceiver mode application (Disconnect mode) Long Sleep Interval wakes up for the next DTIM after a configurable sleep interval, up to 2 seconds. This policy is only applicable for client socket mode PAGE: 8/20

9 5.4.1 MCU Peripheral Interface Drivers Drivers and example applications are provided in the SDK package for the following peripheral interfaces - ADC AES CAMERA CRC DES GPIO I2C Interrupt I2S PinMux PRCM SDHost SHAMD5 SPI Systick Timer UART UDMA WDT Analog to digital converter. Advanced encryption standard Parallel interface (8 bits) that can be used to connect to camera sensors. Cyclic redundancy check Data encryption standard. General purpose input/output Standard I2C interface to communicate with various sensors Interrupt module Audio signal processor Pinmux setting for Pads Power reset and clock module Secure digital host controller Secure hash algorithm, message digest algorithm Serial peripheral interface System tick functionality General purpose timers Standard UART interface Direct memory access Watchdog timer PAGE: 9/20

10 6 Advanced information TCP/IP o TCP Window size is 16KB, divided between application sockets. o IP Fragmentation is not supported for Tx UDP and RAW sockets o Max Tx payload for Raw packet with IP header is 1460 bytes o Max Tx payload for Raw Transceiver is 1488 bytes SSL/TLS Certificates o Certificate Authority (CA) certificates needs to be installed if server authentication is required o CA Certificate key size up to 2048 bit WEP o Supporting only WEP open using ASCII pre shared key WPS o Up to 4 seconds delay between association and EAPOL-Start SmartConfig o Not supported with 5GHz AP (802.11a/n/ac) o Not supported for MIMO-capable configuration devices o Only Group 0 is supported in auto start mode Tx Power o Tx power in AP mode takes effect only after reset Wi-Fi Direct o In Group Owner mode FAST connection policy has to be set to TRUE Rx Filters o BSSID can't be filtered while STA is connected (if filtered will cause disconnection) Power Management o The device will remain in active after initialization until the host reads all events File System o Up to 100 user files, file size is not limited MCU Deep Sleep Mode o User Application should handle the behavior that MCU Deep Sleep mode invocation leads to change in Peripheral Clocks (Frequency gets reduced by a factor of 2 ) Serial Flash CC3200 supports JEDEC specification compliant Serial Flash devices with 4Kbyte sector size erase. The following parts were validated: o Micron N25Q128-A13BSE40 128Mbit o Spansion S25FL208K 8Mbit o Winbond W25Q16V 16Mbit o Adesto AT25DF081A 8Mbit o Macronix MX25L12835F-M2 128Mbit PAGE: 10/20

11 7 Networking sample applications The release package includes several sample applications developed for the CC3200 Cortex M4 processor. The applications come with - Detailed Application Note (readme documents) - Project files for IAR, CCS or Both as well as GCC makefiles for a few applications 7.1 Antenna Selection This is a reference implementation for antenna-selection scheme running on the CC3200 MCU, to enable improved radio performance inside buildings 7.2 Connection Policies This application demonstrates the usage of the CC3200 profiles and connection-policies. 7.3 Send This application sends an using SMTP to a user-configurable address at the push of a button. 7.4 Enterprise Network Connection This application demonstrates the procedure for connecting the CC3200 to an enterprise network. 7.5 File System This application demonstrates the use of the file system API to read and write files from the serial Flash. 7.6 Get Time This application connects to an SNTP cloud server and receives the accurate time. 7.7 Get Weather This application connects to Open Weather Map cloud service and receives weather data. 7.8 Getting Started in AP Mode This application configures the CC3200 in AP mode. It verifies the connection by pinging the connected client. PAGE: 11/20

12 7.9 Getting Started in STA Mode This application configures the CC3200 in STA mode. It verifies the connection by pinging the connected Access Point HTTP Server This application demonstrates using the on-chip HTTP Server APIs to enable static and dynamic web page content MDNS This application registers the service for broadcasting and attempts to get the service by the name broadcasted by another device Mode Configuration This application demonstrates switching between STA and AP modes NWP Filters This application demonstrates the configuration of Rx-filtering to reduce the amount of traffic transferred to the host, and to achieve lower power consumption P2P (Wi-Fi Direct) This application configures the device in P2P (Wi-Fi Direct) mode and demonstrates how to communicate with a remote peer device Provisioning AP This application demonstrates the use of the on Chip HTTP server for Wi-Fi provisioning in AP Mode, building upon example application 7.8 above. PAGE: 12/20

13 7.16 Provisioning with SmartConfig This application demonstrates the usage of TI's SmartConfig Wi-Fi provisioning technology. The Wi-Fi Starter Application for ios and Android is required to use this application. It can be downloaded from following link: or from the Apple App store and Google Play Provisioning with WPS This application demonstrates the usage of WPS Wi-Fi provisioning with CC Scan Policy The application demonstrates the scan-policy settings in CC SSL/TLS The application demonstrates the usage of certificates with SSL/TLS for application traffic privacy and device or user authentication 7.20 TCP Socket The application demonstrates simple connection with TCP traffic Transceiver Mode The application demonstrates the CC3200 transceiver mode of operation UDP Socket The application demonstrates simple connection with UDP traffic XMPP Client The application demonstrates instant messaging using a cloud based XMPP server File Download This application demonstrates file download from a cloud server to the on board serial Flash Deep-sleep This application demonstrates the deep-sleep low power mode a networking application Hibernate This application demonstrates the hibernate ultra-low-power mode in a networking application using an UDP client. PAGE: 13/20

14 7.27 Serial Wi-Fi This application implements a wireless terminal over a Wi-Fi network and an AT commands like control interface 7.28 Out of Box Application This application demonstrates the out of box experience where user can view different demo and SDK web links on their web-browser Wi-Fi Audio This application demonstrates Bi-directional wireless audio on a CC3200 LaunchPad. It uses two LaunchPad boards in STA mode and streams the audio from one LaunchPad to the other Camera Application This example demonstrates image capture using the CC3200 fast parallel interface 7.31 Sensor Profile This application shows how to use hibernate mode through the Power Management Framework 7.32 Idle Profile This Application exercises low power modes (LPDS) using Power Management Framework (middleware). 8 MCU sample applications 8.1 LED Blink This application uses the GPIO DriverLib APIs to blink an LED on the CC3200 Launchpad. 8.2 Timer Demo This application demonstrates the CC3200 timer DriverLib APIs. It uses 16 bit timers to generate interrupts which in turn toggle the state a GPIO driving LEDs. 8.3 Watchdog Demo This application demonstrates the use of the Watch Dog timer (WDT) DriverLib APIs. It shows how the watchdog timer resets the device on system failure. PAGE: 14/20

15 8.4 UART Demo This application uses the UART DriverLib APIs to demonstrate typing echo on a UART terminal. 8.5 Interrupt Application This application uses the Interrupt DriverLib APIs to demonstrate the CC3200 MCU interrupt preemption and tail-chaining capabilities. 8.6 I2C Demo This application uses the I2C DriverLib APIs to read and write the I2C peripherals on the CC3200 LaunchPad. 8.7 MCU Sleep-DS This application demonstrates the Sleep and Deep Sleep modes of the CC3200 MCU. 8.8 udma Application This application uses the UDMA DriverLib APIs to show various DMA mode functionalities. 8.9 FreeRTOS Demo This application demonstrates using FreeRTOS for multiple task creation and inter-task communication using queues AES Demo This application uses the AES Driverlib APIs to exercise various AES encryption modes DES Demo This application uses the DES Driverlib APIs to exercise various AES encryption modes CRC Demo This application uses the CRC Driverlib APIs to exercise various CRC calculation modes SHA-MD5 Application This application uses the SHA-MD5 Driverlib APIs to to exercise various SHA-MD5 modes ADC Demo Application This application demonstrates the C3200 ADC module using the Driverlib APIs. PAGE: 15/20

16 8.15 PWM Demo This application demonstrates the PWM mode of the CC3200 General Purpose Timers (GPT) SD Host Demo This application demonstrates the functionality of the Secure Digital Host (SD Host) controller of CC3200, which interfaces with standard SD memory cards in 1-bit transfer mode SDHost FatFS Demo This application uses the FatFS library for block level read/write access to SD card, using the SD Host controller on CC SPI Demo This application shows the initialization sequence that enables the CC3200 SPI module in full duplex 4-wire master and slave modes UART DMA This application demonstrates using the CC3200 UART interface with udma and interrupts Timer Count Capture This application demonstrates measuring the frequency of an external signal using the CC3200 Timer count capture feature. PAGE: 16/20

17 9 Errata The following section covers known issues and performance limitations with SDK and the CC3200 pre-production devices. TI will release the CC3200 production devices with SDK during summer 2014 that will remove some of the limitations as described ahead. 9.1 Functionality 9.2 Pre-regulated 3.3v to Pin 47 For preproduction devices connect an external pre-regulated 3.3v +/- 5% supply to pin 47 (VDD_ANA2). This adds 12mA average current and up to 100mA peak current over 20uSec to the total system current at 3.3V. The CC300 LaunchPad version 3.2 already includes the correct supply configuration for the pre-production device and also adds a 10uF capacitor to filter the peak currents. No further action is required. The external 3.3V supply is not required in the CC3200 production device in which case pin 47 can be left not connected. If pin 45 is used in the production device as a GPIO, pin 47 has to be connected to any on-board power supply. 9.3 Power consumption increase Power consumption of the CC3200 pre-production device in all active modes is 1-2 ma higher compared to the CC3200 production devices 9.4 RAM size Preproduction device have 192 Kbyte RAM available for user application. The production devices will have 256 Kbyte RAM available 9.5 MCU Low-Power Deep Sleep (LPDS) Pre-production devices do not support LPDS mode. 9.6 Peripherals driver library On CC3200 pre-production devices the peripheral driver library needs to be compiled and executed from RAM. On CC3200 production device, the peripheral driver library is burned in the device ROM leaving more RAM space for user applications. PAGE: 17/20

18 9.7 Network Processor Performance Item SDK SDK ** MCU-NWP SPI link 13 MHz 20 MHz Init time from hibernate until device ready for networking 250 msec 50 msec Init time from hibernate until WPA2 connection * 300 msec 95 msec Maximum UDP throughput, open socket 13 Mbps 16 Mbps Maximum TCP throughput, open socket 11 Mbps 12 Mbps Maximum TLS/SSL throughput with RC4_128 cipher 5 Mbps 8 Mbps Maximum TLS/SSL throughput with AES_256 cipher 7 Mbps 8 Mbps Minimum TLS/SLL connection time with ECC cipher 2.5 Sec 1.4 Sec Minimum TLS/SSL connection time with RSA cipher 200 msec 150 msec * Excluding user application boot time ** SDK target performance based on CC3200 production device 9.8 Wi-Fi known issues ID MCS Title Wi-Fi Direct connection can fail at first attempt Description Negotiation with peer device is not always successful at first attempt Impact The first connection doesn t success Workaround Repeat the connection attempt Fix Expected Will be improved in SDK ID MCS Title Scan during connection process Description Cannot invoke a scan command while trying to connect Impact Scan command might interfere with connection process Workaround Avoid calling scan during connection Fix Expected Fix expected in SDK ID MCS Title Adding profile using Fast connection-policy Description The profile has to be explicitly added when using Fast connection-policy Impact Connection policy with Fast will not connect automatically if profile is not added explicitly. Workaround Add the profile manually Fix Expected Fix expected in SDK PAGE: 18/20

19 9.9 Networking known issues ID Title Description Impact Workaround ID Title Description Impact ID Title Description Impact MCS sl_netappdnsgethostbyname returns with no answer In high Rx traffic conditions some DNS packets can be dropped, causing GetHostByName to fail No answer on request Upon error return status call the API again MCS Failing IXIA invalid DHCP test case Failing IXIA test case for RFC2131 Device IP address will not be updated when receiving a malformed DHCPACK packet MCS Failing IXIA malformed ICMP header test case Failing IXIA test case 5.1 for handling malformed ICMP header None 9.10 Host applications known issues ID Title Description Impact Workaround ID Title Description Impact Workaround Fix Expected MCS WPS PIN Connect failure if pin code is not null-terminated If the PIN code from the HOST is not null terminated connection can fail in some cases Connection failure Add null termination to the PIN code string MCU During Debug, the path for driverlib or simplelink related files needs to be specified explicitly by the user This is due to IAR/CCS IDE generate *.a library with static path embed in it. Clean Build Required for debug sessions Build Driverlib and Simplelink project before building any example project. TBD PAGE: 19/20

20 9.11 Applications known issues ID Title Impact ID Title Impact Workaround MCS In AP mode the internal DNS Server cannot be disabled Cannot use external DNS server in AP mode MCS 'AnyP2P' and 'Auto smart config' policies can be changed only in station or P2P mode Can t change these specific configurations from the HTTP server in AP mode Change the configurations while in STA mode PAGE: 20/20