Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Pointer to variable that will receive the return error code from this function:

FS_DEV_SD_CARD_ERR_NONE

No error.

FS_DEV_SD_CARD_ERR_NO_CARD

No card present.

FS_DEV_SD_CARD_ERR_UNKNOWN

Unknown or other error.

FS_DEV_SD_CARD_ERR_WAIT_TIMEOUT

Timeout in waiting for data.

FS_DEV_SD_CARD_ERR_DATA_UNDERRUN

Data underrun.

FS_DEV_SD_CARD_ERR_DATA_CHKSUM

Error in data checksum.

FS_DEV_SD_CARD_ERR_DATA_START_BIT

Data start bit error.

FS_DEV_SD_CARD_ERR_DATA

Other data error.

Returned Value

None.

Notes/Warnings

...

The implementation of FSDev_SD_Card_BSP_CmdDataWr() in Listing C-10 is targeted for the same host controller as the other listings in this chapter; for more information, see FSDev_SD_Card_BSP_CmdStart().

Listing C-10 FSDev_SD_Card_BSP_CmdDataWr()

LC-10(1) Wait until data transfer completes or an error occurs. The wait loop (or wait on semaphore) SHOULD always have a timeout to avoid blocking the task in the case of an unforeseen hardware malfunction or a software flaw.

LC-10(2) Check if an error occurred. The error status register is decoded to produce the actual error condition. That is not necessary, strictly, but error counters that accumulate within the generic driver based upon returned error values may be useful while debugging a port.

LC-10(3) Return no error. The data has been transferred already from the memory buffer using DMA.