Difference between revisions of "Unit MMC"

From Ultibo.org
Jump to: navigation, search
Line 3,733: Line 3,733:
 
----
 
----
  
−
''To be documented''
+
 
 +
'''MMC command'''
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
 +
<code>PMMCCommand = ^TMMCCommand;</code>
 +
 
 +
<code>TMMCCommand = record</code>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
|colspan="2"|''Command Properties''
 +
|-
 +
| <code>Command:Word;</code>
 +
| style="width: 50%;"|&nbsp;
 +
|-
 +
| <code>Argument:LongWord;</code>
 +
| &nbsp;
 +
|-
 +
| <code>ResponseType:LongWord;</code>
 +
| &nbsp;
 +
|-
 +
| <code>Response:array[0..3] of LongWord;</code>
 +
| &nbsp;
 +
|-
 +
| <code>Status:LongWord;</code>
 +
| &nbsp;
 +
|-
 +
| <code>Data:PMMCData;</code>
 +
| &nbsp;
 +
|-
 +
|colspan="2"|''Host Properties''
 +
|-
 +
| <code>DataCompleted:Boolean;</code>
 +
| &nbsp;
 +
|-
 +
| <code>BusyCompleted:Boolean;</code>
 +
| &nbsp;
 +
|-
 +
| <code>TuningCompleted:Boolean;</code>
 +
| &nbsp;
 +
|-
 +
| <code>CommandCompleted:Boolean;</code>
 +
| &nbsp;
 +
|-
 +
|}
 +
</div></div>
 +
 
 +
'''MMC data'''
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
 +
<code>PMMCData = ^TMMCData;</code>
 +
 
 +
<code>TMMCData = record</code>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
|colspan="2"|''Data Properties''
 +
|-
 +
| <code>Data:Pointer;</code>
 +
| style="width: 50%;"|&nbsp;
 +
|-
 +
| <code>Flags:LongWord;</code>
 +
| &nbsp;
 +
|-
 +
| <code>BlockSize:LongWord;</code>
 +
| &nbsp;
 +
|-
 +
| <code>BlockCount:LongWord;</code>
 +
| &nbsp;
 +
|-
 +
|colspan="2"|''Host Properties''
 +
|-
 +
| <code>BlockOffset:LongWord;</code>
 +
| &nbsp;
 +
|-
 +
| <code>BlocksRemaining:LongWord;</code>
 +
| &nbsp;
 +
|-
 +
| <code>BytesTransfered:LongWord;</code>
 +
| &nbsp;
 +
|-
 +
|}
 +
</div></div>
 +
 
 +
'''MMC card identification data (CID)'''
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
 +
<code>PMMCCardIdentificationData = ^TMMCCardIdentificationData;</code>
 +
 
 +
<code>TMMCCardIdentificationData = record</code>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
|colspan="2"|Note: See: Section 5.2 of SD Physical Layer Simplified Specification Version 4.10
 +
|-
 +
| <code>ManufacturerId:Byte;</code>
 +
| &nbsp;
 +
|-
 +
| <code>OEMId:Word;</code>
 +
| &nbsp;
 +
|-
 +
| <code>ProductName:array[0..7] of Char;</code>
 +
| Max 0 to 6, 1 extra for null terminator
 +
|-
 +
| <code>ProductRevision:Byte;</code>
 +
| &nbsp;
 +
|-
 +
| <code>HardwareRevision:Byte;</code>
 +
| &nbsp;
 +
|-
 +
| <code>FirmwareRevision:Byte;</code>
 +
| &nbsp;
 +
|-
 +
| <code>ProductSerialNumber:LongWord;</code>
 +
| &nbsp;
 +
|-
 +
| <code>ManufacturingMonth:Byte;</code>
 +
| &nbsp;
 +
|-
 +
| <code>ManufacturingYear:Word;</code>
 +
| &nbsp;
 +
|-
 +
| <code>CRC:Byte;</code>
 +
| CRC7 checksum
 +
|-
 +
|}
 +
</div></div>
 +
 
 +
'''MMC card specific erase data (CSD)'''
 +
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
 +
 
 +
<code>TMMCCardSpecificSDEraseData = record</code>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
|colspan="2"|Note: See: Section 5.3 of SD Physical Layer Simplified Specification Version 4.10 (Defined here for CSD)
 +
|-
 +
| <code>EraseBlockEnable:Boolean;</code>
 +
| Erase single block enable
 +
|-
 +
| <code>SectorSize:Byte;</code>
 +
| Erase sector size
 +
|-
 +
|}
 +
</div></div> 
 +
 +
'''MMC card specific MMC22 erase data''' 
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
 +
 
 +
<code>TMMCCardSpecificMMC22EraseData = record</code>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
| <code>SectorSize:Byte;</code>
 +
| Erase sector size
 +
|-
 +
| <code>EraseGroupSize:Byte;</code>
 +
| Erase group size
 +
|-
 +
|}
 +
</div></div>
 +
 
 +
'''MMC card specific MMC31 erase data'''
 +
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
 +
 
 +
<code>TMMCCardSpecificMMC31EraseData = record</code>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
| <code>EraseGroupSize:Byte;</code>
 +
| Erase group size
 +
|-
 +
| <code>EraseGroupMultiplier:Byte;</code>
 +
| Erase group size multiplier
 +
|-
 +
|}
 +
</div></div>
 +
 
 +
'''MMC card specific erase data'''
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
 +
 
 +
<code>TMMCCardSpecificEraseData = record</code>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
| <code>case Integer of</code>
 +
| style="width: 50%;"|&nbsp;
 +
|-
 +
| <code>0:(MMC22:TMMCCardSpecificMMC22EraseData);</code>
 +
| &nbsp;
 +
|-
 +
| <code>1:(MMC31:TMMCCardSpecificMMC31EraseData);</code>
 +
| &nbsp;
 +
|-
 +
| <code>2:(SD:TMMCCardSpecificSDEraseData);</code>
 +
| &nbsp;
 +
|-
 +
|}
 +
</div></div>
 +
 
 +
'''MMC card specific data'''
 +
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
 +
<code>PMMCCardSpecificData = ^TMMCCardSpecificData;</code>
 +
 
 +
<code>TMMCCardSpecificData = record</code>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
|colspan="2"|''Card Values''
 +
|-
 +
| <code>CSDStructure:Byte;</code>
 +
| CSD structure version
 +
|-
 +
| <code>SpecVersion:Byte;</code>
 +
| System specification version (MMC/eMMC Only)
 +
|-
 +
| <code>TAAC:Byte;</code>
 +
| Data read access-time-1
 +
|-
 +
| <code>NSAC:Byte;</code>
 +
| Data read access-time-2 in CLK cycles (NSAC*100)
 +
|-
 +
| <code>TransferSpeed:Byte;</code>
 +
| Max. data transfer rate
 +
|-
 +
| <code>CCC:Word;</code>
 +
| Card command classes
 +
|-
 +
| <code>ReadBlockLength:Byte;</code>
 +
| Max. read data block length
 +
|-
 +
| <code>ReadBlockPartial:Boolean;</code>
 +
| Partial blocks for read allowed
 +
|-
 +
| <code>WriteBlockMisalign:Boolean;</code>
 +
| Write block misalignment
 +
|-
 +
| <code>ReadBlockMisalign:Boolean;</code>
 +
| Read block misalignment
 +
|-
 +
| <code>DSRImplemented:Boolean;</code>
 +
| DSR implemented
 +
|-
 +
