1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00

cpu/sam0_common: add SD Host Controller implementation

This commit is contained in:
Benjamin Valentin 2022-03-18 12:35:05 +01:00
parent e3f9252947
commit babee877ce
10 changed files with 2499 additions and 3 deletions

View File

@ -1,7 +1,10 @@
DIRS = periph
ifneq (, $(filter sam0_eth, $(USEMODULE)))
DIRS += sam0_eth
ifneq (,$(filter sam0_eth, $(USEMODULE)))
DIRS += sam0_eth
endif
ifneq (,$(filter sam0_sdhc, $(USEMODULE)))
DIRS += sam0_sdhc
endif
include $(RIOTBASE)/Makefile.base

View File

@ -0,0 +1,55 @@
/*
* Copyright (C) 2022 Benjamin Valentin
*
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*/
/**
* @ingroup drivers_storage
* @ingroup cpu_sam0_common_sdhc
* @brief Driver for SD-cards using mtd interface
*
* @{
*
* @file
* @brief Interface definition for SAM SDHC driver
*
* @author Benjamin Valentin <benjamin.valentin@ml-pa.com>
*/
#ifndef MTD_SAM0_SDHC_H
#define MTD_SAM0_SDHC_H
#include <stdint.h>
#include "mtd.h"
#include "sdhc.h"
#ifdef __cplusplus
extern "C"
{
#endif
/**
* @brief Device descriptor for mtd_sdcard device
*
* This is an extension of the @c mtd_dev_t struct
*/
typedef struct {
mtd_dev_t base; /**< inherit from mtd_dev_t object */
sdhc_state_t state; /**< sdcard_spi dev descriptor */
} mtd_sam0_sdhc_t;
/**
* @brief sdcard device operations table for mtd
*/
extern const mtd_desc_t mtd_sam0_sdhc_driver;
#ifdef __cplusplus
}
#endif
#endif /* MTD_SAM0_SDHC_H */
/** @} */

View File

