mmcsd_lld.h

Go to the documentation of this file.

/*
 * Copyright (C) 2024-2025 Texas Instruments Incorporated
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 *   Redistributions of source code must retain the above copyright
 *   notice, this list of conditions and the following disclaimer.
 *
 *   Redistributions in binary form must reproduce the above copyright
 *   notice, this list of conditions and the following disclaimer in the
 *   documentation and/or other materials provided with the
 *   distribution.
 *
 *   Neither the name of Texas Instruments Incorporated nor the names of
 *   its contributors may be used to endorse or promote products derived
 *   from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */
 
#ifndef MMCSD_LLD_H_
#define MMCSD_LLD_H_
 
/* ========================================================================== */
/*                             Include Files                                  */
/* ========================================================================== */
#ifdef __cplusplus
extern "C" {
#endif
 
#include <stdint.h>
#include <stdbool.h>
#include <stdlib.h>
#include <stddef.h>
#include <drivers/edma/v0/edma.h>
#include <drivers/mmcsd/v1/cslr_mmcsd.h>
 
/* ========================================================================== */
/*                           Macros & Typedefs                                */
/* ========================================================================== */
 
typedef EDMA_Handle MMCSD_DmaHandle;
 
typedef struct MMCSD_EdmaChConfig_s *MMCSD_DmaChConfig;
 
#define MMCSD_STS_SUCCESS                       ((int32_t) 0)
 
#define MMCSD_STS_ERR                           ((int32_t)-1)
 
#define MMCSD_STS_ERR_TIMEOUT                   ((int32_t)-2)
 
#define MMCSD_STS_ERR_INVALID_PARAM             ((int32_t)-3)
 
#define MMCSD_STS_ERR_BUSY                      ((int32_t)-4)
 
#define MMCSD_STS_ERR_CARD_NOT_FOUND            ((int32_t)-5)
 
#define MMCSD_STS_ERR_CARD_UNUSEABLE            ((int32_t)-6)
 
#define MMCSD_STS_ERR_CARD_UNLOCK_FAIL          ((int32_t)-7)
 
#define MMCSD_NO_WAIT                           ((uint32_t)0)
 
#define MMCSD_WAIT_FOREVER                      ((uint32_t)-1)
 
#define MMCSD_STATE_RESET                       ((uint8_t) 0U)
 
#define MMCSD_STATE_IDLE                        ((uint8_t) 1U)
 
#define MMCSD_STATE_BUSY                        ((uint8_t) 2U)
 
#define MMCSD_STATE_ERROR                       ((uint8_t) 3U)
 
#define MMCSD_XFER_IDLE_STATE                   ((uint8_t) 0U)
 
#define MMCSD_XFER_CMD_STATE                    ((uint8_t) 1U)
 
#define MMCSD_XFER_WRITE_STATE                  ((uint8_t) 2U)
 
#define MMCSD_XFER_READ_STATE                   ((uint8_t) 3U)
 
#define MMCSD_CARD_TYPE_SD                      ((uint32_t) 0U)
 
#define MMCSD_CARD_TYPE_EMMC                    ((uint32_t) 2U)
 
#define MMCSD_CARD_TYPE_NO_DEVICE               ((uint32_t) 3U)
 
#define MMCSD_BUS_WIDTH_1BIT                    ((uint32_t) 1U)
 
#define MMCSD_BUS_WIDTH_4BIT                    ((uint32_t) 4U)
 
#define MMCSD_BUS_WIDTH_8BIT                    ((uint32_t) 8U)
 
#define MMCSD_ECSD_BUS_WIDTH_INDEX           (183U)
 
#define MMCSD_ECSD_BUS_WIDTH_1BIT            (0U)
 
#define MMCSD_ECSD_BUS_WIDTH_4BIT            (1U)
 
#define MMCSD_ECSD_BUS_WIDTH_8BIT            (2U)
 
#define MMCSD_ECSD_BUS_WIDTH_4BIT_DDR        (5U)
 
#define MMCSD_ECSD_BUS_WIDTH_8BIT_DDR        (6U)
 
#define MMCSD_ECSD_BUS_WIDTH_BUSWIDTH_MASK   (0x0FU)
 
#define MMCSD_ECSD_BUS_WIDTH_BUSWIDTH_SHIFT  (0U)
 
#define MMCSD_ECSD_BUS_WIDTH_ES_ENABLE       (0x80U)
 
#define MMCSD_ECSD_BUS_WIDTH_ES_MASK         (0x80U)
 
#define MMCSD_ECSD_BUS_WIDTH_ES_SHIFT        (7U)
 
#define MMCSD_SD_MODE_DS                        ((uint32_t) 10U)
 
#define MMCSD_SD_MODE_HS                        ((uint32_t) 11U)
 
/* ========================================================================== */
/*                      Function Pointers Declarations                        */
/* ========================================================================== */
 
typedef void (*MMCSD_lld_transferCompleteCallback) (void *args,
                                                    int32_t xferStatus);
 
/* ========================================================================== */
/*                         Structure Declarations                             */
/* ========================================================================== */
 
typedef struct {
 
    uint32_t                ocr;
    uint32_t                rca;
    uint16_t                maxReadBlockLen;
    uint16_t                maxWriteBlockLen;
    char                    manuDate[9];
    uint8_t                 manuID;
    char                    productName[7];
    uint8_t                 specVersion;
    uint32_t                blockCount;
    uint8_t                 transferSpeed;
    uint8_t                 supportedModes;
    uint8_t                 eStrobeSupport;
    uint8_t                 driveStrength;
    uint8_t                 extCsd[512];
    bool                    isHC;
 
} MMCSD_EmmcDeviceData;
 
typedef struct {
 
    uint32_t                ocr;
    uint32_t                rca;
    uint16_t                maxReadBlockLen;
    uint16_t                maxWriteBlockLen;
    char                    manuDate[9];
    uint8_t                 manuID;
    char                    productName[6];
    uint8_t                 specVersion;
    uint32_t                blockCount;
    uint8_t                 transferSpeed;
    uint32_t                isCmd23;
    uint32_t                supportedDataWidths;
    bool                    isHC;
 
} MMCSD_SdDeviceData;
 
typedef struct {
 
    uint32_t                cmd;
    uint32_t                flags;
    uint32_t                arg;
    uint8_t                 *dataBuf;
    uint32_t                blockSize;
    uint32_t                blockCount;
    uint32_t                response[4];
 
} MMCSDLLD_Transaction;
 
typedef struct {
 
    uint32_t                baseAddr;
    uint32_t                inputClkFreq;
    uint32_t                intrNum;
    uint32_t                cardType;
    bool                    autoAssignMaxSpeed;
    uint32_t                uaBusSpeed;
    uint32_t                busWidth;
    bool                    enableDma;
    void                    *deviceData; 
    MMCSD_DmaHandle         mmcsdDmaHandle;
    MMCSD_DmaChConfig       mmcsdDmaChConfig;
    uint8_t                 *dataBuf;
 
} MMCSDLLD_InitObject, *MMCSDLLD_InitHandle;
 
typedef struct {
 
    uint16_t                cmdErrorStat;
    uint16_t                xferErrorStat;
    uint8_t                 *dataBufIdx;
    uint32_t                dataBlockCount;
    uint32_t                dataBlockSize;
    uint32_t                remainingBlockCount;
    MMCSDLLD_Transaction    *currentTxn;
    MMCSDLLD_Transaction    mmcsdTxn;
    uint32_t                setBusSpeed;
    uint32_t                setBusWidth;
    uint8_t                 xferState;
    uint8_t                 state;
    MMCSDLLD_InitHandle     initHandle;
    void                    *args;
    MMCSD_lld_transferCompleteCallback          transferCompleteCallback;
 
} MMCSDLLD_Object, *MMCSDLLD_Handle;
 
/* ========================================================================== */
/*                        API Function Declarations                           */
/* ========================================================================== */
 
int32_t MMCSD_lld_init(MMCSDLLD_Handle handle);
 
int32_t MMCSD_lld_InitDma(MMCSDLLD_Handle handle);
 
int32_t MMCSD_lld_deInit(MMCSDLLD_Handle handle);
 
int32_t MMCSD_lld_deInitDma(MMCSDLLD_Handle handle);
 
int32_t MMCSD_lld_write_SD_Poll(MMCSDLLD_Handle handle, uint8_t *buf,
                                uint32_t startBlk, uint32_t numBlks);
 
int32_t MMCSD_lld_read_SD_Poll(MMCSDLLD_Handle handle, uint8_t *buf,
                               uint32_t startBlk, uint32_t numBlks);
 
int32_t MMCSD_lld_write_SD_Intr(MMCSDLLD_Handle handle, uint8_t *buf,
                                uint32_t startBlk, uint32_t numBlks);
 
int32_t MMCSD_lld_read_SD_Intr(MMCSDLLD_Handle handle, uint8_t *buf,
                               uint32_t startBlk, uint32_t numBlks);
 
int32_t MMCSD_lld_write_SD_Dma(MMCSDLLD_Handle handle, uint8_t *buf,
                                uint32_t startBlk, uint32_t numBlks);
 
int32_t MMCSD_lld_read_SD_Dma(MMCSDLLD_Handle handle, uint8_t *buf,
                                uint32_t startBlk, uint32_t numBlks);
 
 
int32_t MMCSD_lld_write_MMC_Poll(MMCSDLLD_Handle handle, uint8_t *buf,
                                uint32_t startBlk, uint32_t numBlks);
 
int32_t MMCSD_lld_read_MMC_Poll(MMCSDLLD_Handle handle, uint8_t *buf,
                               uint32_t startBlk, uint32_t numBlks);
 
int32_t MMCSD_lld_write_MMC_Intr(MMCSDLLD_Handle handle, uint8_t *buf,
                                uint32_t startBlk, uint32_t numBlks);
 
int32_t MMCSD_lld_read_MMC_Intr(MMCSDLLD_Handle handle, uint8_t *buf,
                               uint32_t startBlk, uint32_t numBlks);
 
int32_t MMCSD_lld_write_MMC_Dma(MMCSDLLD_Handle handle, uint8_t *buf,
    uint32_t startBlk, uint32_t numBlks);
 
int32_t MMCSD_lld_read_MMC_Dma(MMCSDLLD_Handle handle, uint8_t *buf,
    uint32_t startBlk, uint32_t numBlks);
 
uint32_t MMCSD_lld_getBlockSize(MMCSDLLD_Handle handle);
 
 
void MMCSD_lld_completeCurrTransfer(MMCSDLLD_Handle handle,int32_t xferStatus);
 
/* ========================================================================== */
/*                        ISR Function Declarations                           */
/* ========================================================================== */
 
void MMCSD_lld_Isr(void *args);
 
#ifdef __cplusplus
}
#endif
 
#endif /* MMCSD_LLD_H_ */