Initializes the SD Host peripheral according to the specified parameters.

• clockDiv: specifies the system clock divider used for SD Host Clock Frequency (system clock / clockDiv).
• config : configuration paramerer. Valid values (can be OR-ed to form desired value) :

  Value	Description
  _SDHOST_CFG_1_WIDE_BUS_MODE	1-bit data width mode.
  _SDHOST_CFG_4_WIDE_BUS_MODE	4-bit data width mode.
  _SDHOST_CFG_CLOCK_RISING_EDGE	The CMD and DAT line output at the rising edge of SCLK.
  _SDHOST_CFG_CLOCK_FALING_EDGE	The CMD and DAT line output at the falling edge of SCLK.

Nothing.

Nothing.

' Initialize SD Host interface
SDHost_Init(128, _SDHOST_CFG_4_WIDE_BUS_MODE or _SDHOST_CFG_CLOCK_RISING_EDGE or _SDHOST_CFG_STREAM_ENABLE)

None.

Sub function detects if an SD card is detected.

None.

• _SDHOST_STATUS_CARD_INSERTED: if an SD card is detected.
• _SDHOST_STATUS_CARD_REMOVED: if an SD card is removed.
• _SDHOST_STATUS_ERROR: if an error occured.

Nothing.

' wait until the card is detected
while(SDHost_CardDetect() <> _SDHOST_STATUS_CARD_INSERTED)
...

None.

Sub function sends a command without data transfer.

• cmdIdx: command index (0 to 63).
• cmdType: command type (bus / application-specific). Valid values :

  Value	Description
  _SDHOST_CMD_TYPE_BUS	CMD52 for writing Bus Suspend in CCCR.
  _SDHOST_CMD_TYPE_APP_SPECIFIC	CMD52 for writing Function Select in CCCR.

• sdioSpecialOp: the SDIO special operation for CMD52 (assign _SDHOST_SPECOP_NOT_IN_USE if the operation is not one of the 3 special ones). Valid values :

  Value	Description
  _SDHOST_SPECOP_WRITE_CCCR_BUS_SUSPEND	CMD52 for writing Bus Suspend in CCCR.
  _SDHOST_SPECOP_WRITE_CCCR_FUNCTION_SELECT	CMD52 for writing Function Select in CCCR.
  _SDHOST_SPECOP_WRITE_CCCR_IO_ABORT	CMD12/52 for writing I/O Abort in CCCR.
  _SDHOST_SPECOP_NOT_IN_USE	Normal commands.

• cmdArg: command argument (32 bits).
• response: a pointer to the array (R2) / variable (others) that will hold the response.

• _SDHOST_STATUS_OK: if no errors occured,
• _SDHOST_STATUS_ERROR: if an error occured,
• _SDHOST_STATUS_CARD_INSERTED: if an SD card is detected,
• _SDHOST_STATUS_CARD_REMOVED: if an SD card is removed,
• _SDHOST_STATUS_INVALID_RESPONSE_TYPE: if invalid reponse type occured,
• _SDHOST_STATUS_CMD_TIMEOUT: if a command timeout has occured,
• _SDHOST_STATUS_UNUSABLE_CARD: if an SD card is unusable,
• _SDHOST_STATUS_CMD2_FAILED: if the CMD2 command failed,
• _SDHOST_STATUS_CMD3_FAILED: if the CMD3 command failed,
• _SDHOST_STATUS_CMD8_FAILED: if the CMD8 command failed,
• _SDHOST_STATUS_CMD9_FAILED: if the CMD9 command failed,
• _SDHOST_STATUS_CMD55_FAILED: if the CMD55 command failed,
• _SDHOST_STATUS_ACMD41_FAILED: if the ACMD41 command failed,
• _SDHOST_STATUS_CANNOT_ENTER_TRANSFER_STATE: if transfer state cannot be entered,
• _SDHOST_STATUS_CANNOT_SET_CARD_BUS_WIDTH: if card bus width cannot be set,
• _SDHOST_STATUS_RESPONSE_ERROR: if response is not in valid format,
• _SDHOST_STATUS_WRITE_ERROR: if writing error occured,
• _SDHOST_STATUS_READ_ERROR: if reading error occured.

Nothing.