| <code>DeviceSize:Word;</code>
 +
| Device size
 +
|-
 +
| <code>VDDReadCurrentMin:Byte;</code>
 +
| Max. read current @VDD min
 +
|-
 +
| <code>VDDReadCurrentMax:Byte;</code>
 +
| Max. read current @VDD max
 +
|-
 +
| <code>VDDWriteCurrentMin:Byte;</code>
 +
| Max. write current @VDD min
 +
|-
 +
| <code>VDDWriteCurrentMax:Byte;</code>
 +
| Max. write current @VDD max
 +
|-
 +
| <code>DeviceSizeMultiplier:Byte;</code>
 +
| Device size multiplier
 +
|-
 +
| <code>Erase:TMMCCardSpecificEraseData;</code>
 +
| Erase group details
 +
|-
 +
| <code>WriteProtectGroupSize:Byte;</code>
 +
| Write protect group size
 +
|-
 +
| <code>WriteProtectGroupEnable:Boolean;</code>
 +
| Write protect group enable
 +
|-
 +
| <code>DefaultECC:Byte;</code>
 +
| Manufacturer default ECC (MMC/eMMC Only)
 +
|-
 +
| <code>ReadToWriteFactor:Byte;</code>
 +
| Write speed factor
 +
|-
 +
| <code>WriteBlockLength:Byte;</code>
 +
| Max. write data block length
 +
|-
 +
| <code>WriteBlockPartial:Boolean;</code>
 +
| Partial blocks for write allowed
 +
|-
 +
| <code>ContentProtectApplication:Boolean;</code>
 +
| Content protection application (MMC/eMMC Only)
 +
|-
 +
| <code>FileFormatGroup:Byte;</code>
 +
| File format group
 +
|-
 +
| <code>CopyFlag:Boolean;</code>
 +
| Copy flag
 +
|-
 +
| <code>PermanentWriteProtect:Boolean;</code>
 +
| Permanent write protection
 +
|-
 +
| <code>TemporaryWriteProtect:Boolean;</code>
 +
| Temporary write protection
 +
|-
 +
| <code>FileFormat:Byte;</code>
 +
| File format
 +
|-
 +
| <code>ECC:Byte;</code>
 +
| ECC code (MMC/eMMC Only)
 +
|-
 +
| <code>CRC:Byte;</code>
 +
| CRC
 +
|-
 +
|colspan="2"|''Calculated Values''
 +
|-
 +
| <code>DataAccessTime:LongWord;</code>
 +
| In Nanoseconds
 +
|-
 +
| <code>DataAccessClocks:Word;</code>
 +
| In Clock cycles
 +
|-
 +
| <code>DataTransferRate:LongWord;</code>
 +
| In Hz
 +
|-
 +
| <code>EraseSize:LongWord;</code>
 +
| In Sectors
 +
|-
 +
| <code>BlockSize:LongWord;</code>
 +
| "Normalized" Block Size
 +
|-
 +
| <code>BlockCount:LongWord;</code>
 +
| In "Normalized" Blocks
 +
|-
 +
| <code>BlockShift:LongWord;</code>
 +
| "Normalized" Block Shift
 +
|-
 +
|}
 +
</div></div> 
 +
 +
'''SD status data (SSR)'''
 +
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
 +
<code>PSDStatusData = ^TSDStatusData;</code>
 +
 
 +
<code>TSDStatusData = record</code>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
|colspan="2"|Note: See: Section 4.10.2 of SD Physical Layer Simplified Specification Version 4.10 (Defined here for MMC Device)
 +
|-
 +
|colspan="2"|''Card Values''
 +
|-
 +
| <code>BusWidth:Byte;</code>
 +
| Shows the currently defined data bus width that was defined by SET_BUS_WIDTH command
 +
|-
 +
| <code>SecuredMode:Boolean;</code>
 +
| Card is in Secured Mode of operation (refer to the "Part 3 Security Specification")
 +
|-
 +
| <code>CardType:Word;</code>
 +
| 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
 +
|-
 +
| <code>ProtectedSize:LongWord;</code>
 +
| Size of protected area
 +
|-
 +
| <code>SpeedClass:Byte;</code>
 +
| Speed Class of the card
 +
|-
 +
| <code>PerformanceMove:Byte;</code>
 +
| Performance of move indicated by 1 [MB/s] step
 +
|-
 +
| <code>EraseSize:Word;</code>
 +
| Number of AUs to be erased at a time
 +
|-
 +
| <code>EraseTimeout:Byte;</code>
 +
| Timeout value for erasing areas specified by UNIT_OF_ERASE_AU
 +
|-
 +
| <code>EraseOffset:Byte;</code>
 +
| Fixed offset value added to erase time
 +
|-
 +
| <code>UHSSpeedGrade:Byte;</code>
 +
| Speed Grade for UHS mode
 +
|-
 +
|colspan="2"|''Calculated Values''
 +
|-
 +
| <code>AllocationUnitSize:Byte;</code>
 +
| Size of Allocation Unit
 +
|-
 +
| <code>UHSAllocationUnitSize:Byte;</code>
 +
| Size of Allocation Unit for UHS mode
 +
|-
 +
|}
 +
</div></div> 
 +
 
 +
'''SD switch data'''
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
 +
<code>PSDSwitchData = ^TSDSwitchData;</code>
 +
 
 +
<code>TSDSwitchData = record</code>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
|colspan="2"|Note: See: Section 4.3.10 of SD Physical Layer Simplified Specification Version 4.10
 +
|-
 +
|colspan="2"|''Card Values''
 +
|-
 +
| <code>MaximumCurrent:Word;</code>
 +
| Maximum Current/Power Consumption
 +
|-
 +
| <code>Group6Support:Word;</code>
 +
| Support Bits of Functions in Function Group 6
 +
|-
 +
| <code>Group5Support:Word;</code>
 +
| Support Bits of Functions in Function Group 5
 +
|-
 +
| <code>Group4Support:Word;</code>
 +
| Support Bits of Functions in Function Group 4
 +
|-
 +
| <code>Group3Support:Word;</code>
 +
| Support Bits of Functions in Function Group 3
 +
|-
 +
| <code>Group2Support:Word;</code>
 +
| Support Bits of Functions in Function Group 2
 +
|-
 +
| <code>Group1Support:Word;</code>
 +
| Support Bits of Functions in Function Group 1
 +
|-
 +
| <code>Group6Selection:Byte;</code>
 +
| Function Selection of Function Group 6
 +
|-
 +
| <code>Group5Selection:Byte;</code>
 +
| Function Selection of Function Group 5
 +
|-
 +
| <code>Group4Selection:Byte;</code>
 +
| Function Selection of Function Group 4
 +
|-
 +
| <code>Group3Selection:Byte;</code>
 +
| Function Selection of Function Group 3
 +
|-
 +
| <code>Group2Selection:Byte;</code>
 +
| Function Selection of Function Group 2
 +
|-
 +
| <code>Group1Selection:Byte;</code>
 +
| Function Selection of Function Group 1
 +
|-
 +
| <code>StructureVersion:Byte;</code>
 +
| Data Structure Version
 +
|-
 +
| <code>Group6BusyStatus:Word;</code>
 +
| Busy Status of functions in group 6
 +
|-
 +
| <code>Group5BusyStatus:Word;</code>
 +
| Busy Status of functions in group 5
 +
|-
 +
| <code>Group4BusyStatus:Word;</code>
 +
| Busy Status of functions in group 4
 +
|-
 +
| <code>Group3BusyStatus:Word;</code>
 +
