de/dd6/sdio_8h_source.html

/**

 * Marlin 3D Printer Firmware

 *

 * Copyright (c) 2019 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]

 * Copyright (c) 2016 Bob Cousins bobcousins42@googlemail.com

 * Copyright (c) 2017 Victor Perez

 *

 * This program is free software: you can redistribute it and/or modify

 * it under the terms of the GNU General Public License as published by

 * the Free Software Foundation, either version 3 of the License, or

 * (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program.  If not, see <http://www.gnu.org/licenses/>.

 *

 */

#pragma once


#include "../shared/Marduino.h"


#include <libmaple/sdio.h>

#include <libmaple/dma.h>


// ------------------------

// Defines

// ------------------------


#define SDMMC_CMD_GO_IDLE_STATE                       ((uint8_t)0)   /* Resets the SD memory card. */

#define SDMMC_CMD_ALL_SEND_CID                        ((uint8_t)2)   /* Asks any card connected to the host to send the CID numbers on the CMD line. */

#define SDMMC_CMD_SET_REL_ADDR                        ((uint8_t)3)   /* Asks the card to publish a new relative address (RCA). */

#define SDMMC_CMD_SEL_DESEL_CARD                      ((uint8_t)7)   /* Selects the card by its own relative address and gets deselected by any other address */

#define SDMMC_CMD_HS_SEND_EXT_CSD                     ((uint8_t)8)   /* Sends SD Memory Card interface condition, which includes host supply voltage information and asks the card whether card supports voltage. */

#define SDMMC_CMD_SEND_CSD                            ((uint8_t)9)   /* Addressed card sends its card specific data (CSD) on the CMD line. */

#define SDMMC_CMD_SEND_STATUS                         ((uint8_t)13)  /*!< Addressed card sends its status register. */

#define SDMMC_CMD_READ_SINGLE_BLOCK                   ((uint8_t)17)  /* Reads single block of size selected by SET_BLOCKLEN in case of SDSC, and a block of fixed 512 bytes in case of SDHC and SDXC. */

#define SDMMC_CMD_WRITE_SINGLE_BLOCK                  ((uint8_t)24)  /* Writes single block of size selected by SET_BLOCKLEN in case of SDSC, and a block of fixed 512 bytes in case of SDHC and SDXC. */

#define SDMMC_CMD_APP_CMD                             ((uint8_t)55)  /* Indicates to the card that the next command is an application specific command rather than a standard command. */


#define SDMMC_ACMD_APP_SD_SET_BUSWIDTH                ((uint8_t)6)   /* (ACMD6) Defines the data bus width to be used for data transfer. The allowed data bus widths are given in SCR register. */

#define SDMMC_ACMD_SD_APP_OP_COND                     ((uint8_t)41)  /* (ACMD41) Sends host capacity support information (HCS) and asks the accessed card to send its operating condition register (OCR) content in the response on the CMD line. */

#define SDMMC_ACMD_SD_APP_SET_CLR_CARD_DETECT         ((uint8_t)42)  /* (ACMD42) Connect/Disconnect the 50 KOhm pull-up resistor on CD/DAT3 (pin 1) of the card  */


#define CMD0_GO_IDLE_STATE                            (uint16_t)(SDMMC_CMD_GO_IDLE_STATE | SDIO_CMD_WAIT_NO_RESP)

#define CMD2_ALL_SEND_CID                             (uint16_t)(SDMMC_CMD_ALL_SEND_CID | SDIO_CMD_WAIT_LONG_RESP)

#define CMD3_SET_REL_ADDR                             (uint16_t)(SDMMC_CMD_SET_REL_ADDR | SDIO_CMD_WAIT_SHORT_RESP)

#define CMD7_SEL_DESEL_CARD                           (uint16_t)(SDMMC_CMD_SEL_DESEL_CARD | SDIO_CMD_WAIT_SHORT_RESP)

#define CMD8_HS_SEND_EXT_CSD                          (uint16_t)(SDMMC_CMD_HS_SEND_EXT_CSD | SDIO_CMD_WAIT_SHORT_RESP)

#define CMD9_SEND_CSD                                 (uint16_t)(SDMMC_CMD_SEND_CSD | SDIO_CMD_WAIT_LONG_RESP)

#define CMD13_SEND_STATUS                             (uint16_t)(SDMMC_CMD_SEND_STATUS | SDIO_CMD_WAIT_SHORT_RESP)

#define CMD17_READ_SINGLE_BLOCK                       (uint16_t)(SDMMC_CMD_READ_SINGLE_BLOCK | SDIO_CMD_WAIT_SHORT_RESP)

#define CMD24_WRITE_SINGLE_BLOCK                      (uint16_t)(SDMMC_CMD_WRITE_SINGLE_BLOCK | SDIO_CMD_WAIT_SHORT_RESP)

#define CMD55_APP_CMD                                 (uint16_t)(SDMMC_CMD_APP_CMD | SDIO_CMD_WAIT_SHORT_RESP)