' Send CMD16 to set the card's block length (512)
sdHostStatus = SDHost_SendCMD(16, _SDHOST_CMD_TYPE_BUS, _SDHOST_SPECOP_NOT_IN_USE, 512, @response)

None.

Sub function perfoms a data transfer.

• direction: data transfer direction. Valid values :

  Value	Description
  _SDHOST_DIR_WRITE	Write transfer.
  _SDHOST_DIR_READ	Read transfer.

• dataBuf: buffer containing data for transfer.
• numBytes: number of bytes to be transferred.
• addr: sector address.

• _SDHOST_STATUS_OK: if no errors occured,
• _SDHOST_STATUS_ERROR: if an error occured,
• _SDHOST_STATUS_CARD_INSERTED: if an SD card is detected,
• _SDHOST_STATUS_CARD_REMOVED: if an SD card is removed,
• _SDHOST_STATUS_INVALID_RESPONSE_TYPE: if invalid reponse type occured,
• _SDHOST_STATUS_CMD_TIMEOUT: if a command timeout has occured,
• _SDHOST_STATUS_UNUSABLE_CARD: if an SD card is unusable,
• _SDHOST_STATUS_CMD2_FAILED: if the CMD2 command failed,
• _SDHOST_STATUS_CMD3_FAILED: if the CMD3 command failed,
• _SDHOST_STATUS_CMD8_FAILED: if the CMD8 command failed,
• _SDHOST_STATUS_CMD9_FAILED: if the CMD9 command failed,
• _SDHOST_STATUS_CMD55_FAILED: if the CMD55 command failed,
• _SDHOST_STATUS_ACMD41_FAILED: if the ACMD41 command failed,
• _SDHOST_STATUS_CANNOT_ENTER_TRANSFER_STATE: if transfer state cannot be entered,
• _SDHOST_STATUS_CANNOT_SET_CARD_BUS_WIDTH: if card bus width cannot be set,
• _SDHOST_STATUS_RESPONSE_ERROR: if response is not in valid format,
• _SDHOST_STATUS_WRITE_ERROR: if writing error occured,
• _SDHOST_STATUS_READ_ERROR: if reading error occured.

Nothing.

' Initiates a read transfer starting from sector 0, transfers the 512 bytes of data into the inData buffer
sd_status = SDHost_TransferData(_SDHOST_DIR_READ, @inData, 512, 0)

None.

Sub function sends Abort Command following the Asynchronous Abort Sequence.

None.

• _SDHOST_STATUS_OK: if no errors occured,
• _SDHOST_STATUS_ERROR: if an error occured,
• _SDHOST_STATUS_CARD_INSERTED: if an SD card is detected,
• _SDHOST_STATUS_CARD_REMOVED: if an SD card is removed,
• _SDHOST_STATUS_INVALID_RESPONSE_TYPE: if invalid reponse type occured,
• _SDHOST_STATUS_CMD_TIMEOUT: if a command timeout has occured,
• _SDHOST_STATUS_UNUSABLE_CARD: if an SD card is unusable,
• _SDHOST_STATUS_CMD2_FAILED: if the CMD2 command failed,
• _SDHOST_STATUS_CMD3_FAILED: if the CMD3 command failed,
• _SDHOST_STATUS_CMD8_FAILED: if the CMD8 command failed,
• _SDHOST_STATUS_CMD9_FAILED: if the CMD9 command failed,
• _SDHOST_STATUS_CMD55_FAILED: if the CMD55 command failed,
• _SDHOST_STATUS_ACMD41_FAILED: if the ACMD41 command failed,
• _SDHOST_STATUS_CANNOT_ENTER_TRANSFER_STATE: if transfer state cannot be entered,
• _SDHOST_STATUS_CANNOT_SET_CARD_BUS_WIDTH: if card bus width cannot be set,
• _SDHOST_STATUS_RESPONSE_ERROR: if response is not in valid format,
• _SDHOST_STATUS_WRITE_ERROR: if writing error occured,
• _SDHOST_STATUS_READ_ERROR: if reading error occured.

Nothing.

res = SDHost_Abort()

None.

Sub function initializes and identifies the SD card that is detected.

None.

