TI-RTOS 1.20.00.28 Release Notes

This release note is divided into the following sections:

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

Introduction

This is a General Availability (GA) of TI-RTOS . This version of TI-RTOS requires CCS 5.5.

MSP430 support has been added into this release, however it is at a "beta" level. The next release (1.21) will have GA support for MSP430. While not expected, there may be breaks in backward compability for MSP430 from 1.20 to 1.21. All of the other components in this release of TI-RTOS are at a GA level.

The 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.

The 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 TIs 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.

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. Note these products only support ARM and C2xxx devices (this was done to reduce installer and installation size).

bios_6_37_00_20
ipc_3_10_01_11
ndk_2_23_00_00
uia_1_04_00_06
xdctools_3_25_04_88*
MSP430Ware 1_60_02_09a**
MWare_v201b**
TivaWare_C_Series-2.0b**
Drivers and examples for

Concerto Family: TMDXDOCKH52C1 and TMDXDOCK28M36
Stellaris Family: EKS-LM4F232 and EK_LM4F120XL
Tiva-C Family: EK_TM4C123GXL, DK_TM4C123G, and DK_TM4C129X
MSP430 Family: MSP_EXP430F5529LP

* XDCtools is installed at the same level at TI-RTOS. If the xdctools_3_25_04_88 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

1.20.00.28

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

MSP430 Support
DK_TM4C129X Support
IAR Support (MSP430 and M4F)
GUI Composer Support
Examples that utilize boosterpacks

Defects Fixed since 1.10.00.23

ID	Headline
SDOCM00083850	SD (SSI) Driver restrictions (one peripheral and one SSI slave select pin)
SDOCM00094054	tcpEcho does not handle more than two connections well
SDOCM00097571	Add docs for "Adding System Analyzer via USB CDC"
SDOCM00100711	select() should be removed from WiFi example when CC3000 is patched
SDOCM00101013	TI-RTOS module has work-around for platform issue with launchpad
SDOCM00101241	Need to be consistent on giving names to enums
SDOCM00101243	Document that SysFlex is deprecated (use xdc.runtime.SysCallback instead)
SDOCM00101254	TI-RTOS release notes should have pointers to sub-component docs (or release notes which point to docs)
SDOCM00101371	__EKS_LM4F232_H should be __EK_TM4C123GXL_H in EK_TM4C123GXL.h
SDOCM00101494	Getting Started Guide needs section on adding TI-RTOS to TI Resource Explorer
SDOCM00101542	USB serial and composite mouse/serial examples do not retrieve data correctly from the USB rxBuffer
SDOCM00101590	Change max payload size for WiFi driver grace page
SDOCM00101857	In Watchdog driver a few Void functions have return statements
SDOCM00101998	SPIMessageQTransport needs a valid errFxn function
SDOCM00102004	TI-RTOS Ethernet driver needs API for determining link status
SDOCM00102576	Race condition in WiFi driver
SDOCM00103029	Add EK-LM4F120XL board and examples back in
SDOCM00103074	Add I2C_config[] structure in Stellaris/Tiva launchpad board files.
SDOCM00103106	TI-RTOS examples should use ti.platforms.tiva instead of ti.platforms.stellaris
SDOCM00103392	Add DK_TM4C123G (renamed EKS_LM4F232 board)
SDOCM00103573	TI-RTOS drivers should offer zero-memory allocation option
SDOCM00103901	TI-RTOS should ship smaller footprint examples
SDOCM00104272	UARTTiva returns incorrect datapointer in callback fucntion when in UART_DATA_TEXT mode.
SDOCM00104684	USBMSCHFatFs's servicePriority param should default to highest not a hard-coded 15

Upgrade and Compatibility Information

When migrating an application that uses TI-RTOS 1.10.00.23 to TI-RTOS 1.20.00.28, the following steps must be taken:

New MWare: This version of TI-RTOS has a new version of MWare The following changes must be made to existing TI-RTOS applications that are based on MWare

Libraries: The MWare libraries (e.g. "${COM_TI_RTSC_MCUSDK_INSTALL_DIR}/products/MWare_v200a/MWare/driverlib/ccs/Debug/driverlib.lib") must be changed to reflect the new version (e.g. "${COM_TI_RTSC_TIRTOS_INSTALL_DIR}/products/MWare_v201b/MWare/driverlib/ccs/Debug/driverlib.lib")
Include Paths: The MWare include paths (e.g. "${COM_TI_RTSC_MCUSDK_INSTALL_DIR}/products/MWare_v200a/MWare") must be changed to reflect the new version (e.g. "${COM_TI_RTSC_TIRTOS_INSTALL_DIR}/products/MWare_v201b/MWare").

