IPC 1.25.02.12 GA Release Notes

This release note is divided into the following sections:

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

Introduction

IPC 1.25.02.12 is an GA release of IPC

Interprocess communication mechanisms including message passing, streams, and linked lists, which work transparently in both uniprocessor and muiltiprocessor configurations.

The IPC product is comprised of the following main packages

ti.ipc: Contains common interface files (e.g. MessageQ, ListMP, HeapMemMP, Notify, etc.)
ti.sdo.utils: Contains helper modules (e.g. MultiProc, List and NameServer)
ti.sdo.ipc.heaps: Contains shared-memory Heaps
ti.sdo.ipc: Contains multicore modules (e.g. MessageQ, Notify, ListMP, etc.)

These packages are provided as source code and prebuilt libraries.

Documentation

The following documentation is available:

User Install Guide
User Guide (SPRUGO6E)
Doxygen API guide	Documents runtime-APIs, type definitions, error codes and constants
Cdoc API guide	Documents config-time (RTSC) APIs, Asserts and Errors; Indexed and searchable within CCS/Eclipse
Static Analysis Reports

Manifest and License:

IPC Software Manifest and License

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

What's new

Changes since IPC 1.25.01:

SDOCM00097875	ipc.mak is broken in Windows cmd shell
SDOCM00098119	Concerto transport must have MultiProc ids 0 and 1, it fails with 2 and 3, etc
SDOCM00098199	"ti_sdo_ipc_init" section needs to be padded to cacheline size
SDOCM00098462	The IPC mailbox drivers for M3 on TI81XX and C6A8149 does not work for SMP BIOS
SDOCM00098532	Remove deprecated I/O examples from IPC product

For information on enhancements and defect fixes in earlier releases, please refer to the release notes from previous releases that are available in the relnotes_archive directory.

Upgrade and Compatibility Information

Interface/API changes:

No APIs or shared memory interfaces were changed in this release. However, this release requires new SYS/BIOS, XDC, and CCS components as described in the dependency section below.

Host Support

This release supports the following operating systems:

Windows 7, Windows XP, Windows Vista
Linux [RH 4], Ubuntu [10.1]

Dependencies

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

CCS 5.2.0 (or later)
SYS/BIOS 6.34.00.12 (or later)
XDCTools 3.24.01.29 (or later)

Validation Information

This release was validated using the following components:

CCS 5.2.0.68
SYS/BIOS 6.34.00.12
XDCTools 3.24.01.29

Examples

The IPC product ships with several examples. The following is an explaination of each one. Refer to the User Install Guide for details on building.
ipc\examples\singlecore

- notify_loopback: This example demonstrates the Notify module on a single core using loopback functionality.
- message: This example demonstrates the MessageQ module on a single core.

ipc\examples\multicore
Please refer to the readme.txt in the multicore platform specific directories for details on how to run.

- message: This example shows how to use MessageQ on a multiprocessor system.
- notify: This example shows how to use IPC notifications on a multiprocessor system.

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.21.00.01_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. ipc_1_21_00_01.

Subsequent releases of patch upgrades will be identified by the patch number, ex. IPC 1.21.00.01 with directory ipc_1_21_00_01. 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, use the community forum TI E2E Community, or email softwaresupport@ti.com.

Last updated: January 23, 2013