XDCtools 3.23.00.32 GA Release Notes

November 16, 2011

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

---

Introduction

RTSC / XDC (eXpanDed C) is a standard for reusable software components, optimized for real-time embedded systems. RTSC components have hardware-neutral formal interfaces, are configurable offline to optimize memory and performance, and support custom automation in the development environment via a scripting language.

The XDCtools product includes the following components:

• Core (xdc.*) - the xdc and xs command line utilities for building packages and executing scripts respectively; packages that implement the RTSC standard;
• User tools (xdc.tools.*) - command-line and graphical utilities for working with packages and repositories;
• Targets (*.targets.*) - definitions for using various TI and third-party compiler tool chains;
• Platforms (*.platforms.*) - definitions for linking and running code on various TI and third-party board-level hardware and simulator products.
• Eclipse (eclipse) - A set of integration plugins  for RTSC for the eclipse platform. These plugins are leveraged by CCS (Code Composer Studio) to provide support for integrating RTSC content in the IDE environment.

back to top

---

Documentation

The product documentation for this release is available in two formats:

• Compressed .zip file archive
• Microsoft HTML Help .chm file

Both formats are delivered with the product in the docs subdirectory. The most up-to-date docs can also be viewed in the RTSC-pedia

Release notes from previous product releases are available in the relnotes_archive directory. Note that  XDCtools 3.21 (supports only the MSP430 device family) is shipped only with the Grace product. 

back to top

---

License

XDCtools contains elements released under the Eclipse Public License v1.0 and a number of other open-source licenses, detailed here.

---

What's New

The following significant changes are included in XDCtools 3.23 :

• The XDCtools product has been extended to work with Code Composer Studio v5.1.0.  However, note that this release will no longer work with versions of CCS prior to v5.1.0.
• To  align XDCtools with Code Composer Studio 5.1.0, the default directory of its installers are as follows:

Host OS	Default Install Directory
MS Windows (XP and 7)	C:\ti
Linux root user	/opt/ti
Linux non-root user	$HOME/ti

• Calls to Mod_construct() are now permissable in static-only systems.
• Added Android target support (google.targets.arm.Bionic)
• Added gcc ARM Cortex M3/M4 target support (gnu.targets.arm.M3, gnu.targets.arm.M4, gnu.targets.arm.M4F, gnu.targets.arm.rtsv7M)
• Added  gcc Stellaris target support (ti.platforms.stellaris)

---

Defect history for 3.23.00.32 (This Release)

Bugs against the XDCtools product may be filed in Eclipse Bugzilla.

The following defects were resolved in this release:

ID	Headline
361975	add targets for gcc M3/M4 and update ti.platforms.stellaris to support gcc
324012	Support for RTSC integration for standard make projects in eclipse
345297	Program.sectMap should be editable in XGCONF
349505	static only policy should allow runtime constructs
361185	update SourceDir's makefile.lib to make the clean rule work better for custom build
363228	Setting Hwi/Swi stack size in Hwi grace page does not work
345462	MSP430 Generic Platform linker command files should add add " --args 0" by default
360296	Incorrect memory page attribute handling in Utils.checkFit
360297	Incorrect page attribute for simArctic platform
361972	update SysMin to support HOSTwrite during flushAtExit for gcc
363104	Add gnu alignment support to obj.$$alloc
282605	platform getExec should support repositories with spaces

back to top

---

Upgrade and Compatibility Information

 The following section describes compatibility breaks, and workarounds where available

• Packages are forwards and backwards compatible starting from XDCtools 3.20
  

Package Compatibility Keys

The packages comprising the XDCtools release are uniquely identified by a compatibility key defined in the package.xdc file of a package. Please note that the package compatibility keys are independent of XDC product release numbers.

Package compatibility keys are intended to:

1. Enable tooling to identify incompatibilities between components, and
2. Convey a level of compatibility between different releases to set end user expectations.

Package compatibility keys are composed of 4 comma-delimited numbers - M, S, R, P - where:

