PDK API Guide for AM64x
udma_ring.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) Texas Instruments Incorporated 2018
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  *
8  * Redistributions of source code must retain the above copyright
9  * notice, this list of conditions and the following disclaimer.
10  *
11  * Redistributions in binary form must reproduce the above copyright
12  * notice, this list of conditions and the following disclaimer in the
13  * documentation and/or other materials provided with the
14  * distribution.
15  *
16  * Neither the name of Texas Instruments Incorporated nor the names of
17  * its contributors may be used to endorse or promote products derived
18  * from this software without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
23  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
24  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
25  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
26  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
30  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31  */
32 
48 #ifndef UDMA_RING_H_
49 #define UDMA_RING_H_
50 
51 /* ========================================================================== */
52 /* Include Files */
53 /* ========================================================================== */
54 
55 /* None */
56 
57 #ifdef __cplusplus
58 extern "C" {
59 #endif
60 
61 /* ========================================================================== */
62 /* Macros & Typedefs */
63 /* ========================================================================== */
64 
69 #define UDMA_RING_INVALID ((uint16_t) TISCI_MSG_VALUE_RM_NULL_RING_TYPE)
70 
74 #define UDMA_RING_ANY ((uint16_t) 0xFFFEU)
75 
79 #define UDMA_RING_MON_INVALID (UDMA_RING_INVALID)
80 
84 #define UDMA_RING_MON_ANY (UDMA_RING_ANY)
85 
89 #define UDMA_RING_VIRTID_INVALID ((uint16_t) 0xFFFFU)
90 
92 #define UDMA_RING_SIZE_CHECK_SKIP (0xABDCABCDU)
93 
97 #define UDMA_RING_ORDERID_MAX (0x0FU)
98 
111 #define UDMA_RING_ES_4BYTES ((uint8_t) 0x00U)
112 
113 #define UDMA_RING_ES_8BYTES ((uint8_t) 0x01U)
114 
115 #define UDMA_RING_ES_16BYTES ((uint8_t) 0x02U)
116 
117 #define UDMA_RING_ES_32BYTES ((uint8_t) 0x03U)
118 
119 #define UDMA_RING_ES_64BYTES ((uint8_t) 0x04U)
120 
121 #define UDMA_RING_ES_128BYTES ((uint8_t) 0x05U)
122 
123 #define UDMA_RING_ES_256BYTES ((uint8_t) 0x06U)
124 /* @} */
125 
126 /* ========================================================================== */
127 /* Structure Declarations */
128 /* ========================================================================== */
129 
133 typedef struct
134 {
135  void *ringMem;
142  uint32_t ringMemSize;
149  uint8_t mode;
151  uint16_t virtId;
153  uint32_t elemCnt;
157  uint8_t elemSize;
160  uint8_t orderId;
163  uint8_t asel;
171  uint32_t mappedRingGrp;
180  uint32_t mappedChNum;
193 } Udma_RingPrms;
194 
198 typedef struct
199 {
200  uint8_t source;
202  uint8_t mode;
204  uint16_t ringNum;
206  uint32_t data0;
216  uint32_t data1;
227 
231 typedef struct
232 {
233  uint32_t data0;
243  uint32_t data1;
254 
255 /* ========================================================================== */
256 /* Function Declarations */
257 /* ========================================================================== */
258 
279 int32_t Udma_ringAlloc(Udma_DrvHandle drvHandle,
280  Udma_RingHandle ringHandle,
281  uint16_t ringNum,
282  const Udma_RingPrms *ringPrms);
283 
296 int32_t Udma_ringFree(Udma_RingHandle ringHandle);
297 
328 int32_t Udma_ringAttach(Udma_DrvHandle drvHandle,
329  Udma_RingHandle ringHandle,
330  uint16_t ringNum);
331 
345 int32_t Udma_ringDetach(Udma_RingHandle ringHandle);
346 
375 int32_t Udma_ringQueueRaw(Udma_RingHandle ringHandle, uint64_t phyDescMem);
376 
413 int32_t Udma_ringDequeueRaw(Udma_RingHandle ringHandle, uint64_t *phyDescMem);
414 
438 int32_t Udma_ringFlushRaw(Udma_RingHandle ringHandle, uint64_t *phyDescMem);
439 
466 void Udma_ringPrime(Udma_RingHandle ringHandle, uint64_t phyDescMem);
467 
496 void Udma_ringPrimeRead(Udma_RingHandle ringHandle, uint64_t *phyDescMem);
497 
525 void Udma_ringSetDoorBell(Udma_RingHandle ringHandle, int32_t count);
526 
537 uint16_t Udma_ringGetNum(Udma_RingHandle ringHandle);
538 
549 void *Udma_ringGetMemPtr(Udma_RingHandle ringHandle);
550 
561 uint32_t Udma_ringGetMode(Udma_RingHandle ringHandle);
562 
573 uint32_t Udma_ringGetElementCnt(Udma_RingHandle ringHandle);
574 
591 uint32_t Udma_ringGetForwardRingOcc(Udma_RingHandle ringHandle);
592 
609 uint32_t Udma_ringGetReverseRingOcc(Udma_RingHandle ringHandle);
610 
627 uint32_t Udma_ringGetWrIdx(Udma_RingHandle ringHandle);
628 
645 uint32_t Udma_ringGetRdIdx(Udma_RingHandle ringHandle);
646 
668 int32_t Udma_ringMonAlloc(Udma_DrvHandle drvHandle,
669  Udma_RingMonHandle monHandle,
670  uint16_t ringMonNum);
671 
687 int32_t Udma_ringMonFree(Udma_RingMonHandle monHandle);
688 
703 int32_t Udma_ringMonConfig(Udma_RingMonHandle monHandle,
704  const Udma_RingMonPrms *monPrms);
705 
722 int32_t Udma_ringMonGetData(Udma_RingMonHandle monHandle,
723  Udma_RingMonData *monData);
724 
738 uint16_t Udma_ringMonGetNum(Udma_RingMonHandle monHandle);
739 
740 /*
741  * Structure Init functions
742  */
749 void UdmaRingPrms_init(Udma_RingPrms *ringPrms);
750 
758 
759 /* ========================================================================== */
760 /* Static Function Definitions */
761 /* ========================================================================== */
762 
763 /* None */
764 
765 /* ========================================================================== */
766 /* Internal/Private Structure Declarations */
767 /* ========================================================================== */
768 
776 {
777  Udma_DrvHandle drvHandle;
780  uint16_t ringNum;
783 #if (UDMA_SOC_CFG_RA_NORMAL_PRESENT == 1)
784  CSL_RingAccRingCfg cfg;
787  /* Below register overlay pointers provided for debug purpose to
788  * readily view the registers */
789  volatile CSL_ringacc_cfgRegs_RING *pCfgRegs;
791  volatile CSL_ringacc_rtRegs_RINGRT *pRtRegs;
793 #endif
794 #if (UDMA_SOC_CFG_RA_LCDMA_PRESENT == 1)
795  CSL_LcdmaRingaccRingCfg lcdmaCfg;
798  /* Below register overlay pointers provided for debug purpose to
799  * readily view the registers */
800  volatile CSL_lcdma_ringacc_ring_cfgRegs_RING *pLcdmaCfgRegs;
802  volatile CSL_lcdma_ringacc_ringrtRegs_ring *pLcdmaRtRegs;
804 #endif
805 
806 #if (UDMA_SOC_CFG_PROXY_PRESENT == 1)
807  /* Proxy address for the ring. Calculated at alloc time to reduce cycles at
808  * runtime */
809  uintptr_t proxyAddr;
811 #endif
812 
813  uint32_t ringInitDone;
816  uint32_t mappedRingGrp;
827  uint32_t mappedChNum;
835 };
836 
844 {
845  Udma_DrvHandle drvHandle;
848  uint16_t ringMonNum;
851 #if (UDMA_SOC_CFG_RING_MON_PRESENT == 1)
852  /* Below register overlay pointers provided for debug purpose to
853  * readily view the registers */
854  volatile CSL_ringacc_monitorRegs_mon *pMonRegs;
856 #endif
857 
858  uint32_t ringMonInitDone;
860 };
861 
862 #ifdef __cplusplus
863 }
864 #endif
865 
866 #endif /* #ifndef UDMA_RING_H_ */
867 
868 /* @} */
uint32_t mappedRingGrp
Definition: udma_ring.h:816
Udma_DrvHandle drvHandle
Definition: udma_ring.h:777
uint16_t ringNum
Definition: udma_ring.h:204
void Udma_ringPrimeRead(Udma_RingHandle ringHandle, uint64_t *phyDescMem)
UDMA read descriptor from a exposed/"RING" mode ring - raw version (Reads physical pointers)....
UDMA ring parameters.
Definition: udma_ring.h:133
uint16_t ringMonNum
Definition: udma_ring.h:848
uint32_t Udma_ringGetMode(Udma_RingHandle ringHandle)
Returns the ring mode which is configured during ring alloc.
uint32_t Udma_ringGetRdIdx(Udma_RingHandle ringHandle)
Returns the ring read index value.
Udma_DrvHandle drvHandle
Definition: udma_ring.h:845
uint32_t count
Definition: tisci_rm_ra.h:166
void Udma_ringPrime(Udma_RingHandle ringHandle, uint64_t phyDescMem)
UDMA prime descriptor to a exposed/"RING" mode ring - raw version (Takes all physical pointers)....
uint32_t elemCnt
Definition: udma_ring.h:153
int32_t Udma_ringQueueRaw(Udma_RingHandle ringHandle, uint64_t phyDescMem)
UDMA queue descriptor to a ring - raw version (Takes all physical pointers)
uint8_t elemSize
Definition: udma_ring.h:157
void UdmaRingPrms_init(Udma_RingPrms *ringPrms)
Udma_RingPrms structure init function.
uint32_t mappedChNum
Definition: udma_ring.h:827
uint8_t source
Definition: udma_ring.h:200
int32_t Udma_ringAttach(Udma_DrvHandle drvHandle, Udma_RingHandle ringHandle, uint16_t ringNum)
UDMA ring attach API. This API is used to attach to an already allocated and configured ring....
int32_t Udma_ringMonConfig(Udma_RingMonHandle monHandle, const Udma_RingMonPrms *monPrms)
UDMA ring monitor configure API.
void UdmaRingMonPrms_init(Udma_RingMonPrms *monPrms)
Udma_RingMonPrms structure init function.
uint16_t Udma_ringGetNum(Udma_RingHandle ringHandle)
Returns the ring number allocated for this ring.
uint32_t data1
Definition: udma_ring.h:216
UDMA ring object.
Definition: udma_ring.h:775
int32_t Udma_ringAlloc(Udma_DrvHandle drvHandle, Udma_RingHandle ringHandle, uint16_t ringNum, const Udma_RingPrms *ringPrms)
UDMA ring allocation and configuration API.
UDMA ring monitor data.
Definition: udma_ring.h:231
uint32_t data1
Definition: udma_ring.h:243
UDMA ring monitor parameters.
Definition: udma_ring.h:198
UDMA ring monitor object.
Definition: udma_ring.h:843
uint16_t ringNum
Definition: udma_ring.h:780
uint32_t ringInitDone
Definition: udma_ring.h:813
uint32_t Udma_ringGetElementCnt(Udma_RingHandle ringHandle)
Returns the ring element count which is passed during ring alloc.
uint32_t Udma_ringGetWrIdx(Udma_RingHandle ringHandle)
Returns the ring write index value.
uint32_t Udma_ringGetReverseRingOcc(Udma_RingHandle ringHandle)
Returns the reverse ring occupancy.
uint32_t data0
Definition: udma_ring.h:233
uint32_t mappedRingGrp
Definition: udma_ring.h:171
int32_t Udma_ringDetach(Udma_RingHandle ringHandle)
UDMA detach ring API.
void * Udma_ringGetMemPtr(Udma_RingHandle ringHandle)
Returns the ring memory pointer which is passed during ring alloc.
uint8_t orderId
Definition: udma_ring.h:160
uint8_t mode
Definition: udma_ring.h:202
void Udma_ringSetDoorBell(Udma_RingHandle ringHandle, int32_t count)
UDMA ring API to set the doorbell in exposed/"RING" mode ring. This will commit the previously primed...
int32_t Udma_ringMonFree(Udma_RingMonHandle monHandle)
UDMA free ring monitor.
int32_t Udma_ringFlushRaw(Udma_RingHandle ringHandle, uint64_t *phyDescMem)
UDMA dequeue descriptor from a ring when UDMA channel is disabled - raw version (Takes all physical p...
uint16_t Udma_ringMonGetNum(Udma_RingMonHandle monHandle)
Returns the ring monitor number.
int32_t Udma_ringFree(Udma_RingHandle ringHandle)
UDMA free ring.
uint32_t ringMonInitDone
Definition: udma_ring.h:858
int32_t Udma_ringMonGetData(Udma_RingMonHandle monHandle, Udma_RingMonData *monData)
UDMA ring monitor get data API.
uint32_t data0
Definition: udma_ring.h:206
uint16_t virtId
Definition: udma_ring.h:151
void * ringMem
Definition: udma_ring.h:135
uint32_t ringMemSize
Definition: udma_ring.h:142
CSL_LcdmaRingaccRingCfg contains information to configure a ring.
Definition: csl_lcdma_ringacc.h:260
uint32_t mappedChNum
Definition: udma_ring.h:180
uint8_t mode
Definition: udma_ring.h:149
uint32_t Udma_ringGetForwardRingOcc(Udma_RingHandle ringHandle)
Returns the forward ring occupancy.
int32_t Udma_ringMonAlloc(Udma_DrvHandle drvHandle, Udma_RingMonHandle monHandle, uint16_t ringMonNum)
UDMA ring monitor allocation API.
int32_t Udma_ringDequeueRaw(Udma_RingHandle ringHandle, uint64_t *phyDescMem)
UDMA dequeue descriptor from a ring - raw version (Takes all physical pointers).
uint8_t asel
Definition: udma_ring.h:163