TivaWare: This version of TI-RTOS has TivaWare instead of StellarisWare. The following changes must be made to existing TI-RTOS applications that used StellarisWare

Libraries: The StellarisWare libraries (e.g. "${COM_TI_RTSC_TIRTOS_INSTALL_DIR}/products/TivaWare_C_Series-1.0/driverlib/ccs-cm4f/Debug/driverlib-cm4f.lib") must be changed to point to the TivaWare libraries (e.g. "${COM_TI_RTSC_TIRTOS_INSTALL_DIR}/products/TivaWare_C_Series-2.0b/driverlib/ccs/Debug/driverlib.lib")
Include Paths: The StellarisWare include paths (e.g. "${COM_TI_RTSC_TIRTOS_INSTALL_DIR}/products/TivaWare_C_Series-1.0") must be changed to point to the TivaWare path (e.g. "${COM_TI_RTSC_TIRTOS_INSTALL_DIR}/products/TivaWare_C_Series-2.0b").

GPIO_Callbacks structure changed: A new field hwiStruct was added to the GPIO_Callbacks structure. This field points to a family specific Hwi struct. Please refer to the new "Board.c" files to see how to set this field.
SDSPI_Params/SP_Params/WiFi_Params field changed: The bitrate field in three structures were changed from a UInt to a ULong.
UART_Params field changed: The baudRate field in two structures were changed from a ULong to a UInt32.
CCS 5.5: CCS 5.5 is required.

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:

CCSv5.5 or higher

Device Support

TMDXDOCKH52C1
TMDXDOCK28M36
EKS-LM4F232
EK_TM4C123GXL
DK_TM4C123G
DK_TM4C129X
EK_LM4F120XL
MSP_EXP430F5529LP

Validation Information

This release was validated using the following components:

CCSv5.5

Known Issues

There are several know issues with this release.

ID	Headline
SDOCM00088081	SD Card driver lacks CRC support
SDOCM00093268	Add parity and error checking for UART driver
SDOCM00093967	TI-RTOS Windows install will fail if installed in multiple or single directory that contains more than 38 characters in path
SDOCM00094053	TI-RTOS sub-products (e.g. UIA, IPC) are not linked into CCS Help
SDOCM00097626	Giving Priorities to Hwis from TI-RTOS Drivers
SDOCM00098063	UART driver needs to support DMA
SDOCM00099017	TI-RTOS needs to make sub-products examples accessible
SDOCM00099460	ping flood causes Concerto board to stop receiving interrupts
SDOCM00099858	Stellaris launchpad doesn't detect a USB disconnect event
SDOCM00100494	SPI driver was not tested in Slave Open Drain mode
SDOCM00100864	Multithreaded CC3000 Host Driver does not work properly
SDOCM00100865	TI-RTOS drivers should have top-level enable and disable APIs
SDOCM00100945	Make TCP/UDP Echo for CC3000 examples more like NDK TCP/UDP Echo examples
SDOCM00101155	Intermittent spin lock in USB library's USBHCDPipeRead() for LM4F232
SDOCM00101176	SPIMessageQTransport does not support static creates
SDOCM00101229	HTTP demo doesn't show the current SD Card logging state
SDOCM00101240	Coverity for WiFi driver reports several defects in the CC3000 Host Driver
SDOCM00102477	I2CTiva driver get's stuck at a Semaphore_pend() when I2C bus arbitration was lost
SDOCM00102563	WiFi driver should not create Hwi instance
SDOCM00103028	Add USB Host examples to EK_TM4C123GXL
SDOCM00103637	MSP430 UART[USCIA] LibType_Instrumented is not recommended at baudrates > 9600
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
SDOCM00104691	USBMSCHFatFsTiva_open requires a heap since no task stack is provided to the Task_construct
SDOCM00104772	Support for USB in a MSP430 Empty project wizard
SDOCM00104883	improve stack usage in UARTTiva_open() and other XYZ_open() functions
SDOCM00105002	TI-RTOS examples with no heap get an error if they call BIOS_exit
SDOCM00105005	The EMACSnow driver needs a new name
SDOCM00105047	ROV for I2C for MSP430 does not work

Examples

There are for TMDXDOCKH52C1, TMDXDOCK28M36, EKS-LM4F232, EK_TM4C123GXL, DK_TM4C123G, DK_TM4C129X, EK_LM4F120XL, and MSP_EXP430F5529LP. 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 in 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 BIOS Support Forum http://e2e.ti.com/support/embedded/bios/default.aspx or other forums in http://e2e.ti.com/ as needed.

Last updated: November 11, 2013