release_notes_edma3_lld_02_11_02.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html xmlns="http://www.w3.org/TR/REC-html40">
   3 <head>
   4   <meta content="text/html;charset=ISO-8859-1" http-equiv="Content-Type">
   5   <meta http-equiv="Content-Type" content="text/html">
   6   <title>EDMA3 LLD 02.11.02 Release Notes</title>
   7   <style type="text/css">
   8 body
   9 {
  10     color: #000 ;
  11     background-color: #fff ;
  12     margin : 5px 20px 5px 20px;
  13     font-family: Tahoma, Arial, Helvetica, sans-serif;
  14     font-size: 10pt ;
  15 }
  16
  17 a,
  18 a:link,
  19 a:visited,
  20
  21 {
  22     color : #1a41a8 ;
  23 }
  24
  25 a:hover
  26 {
  27     color : #2a3798 ;
  28 }
  29
  30 img
  31 {
  32     text-decoration : none ;
  33 }
  34
  35 p
  36 {
  37     color: #000 ;
  38 }
  39
  40 table.tagline
  41 {
  42     width: 100%;
  43 }
  44
  45 li
  46 {
  47     color : black ;
  48 }
  49
  50 .title
  51 {
  52     text-align : center ;
  53 }
  54
  55 th
  56 {
  57     text-align : left ;
  58 }
  59   </style>
  60 </head>
  61 <body>
  62 <table border="0" cellpadding="0" cellspacing="0" width="100%">
  63   <tbody>
  64     <tr>
  65       <td
  66  style="background: black none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;"
  67  width="222"> <a href="http://www.ti.com/"><img id="_x0000_i1025"
  68  src="docs/html/tilogo.gif" alt="Texas Instruments" border="0"
  69  height="54" width="222"> </a></td>
  70       <td
  71  style="background: red none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">
  72       <img id="_x0000_i1026" src="docs/html/titagline.gif"
  73  alt="Technology for Innovators(tm)" border="0" height="26" width="314">
  74       </td>
  75     </tr>
  76   </tbody>
  77 </table>
  78 <h1 class="title">EDMA3 LLD 02.11.02 Release Notes</h1>
  79 <h2 class="title">May 24, 2011</h2>
  80 <p>
  81 This EDMA3 Low Level Driver Release is targeted to the users (device
  82 drivers
  83 and applications) for submitting and synchronizing with EDMA3 based DMA
  84 transfers.
  85 This release supports DA830,C6748,TCI6498,TI816X,C6472,TCI6486,TI814X,TI816X,TCI6608,TCI6616,C6670,C6678 platforms, on
  86 DSP/BIOS 6 side &amp; OMAPL138 on DSP/BIOS and ARM side. Porting
  87 instructions
  88 are also provided to use the package for different platforms and
  89 Operating
  90 Systems.
  91 </p>
  92 <p>
  93 <a href="#Introduction">Introduction</a>,
  94 <a href="#Documentation">Documentation</a>,
  95 <a href="#Whats_New">What's New</a>,
  96 <a href="#Upgrade_Info">Upgrade Info</a>,
  97 <a href="#Device_Support">Device Support</a>,
  98 <a href="#Compatibility">Compatibility Information</a>,
  99 <a href="#Validation">Validation Info</a>,
 100 <a href="#Known_Issues">Known Issues</a>,
 101 <a href="#Examples">Examples</a>,
 102 <a href="#Version">Version Information</a>,
 103 <a href="#Support">Technical Support</a>
 104 </p>
 105 <hr>
 106 <a name="Introduction"></a>
 107 <h2><a name="Introduction">Introduction</a></h2>
 108 <p>
 109 EDMA3 LLD is a single product package containing the following
 110 stand-alone
 111 software components:
 112 </p>
 113 <ul type="disc">
 114   <a name="Introduction"> <li> <b>EDMA3 Resource Manager</b> - TI
 115 mandated library for all EDMA3 peripheral users to acquire and
 116 configure EDMA3 hardware resources (DMA/QDMA channels, PaRAM Sets, TCCs
 117 etc.) and DMA Interrupt Service Routines. </li>
 118   <li> <b>EDMA3 Driver</b> - Functional library providing APIs for
 119 programming, scheduling and synchronizing with EDMA transfers and many
 120 more. </li>
 121   </a>
 122 </ul>
 123 <p>
 124 EDMA3 Resource Manager can be used independently whereas the EDMA3
 125 Driver requires
 126 the Resource Manager services internally.
 127 </p>
 128 <p>
 129 EDMA3 LLD (both Resource Manager and the Driver) is a platform
 130 independent package.
 131 Hence it can be used across multiple platforms. Porting instructions
 132 are provided for both the components to do the same.
 133 </p>
 134 <p>
 135 It is also an OS-agnostic package and thus can be used across multiple
 136 operating
 137 systems. OS-adaptation layer needs to be provided by the user (in case
 138 it is needed)
 139 for OS customization. Instructions to do the same are also provided
 140 along with
 141 the package.
 142 </p>
 143 <p>
 144 The Low Level Driver has already been ported (DSP/BIOS Operating
 145 Systems)
 146 and tested on various platforms mentioned below. Sample initialization
 147 libraries,
 148 which configure the EDMA3 hardware and provide the necessary OS
 149 abstraction layer,
 150 are also a part of the package. These libraries are available both for
 151 the EDMA3
 152 Resource Manager and EDMA3 Driver. These could be used for proper
 153 initialization of the software component(s) along with the OS
 154 adaptation layer
 155 for the same.
 156 </p>
 157 <p>
 158 The Low Level Driver consists of the following packages:
 159 </p>
 160 <ul type="disc">
 161   <a name="Introduction"> <li> <tt><b>ti.sdo.edma3.rm</b></tt> -
 162 EDMA3 Resource Manager. </li>
 163   <li> <tt><b>ti.sdo.edma3.rm.sample</b></tt> - Sample initialization
 164 library / OS abstraction layer for the Resource Manager. </li>
 165   <li> <tt><b>ti.sdo.edma3.drv</b></tt> - EDMA3 Driver. </li>
 166   <li> <tt><b>ti.sdo.edma3.drv.sample</b></tt> - Sample initialization
 167 library / OS abstraction layer for the Driver. </li>
 168   </a>
 169 </ul>
 170 <a name="Documentation">
 171 </a>
 172 <h2><a name="Documentation">Documentation</a></h2>
 173 <p>The following documentation is available:
 174 </p>
 175 <ul type="disc">
 176   <li><a href="docs/EDMA3_RM_Release_Notes.pdf">EDMA3 Resource Manager
 177 Release Notes</a></li>
 178   <li> <a href="packages/ti/sdo/edma3/rm/docs/EDMA3_RM_User_Guide.pdf">EDMA3
 179 Resource Manager User's Guide</a> </li>
 180   <li> <a href="docs/EDMA3_Driver_Release_Notes.pdf">EDMA3 Driver
 181 Release Notes</a> </li>
 182   <li> <a
 183  href="packages/ti/sdo/edma3/drv/docs/EDMA3_Driver_User_Guide.pdf">EDMA3
 184 Driver User's Guide</a> </li>
 185   <li> EDMA3 Resource Manager Application Programming Interface (API)
 186 Reference Guide (<a href="packages/ti/sdo/edma3/rm/docs/html/index.html">HTML</a>
 187 | <a href="packages/ti/sdo/edma3/rm/docs/EDMA3_Resource_Manager.chm">CHM</a>)
 188   </li>
 189   <li> EDMA3 Driver Application Programming Interface Reference Guide (<a
 190  href="packages/ti/sdo/edma3/drv/docs/html/index.html">HTML</a> | <a
 191  href="packages/ti/sdo/edma3/drv/docs/EDMA3_Driver.chm">CHM</a>) </li>
 192   <li> <a href="examples/CSL2_DAT_DEMO/docs/CSL_DAT_Adapter.ppt">CSL
 193 2.x DAT Reference Implementation on EDMA3 Hardware using EDMA3 LLD</a> </li>
 194 </ul>
 195 <hr>
 196 <a name="Whats_New"></a>
 197 <h2><a name="Whats_New">What's New</a></h2>
 198
 199 <p>
 200 <a name="Whats_New">The following significant changes have been made since 02.11.01:
 201 </a></p>
 202
 203 <p><a name="Whats_New">02.11.02 - This release
 204 </a></p>
 205
 206 <p>
 207 <a name="Whats_New">The following ECNs are implemented:
 208 </a></p>
 209
 210 <table width="100%">
 211   <tbody>
 212     <tr>
 213       <th>ID</th>
 214       <th>Headline</th>
 215     </tr>
 216
 217     <tr>
 218       <td width="200">TIDSP00012625</td>
 219       <td>Addition of TI816x-m3vpss and TI816x-m3video platform to EDMA3LLD</td>
 220     </tr>
 221
 222   </tbody>
 223 </table>
 224
 225
 226 <p>
 227 <a name="Whats_New">The following IRs are implemented:
 228 </a></p>
 229
 230 <table width="100%">
 231   <tbody>
 232     <tr>
 233       <th>ID</th>
 234       <th>Headline</th>
 235     </tr>
 236
 237     <tr>
 238       <td width="200">SDOCM00080618</td>
 239       <td>ti.platforms.evmTI816X and evmTI814X need to be supported</td>
 240     </tr>
 241
 242     <tr>
 243       <td width="200">SDOCM00080034</td>
 244       <td>CC Base Address in TI814X configuration in ti/sdo/edma3/rm/src/configs is wrong</td>
 245     </tr>
 246
 247     <tr>
 248       <td width="200">SDOCM00081696</td>
 249       <td>EDMA package gives error while including as XDC package</td>
 250     </tr>
 251
 252     <tr>
 253       <td width="200">SDOCM00081697</td>
 254       <td>release build of EDMA3LLD build with GENERIC flag defined</td>
 255     </tr>
 256
 257
 258   </tbody>
 259 </table>
 260
 261 <p>
 262 <a name="Whats_New"><FONT COLOR ='RED'>The following IRs are raised on this release:<b>Known Issues</b></FONT>
 263 </a></p>
 264 <table width="100%">
 265   <tbody>
 266     <tr>
 267       <th>ID</th>
 268       <th>Headline</th>
 269     </tr>
 270
 271     <tr>
 272       <td width="200"><FONT COLOR ='RED'>SDOCM00078640</FONT></td>
 273       <td><FONT COLOR ='RED'>ARM 9 support for OMAPL138 is not available on Make based build of EDMA3LLD</FONT></td>
 274     </tr>
 275
 276     <tr>
 277       <td width="200"><FONT COLOR ='RED'>SDSCM00039169</FONT></td>
 278       <td><FONT COLOR ='RED'>EDMA3 Example fails for following Big Endian Simulators targets tci6608-sim/tci6616-sim</FONT></td>
 279     </tr>
 280
 281   </tbody>
 282 </table>
 283
 284 <br>
 285 <hr><a name="Upgrade_Info"></a>
 286 <h2><a name="Upgrade_Info">Upgrade Information</a></h2>
 287 <p>
 288 The EDMA3 LLD packages are available in the "packages/" subdirectory of
 289 the product.
 290 If you have a previous release of the EDMA3 LLD product, you can
 291 install this
 292 release next to it, and modify your application and/or server builds to
 293 use this
 294 newer release.
 295 </p>
 296 <hr>
 297 <a name="Device_Support"></a>
 298 <h2><a name="Device_Support">Device Support</a></h2>
 299 <p>
 300 This release supports and has been tested on the following devices:
 301 </p>
 302 <ul>
 303   <a name="Device_Support"> <li>DA830 EVM:
 304     <ul type="circle">
 305       <li>C67x DSP/BIOS</li>
 306     </ul>
 307   </li>
 308   <li>TCI6498 Simulator:</li>
 309   </a>
 310   <ul>
 311     <li>C64X+ DSP/BIOS</li>
 312   </ul>
 313   <li>C6748 EVM:</li>
 314   <li style="margin-left: 40px;" type="circle">C67x DSP/BIOS</li>
 315   <li type="disc">OMAPL138 EVM:</li>
 316   <li style="margin-left: 40px;" type="circle">C67x DSP/BIOS</li>
 317   <li style="margin-left: 40px;" type="circle">ARM 9 SYSBIOS</li>
 318   <li>TI816X Simulator:</li>
 319   </a>
 320   <ul>
 321     <li>C67X DSP/BIOS</li>
 322   </ul>
 323     <li>TI816X EVM:</li>
 324   </a>
 325   <ul>
 326     <li>C67X DSP/BIOS</li>
 327     <li>M3 DSP/BIOS</li>
 328   </ul>
 329   <li>C6472 EVM:</li>
 330   </a>
 331   <ul>
 332     <li>C64X+ DSP/BIOS</li>
 333   </ul>
 334     <li>TCI6486 EVM:</li>
 335   </a>
 336   <ul>
 337     <li>C64X+ DSP/BIOS</li>
 338   </ul>
 339       <li>TI814X EVM:</li>
 340   </a>
 341   <ul>
 342     <li>C67X DSP/BIOS</li>
 343   </ul>
 344       <li>C6670 EVM:</li>
 345   </a>
 346   <ul>
 347     <li>C66X DSP/BIOS</li>
 348   </ul>
 349   <li>C6678 EVM:</li>
 350   </a>
 351   <ul>
 352     <li>C66X DSP/BIOS</li>
 353   </ul>
 354   <li>TCI6608 Simulator:</li>
 355   </a>
 356   <ul>
 357     <li>C66X DSP/BIOS</li>
 358   </ul>
 359   <li>TCI6616 Simulator:</li>
 360   </a>
 361   <ul>
 362     <li>C66X DSP/BIOS</li>
 363   </ul>
 364     </ul>
 365 <hr>
 366 <a name="Compatibility"></a>
 367 <h2><a name="Compatibility">Compatibility Information</a></h2>
 368 <h3><a name="Compatibility">Compatibility Key Definitions</a></h3>
 369 <p>
 370 Compatibility keys are intentionally independent of Marketing product
 371 numbers
 372 and are intended to:
 373 </p>
 374 <ol start="1" type="1">
 375   <a name="Compatibility"> <li> Enable tooling to identify
 376 incompatibilities between components, and </li>
 377   <li> Convey a level of compatibility between different releases to
 378 set end user expectations. </li>
 379   </a>
 380 </ol>
 381 <p>
 382 Compatibility keys are composed of 3 comma-delimited numbers - M, S, R
 383 - where:
 384 </p>
 385 <ul type="disc">
 386   <a name="Compatibility"> <li> <b>M = Major</b>. A difference in M
 387 indicates a break in compatibility. </li>
 388   <li> <b>S = Source</b>. A difference in S indicates source
 389 compatibility. That is, the user's source doesn't require change, but <i>does</i>
 390 require rebuilding. </li>
 391   <li> <b>R = Radix</b>. A difference in R indicates an introduction
 392 of new features, but compatibility with previous interfaces has not
 393 broken. If libraries are provided by the package, an application must
 394 re-link with the new libraries, but not rebuild from source. </li>
 395   </a>
 396 </ul>
 397 <hr>
 398 <a name="Validation"></a>
 399 <h2><a name="Validation">Validation</a></h2>
 400 <p>
 401 This release was built and validated against using the following
 402 components:
 403 </p>
 404 <ul type="disc">
 405   <a name="Validation"> <li>CCS 5.0.2</li>
 406   <li>C6x Code Generation Tools version 7.2.0 B2</li>
 407   <li>TMS470 Code Generation Tools 4.6.4</li>
 408   <li>DSP/BIOS 6.31.04.27</li>
 409   <li>XDC Tools 3.20.07.86</li>
 410   <li>TCI6498 Simulator 0.7.1</li>
 411   <li>TI816X Simulator 0.7.1</li>
 412   </a>
 413 </ul>
 414 <p>
 415 This release was validated in the following configurations:
 416 </p>
 417 <ul>
 418   <li> DA830 EVM:
 419     <ul type="circle">
 420       <li>C67x DSP/BIOS</li>
 421     </ul>
 422   </li>
 423   <li> TCI6498 Simulator:
 424     <ul type="circle">
 425       <li>C64X+ DSP/BIOS</li>
 426     </ul>
 427   </li>
 428   <li>C6748 EVM:</li>
 429   <li style="margin-left: 40px;" type="circle">C67x DSP/BIOS</li>
 430   <li>OMAPL138 EVM:</li>
 431   <ul>
 432     <li>C67x DSP/BIOS</li>
 433     <li>ARM 9 SYSBIOS</li>
 434   </ul>
 435   <li>TI816X Simulator:</li>
 436   </a>
 437   <ul>
 438     <li>C67X DSP/BIOS</li>
 439   </ul>
 440     <li>TI816X EVM:</li>
 441   </a>
 442   <ul>
 443     <li>C67X DSP/BIOS</li>
 444         <li>M3 DSP/BIOS</li>
 445   </ul>
 446   <li>C6472 EVM:</li>
 447   </a>
 448   <ul>
 449     <li>C64X+ DSP/BIOS</li>
 450   </ul>
 451     <li>TCI6486 EVM:</li>
 452   </a>
 453   <ul>
 454     <li>C64X+ DSP/BIOS</li>
 455   </ul>
 456     <li>TI814X EVM:</li>
 457   </a>
 458   <ul>
 459     <li>C67X DSP/BIOS</li>
 460   </ul>
 461       <li>C6670 EVM:</li>
 462   </a>
 463   <ul>
 464     <li>C66X DSP/BIOS</li>
 465   </ul>
 466   <li>C6678 EVM:</li>
 467   </a>
 468   <ul>
 469     <li>C66X DSP/BIOS</li>
 470   </ul>
 471   <li>TCI6608 Simulator:</li>
 472   </a>
 473   <ul>
 474     <li>C66X DSP/BIOS</li>
 475   </ul>
 476   <li>TCI6616 Simulator:</li>
 477   </a>
 478   <ul>
 479     <li>C66X DSP/BIOS</li>
 480   </ul>
 481   </ul>
 482 <hr><a name="Known_Issues">
 483 </a>
 484 <h2><a name="Known_Issues">Known Issues</a></h2>
 485 <p>
 486 The following are known issues with the current EDMA3 LLD release:
 487 </p>
 488 <h4><a name="Known_Issues">Pre-built instrumented libraries for DA830
 489 not provided initially.</a></h4>
 490 <p>Pre-built instrumented EDMA3 libraries for DA830 will not be
 491 provided
 492 initially. XDC does not support the same and hence the limitation. See
 493 IR#
 494 SDOCM00036738 for more details.
 495 </p>
 496 <h4><a name="Known_Issues">EDMA3 hardware does not work properly in
 497 FIFO mode with all the controllers.</a></h4>
 498 <p>Very few peripherals support EDMA3 FIFO mode. EMIF controller
 499 doesn't support
 500 the same. So EDMA3 CANNOT be used in FIFO mode for doing a
 501 memory-to-memory data
 502 transfers, EDMA3 being configured in the FIFO mode. Applications trying
 503 to use
 504 EDMA3 in FIFO mode should first check their respective
 505 peripheral-controller
 506 document for this mode support.
 507 </p>
 508 <h4><a name="Known_Issues">PingPong Example Fails for certain EDMA
 509 instances for some DSP cores in Release mode only.</a></h4>
 510 <p>The PingPong example in the package fails for certain EDMA Instances
 511 for some DSP cores in Release mode only. It passes for Debug mode. See
 512 IR#
 513 SDOCM00064758 for more details.
 514 </p>
 515 <h4><a name="Known_Issues">Ristriction on use of the user defined platform name, to use EDMA3LLD xdc package.</a></h4>
 516 <p>The getlibs function of EDMA3LLD uses the platform name not the device name to return the appropreate libraries hence you need to use the same platform name as the ones used by the EDMA3LLD.</p>
 517 <hr>
 518 <a name="Examples"></a>
 519 <h2><a name="Examples">Examples</a></h2>
 520 <p>
 521 EDMA3 LLD sample initialization libraries / OS abstraction layers (for
 522 different
 523 platforms) are located in:
 524 </p>
 525 <ul type="disc">
 526   <a name="Examples"> <li> For Resource Manager: They could be located
 527 in <tt>edma3_lld_02_11_02_XX\packages\ti\sdo\edma3\rm\sample\lib</tt>
 528 folder. </li>
 529   <li> For EDMA3 Driver: They could be located in <tt>edma3_lld_02_11_02_XX\packages\ti\sdo\edma3\drv\sample\lib</tt>
 530 folder. </li>
 531   </a>
 532 </ul>
 533 <p>
 534 EDMA3 LLD stand-alone applications (for different platforms) are
 535 located in:
 536 </p>
 537 <ul type="disc">
 538   <a name="Examples"> <li> EDMA3 Driver: They could be located in <tt>edma3_lld_02_11_02_XX\examples\edma3_driver\</tt>
 539 folder. </li>
 540   </a>
 541 </ul>
 542 <ul type="disc">
 543   <a name="Examples"> <li> CSL2.x DAT Reference Implementation: It
 544 could be located in <tt>edma3_lld_02_11_02_XX\examples\CSL2_DAT_DEMO\</tt>
 545 folder. </li>
 546   </a>
 547 </ul>
 548 <hr>
 549 <a name="Version"></a>
 550 <h2><a name="Version">Version Information</a></h2>
 551 <p>
 552 This product's version follows a version format, <b>M.mm.pp.bb</b>,
 553 where
 554 <b>M</b> is a 2 digit major number,
 555 <b>mm</b> is 2 digit minor number,
 556 <b>pp</b> is a 2 digit patch number, and
 557 <b>b</b> is an unrestricted set of digits used as an incrementing build
 558 counter.
 559 </p>
 560 <p>
 561 To support multiple side-by-side installations of the product, the
 562 product
 563 version is encoded in the top level directory, ex. <b>edma3_lld_02_11_02_XX</b>.
 564 </p>
 565 <p>Subsequent releases of patch upgrades will be identified by the
 566 patch number,
 567 ex. EDMA3 LLD 02.11.02 with directory <b>edma3_lld_02_11_02_YY</b>.
 568 Typically, these
 569 patches only include critical bug fixes.
 570 </p>
 571 <hr>
 572 <a name="Support"></a>
 573 <h2><a name="Support">Technical Support</a></h2>
 574 <p>
 575 For technical support, contact <a href="mailto:softwaresupport@ti.com">softwaresupport@ti.com</a>
 576 </p>
 577 <hr>
 578 <p>Last updated: May 24, 2011
 579 </p>
 580 </body>
 581 </html>