643e34efde
and correct the comment: https://www.sdcard.org/downloads/pls/ https://www.jedec.org/standards-documents/technology-focus-areas/flash-memory-ssds-ufs-emmc/e-mmc Signed-off-by: Xiang Xiao <xiaoxiang@xiaomi.com>
411 lines
12 KiB
C
411 lines
12 KiB
C
/****************************************************************************
|
|
* drivers/mmcsd/mmcsd_csd.h
|
|
*
|
|
* Licensed to the Apache Software Foundation (ASF) under one or more
|
|
* contributor license agreements. See the NOTICE file distributed with
|
|
* this work for additional information regarding copyright ownership. The
|
|
* ASF licenses this file to you under the Apache License, Version 2.0 (the
|
|
* "License"); you may not use this file except in compliance with the
|
|
* License. You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
* License for the specific language governing permissions and limitations
|
|
* under the License.
|
|
*
|
|
****************************************************************************/
|
|
|
|
#ifndef __DRIVERS_MMCSD_MMCSD_CSD_H
|
|
#define __DRIVERS_MMCSD_MMCSD_CSD_H
|
|
|
|
/****************************************************************************
|
|
* Included Files
|
|
****************************************************************************/
|
|
|
|
#include <nuttx/config.h>
|
|
#include <stdint.h>
|
|
|
|
/****************************************************************************
|
|
* Pre-processor Definitions
|
|
****************************************************************************/
|
|
|
|
/* CSD **********************************************************************/
|
|
|
|
/* The CSD is a 16 byte, / 128-bit packed structure. The following macros
|
|
* can be used to extract each packed field from the CSD. Two types of
|
|
* macros are supported, selected by CONFIG_MMCSD_BE16: (1) byte data (with
|
|
* MS byte first), or (2) 16-bit big-endian data (with MS hword first).
|
|
*/
|
|
|
|
#ifdef CONFIG_MMCSD_BE16
|
|
|
|
/* CSD_STRUCTURE 126-127 */
|
|
|
|
#define MMCSD_CSD_CSDSTRUCT(csd) (csd[0] >> 14)
|
|
|
|
/* SPEC_VERS 122-125 = (word 0, bits 13:10) (MMC) Spec version */
|
|
|
|
#define MMC_CSD_SPECVERS(csd) ((csd[0] >> 10) & 0x0f)
|
|
|
|
/* Reserved 120-125 */
|
|
|
|
/* TAAC 112-119 = Data read access-time-1
|
|
* TIME_VALUE 3-6 = Time mantissa
|
|
* TIME_UNIT 0-2 = Time exponent
|
|
*/
|
|
|
|
#define MMCSD_CSD_TAAC_TIMEVALUE(csd) ((csd[0] >> 3) & 0x0f)
|
|
#define MMCSD_CSD_TAAC_TIMEUNIT(csd) (csd[0] & 7)
|
|
|
|
/* NSAC 111:104 = Data read access-time-2 in CLK cycle(NSAC*100) */
|
|
|
|
#define MMCSD_CSD_NSAC(csd) (csd[1] >> 8)
|
|
|
|
/* TRAN_SPEED 96-103 = Max. data transfer rate
|
|
* TIME_VALUE 3-6 = Rate exponent
|
|
* TRANSFER_RATE_UNIT 0-2 = Rate mantissa
|
|
*/
|
|
|
|
#define MMCSD_CSD_TRANSPEED_TIMEVALUE(csd) ((csd[1] >> 3) & 0x0f)
|
|
#define MMCSD_CSD_TRANSPEED_TRANSFERRATEUNIT(csd) (csd[1] & 7)
|
|
|
|
/* CCC 84-95 = Card command classes */
|
|
|
|
#define MMCSD_CSD_CCC(csd) ((csd[2] >> 4) & 0x0fff)
|
|
|
|
/* READ_BL_LEN 80-83 = Max. read data block length */
|
|
|
|
#define MMCSD_CSD_READBLLEN(csd) (csd[2] & 0x0f)
|
|
|
|
/* READ_BL_PARTIAL 79-79 = Partial blocks for read allowed */
|
|
|
|
#define MMCSD_CSD_READBLPARTIAL(csd) (csd[3] >> 15)
|
|
|
|
/* WRITE_BLK_MISALIGN 78-78 = Write block misalignment */
|
|
|
|
#define MMCSD_CSD_WRITEBLKMISALIN(csd) ((csd[3] >> 14) & 1)
|
|
|
|
/* READ_BLK_MISALIGN 77:77 = Read block misalignment */
|
|
|
|
#define MMCSD_CSD_READBLKMISALIN(csd) ((csd[3] >> 13) & 1)
|
|
|
|
/* DSR_IMP 76-76 = DSR implemented */
|
|
|
|
#define MMCSD_CSD_DSRIMP(csd) ((csd[3] >> 12) & 1)
|
|
|
|
/* C_SIZE 62-73 Device size */
|
|
|
|
#define MMCSD_CSD_CSIZE(csd) (((csd[3] & 0x03ff) << 2) | ((csd[4] >> 14) & 3))
|
|
|
|
/* VDD_R_CURR_MIN 59-61 = Max. read current at Vcc min */
|
|
|
|
#define MMCSD_CSD_VDDRCURRMIN(csd) ((csd[4] >> 11) & 7)
|
|
|
|
/* VDD_R_CURR_MAX 56-58 = Max. read current at Vcc max */
|
|
|
|
#define MMCSD_CSD_VDDRCURRMAX(csd) ((csd[4] >> 8) & 7)
|
|
|
|
/* VDD_W_CURR_MIN 53-55 = Max. write current at Vcc min */
|
|
|
|
#define MMCSD_CSD_VDDWCURRMIN(csd) ((csd[4] >> 5) & 7)
|
|
|
|
/* VDD_W_CURR_MAX 50-52 = Max. write current at Vcc max */
|
|
|
|
#define MMCSD_CSD_VDDWCURRMAX(csd) ((csd[4] >> 2) & 7)
|
|
|
|
/* C_SIZE_MULT 47-49 Device size multiplier */
|
|
|
|
#define MMCSD_CSD_CSIZEMULT(csd) (((csd[4] & 3) << 1) | (csd[5] >> 15))
|
|
|
|
/* ER_BLK_EN 46-46 =Erase single block enable (SD) */
|
|
|
|
#define SD_CSD_SDERBLKEN(csd) ((csd[5] >> 14) & 1)
|
|
|
|
/* SECTOR_SIZE 39-45 = Erase sector size (SD) */
|
|
|
|
#define SD_CSD_SECTORSIZE(csd) ((csd[5] >> 7) & 0x7f)
|
|
|
|
/* SECTOR_SIZE 42-46 = Erase sector size (MMC) */
|
|
|
|
#define MMC_CSD_SECTORSIZE(csd) ((csd[5] >> 10) & 0x1f)
|
|
|
|
/* ER_GRP_SIZE 37-41 = Erase group size (MMC) */
|
|
|
|
#define MMC_CSD_ERGRPSIZE(csd) ((csd[5] >> 5) & 0x1f)
|
|
|
|
/* WP_GRP_SIZE 32-38 = Write protect group size (SD) */
|
|
|
|
#define SD_CSD_WPGRPSIZE(csd) (csd[5] & 0x7f)
|
|
|
|
/* WP_GRP_SIZE 32-36 = Write protect group size (MMC) */
|
|
|
|
#define MMC_CSD_WPGRPSIZE(csd) (csd[5] & 0x1f)
|
|
|
|
/* WP_GRP_EN 31-31 = Write protect group enable */
|
|
|
|
#define MMCSD_WPGRPEN(csd) (csd[6] >> 15)
|
|
|
|
/* DFLT_ECC 29-30 = Manufacturer default ECC (MMC) */
|
|
|
|
#define MMC_CSD_DFLTECC(csd) ((csd[6] >> 13) & 3)
|
|
|
|
/* R2W_FACTOR 26-28 = Write speed factor */
|
|
|
|
#define MMCSD_CSD_R2WFACTOR(csd) ((csd[6] >> 10) & 7)
|
|
|
|
/* WRITE_BL_LEN 22-25 = Max. write data block length */
|
|
|
|
#define MMCSD_CSD_WRITEBLLEN(csd) ((csd[6] >> 6) & 0x0f)
|
|
|
|
/* WRITE_BL_PARTIAL 21-21 = Partial blocks for write allowed */
|
|
|
|
#define MMCSD_CSD_WRITEBLPARTIAL(csd) ((csd[6] >> 5) & 1)
|
|
|
|
/* Reserved 16-20 */
|
|
|
|
/* FILE_FORMAT_GROUP 15-15 = File format group */
|
|
|
|
#define MMCSD_CSD_FILEFORMATGRP(csd) (csd[7] >> 15)
|
|
|
|
/* COPY 14-14 = Copy flag (OTP) */
|
|
|
|
#define MMCSD_CSD_COPY(csd) ((csd[7] >> 14) & 1)
|
|
|
|
/* PERM_WRITE_PROTECT 13-13 = Permanent write protection */
|
|
|
|
#define MMCSD_CSD_PERMWRITEPROTECT(csd) ((csd[7] >> 13) & 1)
|
|
|
|
/* TMP_WRITE_PROTECT 12-12 = Temporary write protection */
|
|
|
|
#define MMCSD_CSD_TMPWRITEPROTECT(csd) ((csd[7] >> 12) & 1)
|
|
|
|
/* FILE_FORMAT 10-11 = File format */
|
|
|
|
#define MMCSD_CSD_FILEFORMAT(csd) ((csd[7] >> 10) & 3)
|
|
|
|
/* ECC 8-9 = ECC (MMC) */
|
|
|
|
#define MMC_CSD_ECC(csd) ((csd[7] >> 8) & 3)
|
|
|
|
/* CRC 1-7 = CRC */
|
|
|
|
#define MMCSD_CSD_CRC(csd) ((csd[7] >> 1) & 0x7f)
|
|
|
|
/* Reserved 0-0 */
|
|
|
|
#else /* CONFIG_MMCSD_BE16 */
|
|
|
|
/* CSD_STRUCTURE 126-127 */
|
|
|
|
#define MMCSD_CSD_CSDSTRUCT(csd) (csd[0] >> 6)
|
|
|
|
/* SPEC_VERS 122-125 = (word 0, bits 13:10) (MMC) Spec version */
|
|
|
|
#define MMC_CSD_SPECVERS(csd) ((csd[0] >> 2) & 0x0f)
|
|
|
|
/* Reserved 120-121 */
|
|
|
|
/* TAAC 112-119 = Data read access-time-1
|
|
* TIME_VALUE 3-6 = Time mantissa
|
|
* TIME_UNIT 0-2 = Time exponent
|
|
*/
|
|
|
|
#define MMCSD_CSD_TAAC_TIMEVALUE(csd) ((csd[1] >> 3) & 0x0f)
|
|
#define MMCSD_CSD_TAAC_TIMEUNIT(csd) (csd[1] & 7)
|
|
|
|
#define SD20_CSD_TAC_TIMEVALUE(csd) (1)
|
|
#define SD20_CSD_TAC_TIMEUNIT(csd) (6)
|
|
|
|
/* NSAC 111:104 = Data read access-time-2 in CLK cycle(NSAC*100) */
|
|
|
|
#define MMCSD_CSD_NSAC(csd) (csd[2])
|
|
#define SD20_CSD_NSAC(csd) (0)
|
|
|
|
/* TRAN_SPEED 96-103 = Max. data transfer rate
|
|
* TIME_VALUE 3-6 = Rate exponent
|
|
* TRANSFER_RATE_UNIT 0-2 = Rate mantissa
|
|
*/
|
|
|
|
#define MMCSD_CSD_TRANSPEED_TIMEVALUE(csd) ((csd[3] >> 3) & 0x0f)
|
|
#define MMCSD_CSD_TRANSPEED_TRANSFERRATEUNIT(csd) (csd[3] & 7)
|
|
|
|
#define SD20_CSD_TRANSPEED_TIMEVALUE(csd) MMCSD_CSD_TRANSPEED_TIMEVALUE(csd)
|
|
#define SD20_CSD_TRANSPEED_TRANSFERRATEUNIT(csd) MMCSD_CSD_TRANSPEED_TRANSFERRATEUNIT(csd)
|
|
|
|
/* CCC 84-95 = Card command classes */
|
|
|
|
#define MMCSD_CSD_CCC(csd) (((uint16_t)csd[4] << 4) | ((uint16_t)csd[5] >> 4))
|
|
#define SD20_CSD_CCC(csd) MMCSD_CSD_CCC(csd)
|
|
|
|
/* READ_BL_LEN 80-83 = Max. read data block length */
|
|
|
|
#define MMCSD_CSD_READBLLEN(csd) (csd[5] & 0x0f)
|
|
#define SD20_CSD_READBLLEN(csd) (9)
|
|
|
|
/* READ_BL_PARTIAL 79-79 = Partial blocks for read allowed */
|
|
|
|
#define MMCSD_CSD_READBLPARTIAL(csd) (csd[6] >> 7)
|
|
#define SD20_CSD_READBLPARTIAL(csd) (0)
|
|
|
|
/* WRITE_BLK_MISALIGN 78-78 = Write block misalignment */
|
|
|
|
#define MMCSD_CSD_WRITEBLKMISALIGN(csd) ((csd[6] >> 6) & 1)
|
|
#define SD20_CSD_WRITEBLKMISALIGN(csd) (0)
|
|
|
|
/* READ_BLK_MISALIGN 77:77 = Read block misalignment */
|
|
|
|
#define MMCSD_CSD_READBLKMISALIGN(csd) ((csd[6] >> 5) & 1)
|
|
#define SD20_CSD_READBLKMISALIGN(csd) (0)
|
|
|
|
/* DSR_IMP 76-76 = DSR implemented */
|
|
|
|
#define MMCSD_CSD_DSRIMP(csd) ((csd[6] >> 4) & 1)
|
|
#define SD20_CSD_DSRIMP(csd) MMCSD_CSD_DSRIMP(csd)
|
|
|
|
/* C_SIZE 62-73 Device size */
|
|
|
|
#define MMCSD_CSD_CSIZE(csd) (((csd[6] & 3) << 10) | (csd[7] << 2) | (csd[8] >> 6))
|
|
#define SD20_CSD_CSIZE(csd) ((((uint32_t)csd[7] & 0x3f) << 16) | (csd[8] << 8) | csd[9])
|
|
|
|
/* VDD_R_CURR_MIN 59-61 = Max. read current at Vcc min */
|
|
|
|
#define MMCSD_CSD_VDDRCURRMIN(csd) ((csd[8] >> 3) & 7)
|
|
#define SD20_CSD_VDDRCURRMIN(csd) (7)
|
|
|
|
/* VDD_R_CURR_MAX 56-58 = Max. read current at Vcc max */
|
|
|
|
#define MMCSD_CSD_VDDRCURRMAX(csd) (csd[8] & 7)
|
|
#define SD20_CSD_VDDRCURRMAX(csd) (6)
|
|
|
|
/* VDD_W_CURR_MIN 53-55 = Max. write current at Vcc min */
|
|
|
|
#define MMCSD_CSD_VDDWCURRMIN(csd) ((csd[9] >> 5) & 7)
|
|
#define SD20_CSD_VDDWCURRMIN(csd) (7)
|
|
|
|
/* VDD_W_CURR_MAX 50-52 = Max. write current at Vcc max */
|
|
|
|
#define MMCSD_CSD_VDDWCURRMAX(csd) ((csd[9] >> 2) & 7)
|
|
#define SD20_CSD_VDDWCURRMAX(csd) (6)
|
|
|
|
/* C_SIZE_MULT 47-49 Device size multiplier */
|
|
|
|
#define MMCSD_CSD_CSIZEMULT(csd) (((csd[9] & 3) << 1) | (csd[10] >> 7))
|
|
#define SD20_CSD_CSIZEMULT(csd) (10-2)
|
|
|
|
/* ER_BLK_EN 46-46 = Erase single block enable (SD) */
|
|
|
|
#define SD_CSD_SDERBLKEN(csd) ((csd[10] >> 6) & 1)
|
|
#define SD20_CSD_SDERBLKEN(csd) (1)
|
|
|
|
/* SECTOR_SIZE 39-45 = Erase sector size (SD) */
|
|
|
|
#define SD_CSD_SECTORSIZE(csd) (((csd[10] & 0x3f) << 1) | (csd[11] >> 7))
|
|
#define SD20_CSD_SECTORSIZE(csd) (0x7f)
|
|
|
|
/* SECTOR_SIZE 42-46 = Erase sector size (MMC) */
|
|
|
|
#define MMC_CSD_SECTORSIZE(csd) ((csd[10] >> 2) & 0x1f)
|
|
|
|
/* ER_GRP_SIZE 37-41 = Erase group size (MMC) */
|
|
|
|
#define MMC_CSD_ERGRPSIZE(csd) (((csd[10] & 3) << 3) | (csd[11] > 5))
|
|
|
|
/* WP_GRP_SIZE 32-38 = Write protect group size (SD) */
|
|
|
|
#define SD_CSD_WPGRPSIZE(csd) (csd[11] & 0x7f)
|
|
#define SD20_CSD_WPGRPSIZE(csd) (0)
|
|
|
|
/* WP_GRP_SIZE 32-36 = Write protect group size (MMC) */
|
|
|
|
#define MMC_CSD_WPGRPSIZE(csd) (csd[11] & 0x1f)
|
|
|
|
/* WP_GRP_EN 31-31 = Write protect group enable */
|
|
|
|
#define MMCSD_WPGRPEN(csd) (csd[12] >> 7)
|
|
#define SD20_WPGRPEN(csd) (0)
|
|
|
|
/* DFLT_ECC 29-30 = Manufacturer default ECC (MMC) */
|
|
|
|
#define MMC_CSD_DFLTECC(csd) ((csd[12] >> 5) & 3)
|
|
|
|
/* R2W_FACTOR 26-28 = Write speed factor */
|
|
|
|
#define MMCSD_CSD_R2WFACTOR(csd) ((csd[12] >> 2) & 7)
|
|
#define SD20_CSD_R2WFACTOR(csd) (2)
|
|
|
|
/* WRITE_BL_LEN 22-25 = Max. write data block length */
|
|
|
|
#define MMCSD_CSD_WRITEBLLEN(csd) (((csd[12] & 3) << 2) | (csd[13] >> 6))
|
|
#define SD20_CSD_WRITEBLLEN(csd) (9)
|
|
|
|
/* WRITE_BL_PARTIAL 21-21 = Partial blocks for write allowed */
|
|
|
|
#define MMCSD_CSD_WRITEBLPARTIAL(csd) ((csd[13] >> 5) & 1)
|
|
#define SD20_CSD_WRITEBLPARTIAL(csd) (0)
|
|
|
|
/* Reserved 16-20 */
|
|
|
|
/* FILE_FORMAT_GROUP 15-15 = File format group */
|
|
|
|
#define MMCSD_CSD_FILEFORMATGRP(csd) (csd[14] >> 7)
|
|
#define SD20_CSD_FILEFORMATGRP(csd) (0)
|
|
|
|
/* COPY 14-14 = Copy flag (OTP) */
|
|
|
|
#define MMCSD_CSD_COPY(csd) ((csd[14] >> 6) & 1)
|
|
#define SD20_CSD_COPY(csd) MMCSD_CSD_COPY(csd)
|
|
|
|
/* PERM_WRITE_PROTECT 13-13 = Permanent write protection */
|
|
|
|
#define MMCSD_CSD_PERMWRITEPROTECT(csd) ((csd[14] >> 5) & 1)
|
|
#define SD20_CSD_PERMWRITEPROTECT(csd) MMCSD_CSD_PERMWRITEPROTECT(csd)
|
|
|
|
/* TMP_WRITE_PROTECT 12-12 = Temporary write protection */
|
|
|
|
#define MMCSD_CSD_TMPWRITEPROTECT(csd) ((csd[14] >> 4) & 1)
|
|
#define SD20_CSD_TMPWRITEPROTECT(csd) MMCSD_CSD_TMPWRITEPROTECT(csd)
|
|
|
|
/* FILE_FORMAT 10-11 = File format */
|
|
|
|
#define MMCSD_CSD_FILEFORMAT(csd) ((csd[14] >> 2) & 3)
|
|
#define SD20_CSD_FILEFORMAT(csd) (0)
|
|
|
|
/* ECC 8-9 = ECC (MMC) */
|
|
|
|
#define MMC_CSD_ECC(csd) (csd[14] & 3)
|
|
|
|
/* CRC 1-7 = CRC */
|
|
|
|
#define MMCSD_CSD_CRC(csd) (csd[15] >> 1)
|
|
#define SD20_CSD_CRC(csd) MMCSD_CSD_CRC(csd)
|
|
|
|
/* Reserved 0-0 */
|
|
|
|
#endif /* CONFIG_MMCSD_BE16 */
|
|
|
|
/****************************************************************************
|
|
* Public Types
|
|
****************************************************************************/
|
|
|
|
/****************************************************************************
|
|
* Public Functions Definitions
|
|
****************************************************************************/
|
|
|
|
#undef EXTERN
|
|
#if defined(__cplusplus)
|
|
#define EXTERN extern "C"
|
|
extern "C"
|
|
{
|
|
#else
|
|
#define EXTERN extern
|
|
#endif
|
|
|
|
#undef EXTERN
|
|
#if defined(__cplusplus)
|
|
}
|
|
#endif
|
|
#endif /* __DRIVERS_MMCSD_MMCSD_CSD_H */
|