Target_Windows_Storage.c

//
// Copyright (c) .NET Foundation and Contributors
// See LICENSE file in the project root for full license information.
//

//
//	Initialise SD card and mount on VFS
//  Supports  MMC and SPI SD cards
//  MMC supports 4bit or 1 bit

// == Boards == 
// OLimex EVB - 1 bit SD/MMC  ( DAT0 - GPIO2, CMD/DI - GPIO15 ), No Card detect, No Write protect
// Wrover V4 -  4 bit SD/MMC  ( Card detect )
//              D0 = 2, D1 = 4, D2 = 12, D3 = 13
//              CLK = 14, CMD = 15, DETECT = 21


//  SPI test 
//  MISO = 2, MOSI = 15, CLK = 14, CS = 15

//   5    	VSPICS0 (cs)
//	18		VSPICLK (clockPin) *
//  19      VSPIQ   (miso) *
//  21		VSPIHD  (HD)
//	22		VSPIWP  (WP)
//	23		VSPID   (mosi) *

#include <stdio.h>
#include <string.h>
#include <sys/unistd.h>
#include <sys/stat.h>
#include "esp_err.h"
#include "esp_log.h"
#include "esp_vfs_fat.h"
#include "driver/sdmmc_host.h"
#include "driver/sdspi_host.h"
#include "sdmmc/include/sdmmc_cmd.h"
#include <target_platform.h>

static const char *TAG = "SDCard";

// Pin mapping when using SPI mode.
// With this mapping, SD card can be used both in SPI and 1-line SD mode.
// Note that a pull-up on CS line is required in SD mode.
//#define PIN_NUM_MISO 2
//#define PIN_NUM_MOSI 15
//#define PIN_NUM_CLK  14
//#define PIN_NUM_CS  13

#if defined(HAL_USE_SDC)

bool Storage_UnMountSDCard()
{
	if (esp_vfs_fat_sdmmc_unmount() != ESP_OK)
		return false;

	return true;
}

//
//	Mount the SDCard device as a FAT device on the VFS
//
bool Storage_MountSDCard(char * vfsName, sdmmc_host_t * host, void* slot_config, bool formatOnMount, int maxFiles )
{

	esp_vfs_fat_sdmmc_mount_config_t mount_config = {
		.format_if_mount_failed = formatOnMount,
		.max_files = maxFiles,
		.allocation_unit_size = 16 * 1024
	};

	sdmmc_card_t* card;
	esp_err_t ret = esp_vfs_fat_sdmmc_mount(vfsName, host, (sdmmc_slot_config_t*)slot_config, &mount_config, &card);
	if (ret == ESP_ERR_INVALID_STATE)
	{
		// Invalid state means its already mounted, this can happen if you are trying to debug mount from managed code
		// and the code has already run & mounted
		Storage_UnMountSDCard();
		ret = esp_vfs_fat_sdmmc_mount(vfsName, host, (sdmmc_slot_config_t*)slot_config, &mount_config, &card);
	}

	if (ret != ESP_OK) {
		if (ret == ESP_FAIL) {
			ESP_LOGE(TAG, "Failed to mount filesystem. ");
		}
		else {
			ESP_LOGE(TAG, "Failed to initialize the card (%s).  ", esp_err_to_name(ret));
		}
		return false;
	}

	return true;
}


//  Storage_InitSDCardMMC
//	Initial the SD card Slot 1 - 4/1 bit ( hs2_* signals )
//
//  vfsName - Name of disk for vfs - i.e "/SDSPI"
//  maxFiles- Maximum number of open files
//  bit1Mode- true to use 1 bit MMC interface
//
//  return true if OK
//
bool Storage_InitSDCardMMC(char * vfsName, int maxFiles, bool bit1Mode)
{
	ESP_LOGI(TAG, "Initializing MMC SD card");

	sdmmc_host_t host = SDMMC_HOST_DEFAULT();

	// Using 1 bit data ( OLimex EVB etc )
	if (bit1Mode)
	{
		host.flags = SDMMC_HOST_FLAG_1BIT;
		host.max_freq_khz = SDMMC_FREQ_PROBING;
	}

	// This initializes the slot without card detect (CD) and write protect (WP) signals.
	// Modify slot_config.gpio_cd and slot_config.gpio_wp if your board has these signals.
	sdmmc_slot_config_t slot_config = SDMMC_SLOT_CONFIG_DEFAULT();

	// GPIOs 15, 2, 4, 12, 13 should have external 10k pull-ups.
	// Internal pull-ups are not sufficient. However, enabling internal pull-ups
	// does make a difference some boards, so we do that here.
	gpio_set_pull_mode(15, GPIO_PULLUP_ONLY);       // CMD, needed in 4- and 1- line modes
	gpio_set_pull_mode(2, GPIO_PULLUP_ONLY);        // D0, needed in 4- and 1-line modes

	if (!bit1Mode)
	{
		gpio_set_pull_mode(4, GPIO_PULLUP_ONLY);    // D1, needed in 4-line mode only
		gpio_set_pull_mode(12, GPIO_PULLUP_ONLY);   // D2, needed in 4-line mode only
		gpio_set_pull_mode(13, GPIO_PULLUP_ONLY);   // D3, needed in 4-line modes only
	}

	return Storage_MountSDCard(vfsName, &host, &slot_config, false, maxFiles);
}

//  Storage_InitSDCardSPI
//	Initial the SD card connected by SPI)
//
//  vfsName - Name of disk for vfs - i.e "/SDSPI"
//  maxFiles- Maximum number of open files
//
//  return true if OK
//
bool Storage_InitSDCardSPI(char * vfsName, int maxFiles, int pin_Miso, int pin_Mosi, int pin_Clk, int pin_Cs)
{
	ESP_LOGI(TAG, "Initializing SPI SD card");

	sdmmc_host_t host = SDSPI_HOST_DEFAULT();
	sdspi_slot_config_t slot_config = SDSPI_SLOT_CONFIG_DEFAULT();
	slot_config.gpio_miso = pin_Miso;
	slot_config.gpio_mosi = pin_Mosi;
	slot_config.gpio_sck = pin_Clk;
	slot_config.gpio_cs = pin_Cs;

	return Storage_MountSDCard(vfsName, &host, &slot_config, false, maxFiles);
}

#endif