/****************************************************************************** * Copyright (C) 2021, Xiaohua Semiconductor Co., Ltd. All rights reserved. * * This software component is licensed by XHSC under BSD 3-Clause license * (the "License"); You may not use this file except in compliance with the * License. You may obtain a copy of the License at: * opensource.org/licenses/BSD-3-Clause * ******************************************************************************/ /****************************************************************************** * @file dma.h * * @brief Header file for DMAC functions * * @author MADS Team * ******************************************************************************/ #ifndef __DMAC_H__ #define __DMAC_H__ /******************************************************************************* * Include files ******************************************************************************/ #include "ddl.h" /* C binding of definitions if building with C++ compiler */ #ifdef __cplusplus extern "C" { #endif /** ******************************************************************************* ** \defgroup DmacGroup Direct Memory Access Control(DMAC) ** ******************************************************************************/ //@{ /******************************************************************************* * Global type definitions ('typedef') ******************************************************************************/ /** ******************************************************************************* ** \brief DMA 通道 ** ******************************************************************************/ typedef enum en_dma_channel { DmaCh0 = 0x00, ///< DMA 通道0 DmaCh1 = 0x04, ///< DMA 通道1 } en_dma_channel_t; /** ******************************************************************************* ** \brief DMA 优先级 ** ******************************************************************************/ typedef enum en_dma_priority { DmaMskPriorityFix = 0x00000000, ///< DMA 各通道优先级固定 (CH0>CH1) DmaMskPriorityLoop = 0x10000000, ///< DMA 各通道优先级采用轮询方式 } en_dma_priority_t; /** ******************************************************************************* ** \brief DMA 传输数据宽度 ** ******************************************************************************/ typedef enum en_dma_transfer_width { DmaMsk8Bit = 0x00000000, ///< 8 bit 字节传输 DmaMsk16Bit = 0x04000000, ///< 16 bit 半字传输 DmaMsk32Bit = 0x08000000 ///< 32 bit 字传输 } en_dma_transfer_width_t; /** ******************************************************************************* ** \brief DMA 传输模式：块(Block)传输或者突发(Burst)传输 ** ******************************************************************************/ typedef enum en_dma_transfer_mode { DmaMskBlock = 0x00000000, ///< 块(Block)传输 DmaMskBurst = 0x10000000, ///< 突发(Burst)传输 } en_dma_transfer_mode_t; /** ******************************************************************************* ** \brief DMA传输当前状态 ** ******************************************************************************/ typedef enum en_dma_stat { DmaDefault = 0U, ///< 初始值 DmaAddOverflow = 1U, ///< 传输错误引起中止（地址溢出） DmaHALT = 2U, ///< 传输停止请求引起中止（外设停止请求引起的停止或者EB/DE位引起的禁止传输） DmaAccSCRErr = 3U, ///< 传输错误引起中止（传输源地址访问错误） DmaAccDestErr = 4U, ///< 传输错误引起中止（传输目的地址访问错误） DmaTransferComplete = 5U, ///< 成功传输完成 DmaTransferPause = 7U, ///< 传输暂停 } en_dma_stat_t; /** ******************************************************************************* ** \brief DMA源地址控制模式：自增或固定 ** ******************************************************************************/ typedef enum en_src_address_mode { DmaMskSrcAddrInc = 0x00000000, ///< 地址自增 DmaMskSrcAddrFix = 0x02000000, ///< 地址固定 } en_src_address_mode_t; /** ******************************************************************************* ** \brief DMA目的地址控制模式：自增或固定 ** ******************************************************************************/ typedef enum en_dst_address_mode { DmaMskDstAddrInc = 0x00000000, ///< 地址自增 DmaMskDstAddrFix = 0x01000000, ///< 地址固定 } en_dst_address_mode_t; /** ******************************************************************************* ** \brief DMA CONFA:BC[3:0]和CONFA:TC[15:0]的重载功能 ** ******************************************************************************/ typedef enum en_bc_tc_reload_mode { DmaMskBcTcReloadDisable = 0x00000000, ///< 禁止重载 DmaMskBcTcReloadEnable = 0x00800000, ///< 使能重载 } en_bc_tc_reload_mode_t; /** ******************************************************************************* ** \brief DMA源地址重载功能：使能或禁止 ** ******************************************************************************/ typedef enum en_src_address_reload_mode { DmaMskSrcAddrReloadDisable = 0x00000000, ///< 禁止DMA源地址重载 DmaMskSrcAddrReloadEnable = 0x00400000, ///< 使能DMA源地址重载 } en_src_address_reload_mode_t; /** ******************************************************************************* ** \brief DMA目的地址重载功能：使能或禁止 ** ******************************************************************************/ typedef enum en_dst_address_reload_mode { DmaMskDstAddrReloadDisable = 0x00000000, ///< 禁止DMA目的地址重载 DmaMskDstAddrReloadEnable = 0x00200000, ///< 使能DMA目的地址重载 } en_dst_address_reload_mode_t; /** ******************************************************************************* ** \brief DMA 连续传输设置 ** ******************************************************************************/ typedef enum en_dma_msk { DmaMskOneTransfer = 0x00000000, ///< 传输一次，DMAC传输完成时清除CONFA:ENS位 DmaMskContinuousTransfer = 0x00000001, ///< 连续传输，DMAC传输完成时不清除CONFA:ENS位 } en_dma_msk_t; /** ******************************************************************************* ** \brief DMA 触发源选择 ** ******************************************************************************/ typedef enum stc_dma_trig_sel { DmaSWTrig = 0U, ///< Select DMA software trig DmaSPI0RXTrig = 64U, ///< Select DMA hardware trig 0 DmaSPI0TXTrig = 65U, ///< Select DMA hardware trig 1 DmaSPI1RXTrig = 66U, ///< Select DMA hardware trig 2 DmaSPI1TXTrig = 67U, ///< Select DMA hardware trig 3 DmaADCJQRTrig = 68U, ///< Select DMA hardware trig 4 DmaADCSQRTrig = 69U, ///< Select DMA hardware trig 5 DmaLCDTxTrig = 70U, ///< Select DMA hardware trig 6 DmaUart0RxTrig = 72U, ///< Select DMA hardware trig 8 DmaUart0TxTrig = 73U, ///< Select DMA hardware trig 9 DmaUart1RxTrig = 74U, ///< Select DMA hardware trig 10 DmaUart1TxTrig = 75U, ///< Select DMA hardware trig 11 DmaLpUart0RxTrig = 76U, ///< Select DMA hardware trig 12 DmaLpUart0TxTrig = 77U, ///< Select DMA hardware trig 13 DmaLpUart1RxTrig = 78U, ///< Select DMA hardware trig 14 DmaLpUart1TxTrig = 79U, ///< Select DMA hardware trig 15 DmaDAC0Trig = 80U, ///< Select DMA hardware trig 16 DmaDAC1Trig = 81U, ///< Select DMA hardware trig 17 DmaTIM0ATrig = 82U, ///< Select DMA hardware trig 18 DmaTIM0BTrig = 83U, ///< Select DMA hardware trig 19 DmaTIM1ATrig = 84U, ///< Select DMA hardware trig 20 DmaTIM1BTrig = 85U, ///< Select DMA hardware trig 21 DmaTIM2ATrig = 86U, ///< Select DMA hardware trig 22 DmaTIM2BTrig = 87U, ///< Select DMA hardware trig 23 DmaTIM3ATrig = 88U, ///< Select DMA hardware trig 24 DmaTIM3BTrig = 89U, ///< Select DMA hardware trig 25 DmaTIM4ATrig = 90U, ///< Select DMA hardware trig 26 DmaTIM4BTrig = 91U, ///< Select DMA hardware trig 27 DmaTIM5ATrig = 92U, ///< Select DMA hardware trig 28 DmaTIM5BTrig = 93U, ///< Select DMA hardware trig 29 DmaTIM6ATrig = 94U, ///< Select DMA hardware trig 30 DmaTIM6BTrig = 95U, ///< Select DMA hardware trig 31 DmaUart2RxTrig = 96U, ///< Select DMA hardware trig 32 DmaUart2TxTrig = 97U, ///< Select DMA hardware trig 33 DmaUart3RxTrig = 98U, ///< Select DMA hardware trig 34 DmaUart3TxTrig = 99U, ///< Select DMA hardware trig 35 }en_dma_trig_sel_t; /** ******************************************************************************* ** \brief DMA通道初始化配置结构体 ** ******************************************************************************/ typedef struct stc_dma_cfg { en_dma_transfer_mode_t enMode; uint16_t u16BlockSize; ///< 块传输个数 uint16_t u16TransferCnt; ///< 传输块次数 en_dma_transfer_width_t enTransferWidth; ///< 传输数据字节宽度 具体参考枚举定义:en_dma_transfer_width_t en_src_address_mode_t enSrcAddrMode; ///< DMA源地址控制模式：自增或固定 en_dst_address_mode_t enDstAddrMode; ///< DMA目的地址控制模式：自增或固定 en_src_address_reload_mode_t enSrcAddrReloadCtl; ///< 源地址重载 具体参考枚举定义:en_src_address_reload_mode_t en_dst_address_reload_mode_t enDestAddrReloadCtl;///< 目的地址重载 具体参考枚举定义:en_dst_address_reload_mode_t en_bc_tc_reload_mode_t enSrcBcTcReloadCtl; ///< Bc/Tc值重载功能 具体参考枚举定义:en_bc_tc_reload_mode_t uint32_t u32SrcAddress; ///< 源地址> uint32_t u32DstAddress; ///< 目的地址> en_dma_msk_t enTransferMode; ///DMA 连续传输设置 具体参考枚举定义:en_dma_msk_t en_dma_priority_t enPriority; ///DMA 优先级设定 具体参考枚举定义:en_dma_priority_t en_dma_trig_sel_t enRequestNum; ///