• M = Major - A difference in M indicates a break in compatibility. The package consumer is required to re-write its source code in order to use the package.
• S = Source - A difference in S indicates source compatibility. The package consumer’s source code doesn't require change, but does require a recompile.
• R = Radix - A difference in R indicates an introduction of new features, but compatibility with previous interfaces is not broken. If libraries are provided by the package, an application must re-link with the new libraries, but is not required to recompile its source.
• P = Patch - A difference in P indicates that only bugs have been fixed in the latest package and no new features have been introduced. If libraries are provided by the package, an application must re-link with the new libraries, but is not required to recompile its source.

back to top

---

Host Support

This release supports the following hosts:

• Windows XP, Windows 7
• RedHat Enterprise Linux 3 and Ubuntu 10.04 . Note that IDE integration on Linux is only supported for CCSv5 on Ubuntu 10.04.

back to top

---

Dependencies

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

• TI C6x Code Generation Tools version 7.0 or later
• TI ARM Code Generation Tools version 4.5 or later
• TI MSP430 Code Generation Tools version 3.3.0 or later
• GCC for x86 version 3.2.3 or later
• GCC for ARM version 3.2.3 or later
• Code Composer Studio version  4.2.0.10017 and 5.0.0.00095. Note that this release will not work with CCS 4.1.3 and earlier releases.

back to top

---

Device Support

This release supports the following device families:

• C6000 family - C674, C67P, C64P, C66, C64T
• C2000 family - C28
• ARM processors - TMS470, ARM7/9, Cortex A8/M3/R4
• MSP430
• Native development host (Windows, Linux)

back to top

---

Validation Information

This release was built and validated against using the following components:

• Code Composer Studio version  5.1.0.90000
• TI ARM Code Generation Tools version 4.9.0 
• TI C6x Code Generation Tools version 7.0.3, 7.2.0B2
• TI MSP430 Code Generation Tools version 3.4.0
• TI C28 Code Generation Tools version 5.2.3
• GCC for ARM version 4.3.2 (CodeSourcery), 4.2.1 and 3.4.3 (Montavista) 

The code generation tools used for the various RTSC targets shipped with the product are shown below:

RTSC Target	Code Generation Tools
ti.targets.[C64P,C64P_big_endian,C67P,C674,C674_big_endian,C64T,C64T_big_endian]	7.0.3 (TMS320C6x)
ti.targets.[C28,C28_large,C28_float]	5.2.3 (TMS320C2000)
ti.targets.[C66,C66_big_endian];ti.targets.elf.[C64P,C64P_big_endian,C64T,C64T_big_endian,C674,C674_big_endian,C67P,C66,C66_big_endian]	7.2.0 (TMS320C6x)
ti.targets.arm.elf.[TMS470,Arm7,Arm9,Arm9t,A8Ft,M3,M3_big_endian,R4,R4_big_endian,R4t,R4t_big_endian,R4F,R4F_big_endian,R4Ft_big_endian]	4.9.0 (ARM/TMS470)
gnu.targets.MVArm9,gnu.targets.arm.GCArmv5T	3.4.3 (GCC Montavista)
gnu.targets.UCArm9	4.2.1 (GCC Opensource)
gnu.targets.arm.GCArmv6,GCArmv7A	4.3.2 (GCC Codesourcery)
gnu.targets.[Linux86,Sparc]	4.1.0 (GCC Opensource)
gnu.targets.Mingw	4.4.0 (GCC MingW)
microsoft.targets.Net32	13.10.3052 (Microsoft .NET C/C++)
microsoft.targets.Win32	14.00.50727.42 (Microsoft Visual C/C++)
microsoft.targets.VC98	12.00.8168 (Microsoft Visual C/C++)
microsoft.targets.arm.WinCE	Microsoft WinCE 6.00
ti.targets.msp430.[MSP430,MSP430X,MSP430X_small]	3.3.0(MSP430)
Android Bionic	4.4.3

back to top

---

Known Issues

To see a complete list of XDCTools issues, see the Eclipse Bugzilla.

back to top

---

Version Information

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

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

Subsequent releases of patch upgrades will be identified by the patch number, ex. XDCtools 3.15.01.67 with directory xdctools_3_15_01_67. 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.

back to top

---

Technical Support

Support questions on the product should be posted to the RTSC newsgroup.   Check the XDCtools download site  for the latest releases.

back to top

---

Last updated: November 16, 2011 Build Ver: 3.23.00.32 Rev: