Add more comments
authorFrank Livingston <frank-livingston@ti.com>
Wed, 5 Apr 2017 15:49:45 +0000 (10:49 -0500)
committerFrank Livingston <frank-livingston@ti.com>
Wed, 5 Apr 2017 15:49:45 +0000 (10:49 -0500)
pasdk/common/paf_heapMgr.c
pasdk/common/paf_heapMgr.h
pasdk/test_arm/framework/itopo/params.c
pasdk/test_dsp/framework/itopo/params.c

index 3a45dc73ed3a67683f3ce27e0c5418cc31ac2f9a..f41b2648618eadb65a00984029887398e744285d 100644 (file)
@@ -38,12 +38,12 @@ All rights reserved.
 
 #include "paf_heapMgr.h"
 
-Int gPafHeapIdInt             = PAF_HEAP_ID_INT;
-Int gPafHeapIdInt1            = PAF_HEAP_ID_INT1;
-Int gPafHeapIdExt             = PAF_HEAP_ID_EXT;
-Int gPafHeapIdInt1Shm         = PAF_HEAP_ID_INT1_SHM;
-Int gPafHeapIdExtShm          = PAF_HEAP_ID_EXT_SHM;
-Int gPafHeapIdExtNonCachedShm = PAF_HEAP_ID_EXT_NON_CACHED_SHM;
+Int gPafHeapIdInt             = PAF_HEAP_ID_INT;                // L2 SRAM
+Int gPafHeapIdInt1            = PAF_HEAP_ID_INT1;               // MSMC SRAM
+Int gPafHeapIdExt             = PAF_HEAP_ID_EXT;                // DDR3
+Int gPafHeapIdInt1Shm         = PAF_HEAP_ID_INT1_SHM;           // MSMC SRAM, Shared
+Int gPafHeapIdExtShm          = PAF_HEAP_ID_EXT_SHM;            // DDR3, Shared
+Int gPafHeapIdExtNonCachedShm = PAF_HEAP_ID_EXT_NON_CACHED_SHM; // DDR3 non-cached, Shared
 
 // heap handle array
 //static IHeap_Handle gHeapIdToHandle[PAF_NUM_HEAPS] =
index 5bda76e80b237543c00aba79189ccc3c171cde59..46c7890bcd2b4b50eccb729d224b81ec766fa15c 100644 (file)
@@ -49,12 +49,12 @@ All rights reserved.
 #define PAF_HEAP_ID_EXT_SHM             ( 4 )   // DDR3, Shared
 #define PAF_HEAP_ID_EXT_NON_CACHED_SHM  ( 5 )   // DDR3 non-cached, Shared
 
-extern Int gPafHeapIdInt;
-extern Int gPafHeapIdInt1;
-extern Int gPafHeapIdExt;
-extern Int gPafHeapIdInt1Shm;
-extern Int gPafHeapIdExtShm;
-extern Int gPafHeapIdExtNonCachedShm;
+extern Int gPafHeapIdInt;                       // L2 SRAM
+extern Int gPafHeapIdInt1;                      // MSMC SRAM
+extern Int gPafHeapIdExt;                       // DDR3
+extern Int gPafHeapIdInt1Shm;                   // MSMC SRAM, Shared
+extern Int gPafHeapIdExtShm;                    // DDR3, Shared
+extern Int gPafHeapIdExtNonCachedShm;           // DDR3 non-cached, Shared
 
 /* Initialize PAF heap manager */
 Void pafHeapMgr_init(
index dc8dd1947a985481ab639bade2332b28a31535ff..c16a5b760a786b57312944bb669b754f7e1e6ace 100644 (file)
@@ -183,11 +183,11 @@ const PAF_DecodeStatus PAF_AST_params_decodeStatus_primary =
     4,                                                      // sourceKaraoke: both
     0,                                                      // aspGearControl: unused
     0,                                                      // aspGearStatus: unused
-    0, 0, 0, 0,                                                // Unused
-    0, 0, 0, 0,                                                // Unused
-    0, 0, 0, 0,                                                // Unused
-    0, 0, 0, 0,                                                // Unused
-    0, 0, 0, 0,                                                // Unused
+    0, 0, 0, 0,                                             // Unused
+    0, 0, 0, 0,                                             // Unused
+    0, 0, 0, 0,                                             // Unused
+    0, 0, 0, 0,                                             // Unused
+    0, 0, 0, 0,                                             // Unused
     0,                                                      // frameCount
     0x40,                                                   // karaoka: Vocal 1 Level
     0x40,                                                   // karaoka: Vocal 1 Pan
@@ -197,10 +197,10 @@ const PAF_DecodeStatus PAF_AST_params_decodeStatus_primary =
     0x00,                                                   // karaoka: Melody Pan
     0,                                                      // decBypass
     0,                                                      // unused
-    0,                                                         // frameLength: reset later
+    0,                                                      // frameLength: reset later
     1,                                                      // bufferRatio: unity
     PAF_IEC_PREEMPHASIS_UNKNOWN,                            // emphasis
-    0,                                                        // bufferDrift
+    0,                                                      // bufferDrift
     0, 0,
     PAF_CC_SAT_SURROUND4, PAF_CC_SUB_ONE, PAF_CC_AUX_SURROUND4_UNKNOWN, 0, 0, 0, 0, 0,    
     // channelConfigurationRequest.full
@@ -419,25 +419,25 @@ const PAF_AudioFrameBufStatus    PAF_AST_params_AudioFrameBufStatus[PAF_MAXNUMCH
 
 const PAF_ASDT_Params asdp_params_PAi =
 {
-    &PAF_ASDT_params_fxns,                                     // fxns
-    {                                                          // zone
-        0,                                                     // master
-        1,                                                     // decodes
-        0,                                                     // decode1
-        1,                                                     // decodeN
-        1,                                                     // streams
+    &PAF_ASDT_params_fxns,                                  // fxns
+    {                                                       // zone
+        0,                                                  // zone.master
+        1,                                                  // zone.decodes
+        0,                                                  // zone.decode1
+        1,                                                  // zone.decodeN
+        1,                                                  // zone.streams
     },
     PAF_AST_inputsFromDecodes_std,
     {                                                       // heap
-        &gPafHeapIdInt1,    //&IRAM                         // pIntern
-        &gPafHeapIdExt,     //&SDRAM,                       // pExtern
-        //&gPafHeapIdInt1,    //&IRAM,                        // pFrmbuf
-        &gPafHeapIdExt,     //&SDRAM,                        // pFrmbuf //Qin - moved to external memory
-        &gPafHeapIdInt1,    //&L3RAM,                       // pIntern1
-        1,                                                  // clear
+        &gPafHeapIdInt1,    //&IRAM                         // heap.pIntern
+        &gPafHeapIdExt,     //&SDRAM,                       // heap.pExtern
+        //&gPafHeapIdInt1,    //&IRAM,                        // heap.pFrmbuf
+        &gPafHeapIdExt,     //&SDRAM,                        // heap.pFrmbuf //Qin - moved to external memory
+        &gPafHeapIdInt1,    //&L3RAM,                       // heap.pIntern1
+        1,                                                  // heap.clear
     },
     {                                                       // common
-        params_memspace_PAi_Slave,                          // space
+        params_memspace_PAi_Slave,                          // common.space
     },
     PAF_AST_params_numchan,                                 // z_numchan
     PAF_SYS_FRAMELENGTH,                                    // framelength
index 6bb26f20010d139f9a27c6894802c65bf1c73505..f4b4fc4fbc5d91585a0a8f82b3d81d9c825243c7 100644 (file)
@@ -835,38 +835,38 @@ const PAF_AudioFrameBufStatus    PAF_AST_params_AudioFrameBufStatus[PAF_MAXNUMCH
 
 const PAF_ASIT_Params asip_params_PAi =
 {
-    &PAF_ASIT_params_fxns,                                     // fxns
-    {                                                          // zone
-        0,                                                     // master
-        1,                                                     // inputs
-        0,                                                     // input1
-        1,                                                     // inputN
-        1,                                                     // decodes
-        0,                                                     // decode1
-        1,                                                     // decodeN
-        1,                                                     // streams
-        0,                                                     // stream1 /* unused */
-        1,                                                     // streamN /* unused */
-        1,                                                     // encodes
-        0,                                                     // encode1
-        1,                                                     // encodeN
-        1,                                                     // outputs
-        0,                                                     // output1
-        1,                                                     // outputN
+    &PAF_ASIT_params_fxns,                                  // fxns
+    {                                                       // zone
+        0,                                                  // zone.master
+        1,                                                  // zone.inputs
+        0,                                                  // zone.input1
+        1,                                                  // zone.inputN
+        1,                                                  // zone.decodes
+        0,                                                  // zone.decode1
+        1,                                                  // zone.decodeN
+        1,                                                  // zone.streams
+        0,                                                  // zone.stream1 /* unused */
+        1,                                                  // zone.streamN /* unused */
+        1,                                                  // zone.encodes
+        0,                                                  // zone.encode1
+        1,                                                  // zone.encodeN
+        1,                                                  // zone.outputs
+        0,                                                  // zone.output1
+        1,                                                  // zone.outputN
     },
     PAF_AST_inputsFromDecodes_std,
     PAF_AST_outputsFromEncodes_std,
     {                                                       // heap
-        &gPafHeapIdInt,    //&IRAM,                         // pIntern
-        &gPafHeapIdExt,    //&SDRAM,                        // pExtern
-        &gPafHeapIdInt,    //&IRAM,                         // pInpbuf
-        &gPafHeapIdInt,    //&IRAM,                         // pOutbuf
-        &gPafHeapIdInt,    //&IRAM,                         // pFrmbuf
-        &gPafHeapIdInt1,   //&L3RAM,                        // pIntern1
-        1,                                                  // clear
+        &gPafHeapIdInt,    //&IRAM,                         // heap.pIntern
+        &gPafHeapIdExt,    //&SDRAM,                        // heap.pExtern
+        &gPafHeapIdInt,    //&IRAM,                         // heap.pInpbuf
+        &gPafHeapIdInt,    //&IRAM,                         // heap.pOutbuf
+        &gPafHeapIdInt,    //&IRAM,                         // heap.pFrmbuf
+        &gPafHeapIdInt1,   //&L3RAM,                        // heap.pIntern1
+        1,                                                  // heap.clear
     },
     {                                                       // common
-        params_memspace_PAi,                                // space
+        params_memspace_PAi,                                // common.space
     },
     NULL,                                                   // z_rx_bufsiz
     NULL,                                                   // z_tx_bufsiz
@@ -899,38 +899,38 @@ extern const PAF_ASOT_Fxns PAF_ASOT_params_fxns;
 //(***) FL: re-visit, clean this up (remove unused members)
 const PAF_ASOT_Params asop_params_PAi =
 {
-    &PAF_ASOT_params_fxns,                                     // fxns
-    {                                                          // zone
-        0,                                                     // master
-        1,                                                     // inputs
-        0,                                                     // input1
-        1,                                                     // inputN
-        1,                                                     // decodes
-        0,                                                     // decode1
-        1,                                                     // decodeN
-        1,                                                     // streams
-        0,                                                     // stream1 /* unused */
-        1,                                                     // streamN /* unused */
-        1,                                                     // encodes
-        0,                                                     // encode1
-        1,                                                     // encodeN
-        1,                                                     // outputs
-        0,                                                     // output1
-        1,                                                     // outputN
+    &PAF_ASOT_params_fxns,                                  // fxns
+    {                                                       // zone
+        0,                                                  // zone.master
+        1,                                                  // zone.inputs
+        0,                                                  // zone.input1
+        1,                                                  // zone.inputN
+        1,                                                  // zone.decodes
+        0,                                                  // zone.decode1
+        1,                                                  // zone.decodeN
+        1,                                                  // zone.streams
+        0,                                                  // zone.stream1 /* unused */
+        1,                                                  // zone.streamN /* unused */
+        1,                                                  // zone.encodes
+        0,                                                  // zone.encode1
+        1,                                                  // zone.encodeN
+        1,                                                  // zone.outputs
+        0,                                                  // zone.output1
+        1,                                                  // zone.outputN
     },
     PAF_AST_inputsFromDecodes_std,
     PAF_AST_outputsFromEncodes_std,
     {                                                       // heap
-        &gPafHeapIdInt,    //&IRAM,                         // pIntern
-        &gPafHeapIdExt,    //&SDRAM,                        // pExtern
-        &gPafHeapIdInt,    //&IRAM,                         // pInpbuf
-        &gPafHeapIdInt,    //&IRAM,                         // pOutbuf
-        &gPafHeapIdInt,    //&IRAM,                         // pFrmbuf
-        &gPafHeapIdInt1,   //&L3RAM,                        // pIntern1
-        1,                                                  // clear
+        &gPafHeapIdInt,    //&IRAM,                         // heap.pIntern
+        &gPafHeapIdExt,    //&SDRAM,                        // heap.pExtern
+        &gPafHeapIdInt,    //&IRAM,                         // heap.pInpbuf
+        &gPafHeapIdInt,    //&IRAM,                         // heap.pOutbuf
+        &gPafHeapIdInt,    //&IRAM,                         // heap.pFrmbuf
+        &gPafHeapIdInt1,   //&L3RAM,                        // heap.pIntern1
+        1,                                                  // heap.clear
     },
     {                                                       // common
-        params_memspace_PAi,                                // space
+        params_memspace_PAi,                                // common.space
     },
     NULL,                                                   // z_rx_bufsiz
     NULL,                                                   // z_tx_bufsiz