AM62L FreeRTOS SDK  11.00.00
udma_soc.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2025 Texas Instruments Incorporated
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 
47 #ifndef UDMA_SOC_H_
48 #define UDMA_SOC_H_
49 
50 /* ========================================================================== */
51 /* Include Files */
52 /* ========================================================================== */
53 
54 /* None */
55 
56 #ifdef __cplusplus
57 extern "C" {
58 #endif
59 
60 /* ========================================================================== */
61 /* Macros & Typedefs */
62 /* ========================================================================== */
63 
73 #define UDMA_INST_ID_BCDMA_0 (UDMA_INST_ID_2)
74 
75 #define UDMA_INST_ID_PKTDMA_0 (UDMA_INST_ID_3)
76 
77 #define UDMA_INST_ID_START (UDMA_INST_ID_2)
78 
79 #define UDMA_INST_ID_MAX (UDMA_INST_ID_3)
80 
81 #define UDMA_NUM_INST_ID (UDMA_INST_ID_MAX - UDMA_INST_ID_START + 1U)
82 
83 #define UDMA_SOC_TOTAL_CHAN_NUM (79U)
84 
85 #define UDMA_SOC_PKTDMA_TOTAL_TX_RX_CHAN (97U)
86 
87 #define UDMA_SOC_BCDMA_TOTAL_TX_RX_CHAN (82U)
88 
89 #define UDMA_SOC_MAX_TIMEOUT (1U * 1000U) /*1ms*/
90 
101 #define UDMA_SOC_CFG_LCDMA_PRESENT (1U)
102 
104 #define UDMA_SOC_CFG_RA_LCDMA_PRESENT (1U)
105 
106 #define UDMA_SOC_CFG_UDMAP_PRESENT (0U)
107 
109 #define UDMA_SOC_CFG_PROXY_PRESENT (0U)
110 
112 #define UDMA_SOC_CFG_CLEC_PRESENT (0U)
113 
115 #define UDMA_SOC_CFG_RA_NORMAL_PRESENT (0U)
116 
118 #define UDMA_SOC_CFG_RING_MON_PRESENT (0U)
119 
121 #define UDMA_SOC_CFG_APPLY_RING_WORKAROUND (0U)
122 
134 #define UDMA_TX_UHC_CHANS_FDEPTH (0U)
135 
136 #define UDMA_TX_HC_CHANS_FDEPTH (0U)
137 
138 #define UDMA_TX_CHANS_FDEPTH (192U)
139 
150 #define UDMA_RINGACC_ASEL_ENDPOINT_PHYSADDR ((uint32_t) 0U)
151 
152 #define UDMA_RINGACC_ASEL_ENDPOINT_PCIE0 ((uint32_t) 1U)
153 
154 #define UDMA_RINGACC_ASEL_ENDPOINT_ACP_WR_ALLOC ((uint32_t) 14U)
155 
156 #define UDMA_RINGACC_ASEL_ENDPOINT_ACP_RD_ALLOC ((uint32_t) 15U)
157 
160 #define UDMA_NUM_MAPPED_TX_GROUP (2U)
161 
169 #define UDMA_MAPPED_TX_GROUP_CPSW (UDMA_MAPPED_GROUP0)
170 #define UDMA_MAPPED_TX_GROUP_DTHE (UDMA_MAPPED_GROUP1)
171 
174 #define UDMA_NUM_MAPPED_RX_GROUP (2U)
175 
183 #define UDMA_MAPPED_RX_GROUP_CPSW (UDMA_MAPPED_GROUP2)
184 #define UDMA_MAPPED_RX_GROUP_DTHE (UDMA_MAPPED_GROUP3)
185 
196 #define UDMA_RM_RES_ID_BC_UHC (0U)
197 
198 #define UDMA_RM_RES_ID_BC_HC (1U)
199 
200 #define UDMA_RM_RES_ID_BC (2U)
201 
202 #define UDMA_RM_RES_ID_TX_UHC (3U)
203 
204 #define UDMA_RM_RES_ID_TX_HC (4U)
205 
206 #define UDMA_RM_RES_ID_TX (5U)
207 
208 #define UDMA_RM_RES_ID_RX_UHC (6U)
209 
210 #define UDMA_RM_RES_ID_RX_HC (7U)
211 
212 #define UDMA_RM_RES_ID_RX (8U)
213 
214 #define UDMA_RM_RES_ID_MAPPED_TX_CPSW (11U)
215 
216 #define UDMA_RM_RES_ID_MAPPED_RX_CPSW (16U)
217 
218 #define UDMA_RM_RES_ID_MAPPED_TX_RING_CPSW (23U)
219 
220 #define UDMA_RM_NUM_BCDMA_RES (11U)
221 
222 #define UDMA_RM_NUM_PKTDMA_RES (35U)
223 
224 #define UDMA_RM_NUM_RES (35U)
225 
226 #define UDMA_RM_BLKCPY_START (128U)
227 
228 #define UDMA_RM_SPLIT_TX_START (1U)
229 
230 #define UDMA_RM_SPLIT_RX_START (0U)
231 
232 #define UDMA_RM_TOTAL_CH_INT (229U)
233 
234 #define UDMA_RM_BLKCPY_BC_CH_INT_OFFSET (420U)
235 
236 #define UDMA_RM_CH_INT_START (352U)
237 
240 #define UDMA_PSIL_DEST_THREAD_OFFSET (0x8000U)
241 
251 #define UDMA_PSIL_CH_CPSW2_RX (0x4600U)
252 #define UDMA_PSIL_CH_DTHE_RX (0x4000U)
253 
254 #define UDMA_PSIL_CH_CPSW2_TX0 (UDMA_PSIL_CH_CPSW2_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
255 #define UDMA_PSIL_CH_CPSW2_TX1 (0xC601U)
256 #define UDMA_PSIL_CH_CPSW2_TX2 (0xC602U)
257 #define UDMA_PSIL_CH_CPSW2_TX3 (0xC603U)
258 #define UDMA_PSIL_CH_CPSW2_TX4 (0xC604U)
259 #define UDMA_PSIL_CH_CPSW2_TX5 (0xC605U)
260 #define UDMA_PSIL_CH_CPSW2_TX6 (0xC606U)
261 #define UDMA_PSIL_CH_CPSW2_TX7 (0xC607U)
262 #define UDMA_PSIL_CH_DTHE_TX (UDMA_PSIL_CH_DTHE_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
263 
264 #define UDMA_PSIL_CH_CPSW2_TX_CNT (8U)
265 
266 #define UDMA_PSIL_CH_CPSW2_RX_CNT (1U)
267 #define UDMA_PSIL_CH_DTHE_RX_CNT (4U)
268 
290 /*
291  * PDMA MAIN0 MCSPI RX Channels
292  */
293 #define UDMA_PDMA_CH_MAIN0_MCSPI0_CH0_RX (0x4300U + 0U)
294 #define UDMA_PDMA_CH_MAIN0_MCSPI0_CH1_RX (0x4300U + 0U)
295 #define UDMA_PDMA_CH_MAIN0_MCSPI0_CH2_RX (0x4300U + 0U)
296 #define UDMA_PDMA_CH_MAIN0_MCSPI0_CH3_RX (0x4300U + 0U)
297 #define UDMA_PDMA_CH_MAIN0_MCSPI1_CH0_RX (0x4300U + 1U)
298 #define UDMA_PDMA_CH_MAIN0_MCSPI1_CH1_RX (0x4300U + 1U)
299 #define UDMA_PDMA_CH_MAIN0_MCSPI1_CH2_RX (0x4300U + 1U)
300 #define UDMA_PDMA_CH_MAIN0_MCSPI1_CH3_RX (0x4300U + 1U)
301 #define UDMA_PDMA_CH_MAIN0_MCSPI2_CH0_RX (0x4300U + 2U)
302 #define UDMA_PDMA_CH_MAIN0_MCSPI2_CH1_RX (0x4300U + 2U)
303 #define UDMA_PDMA_CH_MAIN0_MCSPI2_CH2_RX (0x4300U + 2U)
304 #define UDMA_PDMA_CH_MAIN0_MCSPI2_CH3_RX (0x4300U + 2U)
305 #define UDMA_PDMA_CH_MAIN0_MCSPI3_CH0_RX (0x4300U + 3U)
306 #define UDMA_PDMA_CH_MAIN0_MCSPI3_CH1_RX (0x4300U + 3U)
307 #define UDMA_PDMA_CH_MAIN0_MCSPI3_CH2_RX (0x4300U + 3U)
308 #define UDMA_PDMA_CH_MAIN0_MCSPI3_CH3_RX (0x4300U + 3U)
309 /*
310  * PDMA MAIN0 UART RX Channels
311  */
312 #define UDMA_PDMA_CH_MAIN0_UART0_RX (0x4400U + 0U)
313 #define UDMA_PDMA_CH_MAIN0_UART1_RX (0x4400U + 1U)
314 
315 /*
316  * PDMA MAIN0 MCASP RX Channels
317  */
318 #define UDMA_PDMA_CH_MAIN0_MCASP0_RX (0x4500U + 0U)
319 #define UDMA_PDMA_CH_MAIN0_MCASP1_RX (0x4500U + 1U)
320 #define UDMA_PDMA_CH_MAIN0_MCASP2_RX (0x4500U + 2U)
321 
333 /*
334  * PDMA MAIN0 MCSPI TX Channels
335  */
336 #define UDMA_PDMA_CH_MAIN0_MCSPI0_CH0_TX (UDMA_PDMA_CH_MAIN0_MCSPI0_CH0_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
337 #define UDMA_PDMA_CH_MAIN0_MCSPI0_CH1_TX (UDMA_PDMA_CH_MAIN0_MCSPI0_CH1_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
338 #define UDMA_PDMA_CH_MAIN0_MCSPI0_CH2_TX (UDMA_PDMA_CH_MAIN0_MCSPI0_CH2_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
339 #define UDMA_PDMA_CH_MAIN0_MCSPI0_CH3_TX (UDMA_PDMA_CH_MAIN0_MCSPI0_CH3_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
340 #define UDMA_PDMA_CH_MAIN0_MCSPI1_CH0_TX (UDMA_PDMA_CH_MAIN0_MCSPI1_CH0_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
341 #define UDMA_PDMA_CH_MAIN0_MCSPI1_CH1_TX (UDMA_PDMA_CH_MAIN0_MCSPI1_CH1_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
342 #define UDMA_PDMA_CH_MAIN0_MCSPI1_CH2_TX (UDMA_PDMA_CH_MAIN0_MCSPI1_CH2_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
343 #define UDMA_PDMA_CH_MAIN0_MCSPI1_CH3_TX (UDMA_PDMA_CH_MAIN0_MCSPI1_CH3_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
344 #define UDMA_PDMA_CH_MAIN0_MCSPI2_CH0_TX (UDMA_PDMA_CH_MAIN0_MCSPI2_CH0_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
345 #define UDMA_PDMA_CH_MAIN0_MCSPI2_CH1_TX (UDMA_PDMA_CH_MAIN0_MCSPI2_CH1_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
346 #define UDMA_PDMA_CH_MAIN0_MCSPI2_CH2_TX (UDMA_PDMA_CH_MAIN0_MCSPI2_CH2_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
347 #define UDMA_PDMA_CH_MAIN0_MCSPI2_CH3_TX (UDMA_PDMA_CH_MAIN0_MCSPI2_CH3_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
348 #define UDMA_PDMA_CH_MAIN0_MCSPI3_CH0_TX (UDMA_PDMA_CH_MAIN0_MCSPI3_CH0_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
349 #define UDMA_PDMA_CH_MAIN0_MCSPI3_CH1_TX (UDMA_PDMA_CH_MAIN0_MCSPI3_CH1_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
350 #define UDMA_PDMA_CH_MAIN0_MCSPI3_CH2_TX (UDMA_PDMA_CH_MAIN0_MCSPI3_CH2_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
351 #define UDMA_PDMA_CH_MAIN0_MCSPI3_CH3_TX (UDMA_PDMA_CH_MAIN0_MCSPI3_CH3_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
352 /*
353  * PDMA MAIN0 UART TX Channels
354  */
355 #define UDMA_PDMA_CH_MAIN0_UART0_TX (UDMA_PDMA_CH_MAIN0_UART0_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
356 #define UDMA_PDMA_CH_MAIN0_UART1_TX (UDMA_PDMA_CH_MAIN0_UART1_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
357 
358 /*
359  * PDMA MAIN0 MCASP TX Channels
360  */
361 #define UDMA_PDMA_CH_MAIN0_MCASP0_TX (UDMA_PDMA_CH_MAIN0_MCASP0_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
362 #define UDMA_PDMA_CH_MAIN0_MCASP1_TX (UDMA_PDMA_CH_MAIN0_MCASP1_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
363 #define UDMA_PDMA_CH_MAIN0_MCASP2_TX (UDMA_PDMA_CH_MAIN0_MCASP2_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
364 
375 /*
376  * PDMA MAIN1 UART RX Channels
377  */
378 #define UDMA_PDMA_CH_MAIN1_UART2_RX (0x4400U + 2U)
379 #define UDMA_PDMA_CH_MAIN1_UART3_RX (0x4400U + 3U)
380 #define UDMA_PDMA_CH_MAIN1_UART4_RX (0x4400U + 4U)
381 #define UDMA_PDMA_CH_MAIN1_UART5_RX (0x4400U + 5U)
382 #define UDMA_PDMA_CH_MAIN1_UART6_RX (0x4400U + 6U)
383 
384 /*
385  * PDMA MAIN1 ADC RX Channels
386  */
387 #define UDMA_PDMA_CH_MAIN1_ADC0_CH0_RX (0x4503U)
388 #define UDMA_PDMA_CH_MAIN1_ADC0_CH1_RX (0x4504U)
389 
401 /*
402  * PDMA MAIN1 UART TX Channels
403  */
404 #define UDMA_PDMA_CH_MAIN1_UART2_TX (UDMA_PDMA_CH_MAIN1_UART2_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
405 #define UDMA_PDMA_CH_MAIN1_UART3_TX (UDMA_PDMA_CH_MAIN1_UART3_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
406 #define UDMA_PDMA_CH_MAIN1_UART4_TX (UDMA_PDMA_CH_MAIN1_UART4_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
407 #define UDMA_PDMA_CH_MAIN1_UART5_TX (UDMA_PDMA_CH_MAIN1_UART5_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
408 #define UDMA_PDMA_CH_MAIN1_UART6_TX (UDMA_PDMA_CH_MAIN1_UART6_RX | UDMA_PSIL_DEST_THREAD_OFFSET)
409 
414 /* ========================================================================== */
415 /* Structure Declarations */
416 /* ========================================================================== */
417 
418 /* None */
419 
420 /* ========================================================================== */
421 /* Function Declarations */
422 /* ========================================================================== */
423 
429 uint32_t Udma_isCacheCoherent(void);
430 
431 /* ========================================================================== */
432 /* Static Function Definitions */
433 /* ========================================================================== */
434 
435 /* None */
436 
437 #ifdef __cplusplus
438 }
439 #endif
440 
441 #endif /* #ifndef UDMA_SOC_H_ */
442 
Udma_isCacheCoherent
uint32_t Udma_isCacheCoherent(void)
Returns TRUE if the memory is cache coherent.