@ -0,0 +1,167 @@
/*
* Copyright (C) 2018 Alkgrove
*
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*/
/**
* @defgroup cpu_sam0_common_sdhc sam0 SD Host Controller
* @ingroup cpu_sam0_common
* @brief SD card interface functions for sam0 class devices
*
* @{
*
* @file
* @brief SD card interface functions for sam0 class devices
*
* @author alkgrove <bob@alkgrove.com>
* @author Benjamin Valentin <benjamin.valentin@ml-pa.com>
*/
#ifndef SDHC_H
#define SDHC_H
#ifdef __cplusplus
extern "C" {
#endif
#include <stdint.h>
#include <stdbool.h>
#include "periph/gpio.h"
#include "mutex.h"
/**
* @brief SD Card driver context
*/
typedef struct {
Sdhc *dev; /**< SDHC instance */
gpio_t cd; /**< Card detect pin */
gpio_t wp; /**< Write Protect pin */
mutex_t lock; /**< Ensure thread-safe access */
mutex_t sync; /**< ISR mutex */
uint32_t sectors; /**< Capacity in bytes */
uint32_t clock; /**< Accepted Cloc Rate in Hz */
uint16_t rca; /**< Relative Card Address */
uint16_t error; /**< Last error state */
uint8_t type; /**< Type of Card */
uint8_t version; /**< Version of Card */
uint8_t bus_width; /**< Acceptable Bus Width (1 or 4) */
bool high_speed; /**< Turbo mode */
bool need_init; /**< Card installed but not initialized if true */
} sdhc_state_t;
/** @name Card Types */
/** @{ */
#define CARD_TYPE_UNKNOWN (0) /**< Unknown type card */
#define CARD_TYPE_SD (1 << 0) /**< SD card */
#define CARD_TYPE_MMC (1 << 1) /**< MMC card */
#define CARD_TYPE_SDIO (1 << 2) /**< SDIO card */
#define CARD_TYPE_HC (1 << 3) /**< High capacity card */
/** SD combo card (io + memory) */
#define CARD_TYPE_SD_COMBO (CARD_TYPE_SD | CARD_TYPE_SDIO)
/** @} */
/** @name Card Versions */
/** @{ */
#define CARD_VER_UNKNOWN (0) /**< Unknown card version */
#define CARD_VER_SD_1_0 (0x10) /**< SD version 1.0 and 1.01 */
#define CARD_VER_SD_1_10 (0x1A) /**< SD version 1.10 */
#define CARD_VER_SD_2_0 (0X20) /**< SD version 2.00 */
#define CARD_VER_SD_3_0 (0X30) /**< SD version 3.0X */
#define CARD_VER_MMC_1_2 (0x12) /**< MMC version 1.2 */
#define CARD_VER_MMC_1_4 (0x14) /**< MMC version 1.4 */
#define CARD_VER_MMC_2_2 (0x22) /**< MMC version 2.2 */
#define CARD_VER_MMC_3 (0x30) /**< MMC version 3 */
#define CARD_VER_MMC_4 (0x40) /**< MMC version 4 */
/** @} */
/** @name Flags used to define MCI parser for SD/MMC command */
/** @{ */
#define MCI_RESP_PRESENT (1ul << 8) /**< Have response */
#define MCI_RESP_136 (1ul << 11) /**< 136 bit response */
#define MCI_RESP_CRC (1ul << 12) /**< Expect valid crc */
#define MCI_RESP_BUSY (1ul << 13) /**< Card may send busy */
#define MCI_CMD_OPENDRAIN (1ul << 14) /**< Open drain for a braodcast command */
#define MCI_CMD_WRITE (1ul << 15) /**< To signal a data write operation */
#define MCI_CMD_SDIO_BYTE (1ul << 16) /**< To signal a SDIO transfer in multi byte mode */
#define MCI_CMD_SDIO_BLOCK (1ul << 17) /**< To signal a SDIO transfer in block mode */
#define MCI_CMD_STREAM (1ul << 18) /**< To signal a data transfer in stream mode */
#define MCI_CMD_SINGLE_BLOCK (1ul << 19) /**< To signal a data transfer in single block mode */
#define MCI_CMD_MULTI_BLOCK (1ul << 20) /**< To signal a data transfer in multi block mode */
/** @} */
/** This SD stack uses the maximum block size authorized (512 bytes) */
#define SD_MMC_BLOCK_SIZE 512 /**< SD card block size */
#define SDHC_SLOW_CLOCK_HZ 400000 /**< Clock frequency on init */
/**
* @brief Initialize the SD host controller
*
* @param[in] state driver context
*
* @return int 0 on success, error otherwise
*/
int sdhc_init(sdhc_state_t *state);
/**
* @brief Send a command to the SD card
*
* @param[in] state driver context
* @param[in] cmd the command code
* @param[in] arg command argument
*
* @return true command was successful
* @return false command returned error
*/
bool sdhc_send_cmd(sdhc_state_t *state, uint32_t cmd, uint32_t arg);
/**
* @brief Read blocks from the SD card into memory
*
* Reads n 512 byte blocks from the SD card
*
* @param[in] state driver context
* @param[in] block block number to read from
* @param[out] dst destination address
* @param[in] num number of blocks to read
*
* @return 0 if success, negative error if failed
*/
int sdhc_read_blocks(sdhc_state_t *state, uint32_t block, void *dst, uint16_t num);
/**
* @brief Write memory to SD card blocks
*
* Writes n 512 bytes blocks on the SD card
*
* @param[in] state driver context
* @param[in] block block number to write to
* @param[in] src pointer to memory to write
* @param[in] num number of blocks to write
*
* @return 0 if success, negative error if failed
*/
int sdhc_write_blocks(sdhc_state_t *state, uint32_t block, const void *src,
uint16_t num);
/**
* @brief Erase memory from SD card blocks
*
* Erases n 512 byte blocks on the SD card
*
* @param[in] state driver context
* @param[in] block first block number to erase
* @param[in] num number of blocks to erase
*
* @return 0 if success, negative error if failed
*/
int sdhc_erase_blocks(sdhc_state_t *state, uint32_t block, uint16_t num);
#ifdef __cplusplus
}
#endif
#endif /* SDHC_H */
/** @} */

