Merged from master; updated build-related files for dsp build
[keystone-rtos/edma3_lld.git] / release_notes_edma3_lld.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.11 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 }
17 a,
18 a:link,
19 a:visited,
21 {
22     color : #1a41a8 ;
23 }
25 a:hover
26 {
27     color : #2a3798 ;
28 }
30 img
31 {
32     text-decoration : none ;
33 }
35 p
36 {
37     color: #000 ;
38 }
40 table.tagline
41 {
42     width: 100%;
43 }
45 li
46 {
47     color : black ;
48 }
50 .title
51 {
52     text-align : center ;
53 }
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.11 Release Notes</h1>
79 <h2 class="title">Jan 7, 2013</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,TI811X,TCI6608,TCI6616,TCI6614,C6670,C6678,TCI6638K2K,TDA2xx platforms, on
86 SYS/BIOS 6 side &amp; OMAPL138 on SYS/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 (SYS/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 <p><b>Note: </b>
171 <ul type="disc">
172   <a name="Introduction"> <li> <b>Address translation is not done in EDMA3 LLD</b> </li>
173 <br>If the memory map of the EDMA is different than the host processor programming it,
174 EDMA3LLD being a low level driver the address translation is not done by this. It is expected that the application
175 will provide the addresses, corresponding to EDMA memory map to configure in PARAM.
176 </p>
177 </a>
178   <a name="Introduction"> <li> <FONT COLOR ='RED'><b>All resources are allocated to all cores in default sample configuration files of EDMA3 LLD</b> </FONT></li>
179 <br>The EDMA resources like Channels, PaRAMs and TCCs which are shared by multiple cores (Ex: in TI814X and TI816X), 
180 The default configuration file allocates all the resources to every core since the resource split is application dependant. 
181 The applications using EDMA3LLD should appropriately allocate the resources in the config files and build EDMA3LLD libraries.
182 </p>
183 </a>
184   <a name="Introduction"> <li> <b>Building EDMA3LLD libs and examples on windows 7</b> </li>
185 <br>On windows 7 there is a permission issue while building the libs and examples.set the environment variable CYGWIN in the command window where you are building <br> examples:       $set CYGWIN=nontsec <br>You might have to manually delete the generated files before building.
186 </p>
187 </a>
188   <a name="Introduction"> <li> <b>Platform name Vayu will Change in future release</b> </li>
189 <br>The package.xs file uses platform name vayu which will change in future release based on the official name given in BIOS for vayu platform.
190 </p>
191 </a>
192 </ul>
193 <a name="Documentation">
194 </a>
195 <h2><a name="Documentation">Documentation</a></h2>
196 <p>The following documentation is available:
197 </p>
198 <ul type="disc">
199   <li><a href="docs/EDMA3_RM_Release_Notes.pdf">EDMA3 Resource Manager
200 Release Notes</a></li>
201   <li> <a href="packages/ti/sdo/edma3/rm/docs/EDMA3_RM_User_Guide.pdf">EDMA3
202 Resource Manager User's Guide</a> </li>
203   <li> <a href="docs/EDMA3_Driver_Release_Notes.pdf">EDMA3 Driver
204 Release Notes</a> </li>
205   <li> <a
206  href="packages/ti/sdo/edma3/drv/docs/EDMA3_Driver_User_Guide.pdf">EDMA3
207 Driver User's Guide</a> </li>
208   <li> EDMA3 Resource Manager Application Programming Interface (API)
209 Reference Guide (<a href="packages/ti/sdo/edma3/rm/docs/html/index.html">HTML</a>
210 | <a href="packages/ti/sdo/edma3/rm/docs/EDMA3_Resource_Manager.chm">CHM</a>)
211   </li>
212   <li> EDMA3 Driver Application Programming Interface Reference Guide (<a
213  href="packages/ti/sdo/edma3/drv/docs/html/index.html">HTML</a> | <a
214  href="packages/ti/sdo/edma3/drv/docs/EDMA3_Driver.chm">CHM</a>) </li>
215   <li> <a href="examples/CSL2_DAT_DEMO/docs/CSL_DAT_Adapter.ppt">CSL
216 2.x DAT Reference Implementation on EDMA3 Hardware using EDMA3 LLD</a> </li>
217 </ul>
218 <hr>
219 <a name="Whats_New"></a>
220 <h2><a name="Whats_New">What's New</a></h2>
222 <p>
223 <a name="Whats_New">The following significant changes have been made since 02.11.11:
224 </a></p>
226 <p><a name="Whats_New">02.11.11 - This release
227 </a></p>
229 <p>
230 <a name="Whats_New">The following IRs are implemented:
231 </a></p>
233 <table width="100%">
234   <tbody>
235     <tr>
236       <th>ID</th>
237       <th>Headline</th>
238     </tr>
239     <tr>
240       <td width="200">SDOCM00104308</td>
241       <td>Ti814x sample app, the unregisterEdma3Interrupts causes an exception because error interrupts were not assigned for M3 builds</td>
242     </tr>
243     <tr>
244       <td width="200">SDOCM00105689</td>
245       <td>EDMA3 LLD support for official DRA7xx platform is broken</td>
246     </tr>
247     <tr>
248       <td width="200">SDOCM00105739</td>
249       <td>Add Support for EVE internal EDMA in EDMA3 LLD</td>
250     </tr>
251     <tr>
252       <td width="200">SDOCM00105829</td>
253       <td>Remove build warnings and C++ warning</td>
254     </tr>
255     <tr>
256       <td width="200">SDOCM00105832</td>
257       <td>Tear down sequence in standalone example is improper</td>
258     </tr>
259   </tbody>
260 </table>
262 <p>
263 <a name="Whats_New"><FONT COLOR ='RED'>The following IRs are raised on this release:<b>Known Issues</b></FONT>
264 </a></p>
265 <table width="100%">
266   <tbody>
267     <tr>
268       <th>ID</th>
269       <th>Headline</th>
270     </tr>
272     <tr>
273       <td width="200"><FONT COLOR ='RED'>SDOCM00078640</FONT></td>
274       <td><FONT COLOR ='RED'>ARM 9 support for OMAPL138 is not available on Make based build of EDMA3LLD</FONT></td>
275     </tr>
277     <tr>
278       <td width="200"><FONT COLOR ='RED'>SDSCM00039169</FONT></td>
279       <td><FONT COLOR ='RED'>EDMA3 Example fails for following Big Endian Simulators targets tci6608-sim/tci6616-sim</FONT></td>
280     </tr>
282   </tbody>
283 </table>
285 <br>
286 <hr><a name="Upgrade_Info"></a>
287 <h2><a name="Upgrade_Info">Upgrade Information</a></h2>
288 <p>
289 The EDMA3 LLD packages are available in the "packages/" subdirectory of
290 the product.
291 If you have a previous release of the EDMA3 LLD product, you can
292 install this
293 release next to it, and modify your application and/or server builds to
294 use this
295 newer release.
296 </p>
297 <hr>
298 <a name="Device_Support"></a>
299 <h2><a name="Device_Support">Device Support</a></h2>
300 <p>
301 This release supports and has been tested on the following devices:
302 </p>
303 <ul>
304   <a name="Device_Support"> <li>DA830 EVM:
305     <ul type="circle">
306       <li>C67x SYS/BIOS</li>
307     </ul>
308   </li>
309   <li>TCI6498 Simulator:</li>
310   </a>
311   <ul>
312     <li>C64X+ SYS/BIOS</li>
313   </ul>
314   <li>C6748 EVM:</li>
315   <li style="margin-left: 40px;" type="circle">C67x SYS/BIOS</li>
316   <li type="disc">OMAPL138 EVM:</li>
317   <li style="margin-left: 40px;" type="circle">C67x SYS/BIOS</li>
318   <li style="margin-left: 40px;" type="circle">ARM 9 SYSBIOS</li>
319     <li>TI816X EVM:</li>
320   </a>
321   <ul>
322     <li>C67X SYS/BIOS</li>
323         <li>A8 SYS/BIOS</li>
324     <li>M3 SYS/BIOS</li>
325   </ul>
326   <li>C6472 EVM:</li>
327   </a>
328   <ul>
329     <li>C64X+ SYS/BIOS</li>
330   </ul>
331     <li>TCI6486 EVM:</li>
332   </a>
333   <ul>
334     <li>C64X+ SYS/BIOS</li>
335   </ul>
336       <li>TI814X EVM:</li>
337   </a>
338   <ul>
339     <li>C67X SYS/BIOS</li>
340         <li>A8 SYS/BIOS</li>
341         <li>M3 SYS/BIOS</li>
342   </ul>
343     <li>TI811X EVM:</li>
344   </a>
345   <ul>
346     <li>C67X SYS/BIOS</li>
347         <li>A8 SYS/BIOS</li>
348     <li>M3 SYS/BIOS</li>
349   </ul>
350       <li>C6670 EVM:</li>
351   </a>
352   <ul>
353     <li>C66X SYS/BIOS</li>
354   </ul>      
355   <li>C6678 EVM:</li>
356   </a>
357   <ul>
358     <li>C66X SYS/BIOS</li>
359   </ul>      
360   <li>TCI6608 Simulator:</li>
361   </a>
362   <ul>
363     <li>C66X SYS/BIOS</li>
364   </ul>      
365   <li>TCI6616 Simulator:</li>
366   </a>
367   <ul>
368     <li>C66X SYS/BIOS</li>
369   </ul>
370   <li>TCI6614 EVM:</li>
371   </a>
372   <ul>
373     <li>C66X SYS/BIOS</li>
374   </ul>
375   <li>TCI6638K2K Simulator:</li>
376   </a>
377   <ul>
378     <li>C66X SYS/BIOS</li>
379   </ul>
380   <li>TCI6638K2K EVM:</li>
381   </a>
382   <ul>
383     <li>C66X SYS/BIOS</li>
384   </ul>
385   <li>TDA2XX SIM:</li>
386   </a>
387   <ul>
388     <li>M4 SYS/BIOS</li>
389     <li>a15 SYS/BIOS</li>
390     <li>c66x SYS/BIOS</li>
391     <li>EVE SYS/BIOS</li>
392   </ul>
393     </ul>
394 <hr>
395 <a name="Compatibility"></a>
396 <h2><a name="Compatibility">Compatibility Information</a></h2>
397 <h3><a name="Compatibility">Compatibility Key Definitions</a></h3>
398 <p>
399 Compatibility keys are intentionally independent of Marketing product
400 numbers
401 and are intended to:
402 </p>
403 <ol start="1" type="1">
404   <a name="Compatibility"> <li> Enable tooling to identify
405 incompatibilities between components, and </li>
406   <li> Convey a level of compatibility between different releases to
407 set end user expectations. </li>
408   </a>
409 </ol>
410 <p>
411 Compatibility keys are composed of 3 comma-delimited numbers - M, S, R
412 - where:
413 </p>
414 <ul type="disc">
415   <a name="Compatibility"> <li> <b>M = Major</b>. A difference in M
416 indicates a break in compatibility. </li>
417   <li> <b>S = Source</b>. A difference in S indicates source
418 compatibility. That is, the user's source doesn't require change, but <i>does</i>
419 require rebuilding. </li>
420   <li> <b>R = Radix</b>. A difference in R indicates an introduction
421 of new features, but compatibility with previous interfaces has not
422 broken. If libraries are provided by the package, an application must
423 re-link with the new libraries, but not rebuild from source. </li>
424   </a>
425 </ul>
426 <hr>
427 <a name="Validation"></a>
428 <h2><a name="Validation">Validation</a></h2>
429 <p>
430 This release was built and validated against using the following
431 components:
432 </p>
433 <ul type="disc">
434   <a name="Validation"> <li>CCS 5.4.0</li>
435   <li>C6x Code Generation Tools version 7.4.2 </li>
436   <li>TMS470 Code Generation Tools 5.0.4</li>
437   <li>Arm GCC A15 Toolchain (Linaro) 4.7.3</li>
438   <li>ARP32 Code Generation Tools 1.0.2</li>
439   <li>SYS/BIOS 6.35.03.47</li>
440   <li>XDC Tools 3.25.02.70</li>
441   <li>TCI6498 Simulator 0.7.1</li>
442   </a>
443 </ul>
444 <p>
445 This release was validated in the following configurations:
446 </p>
447 <ul>
448   <li> DA830 EVM:
449     <ul type="circle">
450       <li>C67x SYS/BIOS</li>
451     </ul>
452   </li>
453   <li> TCI6498 Simulator:
454     <ul type="circle">
455       <li>C64X+ SYS/BIOS</li>
456     </ul>
457   </li>
458   <li>C6748 EVM:</li>
459   <li style="margin-left: 40px;" type="circle">C67x SYS/BIOS</li>
460   <li>OMAPL138 EVM:</li>
461   <ul>
462     <li>C67x SYS/BIOS</li>
463     <li>ARM 9 SYSBIOS</li>
464   </ul>
465     <li>TI816X EVM:</li>
466   </a>
467   <ul>
468     <li>C67X SYS/BIOS</li>
469         <li>A8 SYS/BIOS</li>
470         <li>M3 SYS/BIOS</li>
471   </ul>
472   <li>C6472 EVM:</li>
473   </a>
474   <ul>
475     <li>C64X+ SYS/BIOS</li>
476   </ul>
477     <li>TCI6486 EVM:</li>
478   </a>
479   <ul>
480     <li>C64X+ SYS/BIOS</li>
481   </ul>
482     <li>TI814X EVM:</li>
483   </a>
484   <ul>
485     <li>C67X SYS/BIOS</li>
486         <li>A8 SYS/BIOS</li>
487         <li>M3 SYS/BIOS</li>
488   </ul>
489     <li>TI811X EVM:</li>
490   </a>
491   <ul>
492     <li>C67X SYS/BIOS</li>
493         <li>A8 SYS/BIOS</li>
494         <li>M3 SYS/BIOS</li>
495   </ul>
496       <li>C6670 EVM:</li>
497   </a>
498   <ul>
499     <li>C66X SYS/BIOS</li>
500   </ul>      
501   <li>C6678 EVM:</li>
502   </a>
503   <ul>
504     <li>C66X SYS/BIOS</li>
505   </ul>      
506   <li>TCI6608 Simulator:</li>
507   </a>
508   <ul>
509     <li>C66X SYS/BIOS</li>
510   </ul>      
511   <li>TCI6616 Simulator:</li>
512   </a>
513   <ul>
514     <li>C66X SYS/BIOS</li>
515   </ul>
516   <li>TCI6614 EVM:</li>
517   </a>
518   <ul>
519     <li>C66X SYS/BIOS</li>
520   </ul>
521   <li>TCI6638K2K Simulator:</li>
522   </a>
523   <ul>
524     <li>C66X SYS/BIOS</li>
525   </ul>
526   <li>TCI6638K2K EVM:</li>
527   </a>
528   <ul>
529     <li>C66X SYS/BIOS</li>
530   </ul>
531   <li>TDA2XX SIM:</li>
532   </a>
533   <ul>
534   <li>A15 SYS/BIOS</li>
535   <li>M4 SYS/BIOS</li>
536   <li>DSP SYS/BIOS</li>
537   <li>EVE SYS/BIOS</li>
538   </ul>
539   </ul>
540 <hr><a name="Known_Issues">
541 </a>
542 <h2><a name="Known_Issues">Known Issues</a></h2>
543 <p>
544 The following are known issues with the current EDMA3 LLD release:
545 </p>
546 <h4><a name="Known_Issues">Pre-built instrumented libraries for DA830
547 not provided initially.</a></h4>
548 <p>Pre-built instrumented EDMA3 libraries for DA830 will not be
549 provided
550 initially. XDC does not support the same and hence the limitation. See
551 IR#
552 SDOCM00036738 for more details.
553 </p>
554 <h4><a name="Known_Issues">EDMA3 hardware does not work properly in
555 FIFO mode with all the controllers.</a></h4>
556 <p>Very few peripherals support EDMA3 FIFO mode. EMIF controller
557 doesn't support
558 the same. So EDMA3 CANNOT be used in FIFO mode for doing a
559 memory-to-memory data
560 transfers, EDMA3 being configured in the FIFO mode. Applications trying
561 to use
562 EDMA3 in FIFO mode should first check their respective
563 peripheral-controller
564 document for this mode support.
565 </p>
566 <h4><a name="Known_Issues">PingPong Example Fails for certain EDMA
567 instances for some DSP cores in Release mode only.</a></h4>
568 <p>The PingPong example in the package fails for certain EDMA Instances
569 for some DSP cores in Release mode only. It passes for Debug mode. See
570 IR#
571 SDOCM00064758 for more details.
572 </p>
573 <hr>
574 <a name="Examples"></a>
575 <h2><a name="Examples">Examples</a></h2>
576 <p>
577 EDMA3 LLD sample initialization libraries / OS abstraction layers (for
578 different
579 platforms) are located in:
580 </p>
581 <ul type="disc">
582   <a name="Examples"> <li> For Resource Manager: They could be located
583 in <tt>edma3_lld_02_11_11_XX\packages\ti\sdo\edma3\rm\sample\lib</tt>
584 folder. </li>
585   <li> For EDMA3 Driver: They could be located in <tt>edma3_lld_02_11_11_XX\packages\ti\sdo\edma3\drv\sample\lib</tt>
586 folder. </li>
587   </a>
588 </ul>
589 <p>
590 EDMA3 LLD stand-alone applications (for different platforms) are
591 located in:
592 </p>
593 <ul type="disc">
594   <a name="Examples"> <li> EDMA3 Driver: They could be located in <tt>edma3_lld_02_11_11_XX\examples\edma3_driver\</tt>
595 folder. </li>
596   </a>
597 </ul>
598 <ul type="disc">
599   <a name="Examples"> <li> CSL2.x DAT Reference Implementation: It
600 could be located in <tt>edma3_lld_02_11_11_XX\examples\CSL2_DAT_DEMO\</tt>
601 folder. </li>
602   </a>
603 </ul>
604 <hr>
605 <a name="Version"></a>
606 <h2><a name="Version">Version Information</a></h2>
607 <p>
608 This product's version follows a version format, <b>M.mm.pp.bb</b>,
609 where
610 <b>M</b> is a 2 digit major number,
611 <b>mm</b> is 2 digit minor number,
612 <b>pp</b> is a 2 digit patch number, and
613 <b>b</b> is an unrestricted set of digits used as an incrementing build
614 counter.
615 </p>
616 <p>
617 To support multiple side-by-side installations of the product, the
618 product
619 version is encoded in the top level directory, ex. <b>edma3_lld_02_11_11_XX</b>.
620 </p>
621 <p>Subsequent releases of patch upgrades will be identified by the
622 patch number,
623 ex. EDMA3 LLD 02.11.11 with directory <b>edma3_lld_02_11_11_YY</b>.
624 Typically, these
625 patches only include critical bug fixes.
626 </p>
627 <hr>
628 <a name="Support"></a>
629 <h2><a name="Support">Technical Support</a></h2>
630 <p>
631 For technical support, Please post at TI E2E forum <a href="http://e2e.ti.com/support/embedded/f/355.aspx">http://e2e.ti.com/support/embedded/f/355.aspx</a>
632 </p>
633 <hr>
634 <p>Last updated: Jan 7, 2013
635 </p>
636 </body>
637 </html>