• _SDHOST_STATUS_OK: if no errors occured,
• _SDHOST_STATUS_ERROR: if an error occured,
• _SDHOST_STATUS_CARD_INSERTED: if an SD card is detected,
• _SDHOST_STATUS_CARD_REMOVED: if an SD card is removed,
• _SDHOST_STATUS_INVALID_RESPONSE_TYPE: if invalid reponse type occured,
• _SDHOST_STATUS_CMD_TIMEOUT: if a command timeout has occured,
• _SDHOST_STATUS_UNUSABLE_CARD: if an SD card is unusable,
• _SDHOST_STATUS_CMD2_FAILED: if the CMD2 command failed,
• _SDHOST_STATUS_CMD3_FAILED: if the CMD3 command failed,
• _SDHOST_STATUS_CMD8_FAILED: if the CMD8 command failed,
• _SDHOST_STATUS_CMD9_FAILED: if the CMD9 command failed,
• _SDHOST_STATUS_CMD55_FAILED: if the CMD55 command failed,
• _SDHOST_STATUS_ACMD41_FAILED: if the ACMD41 command failed,
• _SDHOST_STATUS_CANNOT_ENTER_TRANSFER_STATE: if transfer state cannot be entered,
• _SDHOST_STATUS_CANNOT_SET_CARD_BUS_WIDTH: if card bus width cannot be set,
• _SDHOST_STATUS_RESPONSE_ERROR: if response is not in valid format,
• _SDHOST_STATUS_WRITE_ERROR: if writing error occured,
• _SDHOST_STATUS_READ_ERROR: if reading error occured.

Nothing.

sd_status = SDHost_CardInit()

None.

Sub function returns the information stored in the Card Identification Register (CID).

• cid: buffer to store data.

Nothing.

Nothing.

var dataBuffer : array[16] of byte;
...
SDHost_GetCID(@dataBuffer)

For better performance, please set the buffers holding the data to alignment 4.

Sub function returns the information stored in the Card Specific Data Register (CSD).

• csd: buffer to store data.

Nothing.

Nothing.

dim dataBuffer as byte[16]
...
SDHost_GetCSD(@dataBuffer)

For better performance, please set the buffers holding the data to alignment 4.

Sub function reads data stored in a specific sector.

• dataBuf: buffer containing data read from the sector.
• addr: sector address.

• _SDHOST_STATUS_OK: if no errors occured,
• _SDHOST_STATUS_ERROR: if an error occured,
• _SDHOST_STATUS_CARD_INSERTED: if an SD card is detected,
• _SDHOST_STATUS_CARD_REMOVED: if an SD card is removed,
• _SDHOST_STATUS_INVALID_RESPONSE_TYPE: if invalid reponse type occured,
• _SDHOST_STATUS_CMD_TIMEOUT: if a command timeout has occured,
• _SDHOST_STATUS_UNUSABLE_CARD: if an SD card is unusable,
• _SDHOST_STATUS_CMD2_FAILED: if the CMD2 command failed,
• _SDHOST_STATUS_CMD3_FAILED: if the CMD3 command failed,
• _SDHOST_STATUS_CMD8_FAILED: if the CMD8 command failed,
• _SDHOST_STATUS_CMD9_FAILED: if the CMD9 command failed,
• _SDHOST_STATUS_CMD55_FAILED: if the CMD55 command failed,
• _SDHOST_STATUS_ACMD41_FAILED: if the ACMD41 command failed,
• _SDHOST_STATUS_CANNOT_ENTER_TRANSFER_STATE: if transfer state cannot be entered,
• _SDHOST_STATUS_CANNOT_SET_CARD_BUS_WIDTH: if card bus width cannot be set,
• _SDHOST_STATUS_RESPONSE_ERROR: if response is not in valid format,
• _SDHOST_STATUS_WRITE_ERROR: if writing error occured,
• _SDHOST_STATUS_READ_ERROR: if reading error occured.

Nothing.

dim error as byte
...
error = SDHost_ReadSector(@buffer, sector_address)

For better performance, please set the buffers holding the data to alignment 4.

Sub function writes data to a specific sector.

• dataBuf: buffer containing data to be written.
• addr: sector address.