| Busy Status of functions in group 3
 +
|-
 +
| <code>Group2BusyStatus:Word;</code>
 +
| Busy Status of functions in group 2
 +
|-
 +
| <code>Group1BusyStatus:Word;</code>
 +
| Busy Status of functions in group 1
 +
|-
 +
|}
 +
</div></div> 
 +
 +
'''SD configuration data (SCR)'''
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
 +
<code>PSDConfigurationData = ^TSDConfigurationData;</code>
 +
 
 +
<code>TSDConfigurationData = record</code>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
|colspan="2"|Note: See: Section 5.6 of SD Physical Layer Simplified Specification Version 4.10 (Defined here for MMC Device)
 +
|-
 +
|colspan="2"|''Card Values''
 +
|-
 +
| <code>SCRStructure:Byte;</code>
 +
| SCR Structure version
 +
|-
 +
| <code>SpecVersion:Byte;</code>
 +
| SD Memory Card - Spec. Version
 +
|-
 +
| <code>DataAfterErase:Byte;</code>
 +
| Data status after erases
 +
|-
 +
| <code>Security:Byte;</code>
 +
| CPRM Security Support
 +
|-
 +
| <code>SpecVersion3:Boolean;</code>
 +
| Spec. Version 3.00 or higher
 +
|-
 +
| <code>ExtendedSecurity:Byte;</code>
 +
| Extended Security Support
 +
|-
 +
| <code>SpecVersion4:Boolean;    {Spec. Version 4.00 or higher}</code>
 +
| Spec. Version 4.00 or higher
 +
|-
 +
| <code>CommandSupport:Byte;</code>
 +
| Command Support bits
 +
|-
 +
|colspan="2"|''Calculated Values''
 +
|-
 +
| <code>ErasedByte:Byte;</code>
 +
| Value after Erase
 +
|-
 +
|}
 +
</div></div>
 +
 
 +
'''MMC enumeration callback'''
 +
 
 +
{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
 +
|-
 +
| <code>TMMCEnumerate = function(MMC:PMMCDevice; Data:Pointer):LongWord;</code>
 +
| style="width: 40%;"|
 +
|-
 +
|}
 +
 
 +
'''MMC notification callback'''
 +
 
 +
{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
 +
|-
 +
| <code>TMMCNotification = function(Device:PDevice; Data:Pointer; Notification:LongWord):LongWord;</code>
 +
| style="width: 40%;"|
 +
|-
 +
|}
 +
 
 +
'''MMC device initialize'''
 +
 
 +
{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
 +
|-
 +
| <code>TMMCDeviceInitialize = function(MMC:PMMCDevice):LongWord;</code>
 +
| style="width: 40%;"|
 +
|-
 +
|}
 +
 
 +
'''MMC device deinitialize'''
 +
 
 +
{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
 +
|-
 +
| <code>TMMCDeviceDeinitialize = function(MMC:PMMCDevice):LongWord;</code>
 +
| style="width: 40%;"|
 +
|-
 +
|}
 +
 
 +
'''MMC device get card detect'''
 +
{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
 +
|-
 +
| <code>TMMCDeviceGetCardDetect = function(MMC:PMMCDevice):LongWord;</code>
 +
| style="width: 40%;"|
 +
|-
 +
|}
 +
 
 +
'''MMC device get write protect'''
 +
 
 +
{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
 +
|-
 +
| <code>TMMCDeviceGetWriteProtect = function(MMC:PMMCDevice):LongWord;</code>
 +
| style="width: 40%;"|
 +
|-
 +
|}
 +
 
 +
'''MMC device send command'''
 +
 
 +
{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
 +
|-
 +
| <code>TMMCDeviceSendCommand = function(MMC:PMMCDevice; Command:PMMCCommand):LongWord;</code>
 +
| style="width: 40%;"|
 +
|-
 +
|}
 +
 
 +
'''MMC device set IOS'''
 +
 
 +
{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
 +
|-
 +
| <code>TMMCDeviceSetIOS = function(MMC:PMMCDevice):LongWord;</code>
 +
| style="width: 40%;"|
 +
|-
 +
|}
 +
 
 +
'''MMC device types'''
 +
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
 +
<code>PMMCDevice = ^TMMCDevice;</code>
 +
 
 +
<code>TMMCDevice = record</code>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
|colspan="2"|''Device Properties''
 +
|-
 +
| <code>Device:TDevice;</code>
 +
| The Device entry for this MMC
 +
|-
 +
|colspan="2"|''MMC Properties''
 +
|-
 +
| <code>MMCId:LongWord;</code>
 +
| Unique Id of this MMC in the MMC table
 +
|-
 +
| <code>MMCState:LongWord;</code>
 +
| MMC state (eg MMC_STATE_INSERTED)
 +
|-
 +
| <code>DeviceInitialize:TMMCDeviceInitialize;</code>
 +
| A Device specific DeviceInitialize method implementing a standard MMC device interface (Or nil if the default method is suitable)
 +
|-
 +
| <code>DeviceDeinitialize:TMMCDeviceDeinitialize;</code>
 +
| A Device specific DeviceDeinitialize method implementing a standard MMC device interface (Or nil if the default method is suitable)
 +
|-
 +
| <code>DeviceGetCardDetect:TMMCDeviceGetCardDetect;</code>
 +
| A Device specific DeviceGetCardDetect method implementing a standard MMC device interface (Or nil if the default method is suitable)
 +
|-
 +
| <code>DeviceGetWriteProtect:TMMCDeviceGetWriteProtect;</code>
 +
| A Device specific DeviceGetWriteProtect method implementing a standard MMC device interface (Or nil if the default method is suitable)
 +
|-
 +
| <code>DeviceSendCommand:TMMCDeviceSendCommand;</code>
 +
| A Device specific DeviceSendCommand method implementing a standard MMC device interface (Or nil if the default method is suitable)
 +
|-
 +
| <code>DeviceSetIOS:TMMCDeviceSetIOS;</code>
 +
| A Device specific DeviceSetIOS method implementing a standard MMC device interface (Or nil if the default method is suitable)
 +
|-
 +
|colspan="2"|''Statistics Properties''
 +
|-
 +
| <code>CommandCount:LongWord;</code>
 +
| &nbsp;
 +
|-
 +
| <code>CommandErrors:LongWord;</code>
 +
| &nbsp;
 +
|-
 +
|colspan="2"|''Driver Properties''
 +
|-
 +
| <code>Lock:TMutexHandle;</code>
 +
| Device lock
 +
|-
 +
| <code>Version:LongWord;</code>
 +
| &nbsp;
 +
|-
 +
| <code>Clock:LongWord;</code>
 +
| &nbsp;
 +
|-
 +
| <code>BusWidth:LongWord;</code>
 +
| &nbsp;
 +
|-
 +
| <code>Voltages:LongWord;</code>
 +
| &nbsp;
 +
|-
 +
| <code>Capabilities:LongWord;</code>
 +
| &nbsp;
 +
|-
 +
|colspan="2"|''Register Properties''
 +
|-
 +
|colspan="2"|See: Table 3-2: SD Memory Card Registers of SD Physical Layer Simplified Specification Version 4.10
 +
|-
 +
| <code>InterfaceCondition:LongWord;</code>
 +
| Interface Condition Result
 +
|-
 +
| <code>OperationCondition:LongWord;</code>
 +
| Operation Condition Register (OCR) See: Section 5.1 of SD Physical Layer Simplified Specification Version 4.10
 +
