163 lines
9.7 KiB
C
163 lines
9.7 KiB
C
/*******************************************************************************
|
|
* DISCLAIMER
|
|
* This software is supplied by Renesas Electronics Corporation and is only
|
|
* intended for use with Renesas products. No other uses are authorized. This
|
|
* software is owned by Renesas Electronics Corporation and is protected under
|
|
* all applicable laws, including copyright laws.
|
|
* THIS SOFTWARE IS PROVIDED "AS IS" AND RENESAS MAKES NO WARRANTIES REGARDING
|
|
* THIS SOFTWARE, WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
|
|
* LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
|
|
* AND NON-INFRINGEMENT. ALL SUCH WARRANTIES ARE EXPRESSLY DISCLAIMED.
|
|
* TO THE MAXIMUM EXTENT PERMITTED NOT PROHIBITED BY LAW, NEITHER RENESAS
|
|
* ELECTRONICS CORPORATION NOR ANY OF ITS AFFILIATED COMPANIES SHALL BE LIABLE
|
|
* FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES FOR
|
|
* ANY REASON RELATED TO THIS SOFTWARE, EVEN IF RENESAS OR ITS AFFILIATES HAVE
|
|
* BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
|
|
* Renesas reserves the right, without notice, to make changes to this software
|
|
* and to discontinue the availability of this software. By using this software,
|
|
* you agree to the additional terms and conditions found by accessing the
|
|
* following link:
|
|
* http://www.renesas.com/disclaimer
|
|
* Copyright 2021-2022 Renesas Electronics Corporation All rights reserved.
|
|
*******************************************************************************/
|
|
|
|
/*******************************************************************************
|
|
* DESCRIPTION : eMMC HAL driverd header
|
|
******************************************************************************/
|
|
|
|
#ifndef EMMC_HAL_H__
|
|
#define EMMC_HAL_H__
|
|
/* ************************ HEADER (INCLUDE) SECTION *********************** */
|
|
#include <types.h>
|
|
|
|
/* ***************** MACROS, CONSTANTS, COMPILATION FLAGS ****************** */
|
|
/* Memory card response types */
|
|
#define HAL_MEMCARD_COMMAND_INDEX_MASK (0x0003fU)
|
|
|
|
/* ********************** STRUCTURES, TYPE DEFINITIONS ********************* */
|
|
|
|
/* memory access operation */
|
|
typedef enum
|
|
{
|
|
HAL_MEMCARD_READ = 0U, /**< read */
|
|
HAL_MEMCARD_WRITE = 1U /**< write */
|
|
} HAL_MEMCARD_OPERATION;
|
|
|
|
/* Type of data width on memorycard bus */
|
|
typedef enum
|
|
{
|
|
HAL_MEMCARD_DATA_WIDTH_1_BIT = 0U,
|
|
HAL_MEMCARD_DATA_WIDTH_4_BIT = 1U,
|
|
HAL_MEMCARD_DATA_WIDTH_8_BIT = 2U
|
|
} HAL_MEMCARD_DATA_WIDTH; /**< data (bus) width types */
|
|
|
|
/* mode of data transfer */
|
|
typedef enum
|
|
{
|
|
HAL_MEMCARD_DMA = 0U,
|
|
HAL_MEMCARD_NOT_DMA = 1U
|
|
} HAL_MEMCARD_DATA_TRANSFER_MODE;
|
|
|
|
|
|
/* Memory card response types. */
|
|
typedef enum hal_memcard_response_type
|
|
{
|
|
HAL_MEMCARD_RESPONSE_NONE = 0x00000U,
|
|
HAL_MEMCARD_RESPONSE_R1 = 0x00100U,
|
|
HAL_MEMCARD_RESPONSE_R1b = 0x00200U,
|
|
HAL_MEMCARD_RESPONSE_R2 = 0x00300U,
|
|
HAL_MEMCARD_RESPONSE_R3 = 0x00400U,
|
|
HAL_MEMCARD_RESPONSE_R4 = 0x00500U,
|
|
HAL_MEMCARD_RESPONSE_R5 = 0x00600U,
|
|
HAL_MEMCARD_RESPONSE_R6 = 0x00700U,
|
|
HAL_MEMCARD_RESPONSE_R7 = 0x00800U,
|
|
HAL_MEMCARD_RESPONSE_TYPE_MASK = 0x00f00U
|
|
} HAL_MEMCARD_RESPONSE_TYPE;
|
|
|
|
|
|
/* Memory card command types. */
|
|
typedef enum hal_memcard_command_type
|
|
{
|
|
HAL_MEMCARD_COMMAND_TYPE_BC = 0x00000U,
|
|
HAL_MEMCARD_COMMAND_TYPE_BCR = 0x01000U,
|
|
HAL_MEMCARD_COMMAND_TYPE_AC = 0x02000U,
|
|
HAL_MEMCARD_COMMAND_TYPE_ADTC_WRITE = 0x03000U,
|
|
HAL_MEMCARD_COMMAND_TYPE_ADTC_READ = 0x04000U,
|
|
HAL_MEMCARD_COMMAND_TYPE_MASK = 0x07000U
|
|
} HAL_MEMCARD_COMMAND_TYPE;
|
|
|
|
/* Type of memory card */
|
|
typedef enum hal_memcard_command_card_type
|
|
{
|
|
HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON = 0x00000U,
|
|
HAL_MEMCARD_COMMAND_CARD_TYPE_MMC = 0x08000U,
|
|
HAL_MEMCARD_COMMAND_CARD_TYPE_SD = 0x10000U,
|
|
HAL_MEMCARD_COMMAND_CARD_TYPE_MASK = 0x18000U
|
|
} HAL_MEMCARD_COMMAND_CARD_TYPE;
|
|
|
|
/* Memory card application command. */
|
|
typedef enum hal_memcard_command_app_norm
|
|
{
|
|
HAL_MEMCARD_COMMAND_NORMAL = 0x00000U,
|
|
HAL_MEMCARD_COMMAND_APP = 0x20000U,
|
|
HAL_MEMCARD_COMMAND_APP_NORM_MASK = 0x20000U
|
|
} HAL_MEMCARD_COMMAND_APP_NORM;
|
|
|
|
|
|
/* Memory card command codes. */
|
|
typedef enum
|
|
{
|
|
/* class 0 and class 1 */
|
|
CMD0_GO_IDLE_STATE = 0 | HAL_MEMCARD_RESPONSE_NONE | HAL_MEMCARD_COMMAND_TYPE_BC | HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | HAL_MEMCARD_COMMAND_NORMAL, /* CMD0 */
|
|
CMD1_SEND_OP_COND = 1 | HAL_MEMCARD_RESPONSE_R3 | HAL_MEMCARD_COMMAND_TYPE_BCR | HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | HAL_MEMCARD_COMMAND_NORMAL, /* CMD1 */
|
|
CMD2_ALL_SEND_CID_MMC = 2 | HAL_MEMCARD_RESPONSE_R2 | HAL_MEMCARD_COMMAND_TYPE_BCR | HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | HAL_MEMCARD_COMMAND_NORMAL, /* CMD2 */
|
|
CMD2_ALL_SEND_CID_SD = 2 | HAL_MEMCARD_RESPONSE_R2 | HAL_MEMCARD_COMMAND_TYPE_BCR | HAL_MEMCARD_COMMAND_CARD_TYPE_SD | HAL_MEMCARD_COMMAND_NORMAL,
|
|
CMD3_SET_RELATIVE_ADDR = 3 | HAL_MEMCARD_RESPONSE_R1 | HAL_MEMCARD_COMMAND_TYPE_AC | HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | HAL_MEMCARD_COMMAND_NORMAL, /* CMD3 */
|
|
CMD3_SEND_RELATIVE_ADDR = 3 | HAL_MEMCARD_RESPONSE_R6 | HAL_MEMCARD_COMMAND_TYPE_AC | HAL_MEMCARD_COMMAND_CARD_TYPE_SD | HAL_MEMCARD_COMMAND_NORMAL,
|
|
CMD4_SET_DSR = 4 | HAL_MEMCARD_RESPONSE_NONE | HAL_MEMCARD_COMMAND_TYPE_BC | HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | HAL_MEMCARD_COMMAND_NORMAL, /* CMD4 */
|
|
CMD5_SLEEP_AWAKE = 5 | HAL_MEMCARD_RESPONSE_R1b | HAL_MEMCARD_COMMAND_TYPE_AC | HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | HAL_MEMCARD_COMMAND_NORMAL, /* CMD5 */
|
|
CMD6_SWITCH = 6 | HAL_MEMCARD_RESPONSE_R1b | HAL_MEMCARD_COMMAND_TYPE_AC | HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | HAL_MEMCARD_COMMAND_NORMAL, /* CMD6 */
|
|
CMD6_SWITCH_FUNC = 6 | HAL_MEMCARD_RESPONSE_R1 | HAL_MEMCARD_COMMAND_TYPE_AC | HAL_MEMCARD_COMMAND_CARD_TYPE_SD | HAL_MEMCARD_COMMAND_NORMAL,
|
|
ACMD6_SET_BUS_WIDTH = 6 | HAL_MEMCARD_RESPONSE_R1 | HAL_MEMCARD_COMMAND_TYPE_AC | HAL_MEMCARD_COMMAND_CARD_TYPE_SD | HAL_MEMCARD_COMMAND_APP,
|
|
CMD7_SELECT_CARD = 7 | HAL_MEMCARD_RESPONSE_R1 | HAL_MEMCARD_COMMAND_TYPE_AC | HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | HAL_MEMCARD_COMMAND_NORMAL, /* CMD7 */
|
|
CMD7_SELECT_CARD_PROG = 7 | HAL_MEMCARD_RESPONSE_R1b | HAL_MEMCARD_COMMAND_TYPE_AC | HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | HAL_MEMCARD_COMMAND_NORMAL, /* CMD7(from Disconnected State to Programming State) */
|
|
CMD7_DESELECT_CARD = 7 | HAL_MEMCARD_RESPONSE_R1 | HAL_MEMCARD_COMMAND_TYPE_AC | HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | HAL_MEMCARD_COMMAND_NORMAL,
|
|
CMD8_SEND_EXT_CSD = 8 | HAL_MEMCARD_RESPONSE_R1 | HAL_MEMCARD_COMMAND_TYPE_ADTC_READ | HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | HAL_MEMCARD_COMMAND_NORMAL, /* CMD8 */
|
|
CMD8_SEND_IF_COND = 8 | HAL_MEMCARD_RESPONSE_R7 | HAL_MEMCARD_COMMAND_TYPE_BCR | HAL_MEMCARD_COMMAND_CARD_TYPE_SD | HAL_MEMCARD_COMMAND_NORMAL,
|
|
CMD9_SEND_CSD = 9 | HAL_MEMCARD_RESPONSE_R2 | HAL_MEMCARD_COMMAND_TYPE_AC | HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | HAL_MEMCARD_COMMAND_NORMAL, /* CMD9 */
|
|
CMD10_SEND_CID = 10 | HAL_MEMCARD_RESPONSE_R2 | HAL_MEMCARD_COMMAND_TYPE_AC | HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | HAL_MEMCARD_COMMAND_NORMAL, /* CMD10 */
|
|
CMD11_READ_DAT_UNTIL_STOP = 11 | HAL_MEMCARD_RESPONSE_R1 | HAL_MEMCARD_COMMAND_TYPE_ADTC_READ | HAL_MEMCARD_COMMAND_CARD_TYPE_SD | HAL_MEMCARD_COMMAND_NORMAL, /* CMD11 */
|
|
CMD12_STOP_TRANSMISSION = 12 | HAL_MEMCARD_RESPONSE_R1 | HAL_MEMCARD_COMMAND_TYPE_AC | HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | HAL_MEMCARD_COMMAND_NORMAL, /* CMD12 */
|
|
CMD12_STOP_TRANSMISSION_WRITE = 12 | HAL_MEMCARD_RESPONSE_R1b | HAL_MEMCARD_COMMAND_TYPE_AC | HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | HAL_MEMCARD_COMMAND_NORMAL, /* CMD12 R1b : write case */
|
|
CMD13_SEND_STATUS = 13 | HAL_MEMCARD_RESPONSE_R1 | HAL_MEMCARD_COMMAND_TYPE_AC | HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | HAL_MEMCARD_COMMAND_NORMAL, /* CMD13 */
|
|
ACMD13_SD_STATUS = 13 | HAL_MEMCARD_RESPONSE_R1 | HAL_MEMCARD_COMMAND_TYPE_ADTC_READ | HAL_MEMCARD_COMMAND_CARD_TYPE_SD | HAL_MEMCARD_COMMAND_APP,
|
|
CMD14_BUSTEST_R = 14 | HAL_MEMCARD_RESPONSE_R1 | HAL_MEMCARD_COMMAND_TYPE_ADTC_READ | HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | HAL_MEMCARD_COMMAND_NORMAL, /* CMD14 */
|
|
CMD15_GO_INACTIVE_STATE = 15 | HAL_MEMCARD_RESPONSE_NONE | HAL_MEMCARD_COMMAND_TYPE_AC | HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | HAL_MEMCARD_COMMAND_NORMAL, /* CMD15 */
|
|
|
|
/* class 2 */
|
|
CMD16_SET_BLOCKLEN = 16 | HAL_MEMCARD_RESPONSE_R1 | HAL_MEMCARD_COMMAND_TYPE_AC | HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | HAL_MEMCARD_COMMAND_NORMAL, /* CMD16 */
|
|
CMD17_READ_SINGLE_BLOCK = 17 | HAL_MEMCARD_RESPONSE_R1 | HAL_MEMCARD_COMMAND_TYPE_ADTC_READ | HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | HAL_MEMCARD_COMMAND_NORMAL, /* CMD17 */
|
|
CMD18_READ_MULTIPLE_BLOCK = 18 | HAL_MEMCARD_RESPONSE_R1 | HAL_MEMCARD_COMMAND_TYPE_ADTC_READ | HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | HAL_MEMCARD_COMMAND_NORMAL, /* CMD18 */
|
|
CMD19_BUS_TEST_W = 19 | HAL_MEMCARD_RESPONSE_R1 | HAL_MEMCARD_COMMAND_TYPE_ADTC_WRITE | HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | HAL_MEMCARD_COMMAND_NORMAL, /* CMD19 */
|
|
/* class 3 */
|
|
CMD20_WRITE_DAT_UNTIL_STOP = 20 | HAL_MEMCARD_RESPONSE_R1 | HAL_MEMCARD_COMMAND_TYPE_ADTC_WRITE | HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | HAL_MEMCARD_COMMAND_NORMAL, /* CMD20 */
|
|
CMD21 = 21, /* CMD21 */
|
|
CMD22 = 22, /* CMD22 */
|
|
ACMD22_SEND_NUM_WR_BLOCKS = 22 | HAL_MEMCARD_RESPONSE_R1 | HAL_MEMCARD_COMMAND_TYPE_AC | HAL_MEMCARD_COMMAND_CARD_TYPE_SD | HAL_MEMCARD_COMMAND_APP,
|
|
|
|
/* class 4 */
|
|
CMD23_SET_BLOCK_COUNT = 23 | HAL_MEMCARD_RESPONSE_R1 | HAL_MEMCARD_COMMAND_TYPE_AC | HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | HAL_MEMCARD_COMMAND_NORMAL /* CMD23 */
|
|
|
|
} HAL_MEMCARD_COMMAND;
|
|
|
|
/* ********************** DECLARATION OF EXTERNAL DATA ********************* */
|
|
|
|
/* ************************** FUNCTION PROTOTYPES ************************** */
|
|
|
|
/* ********************************* CODE ********************************** */
|
|
|
|
#endif /* EMMC_HAL_H__ */
|
|
|
|
/* ******************************** END ************************************ */
|
|
|