• _SDHOST_STATUS_OK: if no errors occured,
• _SDHOST_STATUS_ERROR: if an error occured,
• _SDHOST_STATUS_CARD_INSERTED: if an SD card is detected,
• _SDHOST_STATUS_CARD_REMOVED: if an SD card is removed,
• _SDHOST_STATUS_INVALID_RESPONSE_TYPE: if invalid reponse type occured,
• _SDHOST_STATUS_CMD_TIMEOUT: if a command timeout has occured,
• _SDHOST_STATUS_UNUSABLE_CARD: if an SD card is unusable,
• _SDHOST_STATUS_CMD2_FAILED: if the CMD2 command failed,
• _SDHOST_STATUS_CMD3_FAILED: if the CMD3 command failed,
• _SDHOST_STATUS_CMD8_FAILED: if the CMD8 command failed,
• _SDHOST_STATUS_CMD9_FAILED: if the CMD9 command failed,
• _SDHOST_STATUS_CMD55_FAILED: if the CMD55 command failed,
• _SDHOST_STATUS_ACMD41_FAILED: if the ACMD41 command failed,
• _SDHOST_STATUS_CANNOT_ENTER_TRANSFER_STATE: if transfer state cannot be entered,
• _SDHOST_STATUS_CANNOT_SET_CARD_BUS_WIDTH: if card bus width cannot be set,
• _SDHOST_STATUS_RESPONSE_ERROR: if response is not in valid format,
• _SDHOST_STATUS_WRITE_ERROR: if writing error occured,
• _SDHOST_STATUS_READ_ERROR: if reading error occured.

Nothing.

dim error as byte
...
error = SDHost_WriteSector(@buffer, sector_address)

For better performance, please set the buffers holding the data to alignment 4.

Sub function starts multi read mode, sectors are sequentially read starting from the sector given in the sub function argument.

• addr: sector address.

• _SDHOST_STATUS_OK: if no errors occured,
• _SDHOST_STATUS_ERROR: if an error occured,
• _SDHOST_STATUS_CARD_INSERTED: if an SD card is detected,
• _SDHOST_STATUS_CARD_REMOVED: if an SD card is removed,
• _SDHOST_STATUS_INVALID_RESPONSE_TYPE: if invalid reponse type occured,
• _SDHOST_STATUS_CMD_TIMEOUT: if a command timeout has occured,
• _SDHOST_STATUS_UNUSABLE_CARD: if an SD card is unusable,
• _SDHOST_STATUS_CMD2_FAILED: if the CMD2 command failed,
• _SDHOST_STATUS_CMD3_FAILED: if the CMD3 command failed,
• _SDHOST_STATUS_CMD8_FAILED: if the CMD8 command failed,
• _SDHOST_STATUS_CMD9_FAILED: if the CMD9 command failed,
• _SDHOST_STATUS_CMD55_FAILED: if the CMD55 command failed,
• _SDHOST_STATUS_ACMD41_FAILED: if the ACMD41 command failed,
• _SDHOST_STATUS_CANNOT_ENTER_TRANSFER_STATE: if transfer state cannot be entered,
• _SDHOST_STATUS_CANNOT_SET_CARD_BUS_WIDTH: if card bus width cannot be set,
• _SDHOST_STATUS_RESPONSE_ERROR: if response is not in valid format,
• _SDHOST_STATUS_WRITE_ERROR: if writing error occured,
• _SDHOST_STATUS_READ_ERROR: if reading error occured.

Nothing.

dim error as byte
dim sector_address as longword
...
error = SDHost_MultiReadStart(sector_address)

None.

The sub procedure reads sectors in multi read mode and places them in the buffer given as the sub function argument. Next sub function call reads the subsequent sector. Buffer size should be 512B.

• dataBuf: buffer for holding the sector data.