|-
 +
| <code>RelativeCardAddress:LongWord;</code>
 +
| Relative Card Address (RCA) (Word) See: Section 5.4 of SD Physical Layer Simplified Specification Version 4.10
 +
|-
 +
| <code>CardSpecific:array[0..3] of LongWord;</code>
 +
| Card Specific Data (CSD) See: Section 5.3 of SD Physical Layer Simplified Specification Version 4.10
 +
|-
 +
| <code>CardIdentification:array[0..3] of LongWord;</code>
 +
| Card Identification Data (CID) See: Section 5.2 of SD Physical Layer Simplified Specification Version 4.10
 +
|-
 +
| <code>CardStatus:LongWord;</code>
 +
| Card Status Register (CSR) See: Section 4.10.1 of SD Physical Layer Simplified Specification Version 4.10
 +
|-
 +
| <code>DriverStage:LongWord;</code>
 +
| Driver Stage Register (DSR) (Word) See: Section 5.5 of SD Physical Layer Simplified Specification Version 4.10
 +
|-
 +
| <code>SDStatus:array[0..15] of LongWord;</code>
 +
| SD Status Register (SSR) See: Section 4.10.2 of SD Physical Layer Simplified Specification Version 4.10
 +
|-
 +
| <code>SDSwitch:array[0..15] of LongWord;</code>
 +
| SD Switch Status See: Section 4.3.10 of SD Physical Layer Simplified Specification Version 4.10
 +
|-
 +
| <code>SDConfiguration:array[0..1] of LongWord;</code>
 +
| SD Configuration Register (SCR) See: Section 5.6 of SD Physical Layer Simplified Specification Version 4.10
 +
|-
 +
|colspan="2"|''Configuration Properties''
 +
|-
 +
| <code>CardSpecificData:TMMCCardSpecificData;</code>
 +
| &nbsp;
 +
|-
 +
| <code>CardIdentificationData:TMMCCardIdentificationData;</code>
 +
| &nbsp;
 +
|-
 +
| <code>SDStatusData:TSDStatusData;</code>
 +
| &nbsp;
 +
|-
 +
| <code>SDSwitchData:TSDSwitchData;</code>
 +
| &nbsp;
 +
|-
 +
| <code>SDConfigurationData:TSDConfigurationData;</code>
 +
| &nbsp;
 +
|-
 +
|colspan="2"|''Storage Properties''
 +
|-
 +
| <code>Storage:PStorageDevice;</code>
 +
| The Storage entry for this MMC (Where Applicable)
 +
|-
 +
|colspan="2"|''Internal Properties''
 +
|-
 +
| <code>Prev:PMMCDevice;</code>
 +
| Previous entry in MMC table
 +
|-
 +
| <code>Next:PMMCDevice;</code>
 +
| Next entry in MMC table
 +
|-
 +
|}
 +
</div></div> 
 +
 
 +
'''SDHCI enumeration callback'''
 +
 
 +
{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
 +
|-
 +
| <code>TSDHCIEnumerate = function(SDHCI:PSDHCIHost; Data:Pointer):LongWord;</code>
 +
| style="width: 40%;"|
 +
|-
 +
|}
 +
 
 +
'''SDHCI notification callback'''
 +
 
 +
{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
 +
|-
 +
| <code>TSDHCINotification = function(Device:PDevice; Data:Pointer; Notification:LongWord):LongWord;</code>
 +
| style="width: 40%;"|
 +
|-
 +
|}
 +
 
 +
'''SDHCI host start'''
 +
 
 +
{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
 +
|-
 +
| <code>TSDHCIHostStart = function(SDHCI:PSDHCIHost):LongWord;</code>
 +
| style="width: 40%;"|
 +
|-
 +
|}
 +
 
 +
'''SDHCI host stop'''
 +
 
 +
{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
 +
|-
 +
| <code>TSDHCIHostStop = function(SDHCI:PSDHCIHost):LongWord;</code>
 +
| style="width: 40%;"|
 +
|-
 +
|}
 +
 
 +
'''SDHCI host read byte'''
 +
 
 +
{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
 +
|-
 +
| <code>TSDHCIHostReadByte = function(SDHCI:PSDHCIHost; Reg:LongWord):Byte;</code>
 +
| style="width: 40%;"|
 +
|-
 +
|}
 +
 
 +
'''SDHCI host read word'''
 +
 +
{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
 +
|-
 +
| <code>TSDHCIHostReadWord = function(SDHCI:PSDHCIHost; Reg:LongWord):Word;</code>
 +
| style="width: 40%;"|
 +
|-
 +
|}
 +
 
 +
'''SDHCI host read long'''
 +
 +
{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
 +
|-
 +
| <code>TSDHCIHostReadLong = function(SDHCI:PSDHCIHost; Reg:LongWord):LongWord;</code>
 +
| style="width: 40%;"|
 +
|-
 +
|}
 +
 
 +
'''SDHCI host write byte'''
 +
 
 +
{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
 +
|-
 +
| <code>TSDHCIHostWriteByte = procedure(SDHCI:PSDHCIHost; Reg:LongWord; Value:Byte);</code>
 +
| style="width: 40%;"|
 +
|-
 +
|}
 +
 
 +
'''SDHCI host write word'''
 +
 +
{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
 +
|-
 +
| <code>TSDHCIHostWriteWord = procedure(SDHCI:PSDHCIHost; Reg:LongWord; Value:Word);</code>
 +
| style="width: 40%;"|
 +
|-
 +
|}
 +
 
 +
'''SDHCI host write long'''
 +
 
 +
{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
 +
|-
 +
| <code>TSDHCIHostWriteLong = procedure(SDHCI:PSDHCIHost; Reg:LongWord; Value:LongWord);</code>
 +
| style="width: 40%;"|
 +
|-
 +
|}
 +
 
 +
'''SDHCI host set clock divider'''
 +
 
 +
{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
 +
|-
 +
| <code>TSDHCIHostSetClockDivider = function(SDHCI:PSDHCIHost; Index:Integer; Divider:LongWord):LongWord;</code>
 +
| style="width: 40%;"|
 +
|-
 +
|}
 +
 
 +
'''SDHCI host set control register'''
 +
 
 +
{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
 +
|-
 +
| <code>TSDHCIHostSetControlRegister = function(SDHCI:PSDHCIHost):LongWord;</code>
 +
| style="width: 40%;"|
 +
|-
 +
|}
 +
 +
'''SDHCI host types'''
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
 +
<code>PSDHCIHost = ^TSDHCIHost;</code>
 +
 
 +
<code>TSDHCIHost = record</code>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
|colspan="2"|''Device Properties''
 +
|-
 +
| <code>Device:TDevice;</code>
 +
| The Device entry for this SDHCI
 +
|-
 +
|colspan="2"|''SDHCI Properties''
 +
|-
 +
| <code>SDHCIId:LongWord;</code>
 +
| Unique Id of this SDHCI in the SDHCI table
 +
|-
 +
| <code>SDHCIState:LongWord;</code>
 +
| SDHCI state (eg SDHCI_STATE_ENABLED)
 +
|-
 +
| <code>HostStart:TSDHCIHostStart;</code>
 +
| A Host specific HostStart method implementing a standard SDHCI host interface
 +
|-
 +
| <code>HostStop:TSDHCIHostStop;</code>
 +
| A Host specific HostStop method implementing a standard SDHCI host interface
 +
|-
 +
| <code>HostReadByte:TSDHCIHostReadByte;</code>
 +
