TI-RTOS 2.12.00.24 Release Notes

This release note is divided into the following sections:

Introduction, Documentation, Products Included, What's New, Upgrade & Compatibility Information, Host Support, Dependencies, Target and Compiler Support, Validation Info, Known Issues, Examples, Version Information, Technical Support.

Introduction

This is the GA (production) release of TI-RTOS 2.12.00. TI-RTOS delivers components that enable engineers to develop applications on Texas Instruments micro-controller devices. The product is comprised of multiple software components and examples of how to use these components together. TI-RTOS gives developers a one-stop RTOS solution for developing applications for TI embedded microcontrollers. It provides an OS kernel, communications support, drivers, and more. It is tightly integrated with the Code Composer Studio development environment. In addition, examples are provided to demonstrate the use of each functional area and each supported device and as a starting point for your own projects. The TI-RTOS 2.12.00 release includes the TI-RTOS for the MSP43x product only; the upcoming TI-RTOS 2.12.01 release will include the remaining TI-RTOS products (i.e., for C2000, TivaC, and SimpleLink). This release note covers all the TI-RTOS products:

Product	Kernel (SYS/BIOS)	Instrumentation (UIA)	Wired Networking (NDK)	Wireless Networking	IPC	Drivers (see Getting Started Guide for more details)	*Ware
TI-RTOS for C2000	Included	Included	Included (M3-only)	Included (M3-only)	included	Included (M3-only)	Included (MWare)
TI-RTOS for MSP43x	Included	Included	Not included	Included	Not included	Included	Included (MSPWare)
TI-RTOS for TivaC	Included	Included	Included	Included	Not included	Included	Included (TivaWare)
TI-RTOS for SimpleLink™ Wireless MCUs	Included	Included	Not included	Included	Not included	Included	Included (cc3200-driverlib)

Documentation

The following documentation is available:

Getting Started Guide
User Guide
TI RTOS Manifest
TI-RTOS Wiki

Release notes from previous releases are also available in the release notes archive directory.

Products Included

The following is a list of all the products bundled into the TI-RTOS installation (with exceptions as noted).

bios_6_41_03_51
uia_2_00_02_39
ipc_3_30_01_12 (valid only for TI-RTOS for C2000 product)
ndk_2_24_02_26_eng (valid only for TI-RTOS for C2000 and TivaC products)
xdctools_3_31_00_24* (included only in stand-alone installer. It is not included via an App Center download)
CC3200_driverlib_1.1.0 (valid only for TI-RTOS for SimpleLink™ Wireless MCUs product).
MSPWare 2_00_00_40a** (valid only for TI-RTOS for MSP43x product).
MWare_v202a** (valid only for TI-RTOS for C2000 product).
TivaWare_C_Series-2.1.0.12573c** (valid only for TI-RTOS for TivaC product).

* XDCtools is installed at the same level at TI-RTOS. If the xdctools_3_31_00_24 version is already present at that location, that version is used.
** refer to <TIRTOS_Install_dir>\products\<*Ware>\TI-RTOS.README for more details

What's New

Please refer to the Getting Started Guide and/or User Guide for more detail about the following new features.

Support for MSP432 devices, including drivers and examples.
TI-RTOS has moved to the new MSPWare 2.00.00 product. Because of this, peripheral drivers (USCI & EUSCI) were updated, and deprecated APIs were replaced with APIs that are compliant with the new Texas Instruments coding standards.
CC3200 Power Management support.
Addition of networking examples over a serial connection using PPP.
Support for SimpleLink CC3000 Wi-Fi devices was dropped -- the TI-RTOS WiFi driver and the CC3000 host driver have been removed from the product.
Support for some older boards -- EK_LM4F120XL and ESK-LM4F232 -- were removed from the product.

Defects Fixed in this release

ID	Severity	Headline
SDOCM00114295	Major	EMAC driver for TM4C129 has race condition if EMAC_init is called from a Task
SDOCM00114670	Major	SPI driver for Tiva is spinning in the hwi for TivaC but not for snowflake
SDOCM00114978	Major	Drivers with "cancel" API have a race condition to release power constraints
SDOCM00115141	Major	I2CTiva_close needs to conditionally call Semaphore_destruct on transferComplete semaphore
SDOCM00115194	Major	UART driver open calls UART_close() on failure before setting Power dependency
SDOCM00115241	Major	GPIO_init (Tiva) causes an assert when instrumented
SDOCM00113733	Minor	ROV for UART with DMA is broken
SDOCM00113895	Minor	TIRTOS docs need to spell out any jumper or switch settings needed for fatsd usb copy example
SDOCM00114138	Minor	Need to document SDSPITiva_HwAttrs fields better
SDOCM00114323	Minor	EK_TM4C1294XL init_I2C and init_SPI configure the same pins
SDOCM00114477	Minor	USBCDCD.h needs to include stdbool.h
SDOCM00114977	Minor	manifest sub section title should be bolded and underlined
SDOCM00115117	Minor	WiFiC3100 drivers should not call sl_Disconnect & sl_Stop in the WiFi_close API

Upgrade and Compatibility Information

When migrating an application that uses TI-RTOS 2.10.xx to TI-RTOS 2.12.00.24, the following steps must be taken:

The API calls sl_WlanDisconnect() & sl_Stop() were removed from the WiFI_close() API. The Application must call these APIs prior to calling WiFi_close().
Several of the driver's parameter structures changed. Additional fields were added to the end. If <driver>_Params_init() is used to initialize the structure and the application is recompiled against the new version of TI-RTOS, there are no breaks in compatibility.
UARTCC3200_HWAttrs and UARTTiva_HWAttrs were changed. It now supports hardware flow control options defined by DriverLib and requires an additional buffer to receive data in the background (interrupt-driven).

