sd.h

Go to the documentation of this file.

/*
 * Copyright 2022 NXP
 *
 * SPDX-License-Identifier: Apache-2.0
 */

 
#ifndef ZEPHYR_INCLUDE_SD_SD_H_
#define ZEPHYR_INCLUDE_SD_SD_H_
 
#include <zephyr/device.h>
#include <zephyr/drivers/sdhc.h>
#include <zephyr/kernel.h>
 
#ifdef __cplusplus
extern "C" {
#endif

enum card_status {
        CARD_UNINITIALIZED = 0, 
        CARD_ERROR = 1, 
        CARD_INITIALIZED = 2, 
};

enum card_type {
        CARD_SDMMC = 0, 
        CARD_SDIO = 1, 
        CARD_COMBO = 2, 
        CARD_MMC = 3, 
};

struct sdio_func {
        enum sdio_func_num num; 
        struct sd_card *card; 
        struct sdio_cis cis; 
        uint16_t block_size; 
};
 

struct sd_card {
        const struct device *sdhc; 
        struct sdhc_io bus_io; 
        enum sd_voltage card_voltage; 
        struct k_mutex lock; 
        struct sdhc_host_props host_props; 
        uint32_t ocr; 
        struct sd_switch_caps switch_caps; 
        unsigned int num_io: 3; 
        uint16_t relative_addr; 
        uint32_t block_count; 
        uint16_t block_size; 
        uint8_t sd_version; 
        uint8_t card_speed; 
        enum card_status status; 
        enum card_type type; 
        uint16_t flags; 
        uint8_t bus_width; 
        uint32_t cccr_flags; 
        struct sdio_func func0; 
 
        /* NOTE: The buffer is accessed as a uint32_t* by the SD subsystem, so must be
         * aligned to 4 bytes for platforms that don't support unaligned access...
         * Systems where the buffer is accessed by DMA may require wider alignment, in
         * which case, use CONFIG_SDHC_BUFFER_ALIGNMENT.
         */
        uint8_t card_buffer[CONFIG_SD_BUFFER_SIZE]
                __aligned(MAX(4, CONFIG_SDHC_BUFFER_ALIGNMENT)); /* Card internal buffer */
};

int sd_init(const struct device *sdhc_dev, struct sd_card *card);

bool sd_is_card_present(const struct device *sdhc_dev);
 
 
#ifdef __cplusplus
}
#endif
 
#endif /* ZEPHYR_INCLUDE_SD_SD_H_ */