#define ACMD6_APP_SD_SET_BUSWIDTH                     (uint16_t)(SDMMC_ACMD_APP_SD_SET_BUSWIDTH | SDIO_CMD_WAIT_SHORT_RESP)

#define ACMD41_SD_APP_OP_COND                         (uint16_t)(SDMMC_ACMD_SD_APP_OP_COND | SDIO_CMD_WAIT_SHORT_RESP)

#define ACMD42_SD_APP_SET_CLR_CARD_DETECT             (uint16_t)(SDMMC_ACMD_SD_APP_SET_CLR_CARD_DETECT | SDIO_CMD_WAIT_SHORT_RESP)


#define SDMMC_ALLZERO                        0x00000000U

#define SDMMC_OCR_ERRORBITS                  0xFDFFE008U


#define SDMMC_R6_GENERAL_UNKNOWN_ERROR       0x00002000U

#define SDMMC_R6_ILLEGAL_CMD                 0x00004000U

#define SDMMC_R6_COM_CRC_FAILED              0x00008000U


#define SDMMC_VOLTAGE_WINDOW_SD              0x80100000U

#define SDMMC_HIGH_CAPACITY                  0x40000000U

#define SDMMC_STD_CAPACITY                   0x00000000U

#define SDMMC_CHECK_PATTERN                  0x000001AAU


#define SDIO_TRANSFER_MODE_BLOCK             0x00000000U

#define SDIO_DPSM_ENABLE                     0x00000001U

#define SDIO_TRANSFER_DIR_TO_CARD            0x00000000U

#define SDIO_DATABLOCK_SIZE_512B             0x00000090U

#define SDIO_TRANSFER_DIR_TO_SDIO            0x00000100U

#define SDIO_DMA_ENABLE                      0x00001000U


#define CARD_V1_X                            0x00000000U

#define CARD_V2_X                            0x00000001U

#define CARD_SDSC                            0x00000000U

#define CARD_SDHC_SDXC                       0x00000001U


#define SDIO_RESP1                           0

#define SDIO_RESP2                           1

#define SDIO_RESP3                           2

#define SDIO_RESP4                           3


#define SDIO_GET_FLAG(__FLAG__)              !!((SDIO->STA) & (__FLAG__))

#define SDIO_CLEAR_FLAG(__FLAG__)            (SDIO->ICR = (__FLAG__))


#define SDMMC_MAX_VOLT_TRIAL                 0x00000FFFU

#define SDIO_CARD_TRANSFER                   0x00000004U    /* Card is in transfer state */

#define SDIO_CARD_ERROR                      0x000000FFU    /* Card response Error */

#define SDIO_CMDTIMEOUT                      200U           /* Command send and response timeout */

#define SDIO_DATA_TIMEOUT                    100U           /* Read data transfer timeout */

#define SDIO_WRITE_TIMEOUT                   200U           /* Write data transfer timeout */


#define SDIO_CLOCK                           18000000       /* 18 MHz */


// ------------------------

// Types

// ------------------------


typedef struct {

  uint32_t CardType;      // Card Type

  uint32_t CardVersion;   // Card version

  uint32_t Class;         // Class of the card class

  uint32_t RelCardAdd;    // Relative Card Address

  uint32_t BlockNbr;      // Card Capacity in blocks

  uint32_t BlockSize;     // One block size in bytes

  uint32_t LogBlockNbr;   // Card logical Capacity in blocks

  uint32_t LogBlockSize;  // Logical block size in bytes

} SDIO_CardInfoTypeDef;


// ------------------------

// Public functions

// ------------------------


inline uint32_t SDIO_GetCardState();


bool SDIO_CmdGoIdleState();

bool SDIO_CmdSendCID();

bool SDIO_CmdSetRelAdd(uint32_t *rca);

bool SDIO_CmdSelDesel(uint32_t address);

bool SDIO_CmdOperCond();

bool SDIO_CmdSendCSD(uint32_t argument);

bool SDIO_CmdSendStatus(uint32_t argument);

bool SDIO_CmdReadSingleBlock(uint32_t address);

bool SDIO_CmdWriteSingleBlock(uint32_t address);

bool SDIO_CmdAppCommand(uint32_t rsa);


bool SDIO_CmdAppSetBusWidth(uint32_t rsa, uint32_t argument);

bool SDIO_CmdAppOperCommand(uint32_t sdType);

bool SDIO_CmdAppSetClearCardDetect(uint32_t rsa);


void SDIO_SendCommand(uint16_t command, uint32_t argument);

uint8_t SDIO_GetCommandResponse();

uint32_t SDIO_GetResponse(uint32_t response);

bool SDIO_GetCmdError();

bool SDIO_GetCmdResp1(uint8_t command);

bool SDIO_GetCmdResp2();

bool SDIO_GetCmdResp3();

bool SDIO_GetCmdResp6(uint8_t command, uint32_t *rca);

bool SDIO_GetCmdResp7();