sdhc.h

Go to the documentation of this file.

/*
 * SPDX-FileCopyrightText: 2018 Alkgrove
 * SPDX-License-Identifier: LGPL-2.1-only
 */
 
#pragma once

 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <stdint.h>
#include <stdbool.h>
#include "periph/gpio.h"
#include "mutex.h"

typedef struct {
    Sdhc *dev;              
    gpio_t cd;              
    gpio_t wp;              
    mutex_t lock;           
    mutex_t sync;           
    uint32_t sectors;       
    uint32_t clock;         
    uint16_t rca;           
    uint16_t error;         
    uint8_t type;           
    uint8_t version;        
    uint8_t bus_width;      
    bool high_speed;        
    bool need_init;         
} sdhc_state_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)

#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 MCI_RESP_PRESENT    (1ul <<  8)     
#define MCI_RESP_136        (1ul << 11)     
#define MCI_RESP_CRC        (1ul << 12)     
#define MCI_RESP_BUSY       (1ul << 13)     
#define MCI_CMD_OPENDRAIN   (1ul << 14)     
#define MCI_CMD_WRITE       (1ul << 15)     
#define MCI_CMD_SDIO_BYTE   (1ul << 16)     
#define MCI_CMD_SDIO_BLOCK  (1ul << 17)     
#define MCI_CMD_STREAM      (1ul << 18)     
#define MCI_CMD_SINGLE_BLOCK (1ul << 19)    
#define MCI_CMD_MULTI_BLOCK (1ul << 20)     

#define SD_MMC_BLOCK_SIZE   512             
#define SDHC_SLOW_CLOCK_HZ  400000          
#define SDHC_FAST_CLOCK_HZ  25000000        

int sdhc_init(sdhc_state_t *state);

bool sdhc_send_cmd(sdhc_state_t *state, uint32_t cmd, uint32_t arg);

int sdhc_read_blocks(sdhc_state_t *state, uint32_t block, void *dst, uint16_t num);

int sdhc_write_blocks(sdhc_state_t *state, uint32_t block, const void *src,
                      uint16_t num);

int sdhc_erase_blocks(sdhc_state_t *state, uint32_t block, uint16_t num);
 
#ifdef __cplusplus
}
#endif