TI-RTOS 2.14.03.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,
Target and Compiler Support,
Validation Info,
Known Issues,
Examples,
Version Information,
Technical Support.
This is a GA release of TI-RTOS.
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 being released
(i.e., for 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) |
The following documentation is available:
Release
notes from previous releases are also available in the
release notes archive directory.
The following is a list of all the products bundled into the TI-RTOS
installation (with exceptions as noted).
- bios_6_42_03_35
- uia_2_00_02_39
- ipc_3_30_01_12
(valid only for TI-RTOS for C2000 product)
- ndk_2_24_03_35 (valid
only for TI-RTOS for C2000 and TivaC products)
- xdctools_3_31_01_33* (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).
- cc13xxware_2_01_00_16101** (valid only for TI-RTOS for SimpleLink product).
- cc26xxware_2_22_00_16101** (valid only for TI-RTOS for SimpleLink product).
- MSPWare 2_00_00_40c** (valid only for TI-RTOS for MSP43x product).
- MWare_v202a** (valid only for TI-RTOS for C2000 product).
- TivaWare_C_Series-2.1.1.71b** (valid only for TI-RTOS for TivaC product).
* XDCTools is installed at the same level at TI-RTOS. If the xdctools_3_31_01_33
version is already present at that location, that version is used.
** refer to <TIRTOS_Install_dir>\products\<*Ware>\TI-RTOS.README for more details
The following is a summary of changes made in this release:
- The cc13xxware and cc26xxware driverlib components have been updated with several enhancements and bug fixes. For information on what's new with the cc13xxware component, see its release notes (available in a link within this).
- Support has been added for the MSP-EXP430FR6989 LaunchPad.
- Support for the MSP_EXP430F5529 Experimenter Board has been removed. This release continues to support the MSP-EXP430F5529 LaunchPad.
ID | Headline |
SDOCM00108264 | UIA hello and stairstep examples do not build for some MSP430 devices |
SDOCM00116218 | MSP432: release RTC and WDT hold upon exit from LPM4 |
SDOCM00116349 | PowerMSP432_config.enablePolicy is not used to initialize PowerMSP432_module.enablePolicy |
SDOCM00116814 | Documentation for UART UART_RETURN_NEWLINE needs to be updated to require setting UART_DATA_TEXT |
SDOCM00116870 | Update User's Guide & release notes due to MSP_EXP430F5529 removal |
SDOCM00117264 | UARTMSP432_close has a memory leak |
SDOCM00118071 | I2CMSP432 is in transmit mode for a brief period of time when in its supposed to be in receive mode |
SDOCM00118245 | MSP430 I2C driver possibly gets stuck in the Hwi |
SDOCM00118251 | I2CMSP432 driver receives one too many bytes (interrupts) causing an exception |
SDOCM00118408 | UART_close does not handle power constraints properly on CC3200 |
SDOCM00118648 | CC3200 Power does not go into Deep Sleep |
SDOCM00118688 | UARTCC3200, UARTTiva, and UARTMSP432 don't work correctly in blocking mode if timeout is '0' |
SDOCM00118754 | PowerCC3200_sleepPolicy() should check if match register is less than current timer count |
SDOCM00118866 | Update SDSPI Drivers to include additional field within Hwattrs |
SDOCM00118973 | Ti-RTOS empty example for MSP430FR5969 and 6989 should not include the USB driver. |
SDOCM00118988 | CC32xx Camera driver doesn't support blocking mode (bad NULL check in open) |
SDOCM00119039 | CC3200 GPIO powerNotify function has several issues |
SDOCM00119169 | CC3200 board file has incorrect name for DMA channel index |
The following are some known compatibility issues between this release and previous releases. In addition, please check out the TI-RTOS Support Wiki for descriptions of some known issues.
- New fields were added to the SDSPIEUSCIA_HWAttrs and SDSPIEUSCIB_HWAttrs structures within the SDSPI drivers (EUSCIA, EUSCIB) for the MSP430FR6989 and MSP430FR5969. Existing board.c files will need to be updated to specify the new fields and use the new structure name (SDSPIEUSCIA_HWAttrsV1 and SDSPIEUSCIB_HWAttrsV1).
- The cc26xxware DriverLib API has changed, with renamed input parameters for functions AONIOCDriveStrengthGet() and AONIOCDriveStrengthSet().
- The CC13xx RF driver API has been changed by adding parameters to RF_postCmd(), RF_runCmd() and RF_abortCmd().
- Clock loss detection is now automatically enabled in the TI-RTOS Power module once the selected LF clock source is ready and switched to. If the LF clock is missing longer than 170 microseconds (8192 periods of SCLK_HF) the system will be reset. Reset source can be read out from the register AON_SYSCTL:RESETCTL.RESET_SRC by calling SysCtrlResetSourceGet(). For external 32kHz clock mode, clock loss detection is enabled immediately upon TI RTOS initialization. A system where an external 32kHz clock is missing will either hang or sit in a reset loop until the LF clock is present and will work fine from there on. Applications not using TI RTOS will need to call OSCClockLossEventEnable() manually once the desired LF clock source is ready and switched to by the oscillator core.
Supported Operating Systems:
- Windows 7, Windows XP, Windows Vista
- Linux [RH4], Ubuntu [10.04]
This release requires the following other software
components and tools versions to successfully function:
- CCS 6.1.0 or higher
- IAR for ARM 7.40.3 or higher
- IAR for MSP430 6.20 or higher
- Compiler versions are noted in the next section
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 |
6.20 |
ti.targets.arm.elf.M4F |
Texas Instruments |
5.2.2 |
iar.targets.arm.M4F |
IAR for ARM |
7.40.3 |
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.40.3 |
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.40.3 |
This release was validated using the following components:
- CCS 6.1.0
- IAR for ARM 7.40.3
- IAR for MSP430 6.20
- xdctools_3_31_01_33 (in CCS 6.1 or included in TI-RTOS stand-alone installer)
- Wolf CyaSSL 3.6.0
The following are some known issues with this release. In addition, please check out the TI-RTOS Support Wiki for information about other issues that may have been found after this release was completed.
- CC13xx/CC26xx RCOSC calibration issue. The high frequency RC oscillator (RCOSC_HF) is used to improve startup time of the high frequency crystal oscillator (XOSC_HF). In order to attain the best startup time for XOSC_HF, the frequency of RCOSC_HF is automatically calibrated by the Power module in RTOS every time XOSC_HF is started.
The current TI-RTOS Power implementation may not always calibrate the RCOSC_HF to the ideal frequency, thus leading to XOSC_HF startup times of up to about 400 us in rare cases. There are plans for improving the calibration algorithm in a future RTOS release.
- Rebuilding TI-RTOS libraries with IAR EW430 versions 6.30.0 through 6.30.3 will result in an xlib error "Unknown tag:E2". This is a known problem that has been fixed in the latest version of XLINK tools. As a workaround, download the latest version of the XLINK linker from here, unzip it, and add the *.exe files to
iar_installation
/430/bin.
ID | Severity | Headline |
SDOCM00099460 | S2 - Major | Ping flood causes Concerto board to stop receiving interrupts |
SDOCM00104253 | S2 - Major | MSP430 Launchpad ez-FET UART emulation issue at buadrate > 28.8kbps |
SDOCM00106264 | S2 - Major | UART driver doesn't handle RX FIFO overruns. |
SDOCM00116795 | S2 - Major | Build steps for MSP430 that use eUSCI drivers need to be documented |
SDOCM00118245 | S2 - Major | MSP430 I2C driver possibly gets stuck in the Hwi |
SDOCM00119675 | S2 - Major | MSP430 EUSCI/I2C delayed stop bit |
SDOCM00105778 | S3 - Minor | MSP430 UART logging to System Analyzer does not work |
SDOCM00107276 | S3 - Minor | ROV for GPIO exception if opened before Board_initGeneral() is called |
SDOCM00107319 | S3 - Minor | Makedef's XDCTOOLS_JAVA_HOME default is bad in supplied examples for stand-alone installer |
SDOCM00107366 | S3 - Minor | Grlibdemo on MSP430FR5969LP not working for IAR |
SDOCM00115174 | S3 - Minor | TI-RTOS Makefiles should not use semihosting (or an easy option to enable/disable it) |
SDOCM00115670 | S3 - Minor | TivaC 1294's USB MSC host is really slow |
SDOCM00119683 | S3 - Minor | MSP432 SPI slave receives corrupt data |
There are driver examples for the following boards:
- CC1310DK
- CC2650DK Development Kit
- CC2650STK SensorTag
- CC3200_LAUNCHXL (CC3200_LP)
- DK_TM4C129X
- EK_TM4C123GXL
- EK-TM4C1294X
- MSP-EXP430FR5969
- MSP-EXP430FR6989
- MSP-EXP430F5529LP
- MSP-EXP432P401R
- TMDXDOCKH52C1
- TMDXDOCK28M36
There are also kernel and instrumentation examples for all supported
devices.Please refer to the Getting Started Guide for more details.
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.
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: November 02, 2015