| A Host specific HostReadByte method implementing a standard SDHCI host interface (Or nil if the default method is suitable)
 +
|-
 +
| <code>HostReadWord:TSDHCIHostReadWord;</code>
 +
| A Host specific HostReadWord method implementing a standard SDHCI host interface (Or nil if the default method is suitable)
 +
|-
 +
| <code>HostReadLong:TSDHCIHostReadLong;</code>
 +
| A Host specific HostReadLong method implementing a standard SDHCI host interface (Or nil if the default method is suitable)
 +
|-
 +
| <code>HostWriteByte:TSDHCIHostWriteByte;</code>
 +
| A Host specific HostWriteByte method implementing a standard SDHCI host interface (Or nil if the default method is suitable)
 +
|-
 +
| <code>HostWriteWord:TSDHCIHostWriteWord;</code>
 +
| A Host specific HostWriteWord method implementing a standard SDHCI host interface (Or nil if the default method is suitable)
 +
|-
 +
| <code>HostWriteLong:TSDHCIHostWriteLong;</code>
 +
| A Host specific HostWriteLong method implementing a standard SDHCI host interface (Or nil if the default method is suitable)
 +
|-
 +
| <code>HostSetClockDivider:TSDHCIHostSetClockDivider;</code>
 +
| &nbsp;
 +
|-
 +
| <code>HostSetControlRegister:TSDHCIHostSetControlRegister;</code>
 +
| &nbsp;
 +
|-
 +
| <code>DeviceInitialize:TMMCDeviceInitialize;</code>
 +
| A Device specific DeviceInitialize method implementing a standard MMC device interface (Or nil if the default method is suitable)
 +
|-
 +
| <code>DeviceDeinitialize:TMMCDeviceDeinitialize;</code>
 +
| A Device specific DeviceDeinitialize method implementing a standard MMC device interface (Or nil if the default method is suitable)
 +
|-
 +
| <code>DeviceGetCardDetect:TMMCDeviceGetCardDetect;</code>
 +
| A Device specific DeviceGetCardDetect method implementing a standard MMC device interface (Or nil if the default method is suitable)
 +
|-
 +
| <code>DeviceGetWriteProtect:TMMCDeviceGetWriteProtect;</code>
 +
| A Device specific DeviceGetWriteProtect method implementing a standard MMC device interface (Or nil if the default method is suitable)
 +
|-
 +
| <code>DeviceSendCommand:TMMCDeviceSendCommand;</code>
 +
| A Device specific DeviceSendCommand method implementing a standard MMC device interface (Or nil if the default method is suitable)
 +
|-
 +
| <code>DeviceSetIOS:TMMCDeviceSetIOS;</code>
 +
| A Device specific DeviceSetIOS method implementing a standard MMC device interface (Or nil if the default method is suitable)
 +
|-
 +
|colspan="2"|''Driver Properties''
 +
|-
 +
| <code>Lock:TMutexHandle;</code>
 +
| Host lock
 +
|-
 +
| <code>Address:Pointer;</code>
 +
| Host register base address
 +
|-
 +
| <code>Version:LongWord;</code>
 +
| Host version information
 +
|-
 +
| <code>Quirks:LongWord;</code>
 +
| Host quirks/bugs flags
 +
|-
 +
| <code>Quirks2:LongWord;</code>
 +
| Host additional quirks/bugs flags
 +
|-
 +
| <code>Clock:LongWord;</code>
 +
| Host current clock
 +
|-
 +
| <code>BusWidth:LongWord;</code>
 +
| Host current bus width
 +
|-
 +
| <code>Interrupts:LongWord;</code>
 +
| Host interrupts to be handled
 +
|-
 +
| <code>Voltages:LongWord;</code>
 +
| Host configured voltage flags
 +
|-
 +
| <code>Capabilities:LongWord;</code>
 +
| Host configured capabilities flags
 +
|-
 +
| <code>MinimumFrequency:LongWord;</code>
 +
| Host configured minimum frequency
 +
|-
 +
| <code>MaximumFrequency:LongWord;</code>
 +
| Host configured maximum frequency
 +
|-
 +
| <code>MaximumBlockCount:LongWord;</code>
 +
| Host configured maximum block count
 +
|-
 +
| <code>Command:PMMCCommand;</code>
 +
| Currently processing command
 +
|-
 +
| <code>Wait:TSemaphoreHandle;</code>
 +
| Command completed semaphore
 +
|-
 +
|colspan="2"|''Configuration Properties''
 +
|-
 +
| <code>PresetVoltages:LongWord;</code>
 +
| Host predefined voltage flags
 +
|-
 +
| <code>PresetCapabilities:LongWord;</code>
 +
| Host predefined capabilities flags
 +
|-
 +
| <code>ClockMinimum:LongWord;</code>
 +
| Host predefined minimum clock frequency
 +
|-
 +
| <code>ClockMaximum:LongWord;</code>
 +
| Host predefined maximum clock frequency
 +
|-
 +
| <code>DriverStageRegister:LongWord;</code>
 +
| Host predefined driver stage register (DSR)
 +
|-
 +
|colspan="2"|''Statistics Properties''
 +
|-
 +
| <code>InterruptCount:LongWord;</code>
 +
| Number of interrupt requests received by the host
 +
|-
 +
|colspan="2"|''Internal Properties''
 +
|-
 +
| <code>Prev:PSDHCIHost;</code>
 +
| Previous entry in SDHCI table
 +
|-
 +
| <code>Next:PSDHCIHost;</code>
 +
| Next entry in SDHCI table
 +
|-
 +
|}
 +
</div></div> 
 +
<br />
  
 
=== Public variables ===
 
=== Public variables ===

Revision as of 01:52, 22 January 2017

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.

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 2 tier (ie Host and Device) whereas the USB interface is 3 tier (Host, Device and Driver).

Constants


[Expand]
MMC specific constants MMC_*


[Expand]
MMC device type constants MMC_TYPE_*


[Expand]
MMC device state constants MMC_STATE_*


[Expand]
MMC device flag constants MMC_FLAG_*


[Expand]
MMC/SD status code constants MMC_STATUS_*


[Expand]
MMC/SD version constants SD_VERSION_*, MMC_VERSION_*


[Expand]
MMC/SD mode constants MMC_MODE_*


[Expand]
MMC/SD direction constants MMC_DATA_*


[Expand]
MMC/SD bus width constants MMC_BUS_WIDTH_*


[Expand]
MMC bus speed (Hz) constants MMC_BUS_SPEED_*


[Expand]
MMC command constants MMC_CMD_*


[Expand]
MMC response type constants MMC_RSP_*


[Expand]
MMC response value constants MMC_RSP_R1_*, MMC_RSP_R2_*


[Expand]
MMC operation condition register (OCR) value constants MMC_OCR_*


[Expand]
MMC card status register (CSR) value constants MMC_CARD_STATUS_*


[Expand]
MMC current state value constants MMC_CURRENT_STATE_*


[Expand]
MMC card identification data (CID) value constants MMC_CID_*


[Expand]
MMC card specific data (CSD) value constants MMC_CSD_*


[Expand]
MMC CSD structure value constants MMC_CSD_STRUCT_*


[Expand]
MMC CSD spec version value constants MMC_CSD_SPEC_VER_*


[Expand]
MMC CSD TAAC time unit constants MMC_CSD_TAAC_UNITS*


[Expand]
MMC CSD TAAC time value constants MMC_CSD_TAAC_VALUES*


[Expand]
MMC CSD card command class (CCC) value constants MMC_CCC_*