Host Support

Supported Operating Systems:

Windows 7, Windows XP, Windows Vista
Linux [RH4], Ubuntu [10.04]

Dependencies

This release requires the following other software components and tools versions to successfully function:

CCS 6.1.0 or higher
IAR for ARM 7.30.1 or higher
IAR for MSP430 5.60.1 or higher
Compiler versions are noted in the next section

Target and Compiler Support

The following table contains the targets available for each product. It also contains the compiler toolchains that were used to build the TI-RTOS binaries.

Product	Supported Targets	Compiler Toolchains	Compiler Versions
TI-RTOS for C2000	ti.targets.arm.elf.M3 ti.targets.C28_float ti.targets.C28_large	Texas Instruments	5.2.2 (M3) 6.2.5 (C28)
TI-RTOS for MSP43x	ti.targets.msp430.elf.MSP430X iar.targets.msp430.MSP430X_small ti.targets.arm.elf.M4F iar.targets.arm.M4F gnu.targets.arm.M4F	Texas Instruments	4.4.2
		IAR	5.60.1
		Texas Instruments	5.2.2
		IAR	7.30.1
		GCC (in CCS)	gcc-arm-none-eabi-4_8-2014q3
TI-RTOS for TivaC	ti.targets.arm.elf.M4F iar.targets.arm.M4F gnu.targets.arm.M4F	Texas Instruments	5.2.2
		GCC (in CCS)	gcc-arm-none-eabi-4_8-2014q3
		IAR for ARM	7.30.1
TI-RTOS for SimpleLink™ Wireless MCUs	ti.targets.arm.elf.M4 iar.targets.arm.M4 gnu.targets.arm.M4	Texas Instruments	5.2.2
		GCC (in CCS)	gcc-arm-none-eabi-4_8-2014q3
		IAR for ARM	7.30.1

Validation Information

This release was validated using the following components:

CCS 6.1.0
IAR for ARM 7.7.31
IAR for MSP430 5.60.1
xdctools_3_31_00_24 (in CCS 6.1 or included in TI-RTOS stand-alone installer)

Known Issues

There are several know issues with this release that will be fixed in the GA release.

IO parking is not yet implemented for GPIO pins. This results in higher electrical current measurements in LPDS.
The 3rd party vendor that produces the SSL product integrated with TI-RTOS, wolfSSL, Inc. has renamed their CyaSSL product to wolfSSL, with a corresponding change to the product's API. However, this release of TI-RTOS is integrated with the old API, so users will need to download the older CyaSSL product from here.

ID	Headline
SDOCM00099460	ping flood causes Concerto board to stop receiving interrupts
SDOCM00101155	usbmsc_SDOCM00100493 fails regression testing (Intermittent spin lock in USB library's USBHCDPipeRead() for LM4F232)
SDOCM00104253	MSP430 Launchpad ez-FET UART emulation issue at buadrate > 28.8kbps
SDOCM00104686	UART in Stellaris launchpad not working above 9600 baud when used with windows apps that use rxtxSerial.dll driver
SDOCM00105778	MSP430 UART logging to System Analyzer does not work
SDOCM00106264	UART driver doesn't handle RX FIFO overruns.
SDOCM00107276	ROV for GPIO exception if opened before Board_initGeneral() is called
SDOCM00107319	makedef's XDCTOOLS_JAVA_HOME default is bad in supplied examples for stand-alone installer
SDOCM00107337	BIOS and UIA examples will not link with default MSP430FR5969 linker file.
SDOCM00107366	Grlibdemo on MSP430FR5969LP not working for IAR
SDOCM00107701	TI-RTOS filters out BIOS' 64T libraries
SDOCM00108264	UIA hello and stairstep examples do not build for some MSP430 devices
SDOCM00108323	TI-RTOS uninstall broke my build environment
SDOCM00113569	Multi-master support for I2C drivers
SDOCM00113961	More info on setting up WiFi examples and h/w needed
SDOCM00115174	TI-RTOS Makefiles should not use semihosting (or an easy option to enable/disable it)

Examples

There are driver examples for the following boards:

CC3200_LP
TMDXDOCKH52C1
TMDXDOCK28M36
EK_TM4C123GXL
DK_TM4C123G
DK_TM4C129X
EK-TM4C1294X
MSP_EXP430F5529LP
MSP_EXP430F5529
MSP-EXP430FR5969LP

There are also kernel and instrumentation examples for all supported devices.Please refer to the Getting Started Guide for more details.

Version Information

All releases have 4 digits (M.mm.pp.bb). This includes GA and pre-releases (engineering, EA, beta, etc.). Pre-releases are denoted with a suffix (e.g. 1.01.00.15_eng or 1.01.00.21-beta).

This product's version follows a version format, M.mm.pp.bb, where M is a single digit Major number, mm is 2 digit minor number, pp is a 2 digit patch number, and b is an unrestricted set of digits used as an incrementing build counter.

To support multiple side-by-side installations of the product, the product version is encoded inEK-TM4C1294XL the top level directory, ex. tirtos_1_00_01_11.

Subsequent releases of patch upgrades will be identified by the patch number, ex. TI-RTOS 1.00.00.68 with directory tirtos_1_00_01_70. Typically, these patches only include critical bug fixes.

Please note that version numbers and compatibility keys are NOT the same. For an explanation of compatibility keys, please refer to the 'Upgrade and Compatibility Information' section.

Technical Support

For technical support, please refer to the Texas Instruments E2E TI-RTOS Support Forum http://e2e.ti.com/support/embedded/tirtos/default.aspx or other forums in http://e2e.ti.com/ as needed.

Last updated: March 24, 2015