Line data    Source code

       1           1 : /*
       2             :  * Copyright 2022 NXP
       3             :  *
       4             :  * SPDX-License-Identifier: Apache-2.0
       5             :  */
       6             : 
       7             : /**
       8             :  * @file
       9             :  * @brief Public API for SD memory card subsystem
      10             :  */
      11             : 
      12             : #ifndef ZEPHYR_INCLUDE_SD_SDMMC_H_
      13             : #define ZEPHYR_INCLUDE_SD_SDMMC_H_
      14             : 
      15             : #include <zephyr/device.h>
      16             : #include <zephyr/drivers/sdhc.h>
      17             : #include <zephyr/sd/sd.h>
      18             : 
      19             : #ifdef __cplusplus
      20             : extern "C" {
      21             : #endif
      22             : 
      23             : /**
      24             :  * @brief Write blocks to SD card from buffer
      25             :  *
      26             :  * Writes blocks from SD buffer to SD card. For best performance, this buffer
      27             :  * should be aligned to CONFIG_SDHC_BUFFER_ALIGNMENT
      28             :  * @param card SD card to write from
      29             :  * @param wbuf write buffer
      30             :  * @param start_block first block to write to
      31             :  * @param num_blocks number of blocks to write
      32             :  * @retval 0 write succeeded
      33             :  * @retval -EBUSY: card is busy with another request
      34             :  * @retval -ETIMEDOUT: card write timed out
      35             :  * @retval -EIO: I/O error
      36             :  */
      37           1 : int sdmmc_write_blocks(struct sd_card *card, const uint8_t *wbuf,
      38             :         uint32_t start_block, uint32_t num_blocks);
      39             : 
      40             : /**
      41             :  * @brief Read block from SD card to buffer
      42             :  *
      43             :  * Reads blocks into SD buffer from SD card. For best performance, this buffer
      44             :  * should be aligned to CONFIG_SDHC_BUFFER_ALIGNMENT
      45             :  * @param card SD card to read from
      46             :  * @param rbuf read buffer
      47             :  * @param start_block first block to read from
      48             :  * @param num_blocks number of blocks to read
      49             :  * @retval 0 read succeeded
      50             :  * @retval -EBUSY: card is busy with another request
      51             :  * @retval -ETIMEDOUT: card read timed out
      52             :  * @retval -EIO: I/O error
      53             :  */
      54           1 : int sdmmc_read_blocks(struct sd_card *card, uint8_t *rbuf,
      55             :         uint32_t start_block, uint32_t num_blocks);
      56             : 
      57             : /**
      58             :  * @brief Get I/O control data from SD card
      59             :  *
      60             :  * Sends I/O control commands to SD card.
      61             :  * @param card SD card
      62             :  * @param cmd I/O control command
      63             :  * @param buf I/O control buf
      64             :  * @retval 0 IOCTL command succeeded
      65             :  * @retval -ENOTSUP: IOCTL command not supported
      66             :  * @retval -EIO: I/O failure
      67             :  */
      68           1 : int sdmmc_ioctl(struct sd_card *card, uint8_t cmd, void *buf);
      69             : 
      70             : #ifdef __cplusplus
      71             : }
      72             : #endif
      73             : 
      74             : #endif /* ZEPHYR_INCLUDE_SD_SDMMC_H_ */