Texas Instruments Technology for Innovators(tm)

TI-RTOS 2.12.01.33 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.01. 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. This release notes covers all of the TI-RTOS products (i.e., for C2000, TivaC, and SimpleLink).

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:

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). 
* 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.

Defects Fixed in this release:

IDSeverityHeadline
SDOCM00114295S2 - MajorEMAC driver for TM4C129 has race condition if EMAC_init is called from a Task
SDOCM00114670S2 - MajorSPI driver for Tiva is spinning in the hwi for TivaC but not for snowflake
SDOCM00114978S2 - MajorDrivers with "cancel" API have a race condition to release power constraints
SDOCM00115141S2 - MajorI2CTiva_close needs to conditionally call Semaphore_destruct on transferComplete semaphore
SDOCM00115157S2 - Major"gmake -f tirtos.mak drivers" is broken for simplelink windows
SDOCM00115194S2 - MajorUART driver open calls UART_close() on failure before setting Power dependency
SDOCM00115241S2 - MajorGPIO_init (Tiva) causes an assert when instrumented
SDOCM00115452S2 - Majorrebooting NDK results in driver error: EMACSnow_InitDMADescriptors: PBM_alloc error
SDOCM00115476S2 - MajortcpEcho* calls setsockopt() with an uninitialized variable
SDOCM00115479S2 - MajorI2C CC3200 does not unregister nofity objects on close
SDOCM00115558S2 - MajorUART_readPolling doesn't work with UART ringbuffered drivers
SDOCM00115596S2 - MajorMSP43x SPI drivers frame format are out of phase.
SDOCM00115632S2 - MajorPower_shutdown for CC3200 interprets shutdownTime as a microsecond value
SDOCM00115664S2 - MajorBad Assert in PWMTImerMSP432.c
SDOCM00115729S2 - MajorGNU makefiles are not linking in reentrant BIOS runtime support libraries
SDOCM00115790S2 - MajorSPI loopback shows erroneous data for MSP432
SDOCM00113733S3 - MinorROV for UART with DMA is broken
SDOCM00113895S3 - MinorTIRTOS docs need to spell out any jumper or switch settings needed for fatsd usb copy example
SDOCM00114138S3 - MinorNeed to document SDSPITiva_HwAttrs fields better
SDOCM00114323S3 - MinorEK_TM4C1294XL init_I2C and init_SPI configure the same pins
SDOCM00114477S3 - MinorUSBCDCD.h needs to include stdbool.h
SDOCM00114977S3 - Minormanifest sub section title should be bolded and underlined
SDOCM00115117S3 - MinorWiFiC3100 drivers should not call sl_Disconnect & sl_Stop in the WiFi_close API
SDOCM00115442S3 - MinorRemove System_flush from spiloopback_perf_level_transfers.c
SDOCM00115443S3 - MinorwifiHandle initialization code being optimized-out by GNU compiler
SDOCM00115445S3 - MinorOSAL regression tests need to pass
SDOCM00115446S3 - MinorGPIO driver writing to an input or reading from an output assertions need to be added
SDOCM00115478S3 - Minorclean-cyassl and cyassl should be listed in tirtos.mak "help"
SDOCM00115570S3 - MinorRemove nortos from the ports directory



Upgrade and Compatibility Information

When migrating an application that uses TI-RTOS 2.10.xx to TI-RTOS 2.12.01.33, the following items must be taken into account:

Host Support

Supported Operating Systems:

Dependencies

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


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 Texas Instruments 4.4.2
iar.targets.msp430.MSP430X_small IAR for MSP430 5.60.x
ti.targets.arm.elf.M4F Texas Instruments 5.2.2
iar.targets.arm.M4F IAR for ARM 7.40.2
gnu.targets.arm.M4F 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:

Known Issues

There are some known issues with this release:
IDSeverityHeadline
SDOCM00099460S2 - Majorping flood causes Concerto board to stop receiving interrupts
SDOCM00101155S2 - Majorusbmsc_SDOCM00100493 fails regression testing (Intermittent spin lock in USB library's USBHCDPipeRead() for LM4F232)
SDOCM00104253S2 - MajorMSP430 Launchpad ez-FET UART emulation issue at buadrate > 28.8kbps
SDOCM00104686S2 - MajorUART in Stellaris launchpad not working above 9600 baud when used with windows apps that use rxtxSerial.dll driver
SDOCM00115790S2 - MajorSPI loopback shows erroneous data for MSP432
SDOCM00105778S3 - MinorMSP430 UART logging to System Analyzer does not work
SDOCM00106264S2 - MajorUART driver doesn't handle RX FIFO overruns.
SDOCM00115853S2 - MajorUART_write for CC3200 may retransmit the last character at baudrates > 115200
SDOCM00107260S3 - MinorROV view for GPIO doesn't work for MSP430
SDOCM00107276S3 - MinorROV for GPIO exception if opened before Board_initGeneral() is called
SDOCM00107319S3 - Minormakedef's XDCTOOLS_JAVA_HOME default is bad in supplied examples for stand-alone installer
SDOCM00107336S3 - MinorGPIO's ROV module does not work on the TM4C1294 because of a missing entry in the gel file.
SDOCM00107337S3 - MinorBIOS and UIA examples will not link with default MSP430FR5969 linker file.
SDOCM00107366S3 - MinorGrlibdemo on MSP430FR5969LP not working for IAR
SDOCM00107701S2 - MajorTI-RTOS filters out BIOS' 64T libraries
SDOCM00108264S3 - MinorUIA hello and stairstep examples do not build for some MSP430 devices
SDOCM00108323S2 - MajorTI-RTOS uninstall broke my build environment
SDOCM00112255S3 - MinorTI-RTOS GPIO driver should support configuring pin direction
SDOCM00113569S2 - MajorMulti-master support for I2C drivers
SDOCM00115174S3 - MinorTI-RTOS Makefiles should not use semihosting (or an easy option to enable/disable it)
SDOCM00115670S3 - MinorTivaC 1294's USB MSC host is really slow


Examples

There are driver examples for the following boards:
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: April 17, 2015