[processor-sdk/performance-audio-sr.git] / psdk_cust / ipc_3_43_00_00_eng / docs / relnotes_archive / ipc_1_20_00_22_release_notes.html
diff --git a/psdk_cust/ipc_3_43_00_00_eng/docs/relnotes_archive/ipc_1_20_00_22_release_notes.html b/psdk_cust/ipc_3_43_00_00_eng/docs/relnotes_archive/ipc_1_20_00_22_release_notes.html
+++ /dev/null
@@ -1,339 +0,0 @@
-<!-- --COPYRIGHT--,BSD
- * Copyright (c) $(CPYYEAR), Texas Instruments Incorporated
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions
- * are met:
- *
- * * Redistributions of source code must retain the above copyright
- * notice, this list of conditions and the following disclaimer.
- *
- * * Redistributions in binary form must reproduce the above copyright
- * notice, this list of conditions and the following disclaimer in the
- * documentation and/or other materials provided with the distribution.
- *
- * * Neither the name of Texas Instruments Incorporated nor the names of
- * its contributors may be used to endorse or promote products derived
- * from this software without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
- * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
- * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
- * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
- * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
- * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
- * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
- * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
- * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
- * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- * --/COPYRIGHT-- -->
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
- <head>
- <meta name="generator" content=
- "HTML Tidy for Windows (vers 14 February 2006), see www.w3.org">
- <title>
- IPC 1.20 Release Notes
- </title>
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
- <!-- For now, we use the doxygen style sheet -->
- <link href="release_notes_template_files/css.htm" type="text/css" rel=
- "stylesheet">
- <meta content="MSHTML 6.00.2900.3395" name="GENERATOR">
- </head>
- <body>
- <table width="100%">
- <tbody>
- <tr>
- <td bgcolor="black" width="1">
- <a href="http://www.ti.com/"><img style=
- "border: 0px solid ; width: 222px; height: 54px;" alt=
- "Texas Instruments" src="docs/tilogo.gif"></a>
- </td>
- <td bgcolor="red">
- <img style="width: 314px; height: 26px;" alt=
- "Technology for Innovators(tm)" src="docs/titagline.gif">
- </td>
- </tr>
- </tbody>
- </table>
- <h1 style="text-align: left;">
- IPC 1.20.00.21 Engineering Release Notes
- </h1>This release note is divided into the following sections:<br>
- <br>
- <a href="#General_Info">Introduction</a>, <a href=
- "#Documentation">Documentation</a>, <a href="#Whats_New">What's New</a>,
- <a href="#Compatibility">Upgrade & Compatibility Information</a>,
- <a href="#Host_Support">Host Support</a>, <a href=
- "#Dependencies">Dependencies</a>, <a href="#Device_Support">Device
- Support</a>, <a href="#Validation">Validation Info</a>, <a href=
- "#Known_Issues">Known Issues</a>, <a href="#Examples">Examples</a>,
- <a href="#Version">Version Information</a>, <a href="#Support">Technical
- Support</a>.
- <hr>
- <h2>
- <a name="General_Info" id="General_Info">Introduction</a>
- </h2>
- <p>
- This is a engineering release of IPC 1.20
- </p>
- <p>
- Interprocess communication mechanisms including message passing, streams,
- and linked lists, which work transparently in both uniprocessor and
- muiltiprocessor configurations.
- </p>
- <p>
- The IPC product is comprised of three main packages
- </p>
- <ul>
- <li>
- <span style="font-weight: bold;">ti.ipc</span>: Contains common
- interface files (e.g. MessageQ, ListMP, HeapMemMP, Notify, etc.)
- </li>
- <li>
- <span style="font-weight: bold;">ti.sdo.io</span>: Contains I/O
- modules (e.g. Stream, IDriver interface, etc.)
- </li>
- <li>
- <span style="font-weight: bold;">ti.sdo</span><span style=
- "font-weight: bold;">.utils</span>: Contains helper modules (e.g.
- MultiProc, List and NameServer)
- </li>
- <li>
- <span style="font-weight: bold;">ti.sdo.</span><span style=
- "font-weight: bold;">ipc</span>: Contains multicore modules (e.g.
- MessageQ, Notify, ListMP, etc.)
- </li>
- </ul>These packages are provided as source code and prebuilt libraries.<br>
- <hr>
- <h2>
- <a name="Documentation" id="Documentation">Documentation</a>
- </h2>
- <p>
- The following documentation is available:
- </p>
- <table style="padding-left: 10px;">
- <tr>
- <td><a href="docs/User_install.pdf">User Install Guide</a></td>
- <td></td>
- </tr>
- <tr>
- <td><a href="docs/sprugo6a.pdf">User Guide (SPRUGO6A)</a></td>
- <td></td>
- </tr>
- <tr>
- <td><a href="docs/doxygen/html/index.html">Doxygen API guide</a></td>
- <td>Documents runtime-APIs, type definitions, error codes and constants</td>
- </tr>
- <tr>
- <td><a href="docs/cdoc/index.html">Cdoc API guide</a></td>
- <td>Documents config-time (RTSC) APIs, Asserts and Errors</td>
- </tr>
- </table>
- <p>
- Release notes from previous releases are also available in the <a href=
- "docs/relnotes_archive">relnotes_archive</a> directory.
- </p>
- <hr>
- <h2>
- <a name="Whats_New" id="Whats_New">What's New</a>
- </h2>
- <p>
- <b>1.20.00.21 Engineering</b> <b>Release (this release)</b>
- </p>
- <p>
- This is an Early Adopter Release of IPC 1.20. This release should be used
- for evaluation and early development only. It will not be supported once
- the official IPC 1.20 GA release is available (April timeframe). Only
- minor, if any, API changes will occur between this release and the GA
- release.
- </p>
- <p>
- The IPC User's Guide examples and code samples are slightly out of synch
- with the APIs in this version of the software. The documentation
- available via the 'cdoc' documentation and CCSv4 Help are accurate and
- should be used as reference. User code should use the APIs defined by the
- headers in <A HREF="docs/doxygen/html/index.html">
- /docs/doxygen/html/index.html</A>
- </p>
- <p>
- For information on enhancements and defect fixes in earlier releases,
- please refer to the release notes from previous releases that are
- available in the <a href="docs/relnotes_archive">relnotes_archive</a>
- directory.
- </p>
- <hr>
- <h2>
- <a name="Compatibility" id="Compatibility">Upgrade and Compatibility
- Information</a>
- </h2>
- <p>
- <span style="font-weight: bold;">Interface/API changes:</span> This
- release is not compatible with IPC 1.00.0X.XX (GA) release. The APIs
- have been updated to be consistent with the Linux APIs to share common
- header files in ti/ipc/. Source files that use IPC 1.00 will have to be
- reviewed and updated.
- </p>
- <hr>
- <h2>
- <a name="Host_Support" id="Host_Support">Host Support</a>
- </h2>
- <p>
- This release supports the following hosts:
- </p>
- <p>
- Windows XP SP2/SP3
- </p>
- <p>
- Windows Vista
- </p>
- <p>
- Linux (Redhat 4 and 5)
- </p>
- <p class="MsoPlainText" style="margin-left: 0.5in; text-indent: -0.25in;">
- </p>
- <hr>
- <h2>
- <a name="Dependencies" id="Dependencies">Dependencies</a>
- </h2>
- <p>
- This release requires the following other software components and tools
- versions to successfully function:
- </p>
- <ul>
- <li>CCS 4.1.0.02003 (or later 4.1)
- </li>
- <li>DSP/BIOS 6.21.01.17 (or later)
- </li>
- <li>XDCtools 3.16.02.32 (or later)<br>
- </li>
- </ul>
- <hr>
- <h2><a name="Device_Support" id="Device_Support">Device Support</a></h2>
- <ul>
- <li><a href="http://focus.ti.com/docs/prod/folders/print/tms320c6472.html">TMS320C6472</a></li>
- <li><a href="http://focus.ti.com/docs/prod/folders/print/tms320c6474.html">TMS320C6474</a></li>
- <li><a href="http://focus.ti.com/apps/docs/gencontent.tsp?contentId=52385&appId=1">TMS320DA830</a></li>
- <li><a href="http://focus.ti.com/docs/prod/folders/print/tms320dm6446.html">TMS320CDM6446</a></li>
- <li><a href="http://focus.ti.com/docs/prod/folders/print/omap-l138.html">OMAPL138</a></li>
- <li><a href="http://focus.ti.com/docs/prod/folders/print/omap3530.html">OMAP3530</a></li>
- <li><a href="http://focus.ti.com/general/docs/wtbu/wtbuproductcontent.tsp?templateId=6123&navigationId=12843&contentId=53243">OMAP4430</a></li>
- </ul>
- <hr>
- <h2>
- <a name="Validation" id="Validation">Validation Information</a>
- </h2>This release was validated using the following components:
- <ul>
- <li>CCS 4.1.0.02003
- </li>
- <li>DSP/BIOS 6.21.01.17
- </li>
- <li>XDCTools 3.16.02.32
- </li>
- </ul>
- <hr>
- <h2>
- <a name="Known_Issues" id="Known_Issues">Known Issues</a>
- </h2>There are the following known issues with this release
- (which is at EA status)<br>
- <br>
- <table width="100%">
- <colgroup width="15%"></colgroup>
- <tbody>
- <tr>
- <td>
- <b>ID</b>
- </td>
- <td>
- <b>Headline</b>
- </td>
- </tr>
- </tbody>
- </table><br>
- <hr>
- <h2>
- <a name="Examples" id="Examples">Examples</a>
- </h2>The IPC product ships with several examples. The following is an
- explaination of each one. Refer to the <a href=
- "docs/User_install.pdf"></a><a href="docs/User_install.pdf">User
- InstallGuide</a> for details on building.<br>
- <big><span style="font-weight: bold;">io\examples</span></big><br>
- <div style="margin-left: 40px;">
- - <span style="font-weight: bold;">stream</span>: This example shows the
- use of ti.sysbios.io.Stream module to demonstrate IO streaming using a
- driver.<br>
- <br>
- </div><big><span style="font-weight: bold;">utils\examples</span></big><br>
- <div style="margin-left: 40px;">
- - <span style="font-weight: bold;">list</span>:The list example shows
- how to use the basical functionality of the ti.sdo.utils.List module<br>
- - <span style="font-weight: bold;">multiProc</span>: The multiProc
- example shows how to use the basical functionality of the
- ti.sdo.utils.MultiProc module<br>
- - <span style="font-weight: bold;">multiProcSingleImage</span>: The
- multiProcSingleImage example shows how to configure an image to be able
- to run on multiple cores.<br>
- <br>
- </div><big><span style=
- "font-weight: bold;">ipc\examples\singlecore</span></big><br>
- <div style="margin-left: 40px;">
- - <span style="font-weight: bold;">notify_loopback</span>: This example
- shows how to use the Notify module. The driver is the
- NotifyDriverLoopback, so it can be run on a single processor.<br>
- <br>
- </div><big style=
- "font-weight: bold;">ipc\examples\multicore<br></big>Please refer to the
- readme.txt in the multicore platform specific directories for details on
- how to run.<big style="font-weight: bold;"><br></big>
- <div style="margin-left: 40px;">
- - <span style="font-weight: bold;">message</span>: This example shows
- messageQ on a multiprocessor system.<br>
- - <span style="font-weight: bold;">notify</span>: This example shows how
- to run the Notify module only on a multiprocessor system.<br>
- </div>
- <h2>
- <a name="Version" id="Version">Version Information</a>
- </h2>
- <p>
- All releaseshave 4 digits (<b>M.mm.pp.bb</b>). This includes GA and
- pre-releases (engineering, EA, beta, etc.). Pre-releases are denoted with
- a suffix (e.g. 1.20.00.01_eng).
- </p>
- <p>
- This product's version follows a version format, <b>M.mm.pp.bb</b>, where
- <b>M</b> is a single digit Major number, <b>mm</b> is 2 digit minor
- number, <b>pp</b> is a 2 digit patch number, and <b>b</b> is an
- unrestricted set of digits used as an incrementing build counter.
- </p>
- <p>
- To support multiple side-by-side installations of the product, the
- product version is encoded in the top level directory, ex.
- <b>ipc_1_20_00_01</b>.
- </p>
- <p>
- Subsequent releases of patch upgrades will be identified by the patch
- number, ex. IPC 1.20.00.01 with directory<b>ipc_1_20_00_01</b>.
- Typically, these patches only include critical bug fixes.
- </p>
- <p>
- 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.
- </p>
- <hr>
- <h2>
- <a name="Support" id="Support">Technical Support</a>
- </h2>
- <p>
- For technical support, contact <a href=
- "https://www-a.ti.com/downloads/sds_support/targetcontent/FC/index.html">softwaresupport@ti.com<br>
- </a>
- </p>
- <hr>
- <p>
- Last updated: April 01, 2010
- </p>
- </body>
-</html>