View File

@ -0,0 +1,3 @@
MODULE=sam0_sdhc
include $(RIOTBASE)/Makefile.base

View File

@ -0,0 +1,154 @@
/*
* Copyright (C) 2022 Benjamin Valentin
*
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*
*/
/**
* @ingroup drivers_mtd
* @{
*
* @file
* @brief Driver for using sam0 SDHC controller via mtd interface
*
* @author Benjamin Valentin <benjamin.valentin@ml-pa.com>
*
* @}
*/
#include <errno.h>
#include <string.h>
#include <stdlib.h>
#include "mtd_sam0_sdhc.h"
#define ENABLE_DEBUG 0
#include "debug.h"
#define min(a, b) ((a) > (b) ? (b) : (a))
static int _init(mtd_dev_t *dev)
{
mtd_sam0_sdhc_t *ctx = container_of(dev, mtd_sam0_sdhc_t, base);
if (sdhc_init(&ctx->state)) {
DEBUG("SDHC init failed\n");
return -EIO;
}
dev->pages_per_sector = 1;
dev->page_size = SD_MMC_BLOCK_SIZE;
dev->sector_count = ctx->state.sectors;
dev->write_size = SD_MMC_BLOCK_SIZE;
#if IS_USED(MODULE_MTD_WRITE_PAGE)
/* TODO: move to MTD layer */
dev->work_area = malloc(SD_MMC_BLOCK_SIZE);
if (dev->work_area == NULL) {
return -ENOMEM;
}
dev->write_size = 1;
#endif
DEBUG("sector size: %lu\n", dev->page_size);
DEBUG("sector count: %lu\n", dev->sector_count);
DEBUG("pages / sector: %lu\n", dev->pages_per_sector);
return 0;
}
static int _read_page(mtd_dev_t *dev, void *buff, uint32_t page,
uint32_t offset, uint32_t size)
{
mtd_sam0_sdhc_t *ctx = container_of(dev, mtd_sam0_sdhc_t, base);
uint16_t pages = size / SD_MMC_BLOCK_SIZE;
DEBUG("%s(%lu, %lu, %lu)\n", __func__, page, offset, size);
/* emulate unaligned / sub-page read */
if (pages == 0 || offset) {
#if IS_USED(MODULE_MTD_WRITE_PAGE)
if (dev->work_area == NULL) {
DEBUG("mtd_sdhc: no work area\n");
return -ENOTSUP;
}
size = min(SD_MMC_BLOCK_SIZE - offset, size);
if (sdhc_read_blocks(&ctx->state, page, dev->work_area, 1)) {
return -EIO;
}
memcpy(buff, dev->work_area + offset, size);
return size;
#else
return -ENOTSUP;
#endif
}
if (sdhc_read_blocks(&ctx->state, page, buff, pages)) {
return -EIO;
}
return pages * SD_MMC_BLOCK_SIZE;
}
static int _write_page(mtd_dev_t *dev, const void *buff, uint32_t page,
uint32_t offset, uint32_t size)
{
mtd_sam0_sdhc_t *ctx = container_of(dev, mtd_sam0_sdhc_t, base);
uint16_t pages = size / SD_MMC_BLOCK_SIZE;
DEBUG("%s(%lu, %lu, %lu)\n", __func__, page, offset, size);
/* emulate unaligned / sub-page write */
if (pages == 0 || offset) {
#if IS_USED(MODULE_MTD_WRITE_PAGE)
if (dev->work_area == NULL) {
DEBUG("mtd_sdhc: no work area\n");
return -ENOTSUP;
}
size = min(SD_MMC_BLOCK_SIZE - offset, size);
if (sdhc_read_blocks(&ctx->state, page, dev->work_area, 1)) {
return -EIO;
}
memcpy(dev->work_area + offset, buff, size);
buff = dev->work_area;
pages = 1;
#else
return -ENOTSUP;
#endif
}
if (sdhc_write_blocks(&ctx->state, page, buff, pages)) {
return -EIO;
}
return min(size, pages * SD_MMC_BLOCK_SIZE);
}
static int _erase_sector(mtd_dev_t *dev, uint32_t sector, uint32_t count)
{
mtd_sam0_sdhc_t *ctx = container_of(dev, mtd_sam0_sdhc_t, base);
if (sdhc_erase_blocks(&ctx->state, sector, count)) {
return -EIO;
}
return 0;
}
const mtd_desc_t mtd_sam0_sdhc_driver = {
.init = _init,
.read_page = _read_page,
.write_page = _write_page,
.erase_sector = _erase_sector,
.flags = MTD_DRIVER_FLAG_DIRECT_WRITE,
};

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@ -172,6 +172,27 @@ struct sam0_aux_cfg_mapping {
#define SAM0_QSPI_MUX GPIO_MUX_H /**< QSPI mux */
/** @} */
/**
* @name SDHC pins are fixed
* @{
*/
#define SAM0_SDHC_MUX GPIO_MUX_I /**< SDHC function */
#define SAM0_SDHC0_PIN_SDCMD GPIO_PIN(PA, 8) /**< Command */
#define SAM0_SDHC0_PIN_SDDAT0 GPIO_PIN(PA, 9) /**< DATA0 */
#define SAM0_SDHC0_PIN_SDDAT1 GPIO_PIN(PA, 10) /**< DATA1 */
#define SAM0_SDHC0_PIN_SDDAT2 GPIO_PIN(PA, 11) /**< DATA2 */
#define SAM0_SDHC0_PIN_SDDAT3 GPIO_PIN(PB, 10) /**< DATA3 */
#define SAM0_SDHC0_PIN_SDCK GPIO_PIN(PB, 11) /**< Clock */
#define SAM0_SDHC1_PIN_SDCMD GPIO_PIN(PA, 20) /**< Command */
#define SAM0_SDHC1_PIN_SDDAT0 GPIO_PIN(PB, 18) /**< DATA0 */
#define SAM0_SDHC1_PIN_SDDAT1 GPIO_PIN(PB, 19) /**< DATA1 */
#define SAM0_SDHC1_PIN_SDDAT2 GPIO_PIN(PB, 20) /**< DATA2 */
#define SAM0_SDHC1_PIN_SDDAT3 GPIO_PIN(PB, 21) /**< DATA3 */
#define SAM0_SDHC1_PIN_SDCK GPIO_PIN(PA, 21) /**< Clock */
/** @} */
#ifdef __cplusplus
}
#endif