[Expand]
MMC CSD transfer speed rate unit constants MMC_CSD_TRAN_SPEED_UNITS*


[Expand]
MMC CSD transfer speed time value constants MMC_CSD_TRAN_SPEED_VALUES*


[Expand]
MMC voltage value constants MMC_VDD_*


[Expand]
MMC switch mode value constants MMC_SWITCH_MODE_*


[Expand]
MMC EXT_CSD field constants EXT_CSD_*


[Expand]
MMC EXT_CSD field definition constants EXT_CSD_*


[Expand]
MMC Misc constants MMCPART_*, MMC_MAX_*


[Expand]
MMC logging constants MMC_LOG_*


[Expand]
SD specific constants SD_*


[Expand]
SD bus width constants SD_BUS_WIDTH_*


[Expand]
SD bus speed (Hz) constants SD_BUS_SPEED_*


[Expand]
SD command constants SD_CMD_*


[Expand]
SD switch mode value constants SD_SWITCH_MODE_*


[Expand]
SD switch function group constants SD_SWITCH_FUNCTION_GROUP_*


[Expand]
SD switch access mode constants SD_SWITCH_ACCESS_MODE_*


[Expand]
SD switch command system constants SD_SWITCH_COMMAND_SYSTEM_*


[Expand]
SD switch driver strength constants SD_SWITCH_DRIVER_STRENGTH_*


[Expand]
SD switch power limit constants SD_SWITCH_POWER_LIMIT_*


[Expand]
SD send interface condition value constants SD_SEND_IF_COND_*


[Expand]
SD send operation condition value constants SD_SEND_OP_COND_*


[Expand]
SD operation condition register value constants SD_OCR_*


[Expand]
SD CSD structure value constants SD_CSD_STRUCT_*


[Expand]
SD SD status register (SSR) value constants SD_SSR_*


[Expand]
SD SSR bus width value constants SD_SSR_BUS_WIDTH_*


[Expand]
SD SSR card type value constants SD_SSR_CARD_TYPE_*


[Expand]
SD SSR speed class value constants SD_SSR_SPEED_CLASS_*


[Expand]
SD SSR AU size value constants SD_SSR_AU_SIZE_*


[Expand]
SD SSR UHS speed grade value constants SD_SSR_UHS_SPEED_*


[Expand]
SD SSR UHS AU size value constants SD_SSR_UHS_AU_SIZE_*


[Expand]
SD switch status value constants SD_SWITCH_*


[Expand]
SD SD configuration register (SCR) value constants SD_SCR_*


[Expand]
SD SCR structure value constants SD_SCR_STRUCT_*


[Expand]
SD SCR Spec version value constants SD_SCR_SPEC_VER_*


[Expand]
SD SCR security value constants SD_SCR_SECURITY_*


[Expand]
SD SCR bus width value constants SD_SCR_BUS_WIDTH_*


[Expand]
SD SCR extended security value constants SD_SCR_EX_SECURITY_*


[Expand]
SD SCR command support value constants SD_SCR_*_SUPPORT


[Expand]
SDIO command constants SDIO_CMD_*


[Expand]
SDIO response value constants SDIO_RSP_*


[Expand]
SDIO card common control registers (CCCR) constants SDIO_CCCR_*


[Expand]
SDIO revision constants SDIO_*_REV_*


[Expand]
SDIO bus width constants SDIO_BUS_*


[Expand]
SDIO CCCR caps register value constants SDIO_CCCR_CAP_*


[Expand]
SDIO CCCR power register value constants SDIO_POWER_*


[Expand]
SDIO CCCR speed register value constants SDIO_SPEED_*


[Expand]
SDIO CCCR UHS register value constants SDIO_UHS_*


[Expand]
SDIO CCCR drive strength register value constants SDIO_DRIVE_*


[Expand]
SDIO function basic register (FBR) constants SDIO_FBR_*


[Expand]
SDHCI specific constants SDHCI_*


[Expand]
SDHCI host type constants SDHCI_TYPE_*


[Expand]
SDHCI host state constants SDHCI_STATE_*


[Expand]
SDHCI host flag constants SDHCI_FLAG_*


[Expand]
SDHCI controller register constants SDHCI_DMA_*, SDHCI_BLOCK_*


[Expand]
SDHCI transfer mode constants SDHCI_TRNS_*


[Expand]
SDHCI command value constants SDHCI_CMD_*


[Expand]
SDHCI command response value constants SDHCI_CMD_RESP_*


[Expand]
SDHCI present state value constants SDHCI_DATA_*, SDHCI_CARD_*


[Expand]
SDHCI host control value constants SDHCI_CTRL_*


[Expand]
SDHCI power control value constants SDHCI_POWER_*


[Expand]
SDHCI wakeup control value constants SDHCI_WAKE_*


[Expand]
SDHCI clock control value constants SDHCI_CLOCK_*


[Expand]
SDHCI software reset value constants SDHCI_RESET_*


[Expand]
SDHCI interrupt value constants SDHCI_INT_*


[Expand]
SDHCI capabilities value constants SDHCI_*_MASK*, SDHCI_*SHIFT


[Expand]
SDHCI host version value constants SDHCI_*_VER_*


[Expand]
SDHCI clock divider constants SDHCI_MAX_CLOCK_DIV_*


[Expand]
SDHCI quirks/bug constants SDHCI_QUIRK*


[Expand]
SDHCI host SDMA buffer boundary constants SDHCI_DEFAULT_BOUNDARY_*


[Expand]
SDHCI timeout value constants SDHCI_TIMEOUT_VALUE*


Type definitions


MMC command

[Expand]

PMMCCommand = ^TMMCCommand;

TMMCCommand = record

MMC data

[Expand]

PMMCData = ^TMMCData;

TMMCData = record

MMC card identification data (CID)

[Expand]

PMMCCardIdentificationData = ^TMMCCardIdentificationData;

TMMCCardIdentificationData = record

MMC card specific erase data (CSD)

[Expand]

TMMCCardSpecificSDEraseData = record

MMC card specific MMC22 erase data

[Expand]

TMMCCardSpecificMMC22EraseData = record

MMC card specific MMC31 erase data

[Expand]

TMMCCardSpecificMMC31EraseData = record

MMC card specific erase data

[Expand]

TMMCCardSpecificEraseData = record

MMC card specific data

[Expand]

PMMCCardSpecificData = ^TMMCCardSpecificData;

TMMCCardSpecificData = record

SD status data (SSR)

[Expand]

PSDStatusData = ^TSDStatusData;

TSDStatusData = record

SD switch data

[Expand]

PSDSwitchData = ^TSDSwitchData;

TSDSwitchData = record

SD configuration data (SCR)

[Expand]

PSDConfigurationData = ^TSDConfigurationData;

TSDConfigurationData = record

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

[Expand]

PMMCDevice = ^TMMCDevice;

TMMCDevice = record

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 set clock divider

TSDHCIHostSetClockDivider = function(SDHCI:PSDHCIHost; Index:Integer; Divider:LongWord):LongWord;

SDHCI host set control register

TSDHCIHostSetControlRegister = function(SDHCI:PSDHCIHost):LongWord;

SDHCI host types

[Expand]

PSDHCIHost = ^TSDHCIHost;

TSDHCIHost = record


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

[Expand] 
procedure MMCInit;
Description: To be documented


[Expand] 
function MMCStart:LongWord;
Description: To be documented


[Expand] 
function MMCStop:LongWord;
Description: To be documented


