FDDMA 驱动程序

fddma
    .
    ├── fddma.c
    ├── fddma.h
    ├── fddma_bdl.c
    ├── fddma_bdl.h
    ├── fddma_g.c
    ├── fddma_hw.c
    ├── fddma_hw.h
    ├── fddma_intr.c
    ├── fddma_selftest.c
    └── fddma_sinit.c

typedef struct
{
    u32 id;                     /* DDMA ctrl id */
    uintptr base_addr;          /* DDMA ctrl base address */
    u32 irq_num;                /* DDMA ctrl interrupt id */
    u32 irq_prority;            /* DDMA ctrl interrupt priority */
    u32 caps;
} FDdmaConfig; /* DDMA instance configuration */

typedef struct
{
    u32 slave_id;               /* Perpherial slave id for DDMA */
    FDdmaChanRequst req_mode;   /* DDMA transfer direction */
    uintptr ddr_addr;           /* DDMA channel DDR address, could be source or destination, physical address */
    u32 dev_addr;               /* DDMA channel Perpherial base address, could be source or destination */
    u32 trans_len;              /* DDMA channel transfer length */
#define FDDMA_MIN_TRANSFER_LEN      4  /* min bytes in transfer */
    u32 timeout;                /* timeout = 0 means no use DMA timeout */
    /* BDL模式，目前只针对I2S */
    uintptr  first_desc_addr;   /* BDL描述符列表首地址-物理地址 */
    u32      valid_desc_num;    /* 需要使用的BDL描述符个数，从BDL描述符列表第一个描述符开始计数 */
} FDdmaChanConfig;  /* DDMA channel instance */

typedef struct _FDdmaChanIrq
{
	FDdmaChanIndex      channel_id;                               /* 信息所属DDMA通道的ID */
    FDdma               *ddma_instance_p;                         /* 信息所属DDMA通道所属的DDMA控制器实例 */
    void                *evt_handler_args[FDDMA_NUM_OF_CHAN_EVT]; /* DDMA通道事件回调函数输入参数 */
    FDdmaChanEvtHandler evt_handlers[FDDMA_NUM_OF_CHAN_EVT];      /* DDMA通道事件回调函数 */
} FDdmaChanIrq; /* DDMA通道中断回调信息 */

typedef struct _FDdma
{
    FDdmaConfig config;  /* DDMA控制器配置 */
    u32 is_ready;        /* DDMA控制器初始化是否完成 */
    u32 bind_status;     /* DDMA通道绑定标志位，第几位表示第几通道已经被外设绑定并进行过相关配置 */
    FDdmaChanIrq chan_irq_info[FDDMA_NUM_OF_CHAN]; /* DDMA通道事件回调信息集合 */
} FDdma; /* DDMA instance */

const FDdmaConfig *FDdmaLookupConfig(u32 instance_id);

FError FDdmaCfgInitialize(FDdma *const instance, const FDdmaConfig *controller_config);

void FDdmaDeInitialize(FDdma *const instance_p);

FError FDdmaChanConfigure(FDdma *const instance_p, FDdmaChanIndex channel_id , const FDdmaChanConfig *channel_config);

FError FDdmaChanDeconfigure(FDdma *const instance_p, FDdmaChanIndex channel_id);

void FDdmaChanActive(FDdma *const instance_p, FDdmaChanIndex channel_id);

void FDdmaChanDeactive(FDdma *const instance_p, FDdmaChanIndex channel_id);

void FDdmaStart(FDdma *const instance_p);

void FDdmaStop(FDdma *const instance_p);

void FDdmaIrqHandler(s32 vector, void *args)

void FDdmaRegisterChanEvtHandler(FDdma *const instance_p,
								 FDdmaChanIndex channel_id,
								 FDdmaChanEvt evt,
								 FDdmaChanEvtHandler handler,
								 void *handler_arg);

FError FDdmaBDLSetDesc(FDdmaBdlDesc *const first_desc_addr_p, FDdmaBdlDescConfig const *bdl_desc_config_p);

FError FDdmaChanBdlConfigure(FDdma *const instance, FDdmaChanIndex channel_id, const FDdmaChanConfig *channel_config_p);