View File

@ -37,6 +37,12 @@ config HAVE_MTD_SPI_NOR
help
Indicates that a spi-nor MTD is present
config HAVE_SAM0_SDHC
bool
imply MODULE_SAM0_SDHC if MODULE_MTD
help
Indicates that a SAM0 SD Host Controller MTD is present
config HAVE_MTD_SPI_MCI
bool
imply MODULE_MTD_MCI if MODULE_MTD
@ -86,6 +92,10 @@ config MODULE_MTD_SDCARD
bool "MTD interface for SPI SD-Card"
depends on MODULE_SDCARD_SPI
config MODULE_SAM0_SDHC
bool "MTD interface for SAM0 SD Host Controller"
depends on CPU_COMMON_SAM0
endmenu # MTD Interfacs
config MODULE_MTD_WRITE_PAGE

View File

@ -59,7 +59,7 @@ extern "C" {
* This can be written to by applications
*/
#ifndef VFS_DEFAULT_DATA
#if IS_USED(MODULE_MTD_MCI) || IS_USED(MODULE_MTD_SDCARD)
#if IS_USED(MODULE_MTD_MCI) || IS_USED(MODULE_MTD_SDCARD) || IS_USED(MODULE_SAM0_SDHC)
#define VFS_DEFAULT_DATA VFS_DEFAULT_SD(0)
#else
#define VFS_DEFAULT_DATA VFS_DEFAULT_NVM(0)