• _SDHOST_STATUS_OK: if no errors occured,
• _SDHOST_STATUS_ERROR: if an error occured,
• _SDHOST_STATUS_CARD_INSERTED: if an SD card is detected,
• _SDHOST_STATUS_CARD_REMOVED: if an SD card is removed,
• _SDHOST_STATUS_INVALID_RESPONSE_TYPE: if invalid reponse type occured,
• _SDHOST_STATUS_CMD_TIMEOUT: if a command timeout has occured,
• _SDHOST_STATUS_UNUSABLE_CARD: if an SD card is unusable,
• _SDHOST_STATUS_CMD2_FAILED: if the CMD2 command failed,
• _SDHOST_STATUS_CMD3_FAILED: if the CMD3 command failed,
• _SDHOST_STATUS_CMD8_FAILED: if the CMD8 command failed,
• _SDHOST_STATUS_CMD9_FAILED: if the CMD9 command failed,
• _SDHOST_STATUS_CMD55_FAILED: if the CMD55 command failed,
• _SDHOST_STATUS_ACMD41_FAILED: if the ACMD41 command failed,
• _SDHOST_STATUS_CANNOT_ENTER_TRANSFER_STATE: if transfer state cannot be entered,
• _SDHOST_STATUS_CANNOT_SET_CARD_BUS_WIDTH: if card bus width cannot be set,
• _SDHOST_STATUS_RESPONSE_ERROR: if response is not in valid format,
• _SDHOST_STATUS_WRITE_ERROR: if writing error occured,
• _SDHOST_STATUS_READ_ERROR: if reading error occured.

Nothing.

dim error as byte
...
error = SDHost_MultiReadSector(@buffer)

For better performance, please set the buffers holding the data to alignment 4.

Sub function stops multi read mode sequence.

None.

• _SDHOST_STATUS_OK: if no errors occured,
• _SDHOST_STATUS_ERROR: if an error occured,
• _SDHOST_STATUS_CARD_INSERTED: if an SD card is detected,
• _SDHOST_STATUS_CARD_REMOVED: if an SD card is removed,
• _SDHOST_STATUS_INVALID_RESPONSE_TYPE: if invalid reponse type occured,
• _SDHOST_STATUS_CMD_TIMEOUT: if a command timeout has occured,
• _SDHOST_STATUS_UNUSABLE_CARD: if an SD card is unusable,
• _SDHOST_STATUS_CMD2_FAILED: if the CMD2 command failed,
• _SDHOST_STATUS_CMD3_FAILED: if the CMD3 command failed,
• _SDHOST_STATUS_CMD8_FAILED: if the CMD8 command failed,
• _SDHOST_STATUS_CMD9_FAILED: if the CMD9 command failed,
• _SDHOST_STATUS_CMD55_FAILED: if the CMD55 command failed,
• _SDHOST_STATUS_ACMD41_FAILED: if the ACMD41 command failed,
• _SDHOST_STATUS_CANNOT_ENTER_TRANSFER_STATE: if transfer state cannot be entered,
• _SDHOST_STATUS_CANNOT_SET_CARD_BUS_WIDTH: if card bus width cannot be set,
• _SDHOST_STATUS_RESPONSE_ERROR: if response is not in valid format,
• _SDHOST_STATUS_WRITE_ERROR: if writing error occured,
• _SDHOST_STATUS_READ_ERROR: if reading error occured.

Nothing.

dim error as byte

error = SDHost_MultiReadStop()

None.

Function starts multi write mode, sectors are sequentially written starting from the sector given in the function argument.

• addr: sector address.

• _SDHOST_STATUS_OK: if no errors occured,
• _SDHOST_STATUS_ERROR: if an error occured,
• _SDHOST_STATUS_CARD_INSERTED: if an SD card is detected,
• _SDHOST_STATUS_CARD_REMOVED: if an SD card is removed,
• _SDHOST_STATUS_INVALID_RESPONSE_TYPE: if invalid reponse type occured,
• _SDHOST_STATUS_CMD_TIMEOUT: if a command timeout has occured,
• _SDHOST_STATUS_UNUSABLE_CARD: if an SD card is unusable,
• _SDHOST_STATUS_CMD2_FAILED: if the CMD2 command failed,
• _SDHOST_STATUS_CMD3_FAILED: if the CMD3 command failed,
• _SDHOST_STATUS_CMD8_FAILED: if the CMD8 command failed,
• _SDHOST_STATUS_CMD9_FAILED: if the CMD9 command failed,
• _SDHOST_STATUS_CMD55_FAILED: if the CMD55 command failed,
• _SDHOST_STATUS_ACMD41_FAILED: if the ACMD41 command failed,
• _SDHOST_STATUS_CANNOT_ENTER_TRANSFER_STATE: if transfer state cannot be entered,
• _SDHOST_STATUS_CANNOT_SET_CARD_BUS_WIDTH: if card bus width cannot be set,
• _SDHOST_STATUS_RESPONSE_ERROR: if response is not in valid format,
• _SDHOST_STATUS_WRITE_ERROR: if writing error occured,
• _SDHOST_STATUS_READ_ERROR: if reading error occured.

