Texas Instruments Technology for Innovators(tm)

XDCtools 3.15.04.70 GA Release Notes

September 04, 2009

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.

XDCtools 3.15.04.70 is the General Availability release of XDCtools 3.15.03

The XDCtools product includes the following sets of packages:

back to top

Documentation

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

Both formats are delivered with the product in the docs subdirectory. The most up-to-date docs can also be viewed on-line at:

Release notes from previous product releases are available in the relnotes_archive directory.

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 3.15.04.70:

The following significant changes were included in 3.15.00.50:

New platforms and device

The RTSC platform packages - ti.platforms.ezdsp5505 and ti.platforms.evm5505ext have been added to XDCtools. The C5504 device is now supported in XDCtools.

Integration with Code Composer Studio v4

XDCtools now integrates with Code Composer Studio v4 (CCSv4) IDE and is bundled with the CCSv4 product. Users can build and run applications that use RTSC content in an integrated graphical environment.

The integration features include:

RTSC platform wizard

CCSv4 now includes a graphical wizard for creating RTSC platforms. This allows users who have their own hardware to generate a RTSC platform package that fully supports all RTSC command-line and graphical features.

Graphical configuration

CCSv4 now includes a graphical editor for RTSC configuration (.cfg) files. Features of the Graphical configuration editor include:

The graphical editor has beta status.

Improved error messages and trace support

Error messages printed by XDCtools are now more concise, and stack backtraces are no longer printed by default. A new Trace facility lets package writers output debug information, and lets users filter the trace output according to producer and verbosity.

The trace support is documented on the web here.

XDC Runtime support for OS-related primitives

XDCtools now includes runtime support for OS-related primitives, delivered as a standard part of the XDC Runtime in package xdc.runtime.knl.

Warning: Package xdc.runtime.knl is experimental in this release, and its interfaces can be expected to change in an incompatible way in upcoming releases.

Closure tool for creating stand-alone bundles

A command line tool that creates a RTSC bundle containing all packages loaded in the process of configuring an application. The resulting bundle can be distributed and consumed without installing any additional products, including XDCtools itself.

The tool is available in package xdc.tools.closure. Documentation is available on the web here.

Warning: Package xdc.tools.closure is experimental in this release, and can be expected to change in an incompatible way in upcoming releases.


Defect history for 3.15.04.70 (This Release)

XDCtools bugs are filed at bugs.eclipse.org.

The following defects were resolved in this release

ID Headline
ECL280697 importing existing standard C project causes null pointer exaception
ECL282090 xdc.rta.Decoder API break
ECL284345 Diags_setMask() may access invalid memory
ECL285049 Error_Block.msg is bogus when Text.isLoaded is false
ECL250866 Confusing error when package's close() is called from the build model
ECL266379 need cdoc support for new diagnostics methods
ECL270851 configuro documentation errors
ECL271200 fix todos in xdc.tools.repoman.sg docs
ECL271850 configuro does not document all it's options
ECL276790 ti.sdoarch.standards.pkg doesn't have appropriate copyrights and tree stamps
ECL282752 ROV for LoggerBuf/Log_print# needs optimization
ECL282939 xdc.cfg.Program.sectMap has incomplete cdoc (3.15.02.62)
ECL283579 white space handling of package path on Windows does not handle extra ';'s
ECL284057 TI platforms should use an open source license
ECL284189 ROV in 3.15.03.63 can't handle 't_Size' type (fix for 280521 breaks ROV)
ECL284523 The TMS570PSF762 device has incorrect 'isa'
ECL285092 Unable to override .externalMemoryMap setting in ti.platforms.evm3530

back to top


Upgrade and Compatibility Information

Warning:Starting with XDCtool 2.95, RTSC packages with target content are incompatible with target content from previous releases. Compatibility of meta only content is not affected. Packages with target content would require a recompile. Starting with XDCtool 3.00 release both backward and forward compatibility is maintained for all content.

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:



back to top

Host Support

This release supports the following hosts:

back to top

Dependencies

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

back to top

Device Support

This release supports the following device families:

back to top

Validation Information

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

back to top


Known Issues

The following major issues are known to exist in this release.

XDC spec file import statement resolution

XDCtools now correctly interprets the "imports" statement used in module .xdc files. Previously the import statement incorrectly imported all modules in the same package in addition to the one named. These extra modules are no longer imported, and content packages that incorrectly relied on this bug now correctly fail with an error message when used or built. This can affect users how unknowingly use content that has this issue.

The most common symptom is the error message "can't resolve name" when configuring an executable. The solution is to update the content that relies on the bug. The content producer should add import statements to the .xdc files for the missing modules.

CCSv4 IDE integration not supported on Linux

Command-line operation on Linux is fully supported.

back to top


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. 3.15.01.51-eng or 3.15.01.58-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. 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

For technical support, contact rtsc_champs@list.ti.com

Please view and file bugs against this product at rtsc.eclipse.org.

back to top


Last updated: September 04, 2009 Build Ver: 3.15.04.70 Rev: k70