2017-07-04 05:58:36 +00:00
|
|
|
// Copyright 2015-2017 Espressif Systems (Shanghai) PTE LTD
|
|
|
|
//
|
|
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
// you may not use this file except in compliance with the License.
|
|
|
|
// You may obtain a copy of the License at
|
|
|
|
//
|
|
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
//
|
|
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
// See the License for the specific language governing permissions and
|
|
|
|
// limitations under the License.
|
|
|
|
|
|
|
|
#pragma once
|
|
|
|
|
|
|
|
#include <stdint.h>
|
|
|
|
#include <stddef.h>
|
|
|
|
#include "esp_err.h"
|
|
|
|
#include "sdmmc_types.h"
|
|
|
|
#include "driver/gpio.h"
|
|
|
|
#include "driver/spi_master.h"
|
|
|
|
#include "driver/sdmmc_host.h"
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
extern "C" {
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Default sdmmc_host_t structure initializer for SD over SPI driver
|
|
|
|
*
|
|
|
|
* Uses SPI mode and max frequency set to 20MHz
|
|
|
|
*
|
|
|
|
* 'slot' can be set to one of HSPI_HOST, VSPI_HOST.
|
|
|
|
*/
|
|
|
|
#define SDSPI_HOST_DEFAULT() {\
|
|
|
|
.flags = SDMMC_HOST_FLAG_SPI, \
|
|
|
|
.slot = HSPI_HOST, \
|
|
|
|
.max_freq_khz = SDMMC_FREQ_DEFAULT, \
|
|
|
|
.io_voltage = 3.3f, \
|
|
|
|
.init = &sdspi_host_init, \
|
|
|
|
.set_bus_width = NULL, \
|
2018-04-23 06:35:13 +00:00
|
|
|
.get_bus_width = NULL, \
|
2018-08-22 10:16:32 +00:00
|
|
|
.set_bus_ddr_mode = NULL, \
|
2017-07-04 05:58:36 +00:00
|
|
|
.set_card_clk = &sdspi_host_set_card_clk, \
|
|
|
|
.do_transaction = &sdspi_host_do_transaction, \
|
|
|
|
.deinit = &sdspi_host_deinit, \
|
2018-12-28 18:04:37 +00:00
|
|
|
.io_int_enable = &sdspi_host_io_int_enable, \
|
|
|
|
.io_int_wait = &sdspi_host_io_int_wait, \
|
2017-11-08 04:52:25 +00:00
|
|
|
.command_timeout_ms = 0, \
|
2017-07-04 05:58:36 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Extra configuration for SPI host
|
|
|
|
*/
|
|
|
|
typedef struct {
|
|
|
|
gpio_num_t gpio_miso; ///< GPIO number of MISO signal
|
|
|
|
gpio_num_t gpio_mosi; ///< GPIO number of MOSI signal
|
|
|
|
gpio_num_t gpio_sck; ///< GPIO number of SCK signal
|
|
|
|
gpio_num_t gpio_cs; ///< GPIO number of CS signal
|
|
|
|
gpio_num_t gpio_cd; ///< GPIO number of card detect signal
|
|
|
|
gpio_num_t gpio_wp; ///< GPIO number of write protect signal
|
2018-12-28 18:04:37 +00:00
|
|
|
gpio_num_t gpio_int; ///< GPIO number of interrupt line (input) for SDIO card.
|
2017-07-04 05:58:36 +00:00
|
|
|
int dma_channel; ///< DMA channel to be used by SPI driver (1 or 2)
|
|
|
|
} sdspi_slot_config_t;
|
|
|
|
|
2018-12-28 18:04:37 +00:00
|
|
|
#define SDSPI_SLOT_NO_CD GPIO_NUM_NC ///< indicates that card detect line is not used
|
|
|
|
#define SDSPI_SLOT_NO_WP GPIO_NUM_NC ///< indicates that write protect line is not used
|
|
|
|
#define SDSPI_SLOT_NO_INT GPIO_NUM_NC ///< indicates that interrupt line is not used
|
2017-07-04 05:58:36 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Macro defining default configuration of SPI host
|
|
|
|
*/
|
|
|
|
#define SDSPI_SLOT_CONFIG_DEFAULT() {\
|
|
|
|
.gpio_miso = GPIO_NUM_2, \
|
|
|
|
.gpio_mosi = GPIO_NUM_15, \
|
|
|
|
.gpio_sck = GPIO_NUM_14, \
|
|
|
|
.gpio_cs = GPIO_NUM_13, \
|
2018-04-23 06:35:13 +00:00
|
|
|
.gpio_cd = SDSPI_SLOT_NO_CD, \
|
|
|
|
.gpio_wp = SDSPI_SLOT_NO_WP, \
|
2018-12-28 18:04:37 +00:00
|
|
|
.gpio_int = GPIO_NUM_NC, \
|
2017-07-04 05:58:36 +00:00
|
|
|
.dma_channel = 1 \
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Initialize SD SPI driver
|
|
|
|
*
|
|
|
|
* @note This function is not thread safe
|
|
|
|
*
|
|
|
|
* @return
|
|
|
|
* - ESP_OK on success
|
|
|
|
* - other error codes may be returned in future versions
|
|
|
|
*/
|
|
|
|
esp_err_t sdspi_host_init();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Initialize SD SPI driver for the specific SPI controller
|
|
|
|
*
|
|
|
|
* @note This function is not thread safe
|
|
|
|
*
|
2018-12-28 18:04:37 +00:00
|
|
|
* @note The SDIO over sdspi needs an extra interrupt line. Call ``gpio_install_isr_service()`` before this function.
|
|
|
|
*
|
2017-07-04 05:58:36 +00:00
|
|
|
* @param slot SPI controller to use (HSPI_HOST or VSPI_HOST)
|
|
|
|
* @param slot_config pointer to slot configuration structure
|
|
|
|
*
|
|
|
|
* @return
|
|
|
|
* - ESP_OK on success
|
|
|
|
* - ESP_ERR_INVALID_ARG if sdspi_init_slot has invalid arguments
|
|
|
|
* - ESP_ERR_NO_MEM if memory can not be allocated
|
|
|
|
* - other errors from the underlying spi_master and gpio drivers
|
|
|
|
*/
|
|
|
|
esp_err_t sdspi_host_init_slot(int slot, const sdspi_slot_config_t* slot_config);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Send command to the card and get response
|
|
|
|
*
|
|
|
|
* This function returns when command is sent and response is received,
|
|
|
|
* or data is transferred, or timeout occurs.
|
|
|
|
*
|
|
|
|
* @note This function is not thread safe w.r.t. init/deinit functions,
|
|
|
|
* and bus width/clock speed configuration functions. Multiple tasks
|
|
|
|
* can call sdspi_host_do_transaction as long as other sdspi_host_*
|
|
|
|
* functions are not called.
|
|
|
|
*
|
|
|
|
* @param slot SPI controller (HSPI_HOST or VSPI_HOST)
|
|
|
|
* @param cmdinfo pointer to structure describing command and data to transfer
|
|
|
|
* @return
|
|
|
|
* - ESP_OK on success
|
|
|
|
* - ESP_ERR_TIMEOUT if response or data transfer has timed out
|
|
|
|
* - ESP_ERR_INVALID_CRC if response or data transfer CRC check has failed
|
|
|
|
* - ESP_ERR_INVALID_RESPONSE if the card has sent an invalid response
|
|
|
|
*/
|
|
|
|
esp_err_t sdspi_host_do_transaction(int slot, sdmmc_command_t *cmdinfo);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Set card clock frequency
|
|
|
|
*
|
|
|
|
* Currently only integer fractions of 40MHz clock can be used.
|
|
|
|
* For High Speed cards, 40MHz can be used.
|
|
|
|
* For Default Speed cards, 20MHz can be used.
|
|
|
|
*
|
|
|
|
* @note This function is not thread safe
|
|
|
|
*
|
|
|
|
* @param slot SPI controller (HSPI_HOST or VSPI_HOST)
|
|
|
|
* @param freq_khz card clock frequency, in kHz
|
|
|
|
* @return
|
|
|
|
* - ESP_OK on success
|
|
|
|
* - other error codes may be returned in the future
|
|
|
|
*/
|
|
|
|
esp_err_t sdspi_host_set_card_clk(int slot, uint32_t freq_khz);
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Release resources allocated using sdspi_host_init
|
|
|
|
*
|
|
|
|
* @note This function is not thread safe
|
|
|
|
*
|
|
|
|
* @return
|
|
|
|
* - ESP_OK on success
|
|
|
|
* - ESP_ERR_INVALID_STATE if sdspi_host_init function has not been called
|
|
|
|
*/
|
|
|
|
esp_err_t sdspi_host_deinit();
|
|
|
|
|
2018-12-28 18:04:37 +00:00
|
|
|
/**
|
|
|
|
* @brief Enable SDIO interrupt.
|
|
|
|
*
|
|
|
|
* @param slot SPI controller to use (HSPI_HOST or VSPI_HOST)
|
|
|
|
*
|
|
|
|
* @return
|
|
|
|
* - ESP_OK on success
|
|
|
|
*/
|
|
|
|
esp_err_t sdspi_host_io_int_enable(int slot);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Wait for SDIO interrupt until timeout.
|
|
|
|
*
|
|
|
|
* @param slot SPI controller to use (HSPI_HOST or VSPI_HOST)
|
|
|
|
* @param timeout_ticks Ticks to wait before timeout.
|
|
|
|
*
|
|
|
|
* @return
|
|
|
|
* - ESP_OK on success
|
|
|
|
*/
|
|
|
|
esp_err_t sdspi_host_io_int_wait(int slot, TickType_t timeout_ticks);
|
|
|
|
|
2017-07-04 05:58:36 +00:00
|
|
|
#ifdef __cplusplus
|
|
|
|
}
|
|
|
|
#endif
|