FSDIF 驱动程序

fsdif
    ├── fsdif.c
    ├── fsdif.h
    ├── fsdif_cmd.c
    ├── fsdif_dma.c
    ├── fsdif_g.c
    ├── fsdif_hw.h
    ├── fsdif_intr.c
    ├── fsdif_pio.c
    ├── fsdif_selftest.c
    ├── fsdif_sinit.c

typedef struct _FSdif
{
    FSdifConfig         config;      /* Current active configs */
    u32                 is_ready;    /* Device is initialized and ready */
    FSdifIDmaDescList   desc_list;   /* DMA descriptor list, valid in DMA trans mode */
    FSdifEvtHandler     evt_handlers[FSDIF_NUM_OF_EVT]; /* call-backs for interrupt event */
    void                *evt_args[FSDIF_NUM_OF_EVT]; /* arguments for event call-backs */
    FSdifRelaxHandler   relax_handler;
    u32                 prev_cmd; /* record previous command code */
    FSdifCmdData        *cur_cmd;
    FSdifTiming         *curr_timing;
} FSdif; /* SDIF intance */

typedef struct
{
    u32            instance_id; /* Device instance id */
    uintptr        base_addr;   /* Device base address */
    u32            irq_num;     /* Interrupt num */
    FSdifTransMode trans_mode;  /* Trans mode, PIO/DMA */
    boolean        non_removable; /* No removeable media, e.g eMMC */
    FSdifGetTuning get_tuning; /* Get time-tuning related parameters and method */
} FSdifConfig; /* SDIF intance configuration */

typedef struct
{
    u32 cmdidx; /* command index */
#define FSDIF_SWITCH_VOLTAGE             11U
    u32 cmdarg; /* command argument */
    u32 response[4]; /* command response buffer */
    u32 flag; /* command flags */
#define FSDIF_CMD_FLAG_NEED_INIT         BIT(1) /* need initialization */
#define FSDIF_CMD_FLAG_EXP_RESP          BIT(2) /* need reply */
#define FSDIF_CMD_FLAG_EXP_LONG_RESP     BIT(3) /* need 136 bits long reply */
#define FSDIF_CMD_FLAG_NEED_RESP_CRC     BIT(4) /* need CRC */
#define FSDIF_CMD_FLAG_EXP_DATA          BIT(5) /* need trans data */
#define FSDIF_CMD_FLAG_WRITE_DATA        BIT(6) /* need trans data to write card */
#define FSDIF_CMD_FLAG_READ_DATA         BIT(7) /* need trans data to read card */
#define FSDIF_CMD_FLAG_NEED_AUTO_STOP    BIT(8) /* need auto stop after command */
#define FSDIF_CMD_FLAG_ADTC              BIT(9) /* need ADTC */
#define FSDIF_CMD_FLAG_SWITCH_VOLTAGE    BIT(10) /* need switch voltage */
#define FSDIF_CMD_FLAG_ABORT             BIT(11) 
    FSdifData *data_p; /* SDIF trans data */
    volatile boolean success; /* TRUE: comand and data transfer success */
} FSdifCmdData; /* SDIF trans command and data */

typedef struct
{
    u32 attribute; /* ds0 */
#define FSDIF_IDMAC_DES0_DIC    BIT(1)/* 内部描述表不触发TI/RI中断 */
#define FSDIF_IDMAC_DES0_LD     BIT(2)/* 数据的最后一个描述符 */
#define FSDIF_IDMAC_DES0_FD     BIT(3)/* 数据的第一个描述符 */
#define FSDIF_IDMAC_DES0_CH     BIT(4)/* 链接下一个描述符地址 */
#define FSDIF_IDMAC_DES0_ER     BIT(5)/* 链表已经到达最后一个链表 */
#define FSDIF_IDMAC_DES0_CES    BIT(30)/* RINTSTS寄存器错误汇总 */
#define FSDIF_IDMAC_DES0_OWN    BIT(31)/* 描述符关联DMA，完成传输后该位置置0 */
    u32 non1; /* ds1 --> unused */
    u32 len;  /* ds2 buffer size*/
    u32 non2; /* ds3 --> unused */
    u32 addr_lo; /* ds4 Lower 32-bits of Buffer Address Pointer 1 --> buffer 1 */
    u32 addr_hi; /* ds5 Upper 32-bits of Buffer Address Pointer 1 */
/* Each descriptor can transfer up to 4KB of data in chained mode */
#define FSDIF_IDMAC_MAX_BUF_SIZE        0x1000U
    u32 desc_lo; /* ds6 Lower 32-bits of Next Descriptor Address --> buffer 2 */
    u32 desc_hi; /* ds7 Upper 32-bits of Next Descriptor Address */
} __attribute__((packed)) __attribute((aligned(4))) FSdifIDmaDesc;  /* SDIF DMA descriptr */

const FSdifConfig *FSdifLookupConfig(u32 instance_id);

FError FSdifCfgInitialize(FSdif *const instance_p, const FSdifConfig *cofig_p);

void FSdifDeInitialize(FSdif *const instance_p);

FError FSdifSetIDMAList(FSdif *const instance_p, volatile FSdifIDmaDesc *desc, uintptr desc_dma,  u32 desc_num);

FError FSdifSetClkFreq(FSdif *const instance_p, u32 input_clk_hz);

FError FSdifDMATransfer(FSdif *const instance_p, FSdifCmdData *const cmd_data_p);

FError FSdifPollWaitDMAEnd(FSdif *const instance_p, FSdifCmdData *const cmd_data_p);

u32 FSdifGetInterruptMask(FSdif *const instance_p, FSdifIntrType intr_type);

void FSdifSetInterruptMask(FSdif *const instance_p, FSdifIntrType type, u32 set_mask, boolean enable);

void FSdioInterruptHandler(s32 vector, void *param)

void FSdifRegisterEvtHandler(FSdif *const instance_p, FSdifEvtType evt, FSdifEvtHandler handler, void *handler_arg);

FError FSdifPIOTransfer(FSdif *const instance_p, FSdifCmdData *const cmd_data_p);

FError FSdifPollWaitPIOEnd(FSdif *const instance_p, FSdifCmdData *const cmd_data_p);

FError FSdioGetCmdResponse(FSdif *const instance_p, FSdioCmdData *const cmd_data_p)

FError FSdifRestart(FSdif *const instance_p);