sd_mmc.h

Go to the documentation of this file.

/*
 * Support and FAQ: visit <a href="https://www.microchip.com/support/">Microchip Support</a>
 */

#ifndef SD_MMC_H_INCLUDED
#define SD_MMC_H_INCLUDED

#include "compiler.h"
#include "conf_sd_mmc.h"

#ifdef __cplusplus
extern "C" {
#endif

typedef uint8_t sd_mmc_err_t; 

#define SD_MMC_OK               0    
#define SD_MMC_INIT_ONGOING     1    
#define SD_MMC_ERR_NO_CARD      2    
#define SD_MMC_ERR_UNUSABLE     3    
#define SD_MMC_ERR_SLOT         4    
#define SD_MMC_ERR_COMM         5    
#define SD_MMC_ERR_PARAM        6    
#define SD_MMC_ERR_WP           7    

typedef uint8_t card_type_t; 

#define CARD_TYPE_UNKNOWN   (0)      
#define CARD_TYPE_SD        (1 << 0) 
#define CARD_TYPE_MMC       (1 << 1) 
#define CARD_TYPE_SDIO      (1 << 2) 
#define CARD_TYPE_HC        (1 << 3) 
#define CARD_TYPE_SD_COMBO  (CARD_TYPE_SD | CARD_TYPE_SDIO)

typedef uint8_t card_version_t; 

#define CARD_VER_UNKNOWN   (0)       
#define CARD_VER_SD_1_0    (0x10)    
#define CARD_VER_SD_1_10   (0x1A)    
#define CARD_VER_SD_2_0    (0X20)    
#define CARD_VER_SD_3_0    (0X30)    
#define CARD_VER_MMC_1_2   (0x12)    
#define CARD_VER_MMC_1_4   (0x14)    
#define CARD_VER_MMC_2_2   (0x22)    
#define CARD_VER_MMC_3     (0x30)    
#define CARD_VER_MMC_4     (0x40)    

#define SD_MMC_BLOCK_SIZE          512

void sd_mmc_init(void);

uint8_t sd_mmc_nb_slot(void);

sd_mmc_err_t sd_mmc_check(uint8_t slot);

card_type_t sd_mmc_get_type(uint8_t slot);

card_version_t sd_mmc_get_version(uint8_t slot);

uint32_t sd_mmc_get_capacity(uint8_t slot);

bool sd_mmc_is_write_protected(uint8_t slot);

sd_mmc_err_t sd_mmc_init_read_blocks(uint8_t slot, uint32_t start,
                uint16_t nb_block);

sd_mmc_err_t sd_mmc_start_read_blocks(void *dest, uint16_t nb_block);

sd_mmc_err_t sd_mmc_wait_end_of_read_blocks(bool abort);

sd_mmc_err_t sd_mmc_init_write_blocks(uint8_t slot, uint32_t start,
                uint16_t nb_block);

sd_mmc_err_t sd_mmc_start_write_blocks(const void *src, uint16_t nb_block);

sd_mmc_err_t sd_mmc_wait_end_of_write_blocks(bool abort);

#ifdef SDIO_SUPPORT_ENABLE

sd_mmc_err_t sdio_read_direct(uint8_t slot, uint8_t func_num, uint32_t addr,
                uint8_t *dest);
sd_mmc_err_t sdio_write_direct(uint8_t slot, uint8_t func_num, uint32_t addr,
                uint8_t data);

sd_mmc_err_t sdio_read_extended(uint8_t slot, uint8_t func_num, uint32_t addr,
                uint8_t inc_addr, uint8_t *dest, uint16_t size);

sd_mmc_err_t sdio_write_extended(uint8_t slot, uint8_t func_num, uint32_t addr,
                uint8_t inc_addr, uint8_t *src, uint16_t size);
#endif // SDIO_SUPPORT_ENABLE

#ifdef __cplusplus
}
#endif

#endif /* SD_MMC_H_INCLUDED */