Difference between revisions of "Unit MMC"
From Ultibo.org
| Line 6,567: | Line 6,567: | ||
|- | |- | ||
| <code>TSDHCIHostSetTiming = function(SDHCI:PSDHCIHost; Timing:LongWord):LongWord;</code> | | <code>TSDHCIHostSetTiming = function(SDHCI:PSDHCIHost; Timing:LongWord):LongWord;</code> | ||
| + | | style="width: 40%;"| | ||
| + | |- | ||
| + | |} | ||
| + | |||
| + | '''SDHCI host bus width'' | ||
| + | |||
| + | {| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;" | ||
| + | |- | ||
| + | | <code>TSDHCIHostSetBusWidth = function(SDHCI:PSDHCIHost; BusWidth:LongWord):LongWord;</code> | ||
| style="width: 40%;"| | | style="width: 40%;"| | ||
|- | |- | ||
| Line 6,754: | Line 6,763: | ||
| <code>HostSetTiming:TSDHCIHostSetTiming;</code> | | <code>HostSetTiming:TSDHCIHostSetTiming;</code> | ||
| A Host specific HostSetTiming method implementing a standard SDHCI host interface (Or nil if the default method is suitable) | | A Host specific HostSetTiming method implementing a standard SDHCI host interface (Or nil if the default method is suitable) | ||
| + | |- | ||
| + | | <code>HostSetBusWidth:TSDHCIHostSetBusWidth;</code> | ||
| + | | A Host specific HostSetBusWidth method implementing a standard SDHCI host interface (Or nil if the default method is suitable) | ||
|- | |- | ||
| <code>HostSetClockDivider:TSDHCIHostSetClockDivider;</code> | | <code>HostSetClockDivider:TSDHCIHostSetClockDivider;</code> | ||
| Line 8,102: | Line 8,114: | ||
<pre style="border: 0; padding-bottom:0px;">function SDHCIHostSetTiming(SDHCI:PSDHCIHost; Timing:LongWord):LongWord;</pre> | <pre style="border: 0; padding-bottom:0px;">function SDHCIHostSetTiming(SDHCI:PSDHCIHost; Timing:LongWord):LongWord;</pre> | ||
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Default set timing function for SDHCI host controllers</div> | <div style="font-size: 14px; padding-left: 12px;">'''Description:''' Default set timing function for SDHCI host controllers</div> | ||
| + | <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;"> | ||
| + | {| class="wikitable" style="font-size: 14px; background: white;" | ||
| + | |- | ||
| + | ! Note | ||
| + | | Not intended to be called directly by applications, may be used by SDHCI drivers. | ||
| + | |- | ||
| + | |} | ||
| + | </div></div> | ||
| + | <br /> | ||
| + | <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;"> | ||
| + | <pre style="border: 0; padding-bottom:0px;">function SDHCIHostSetBusWidth(SDHCI:PSDHCIHost; BusWidth:LongWord):LongWord;</pre> | ||
| + | <div style="font-size: 14px; padding-left: 12px;">'''Description:''' Default set bus width function for SDHCI host controllers</div> | ||
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;"> | <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;"> | ||
{| class="wikitable" style="font-size: 14px; background: white;" | {| class="wikitable" style="font-size: 14px; background: white;" | ||
Revision as of 01:54, 28 July 2021
Return to Unit Reference
Description
Ultibo MMC/SD interface unit
This unit implements the standards based part of the SD/MMC specification including the standard SDHCI interfaces.
For each platform a SDHCI module needs to be provided that implements the platform specific parts of the SDHCI interface.
A fully standards compliant SDHCI host controller needs only a procedure to register it with the SD/MMC core and it can operate using the standard functions provided in this unit, any deviations from the standard will require custom functions to be provided to override the standard functionality.
This is similar in model to USB and other interfaces in Ultibo, where the generic interface unit requires a platform specific module to register with it in order to communicate with platform specific devices.
The SD/MMC interfaces are normally 2 tier (ie Host and Device) whereas the USB interface is 3 tier (Host, Device and Driver) however SDIO support adds a driver model to encapsulate support for devices which can provide a variety of functionality including WiFi, Bluetooth, Ethernet and others.
Constants
MMC specific constants
MMC_* MMC_NAME_PREFIX = 'MMC';
|
Name prefix for MMC Devices |
MMC_DEVICE_DESCRIPTION = 'MMC/SD Device';
|
Description of MMC/SD device |
MMC_STORAGE_DESCRIPTION = 'MMC/SD Storage Device';
|
Description of MMC/SD storage device |
MMC_STATUS_TIMER_INTERVAL = 1000;
|
|
MMC_DEFAULT_BLOCKSIZE = 512;
|
|
MMC_DEFAULT_BLOCKSHIFT = 9;
|
|
MMC device type
MMC_TYPE_* MMC_TYPE_NONE = 0;
|
|
MMC_TYPE_MMC = 1;
|
An MMC specification card |
MMC_TYPE_SD = 2;
|
An SD specification card |
MMC_TYPE_SDIO = 3;
|
An SDIO specification card |
MMC_TYPE_SD_COMBO = 4;
|
An SD/SDIO combination card |
MMC_TYPE_MAX = 4;
|
|
MMC device state
MMC_STATE_* MMC_STATE_EJECTED = 0;
|
|
MMC_STATE_INSERTED = 1;
|
|
MMC_STATE_MAX = 1;
|
|
MMC device flag
MMC_FLAG_* MMC_FLAG_NONE = $00000000;
|
|
MMC_FLAG_CARD_PRESENT = $00000001;
|
Card is present |
MMC_FLAG_WRITE_PROTECT = $00000002;
|
Card is write protected |
MMC_FLAG_HIGH_CAPACITY = $00000004;
|
High Capacity (SDHC) |
MMC_FLAG_EXT_CAPACITY = $00000008;
|
Extended Capacity (SDXC) |
MMC_FLAG_UHS_I = $00000010;
|
Ultra High Speed (UHS-I) |
MMC_FLAG_UHS_II = $00000020;
|
Ultra High Speed (UHS-II) |
MMC_FLAG_BLOCK_ADDRESSED = $00000040;
|
Block Addressed (SDHC/SDXC and others) |
MMC_FLAG_AUTO_BLOCK_COUNT = $00000080;
|
Controller supports Auto CMD23 (Set Block Count) |
MMC_FLAG_AUTO_COMMAND_STOP = $00000100;
|
Controller supports Auto CMD12 (Stop Transmission) |
MMC_FLAG_DDR_MODE = $00000200;
|
Device supports DDR mode |
MMC_FLAG_NON_REMOVABLE = $00000400;
|
Device is non removable, only check for presence once. |
MMC/SD status code
MMC_STATUS_* MMC_STATUS_SUCCESS = 0;
|
Function successful |
MMC_STATUS_TIMEOUT = 1;
|
The operation timed out |
MMC_STATUS_NO_MEDIA = 2;
|
No media present in device |
MMC_STATUS_HARDWARE_ERROR = 3;
|
Hardware error of some form occurred |
MMC_STATUS_INVALID_DATA = 4;
|
Invalid data was received |
MMC_STATUS_INVALID_PARAMETER = 5;
|
An invalid parameter was passed to the function |
MMC_STATUS_INVALID_SEQUENCE = 6;
|
Invalid sequence encountered |
MMC_STATUS_OUT_OF_MEMORY = 7;
|
No memory available for operation |
MMC_STATUS_UNSUPPORTED_REQUEST = 8;
|
The request is unsupported |
MMC_STATUS_NOT_PROCESSED = 9;
|
The MMC transfer has not yet been processed |
MMC/SD version
SD_VERSION_*, MMC_VERSION_* SD_VERSION_SD = $00020000;
|
|
SD_VERSION_1_0 = (SD_VERSION_SD or $0100);
|
|
SD_VERSION_1_10 = (SD_VERSION_SD or $010a);
|
|
SD_VERSION_2 = (SD_VERSION_SD or $0200);
|
|
SD_VERSION_3 = (SD_VERSION_SD or $0300);
|
|
SD_VERSION_4 = (SD_VERSION_SD or $0400);
|
|
MMC_VERSION_MMC = $00010000;
|
|
MMC_VERSION_1_2 = (MMC_VERSION_MMC or $0102);
|
|
MMC_VERSION_1_4 = (MMC_VERSION_MMC or $0104);
|
|
MMC_VERSION_2_2 = (MMC_VERSION_MMC or $0202);
|
|
MMC_VERSION_3 = (MMC_VERSION_MMC or $0300);
|
|
MMC_VERSION_4 = (MMC_VERSION_MMC or $0400);
|
|
MMC_VERSION_4_1 = (MMC_VERSION_MMC or $0401);
|
|
MMC_VERSION_4_2 = (MMC_VERSION_MMC or $0402);
|
|
MMC_VERSION_4_3 = (MMC_VERSION_MMC or $0403);
|
|
MMC_VERSION_4_41 = (MMC_VERSION_MMC or $0429);
|
|
MMC_VERSION_4_5 = (MMC_VERSION_MMC or $0405);
|
|
MMC_VERSION_5_0 = (MMC_VERSION_MMC or $0500);
|
|
MMC_VERSION_UNKNOWN = (MMC_VERSION_MMC);
|
|
MMC/SD capabilities
MMC_CAP_* | From: /include/linux/mmc/host.h | |
MMC_CAP_4_BIT_DATA = (1 shl 0);
|
Can the host do 4 bit transfers |
MMC_CAP_MMC_HIGHSPEED = (1 shl 1);
|
Can do MMC high-speed timing |
MMC_CAP_SD_HIGHSPEED = (1 shl 2);
|
Can do SD high-speed timing |
MMC_CAP_SDIO_IRQ = (1 shl 3);
|
Can signal pending SDIO IRQs |
MMC_CAP_SPI = (1 shl 4);
|
Talks only SPI protocols |
MMC_CAP_NEEDS_POLL = (1 shl 5);
|
Needs polling for card-detection |
MMC_CAP_8_BIT_DATA = (1 shl 6);
|
Can the host do 8 bit transfers |
MMC_CAP_AGGRESSIVE_PM = (1 shl 7);
|
Suspend = (e)MMC/SD at idle |
MMC_CAP_NONREMOVABLE = (1 shl 8);
|
Nonremovable eg. eMMC |
MMC_CAP_WAIT_WHILE_BUSY = (1 shl 9);
|
Waits while card is busy |
MMC_CAP_3_3V_DDR = (1 shl 11);
|
Host supports eMMC DDR 3.3V |
MMC_CAP_1_8V_DDR = (1 shl 12);
|
Host supports eMMC DDR 1.8V |
MMC_CAP_1_2V_DDR = (1 shl 13);
|
Host supports eMMC DDR 1.2V |
MMC_CAP_DDR = (MMC_CAP_3_3V_DDR or MMC_CAP_1_8V_DDR or MMC_CAP_1_2V_DDR);
|
|
MMC_CAP_POWER_OFF_CARD = (1 shl 14);
|
Can power off after boot |
MMC_CAP_BUS_WIDTH_TEST = (1 shl 15);
|
CMD14/CMD19 bus width ok |
MMC_CAP_UHS_SDR12 = (1 shl 16);
|
Host supports UHS SDR12 mode |
MMC_CAP_UHS_SDR25 = (1 shl 17);
|
Host supports UHS SDR25 mode |
MMC_CAP_UHS_SDR50 = (1 shl 18);
|
Host supports UHS SDR50 mode |
MMC_CAP_UHS_SDR104 = (1 shl 19);
|
Host supports UHS SDR104 mode |
MMC_CAP_UHS_DDR50 = (1 shl 20);
|
Host supports UHS DDR50 mode |
MMC_CAP_UHS = (MMC_CAP_UHS_SDR12 or MMC_CAP_UHS_SDR25 or MMC_CAP_UHS_SDR50 or MMC_CAP_UHS_SDR104 or MMC_CAP_UHS_DDR50);
|
|
MMC_CAP_SYNC_RUNTIME_PM = (1 shl 21);
|
Synced runtime PM suspends |
MMC_CAP_NEED_RSP_BUSY = (1 shl 22);
|
Commands with R1B can't use R1 |
MMC_CAP_DRIVER_TYPE_A = (1 shl 23);
|
Host supports Driver Type A |
MMC_CAP_DRIVER_TYPE_C = (1 shl 24);
|
Host supports Driver Type C |
MMC_CAP_DRIVER_TYPE_D = (1 shl 25);
|
Host supports Driver Type D |
MMC_CAP_DONE_COMPLETE = (1 shl 27);
|
RW reqs can be completed within mmc_request_done() |
MMC_CAP_CD_WAKE = (1 shl 28);
|
Enable card detect wake |
MMC_CAP_CMD_DURING_TFR = (1 shl 29);
|
Commands during data transfer |
MMC_CAP_CMD23 = (1 shl 30);
|
CMD23 supported |
MMC_CAP_HW_RESET = (1 shl 31);
|
Reset the eMMC card via RST_n |
MMC/SD capabilities2
MMC_CAP2_* | From: /include/linux/mmc/host.h | |
MMC_CAP2_BOOTPART_NOACC = (1 shl 0);
|
Boot partition no access |
MMC_CAP2_FULL_PWR_CYCLE = (1 shl 2);
|
Can do full power cycle |
MMC_CAP2_FULL_PWR_CYCLE_IN_SUSPEND = (1 shl 3);
|
Can do full power cycle in suspend |
MMC_CAP2_HS200_1_8V_SDR = (1 shl 5);
|
Can support HS200 1.8V |
MMC_CAP2_HS200_1_2V_SDR = (1 shl 6);
|
Can support HS200 1.2V |
MMC_CAP2_HS200 = (MMC_CAP2_HS200_1_8V_SDR or MMC_CAP2_HS200_1_2V_SDR);
|
|
MMC_CAP2_CD_ACTIVE_HIGH = (1 shl 10);
|
Card-detect signal active high |
MMC_CAP2_RO_ACTIVE_HIGH = (1 shl 11);
|
Write-protect signal active high |
MMC_CAP2_NO_PRESCAN_POWERUP = (1 shl 14);
|
Don't power up before scan |
MMC_CAP2_HS400_1_8V = (1 shl 15);
|
Can support HS400 1.8V |
MMC_CAP2_HS400_1_2V = (1 shl 16);
|
Can support HS400 1.2V |
MMC_CAP2_HS400 = (MMC_CAP2_HS400_1_8V or MMC_CAP2_HS400_1_2V);
|
|
MMC_CAP2_HSX00_1_8V = (MMC_CAP2_HS200_1_8V_SDR or MMC_CAP2_HS400_1_8V);
|
|
MMC_CAP2_HSX00_1_2V = (MMC_CAP2_HS200_1_2V_SDR or MMC_CAP2_HS400_1_2V);
|
|
MMC_CAP2_SDIO_IRQ_NOTHREAD = (1 shl 17);
|
|
MMC_CAP2_NO_WRITE_PROTECT = (1 shl 18);
|
No physical write protect pin, assume that card is always read-write |
MMC_CAP2_NO_SDIO = (1 shl 19);
|
Do not send SDIO commands during initialization |
MMC_CAP2_HS400_ES = (1 shl 20);
|
Host supports enhanced strobe |
MMC_CAP2_NO_SD = (1 shl 21);
|
Do not send SD commands during initialization |
MMC_CAP2_NO_MMC = (1 shl 22);
|
Do not send = (e)MMC commands during initialization |
MMC_CAP2_CQE = (1 shl 23);
|
Has eMMC command queue engine |
MMC_CAP2_CQE_DCMD = (1 shl 24);
|
CQE can issue a direct command |
MMC_CAP2_AVOID_3_3V = (1 shl 25);
|
Host must negotiate down from 3.3V |
MMC_CAP2_MERGE_CAPABLE = (1 shl 26);
|
Host can merge a segment over the segment size |
MMC/SD direction
MMC_DATA_* MMC_DATA_READ = 1;
|
|
MMC_DATA_WRITE = 2;
|
MMC/SD bus width
MMC_BUS_WIDTH_* MMC_BUS_WIDTH_1 = 0;
|
|
MMC_BUS_WIDTH_4 = 2;
|
|
MMC_BUS_WIDTH_8 = 3;
|
MMC bus speed (Hz)
MMC_BUS_SPEED_* MMC_BUS_SPEED_DEFAULT = 0;
|
|
MMC_BUS_SPEED_HS26 = 26000000;
|
|
MMC_BUS_SPEED_HS52 = 52000000;
|
|
MMC_BUS_SPEED_DDR = 52000000;
|
|
MMC_BUS_SPEED_HS200 = 200000000;
|
MMC/SD timing
MMC_TIMING_* | From: /include/linux/mmc/host.h | |
MMC_TIMING_LEGACY = 0;
|
|
MMC_TIMING_MMC_HS = 1;
|
|
MMC_TIMING_SD_HS = 2;
|
|
MMC_TIMING_UHS_SDR12 = 3;
|
|
MMC_TIMING_UHS_SDR25 = 4;
|
|
MMC_TIMING_UHS_SDR50 = 5;
|
|
MMC_TIMING_UHS_SDR104 = 6;
|
|
MMC_TIMING_UHS_DDR50 = 7;
|
|
MMC_TIMING_MMC_DDR52 = 8;
|
|
MMC_TIMING_MMC_HS200 = 9;
|
|
MMC_TIMING_MMC_HS400 = 10;
|
|
MMC/SD signal voltage
MMC_SIGNAL_VOLTAGE_* | From: /include/linux/mmc/host.h | |
MMC_SIGNAL_VOLTAGE_330 = 0;
|
|
MMC_SIGNAL_VOLTAGE_180 = 1;
|
|
MMC_SIGNAL_VOLTAGE_120 = 2;
|
|
MMC/SD set driver type
MMC_SET_DRIVER_TYPE_* | From: /include/linux/mmc/host.h | |
MMC_SET_DRIVER_TYPE_B = 0;
|
|
MMC_SET_DRIVER_TYPE_A = 1;
|
|
MMC_SET_DRIVER_TYPE_C = 2;
|
|
MMC_SET_DRIVER_TYPE_D = 3;
|
|
MMC command
MMC_CMD_* | From: /include/linux/mmc/mmc.h | |
| Class 1 | |
MMC_CMD_GO_IDLE_STATE = 0;
|
|
MMC_CMD_SEND_OP_COND = 1;
|
|
MMC_CMD_ALL_SEND_CID = 2;
|
|
MMC_CMD_SET_RELATIVE_ADDR = 3;
|
|
MMC_CMD_SET_DSR = 4;
|
|
MMC_CMD_SLEEP_AWAKE = 5;
|
|
MMC_CMD_SWITCH = 6;
|
|
MMC_CMD_SELECT_CARD = 7;
|
|
MMC_CMD_SEND_EXT_CSD = 8;
|
|
MMC_CMD_SEND_CSD = 9;
|
|
MMC_CMD_SEND_CID = 10;
|
|
MMC_CMD_READ_DAT_UNTIL_STOP = 11;
|
|
MMC_CMD_STOP_TRANSMISSION = 12;
|
|
MMC_CMD_SEND_STATUS = 13;
|
|
MMC_CMD_BUS_TEST_R = 14;
|
|
MMC_CMD_GO_INACTIVE_STATE = 15;
|
|
MMC_CMD_BUS_TEST_W = 19;
|
|
MMC_CMD_SPI_READ_OCR = 58;
|
|
MMC_CMD_SPI_CRC_ON_OFF = 59;
|
|
| Class 2 | |
MMC_CMD_SET_BLOCKLEN = 16;
|
|
MMC_CMD_READ_SINGLE_BLOCK = 17;
|
|
MMC_CMD_READ_MULTIPLE_BLOCK = 18;
|
|
MMC_CMD_SEND_TUNING_BLOCK = 19;
|
|
MMC_CMD_SEND_TUNING_BLOCK_HS200 = 21;
|
|
| Class 3 | |
MMC_CMD_WRITE_DAT_UNTIL_STOP = 20;
|
|
| Class 4 | |
MMC_CMD_SET_BLOCK_COUNT = 23;
|
|
MMC_CMD_WRITE_SINGLE_BLOCK = 24;
|
|
MMC_CMD_WRITE_MULTIPLE_BLOCK = 25;
|
|
MMC_CMD_PROGRAM_CID = 26;
|
|
MMC_CMD_PROGRAM_CSD = 27;
|
|
| Class 6 | |
MMC_CMD_SET_WRITE_PROT = 28;
|
|
MMC_CMD_CLR_WRITE_PROT = 29;
|
|
MMC_CMD_SEND_WRITE_PROT = 30;
|
|
| Class 5 | |
MMC_CMD_ERASE_GROUP_START = 35;
|
|
MMC_CMD_ERASE_GROUP_END = 36;
|
|
MMC_CMD_ERASE = 38;
|
|
| Class 9 | |
MMC_CMD_FAST_IO = 39;
|
|
MMC_CMD_GO_IRQ_STATE = 40;
|
|
| Class 7 | |
MMC_CMD_LOCK_UNLOCK = 42;
|
|
| Class 8 | |
MMC_CMD_APP_CMD = 55;
|
|
MMC_CMD_GEN_CMD = 56;
|
|
MMC_CMD_RES_MAN = 62;
|
|
MMC_CMD62_ARG1 = $EFAC62EC;
|
|
MMC_CMD62_ARG2 = $00CBAEA7;
|
|
MMC response type
MMC_RSP_* | From: /include/linux/mmc/mmc.h | |
| Native | |
MMC_RSP_PRESENT = (1 shl 0);
|
|
MMC_RSP_136 = (1 shl 1);
|
136 bit response |
MMC_RSP_CRC = (1 shl 2);
|
Expect valid crc |
MMC_RSP_BUSY = (1 shl 3);
|
Card may send busy |
MMC_RSP_OPCODE = (1 shl 4);
|
Response contains opcode |
| These are the native response types, and correspond to valid bit patterns of the above flags. One additional valid pattern is all zeros, which means we don't expect a response. | |
MMC_RSP_NONE = (0);
|
|
MMC_RSP_R1 = (MMC_RSP_PRESENT or MMC_RSP_CRC or MMC_RSP_OPCODE);
|
|
MMC_RSP_R1B = (MMC_RSP_PRESENT or MMC_RSP_CRC or MMC_RSP_OPCODE or MMC_RSP_BUSY);
|
|
MMC_RSP_R2 = (MMC_RSP_PRESENT or MMC_RSP_136 or MMC_RSP_CRC);
|
|
MMC_RSP_R3 = (MMC_RSP_PRESENT);
|
|
MMC_RSP_R4 = (MMC_RSP_PRESENT);
|
|
MMC_RSP_R5 = (MMC_RSP_PRESENT or MMC_RSP_CRC or MMC_RSP_OPCODE);
|
|
MMC_RSP_R6 = (MMC_RSP_PRESENT or MMC_RSP_CRC or MMC_RSP_OPCODE);
|
|
MMC_RSP_R7 = (MMC_RSP_PRESENT or MMC_RSP_CRC or MMC_RSP_OPCODE);
|
|
MMC non-SPI command
MMC_CMD_* MMC_CMD_MASK = (3 shl 5);
|
|
MMC_CMD_AC = (0 shl 5);
|
Addressed Command, no Data |
MMC_CMD_ADTC = (1 shl 5);
|
Addressed Data Transfer Command |
MMC_CMD_BC = (2 shl 5);
|
Broadcast Command, no Response |
MMC_CMD_BCR = (3 shl 5);
|
Broadcast Command with Response |
MMC SPI response type
MMC_RSP_SPI_* MMC_RSP_SPI_S1 = (1 shl 7);
|
One status byte |
MMC_RSP_SPI_S2 = (1 shl 8);
|
Second byte |
MMC_RSP_SPI_B4 = (1 shl 9);
|
Four data bytes |
MMC_RSP_SPI_BUSY = (1 shl 10);
|
Card may send busy |
| These are the SPI response types for MMC, SD, and SDIO cards. Commands return R1, with maybe more info. Zero is an error type, callers must always provide the appropriate MMC_RSP_SPI_Rx flags. | |
MMC_RSP_SPI_R1 = (MMC_RSP_SPI_S1);
|
|
MMC_RSP_SPI_R1B = (MMC_RSP_SPI_S1 or MMC_RSP_SPI_BUSY);
|
|
MMC_RSP_SPI_R2 = (MMC_RSP_SPI_S1 or MMC_RSP_SPI_S2);
|
|
MMC_RSP_SPI_R3 = (MMC_RSP_SPI_S1 or MMC_RSP_SPI_B4);
|
|
MMC_RSP_SPI_R4 = (MMC_RSP_SPI_S1 or MMC_RSP_SPI_B4);
|
|
MMC_RSP_SPI_R5 = (MMC_RSP_SPI_S1 or MMC_RSP_SPI_S2);
|
|
MMC_RSP_SPI_R7 = (MMC_RSP_SPI_S1 or MMC_RSP_SPI_B4);
|
|
MMC response value
MMC_RSP_R1_*, MMC_RSP_R2_* | R1 - MMC status in R1, for native mode (SPI bits are different) | |
MMC_RSP_R1_OUT_OF_RANGE = (1 shl 31);
|
|
MMC_RSP_R1_ADDRESS_ERROR = (1 shl 30);
|
|
MMC_RSP_R1_BLOCK_LEN_ERROR = (1 shl 29);
|
|
MMC_RSP_R1_ERASE_SEQ_ERROR = (1 shl 28);
|
|
MMC_RSP_R1_ERASE_PARAM = (1 shl 27);
|
|
MMC_RSP_R1_WP_VIOLATION = (1 shl 26);
|
|
MMC_RSP_R1_CARD_IS_LOCKED = (1 shl 25);
|
|
MMC_RSP_R1_LOCK_UNLOCK_FAILED = (1 shl 24);
|
|
MMC_RSP_R1_COM_CRC_ERROR = (1 shl 23);
|
|
MMC_RSP_R1_ILLEGAL_COMMAND = (1 shl 22);
|
|
MMC_RSP_R1_CARD_ECC_FAILED = (1 shl 21);
|
|
MMC_RSP_R1_CC_ERROR = (1 shl 20);
|
|
MMC_RSP_R1_ERROR = (1 shl 19);
|
|
MMC_RSP_R1_UNDERRUN = (1 shl 18);
|
|
MMC_RSP_R1_OVERRUN = (1 shl 17);
|
|
MMC_RSP_R1_CID_CSD_OVERWRITE = (1 shl 16);
|
|
MMC_RSP_R1_WP_ERASE_SKIP = (1 shl 15);
|
|
MMC_RSP_R1_CARD_ECC_DISABLED = (1 shl 14);
|
|
MMC_RSP_R1_ERASE_RESET = (1 shl 13);
|
|
MMC_RSP_R1_READY_FOR_DATA = (1 shl 8);
|
|
MMC_RSP_R1_SWITCH_ERROR = (1 shl 7);
|
|
MMC_RSP_R1_EXCEPTION_EVENT = (1 shl 6);
|
|
MMC_RSP_R1_APP_CMD = (1 shl 5);
|
|
MMC_RSP_R1_AKE_SEQ_ERROR = (1 shl 3);
|
|
| R1 SPI - MMC/SD in SPI mode reports R1 status always, and R2 for SEND_STATUS. R1 is the low order byte, R2 is the next highest byte, when present. | |
MMC_RSP_R1_SPI_IDLE = (1 shl 0);
|
|
MMC_RSP_R1_SPI_ERASE_RESET = (1 shl 1);
|
|
MMC_RSP_R1_SPI_ILLEGAL_COMMAND = (1 shl 2);
|
|
MMC_RSP_R1_SPI_COM_CRC = (1 shl 3);
|
|
MMC_RSP_R1_SPI_ERASE_SEQ = (1 shl 4);
|
|
MMC_RSP_R1_SPI_ADDRESS = (1 shl 5);
|
|
MMC_RSP_R1_SPI_PARAMETER = (1 shl 6);
|
|
| R1 bit 7 is always zero | |
| R2 SPI - See above | |
MMC_RSP_R2_SPI_CARD_LOCKED = (1 shl 8);
|
|
MMC_RSP_R2_SPI_WP_ERASE_SKIP = (1 shl 9);
|
Or lock/unlock fail |
MMC_RSP_R2_SPI_LOCK_UNLOCK_FAIL = MMC_RSP_R2_SPI_WP_ERASE_SKIP;
|
|
MMC_RSP_R2_SPI_ERROR = (1 shl 10);
|
|
MMC_RSP_R2_SPI_CC_ERROR = (1 shl 11);
|
|
MMC_RSP_R2_SPI_CARD_ECC_ERROR = (1 shl 12);
|
|
MMC_RSP_R2_SPI_WP_VIOLATION = (1 shl 13);
|
|
MMC_RSP_R2_SPI_ERASE_PARAM = (1 shl 14);
|
|
MMC_RSP_R2_SPI_OUT_OF_RANGE = (1 shl 15);
|
Or CSD overwrite |
MMC_RSP_R2_SPI_CSD_OVERWRITE = MMC_RSP_R2_SPI_OUT_OF_RANGE;
|
|
MMC operation condition register (OCR) value
MMC_OCR_* | See: Section 5.1 of SD Physical Layer Simplified Specification V4.10 | |
MMC_OCR_BUSY = $80000000;
|
Busy Status - 0 = Initializing/1 = Initialization Complete |
MMC_OCR_HCS = $40000000;
|
Card Capacity Status - 0 = SDSC/1 = SDHC or SDXC |
MMC_OCR_UHS_II = $20000000;
|
UHS-II Card Status - 0 = Non UHS-II Card/1 = UHS-II Card |
MMC_OCR_S18A = $01000000;
|
Switching to 1.8V Accepted - 0 = Continue current voltage signaling/1 = Ready for switching signal voltage |
MMC_OCR_VOLTAGE_MASK = $007FFF80;
|
|
MMC_OCR_ACCESS_MODE = $60000000;
|
|
MMC card status register (CSR) value
MMC_CARD_STATUS_* | See: Section 4.10.1 of SD Physical Layer Simplified Specification Version 4.10 | |
| Note: These map to the Native mode R1 response values | |
MMC_CARD_STATUS_MASK = not($0206BF7F);
|
|
MMC_CARD_STATUS_ERROR = (1 shl 19);
|
|
MMC_CARD_STATUS_CURRENT_STATE = ($0F shl 9);
|
See MMC_CURRENT_STATE_ definitions below |
MMC_CARD_STATUS_READY_FOR_DATA = (1 shl 8);
|
|
MMC_CARD_STATUS_SWITCH_ERROR = (1 shl 7);
|
|
MMC current state value
MMC_CURRENT_STATE_* | From Card Status Register or R1 Response | |
MMC_CURRENT_STATE_IDLE = (0 shl 9);
|
|
MMC_CURRENT_STATE_READY = (1 shl 9);
|
|
MMC_CURRENT_STATE_IDENT = (2 shl 9);
|
|
MMC_CURRENT_STATE_STBY = (3 shl 9);
|
|
MMC_CURRENT_STATE_TRAN = (4 shl 9);
|
|
MMC_CURRENT_STATE_DATA = (5 shl 9);
|
|
MMC_CURRENT_STATE_RCV = (6 shl 9);
|
|
MMC_CURRENT_STATE_PRG = (7 shl 9);
|
|
MMC_CURRENT_STATE_DIS = (8 shl 9);
|
|
MMC card identification data (CID) value
MMC_CID_* | See: Section 5.2 of SD Physical Layer Simplified Specification Version 4.10 | |
| MMC CID Fields | |
MMC_CID_MID = 1;
|
Manufacturer Id |
MMC_CID_OID = 2;
|
OEM/Application Id |
MMC_CID_PNM0 = 3;
|
Product name (Byte 0) |
MMC_CID_PNM1 = 4;
|
Product name (Byte 1) |
MMC_CID_PNM2 = 5;
|
Product name (Byte 2) |
MMC_CID_PNM3 = 6;
|
Product name (Byte 3) |
MMC_CID_PNM4 = 7;
|
Product name (Byte 4) |
MMC_CID_PNM5 = 8;
|
Product name (Byte 5) |
MMC_CID_PNM6 = 9;
|
Product name (Byte 6) |
MMC_CID_PRV = 10;
|
Product revision |
MMC_CID_HRV = 11;
|
Hardware revision |
MMC_CID_FRV = 12;
|
Firmware revision |
MMC_CID_PSN = 13;
|
Product serial number |
MMC_CID_MDT_YEAR = 14;
|
Manufacturing year |
MMC_CID_MDT_MONTH = 15;
|
Manufacturing month |
MMC_CID_CRC = 16;
|
CRC |
MMC card specific data (CSD) value
MMC_CSD_* | See: Section 5.3 of SD Physical Layer Simplified Specification Version 4.10 | |
| MMC CSD Fields | |
MMC_CSD_STRUCTURE = 1;
|
|
MMC_CSD_SPECVER = 2;
|
MMC/eMMC Only |
MMC_CSD_TAAC_UNIT = 3;
|
|
MMC_CSD_TAAC_VALUE = 4;
|
|
MMC_CSD_NSAC = 5;
|
|
MMC_CSD_TRAN_SPEED_UNIT = 6;
|
|
MMC_CSD_TRAN_SPEED_VALUE = 37;
|
|
MMC_CSD_CCC = 7;
|
|
MMC_CSD_READ_BL_LEN = 8;
|
|
MMC_CSD_READ_BL_PARTIAL = 9;
|
|
MMC_CSD_WRITE_BLK_MISALIGN = 10;
|
|
MMC_CSD_READ_BLK_MISALIGN = 11;
|
|
MMC_CSD_DSR_IMP = 12;
|
|
MMC_CSD_C_SIZE = 13;
|
|
MMC_CSD_VDD_R_CURR_MIN = 14;
|
|
MMC_CSD_VDD_R_CURR_MAX = 15;
|
|
MMC_CSD_VDD_W_CURR_MIN = 16;
|
|
MMC_CSD_VDD_W_CURR_MAX = 17;
|
|
MMC_CSD_C_SIZE_MULT = 18;
|
|
MMC_CSD_ERASE_BLK_EN = 19;
|
SD Specification |
MMC_CSD_SECTOR_SIZE = 20;
|
MMC/eMMC Specification/SD Specification |
MMC_CSD_ERASE_GRP_SIZE = 21;
|
MMC/eMMC Specification |
MMC_CSD_ERASE_GRP_MULT = 22;
|
MMC/eMMC Specification |
MMC_CSD_WP_GRP_SIZE = 23;
|
|
MMC_CSD_WP_GRP_ENABLE = 24;
|
|
MMC_CSD_DEFAULT_ECC = 25;
|
MMC/eMMC Only |
MMC_CSD_R2W_FACTOR = 26;
|
|
MMC_CSD_WRITE_BL_LEN = 27;
|
|
MMC_CSD_WRITE_BL_PARTIAL = 28;
|
|
MMC_CSD_CONTENT_PROT_APP = 29;
|
MMC/eMMC Only |
MMC_CSD_FILE_FORMAT_GRP = 30;
|
|
MMC_CSD_COPY = 31;
|
|
MMC_CSD_PERM_WRITE_PROTECT = 32;
|
|
MMC_CSD_TMP_WRITE_PROTECT = 33;
|
|
MMC_CSD_FILE_FORMAT = 34;
|
|
MMC_CSD_ECC = 35;
|
MMC/eMMC Only |
MMC_CSD_CRC = 36;
|
|
MMC CSD structure value
MMC_CSD_STRUCT_* MMC_CSD_STRUCT_VER_1_0 = 0;
|
Valid for system specification 1.0 - 1.2 |
MMC_CSD_STRUCT_VER_1_1 = 1;
|
Valid for system specification 1.4 - 2.2 |
MMC_CSD_STRUCT_VER_1_2 = 2;
|
Valid for system specification 3.1 - 3.2 - 3.31 - 4.0 - 4.1 |
MMC_CSD_STRUCT_EXT_CSD = 3;
|
Version is coded in CSD_STRUCTURE in EXT_CSD |
MMC CSD spec version value
MMC_CSD_SPEC_VER_* MMC_CSD_SPEC_VER_0 = 0;
|
Implements system specification 1.0 - 1.2 |
MMC_CSD_SPEC_VER_1 = 1;
|
Implements system specification 1.4 |
MMC_CSD_SPEC_VER_2 = 2;
|
Implements system specification 2.0 - 2.2 |
MMC_CSD_SPEC_VER_3 = 3;
|
Implements system specification 3.1 - 3.2 - 3.31 |
MMC_CSD_SPEC_VER_4 = 4;
|
Implements system specification 4.0 - 4.1 |
MMC CSD TAAC time unit
MMC_CSD_TAAC_UNITS* MMC_CSD_TAAC_UNITS:array[0..7] of LongWord = (
| |
1,
|
|
10,
|
|
100,
|
|
1000,
|
|
10000,
|
|
100000,
|
|
1000000,
|
|
10000000);
|
|
MMC CSD TAAC time value
MMC_CSD_TAAC_VALUES* MMC_CSD_TAAC_VALUES:array[0..15] of LongWord = (
| |
0,
|
|
10,
|
|
12,
|
|
13,
|
|
15,
|
|
20,
|
|
25,
|
|
30,
|
|
35,
|
|
40,
|
|
45,
|
|
50,
|
|
55,
|
|
60,
|
|
70,
|
|
80);
|
|
MMC CSD card command class (CCC) value
MMC_CCC_* | See: Table 4-21 (Page 68) of SD Physical Layer Simplified Specification V4.10 | |
MMC_CCC_BASIC = (1 shl 0);
|
(Class 0) Basic protocol functions (CMD0,1,2,3,4,7,9,10,12,13,15) (and for SPI, CMD58,59) |
MMC_CCC_STREAM_READ = (1 shl 1);
|
(Class 1) Stream read commands (CMD11) |
MMC_CCC_BLOCK_READ = (1 shl 2);
|
(Class 2) Block read commands (CMD16,17,18) |
MMC_CCC_STREAM_WRITE = (1 shl 3);
|
(Class 3) Stream write commands (CMD20) |
MMC_CCC_BLOCK_WRITE = (1 shl 4);
|
(Class 4) Block write commands (CMD16,24,25,26,27) |
MMC_CCC_ERASE = (1 shl 5);
|
(Class 5) Ability to erase blocks (CMD32,33,34,35,36,37,38,39) |
MMC_CCC_WRITE_PROT = (1 shl 6);
|
(Class 6) Ability to write protect blocks (CMD28,29,30) |
MMC_CCC_LOCK_CARD = (1 shl 7);
|
(Class 7) Ability to lock down card (CMD16,CMD42) |
MMC_CCC_APP_SPEC = (1 shl 8);
|
(Class 8) Application specific (CMD55,56,57,ACMD*) |
MMC_CCC_IO_MODE = (1 shl 9);
|
(Class 9) I/O mode (CMD5,39,40,52,53) |
MMC_CCC_SWITCH = (1 shl 10);
|
(Class 10) High speed switch (CMD6,34,35,36,37,50) |
MMC_CCC_EXTENSION = (1 shl 11);
|
(Class 11) Extension (CMD?) |
MMC CSD transfer speed rate unit
MMC_CSD_TRAN_SPEED_UNITS* MMC_CSD_TRAN_SPEED_UNITS:array[0..7] of LongWord = (
| |
10000,
|
|
100000,
|
|
1000000,
|
|
10000000,
|
|
0,
|
|
0,
|
|
0,
|
|
0);
|
|
MMC CSD transfer speed time value
MMC_CSD_TRAN_SPEED_VALUES* MMC_CSD_TRAN_SPEED_VALUES:array[0..15] of LongWord = (
| |
0,
|
|
10,
|
|
12,
|
|
13,
|
|
15,
|
|
20,
|
|
25,
|
|
30,
|
|
35,
|
|
40,
|
|
45,
|
|
50,
|
|
55,
|
|
60,
|
|
70,
|
|
80);
|
|
SECURE_ERASE = $80000000;
|
Used by MMC_CMD_ERASE |
MMC voltage value
MMC_VDD_* MMC_VDD_165_195 = $00000080;
|
VDD voltage 1.65 - 1.95 |
MMC_VDD_20_21 = $00000100;
|
VDD voltage 2.0 ~ 2.1 |
MMC_VDD_21_22 = $00000200;
|
VDD voltage 2.1 ~ 2.2 |
MMC_VDD_22_23 = $00000400;
|
VDD voltage 2.2 ~ 2.3 |
MMC_VDD_23_24 = $00000800;
|
VDD voltage 2.3 ~ 2.4 |
MMC_VDD_24_25 = $00001000;
|
VDD voltage 2.4 ~ 2.5 |
MMC_VDD_25_26 = $00002000;
|
VDD voltage 2.5 ~ 2.6 |
MMC_VDD_26_27 = $00004000;
|
VDD voltage 2.6 ~ 2.7 |
MMC_VDD_27_28 = $00008000;
|
VDD voltage 2.7 ~ 2.8 |
MMC_VDD_28_29 = $00010000;
|
VDD voltage 2.8 ~ 2.9 |
MMC_VDD_29_30 = $00020000;
|
VDD voltage 2.9 ~ 3.0 |
MMC_VDD_30_31 = $00040000;
|
VDD voltage 3.0 ~ 3.1 |
MMC_VDD_31_32 = $00080000;
|
VDD voltage 3.1 ~ 3.2 |
MMC_VDD_32_33 = $00100000;
|
VDD voltage 3.2 ~ 3.3 |
MMC_VDD_33_34 = $00200000;
|
VDD voltage 3.3 ~ 3.4 |
MMC_VDD_34_35 = $00400000;
|
VDD voltage 3.4 ~ 3.5 |
MMC_VDD_35_36 = $00800000;
|
VDD voltage 3.5 ~ 3.6 |
MMC switch mode value
MMC_SWITCH_MODE_* MMC_SWITCH_MODE_CMD_SET = $00;
|
Change the command set |
MMC_SWITCH_MODE_SET_BITS = $01;
|
Set bits in EXT_CSD byte addressed by index which are 1 in value field |
MMC_SWITCH_MODE_CLEAR_BITS = $02;
|
Clear bits in EXT_CSD byte addressed by index, which are 1 in value field |
MMC_SWITCH_MODE_WRITE_BYTE = $03;
|
Set target byte to value |
MMC EXT_CSD field
EXT_CSD_* EXT_CSD_CMDQ_MODE_EN = 15;
|
R/W |
EXT_CSD_FLUSH_CACHE = 32;
|
W |
EXT_CSD_CACHE_CTRL = 33;
|
R/W |
EXT_CSD_POWER_OFF_NOTIFICATION = 34;
|
R/W |
EXT_CSD_PACKED_FAILURE_INDEX = 35;
|
RO |
EXT_CSD_PACKED_CMD_STATUS = 36;
|
RO |
EXT_CSD_EXP_EVENTS_STATUS = 54;/code>
|
RO, 2 bytes |
| <code>EXT_CSD_EXP_EVENTS_CTRL = 56; | R/W, 2 bytes |
EXT_CSD_DATA_SECTOR_SIZE = 61;
|
R |
EXT_CSD_ENH_START_ADDR = 136;
|
R/W |
EXT_CSD_ENH_SIZE_MULT = 140;
|
R/W |
EXT_CSD_GP_SIZE_MULT = 143;
|
R/W |
EXT_CSD_PARTITION_SETTING_COMPLETED = 155;
|
R/W |
EXT_CSD_PARTITION_ATTRIBUTE = 156;
|
R/W |
EXT_CSD_MAX_ENH_SIZE_MULT = 157;
|
R |
EXT_CSD_PARTITION_SUPPORT = 160;
|
RO |
EXT_CSD_HPI_MGMT = 161;
|
R/W |
EXT_CSD_RST_N_FUNCTION = 162;
|
R/W |
EXT_CSD_BKOPS_EN = 163;
|
R/W |
EXT_CSD_BKOPS_START = 164;
|
W |
EXT_CSD_SANITIZE_START = 165;
|
W |
EXT_CSD_WR_REL_PARAM = 166;
|
RO |
EXT_CSD_WR_REL_SET = 167;
|
R/W |
EXT_CSD_RPMB_MULT = 168;
|
RO |
EXT_CSD_FW_CONFIG = 169;
|
R/W |
EXT_CSD_BOOT_WP = 173;
|
R/W |
EXT_CSD_ERASE_GROUP_DEF = 175;
|
R/W |
EXT_CSD_BOOT_BUS_CONDITIONS = 177;
|
R/W/E |
EXT_CSD_PART_CONFIG = 179;
|
R/W |
EXT_CSD_ERASED_MEM_CONT = 181;
|
RO |
EXT_CSD_BUS_WIDTH = 183;
|
R/W |
EXT_CSD_STROBE_SUPPORT = 184
|
RO |
EXT_CSD_HS_TIMING = 185;
|
R/W |
EXT_CSD_POWER_CLASS = 187;
|
R/W |
EXT_CSD_REV = 192;
|
RO |
EXT_CSD_STRUCTURE = 194;
|
RO |
EXT_CSD_CARD_TYPE = 196;
|
RO |
EXT_CSD_DRIVER_STRENGTH = 197;
|
RO |
EXT_CSD_OUT_OF_INTERRUPT_TIME = 198;
|
RO |
EXT_CSD_PART_SWITCH_TIME = 199;
|
RO |
EXT_CSD_PWR_CL_52_195 = 200;
|
RO |
EXT_CSD_PWR_CL_26_195 = 201;
|
RO |
EXT_CSD_PWR_CL_52_360 = 202;
|
RO |
EXT_CSD_PWR_CL_26_360 = 203;
|
RO |
EXT_CSD_SEC_CNT = 212;
|
RO, 4 bytes |
EXT_CSD_S_A_TIMEOUT = 217;
|
RO |
EXT_CSD_REL_WR_SEC_C = 222;
|
RO |
EXT_CSD_HC_WP_GRP_SIZE = 221;
|
RO |
EXT_CSD_ERASE_TIMEOUT_MULT = 223;
|
RO |
EXT_CSD_HC_ERASE_GRP_SIZE = 224;
|
RO |
EXT_CSD_BOOT_SIZE_MULT = 226;
|
RO |
EXT_CSD_SEC_TRIM_MULT = 229;
|
RO |
EXT_CSD_SEC_ERASE_MULT = 230;
|
RO |
EXT_CSD_SEC_FEATURE_SUPPORT = 231;
|
RO |
EXT_CSD_TRIM_MULT = 232;
|
RO |
EXT_CSD_PWR_CL_200_195 = 236;
|
RO |
EXT_CSD_PWR_CL_200_360 = 237;
|
RO |
EXT_CSD_PWR_CL_DDR_52_195 = 238;
|
RO |
EXT_CSD_PWR_CL_DDR_52_360 = 239;
|
RO |
EXT_CSD_BKOPS_STATUS = 246;
|
RO |
EXT_CSD_POWER_OFF_LONG_TIME = 247;
|
RO |
EXT_CSD_GENERIC_CMD6_TIME = 248;
|
RO |
EXT_CSD_CACHE_SIZE = 249;
|
RO, 4 bytes |
EXT_CSD_PWR_CL_DDR_200_360 = 253;
|
RO |
EXT_CSD_FIRMWARE_VERSION = 254;
|
RO, 8 bytes |
EXT_CSD_PRE_EOL_INFO = 267;
|
RO |
EXT_CSD_DEVICE_LIFE_TIME_EST_TYP_A = 268;
|
RO |
EXT_CSD_DEVICE_LIFE_TIME_EST_TYP_B = 269;
|
RO |
EXT_CSD_CMDQ_DEPTH = 307;
|
RO |
EXT_CSD_CMDQ_SUPPORT = 308;
|
RO |
EXT_CSD_SUPPORTED_MODE = 493;
|
RO |
EXT_CSD_TAG_UNIT_SIZE = 498;
|
RO |
EXT_CSD_DATA_TAG_SUPPORT = 499;
|
RO |
EXT_CSD_MAX_PACKED_WRITES = 500;
|
RO |
EXT_CSD_MAX_PACKED_READS = 501;
|
RO |
EXT_CSD_BKOPS_SUPPORT = 502;
|
RO |
EXT_CSD_HPI_FEATURES = 503;
|
RO |
MMC EXT_CSD field definition
EXT_CSD_* EXT_CSD_PARTITION_ATTRIBUTE_ENH_4 = $10;
|
|
EXT_CSD_PARTITION_ATTRIBUTE_ENH_3 = $08;
|
|
EXT_CSD_PARTITION_ATTRIBUTE_ENH_2 = $04;
|
|
EXT_CSD_PARTITION_ATTRIBUTE_ENH_1 = $02;
|
|
EXT_CSD_PARTITION_ATTRIBUTE_ENH_USR = $01;
|
|
EXT_CSD_PARTITION_EXT_ATTRIBUTE_EN = $04;
|
|
EXT_CSD_PARTITION_ENH_ATTRIBUTE_EN = $02;
|
|
EXT_CSD_PARTITION_PARTITIONING_EN = $01;
|
|
EXT_CSD_WR_REL_PARAM_EN = (1 shl 2);
|
|
EXT_CSD_WR_REL_PARAM_EN_RPMB_REL_WR = (1 shl 4);
|
|
EXT_CSD_BOOT_WP_B_PWR_WP_DIS = $40;
|
|
EXT_CSD_BOOT_WP_B_PERM_WP_DIS = $10;
|
|
EXT_CSD_BOOT_WP_B_PERM_WP_EN = $04;
|
|
EXT_CSD_BOOT_WP_B_PWR_WP_EN = $01;
|
|
EXT_CSD_PART_CONFIG_ACC_MASK = $07;
|
|
EXT_CSD_PART_CONFIG_ACC_BOOT0 = $01;
|
|
EXT_CSD_PART_CONFIG_ACC_RPMB = $03;
|
|
EXT_CSD_PART_CONFIG_ACC_GP0 = $04;
|
|
EXT_CSD_PART_SETTING_COMPLETED = $01;
|
|
EXT_CSD_PART_SUPPORT_PART_EN = $01;
|
|
EXT_CSD_CMD_SET_NORMAL = (1 shl 0);
|
|
EXT_CSD_CMD_SET_SECURE = (1 shl 1);
|
|
EXT_CSD_CMD_SET_CPSECURE = (1 shl 2);
|
|
EXT_CSD_CARD_TYPE_HS_26 = (1 shl 0);
|
Card can run at 26MHz |
EXT_CSD_CARD_TYPE_HS_52 = (1 shl 1);
|
Card can run at 52MHz |
EXT_CSD_CARD_TYPE_HS = (EXT_CSD_CARD_TYPE_HS_26 or EXT_CSD_CARD_TYPE_HS_52);
|
|
EXT_CSD_CARD_TYPE_DDR_1_8V = (1 shl 2);
|
Card can run at 52MHz / DDR mode @1.8V or 3V I/O |
EXT_CSD_CARD_TYPE_DDR_1_2V = (1 shl 3);
|
Card can run at 52MHz / DDR mode @1.2V I/O |
EXT_CSD_CARD_TYPE_DDR_52 = (EXT_CSD_CARD_TYPE_DDR_1_8V or EXT_CSD_CARD_TYPE_DDR_1_2V);
|
|
EXT_CSD_CARD_TYPE_HS200_1_8V = (1 shl 4);
|
Card can run at 200MHz |
EXT_CSD_CARD_TYPE_HS200_1_2V = (1 shl 5);
|
Card can run at 200MHz / SDR mode @1.2V I/O |
EXT_CSD_CARD_TYPE_HS200 = (EXT_CSD_CARD_TYPE_HS200_1_8V or EXT_CSD_CARD_TYPE_HS200_1_2V);
|
|
EXT_CSD_CARD_TYPE_HS400_1_8V = (1 shl 6);
|
Card can run at 200MHz DDR, 1.8V |
EXT_CSD_CARD_TYPE_HS400_1_2V = (1 shl 7);
|
Card can run at 200MHz DDR, 1.2V |
EXT_CSD_CARD_TYPE_HS400 = (EXT_CSD_CARD_TYPE_HS400_1_8V or EXT_CSD_CARD_TYPE_HS400_1_2V);
|
|
EXT_CSD_CARD_TYPE_HS400ES = (1 shl 8);
|
Card can run at HS400ES |
EXT_CSD_BUS_WIDTH_1 = 0;
|
Card is in 1 bit mode |
EXT_CSD_BUS_WIDTH_4 = 1;
|
Card is in 4 bit mode |
EXT_CSD_BUS_WIDTH_8 = 2;
|
Card is in 8 bit mode |
EXT_CSD_DDR_BUS_WIDTH_4 = 5;
|
Card is in 4 bit DDR mode |
EXT_CSD_DDR_BUS_WIDTH_8 = 6;
|
Card is in 8 bit DDR mode |
EXT_CSD_BUS_WIDTH_STROBE = 1 shl 7;
|
Enhanced strobe mode |
EXT_CSD_TIMING_BC = 0;
|
Backwards compatility |
EXT_CSD_TIMING_HS = 1;
|
High speed |
EXT_CSD_TIMING_HS200 = 2;
|
HS200 |
EXT_CSD_TIMING_HS400 = 3;
|
HS400 |
EXT_CSD_DRV_STR_SHIFT = 4;
|
Driver Strength shift |
EXT_CSD_SEC_ER_EN = 1 shl 0;
|
|
EXT_CSD_SEC_BD_BLK_EN = 1 shl 2;
|
|
EXT_CSD_SEC_GB_CL_EN = 1 shl 4;
|
|
EXT_CSD_SEC_SANITIZE = 1 shl 6;
|
v4.5 only |
EXT_CSD_RST_N_EN_MASK = $03;
|
|
EXT_CSD_RST_N_ENABLED = 1;
|
RST_n is enabled on card |
EXT_CSD_NO_POWER_NOTIFICATION = 0;
|
|
EXT_CSD_POWER_ON = 1;
|
|
EXT_CSD_POWER_OFF_SHORT = 2;
|
|
EXT_CSD_POWER_OFF_LONG = 3;
|
|
EXT_CSD_PWR_CL_8BIT_MASK = $F0;
|
8 bit PWR CLS |
EXT_CSD_PWR_CL_4BIT_MASK = $0F;
|
8 bit PWR CLS |
EXT_CSD_PWR_CL_8BIT_SHIFT = 4;
|
|
EXT_CSD_PWR_CL_4BIT_SHIFT = 0;
|
|
EXT_CSD_PACKED_EVENT_EN = 1 shl 3;
|
|
MMC EXT_CSD exception event status field
EXT_CSD_* EXT_CSD_URGENT_BKOPS = 1 shl 0;
|
|
EXT_CSD_DYNCAP_NEEDED = 1 shl 1;
|
|
EXT_CSD_SYSPOOL_EXHAUSTED = 1 shl 2;
|
|
EXT_CSD_PACKED_FAILURE = 1 shl 3;
|
|
EXT_CSD_PACKED_GENERIC_ERROR = 1 shl 0;
|
|
EXT_CSD_PACKED_INDEXED_ERROR = 1 shl 1;
|
|
MMC EXT_CSD BKOPS status level
EXT_CSD_BKOPS_* EXT_CSD_BKOPS_LEVEL_2 = $02;
|
MMC EXT_CSD BKOPS mode
EXT_CSD_*_BKOPS_ EXT_CSD_MANUAL_BKOPS_MASK = $01;
|
|
EXT_CSD_AUTO_BKOPS_MASK = $02;
|
MMC EXT_CSD command queue
EXT_CSD_CMDQ_* EXT_CSD_CMDQ_MODE_ENABLED = 1 shl 0;
|
|
EXT_CSD_CMDQ_DEPTH_MASK = $1F;
|
|
EXT_CSD_CMDQ_SUPPORTED = 1 shl 0;
|
MMC EXT_CSD high speed max
MMC_HIGH_* MMC_HIGH_26_MAX_DTR = 26000000;
|
|
MMC_HIGH_52_MAX_DTR = 52000000;
|
|
MMC_HIGH_DDR_MAX_DTR = 52000000;
|
|
MMC_HS200_MAX_DTR = 200000000;
|
MMC EXT_CSD minimum partition switch timeout
MMC_MIN_PART_* MMC_MIN_PART_SWITCH_TIME = 300;
|
Milliseconds |
MMC miscellaneous
MMCPART_*, MMC_MAX_* MMCPART_NOAVAILABLE = ($ff);
|
|
PART_ACCESS_MASK = ($07);
|
|
PART_SUPPORT = ($01);
|
|
ENHNCD_SUPPORT = ($02);
|
|
PART_ENH_ATTRIB = ($1f);
|
|
| Maximum block size for MMC | |
MMC_MAX_BLOCK_LEN = 512;
|
|
| Maximum block count for MMC | |
MMC_MAX_BLOCK_COUNT = 65535;
|
|
| The number of MMC physical partitions. These consist of: boot partitions (2), general purpose partitions (4) and RPMB partition (1) in MMC v4.4 | |
MMC_NUM_BOOT_PARTITION = 2;
|
|
MMC_NUM_GP_PARTITION = 4;
|
|
MMC_NUM_PHY_PARTITION = 7;
|
|
| Timeouts | |
MMC_DEFAULT_CMD6_TIMEOUT_MS = 500;
|
|
MMC_MIN_CACHE_EN_TIMEOUT_MS = 1600;
|
|
| Sizes | |
MMC_FIRMWARE_VERSION_LEN = 8;
|
|
| Version specific features | |
MMC_DISCARD_FEATURE = $01;
|
|
| Busy Poll Commands | |
MMC_BUSY_CMD6 = 0;
|
|
MMC_BUSY_ERASE = 1;
|
|
MMC_BUSY_HPI = 2;
|
|
| Erase/Trim/Discard Arguments | |
MMC_ERASE_ARG = $00000000;
|
|
MMC_SECURE_ERASE_ARG = $80000000;
|
|
MMC_TRIM_ARG = $00000001;
|
|
MMC_DISCARD_ARG = $00000003;
|
|
MMC_SECURE_TRIM1_ARG = $80000001;
|
|
MMC_SECURE_TRIM2_ARG = $80008000;
|
|
MMC_SECURE_ARGS = $80000000;
|
|
MMC_TRIM_ARGS = $00008001;
|
|
MMC logging
MMC_LOG_* MMC_LOG_LEVEL_DEBUG = LOG_LEVEL_DEBUG;
|
MMC debugging messages |
MMC_LOG_LEVEL_INFO = LOG_LEVEL_INFO;
|
MMC informational messages, such as a device being attached or detached |
MMC_LOG_LEVEL_WARN = LOG_LEVEL_WARN;
|
MMC warning messages |
MMC_LOG_LEVEL_ERROR = LOG_LEVEL_ERROR;
|
MMC error messages |
MMC_LOG_LEVEL_NONE = LOG_LEVEL_NONE;
|
No MMC messages |
SD specific constants
SD_* SD_DEFAULT_BLOCKSIZE = 512;
|
|
SD_DEFAULT_BLOCKSHIFT = 9;
|
SD bus width
SD_BUS_WIDTH_* SD_BUS_WIDTH_1 = 0;
|
|
SD_BUS_WIDTH_4 = 2;
|
SD bus speed (Hz)
SD_BUS_SPEED_* SD_BUS_SPEED_DEFAULT = 25000000;
|
|
SD_BUS_SPEED_HS = 50000000;
|
|
SD_BUS_SPEED_UHS_SDR12 = 25000000;
|
|
SD_BUS_SPEED_UHS_SDR25 = 50000000;
|
|
SD_BUS_SPEED_UHS_DDR50 = 50000000;
|
|
SD_BUS_SPEED_UHS_SDR50 = 100000000;
|
|
SD_BUS_SPEED_UHS_SDR104 = 208000000;
|
SD command
SD_CMD_* | From: /include/linux/mmc/sd.h | |
| Class 0 | |
SD_CMD_SEND_RELATIVE_ADDR = 3;
|
|
SD_CMD_SEND_IF_COND = 8;
|
|
SD_CMD_SWITCH_VOLTAGE = 11;
|
|
| Class 10 | |
SD_CMD_SWITCH = 6;
|
See: 4.3.10 Switch Function Command |
| Class 5 | |
SD_CMD_ERASE_WR_BLK_START = 32;
|
|
SD_CMD_ERASE_WR_BLK_END = 33;
|
|
| Application commands | |
SD_CMD_APP_SET_BUS_WIDTH = 6;
|
|
SD_CMD_APP_SD_STATUS = 13;
|
|
SD_CMD_APP_SEND_NUM_WR_BLKS = 22;
|
|
SD_CMD_APP_SEND_OP_COND = 41;
|
|
SD_CMD_APP_SEND_SCR = 51;
|
|
| SD_CMD_SWITCH argument format: | |
[31] Check (0) or switch (1)
|
|
[30:24] Reserved (0)
|
|
[23:20] Function group 6
|
|
[19:16] Function group 5
|
|
[15:12] Function group 4
|
|
[11:8] Function group 3
|
|
[7:4] Function group 2
|
|
[3:0] Function group 1
|
|
SD switch mode value
SD_SWITCH_MODE_* SD_SWITCH_MODE_CHECK = 0;
|
|
SD_SWITCH_MODE_SWITCH = 1;
|
SD switch function group
SD_SWITCH_FUNCTION_GROUP_* SD_SWITCH_FUNCTION_GROUP_ACCESS = 0;
|
Access Mode |
SD_SWITCH_FUNCTION_GROUP_COMMAND = 1;
|
Command System |
SD_SWITCH_FUNCTION_GROUP_DRIVER = 2;
|
Driver Strength |
SD_SWITCH_FUNCTION_GROUP_POWER = 3;
|
Power Limit |
SD switch access mode
SD_SWITCH_ACCESS_MODE_* SD_SWITCH_ACCESS_MODE_DEF = 0;
|
Default SDR12 |
SD_SWITCH_ACCESS_MODE_HS = 1;
|
High Speed SDR25 |
SD_SWITCH_ACCESS_MODE_SDR50 = 2;
|
SDR50 (1.8V only) |
SD_SWITCH_ACCESS_MODE_SDR104 = 3;
|
SDR104 (1.8V only) |
SD_SWITCH_ACCESS_MODE_DDR50 = 4;
|
DDR50 (1.8V only) |
SD switch command system
SD_SWITCH_COMMAND_SYSTEM_* SD_SWITCH_COMMAND_SYSTEM_DEF = 0;
|
Default |
SD_SWITCH_COMMAND_SYSTEM_EC = 1;
|
For eC |
SD_SWITCH_COMMAND_SYSTEM_OTP = 3;
|
OTP |
SD_SWITCH_COMMAND_SYSTEM_ASSD = 4;
|
ASSD |
SD switch driver strength
SD_SWITCH_DRIVER_STRENGTH_* SD_SWITCH_DRIVER_STRENGTH_DEF = 0;
|
Default Type B |
SD_SWITCH_DRIVER_STRENGTH_TYPE_A = 1;
|
Type A |
SD_SWITCH_DRIVER_STRENGTH_TYPE_C = 2;
|
Type C |
SD_SWITCH_DRIVER_STRENGTH_TYPE_D = 3;
|
Type D |
SD switch power limit
SD_SWITCH_POWER_LIMIT_* SD_SWITCH_POWER_LIMIT_DEF = 0;
|
Default 0.72W |
SD_SWITCH_POWER_LIMIT_144 = 1;
|
1.44W |
SD_SWITCH_POWER_LIMIT_216 = 2;
|
2.16W (Embedded only) |
SD_SWITCH_POWER_LIMIT_216 = 2;
|
2.16W (Embedded only) |
SD_SWITCH_POWER_LIMIT_288 = 3;
|
2.88W (Embedded only) |
SD_SWITCH_POWER_LIMIT_180 = 4;
|
1.80W |
SD send interface condition value
SD_SEND_IF_COND_* SD_SEND_IF_COND_CHECK_PATTERN = $AA;
|
|
SD_SEND_IF_COND_VOLTAGE_MASK = $00FF8000;
|
MMC_VDD_27_28, MMC_VDD_28_29, MMC_VDD_29_30, MMC_VDD_30_31, MMC_VDD_31_32, MMC_VDD_32_33, MMC_VDD_33_34, MMC_VDD_34_35, MMC_VDD_35_36 |
| SD_CMD_SEND_IF_COND argument format: | |
[31:12] Reserved (0)
|
|
[11:8] Host Voltage Supply Flags
|
|
[7:0] Check Pattern (0xAA)
|
|
SD send operation condition value
SD_SEND_OP_COND_* SD_SEND_OP_COND_VOLTAGE_MASK = $00FF8000;
|
MMC_VDD_27_28, MMC_VDD_28_29, MMC_VDD_29_30, MMC_VDD_30_31, MMC_VDD_31_32, MMC_VDD_32_33, MMC_VDD_33_34, MMC_VDD_34_35, MMC_VDD_35_36 |
SD operation condition register value
SD_OCR_* | See: Section 5.1 of SD Physical Layer Simplified Specification V4.10 | |
SD_OCR_CCS = $40000000;
|
Card Capacity Status - 0 = SDSC/1 = SDHC or SDXC |
SD_OCR_CCS = $40000000;
|
Card Capacity Status - 0 = SDSC/1 = SDHC or SDXC |
SD_OCR_UHS_II = $20000000;
|
UHS-II Card Status - 0 = Non UHS-II Card/1 = UHS-II Card |
SD_OCR_XPC = $10000000;
|
SDXC Power Control |
SD_OCR_S18A = $01000000;
|
1.8V Switching Accepted |
SD CSD structure value
SD_CSD_STRUCT_* SD_CSD_STRUCT_VER_1_0 = 0;
|
Standard Capacity |
SD_CSD_STRUCT_VER_2_0 = 1;
|
High Capacity and Extended Capacity |
SD status register (SSR) value
SD_SSR_* | See: Section 4.10.2 of SD Physical Layer Simplified Specification Version 4.10 | |
| SD SSR Fields | |
SD_SSR_DAT_BUS_WIDTH = 1;
|
|
SD_SSR_SECURED_MODE = 2;
|
|
SD_SSR_SD_CARD_TYPE = 3;
|
|
SD_SSR_SIZE_OF_PROTECTED_AREA = 4;
|
|
SD_SSR_SPEED_CLASS = 5;
|
|
SD_SSR_PERFORMANCE_MOVE = 6;
|
|
SD_SSR_AU_SIZE = 7;
|
|
SD_SSR_ERASE_SIZE = 8;
|
|
SD_SSR_ERASE_TIMEOUT = 9;
|
|
SD_SSR_ERASE_OFFSET = 10;
|
|
SD_SSR_UHS_SPEED_GRADE = 11;
|
|
SD_SSR_UHS_AU_SIZE = 12;
|
|
SD SSR bus width value
SD_SSR_BUS_WIDTH_* SD_SSR_BUS_WIDTH_1 = 0;
|
1 (default) |
SD_SSR_BUS_WIDTH_4 = 2;
|
4 bit width |
SD SSR card type value
SD_SSR_CARD_TYPE_* SD_SSR_CARD_TYPE_RW = $0000;
|
Regular SD RD/WR Card |
SD_SSR_CARD_TYPE_ROM = $0001;
|
SD ROM Card |
SD_SSR_CARD_TYPE_OTP = $0002;
|
OTP |
SD SSR speed class value
SD_SSR_SPEED_CLASS_* SD_SSR_SPEED_CLASS_0 = $00;
|
Class 0 |
SD_SSR_SPEED_CLASS_2 = $01;
|
Class 2 |
SD_SSR_SPEED_CLASS_4 = $02;
|
Class 4 |
SD_SSR_SPEED_CLASS_6 = $03;
|
Class 6 |
SD_SSR_SPEED_CLASS_10 = $04;
|
Class 10 |
SD SSR AU size value
SD_SSR_AU_SIZE_* SD_SSR_AU_SIZE_VALUES:array[0..15] of LongWord = (
| |
0,
|
Not Defined |
$00004000,
|
16 KB |
$00008000,
|
32 KB |
$00010000,
|
64 KB |
$00020000,
|
128 KB |
$00040000,
|
256 KB |
$00080000,
|
512 KB |
$00100000,
|
1 MB |
$00200000,
|
2 MB |
$00400000,
|
4 MB |
$00800000,
|
8 MB |
$00800000 + $00400000,
|
12 MB |
$01000000,
|
16 MB |
$01000000 + $00800000,
|
24 MB |
$02000000,
|
32 MB |
$04000000);
|
64 MB |
SD SSR UHS speed grade value
SD_SSR_UHS_SPEED_* SD_SSR_UHS_SPEED_GRADE_0 = 0;
|
Less than 10MB/sec |
SD_SSR_UHS_SPEED_GRADE_1 = 1;
|
10MB/sec and above |
SD SSR UHS AU size value
SD_SSR_UHS_AU_SIZE_* SD_SSR_UHS_AU_SIZE_VALUES:array[0..15] of LongWord = (
| |
0,
|
Not Defined |
0,
|
Not Used |
0,
|
Not Used |
0,
|
Not Used |
0,
|
Not Used |
0,
|
Not Used |
0,
|
Not Used |
$00100000,
|
1 MB |
$00200000,
|
2 MB |
$00400000,
|
4 MB |
$00800000,
|
8 MB |
$00800000 + $00400000,
|
12 MB |
$01000000,
|
16 MB |
$01000000 + $00800000,
|
24 MB |
$02000000,
|
32 MB |
$04000000);
|
64 MB |
SD switch status value
SD_SWITCH_* | See: Section 4.3.10 of SD Physical Layer Simplified Specification Version 4.10 | |
| SD Switch Fields | |
SD_SWITCH_MAXIMUM_CURRENT = 1;
|
|
SD_SWITCH_GROUP6_SUPPORT = 2;
|
|
SD_SWITCH_GROUP5_SUPPORT = 3;
|
|
SD_SWITCH_GROUP4_SUPPORT = 4;
|
|
SD_SWITCH_GROUP3_SUPPORT = 5;
|
|
SD_SWITCH_GROUP2_SUPPORT = 6;
|
|
SD_SWITCH_GROUP1_SUPPORT = 7;
|
|
SD_SWITCH_GROUP6_SELECTION = 8;
|
|
SD_SWITCH_GROUP5_SELECTION = 9;
|
|
SD_SWITCH_GROUP4_SELECTION = 10;
|
|
SD_SWITCH_GROUP3_SELECTION = 11;
|
|
SD_SWITCH_GROUP2_SELECTION = 12;
|
|
SD_SWITCH_GROUP1_SELECTION = 13;
|
|
SD_SWITCH_STRUCT_VERSION = 14;
|
|
SD_SWITCH_GROUP6_BUSY_STATUS = 15;
|
|
SD_SWITCH_GROUP5_BUSY_STATUS = 16;
|
|
SD_SWITCH_GROUP4_BUSY_STATUS = 17;
|
|
SD_SWITCH_GROUP3_BUSY_STATUS = 18;
|
|
SD_SWITCH_GROUP2_BUSY_STATUS = 19;
|
|
SD_SWITCH_GROUP1_BUSY_STATUS = 20;
|
|
| SD Switch Access Mode (Bus Speed) Support (Group 1) | |
SD_SWITCH_GROUP1_SDR12 = (1 shl 0);
|
|
SD_SWITCH_GROUP1_HS = (1 shl 1);
|
|
SD_SWITCH_GROUP1_SDR25 = (1 shl 1);
|
|
SD_SWITCH_GROUP1_SDR50 = (1 shl 2);
|
|
SD_SWITCH_GROUP1_SDR104 = (1 shl 3);
|
|
SD_SWITCH_GROUP1_DDR50 = (1 shl 4);
|
|
| SD Switch Driver Strength Support (Group 3) | |
SD_SWITCH_GROUP3_TYPE_B = (1 shl 0);
|
|
SD_SWITCH_GROUP3_TYPE_A = (1 shl 1);
|
|
SD_SWITCH_GROUP3_TYPE_C = (1 shl 2);
|
|
SD_SWITCH_GROUP3_TYPE_D = (1 shl 3);
|
|
| SD Switch Structure Versions | |
SD_SWITCH_STRUCT_VER_0 = 0;
|
Bits 511:376 are defined (SD_SWITCH_MAXIMUM_CURRENT to SD_SWITCH_GROUP1_SELECTION) |
SD_SWITCH_STRUCT_VER_1 = 1;
|
Bits 511:272 are defined (SD_SWITCH_MAXIMUM_CURRENT to SD_SWITCH_GROUP1_BUSY_STATUS |
SD configuration register (SCR) value
SD_SCR_* | See: Section 5.6 of SD Physical Layer Simplified Specification Version 4.10 | |
| SD SCR Fields | |
SD_SCR_STRUCTURE = 1;
|
|
SD_SCR_SD_SPEC = 2;
|
|
SD_SCR_DATA_STAT_AFTER_ERASE = 3;
|
|
SD_SCR_SD_SECURITY = 4;
|
|
SD_SCR_SD_BUS_WIDTHS = 5;
|
|
SD_SCR_SD_SPEC3 = 6;
|
|
SD_SCR_EX_SECURITY = 7;
|
|
SD_SCR_SD_SPEC4 = 8;
|
|
SD_SCR_CMD_SUPPORT = 9;
|
|
SD SCR structure value
SD_SCR_STRUCT_* SD_SCR_STRUCT_VER_1_0 = 0;
|
Valid for system specification 1.01 - 4.0 |
SD SCR spec version value
SD_SCR_SPEC_VER_* SD_SCR_SPEC_VER_0 = 0;
|
Implements system specification 1.0 - 1.01 |
SD_SCR_SPEC_VER_1 = 1;
|
Implements system specification 1.10 |
SD_SCR_SPEC_VER_2 = 2;
|
Implements system specification 2.00-4.0X |
SD SCR security value
SD_SCR_SECURITY_* SD_SCR_SECURITY_VER_0 = 0;
|
No Security |
SD_SCR_SECURITY_VER_2 = 2;
|
SDSC Card (Security Version 1.01) |
SD_SCR_SECURITY_VER_3 = 3;
|
SDHC Card (Security Version 2.00) |
SD_SCR_SECURITY_VER_4 = 4;
|
SDXC Card (Security Version 3.xx) |
SD SCR bus width value
SD_SCR_BUS_WIDTH_* SD_SCR_BUS_WIDTH_1 = (1 shl 0);
|
1 bit (DAT0) |
SD_SCR_BUS_WIDTH_4 = (1 shl 2); {4 bit (DAT0-3)}
|
4 bit (DAT0-3) |
SD SCR extended security value
SD_SCR_EX_SECURITY_* SD_SCR_EX_SECURITY_VER_0 = 0;
|
Extended Security is not supported |
SD SCR command support value
SD_SCR_*_SUPPORT SD_SCR_CMD20_SUPPORT = (1 shl 0);
|
Mandatory for SDXC card |
SD_SCR_CMD23_SUPPORT = (1 shl 1);
|
Mandatory for UHS104 card |
SD_SCR_CMD48_49_SUPPORT = (1 shl 2);
|
Optional |
SD_SCR_CMD58_59_SUPPORT = (1 shl 3);
|
Optional (If CMD58/59 is supported, CMD48/49 shall be supported) |
SDIO device state
SDIO_STATE_* SDIO_STATE_DETACHED = 0;
|
|
SDIO_STATE_DETACHING = 1;
|
|
SDIO_STATE_ATTACHING = 2;
|
|
SDIO_STATE_ATTACHED = 3;
|
|
SDIO_STATE_MAX = 3;
|
|
SDIO_STATE_NAMES:array[SDIO_STATE_DETACHED..SDIO_STATE_MAX] of String = ('SDIO_STATE_DETACHED', 'SDIO_STATE_DETACHING', 'SDIO_STATE_ATTACHING', 'SDIO_STATE_ATTACHED');
|
|
SDIO device status
SDIO_STATUS_* SDIO_STATUS_UNBOUND = 0;
|
|
SDIO_STATUS_BOUND = 1;
|
|
SDIO_STATUS_MAX = 1;
|
|
SDIO_STATUS_NAMES:array[SDIO_STATUS_UNBOUND..SDIO_STATUS_MAX] of String = ('SDIO_STATUS_UNBOUND', 'SDIO_STATUS_BOUND');
|
|
SDIO command
SDIO_CMD_* | From: /include/linux/mmc/sdio.h | |
SDIO_CMD_SEND_OP_COND = 5;
|
|
SDIO_CMD_RW_DIRECT = 52;
|
|
SDIO_CMD_RW_EXTENDED = 53;
|
|
| SDIO_CMD_RW_DIRECT argument format: | |
[31] R/W flag
|
|
[30:28] Function number
|
|
[27] RAW flag
|
|
[25:9] Register address
|
|
[7:0] Data
|
|
| SDIO_CMD_RW_EXTENDED argument format: | |
[31] R/W flag
|
|
[30:28] Function number
|
|
[27] Block mode
|
|
[26] Increment address
|
|
[25:9] Register address
|
|
[8:0] Byte/block count
|
|
SDIO response value
SDIO_RSP_* | From: /include/linux/mmc/sdio.h | |
| R4 | |
SDIO_RSP_R4_18V_PRESENT = (1 shl 24);
|
|
SDIO_RSP_R4_MEMORY_PRESENT = (1 shl 27);
|
|
| R5 | |
SDIO_RSP_R5_COM_CRC_ERROR = (1 shl 15);
|
|
SDIO_RSP_R5_ILLEGAL_COMMAND = (1 shl 14);
|
|
SDIO_RSP_R5_ERROR = (1 shl 11);
|
|
SDIO_RSP_R5_FUNCTION_NUMBER = (1 shl 9);
|
|
SDIO_RSP_R5_OUT_OF_RANGE = (1 shl 8);
|
|
SDIO card common control registers (CCCR)
SDIO_CCCR_* SDIO_CCCR_CCCR = $00;
|
|
SDIO_CCCR_SD = $01;
|
|
SDIO_CCCR_IOEx = $02;
|
|
SDIO_CCCR_IORx = $03;
|
|
SDIO_CCCR_IENx = $04;
|
Function/Master Interrupt Enable |
SDIO_CCCR_INTx = $05;
|
Function Interrupt Pending |
SDIO_CCCR_ABORT = $06;
|
function abort/card reset |
SDIO_CCCR_IF = $07;
|
bus interface controls |
SDIO_CCCR_CAPS = $08;
|
|
SDIO_CCCR_CIS = $09;
|
common CIS pointer (3 bytes) |
| Following 4 regs are valid only if SBS is set | |
SDIO_CCCR_SUSPEND = $0c;
|
|
SDIO_CCCR_SELx = $0d;
|
|
SDIO_CCCR_EXECx = $0e;
|
|
SDIO_CCCR_READYx = $0f;
|
|
SDIO_CCCR_BLKSIZE = $10;
|
|
SDIO_CCCR_POWER = $12;
|
|
SDIO_CCCR_SPEED = $13;
|
|
SDIO_CCCR_UHS = $14;
|
|
SDIO_CCCR_DRIVE_STRENGTH = $15;
|
|
SDIO revision
SDIO_*_REV_* | SDIO CCCR Register values | |
SDIO_CCCR_REV_1_00 = 0;
|
CCCR/FBR Version 1.00 |
SDIO_CCCR_REV_1_10 = 1;
|
CCCR/FBR Version 1.10 |
SDIO_CCCR_REV_1_20 = 2;
|
CCCR/FBR Version 1.20 |
SDIO_CCCR_REV_3_00 = 3;
|
CCCR/FBR Version 3.00 |
SDIO_SDIO_REV_1_00 = 0;
|
SDIO Spec Version 1.00 |
SDIO_SDIO_REV_1_10 = 1;
|
SDIO Spec Version 1.10 |
SDIO_SDIO_REV_1_20 = 2;
|
SDIO Spec Version 1.20 |
SDIO_SDIO_REV_2_00 = 3;
|
SDIO Spec Version 2.00 |
SDIO_SDIO_REV_3_00 = 4;
|
SDIO Spec Version 3.00 |
| SDIO CCCR SD Register values | |
SDIO_SD_REV_1_01 = 0;
|
SD Physical Spec Version 1.01 |
SDIO_SD_REV_1_10 = 1;
|
SD Physical Spec Version 1.10 |
SDIO_SD_REV_2_00 = 2;
|
SD Physical Spec Version 2.00 |
SDIO_SD_REV_3_00 = 3;
|
SD Physical Spev Version 3.00 |
SDIO bus width
SDIO_BUS_* | SDIO CCCR IF Register values | |
SDIO_BUS_WIDTH_MASK = $03;
|
data bus width setting |
SDIO_BUS_WIDTH_1BIT = $00;
|
|
SDIO_BUS_WIDTH_RESERVED = $01;
|
|
SDIO_BUS_WIDTH_4BIT = $02;
|
|
SDIO_BUS_ECSI = $20;
|
Enable continuous SPI interrupt |
SDIO_BUS_SCSI = $40;
|
Support continuous SPI interrupt |
SDIO_BUS_ASYNC_INT = $20;
|
|
SDIO_BUS_CD_DISABLE = $80;
|
disable pull-up on DAT3 (pin 1) |
SDIO CCCR caps register value
SDIO_CCCR_CAP_* SDIO_CCCR_CAP_SDC = $01;
|
can do CMD52 while data transfer |
SDIO_CCCR_CAP_SMB = $02;
|
can do multi-block xfers (CMD53) |
SDIO_CCCR_CAP_SRW = $04;
|
supports read-wait protocol |
SDIO_CCCR_CAP_SBS = $08;
|
supports suspend/resume |
SDIO_CCCR_CAP_S4MI = $10;
|
interrupt during 4-bit CMD53 |
SDIO_CCCR_CAP_E4MI = $20;
|
enable ints during 4-bit CMD53 |
SDIO_CCCR_CAP_LSC = $40;
|
low speed card |
SDIO_CCCR_CAP_4BLS = $80;
|
4 bit low speed card |
SDIO CCCR power register value
SDIO_POWER_* SDIO_POWER_SMPC = $01;
|
Supports Master Power Control |
SDIO_POWER_EMPC = $02;
|
Enable Master Power Control |
SDIO CCCR speed register value
SDIO_SPEED_* SDIO_SPEED_SHS = $01;
|
Supports High-Speed mode |
SDIO_SPEED_BSS_SHIFT = 1;
|
|
SDIO_SPEED_BSS_MASK = (7 shl SDIO_SPEED_BSS_SHIFT);
|
|
SDIO_SPEED_SDR12 = (0 shl SDIO_SPEED_BSS_SHIFT);
|
|
SDIO_SPEED_SDR25 = (1 shl SDIO_SPEED_BSS_SHIFT);
|
|
SDIO_SPEED_SDR50 = (2 shl SDIO_SPEED_BSS_SHIFT);
|
|
SDIO_SPEED_SDR104 = (3 shl SDIO_SPEED_BSS_SHIFT);
|
|
SDIO_SPEED_DDR50 = (4 shl SDIO_SPEED_BSS_SHIFT);
|
|
SDIO_SPEED_EHS = SDIO_SPEED_SDR25;
|
Enable High-Speed |
SDIO CCCR UHS register value
SDIO_UHS_* SDIO_UHS_SDR50 = $01;
|
|
SDIO_UHS_SDR104 = $02;
|
|
SDIO_UHS_DDR50 = $04;
|
SDIO CCCR drive strength register value
SDIO_DRIVE_* SDIO_SDTx_MASK = $07;
|
|
SDIO_DRIVE_SDTA = (1 shl 0);
|
|
SDIO_DRIVE_SDTC = (1 shl 1);
|
|
SDIO_DRIVE_SDTD = (1 shl 2);
|
|
SDIO_DRIVE_DTSx_MASK = $03;
|
|
SDIO_DRIVE_DTSx_SHIFT = 4;
|
|
SDIO_DTSx_SET_TYPE_B = (0 shl SDIO_DRIVE_DTSx_SHIFT);
|
|
SDIO_DTSx_SET_TYPE_A = (1 shl SDIO_DRIVE_DTSx_SHIFT);
|
|
SDIO_DTSx_SET_TYPE_C = (2 shl SDIO_DRIVE_DTSx_SHIFT);
|
|
SDIO_DTSx_SET_TYPE_D = (3 shl SDIO_DRIVE_DTSx_SHIFT);
|
SDIO function basic register (FBR)
SDIO_FBR_* SDIO_FBR_BASE(f) ((f) * $100)
|
base of function f's FBRs |
SDIO_FBR_STD_IF = $00;
|
|
SDIO_FBR_STD_IF_EXT = $01;
|
|
SDIO_FBR_POWER = $02;
|
|
SDIO_FBR_CIS = $09;
|
CIS pointer (3 bytes) |
SDIO_FBR_CSA = $0C;
|
CSA pointer (3 bytes) |
SDIO_FBR_BLKSIZE = $10;
|
block size (2 bytes) |
| SDIO FBR IF Register values | |
SDIO_FBR_SUPPORTS_CSA = $40;
|
supports Code Storage Area |
SDIO_FBR_ENABLE_CSA = $80;
|
enable Code Storage Area |
| SDIO FBR POWER Register values | |
SDIO_FBR_POWER_SPS = $01;
|
Supports Power Selection |
SDIO_FBR_POWER_EPS = $02;
|
Enable (low) Power Selection |
SDIO function class
SDIO_CLASS_* SDIO_CLASS_NONE = $00;
|
Not a SDIO standard interface |
SDIO_CLASS_UART = $01;
|
standard UART interface |
SDIO_CLASS_BT_A = $02;
|
Type-A BlueTooth std interface |
SDIO_CLASS_BT_B = $03;
|
Type-B BlueTooth std interface |
SDIO_CLASS_GPS = $04;
|
GPS standard interface |
SDIO_CLASS_CAMERA = $05;
|
Camera standard interface |
SDIO_CLASS_PHS = $06;
|
PHS standard interface |
SDIO_CLASS_WLAN = $07;
|
WLAN interface |
SDIO_CLASS_ATA = $08;
|
Embedded SDIO-ATA std interface |
SDIO_CLASS_BT_AMP = $09;
|
Type-A Bluetooth AMP interface |
SDIO vendor
SDIO_VENDOR_* SDIO_VENDOR_ID_STE = $0020;
|
|
SDIO_VENDOR_ID_INTEL = $0089;
|
|
SDIO_VENDOR_ID_CGUYS = $0092;
|
|
SDIO_VENDOR_ID_TI = $0097;
|
|
SDIO_VENDOR_ID_ATHEROS = $0271;
|
|
SDIO_VENDOR_ID_BROADCOM = $02d0;
|
|
SDIO_VENDOR_ID_MARVELL = $02df;
|
|
SDIO_VENDOR_ID_MEDIATEK = $037a;
|
|
SDIO_VENDOR_ID_MICROCHIP_WILC = $0296;
|
|
SDIO_VENDOR_ID_SIANO = $039a;
|
|
SDIO_VENDOR_ID_RSI = $041b;
|
|
SDIO_VENDOR_ID_TI_WL1251 = $104c;
|
SDIO device
SDIO_DEVICE_* SDIO_DEVICE_ID_STE_CW1200 = $2280;
|
|
SDIO_DEVICE_ID_INTEL_IWMC3200WIMAX = $1402;
|
|
SDIO_DEVICE_ID_INTEL_IWMC3200WIFI = $1403;
|
|
SDIO_DEVICE_ID_INTEL_IWMC3200TOP = $1404;
|
|
SDIO_DEVICE_ID_INTEL_IWMC3200GPS = $1405;
|
|
SDIO_DEVICE_ID_INTEL_IWMC3200BT = $1406;
|
|
SDIO_DEVICE_ID_INTEL_IWMC3200WIMAX_2G5 = $1407;
|
|
SDIO_DEVICE_ID_CGUYS_EW_CG1102GC = $0004;
|
|
SDIO_DEVICE_ID_TI_WL1271 = $4076;
|
|
SDIO_DEVICE_ID_ATHEROS_AR6003_00 = $0300;
|
|
SDIO_DEVICE_ID_ATHEROS_AR6003_01 = $0301;
|
|
SDIO_DEVICE_ID_ATHEROS_AR6004_00 = $0400;
|
|
SDIO_DEVICE_ID_ATHEROS_AR6004_01 = $0401;
|
|
SDIO_DEVICE_ID_ATHEROS_AR6004_02 = $0402;
|
|
SDIO_DEVICE_ID_ATHEROS_AR6004_18 = $0418;
|
|
SDIO_DEVICE_ID_ATHEROS_AR6004_19 = $0419;
|
|
SDIO_DEVICE_ID_ATHEROS_AR6005 = $050A;
|
|
SDIO_DEVICE_ID_ATHEROS_QCA9377 = $0701;
|
|
SDIO_DEVICE_ID_BROADCOM_NINTENDO_WII = $044b;
|
|
SDIO_DEVICE_ID_BROADCOM_43241 = $4324;
|
|
SDIO_DEVICE_ID_BROADCOM_4329 = $4329;
|
|
SDIO_DEVICE_ID_BROADCOM_4330 = $4330;
|
|
SDIO_DEVICE_ID_BROADCOM_4334 = $4334;
|
|
SDIO_DEVICE_ID_BROADCOM_4335_4339 = $4335;
|
|
SDIO_DEVICE_ID_BROADCOM_4339 = $4339;
|
|
SDIO_DEVICE_ID_BROADCOM_4345 = $4345;
|
|
SDIO_DEVICE_ID_BROADCOM_4354 = $4354;
|
|
SDIO_DEVICE_ID_BROADCOM_CYPRESS_89359 = $4355;
|
|
SDIO_DEVICE_ID_BROADCOM_4356 = $4356;
|
|
SDIO_DEVICE_ID_BROADCOM_4359 = $4359;
|
|
SDIO_DEVICE_ID_BROADCOM_CYPRESS_4373 = $4373;
|
|
SDIO_DEVICE_ID_BROADCOM_CYPRESS_43012 = $a804;
|
|
SDIO_DEVICE_ID_BROADCOM_43143 = $a887;
|
|
SDIO_DEVICE_ID_BROADCOM_43340 = $a94c;
|
|
SDIO_DEVICE_ID_BROADCOM_43341 = $a94d;
|
|
SDIO_DEVICE_ID_BROADCOM_43362 = $a962;
|
|
SDIO_DEVICE_ID_BROADCOM_43364 = $a9a4;
|
|
SDIO_DEVICE_ID_BROADCOM_43430 = $a9a6;
|
|
SDIO_DEVICE_ID_BROADCOM_43455 = $a9bf;
|
|
SDIO_DEVICE_ID_MARVELL_LIBERTAS = $9103;
|
|
SDIO_DEVICE_ID_MARVELL_8688_WLAN = $9104;
|
|
SDIO_DEVICE_ID_MARVELL_8688_BT = $9105;
|
|
SDIO_DEVICE_ID_MARVELL_8786_WLAN = $9116;
|
|
SDIO_DEVICE_ID_MARVELL_8787_WLAN = $9119;
|
|
SDIO_DEVICE_ID_MARVELL_8787_BT = $911a;
|
|
SDIO_DEVICE_ID_MARVELL_8787_BT_AMP = $911b;
|
|
SDIO_DEVICE_ID_MARVELL_8797_F0 = $9128;
|
|
SDIO_DEVICE_ID_MARVELL_8797_WLAN = $9129;
|
|
SDIO_DEVICE_ID_MARVELL_8797_BT = $912a;
|
|
SDIO_DEVICE_ID_MARVELL_8897_WLAN = $912d;
|
|
SDIO_DEVICE_ID_MARVELL_8897_BT = $912e;
|
|
SDIO_DEVICE_ID_MARVELL_8887_F0 = $9134;
|
|
SDIO_DEVICE_ID_MARVELL_8887_WLAN = $9135;
|
|
SDIO_DEVICE_ID_MARVELL_8887_BT = $9136;
|
|
SDIO_DEVICE_ID_MARVELL_8801_WLAN = $9139;
|
|
SDIO_DEVICE_ID_MARVELL_8997_F0 = $9140;
|
|
SDIO_DEVICE_ID_MARVELL_8997_WLAN = $9141;
|
|
SDIO_DEVICE_ID_MARVELL_8997_BT = $9142;
|
|
SDIO_DEVICE_ID_MARVELL_8977_WLAN = $9145;
|
|
SDIO_DEVICE_ID_MARVELL_8977_BT = $9146;
|
|
SDIO_DEVICE_ID_MARVELL_8987_WLAN = $9149;
|
|
SDIO_DEVICE_ID_MARVELL_8987_BT = $914a;
|
|
SDIO_DEVICE_ID_MEDIATEK_MT7663 = $7663;
|
|
SDIO_DEVICE_ID_MEDIATEK_MT7668 = $7668;
|
|
SDIO_DEVICE_ID_MICROCHIP_WILC1000 = $5347;
|
|
SDIO_DEVICE_ID_SIANO_NOVA_B0 = $0201;
|
|
SDIO_DEVICE_ID_SIANO_NICE = $0202;
|
|
SDIO_DEVICE_ID_SIANO_VEGA_A0 = $0300;
|
|
SDIO_DEVICE_ID_SIANO_VENICE = $0301;
|
|
SDIO_DEVICE_ID_SIANO_MING = $0302;
|
|
SDIO_DEVICE_ID_SIANO_PELE = $0500;
|
|
SDIO_DEVICE_ID_SIANO_RIO = $0600;
|
|
SDIO_DEVICE_ID_SIANO_DENVER_2160 = $0700;
|
|
SDIO_DEVICE_ID_SIANO_DENVER_1530 = $0800;
|
|
SDIO_DEVICE_ID_SIANO_NOVA_A0 = $1100;
|
|
SDIO_DEVICE_ID_SIANO_STELLAR = $5347;
|
|
SDIO_DEVICE_ID_TI_WL1251 = $9066;
|
|
SDIO_MAX_FUNCTIONS = 7;
|
|
SDHCI specific constants
SDHCI_* SDHCI_NAME_PREFIX = 'SDHCI';
|
Name prefix for SDHCI Devices |
SDHCI host type
SDHCI_TYPE_* SDHCI_TYPE_NONE = 0;
|
|
SDHCI_TYPE_MMC = 1;
|
An MMC specification host controller |
SDHCI_TYPE_SD = 2;
|
An SD specification host controller |
SDHCI_TYPE_MMCI = 3;
|
An MMCI specification host controller |
SDHCI_TYPE_MAX = 3;
|
|
| SDHCI Type Names | |
SDHCI_TYPE_NAMES:array[SDHCI_TYPE_NONE..SDHCI_TYPE_MAX] of String = (
| |
'SDHCI_TYPE_NONE',
|
|
'SDHCI_TYPE_MMC',
|
|
'SDHCI_TYPE_SD',
|
|
'SDHCI_TYPE_MMCI');
|
|
SDHCI host state
SDHCI_STATE_* SDHCI_STATE_DISABLED = 0;
|
|
SDHCI_STATE_ENABLED = 1;
|
|
SDHCI_STATE_MAX = 1;
|
|
| SDHCI State Names | |
SDHCI_STATE_NAMES:array[SDHCI_STATE_DISABLED..SDHCI_STATE_MAX] of String = (
| |
'SDHCI_STATE_DISABLED',
|
|
'SDHCI_STATE_ENABLED');
|
|
SDHCI host flag
SDHCI_FLAG_* SDHCI_FLAG_NONE = $00000000;
|
|
SDHCI_FLAG_SDMA = $00000001;
|
Host Controller supports SDMA specification |
SDHCI_FLAG_ADMA = $00000002;
|
Host Controller supports ADMA specification |
SDHCI_FLAG_SPI = $00000004;
|
Host Controller uses SPI interface |
SDHCI_FLAG_CRC_ENABLE = $00000008;
|
|
SDHCI_FLAG_NON_STANDARD = $00000010;
|
Host Controller uses a non standard interface (not supporting SDHCI register layout) |
SDHCI_FLAG_AUTO_CMD12 = $00000020;
|
Host Controller supports Auto CMD12 (Stop Transmission) |
SDHCI_FLAG_AUTO_CMD23 = $00000040;
|
Host Controller supports Auto CMD23 (Set Block Count) |
SDHCI_FLAG_64_BIT_DMA = $00000080;
|
Host Controller supports 64-bit ADMA |
SDHCI_FLAG_EXTERNAL_DMA = $00000100;
|
Host Controller requires external DMA engine to perform transfers |
SDHCI_FLAG_BUS_ADDRESSES = $00000200;
|
Host Controller requires use of bus addresses for SDMA/ADMA transfers |
SDHCI controller register
SDHCI_DMA_*, SDHCI_BLOCK_* SDHCI_DMA_ADDRESS = $00;
|
|
SDHCI_ARGUMENT2 = SDHCI_DMA_ADDRESS;
|
|
SDHCI_32BIT_BLK_CNT = SDHCI_DMA_ADDRESS;
|
|
SDHCI_BLOCK_SIZE = $04;
|
|
SDHCI_BLOCK_COUNT = $06;
|
|
SDHCI_ARGUMENT = $08;
|
|
SDHCI_TRANSFER_MODE = $0C;
|
|
SDHCI_COMMAND = $0E;
|
|
SDHCI_RESPONSE = $10;
|
|
SDHCI_BUFFER = $20;
|
|
SDHCI_PRESENT_STATE = $24;
|
|
SDHCI_HOST_CONTROL = $28;
|
|
SDHCI_POWER_CONTROL = $29;
|
|
SDHCI_BLOCK_GAP_CONTROL = $2A;
|
|
SDHCI_WAKE_UP_CONTROL = $2B;
|
|
SDHCI_CLOCK_CONTROL = $2C;
|
|
SDHCI_TIMEOUT_CONTROL = $2E;
|
|
SDHCI_SOFTWARE_RESET = $2F;
|
|
SDHCI_INT_STATUS = $30;
|
|
SDHCI_INT_ENABLE = $34;
|
|
SDHCI_SIGNAL_ENABLE = $38;
|
|
SDHCI_AUTO_CMD_STATUS = $3C;
|
{SDHCI_ACMD12_ERR |
SDHCI_HOST_CONTROL2 = $3E;
|
|
SDHCI_CAPABILITIES = $40;
|
|
SDHCI_CAPABILITIES_1 = $44;
|
|
SDHCI_MAX_CURRENT = $48;
|
|
| 4C-4F reserved for more max current | |
SDHCI_SET_ACMD12_ERROR= $50;
|
|
SDHCI_SET_INT_ERROR = $52;
|
|
SDHCI_ADMA_ERROR = $54;
|
|
| 55-57 reserved | |
SDHCI_ADMA_ADDRESS = $58;
|
|
SDHCI_ADMA_ADDRESS_HI = $5C;
|
|
| 5D-65 reserved | |
SDHCI_PRESET_FOR_SDR12 = $66;
|
|
SDHCI_PRESET_FOR_SDR25 = $68;
|
|
SDHCI_PRESET_FOR_SDR50 = $6A;
|
|
SDHCI_PRESET_FOR_SDR104 = $6C;
|
|
SDHCI_PRESET_FOR_DDR50 = $6E;
|
|
| 6F-73 reserved | |
SDHCI_PRESET_FOR_HS400 = $74;
|
Non-standard |
| 75-FB reserved | |
SDHCI_SLOT_INT_STATUS = $FC;
|
|
SDHCI_HOST_VERSION = $FE;
|
|
SDHCI transfer mode
SDHCI_TRNS_* SDHCI_TRNS_DMA = $01;
|
|
SDHCI_TRNS_BLK_CNT_EN = $02;
|
|
SDHCI_TRNS_AUTO_CMD12 = $04;
|
SDHCI_TRNS_ACMD12 |
SDHCI_TRNS_AUTO_CMD23 = $08;
|
|
SDHCI_TRNS_AUTO_SEL = SDHCI_TRNS_AUTO_CMD12 or SDHCI_TRNS_AUTO_CMD23;
|
|
SDHCI_TRNS_READ = $10;
|
|
SDHCI_TRNS_MULTI = $20;
|
SDHCI command value
SDHCI_CMD_* SDHCI_CMD_RESP_MASK = $03;
|
|
SDHCI_CMD_CRC = $08;
|
|
SDHCI_CMD_INDEX = $10;
|
|
SDHCI_CMD_DATA = $20;
|
|
SDHCI_CMD_ABORTCMD = $C0;
|
SDHCI command response value
SDHCI_CMD_RESP_* SDHCI_CMD_RESP_NONE = $00;
|
|
SDHCI_CMD_RESP_LONG = $01;
|
|
SDHCI_CMD_RESP_SHORT = $02;
|
|
SDHCI_CMD_RESP_SHORT_BUSY = $03;
|
SDHCI present state value
SDHCI_DATA_*, SDHCI_CARD_* SDHCI_CMD_INHIBIT = $00000001;
|
|
SDHCI_DATA_INHIBIT = $00000002;
|
|
SDHCI_DOING_WRITE = $00000100;
|
|
SDHCI_DOING_READ = $00000200;
|
|
SDHCI_SPACE_AVAILABLE = $00000400;
|
|
SDHCI_DATA_AVAILABLE = $00000800;
|
|
SDHCI_CARD_PRESENT = $00010000;
|
|
SDHCI_CARD_STATE_STABLE = $00020000;
|
SDHCI_CD_STABLE |
SDHCI_CARD_DETECT_PIN_LEVEL = $00040000;
|
SDHCI_CD_LVL |
SDHCI_WRITE_PROTECT = $00080000;
|
Set if Write Enabled/Clear if Write Protected |
SDHCI_DATA_LEVEL_MASK = $00F00000;
|
SDHCI_DATA_LVL_MASK |
SDHCI_DATA_0_LEVEL_MASK = $00100000;
|
SDHCI_DATA_0_LVL_MASK |
SDHCI_CMD_LEVEL = $01000000;
|
SDHCI_CMD_LVL |
SDHCI host control value
SDHCI_CTRL_* SDHCI_CTRL_LED = $01;
|
|
SDHCI_CTRL_4BITBUS = $02;
|
|
SDHCI_CTRL_HISPD = $04;
|
|
SDHCI_CTRL_DMA_MASK = $18;
|
|
SDHCI_CTRL_SDMA = $00;
|
|
SDHCI_CTRL_ADMA1 = $08;
|
|
SDHCI_CTRL_ADMA32 = $10;
|
|
SDHCI_CTRL_ADMA64 = $18;
|
|
SDHCI_CTRL_ADMA3 = $18;
|
|
SDHCI_CTRL_8BITBUS = $20;
|
|
SDHCI_CTRL_CD_TEST_INS = $40;
|
|
SDHCI_CTRL_CD_TEST = $80;
|
SDHCI power control value
SDHCI_POWER_* SDHCI_POWER_ON = $01;
|
|
SDHCI_POWER_180 = $0A;
|
|
SDHCI_POWER_300 = $0C;
|
|
SDHCI_POWER_330 = $0E;
|
SDHCI wakeup control value
SDHCI_WAKE_* SDHCI_WAKE_ON_INT = $01;
|
|
SDHCI_WAKE_ON_INSERT = $02;
|
|
SDHCI_WAKE_ON_REMOVE = $04;
|
SDHCI clock control value
SDHCI_CLOCK_* SDHCI_DIVIDER_SHIFT = 8;
|
|
SDHCI_DIVIDER_HI_SHIFT = 6;
|
|
SDHCI_DIV_MASK = $FF;
|
|
SDHCI_DIV_MASK_LEN = 8;
|
|
SDHCI_DIV_HI_MASK = $0300;
|
|
SDHCI_PROG_CLOCK_MODE = $0020;
|
|
SDHCI_CLOCK_CARD_EN = $0004;
|
|
SDHCI_CLOCK_PLL_EN = $0008;
|
|
SDHCI_CLOCK_INT_STABLE = $0002;
|
|
SDHCI_CLOCK_INT_EN = $0001;
|
SDHCI software reset value
SDHCI_RESET_* SDHCI_RESET_ALL = $01;
|
|
SDHCI_RESET_CMD = $02;
|
|
SDHCI_RESET_DATA = $04;
|
SDHCI interrupt value
SDHCI_INT_* SDHCI_INT_RESPONSE = $00000001;
|
|
SDHCI_INT_DATA_END = $00000002;
|
|
SDHCI_INT_BLK_GAP = $00000004;
|
|
SDHCI_INT_DMA_END = $00000008;
|
|
SDHCI_INT_SPACE_AVAIL = $00000010;
|
|
SDHCI_INT_DATA_AVAIL = $00000020;
|
|
SDHCI_INT_CARD_INSERT = $00000040;
|
|
SDHCI_INT_CARD_REMOVE = $00000080;
|
|
SDHCI_INT_CARD_INT = $00000100;
|
|
SDHCI_INT_RETUNE = $00001000;
|
|
SDHCI_INT_CQE = $00004000;
|
|
SDHCI_INT_ERROR = $00008000;
|
|
SDHCI_INT_TIMEOUT = $00010000;
|
|
SDHCI_INT_CRC = $00020000;
|
|
SDHCI_INT_END_BIT = $00040000;
|
|
SDHCI_INT_INDEX = $00080000;
|
|
SDHCI_INT_DATA_TIMEOUT = $00100000;
|
|
SDHCI_INT_DATA_CRC = $00200000;
|
|
SDHCI_INT_DATA_END_BIT = $00400000;
|
|
SDHCI_INT_BUS_POWER = $00800000;
|
|
SDHCI_INT_AUTO_CMD_ERR= $01000000;
|
SDHCI_INT_ACMD12ERR |
SDHCI_INT_ADMA_ERROR = $02000000;
|
|
SDHCI_INT_NORMAL_MASK = $00007FFF;
|
|
SDHCI_INT_ERROR_MASK = $FFFF8000;
|
|
SDHCI_INT_CMD_MASK = (SDHCI_INT_RESPONSE or SDHCI_INT_TIMEOUT or SDHCI_INT_CRC or SDHCI_INT_END_BIT or SDHCI_INT_INDEX or SDHCI_INT_AUTO_CMD_ERR);
| |
SDHCI_INT_DATA_MASK = (SDHCI_INT_DATA_END or SDHCI_INT_DMA_END or SDHCI_INT_DATA_AVAIL or SDHCI_INT_SPACE_AVAIL or SDHCI_INT_DATA_TIMEOUT or SDHCI_INT_DATA_CRC or SDHCI_INT_DATA_END_BIT or SDHCI_INT_ADMA_ERROR or SDHCI_INT_BLK_GAP);
| |
SDHCI_INT_ALL_MASK = (LongWord(-1));
|
|
SDHCI_CQE_INT_ERR_MASK = (SDHCI_INT_ADMA_ERROR or SDHCI_INT_BUS_POWER or SDHCI_INT_DATA_END_BIT or SDHCI_INT_DATA_CRC or SDHCI_INT_DATA_TIMEOUT or SDHCI_INT_INDEX or SDHCI_INT_END_BIT or SDHCI_INT_CRC or SDHCI_INT_TIMEOUT);
|
|
SDHCI_CQE_INT_MASK = (SDHCI_CQE_INT_ERR_MASK or SDHCI_INT_CQE);
|
|
SDHCI auto CMD status value
SDHCI_AUTO_CMD_* SDHCI_AUTO_CMD_TIMEOUT = $00000002;
|
|
SDHCI_AUTO_CMD_CRC = $00000004;
|
|
SDHCI_AUTO_CMD_END_BIT = $00000008;
|
|
SDHCI_AUTO_CMD_INDEX = $00000010;
|
SDHCI host control 2 value
SDHCI_CTRL_* SDHCI_CTRL_UHS_MASK = $0007;
|
|
SDHCI_CTRL_UHS_SDR12 = $0000;
|
|
SDHCI_CTRL_UHS_SDR25 = $0001;
|
|
SDHCI_CTRL_UHS_SDR50 = $0002;
|
|
SDHCI_CTRL_UHS_SDR104 = $0003;
|
|
SDHCI_CTRL_UHS_DDR50 = $0004;
|
|
SDHCI_CTRL_HS400 = $0005;
|
Non-standard |
SDHCI_CTRL_VDD_180 = $0008;
|
|
SDHCI_CTRL_DRV_TYPE_MASK = $0030;
|
|
SDHCI_CTRL_DRV_TYPE_B = $0000;
|
|
SDHCI_CTRL_DRV_TYPE_A = $0010;
|
|
SDHCI_CTRL_DRV_TYPE_C = $0020;
|
|
SDHCI_CTRL_DRV_TYPE_D = $0030;
|
|
SDHCI_CTRL_EXEC_TUNING = $0040;
|
|
SDHCI_CTRL_TUNED_CLK = $0080;
|
|
SDHCI_CMD23_ENABLE = $0800;
|
|
SDHCI_CTRL_V4_MODE = $1000;
|
|
SDHCI_CTRL_64BIT_ADDR = $2000;
|
|
SDHCI_CTRL_PRESET_VAL_ENABLE = $8000;
|
SDHCI capabilities value
SDHCI_*_MASK*, SDHCI_*SHIFT SDHCI_TIMEOUT_CLK_MASK = $0000003F;
|
|
SDHCI_TIMEOUT_CLK_SHIFT = 0;
|
|
SDHCI_TIMEOUT_CLK_UNIT = $00000080;
|
|
SDHCI_CLOCK_BASE_MASK = $00003F00;
|
|
SDHCI_CLOCK_V3_BASE_MASK = $0000FF00;
|
|
SDHCI_CLOCK_BASE_SHIFT = 8;
|
|
SDHCI_CLOCK_BASE_MULTIPLIER = 1000000;
|
|
SDHCI_MAX_BLOCK_MASK = $00030000;
|
|
SDHCI_MAX_BLOCK_SHIFT = 16;
|
|
SDHCI_CAN_DO_8BIT = $00040000;
|
|
SDHCI_CAN_DO_ADMA2 = $00080000;
|
|
SDHCI_CAN_DO_ADMA1 = $00100000;
|
|
SDHCI_CAN_DO_HISPD = $00200000;
|
|
SDHCI_CAN_DO_SDMA = $00400000;
|
|
SDHCI_CAN_VDD_330 = $01000000;
|
|
SDHCI_CAN_VDD_300 = $02000000;
|
|
SDHCI_CAN_VDD_180 = $04000000;
|
|
SDHCI_CAN_64BIT_V4 = $08000000;
|
|
SDHCI_CAN_64BIT = $10000000;
|
SDHCI capabilities 1 value
SDHCI_SUPPORT_* SDHCI_SUPPORT_SDR50 = $00000001;
|
|
SDHCI_SUPPORT_SDR104 = $00000002;
|
|
SDHCI_SUPPORT_DDR50 = $00000004;
|
|
SDHCI_DRIVER_TYPE_A = $00000010;
|
|
SDHCI_DRIVER_TYPE_C = $00000020;
|
|
SDHCI_DRIVER_TYPE_D = $00000040;
|
|
SDHCI_RETUNING_TIMER_COUNT_MASK = $00000F00;
|
GENMASK(11,8) |
SDHCI_USE_SDR50_TUNING = $00002000;
|
|
SDHCI_RETUNING_MODE_MASK = $0000C000;
|
GENMASK(15,14) |
SDHCI_CLOCK_MUL_MASK = $00FF0000;
|
GENMASK(23,16) |
SDHCI_CAN_DO_ADMA3 = $08000000;
|
|
SDHCI_SUPPORT_HS400 = $80000000;
|
Non-standard |
SDHCI max current value
SDHCI_MAX_CURRENT_* SDHCI_MAX_CURRENT_LIMIT = $000000FF;
|
GENMASK(7,0) |
SDHCI_MAX_CURRENT_330_MASK = $000000FF;
|
GENMASK(7,0) |
SDHCI_MAX_CURRENT_300_MASK = $0000FF00;
|
GENMASK(15,8) |
SDHCI_MAX_CURRENT_180_MASK = $00FF0000;
|
GENMASK(23,16) |
SDHCI_MAX_CURRENT_MULTIPLIER = 4;
|
SDHCI preset value
SDHCI_PRESET_* SDHCI_PRESET_DRV_MASK = $0000C000;
|
GENMASK(15,14) |
SDHCI_PRESET_DRV_SHIFT = 14;
|
|
SDHCI_PRESET_CLKGEN_SEL = 1 shl 10;
|
BIT(10) |
SDHCI_PRESET_SDCLK_FREQ_MASK = $000003FF;
|
GENMASK(9,0) |
SDHCI host version value
SDHCI_*_VER_* SDHCI_VENDOR_VER_MASK = $FF00;
|
|
SDHCI_VENDOR_VER_SHIFT = 8;
|
|
SDHCI_SPEC_VER_MASK = $00FF;
|
|
SDHCI_SPEC_VER_SHIFT = 0;
|
|
SDHCI_SPEC_100 = 0;
|
|
SDHCI_SPEC_200 = 1;
|
|
SDHCI_SPEC_300 = 2;
|
|
SDHCI_SPEC_400 = 3;
|
|
SDHCI_SPEC_410 = 4;
|
|
SDHCI_SPEC_420 = 5;
|
SDHCI clock divider
SDHCI_MAX_CLOCK_DIV_* SDHCI_MAX_CLOCK_DIV_SPEC_200 = 256;
|
|
SDHCI_MAX_CLOCK_DIV_SPEC_300 = 2046;
|
SDHCI quirks/bug
SDHCI_QUIRK* | From Linux /include/linux/mmc/sdhci.h | |
SDHCI_QUIRK_CLOCK_BEFORE_RESET = (1 shl 0);
|
Controller doesn't honor resets unless we touch the clock register |
SDHCI_QUIRK_FORCE_DMA = (1 shl 1);
|
Controller has bad caps bits, but really supports DMA |
SDHCI_QUIRK_NO_CARD_NO_RESET = (1 shl 2);
|
Controller doesn't like to be reset when there is no card inserted |
SDHCI_QUIRK_SINGLE_POWER_WRITE = (1 shl 3);
|
Controller doesn't like clearing the power reg before a change |
SDHCI_QUIRK_RESET_CMD_DATA_ON_IOS = (1 shl 4);
|
Controller has flaky internal state so reset it on each ios change |
SDHCI_QUIRK_BROKEN_DMA = (1 shl 5);
|
Controller has an unusable DMA engine |
SDHCI_QUIRK_BROKEN_ADMA = (1 shl 6);
|
Controller has an unusable ADMA engine |
SDHCI_QUIRK_32BIT_DMA_ADDR = (1 shl 7);
|
Controller can only DMA from 32-bit aligned addresses |
SDHCI_QUIRK_32BIT_DMA_SIZE = (1 shl 8);
|
Controller can only DMA chunk sizes that are a multiple of 32 bits |
SDHCI_QUIRK_32BIT_ADMA_SIZE = (1 shl 9);
|
Controller can only ADMA chunks that are a multiple of 32 bits |
SDHCI_QUIRK_RESET_AFTER_REQUEST = (1 shl 10);
|
Controller needs to be reset after each request to stay stable |
SDHCI_QUIRK_NO_SIMULT_VDD_AND_POWER = (1 shl 11);
|
Controller needs voltage and power writes to happen separately |
SDHCI_QUIRK_BROKEN_TIMEOUT_VAL = (1 shl 12);
|
Controller provides an incorrect timeout value for transfers |
SDHCI_QUIRK_BROKEN_SMALL_PIO = (1 shl 13);
|
Controller has an issue with buffer bits for small transfers |
SDHCI_QUIRK_NO_BUSY_IRQ = (1 shl 14);
|
Controller does not provide transfer-complete interrupt when not busy |
SDHCI_QUIRK_BROKEN_CARD_DETECTION = (1 shl 15);
|
Controller has unreliable card detection |
SDHCI_QUIRK_INVERTED_WRITE_PROTECT = (1 shl 16);
|
Controller reports inverted write-protect state |
SDHCI_QUIRK_PIO_NEEDS_DELAY = (1 shl 18);
|
Controller does not like fast PIO transfers |
SDHCI_QUIRK_FORCE_BLK_SZ_2048 = (1 shl 20);
|
Controller has to be forced to use block size of 2048 bytes |
SDHCI_QUIRK_NO_MULTIBLOCK = (1 shl 21);
|
Controller cannot do multi-block transfers |
SDHCI_QUIRK_FORCE_1_BIT_DATA = (1 shl 22);
|
Controller can only handle 1-bit data transfers |
SDHCI_QUIRK_DELAY_AFTER_POWER = (1 shl 23);
|
Controller needs 10ms delay between applying power and clock |
SDHCI_QUIRK_DATA_TIMEOUT_USES_SDCLK = (1 shl 24);
|
Controller uses SDCLK instead of TMCLK for data timeouts |
SDHCI_QUIRK_CAP_CLOCK_BASE_BROKEN = (1 shl 25);
|
Controller reports wrong base clock capability |
SDHCI_QUIRK_NO_ENDATTR_IN_NOPDESC = (1 shl 26);
|
Controller cannot support End Attribute in NOP ADMA descriptor |
SDHCI_QUIRK_MISSING_CAPS = (1 shl 27);
|
Controller is missing device caps. Use caps provided by host |
SDHCI_QUIRK_MULTIBLOCK_READ_ACMD12 = (1 shl 28);
|
Controller uses Auto CMD12 command to stop the transfer |
SDHCI_QUIRK_NO_HISPD_BIT = (1 shl 29);
|
Controller doesn't have HISPD bit field in HI-SPEED SD card |
SDHCI_QUIRK_BROKEN_ADMA_ZEROLEN_DESC = (1 shl 30);
|
Controller treats ADMA descriptors with length 0000h incorrectly |
SDHCI_QUIRK_UNSTABLE_RO_DETECT = (1 shl 31);
|
The read-only detection via SDHCI_PRESENT_STATE register is unstable |
SDHCI_QUIRK2_HOST_OFF_CARD_ON = (1 shl 0);
|
|
SDHCI_QUIRK2_HOST_NO_CMD23 = (1 shl 1);
|
|
SDHCI_QUIRK2_NO_1_8_V = (1 shl 2);
|
The system physically doesn't support 1.8v, even if the host does |
SDHCI_QUIRK2_PRESET_VALUE_BROKEN = (1 shl 3);
|
|
SDHCI_QUIRK2_CARD_ON_NEEDS_BUS_ON = (1 shl 4);
|
|
SDHCI_QUIRK2_BROKEN_HOST_CONTROL = (1 shl 5);
|
Controller has a non-standard host control register |
SDHCI_QUIRK2_BROKEN_HS200 = (1 shl 6);
|
Controller does not support HS200 |
SDHCI_QUIRK2_BROKEN_DDR50 = (1 shl 7);
|
Controller does not support DDR50 |
SDHCI_QUIRK2_STOP_WITH_TC = (1 shl 8);
|
Stop command(CMD12) can set Transfer Complete when not using MMC_RSP_BUSY |
SDHCI_QUIRK2_BROKEN_64_BIT_DMA = (1 shl 9);
|
Controller does not support 64-bit DMA |
SDHCI_QUIRK2_CLEAR_TRANSFERMODE_REG_BEFORE_CMD = (1 shl 10);
|
Need clear transfer mode register before send cmd |
SDHCI_QUIRK2_CAPS_BIT63_FOR_HS400 = (1 shl 11);
|
Capability register bit-63 indicates HS400 support |
SDHCI_QUIRK2_TUNING_WORK_AROUND = (1 shl 12);
|
Forced tuned clock |
SDHCI_QUIRK2_SUPPORT_SINGLE = (1 shl 13);
|
Disable the block count for single block transactions |
SDHCI_QUIRK2_ACMD23_BROKEN = (1 shl 14);
|
Controller broken with using ACMD23 |
SDHCI_QUIRK2_CLOCK_DIV_ZERO_BROKEN = (1 shl 15);
|
Broken Clock divider zero in controller |
SDHCI_QUIRK2_RSP_136_HAS_CRC = (1 shl 16);
|
Controller has CRC in 136 bit Command Response |
SDHCI_QUIRK2_DISABLE_HW_TIMEOUT = (1 shl 17);
|
Disable HW timeout if the requested timeout is more than the maximum obtainable timeout |
SDHCI_QUIRK2_USE_32BIT_BLK_CNT = (1 shl 18);
|
32-bit block count may not support eMMC where upper bits of CMD23 are used for other purposes. Support 16-bit block count by default otherwise, SDHCI_QUIRK2_USE_32BIT_BLK_CNT can be selected to use 32-bit block count |
SDHCI host SDMA buffer boundary
SDHCI_DEFAULT_BOUNDARY_* | Valid values from 4K to 512K in powers of 2 | |
SDHCI_DEFAULT_BOUNDARY_SIZE = (512 * 1024);
|
Default to 512K boundary |
SDHCI_DEFAULT_BOUNDARY_ARG = 7;
|
(ilog2(SDHCI_DEFAULT_BOUNDARY_SIZE) - 12) |
SDHCI ADMA2 32-bit DMA descriptor size
SDHCI_ADMA2_32_DESC_SIZE* SDHCI_ADMA2_32_DESC_SIZE = 8;
|
SDHCI ADMA2 data alignment
SDHCI_ADMA2_ALIGN* SDHCI_ADMA2_ALIGN = 4;
|
|
SDHCI_ADMA2_MASK = (SDHCI_ADMA2_ALIGN - 1);
|
SDHCI ADMA2 descriptor alignment
SDHCI_ADMA2_DESC_ALIGN* SDHCI_ADMA2_DESC_ALIGN = 8;
|
SDHCI ADMA2 64-bit DMA descriptor size
SDHCI_ADMA2_64_DESC_SIZE* SDHCI_ADMA2_64_DESC_SIZE = 12;
|
|
SDHCI_ADMA2_64_DESC_V4_SIZE = 16;
|
Use 128-bit descriptor, if Host Version 4 Enable is set in the Host Control 2 register |
SDHCI ADMA2 descriptor attributes
SDHCI_ADMA2_DESC_ATTR_* SDHCI_ADMA2_DESC_ATTR_VALID = $01;
|
|
SDHCI_ADMA2_DESC_ATTR_END = $02;
|
|
SDHCI_ADMA2_DESC_ATTR_INT = $04;
|
|
SDHCI_ADMA2_DESC_ATTR_NOP = $00;
|
|
SDHCI_ADMA2_DESC_ATTR_TRAN = $20;
|
|
SDHCI_ADMA2_DESC_ATTR_LINK = $30;
|
|
SDHCI_ADMA2_DESC_TRAN_VALID = SDHCI_ADMA2_DESC_ATTR_TRAN or SDHCI_ADMA2_DESC_ATTR_VALID;
|
0x21 |
SDHCI_ADMA2_DESC_NOP_END_VALID = SDHCI_ADMA2_DESC_ATTR_NOP or SDHCI_ADMA2_DESC_ATTR_END or SDHCI_ADMA2_DESC_ATTR_VALID;
|
0x3 |
SDHCI_ADMA2_DESC_END = SDHCI_ADMA2_DESC_ATTR_END;
|
0x2 |
SDHCI maximum segments
SDHCI_MAX_SEGS* | Assuming a 512KB maximum request size and a minimum 4KB page size | |
SDHCI_MAX_SEGS = 128;
|
|
SDHCI timeout value
SDHCI_TIMEOUT_VALUE* SDHCI_TIMEOUT_VALUE = $0E;
|
Type definitions
MMC command
PMMCCommand = ^TMMCCommand;
TMMCCommand = record
| Command Properties | |
Command:Word;
|
|
Argument:LongWord;
|
|
ResponseType:LongWord;
|
|
Response:array[0..3] of LongWord;
|
|
Status:LongWord;
|
|
Data:PMMCData;
|
|
| Host Properties | |
Timeout:LongWord;
|
Milliseconds |
DataCompleted:Boolean;
|
|
BusyCompleted:Boolean;
|
|
TuningCompleted:Boolean;
|
|
CommandCompleted:Boolean;
|
|
MMC data
PMMCData = ^TMMCData;
TMMCData = record
| Data Properties | |
Data:Pointer;
|
|
Flags:LongWord;
|
|
BlockSize:LongWord;
|
|
BlockCount:LongWord;
|
|
| Host Properties | |
BlockOffset:LongWord;
|
|
BlocksRemaining:LongWord;
|
|
BytesRemaining:LongWord;
|
|
BytesTransfered:LongWord;
|
|
MMC card identification data (CID)
PMMCCardIdentificationData = ^TMMCCardIdentificationData;
TMMCCardIdentificationData = record
| Note: See: Section 5.2 of SD Physical Layer Simplified Specification Version 4.10 | |
ManufacturerId:Byte;
|
|
OEMId:Word;
|
|
ProductName:array[0..7] of Char;
|
Max 0 to 6, 1 extra for null terminator |
ProductRevision:Byte;
|
|
HardwareRevision:Byte;
|
|
FirmwareRevision:Byte;
|
|
ProductSerialNumber:LongWord;
|
|
ManufacturingMonth:Byte;
|
|
ManufacturingYear:Word;
|
|
CRC:Byte;
|
CRC7 checksum |
MMC card specific erase data (CSD)
TMMCCardSpecificSDEraseData = record
| Note: See: Section 5.3 of SD Physical Layer Simplified Specification Version 4.10 (Defined here for CSD) | |
EraseBlockEnable:Boolean;
|
Erase single block enable |
SectorSize:Byte;
|
Erase sector size |
MMC card specific MMC22 erase data
TMMCCardSpecificMMC22EraseData = record
SectorSize:Byte;
|
Erase sector size |
EraseGroupSize:Byte;
|
Erase group size |
MMC card specific MMC31 erase data
TMMCCardSpecificMMC31EraseData = record
EraseGroupSize:Byte;
|
Erase group size |
EraseGroupMultiplier:Byte;
|
Erase group size multiplier |
MMC card specific erase data
TMMCCardSpecificEraseData = record
case Integer of
|
|
0:(MMC22:TMMCCardSpecificMMC22EraseData);
|
|
1:(MMC31:TMMCCardSpecificMMC31EraseData);
|
|
2:(SD:TMMCCardSpecificSDEraseData);
|
MMC card specific data
PMMCCardSpecificData = ^TMMCCardSpecificData;
TMMCCardSpecificData = record
| Card Values | |
CSDStructure:Byte;
|
CSD structure version |
SpecVersion:Byte;
|
System specification version (MMC/eMMC Only) |
TAAC:Byte;
|
Data read access-time-1 |
NSAC:Byte;
|
Data read access-time-2 in CLK cycles (NSAC*100) |
TransferSpeed:Byte;
|
Max. data transfer rate |
CCC:Word;
|
Card command classes |
ReadBlockLength:Byte;
|
Max. read data block length |
ReadBlockPartial:Boolean;
|
Partial blocks for read allowed |
WriteBlockMisalign:Boolean;
|
Write block misalignment |
ReadBlockMisalign:Boolean;
|
Read block misalignment |
DSRImplemented:Boolean;
|
DSR implemented |
DeviceSize:Word;
|
Device size |
VDDReadCurrentMin:Byte;
|
Max. read current @VDD min |
VDDReadCurrentMax:Byte;
|
Max. read current @VDD max |
VDDWriteCurrentMin:Byte;
|
Max. write current @VDD min |
VDDWriteCurrentMax:Byte;
|
Max. write current @VDD max |
DeviceSizeMultiplier:Byte;
|
Device size multiplier |
Erase:TMMCCardSpecificEraseData;
|
Erase group details |
WriteProtectGroupSize:Byte;
|
Write protect group size |
WriteProtectGroupEnable:Boolean;
|
Write protect group enable |
DefaultECC:Byte;
|
Manufacturer default ECC (MMC/eMMC Only) |
ReadToWriteFactor:Byte;
|
Write speed factor |
WriteBlockLength:Byte;
|
Max. write data block length |
WriteBlockPartial:Boolean;
|
Partial blocks for write allowed |
ContentProtectApplication:Boolean;
|
Content protection application (MMC/eMMC Only) |
FileFormatGroup:Byte;
|
File format group |
CopyFlag:Boolean;
|
Copy flag |
PermanentWriteProtect:Boolean;
|
Permanent write protection |
TemporaryWriteProtect:Boolean;
|
Temporary write protection |
FileFormat:Byte;
|
File format |
ECC:Byte;
|
ECC code (MMC/eMMC Only) |
CRC:Byte;
|
CRC |
| Calculated Values | |
DataAccessTime:LongWord;
|
In Nanoseconds |
DataAccessClocks:Word;
|
In Clock cycles |
DataTransferRate:LongWord;
|
In Hz |
EraseSize:LongWord;
|
In Sectors |
BlockSize:LongWord;
|
"Normalized" Block Size |
BlockCount:LongWord;
|
In "Normalized" Blocks |
BlockShift:LongWord;
|
"Normalized" Block Shift |
MMC extended card specific data
PMMCExtendedCardSpecificData = ^TMMCExtendedCardSpecificData;
TMMCExtendedCardSpecificData = record
| Card Values | |
Revision:Byte;
|
Extended CSD revision (192) |
CacheControl:Byte;
|
Control to turn the Cache ON/OFF (33) |
PowerOffNotification:Byte;
|
Power Off Notification (34) |
PartitionSupport:Byte;
|
Partitioning Support (160) |
HardwareResetFunction:Byte;
|
H/W reset function (162]) |
WriteReliabilityParameter:Byte;
|
Write reliability parameter register (166]) |
RPMBSizeMult:Byte;
|
RPMB Size Multiplier (168) |
EraseGroupDef:Byte;
|
High-density erase group definition (175) |
PartConfig:Byte;
|
Partition configuration (179) |
ErasedMemoryContent:Byte;
|
Erased memory content (181) |
StrobeSupport:Byte;
|
Strobe Support (184) |
CSDStructure:Byte;
|
CSD STRUCTURE (194) |
CardType:Byte;
|
Device type (196) |
DriverStrength:Byte;
|
I/O Driver Strength (197) |
OutOfInterruptTime:Byte;
|
Out-of-interrupt busy timing (198) |
SectorCount:array[0..3] of Byte;
|
Sector Count (212)(4 bytes) |
SATimeout:Byte;
|
Sleep/awake timeout (217) |
HCEraseGapSize:Byte;
|
High-capacity write protect group size (221) |
ReliableSectors:Byte;
|
Reliable write sector count (222) |
EraseTimeoutMult:Byte;
|
High-capacity erase timeout (223) |
HCEraseGrpSize:Byte;
|
High-capacity erase unit size (224) |
SecTRIMMult:Byte;
|
Secure TRIM Multiplier (229) |
SecEraseMult:Byte;
|
Secure Erase Multiplier (230) |
SecFeatureSupport:Byte;
|
Secure Feature support (231) |
TRIMMult:Byte;
|
TRIM Multiplier (232) |
PowerClass52MHz195:Byte;
|
Power class for 52 MHz at 1.95 V (200) |
PowerClass26MHz195:Byte;
|
Power class for 26 MHz at 1.95 V (201) |
PowerClass52MHz360:Byte;
|
Power class for 52 MHz at 3.6 V (202) |
PowerClass26MHz360:Byte;
|
Power class for 26 MHz at 3.6 V (203) |
PowerClass200MHz195:Byte;
|
Power class for 200MHz, at VCCQ = 1.3V, VCC = 3.6V (236) |
PowerClass200MHz360:Byte;
|
Power class for 200MHz at VCCQ = 1.95V, VCC = 3.6V (237) |
PowerClassDDR52MHz195:Byte;
|
Power class for 52MHz, DDR at VCC = 1.95V (238) |
PowerClassDDR52MHz360:Byte;
|
Power class for 52MHz, DDR at VCC = 3.6V (239) |
PowerClassDDR200MHz360:Byte;
|
Power class for 200MHz, DDR at VCC = 3.6V (253) |
BKOPSStatus:Byte;
|
Background operations status (246) |
FirmwareVersion:array[0..MMC_FIRMWARE_VERSION_LEN - 1] of Byte;
|
(254) (8 bytes) |
PreEndOfLifeInfo:Byte;
|
Pre EOL information (267) |
DeviceLifetimeEstimateA:Byte;
|
Device life time estimation type A (268) |
DeviceLifetimeEstimateB:Byte;
|
Device life time estimation type B (269) |
MaxPackedWrites:Byte;
|
Max packed write commands (500) |
| Calculated Values | |
Sectors:LongWord;
|
|
SleepAwakeTime:LongWord;
|
100ns units |
PartitionSwitchTime:LongWord;
|
ms |
GenericCMD6Time:LongWord;
|
10ms units |
PowerOffLongTime:LongWord;
|
ms |
HCEraseSize:LongWord;
|
Sectors |
HCEraseTimeout:LongWord;
|
Milliseconds |
DataSectorSize:LongWord;
|
512 bytes or 4KB |
DataTagUnitSize:LongWord;
|
|
HSMaxRate:LongWord;
|
Hz |
HS200MaxRate:LongWord;
|
Hz |
AvailableTypes:LongWord;
|
|
BootPartitionSize:UInt64;
|
Bytes |
EnhancedAreaOffset:UInt64;
|
Bytes |
EnhancedAreaSize:UInt64;
|
KB |
CacheSize:LongWord;
|
KB |
PartitionSettingCompleted:Boolean;
|
Enable Bit |
TRIMTimeout:LongWord;
|
Milliseconds |
PartitionSizes:array[0..MMC_NUM_GP_PARTITION - 1] of UInt64;
|
Bytes |
BootReadOnlySupport:LongWord;
|
Read Only Lock Support |
BootReadOnlyLockable:Boolean;
|
|
FieldFirmwareUpdate:Boolean;
|
Firmware upgrade support |
CommandQueueSupport:Boolean;
|
Command Queue supported |
CommandQueueDepth:LongWord;
|
Command Queue depth |
BackgroundOperations:Boolean;
|
BKOPS Supported |
ManualBKOPSEnable:Boolean;
|
Manual BKOPS Supported |
AutoBKOPSEnable:Boolean;
|
Auto BKOPS Supported |
HPI:Boolean;
|
HPI (High Priority Interrupt) Supported |
HPIEnable:Boolean;
|
HPI Enabled |
HPICommand:LongWord;
|
CMD used as HPI |
RPMBSize:UInt64;
|
Bytes |
EnhancedRPMBSupport:Boolean;
|
|
ErasedByte:Byte;
|
Value after Erase |
FeatureSupport:LongWord;
|
Version specific features (eg MMC_DISCARD_FEATURE) |
SD status data (SSR)
PSDStatusData = ^TSDStatusData;
TSDStatusData = record
| Note: See: Section 4.10.2 of SD Physical Layer Simplified Specification Version 4.10 (Defined here for MMC Device) | |
| Card Values | |
BusWidth:Byte;
|
Shows the currently defined data bus width that was defined by SET_BUS_WIDTH command |
SecuredMode:Boolean;
|
Card is in Secured Mode of operation (refer to the "Part 3 Security Specification") |
CardType:Word;
|
In the future, the 8 LSBs will be used to define different variations of an SD Memory Card (Each bit will define different SD Types). The 8 MSBs will be used to define SD Cards that do not comply with the Physical Layer Specification |
ProtectedSize:LongWord;
|
Size of protected area |
SpeedClass:Byte;
|
Speed Class of the card |
PerformanceMove:Byte;
|
Performance of move indicated by 1 [MB/s] step |
EraseSize:Word;
|
Number of AUs to be erased at a time |
EraseTimeout:Byte;
|
Timeout value for erasing areas specified by UNIT_OF_ERASE_AU |
EraseOffset:Byte;
|
Fixed offset value added to erase time |
UHSSpeedGrade:Byte;
|
Speed Grade for UHS mode |
| Calculated Values | |
AllocationUnitSize:Byte;
|
Size of Allocation Unit |
UHSAllocationUnitSize:Byte;
|
Size of Allocation Unit for UHS mode |
SD switch data
PSDSwitchData = ^TSDSwitchData;
TSDSwitchData = record
| Note: See: Section 4.3.10 of SD Physical Layer Simplified Specification Version 4.10 | |
| Card Values | |
MaximumCurrent:Word;
|
Maximum Current/Power Consumption |
Group6Support:Word;
|
Support Bits of Functions in Function Group 6 |
Group5Support:Word;
|
Support Bits of Functions in Function Group 5 |
Group4Support:Word;
|
Support Bits of Functions in Function Group 4 |
Group3Support:Word;
|
Support Bits of Functions in Function Group 3 |
Group2Support:Word;
|
Support Bits of Functions in Function Group 2 |
Group1Support:Word;
|
Support Bits of Functions in Function Group 1 |
Group6Selection:Byte;
|
Function Selection of Function Group 6 |
Group5Selection:Byte;
|
Function Selection of Function Group 5 |
Group4Selection:Byte;
|
Function Selection of Function Group 4 |
Group3Selection:Byte;
|
Function Selection of Function Group 3 |
Group2Selection:Byte;
|
Function Selection of Function Group 2 |
Group1Selection:Byte;
|
Function Selection of Function Group 1 |
StructureVersion:Byte;
|
Data Structure Version |
Group6BusyStatus:Word;
|
Busy Status of functions in group 6 |
Group5BusyStatus:Word;
|
Busy Status of functions in group 5 |
Group4BusyStatus:Word;
|
Busy Status of functions in group 4 |
Group3BusyStatus:Word;
|
Busy Status of functions in group 3 |
Group2BusyStatus:Word;
|
Busy Status of functions in group 2 |
Group1BusyStatus:Word;
|
Busy Status of functions in group 1 |
SD configuration data (SCR)
PSDConfigurationData = ^TSDConfigurationData;
TSDConfigurationData = record
| Note: See: Section 5.6 of SD Physical Layer Simplified Specification Version 4.10 (Defined here for MMC Device) | |
| Card Values | |
SCRStructure:Byte;
|
SCR Structure version |
SpecVersion:Byte;
|
SD Memory Card - Spec. Version |
DataAfterErase:Byte;
|
Data status after erases |
Security:Byte;
|
CPRM Security Support |
SpecVersion3:Boolean;
|
Spec. Version 3.00 or higher |
ExtendedSecurity:Byte;
|
Extended Security Support |
SpecVersion4:Boolean;
|
Spec. Version 4.00 or higher |
CommandSupport:Byte;
|
Command Support bits |
| Calculated Values | |
ErasedByte:Byte;
|
Value after Erase |
MMC enumeration callback
TMMCEnumerate = function(MMC:PMMCDevice; Data:Pointer):LongWord;
|
MMC notification callback
TMMCNotification = function(Device:PDevice; Data:Pointer; Notification:LongWord):LongWord;
|
MMC device initialize
TMMCDeviceInitialize = function(MMC:PMMCDevice):LongWord;
|
MMC device deinitialize
TMMCDeviceDeinitialize = function(MMC:PMMCDevice):LongWord;
|
MMC device get card detect
TMMCDeviceGetCardDetect = function(MMC:PMMCDevice):LongWord;
|
MMC device get write protect
TMMCDeviceGetWriteProtect = function(MMC:PMMCDevice):LongWord;
|
MMC device send command
TMMCDeviceSendCommand = function(MMC:PMMCDevice; Command:PMMCCommand):LongWord;
|
MMC device set IOS
TMMCDeviceSetIOS = function(MMC:PMMCDevice):LongWord;
|
MMC device types
PMMCDevice = ^TMMCDevice;
TMMCDevice = record
| Device Properties | |
Device:TDevice;
|
The Device entry for this MMC |
| MMC Properties | |
MMCId:LongWord;
|
Unique Id of this MMC in the MMC table |
MMCState:LongWord;
|
MMC state (eg MMC_STATE_INSERTED) |
DeviceInitialize:TMMCDeviceInitialize;
|
A Device specific DeviceInitialize method implementing a standard MMC device interface (Or nil if the default method is suitable) |
DeviceDeinitialize:TMMCDeviceDeinitialize;
|
A Device specific DeviceDeinitialize method implementing a standard MMC device interface (Or nil if the default method is suitable) |
DeviceGetCardDetect:TMMCDeviceGetCardDetect;
|
A Device specific DeviceGetCardDetect method implementing a standard MMC device interface (Or nil if the default method is suitable) |
DeviceGetWriteProtect:TMMCDeviceGetWriteProtect;
|
A Device specific DeviceGetWriteProtect method implementing a standard MMC device interface (Or nil if the default method is suitable) |
DeviceSendCommand:TMMCDeviceSendCommand;
|
A Device specific DeviceSendCommand method implementing a standard MMC device interface (Or nil if the default method is suitable) |
DeviceSetIOS:TMMCDeviceSetIOS;
|
A Device specific DeviceSetIOS method implementing a standard MMC device interface (Or nil if the default method is suitable) |
| Statistics Properties | |
CommandCount:LongWord;
|
|
CommandErrors:LongWord;
|
|
| Driver Properties | |
Lock:TMutexHandle;
|
Device lock |
Version:LongWord;
|
|
Clock:LongWord;
|
|
Timing:LongWord;
|
|
BusWidth:LongWord;
|
|
DriverType:LongWord;
|
|
SignalVoltage:LongWord;
|
|
Voltages:LongWord;
|
|
Capabilities:LongWord;
|
|
Capabilities2:LongWord;
|
|
EraseSize:LongWord;
|
Erase Size in Sectors |
EraseShift:LongWord;
|
|
EraseArgument:LongWord;
|
|
PreferredEraseSize:LongWord;
|
Preferred Erase Size in Sectors |
nhancedStrobe:LongBool;
|
|
| Register Properties | |
| See: Table 3-2: SD Memory Card Registers of SD Physical Layer Simplified Specification Version 4.10 | |
InterfaceCondition:LongWord;
|
Interface Condition Result |
OperationCondition:LongWord;
|
Operation Condition Register (OCR) See: Section 5.1 of SD Physical Layer Simplified Specification Version 4.10 |
RelativeCardAddress:LongWord;
|
Relative Card Address (RCA) (Word) See: Section 5.4 of SD Physical Layer Simplified Specification Version 4.10 |
CardSpecific:array[0..3] of LongWord;
|
Card Specific Data (CSD) See: Section 5.3 of SD Physical Layer Simplified Specification Version 4.10 |
CardIdentification:array[0..3] of LongWord;
|
Card Identification Data (CID) See: Section 5.2 of SD Physical Layer Simplified Specification Version 4.10 |
ExtendedCardSpecific:PByte;
|
Extended Card Specific Data (EXTCSD) See: Section 7.4 of Embedded Multi-Media Card (eMMC) Electrical Standard 5.1 |
CardStatus:LongWord;
|
Card Status Register (CSR) See: Section 4.10.1 of SD Physical Layer Simplified Specification Version 4.10 |
DriverStage:LongWord;
|
Driver Stage Register (DSR) (Word) See: Section 5.5 of SD Physical Layer Simplified Specification Version 4.10 |
SDStatus:array[0..15] of LongWord;
|
SD Status Register (SSR) See: Section 4.10.2 of SD Physical Layer Simplified Specification Version 4.10 |
SDSwitch:array[0..15] of LongWord;
|
SD Switch Status See: Section 4.3.10 of SD Physical Layer Simplified Specification Version 4.10 |
SDConfiguration:array[0..3] of LongWord;
|
SD Configuration Register (SCR) See: Section 5.6 of SD Physical Layer Simplified Specification Version 4.10 |
| Configuration Properties | |
| Note: 16 bytes instead of 8 to allow correct operation of MMCExtractBits, offset handled by SDDeviceSendSDConfiguration. | |
CardSpecificData:TMMCCardSpecificData;
|
|
CardIdentificationData:TMMCCardIdentificationData;
|
|
ExtendedCardSpecificData:TMMCExtendedCardSpecificData;
|
|
SDStatusData:TSDStatusData;
|
|
SDSwitchData:TSDSwitchData;
|
|
SDConfigurationData:TSDConfigurationData;
|
|
| Storage Properties | |
Storage:PStorageDevice;
|
The Storage entry for this MMC (Where Applicable) |
| Internal Properties | |
Prev:PMMCDevice;
|
Previous entry in MMC table |
Next:PMMCDevice;
|
Next entry in MMC table |
SDIO driver
PSDIODriver = ^TSDIODriver;
TSDIODriver = record
| Driver Properties | |
Driver:TDriver;
|
The Driver entry for this SDIO Driver |
| SDIO Properties | |
DriverBind:TSDIODriverBind;
|
A Driver specific DriverBind method implementing the standard SDIO driver interface |
DriverUnbind:TSDIODriverUnbind;
|
A Driver specific DriverUnbind method implementing the standard SDIO driver interface |
| Interface Properties | |
Lock:TMutexHandle;
|
Driver lock |
| Internal Properties | |
Prev:PSDIODriver;
|
Previous entry in Driver table |
Next:PSDIODriver;
|
Next entry in Driver table |
SDIO function
FSDIOFunction = ^TSDIOFunction;
TSDIOFunction = record
| Function Properties | |
Number:LongWord;
|
The function number |
ClassId:Byte;
|
Standard class Id |
VendorId:Word;
|
Vendor Id |
DeviceId:Word;
|
Device Id |
SDIO driver enumeration callback
TSDIODriverEnumerate = function(Driver:PSDIODriver;Data:Pointer):LongWord;
|
SDIO driver bind callback
TSDIODriverBind = function(Device:PSDIODevice):LongWord;
|
SDIO driver unbind callback
TSDIODriverUnbind = function(Device:PSDIODevice):LongWord;
|
SDIO device
PSDIODevice = ^TSDIODevice;
TSDIODevice = record
| MMC Properties | |
MMC:TMMCDevice;
|
The MMC device entry for this SDIO device |
| SDIO Properties | |
SDIOState:LongWord;
|
SDIO device state (eg SDIO_STATE_ATTACHED) |
SDIOStatus:LongWord;
|
SDIO device status (eg SDIO_STATUS_BOUND) |
Host:PDevice;
|
Host controller this SDIO device is connected to |
Driver:PSDIODriver;
|
Driver this SDIO device is bound to, if any. |
SDIO device bind callback
TSDIODeviceBind = function(Device:PSDIODevice):LongWord;
|
SDIO device unbind callback
TSDIODeviceUnbind = function(Device:PSDIODevice; Driver:PSDIODriver):LongWord;
|
SDIO device enumeration callback
TSDIODeviceEnumerate = function(Device:PSDIODevice; Data:Pointer):LongWord;
|
SDIO device notification callback
TSDIODeviceNotification = function(Device:PDevice; Data:Pointer; Notification:LongWord):LongWord;
|
SDHCI enumeration callback
TSDHCIEnumerate = function(SDHCI:PSDHCIHost; Data:Pointer):LongWord;
|
SDHCI notification callback
TSDHCINotification = function(Device:PDevice; Data:Pointer; Notification:LongWord):LongWord;
|
SDHCI host start
TSDHCIHostStart = function(SDHCI:PSDHCIHost):LongWord;
|
SDHCI host stop
TSDHCIHostStop = function(SDHCI:PSDHCIHost):LongWord;
|
SDHCI host read byte
TSDHCIHostReadByte = function(SDHCI:PSDHCIHost; Reg:LongWord):Byte;
|
SDHCI host read word
TSDHCIHostReadWord = function(SDHCI:PSDHCIHost; Reg:LongWord):Word;
|
SDHCI host read long
TSDHCIHostReadLong = function(SDHCI:PSDHCIHost; Reg:LongWord):LongWord;
|
SDHCI host write byte
TSDHCIHostWriteByte = procedure(SDHCI:PSDHCIHost; Reg:LongWord; Value:Byte);
|
SDHCI host write word
TSDHCIHostWriteWord = procedure(SDHCI:PSDHCIHost; Reg:LongWord; Value:Word);
|
SDHCI host write long
TSDHCIHostWriteLong = procedure(SDHCI:PSDHCIHost; Reg:LongWord; Value:LongWord);
|
SDHCI host reset
TSDHCIHostReset = function(SDHCI:PSDHCIHost; Mask:Byte):LongWord;
|
SDHCI host hardware reset
TSDHCIHostHardwareReset = function(SDHCI:PSDHCIHost):LongWord;
|
SDHCI host set power
TSDHCIHostSetPower = function(SDHCI:PSDHCIHost; Power:Word):LongWord;
|
SDHCI host set clock
TSDHCIHostSetClock = function(SDHCI:PSDHCIHost; Clock:LongWord):LongWord;
|
SDHCI host set timing
TSDHCIHostSetTiming = function(SDHCI:PSDHCIHost; Timing:LongWord):LongWord;
|
'SDHCI host bus width
TSDHCIHostSetBusWidth = function(SDHCI:PSDHCIHost; BusWidth:LongWord):LongWord;
|
SDHCI host set clock divider
TSDHCIHostSetClockDivider = function(SDHCI:PSDHCIHost; Index:Integer; Divider:LongWord):LongWord;
|
SDHCI host set control register
TSDHCIHostSetControlRegister = function(SDHCI:PSDHCIHost):LongWord;
|
SDHCI host prepare DMA
TSDHCIHostPrepareDMA = function(SDHCI:PSDHCIHost; Command:PMMCCommand):LongWord;
|
SDHCI host start DMA
TSDHCIHostStartDMA = function(SDHCI:PSDHCIHost; Command:PMMCCommand):LongWord;
|
SDHCI host stop DMA
TSDHCIHostStopDMA = function(SDHCI:PSDHCIHost; Command:PMMCCommand):LongWord;
|
SDHCI ADMA2 32-bit descriptor
PSDHCIADMA2Descriptor32 = ^TSDHCIADMA2Descriptor32;
TSDHCIADMA2Descriptor32 = packed record
| See: ADMA2 Descriptor Format - SD Host Controller Simplified Specification Version 4.20 | |
Command:Word;
|
|
Len:Word;
|
|
Address:LongWord;
|
|
SDHCI ADMA2 64-bit descriptor
PSDHCIADMA2Descriptor64 = ^TSDHCIADMA2Descriptor64;
TSDHCIADMA2Descriptor64 = packed record
| See: ADMA2 Descriptor Format - SD Host Controller Simplified Specification Version 4.20 | |
| Note: 12-byte descriptor can't always be 8-byte aligned | |
Command:Word;
|
|
Len:Word;
|
|
AddressLow:LongWord;
|
|
AddressHigh:LongWord;
|
|
SDHCI ADMA2 64-bit V4 descriptor
PSDHCIADMA2Descriptor64v4 = ^TSDHCIADMA2Descriptor64v4;
TSDHCIADMA2Descriptor64v4 = packed record
Command:Word;
|
|
Len:Word;
|
|
AddressLow:LongWord;
|
|
AddressHigh:LongWord;
|
|
Reserved:LongWord;
|
SDHCI host types
PSDHCIHost = ^TSDHCIHost;
TSDHCIHost = record
| Device Properties | |
Device:TDevice;
|
The Device entry for this SDHCI |
| SDHCI Properties | |
SDHCIId:LongWord;
|
Unique Id of this SDHCI in the SDHCI table |
SDHCIState:LongWord;
|
SDHCI state (eg SDHCI_STATE_ENABLED) |
HostStart:TSDHCIHostStart;
|
A Host specific HostStart method implementing a standard SDHCI host interface |
HostStop:TSDHCIHostStop;
|
A Host specific HostStop method implementing a standard SDHCI host interface |
HostReadByte:TSDHCIHostReadByte;
|
A Host specific HostReadByte method implementing a standard SDHCI host interface (Or nil if the default method is suitable) |
HostReadWord:TSDHCIHostReadWord;
|
A Host specific HostReadWord method implementing a standard SDHCI host interface (Or nil if the default method is suitable) |
HostReadLong:TSDHCIHostReadLong;
|
A Host specific HostReadLong method implementing a standard SDHCI host interface (Or nil if the default method is suitable) |
HostWriteByte:TSDHCIHostWriteByte;
|
A Host specific HostWriteByte method implementing a standard SDHCI host interface (Or nil if the default method is suitable) |
HostWriteWord:TSDHCIHostWriteWord;
|
A Host specific HostWriteWord method implementing a standard SDHCI host interface (Or nil if the default method is suitable) |
HostWriteLong:TSDHCIHostWriteLong;
|
A Host specific HostWriteLong method implementing a standard SDHCI host interface (Or nil if the default method is suitable) |
HostReset:TSDHCIHostReset;
|
A Host specific HostReset method implementing a standard SDHCI host interface (Or nil if the default method is suitable) |
HostHardwareReset:TSDHCIHostHardwareReset;
|
A Host specific HostHardwareReset method implementing a standard SDHCI host interface (Or nil if the default method is suitable) |
HostSetPower:TSDHCIHostSetPower;
|
A Host specific HostSetPower method implementing a standard SDHCI host interface (Or nil if the default method is suitable) |
HostSetClock:TSDHCIHostSetClock;
|
A Host specific HostSetClock method implementing a standard SDHCI host interface (Or nil if the default method is suitable) |
HostSetTiming:TSDHCIHostSetTiming;
|
A Host specific HostSetTiming method implementing a standard SDHCI host interface (Or nil if the default method is suitable) |
HostSetBusWidth:TSDHCIHostSetBusWidth;
|
A Host specific HostSetBusWidth method implementing a standard SDHCI host interface (Or nil if the default method is suitable) |
HostSetClockDivider:TSDHCIHostSetClockDivider;
|
|
HostSetControlRegister:TSDHCIHostSetControlRegister;
|
|
HostPrepareDMA:TSDHCIHostPrepareDMA;
|
A Host specific HostPrepareDMA method implementing a standard SDHCI host interface (Or nil if the default method is suitable) |
HostStartDMA:TSDHCIHostStartDMA;
|
A Host specific HostStartDMA method implementing a standard SDHCI host interface (Or nil if the default method is suitable) |
HostStopDMA:TSDHCIHostStopDMA;
|
A Host specific HostStopDMA method implementing a standard SDHCI host interface (Or nil if the default method is suitable) |
DeviceInitialize:TMMCDeviceInitialize;
|
A Device specific DeviceInitialize method implementing a standard MMC device interface (Or nil if the default method is suitable) |
DeviceDeinitialize:TMMCDeviceDeinitialize;
|
A Device specific DeviceDeinitialize method implementing a standard MMC device interface (Or nil if the default method is suitable) |
DeviceGetCardDetect:TMMCDeviceGetCardDetect;
|
A Device specific DeviceGetCardDetect method implementing a standard MMC device interface (Or nil if the default method is suitable) |
DeviceGetWriteProtect:TMMCDeviceGetWriteProtect;
|
A Device specific DeviceGetWriteProtect method implementing a standard MMC device interface (Or nil if the default method is suitable) |
DeviceSendCommand:TMMCDeviceSendCommand;
|
A Device specific DeviceSendCommand method implementing a standard MMC device interface (Or nil if the default method is suitable) |
DeviceSetIOS:TMMCDeviceSetIOS;
|
A Device specific DeviceSetIOS method implementing a standard MMC device interface (Or nil if the default method is suitable) |
| Driver Properties | |
Lock:TMutexHandle;
|
Host lock |
Address:Pointer;
|
Host register base address |
Version:LongWord;
|
Host version information |
Quirks:LongWord;
|
Host quirks/bugs flags |
Quirks2:LongWord;
|
Host additional quirks/bugs flags |
Clock:LongWord;
|
Host current clock |
Power:LongWord;
|
Host current power |
Timing:LongWord;
|
Host current timing |
BusWidth:LongWord;
|
Host current bus width |
Interrupts:LongWord;
|
Host interrupts to be handled |
Voltages:LongWord;
|
Host configured voltage flags |
Capabilities:LongWord;
|
Host configured capabilities flags |
Capabilities2:LongWord;
|
Host configured additional capabilities flags |
TimeoutFrequency:LongWord;
|
Host configured timeout clock frequency (KHz) |
MinimumFrequency:LongWord;
|
Host configured minimum frequency (Hz) |
MaximumFrequency:LongWord;
|
Host configured maximum frequency (Hz) |
MaximumBlockSize:LongWord;
|
Host configured maximum block size |
MaximumBlockCount:LongWord;
|
Host configured maximum block count |
MaximumRequestSize:LongWord;
|
Host configured maximum request size |
MaximumBusyTimeout:LongWord;
|
Host configured maximum busy timeout (Milliseconds) |
MinimumDMASize:LongWord;
|
Minimum size for DMA read or write (Use PIO if less) |
MaximumPIOBlocks:LongWord;
|
Maximum blocks for PIO read or write (Use DMA if greater) |
PresetEnabled:LongBool;
|
Version 3.00 Preset Values Enabled (If applicable) |
Command:PMMCCommand;
|
Currently processing command |
Wait:TSemaphoreHandle;
|
Command completed semaphore |
UseDMA:LongBool;
|
Use DMA for the current data transfer |
DMAData:TDMAData;
|
External DMA data descriptor for current request (If applicable) |
DMAWait:TSemaphoreHandle;
|
External DMA completed semaphore |
DMASlave:LongWord;
|
External DMA slave (DREQ) Id for this device (If applicable) |
DMABuffer:Pointer;
|
DMA bounce buffer for the current request (If applicable) |
DMADirection:LongWord;
|
DMA data direction for current request (If applicable) |
SDMABoundary:LongWord;
|
SDMA buffer boundary argument |
ADMATable:PSDHCIADMA2Descriptor64v4;
|
ADMA descriptors for current request (If applicable) |
ADMABuffer:Pointer;
|
ADMA alignment buffers for the current request (If applicable) |
ADMATableSize:LongWord;
|
ADMA descriptor table size in bytes (If applicable) |
ADMATableCount:LongWord;
|
ADMA descriptor table entry count (If applicable) |
ADMABufferSize:LongWord;
|
ADMA alignment buffers size in bytes (If applicable) |
ADMADescriptorSize:LongWord;
|
ADMA descriptor size in bytes (If applicable) |
| Configuration Properties | |
PresetVoltages:LongWord;
|
Host predefined voltage flags |
PresetCapabilities:LongWord;
|
Host predefined capabilities flags |
PresetCapabilities2:LongWord;
|
Host predefined additional capabilities flags |
ClockMinimum:LongWord;
|
Host predefined minimum clock frequency |
ClockMaximum:LongWord;
|
Host predefined maximum clock frequency |
DriverStageRegister:LongWord;
|
Host predefined driver stage register (DSR) |
EnableV4Mode:LongBool;
|
Enable SDHCI version 4 protocol support |
| Statistics Properties | |
RequestCount:LongWord;
|
Number of requests that have been submitted to this host |
RequestErrors:LongWord;
|
Number of requests that have failed on this host |
DataRequestCount:LongWord;
|
Number of data requests that have been submitted to this host |
CommandRequestCount:LongWord;
|
Number of command requests that have been submitted to this host |
PIODataTransferCount:LongWord;
|
Number of data requests that have been submitted for PIO transfer on this host |
DMADataTransferCount:LongWord;
|
Number of data requests that have been submitted for DMA transfer on this host |
InterruptCount:LongWord;
|
Number of interrupt requests received by the host |
DataInterruptCount:LongWord;
|
Number of data interrupt requests received by the host |
CommandInterruptCount:LongWord;
|
Number of command interrupt requests received by the host |
| Internal Properties | |
Prev:PSDHCIHost;
|
Previous entry in SDHCI table |
Next:PSDHCIHost;
|
Next entry in SDHCI table |
Public variables
MMC logging
MMC_DEFAULT_LOG_LEVEL:LongWord = MMC_LOG_LEVEL_DEBUG;
|
Minimum level for MMC messages. Only messages with level greater than or equal to this will be printed. |
MMC_LOG_ENABLED:Boolean;
|
Function declarations
Initialization functions
procedure MMCInit;
Description: Performs basic initialization of the MMC/SD core, after this devices, hosts and drivers can be registered however nothing will work until MMCStart is called
| Note | None documented |
|---|
function MMCStart:LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCStop:LongWord;
Description: To be documented
| Note | None documented |
|---|
procedure MMCAsyncStart(SDHCI:PSDHCIHost);
Description: To be documented
| Note | None documented |
|---|
MMC functions
function MMCDeviceReadBlocks(MMC:PMMCDevice; const Start,Count:Int64; Buffer:Pointer):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceWriteBlocks(MMC:PMMCDevice; const Start,Count:Int64; Buffer:Pointer):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceEraseBlocks(MMC:PMMCDevice; const Start,Count:Int64):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceGoIdle(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceSetClock(MMC:PMMCDevice; Clock:LongWord):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceSetTiming(MMC:PMMCDevice; Timing:LongWord):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceSetBusWidth(MMC:PMMCDevice; Width:LongWord):LongWord;
Description: To be documented
| Reference | Section 3.4 of SD Host Controller Simplified Specification V3.0 partA2_300.pdf |
|---|
function MMCDeviceSetBlockLength(MMC:PMMCDevice; Length:LongWord):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceSetBlockCount(MMC:PMMCDevice; Count:LongWord; Relative:Boolean):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceSetDriverStage(MMC:PMMCDevice; DriverStage:LongWord):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceStopTransmission(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceSelectCard(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceDeselectCard(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceSwitch(MMC:PMMCDevice; Setting,Index,Value:Byte; Timeout:LongWord):LongWord;
Description: Modifies an Extended CSD register for the specificed MMC device
| MMC | The MMC Device to modify |
|---|---|
| Setting | The Extended CSD command set (eg EXT_CSD_CMD_SET_NORMAL) |
| Index | The index of the Extended CSD register to be set |
| Value | The value to be set in the Extended CSD register |
| Timeout | Command timeout in milliseconds |
function MMCDeviceSwitchEx(MMC:PMMCDevice; Setting,Index,Value:Byte; Timeout,Timing:LongWord; SendStatus,RetryCRCError:Boolean):LongWord;
Description: Modifies an Extended CSD register for the specificed MMC device
| MMC | The MMC Device to modify |
|---|---|
| Setting | The Extended CSD command set (eg EXT_CSD_CMD_SET_NORMAL) |
| Index | The index of the Extended CSD register to be set |
| Value | The value to be set in the Extended CSD register |
| Timeout | Command timeout in milliseconds |
| Timing | New timing to enable after change (eg MMC_TIMING_MMC_HS) |
| SendStatus | Use the MMC_CMD_SEND_STATUS command to poll for busy |
| RetryCRCError | Retry if CRC error occurs when polling for busy |
function MMCDevicePollForBusy(MMC:PMMCDevice; Timeout,Command:LongWord):LongWord;
Description: Poll the specified MMC device for command completion using busy status
| Note | None documented |
|---|
function MMCDevicePollForBusyEx(MMC:PMMCDevice; Timeout,Command:LongWord; SendStatus,RetryCRCError:Boolean):LongWord;
Description: Poll the specified MMC device for command completion using busy status
| Note | None documented |
|---|
function MMCDeviceSendCardStatus(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceSendOperationCondition(MMC:PMMCDevice; Probe:Boolean):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceSendCardSpecific(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceDecodeCardSpecific(MMC:PMMCDevice):LongWord;
Description: Given a 128-bit response, decode to our card CSD structure
| Note | None documented |
|---|
function MMCDeviceSendCardIdentification(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceSendAllCardIdentification(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceDecodeCardIdentification(MMC:PMMCDevice):LongWord;
Description: Given a 128-bit response, decode to our card CID structure
| Note | None documented |
|---|
function MMCDeviceGetExtendedCardSpecific(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceSendExtendedCardSpecific(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceDecodeExtendedCardSpecific(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceSetRelativeAddress(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceSPISetCRC(MMC:PMMCDevice; Enable:Boolean):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceSPIReadOperationCondition(MMC:PMMCDevice; HighCapacity:Boolean):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceInsert(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceRemove(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceInitialize(MMC:PMMCDevice):LongWord;
Description: To be documented
| Reference | Section 3.6 of SD Host Controller Simplified Specification V3.0 partA2_300.pdf |
|---|
function MMCDeviceDeinitialize(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceGetCardDetect(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceGetWriteProtect(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceSendCommand(MMC:PMMCDevice; Command:PMMCCommand):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceSetIOS(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceCreate:PMMCDevice;
Description: Create a new MMC entry
| Return | Pointer to new MMC entry or nil if MMC could not be created |
|---|
function MMCDeviceCreateEx(Size:LongWord):PMMCDevice;
Description: Create a new MMC entry
| Size | Size in bytes to allocate for new MMC (Including the MMC entry) |
|---|---|
| Return | Pointer to new MMC entry or nil if MMC could not be created |
function MMCDeviceDestroy(MMC:PMMCDevice):LongWord;
Description: Destroy an existing MMC entry
| Note | None documented |
|---|
function MMCDeviceRegister(MMC:PMMCDevice):LongWord;
Description: Register a new MMC in the MMC table
| Note | None documented |
|---|
function MMCDeviceDeregister(MMC:PMMCDevice):LongWord;
Description: Deregister a MMC from the MMC table
| Note | None documented |
|---|
function MMCDeviceFind(MMCId:LongWord):PMMCDevice;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceFindByDevice(Device:PDevice):PMMCDevice;
Description: Find an MMC/SD device by the matching DeviceData property
| Device | The device entry to match with the DeviceData value |
|---|---|
| Return | The MMC/SD device matched or nil if none found |
function MMCDeviceFindByName(const Name:String):PMMCDevice; inline;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceFindByDescription(const Description:String):PMMCDevice; inline;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceEnumerate(Callback:TMMCEnumerate; Data:Pointer):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceNotification(MMC:PMMCDevice; Callback:TMMCNotification; Data:Pointer; Notification,Flags:LongWord):LongWord;
Description: To be documented
| Note | None documented |
|---|
SD functions
function SDDeviceSwitch(MMC:PMMCDevice; Mode,Group:Integer; Value:Byte; Buffer:Pointer):LongWord;
Description: To be documented
| Buffer | Buffer must point to a 64 byte buffer for Switch Status information |
|---|---|
| Note | See 4.3.10 of SD Physical Layer Simplified Specification V4.10 |
function SDDeviceSwitchHighspeed(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function SDDeviceSetBusWidth(MMC:PMMCDevice; Width:LongWord):LongWord;
Description: To be documented
| Note | See Table 4-30 in Section 4.7.4 of SD Physical Layer Simplified Specification V4.10 |
|---|
function SDDeviceSendInterfaceCondition(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | See 4.3.13 of SD Physical Layer Simplified Specification V4.10.
CMD8 (SEND_IF_COND) must be invoked to support SD 2.0 cards. The card must be in Idle State before issuing this command. This command will fail harmlessly for SD 1.0 cards. |
|---|
function SDDeviceSendOperationCondition(MMC:PMMCDevice; Probe:Boolean):LongWord;
Description: To be documented
| Note | See 4.2.3.1 of SD Physical Layer Simplified Specification V4.10 |
|---|
function SDDeviceGetCardSpecific(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function SDDeviceDecodeCardSpecific(MMC:PMMCDevice):LongWord;
Description: Given a 128-bit response, decode to our card CSD structure
| Note | None documented |
|---|
function SDDeviceGetCardIdentification(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function SDDeviceDecodeCardIdentification(MMC:PMMCDevice):LongWord;
Description: Given a 128-bit response, decode to our card CID structure
| Note | None documented |
|---|
function SDDeviceSendSDStatus(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function SDDeviceDecodeSDStatus(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function SDDeviceSendSDSwitch(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function SDDeviceDecodeSDSwitch(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function SDDeviceSendSDConfiguration(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function SDDeviceDecodeSDConfiguration(MMC:PMMCDevice):LongWord;
Description: Given a 64-bit response, decode to our card SCR structure
| Note | None documented |
|---|
function SDDeviceSendRelativeAddress(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | None documented |
|---|
function SDDeviceSendApplicationCommand(MMC:PMMCDevice; Command:PMMCCommand):LongWord;
Description: To be documented
| Note | None documented |
|---|
SDIO functions
function SDIODeviceReset(MMC:PMMCDevice):LongWord;
Description: To be documented
| Note | See SDIO Simplified Specification V2.0, 4.4 Reset for SDIO |
|---|
function SDIODeviceSendOperationCondition(MMC:PMMCDevice; Probe:Boolean):LongWord;
Description: To be documented
| Note | None documented |
|---|
function SDIODeviceReadWriteDirect(MMC:PMMCDevice; Write:Boolean; Operation,Address:LongWord; Input:Byte; Output:PByte):LongWord;
Description: To be documented
| Note | None documented |
|---|
function SDIODeviceReadWriteExtended(MMC:PMMCDevice; Write:Boolean; Operation,Address:LongWord; Increment:Boolean; Buffer:Pointer; BlockCount,BlockSize:LongWord):LongWord;
Description: To be documented
| Note | None documented |
|---|
SDHCI driver functions
function SDIODriverCreate:PSDIODriver;
Description: Create a new SDIO Driver entry
| Return | Pointer to new Driver entry or nil if driver could not be created |
|---|
function SDIODriverCreateEx(Size:LongWord):PSDIODriver;
Description: Create a new SDIO Driver entry
| Size | Size in bytes to allocate for new driver (Including the driver entry) |
|---|---|
| Return | Pointer to new Driver entry or nil if driver could not be created |
function SDIODriverDestroy(Driver:PSDIODriver):LongWord;
Description: Destroy an existing SDIO Driver entry
| Note | None documented |
|---|
function SDIODriverRegister(Driver:PSDIODriver):LongWord;
Description: Register a new Driver in the SDIO Driver table
| Note | None documented |
|---|
function SDIODriverDeregister(Driver:PSDIODriver):LongWord;
Description: Deregister a Driver from the SDIO Driver table
| Note | None documented |
|---|
function SDIODriverFind(DriverId:LongWord):PSDIODriver;
Description: Find a driver by Id in the SDIO Driver table
| Note | None documented |
|---|
function SDIODriverFindByName(const Name:String):PSDIODriver; inline;
Description: Find a driver by name in the Driver table
| Note | None documented |
|---|
function SDIODriverEnumerate(Callback:TSDIODriverEnumerate;Data:Pointer):LongWord;
Description: To be documented
| Note | None documented |
|---|
SDHCI functions
function SDHCIHostReset(SDHCI:PSDHCIHost; Mask:Byte):LongWord;
Description: Default software reset function for SDHCI host controllers
| Reference | Section 3.3 of SD Host Controller Simplified Specification V3.0 partA2_300.pdf |
|---|---|
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
function SDHCIHostHardwareReset(SDHCI:PSDHCIHost):LongWord;
Description: Default hardware reset function for SDHCI host controllers
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
|---|
function SDHCIHostSetPower(SDHCI:PSDHCIHost; Power:Word):LongWord;
Description: Default set power function for SDHCI host controllers
| Reference | Section 3.3 of SD Host Controller Simplified Specification V3.0 partA2_300.pdf |
|---|---|
| Power | A shift value to indicate the first available value in the Voltages mask. Caller can use FirstBitSet(SDHCI.Voltages) - 1 to obtain the value of Power. If there are no values set then Power will be -1 ($FFFF) to indicate nothing or unknown. |
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
function SDHCIHostSetClock(SDHCI:PSDHCIHost; Clock:LongWord):LongWord;
Description: Default set clock function for SDHCI host controllers
| Reference | Section 3.2 of SD Host Controller Simplified Specification V3.0 partA2_300.pdf |
|---|---|
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
function SDHCIHostSetTiming(SDHCI:PSDHCIHost; Timing:LongWord):LongWord;
Description: Default set timing function for SDHCI host controllers
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
|---|
function SDHCIHostSetBusWidth(SDHCI:PSDHCIHost; BusWidth:LongWord):LongWord;
Description: Default set bus width function for SDHCI host controllers
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
|---|
function SDHCIHostPrepareDMA(SDHCI:PSDHCIHost; Command:PMMCCommand):LongWord;
Description: Default DMA transfer prepare function for SDHCI host controllers
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
|---|
function SDHCIHostStartDMA(SDHCI:PSDHCIHost; Command:PMMCCommand):LongWord;
Description: Default DMA transfer start function for SDHCI host controllers
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
|---|
function SDHCIHostStopDMA(SDHCI:PSDHCIHost; Command:PMMCCommand):LongWord;
Description: Default DMA transfer stop function for SDHCI host controllers
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
|---|
procedure SDHCIHostCompleteDMA(Request:PDMARequest);
Description: Default DMA request completion callback for SDHCI host controllers
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
|---|
function SDHCIHostTransferPIO(SDHCI:PSDHCIHost):LongWord;
Description: Default PIO transfer function for SDHCI host controllers
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
|---|
function SDHCIHostTransferDMA(SDHCI:PSDHCIHost):LongWord;
Description: Default DMA transfer function for SDHCI host controllers
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
|---|
function SDHCIHostFinishCommand(SDHCI:PSDHCIHost):LongWord;
Description: Default finish command function for SDHCI host controllers
| Note | Called by Interrupt Command handler when an SDHCI_INT_RESPONSE is received |
|---|---|
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
function SDHCIHostFinishData(SDHCI:PSDHCIHost):LongWord;
Description: Default finish data function for SDHCI host controllers
| Note | Called by Interrupt Data handler when data is received |
|---|---|
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
function SDHCIHostCommandInterrupt(SDHCI:PSDHCIHost; InterruptMask:LongWord; var ReturnMask:LongWord):LongWord;
Description: Default command interrupt processing function for SDHCI host controllers
| Note | Called by SDHCI controller interrupt handler when a command interrupt is received |
|---|---|
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
function SDHCIHostDataInterrupt(SDHCI:PSDHCIHost; InterruptMask:LongWord):LongWord;
Description: Default data interrupt processing function for SDHCI host controllers
| Note | Called by SDHCI controller interrupt handler when a data interrupt is received |
|---|---|
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
function SDHCIHostStart(SDHCI:PSDHCIHost):LongWord;
Description: Default host start function for SDHCI host controllers
| Note | Called automatically to start each registered SDHCI controller when required |
|---|---|
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
function SDHCIHostStop(SDHCI:PSDHCIHost):LongWord;
Description: Default host stop function for SDHCI host controllers
| Note | Called automatically to stop each registered SDHCI controller when required |
|---|---|
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
function SDHCIHostReadByte(SDHCI:PSDHCIHost; Reg:LongWord):Byte; inline;
Description: Default read byte function for SDHCI host controllers
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
|---|
function SDHCIHostReadWord(SDHCI:PSDHCIHost; Reg:LongWord):Word; inline;
Description: Default read word function for SDHCI host controllers
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
|---|
function SDHCIHostReadLong(SDHCI:PSDHCIHost; Reg:LongWord):LongWord; inline;
Description: Default read longword function for SDHCI host controllers
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
|---|
procedure SDHCIHostWriteByte(SDHCI:PSDHCIHost; Reg:LongWord; Value:Byte); inline;
Description: Default write byte function for SDHCI host controllers
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
|---|
procedure SDHCIHostWriteWord(SDHCI:PSDHCIHost; Reg:LongWord; Value:Word); inline;
Description: Default write word function for SDHCI host controllers
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
|---|
procedure SDHCIHostWriteLong(SDHCI:PSDHCIHost; Reg:LongWord; Value:LongWord); inline;
Description: Default write longword function for SDHCI host controllers
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
|---|
function SDHCIHostSetClockDivider(SDHCI:PSDHCIHost; Index:Integer; Divider:LongWord):LongWord;
Description: Default set clock divider function for SDHCI host controllers
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
|---|
function SDHCIHostSetControlRegister(SDHCI:PSDHCIHost):LongWord;
Description: Default set control register function for SDHCI host controllers
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
|---|
function SDHCIHostGetADMAAddress(SDHCI:PSDHCIHost):PtrUInt;
Description: Get the DMA address of the ADMA table for the current request
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
|---|
procedure SDHCIHostSetADMAAddress(SDHCI:PSDHCIHost; Address:PtrUInt);
Description: Set the address of the transfer data in the Advanded DMA (ADMA) registers
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
|---|
function SDHCIHostGetSDMAAddress(SDHCI:PSDHCIHost; Command:PMMCCommand):PtrUInt;
Description: Get the DMA address of the transfer data for the current request
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
|---|
procedure SDHCIHostSetSDMAAddress(SDHCI:PSDHCIHost; Address:PtrUInt);
Description: Set the address of the transfer data in the Simple DMA (SDMA) register
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
|---|
procedure SDHCIHostWriteADMADescriptor(SDHCI:PSDHCIHost; var Descriptor:Pointer; Command,Len:Word; Address:PtrUInt);
Description: Write the properties to an ADMA descriptor
| Note | Not intended to be called directly by applications, may be used by SDHCI drivers. |
|---|
function SDHCIHostCreate:PSDHCIHost;
Description: Create a new SDHCI entry
| Return | Pointer to new SDHCI entry or nil if SDHCI could not be created |
|---|
function SDHCIHostCreateEx(Size:LongWord):PSDHCIHost;
Description: Create a new SDHCI entry
| Size | Size in bytes to allocate for new SDHCI (Including the SDHCI entry) |
|---|---|
| Return | Pointer to new SDHCI entry or nil if SDHCI could not be created |
function SDHCIHostDestroy(SDHCI:PSDHCIHost):LongWord;
Description: Destroy an existing SDHCI entry
| Note | None documented |
|---|
function SDHCIHostRegister(SDHCI:PSDHCIHost):LongWord;
Description: Register a new SDHCI in the SDHCI table
| Note | None documented |
|---|
function SDHCIHostDeregister(SDHCI:PSDHCIHost):LongWord;
Description: Deregister a SDHCI from the SDHCI table
| Note | None documented |
|---|
function SDHCIHostFind(SDHCIId:LongWord):PSDHCIHost;
Description: To be documented
| Note | None documented |
|---|
function SDHCIHostEnumerate(Callback:TSDHCIEnumerate; Data:Pointer):LongWord;
Description: To be documented
| Note | None documented |
|---|
function SDHCIHostNotification(SDHCI:PSDHCIHost; Callback:TSDHCINotification; Data:Pointer; Notification,Flags:LongWord):LongWord;
Description: To be documented
| Note | None documented |
|---|
MMC helper functions
function MMCGetCount:LongWord; inline;
Description: Get the current MMC count
| Note | None documented |
|---|
function MMCDeviceCheck(MMC:PMMCDevice):PMMCDevice;
Description: Check if the supplied MMC is in the MMC table
| Note | None documented |
|---|
function MMCIsSD(MMC:PMMCDevice):Boolean;
Description: To be documented
| Note | None documented |
|---|
function MMCGetCIDValue(MMC:PMMCDevice; Version,Value:LongWord):LongWord;
Description: Extract a CID field value from the 128 bit Card Identification register
| Note | None documented |
|---|
function MMCGetCSDValue(MMC:PMMCDevice; Value:LongWord):LongWord;
Description: Extract a CSD field value from the 128 bit Card Specific register
| Note | None documented |
|---|
function MMCExtractBits(Buffer:Pointer; Start,Size:LongWord):LongWord;
Description: To be documented
| Start | Start is the starting bit to extract |
|---|---|
| Size | Size is the number of bits to extract |
| Note | Start is the LSB so to extract 8 bits from 127 to 120 then Start would be 120 and Size would be 8 |
function MMCExtractBitsEx(Buffer:Pointer; Length,Start,Size:LongWord):LongWord;
Description: To be documented
| Length | Length is the size of the buffer in LongWords |
|---|---|
| Start | Start is the starting bit to extract |
| Size | Size is the number of bits to extract |
| Note | Start is the LSB so to extract 8 bits from 127 to 120 then Start would be 120 and Size would be 8. For a 128 bit buffer (16 bytes) Length would be 4. For a 512 bit buffer (64 bytes) Length would be 16. |
function MMCIsMultiCommand(Command:Word):Boolean; inline;
Description: To be documented
| Note | None documented |
|---|
function MMCIsNonRemovable(MMC:PMMCDevice):Boolean; inline;
Description: To be documented
| Note | None documented |
|---|
function MMCHasExtendedCSD(MMC:PMMCDevice):Boolean; inline;
Description: To be documented
| Note | None documented |
|---|
function MMCHasSetBlockCount(MMC:PMMCDevice):Boolean; inline;
Description: To be documented
| Note | None documented |
|---|
function MMCHasAutoBlockCount(MMC:PMMCDevice):Boolean; inline;
Description: To be documented
| Note | None documented |
|---|
function MMCHasAutoCommandStop(MMC:PMMCDevice):Boolean; inline;
Description: To be documented
| Note | None documented |
|---|
function MMCStatusToString(Status:LongWord):String;
Description: Translates an MMC status code into a string describing it
| Note | None documented |
|---|
function MMCVersionToString(Version:LongWord):String;
Description: Translates an MMC version into a string
| Note | None documented |
|---|
function MMCTimingToString(Timing:LongWord):String;
Description: Translates an MMC timing into a string
| Note | None documented |
|---|
function MMCBusWidthToString(BusWidth:LongWord):String;
Description: Translates an MMC bus width into a string
| Note | None documented |
|---|
function MMCDriverTypeToString(DriverType:LongWord):String;
Description: Translates an MMC driver type into a string
| Note | None documented |
|---|
function MMCSignalVoltageToString(SignalVoltage:LongWord):String;
Description: Translates an MMC signal voltage into a string
| Note | None documented |
|---|
function MMCDeviceTypeToString(MMCType:LongWord):String;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceStateToString(MMCState:LongWord):String;
Description: To be documented
| Note | None documented |
|---|
function MMCDeviceStateToNotification(State:LongWord):LongWord;
Description: Convert a Device state value into the notification code for device notifications
| Note | None documented |
|---|
procedure MMCLog(Level:LongWord; MMC:PMMCDevice; const AText:String);
Description: To be documented
| Note | None documented |
|---|
procedure MMCLogInfo(MMC:PMMCDevice; const AText:String); inline;
Description: To be documented
| Note | None documented |
|---|
procedure MMCLogWarn(MMC:PMMCDevice; const AText:String); inline;
Description: To be documented
| Note | None documented |
|---|
procedure MMCLogError(MMC:PMMCDevice; const AText:String); inline;
Description: To be documented
| Note | None documented |
|---|
procedure MMCLogDebug(MMC:PMMCDevice; const AText:String); inline;
Description: To be documented
| Note | None documented |
|---|
SD helper functions
function SDGetMaxClock(MMC:PMMCDevice):LongWord;
Description: Determine the Maximum Clock (DTR) for the current card
| Note | None documented |
|---|
function SDGetCIDValue(MMC:PMMCDevice; Value:LongWord):LongWord;
Description: Extract a CID field value from the 128 bit Card Identification register
| Note | None documented |
|---|
function SDGetCSDValue(MMC:PMMCDevice; Version,Value:LongWord):LongWord;
Description: Extract a CSD field value from the 128 bit Card Specific register
| Note | None documented |
|---|
function SDGetSCRValue(MMC:PMMCDevice; Value:LongWord):LongWord;
Description: Extract an SCR field value from the 64 bit SD Configuration register
| Note | None documented |
|---|
function SDGetSSRValue(MMC:PMMCDevice; Value:LongWord):LongWord;
Description: Extract an SCR field value from the 512 bit SD Status register
| Note | None documented |
|---|
function SDGetSwitchValue(MMC:PMMCDevice; Value:LongWord):LongWord;
Description: Extract a Switch field value from the 512 bit SD Switch status
| Note | None documented |
|---|
function SDVersionToString(Version:LongWord):String;
Description: Translates an SD version into a string
| Note | None documented |
|---|
function SDBusWidthToString(BusWidth:LongWord):String;
Description: Translates an SD bus width into a string
| Note | None documented |
|---|
SDIO helper functions
function SDIODriverGetCount:LongWord; inline;
Description: Get the current SDIO driver count
| Note | None documented |
|---|
function SDIODriverCheck(Driver:PSDIODriver):PSDIODriver;
Description: Check if the supplied SDIO Driver is in the driver table
| Note | None documented |
|---|
function SDIODeviceStateToString(SDIOState:LongWord):String;
Description: To be documented
| Note | None documented |
|---|
function SDIODeviceStatusToString(SDIOStatus:LongWord):String;
Description: To be documented
| Note | None documented |
|---|
function SDIODeviceStateToNotification(State:LongWord):LongWord;
Description: Convert a Device state value into the notification code for device notifications
| Note | None documented |
|---|
function SDIODeviceStatusToNotification(Status:LongWord):LongWord;
Description: Convert a Device status value into the notification code for device notifications
| Note | None documented |
|---|
SDHCI helper functions
function SDHCIGetCount:LongWord; inline;
Description: Get the current SDHCI count
| Note | None documented |
|---|
function SDHCIHostCheck(SDHCI:PSDHCIHost):PSDHCIHost;
Description: Check if the supplied SDHCI is in the SDHCI table
| Note | None documented |
|---|
function SDHCIIsSPI(SDHCI:PSDHCIHost):Boolean;
Description: To be documented
| Note | None documented |
|---|
function SDHCIHasDMA(SDHCI:PSDHCIHost):Boolean;
Description: To be documented
| Note | None documented |
|---|
function SDHCIHasCMD23(SDHCI:PSDHCIHost):Boolean;
Description: To be documented
| Note | None documented |
|---|
function SDHCIAutoCMD12(SDHCI:PSDHCIHost):Boolean;
Description: To be documented
| Note | None documented |
|---|
function SDHCIAutoCMD23(SDHCI:PSDHCIHost):Boolean;
Description: To be documented
| Note | None documented |
|---|
function SDHCIGetVersion(SDHCI:PSDHCIHost):Word;
Description: To be documented
| Note | None documented |
|---|
function SDHCIGetCommand(Command:Word):Word;
Description: To be documented
| Note | None documented |
|---|
function SDHCIMakeCommand(Command,Flags:Word):Word;
Description: To be documented
| Note | None documented |
|---|
function SDHCIMakeBlockSize(DMA,BlockSize:Word):Word;
Description: To be documented
| Note | None documented |
|---|
function SDHCIVersionToString(Version:LongWord):String;
Description: Translate an SDHCI version into a string
| Note | None documented |
|---|
function SDHCIPowerToString(Power:LongWord):String;
Description: Translate an SDHCI power value into a string
| Note | None documented |
|---|
function SDHCIDeviceTypeToString(SDHCIType:LongWord):String; inline;
Description: To be documented
| Note | None documented |
|---|
function SDHCIHostTypeToString(SDHCIType:LongWord):String;
Description: To be documented
| Note | None documented |
|---|
function SDHCIDeviceStateToString(SDHCIState:LongWord):String; inline;
Description: To be documented
| Note | None documented |
|---|
function SDHCIHostStateToString(SDHCIState:LongWord):String;
Description: To be documented
| Note | None documented |
|---|
function SDHCIHostStateToNotification(State:LongWord):LongWord;
Description: Convert a Host state value into the notification code for device notifications
| Note | None documented |
|---|
MMC storage functions
function MMCStorageDeviceRead(Storage:PStorageDevice; const Start,Count:Int64; Buffer:Pointer):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCStorageDeviceWrite(Storage:PStorageDevice; const Start,Count:Int64; Buffer:Pointer):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCStorageDeviceErase(Storage:PStorageDevice; const Start,Count:Int64):LongWord;
Description: To be documented
| Note | None documented |
|---|
function MMCStorageDeviceControl(Storage:PStorageDevice; Request:Integer; Argument1:LongWord; var Argument2:LongWord):LongWord;
Description: To be documented
| Note | None documented |
|---|
Return to Unit Reference