[Expand] 
procedure MMCAsyncStart(SDHCI:PSDHCIHost);
Description: To be documented


MMC functions

[Expand] 
function MMCDeviceReadBlocks(MMC:PMMCDevice; const Start,Count:Int64; Buffer:Pointer):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceWriteBlocks(MMC:PMMCDevice; const Start,Count:Int64; Buffer:Pointer):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceEraseBlocks(MMC:PMMCDevice; const Start,Count:Int64):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceGoIdle(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceSetClock(MMC:PMMCDevice; Clock:LongWord):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceSetBusWidth(MMC:PMMCDevice; Width:LongWord):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceSetBlockLength(MMC:PMMCDevice; Length:LongWord):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceSetBlockCount(MMC:PMMCDevice; Count:LongWord; Relative:Boolean):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceSetDriverStage(MMC:PMMCDevice; DriverStage:LongWord):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceSelectCard(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceDeselectCard(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceSwitch(MMC:PMMCDevice; Setting,Index,Value:Byte):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceSendCardStatus(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceSendOperationCondition(MMC:PMMCDevice; Probe:Boolean):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceSendCardSpecific(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceDecodeCardSpecific(MMC:PMMCDevice):LongWord;
Description: Given a 128-bit response, decode to our card CSD structure


[Expand] 
function MMCDeviceSendCardIdentification(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceSendAllCardIdentification(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceDecodeCardIdentification(MMC:PMMCDevice):LongWord;
Description: Given a 128-bit response, decode to our card CID structure


[Expand] 
function MMCDeviceGetExtendedCardSpecific(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceSendExtendedCardSpecific(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceDecodeExtendedCardSpecific(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceSetRelativeAddress(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceSPISetCRC(MMC:PMMCDevice; Enable:Boolean):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceSPIReadOperationCondition(MMC:PMMCDevice; HighCapacity:Boolean):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceInsert(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceRemove(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceInitialize(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceDeinitialize(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceGetCardDetect(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceGetWriteProtect(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceSendCommand(MMC:PMMCDevice; Command:PMMCCommand):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceSetIOS(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceCreate:PMMCDevice;
Description: Create a new MMC entry


[Expand] 
function MMCDeviceCreateEx(Size:LongWord):PMMCDevice;
Description: Create a new MMC entry


[Expand] 
function MMCDeviceDestroy(MMC:PMMCDevice):LongWord;
Description: Destroy an existing MMC entry


[Expand] 
function MMCDeviceRegister(MMC:PMMCDevice):LongWord;
Description: Register a new MMC in the MMC table


[Expand] 
function MMCDeviceDeregister(MMC:PMMCDevice):LongWord;
Description: Deregister a MMC from the MMC table


[Expand] 
function MMCDeviceFind(MMCId:LongWord):PMMCDevice;
Description: To be documented


[Expand] 
function MMCDeviceFindByName(const Name:String):PMMCDevice; inline;
Description: To be documented


[Expand] 
function MMCDeviceFindByDescription(const Description:String):PMMCDevice; inline;
Description: To be documented


[Expand] 
function MMCDeviceEnumerate(Callback:TMMCEnumerate; Data:Pointer):LongWord;
Description: To be documented


[Expand] 
function MMCDeviceNotification(MMC:PMMCDevice; Callback:TMMCNotification; Data:Pointer; Notification,Flags:LongWord):LongWord;
Description: To be documented


SD functions

[Expand] 
function SDDeviceSwitch(MMC:PMMCDevice; Mode,Group:Integer; Value:Byte; Buffer:Pointer):LongWord;
Description: To be documented


[Expand] 
function SDDeviceSwitchHighspeed(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function SDDeviceSetBusSpeed(MMC:PMMCDevice; Speed:LongWord):LongWord;
Description: To be documented


[Expand] 
function SDDeviceSetBusWidth(MMC:PMMCDevice; Width:LongWord):LongWord;
Description: To be documented


[Expand] 
function SDDeviceSendInterfaceCondition(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function SDDeviceSendOperationCondition(MMC:PMMCDevice; Probe:Boolean):LongWord;
Description: To be documented


[Expand] 
function SDDeviceGetCardSpecific(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function SDDeviceDecodeCardSpecific(MMC:PMMCDevice):LongWord;
Description: Given a 128-bit response, decode to our card CSD structure


[Expand] 
function SDDeviceGetCardIdentification(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function SDDeviceDecodeCardIdentification(MMC:PMMCDevice):LongWord;
Description: Given a 128-bit response, decode to our card CID structure


[Expand] 
function SDDeviceSendSDStatus(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function SDDeviceDecodeSDStatus(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function SDDeviceSendSDSwitch(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function SDDeviceDecodeSDSwitch(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function SDDeviceSendSDConfiguration(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function SDDeviceDecodeSDConfiguration(MMC:PMMCDevice):LongWord;
Description: Given a 64-bit response, decode to our card SCR structure


[Expand] 
function SDDeviceSendRelativeAddress(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function SDDeviceSendApplicationCommand(MMC:PMMCDevice; Command:PMMCCommand):LongWord;
Description: To be documented


SDIO functions

[Expand] 
function SDIODeviceReset(MMC:PMMCDevice):LongWord;
Description: To be documented


[Expand] 
function SDIODeviceSendOperationCondition(MMC:PMMCDevice; Probe:Boolean):LongWord;
Description: To be documented


[Expand] 
function SDIODeviceReadWriteDirect(MMC:PMMCDevice; Write:Boolean; Operation,Address:LongWord; Input:Byte; Output:PByte):LongWord;
Description: To be documented


[Expand] 
function SDIODeviceReadWriteExtended(MMC:PMMCDevice; Write:Boolean; Operation,Address:LongWord; Increment:Boolean; Buffer:Pointer; BlockCount,BlockSize:LongWord):LongWord;
Description: To be documented


SDHCI functions

[Expand] 
function SDHCIHostReset(SDHCI:PSDHCIHost; Mask:Byte):LongWord;
Description: To be documented


[Expand] 
function SDHCIHostSetPower(SDHCI:PSDHCIHost; Power:Word):LongWord;
Description: To be documented


[Expand] 
function SDHCIHostSetClock(SDHCI:PSDHCIHost; Clock:LongWord):LongWord;
Description: To be documented


[Expand] 
function SDHCIHostTransferPIO(SDHCI:PSDHCIHost):LongWord;
Description: To be documented


[Expand] 
function SDHCIHostTransferDMA(SDHCI:PSDHCIHost):LongWord;
Description: To be documented


[Expand] 
function SDHCIHostFinishCommand(SDHCI:PSDHCIHost):LongWord;
Description: Called by Interrupt Command handler when an SDHCI_INT_RESPONSE is received


[Expand] 
function SDHCIHostFinishData(SDHCI:PSDHCIHost):LongWord;
Description: Called by Interrupt Data handler when data is received


[Expand] 
function SDHCIHostCommandInterrupt(SDHCI:PSDHCIHost; InterruptMask:LongWord; var ReturnMask:LongWord):LongWord;
Description: To be documented


[Expand] 
function SDHCIHostDataInterrupt(SDHCI:PSDHCIHost; InterruptMask:LongWord):LongWord;
Description: To be documented


[Expand] 
function SDHCIHostStart(SDHCI:PSDHCIHost):LongWord;
Description: To be documented


[Expand] 
function SDHCIHostStop(SDHCI:PSDHCIHost):LongWord;
Description: To be documented


[Expand] 
function SDHCIHostReadByte(SDHCI:PSDHCIHost; Reg:LongWord):Byte; inline;
Description: To be documented


[Expand] 
function SDHCIHostReadWord(SDHCI:PSDHCIHost; Reg:LongWord):Word; inline;
Description: To be documented


[Expand] 
function SDHCIHostReadLong(SDHCI:PSDHCIHost; Reg:LongWord):LongWord; inline;
Description: To be documented


[Expand] 
procedure SDHCIHostWriteByte(SDHCI:PSDHCIHost; Reg:LongWord; Value:Byte); inline;
Description: To be documented


[Expand] 
procedure SDHCIHostWriteWord(SDHCI:PSDHCIHost; Reg:LongWord; Value:Word); inline;
Description: To be documented


[Expand] 
procedure SDHCIHostWriteLong(SDHCI:PSDHCIHost; Reg:LongWord; Value:LongWord); inline;
Description: To be documented


[Expand] 
function SDHCIHostSetClockDivider(SDHCI:PSDHCIHost; Index:Integer; Divider:LongWord):LongWord;
Description: To be documented


[Expand] 
function SDHCIHostSetControlRegister(SDHCI:PSDHCIHost):LongWord;
Description: To be documented


[Expand] 
function SDHCIHostCreate:PSDHCIHost;
Description: Create a new SDHCI entry


[Expand] 
function SDHCIHostCreateEx(Size:LongWord):PSDHCIHost;
Description: Create a new SDHCI entry


[Expand] 
function SDHCIHostDestroy(SDHCI:PSDHCIHost):LongWord;
Description: Destroy an existing SDHCI entry


[Expand] 
function SDHCIHostRegister(SDHCI:PSDHCIHost):LongWord;
Description: Register a new SDHCI in the SDHCI table


[Expand] 
function SDHCIHostDeregister(SDHCI:PSDHCIHost):LongWord;
Description: Deregister a SDHCI from the SDHCI table


[Expand] 
function SDHCIHostFind(SDHCIId:LongWord):PSDHCIHost;
Description: To be documented


[Expand] 
function SDHCIHostEnumerate(Callback:TSDHCIEnumerate; Data:Pointer):LongWord;
Description: To be documented


[Expand] 
function SDHCIHostNotification(SDHCI:PSDHCIHost; Callback:TSDHCINotification; Data:Pointer; Notification,Flags:LongWord):LongWord;
Description: To be documented


MMC helper functions

[Expand] 
function MMCGetCount:LongWord; inline;
Description: Get the current MMC count


[Expand] 
function MMCDeviceCheck(MMC:PMMCDevice):PMMCDevice;
Description: Check if the supplied MMC is in the MMC table


[Expand] 
function MMCIsSD(MMC:PMMCDevice):Boolean;
Description: To be documented


[Expand] 
function MMCGetCIDValue(MMC:PMMCDevice; Version,Value:LongWord):LongWord;
Description: Extract a CID field value from the 128 bit Card Identification register


[Expand] 
function MMCGetCSDValue(MMC:PMMCDevice; Value:LongWord):LongWord;
Description: Extract a CSD field value from the 128 bit Card Specific register


[Expand] 
function MMCGetExtendedCSDValue(MMC:PMMCDevice; Value:LongWord):LongWord;
Description: Extract an Extended CSD field value from the 512 byte Extended Card Specific register


[Expand] 
function MMCExtractBits(Buffer:Pointer; Start,Size:LongWord):LongWord;
Description: To be documented


[Expand] 
function MMCExtractBitsEx(Buffer:Pointer; Length,Start,Size:LongWord):LongWord;
Description: To be documented


[Expand] 
function MMCIsMultiCommand(Command:Word):Boolean;
Description: To be documented


[Expand] 
function MMCStatusToString(Status:LongWord):String;
Description: Translates an MMC status code into a string describing it


[Expand] 
function MMCDeviceTypeToString(MMCType:LongWord):String;
Description: To be documented


[Expand] 
function MMCDeviceStateToString(MMCState:LongWord):String;
Description: To be documented


[Expand] 
procedure MMCLog(Level:LongWord; MMC:PMMCDevice; const AText:String);
Description: To be documented


[Expand] 
procedure MMCLogInfo(MMC:PMMCDevice; const AText:String);
Description: To be documented


[Expand] 
procedure MMCLogError(MMC:PMMCDevice; const AText:String);
Description: To be documented


[Expand] 
procedure MMCLogDebug(MMC:PMMCDevice; const AText:String);
Description: To be documented


SD helper functions

[Expand] 
function SDGetMaxClock(MMC:PMMCDevice):LongWord;
Description: Determine the Maximum Clock (DTR) for the current card


[Expand] 
function SDGetCIDValue(MMC:PMMCDevice; Value:LongWord):LongWord;
Description: Extract a CID field value from the 128 bit Card Identification register


[Expand] 
function SDGetCSDValue(MMC:PMMCDevice; Version,Value:LongWord):LongWord;
Description: Extract a CSD field value from the 128 bit Card Specific register


[Expand] 
function SDGetSCRValue(MMC:PMMCDevice; Value:LongWord):LongWord;
Description: Extract an SCR field value from the 64 bit SD Configuration register


[Expand] 
function SDGetSSRValue(MMC:PMMCDevice; Value:LongWord):LongWord;
Description: Extract an SCR field value from the 512 bit SD Status register


[Expand] 
function SDGetSwitchValue(MMC:PMMCDevice; Value:LongWord):LongWord;
Description: Extract a Switch field value from the 512 bit SD Switch status


SDHCI helper functions

[Expand] 
function SDHCIGetCount:LongWord; inline;
Description: Get the current SDHCI count


[Expand] 
function SDHCIHostCheck(SDHCI:PSDHCIHost):PSDHCIHost;
Description: Check if the supplied SDHCI is in the SDHCI table


[Expand] 
function SDHCIIsSPI(SDHCI:PSDHCIHost):Boolean;
Description: To be documented


[Expand] 
function SDHCIGetVersion(SDHCI:PSDHCIHost):Word;
Description: To be documented


[Expand] 
function SDHCIGetCommand(Command:Word):Word;
Description: To be documented


[Expand] 
function SDHCIMakeCommand(Command,Flags:Word):Word;
Description: To be documented


[Expand] 
function SDHCIMakeBlockSize(DMA,BlockSize:Word):Word;
Description: To be documented


[Expand] 
function SDHCIDeviceTypeToString(SDHCIType:LongWord):String;
Description: To be documented


[Expand] 
function SDHCIDeviceStateToString(SDHCIState:LongWord):String;
Description: To be documented


MMC storage functions

[Expand] 
function MMCStorageDeviceRead(Storage:PStorageDevice; const Start,Count:Int64; Buffer:Pointer):LongWord;
Description: To be documented


[Expand] 
function MMCStorageDeviceWrite(Storage:PStorageDevice; const Start,Count:Int64; Buffer:Pointer):LongWord;
Description: To be documented


[Expand] 
function MMCStorageDeviceErase(Storage:PStorageDevice; const Start,Count:Int64):LongWord;
Description: To be documented


[Expand] 
function MMCStorageDeviceControl(Storage:PStorageDevice; Request:Integer; Argument1:LongWord; var Argument2:LongWord):LongWord;
Description: To be documented


Return to Unit Reference

Retrieved from "https://ultibo.org/mediawiki_ultibo_org/index.php?title=Unit_MMC&oldid=2508"