Nothing.

dim error as longword
error = SDHost_MultiWriteStart(sector_address)

None.

The sub procedure writes sectors in multi write mode. Next sub function call reads the subsequent sector. Buffer size should be 512B.

• dataBuf: buffer holding data to be written.

• _SDHOST_STATUS_OK: if no errors occured,
• _SDHOST_STATUS_ERROR: if an error occured,
• _SDHOST_STATUS_CARD_INSERTED: if an SD card is detected,
• _SDHOST_STATUS_CARD_REMOVED: if an SD card is removed,
• _SDHOST_STATUS_INVALID_RESPONSE_TYPE: if invalid reponse type occured,
• _SDHOST_STATUS_CMD_TIMEOUT: if a command timeout has occured,
• _SDHOST_STATUS_UNUSABLE_CARD: if an SD card is unusable,
• _SDHOST_STATUS_CMD2_FAILED: if the CMD2 command failed,
• _SDHOST_STATUS_CMD3_FAILED: if the CMD3 command failed,
• _SDHOST_STATUS_CMD8_FAILED: if the CMD8 command failed,
• _SDHOST_STATUS_CMD9_FAILED: if the CMD9 command failed,
• _SDHOST_STATUS_CMD55_FAILED: if the CMD55 command failed,
• _SDHOST_STATUS_ACMD41_FAILED: if the ACMD41 command failed,
• _SDHOST_STATUS_CANNOT_ENTER_TRANSFER_STATE: if transfer state cannot be entered,
• _SDHOST_STATUS_CANNOT_SET_CARD_BUS_WIDTH: if card bus width cannot be set,
• _SDHOST_STATUS_RESPONSE_ERROR: if response is not in valid format,
• _SDHOST_STATUS_WRITE_ERROR: if writing error occured,
• _SDHOST_STATUS_READ_ERROR: if reading error occured.

Nothing.

dim error as byte
error = SDHost_MultiWriteStart(@data_buffer)

For better performance, please set the buffers holding the data to alignment 4.

Sub function stops multi write mode sequence.

None.

• _SDHOST_STATUS_OK: if no errors occured,
• _SDHOST_STATUS_ERROR: if an error occured,
• _SDHOST_STATUS_CARD_INSERTED: if an SD card is detected,
• _SDHOST_STATUS_CARD_REMOVED: if an SD card is removed,
• _SDHOST_STATUS_INVALID_RESPONSE_TYPE: if invalid reponse type occured,
• _SDHOST_STATUS_CMD_TIMEOUT: if a command timeout has occured,
• _SDHOST_STATUS_UNUSABLE_CARD: if an SD card is unusable,
• _SDHOST_STATUS_CMD2_FAILED: if the CMD2 command failed,
• _SDHOST_STATUS_CMD3_FAILED: if the CMD3 command failed,
• _SDHOST_STATUS_CMD8_FAILED: if the CMD8 command failed,
• _SDHOST_STATUS_CMD9_FAILED: if the CMD9 command failed,
• _SDHOST_STATUS_CMD55_FAILED: if the CMD55 command failed,
• _SDHOST_STATUS_ACMD41_FAILED: if the ACMD41 command failed,
• _SDHOST_STATUS_CANNOT_ENTER_TRANSFER_STATE: if transfer state cannot be entered,
• _SDHOST_STATUS_CANNOT_SET_CARD_BUS_WIDTH: if card bus width cannot be set,
• _SDHOST_STATUS_RESPONSE_ERROR: if response is not in valid format,
• _SDHOST_STATUS_WRITE_ERROR: if writing error occured,
• _SDHOST_STATUS_READ_ERROR: if reading error occured.

Nothing.

dim error as byte
error = SDHost_MultiWriteStop()

None.