/* * SPDX-FileCopyrightText: 2015-2021 Espressif Systems (Shanghai) CO LTD * * SPDX-License-Identifier: Apache-2.0 */ #include #include "esp_err.h" #include "esp_log.h" #include "sys/lock.h" #include "driver/sdmmc_types.h" #include "driver/sdmmc_defs.h" #include "driver/sdmmc_types.h" #include "sdspi_private.h" #include "sdspi_crc.h" static const char* TAG = "sdspi_transaction"; static _lock_t s_lock; static bool s_app_cmd; static uint8_t sdspi_msg_crc7(sdspi_hw_cmd_t* hw_cmd) { const size_t bytes_to_crc = offsetof(sdspi_hw_cmd_t, arguments) + sizeof(hw_cmd->arguments); /* can't take address of bit fields */ return sdspi_crc7((const uint8_t *)hw_cmd, bytes_to_crc); } void make_hw_cmd(uint32_t opcode, uint32_t arg, int timeout_ms, sdspi_hw_cmd_t *hw_cmd) { hw_cmd->start_bit = 0; hw_cmd->transmission_bit = 1; hw_cmd->cmd_index = opcode; hw_cmd->stop_bit = 1; hw_cmd->r1 = 0xff; memset(hw_cmd->response, 0xff, sizeof(hw_cmd->response)); hw_cmd->ncr = 0xff; uint32_t arg_s = __builtin_bswap32(arg); memcpy(hw_cmd->arguments, &arg_s, sizeof(arg_s)); hw_cmd->crc7 = sdspi_msg_crc7(hw_cmd); hw_cmd->timeout_ms = timeout_ms; } static void r1_response_to_err(uint8_t r1, int cmd, esp_err_t *out_err) { if (r1 & SD_SPI_R1_NO_RESPONSE) { ESP_LOGD(TAG, "cmd=%d, R1 response not found", cmd); *out_err = ESP_ERR_TIMEOUT; } else if (r1 & SD_SPI_R1_CMD_CRC_ERR) { ESP_LOGD(TAG, "cmd=%d, R1 response: command CRC error", cmd); *out_err = ESP_ERR_INVALID_CRC; } else if (r1 & SD_SPI_R1_ILLEGAL_CMD) { ESP_LOGD(TAG, "cmd=%d, R1 response: command not supported", cmd); *out_err = ESP_ERR_NOT_SUPPORTED; } else if (r1 & SD_SPI_R1_ADDR_ERR) { ESP_LOGD(TAG, "cmd=%d, R1 response: alignment error", cmd); *out_err = ESP_ERR_INVALID_ARG; } else if (r1 & SD_SPI_R1_PARAM_ERR) { ESP_LOGD(TAG, "cmd=%d, R1 response: size error", cmd); *out_err = ESP_ERR_INVALID_SIZE; } else if ((r1 & SD_SPI_R1_ERASE_RST) || (r1 & SD_SPI_R1_ERASE_SEQ_ERR)) { *out_err = ESP_ERR_INVALID_STATE; } else if (r1 & SD_SPI_R1_IDLE_STATE) { // Idle state is handled at command layer } else if (r1 != 0) { ESP_LOGD(TAG, "cmd=%d, R1 response: unexpected value 0x%02x", cmd, r1); *out_err = ESP_ERR_INVALID_RESPONSE; } } static void r1_sdio_response_to_err(uint8_t r1, int cmd, esp_err_t *out_err) { if (r1 & SD_SPI_R1_NO_RESPONSE) { ESP_LOGI(TAG, "cmd=%d, R1 response not found", cmd); *out_err = ESP_ERR_TIMEOUT; } else if (r1 & SD_SPI_R1_CMD_CRC_ERR) { ESP_LOGI(TAG, "cmd=%d, R1 response: command CRC error", cmd); *out_err = ESP_ERR_INVALID_CRC; } else if (r1 & SD_SPI_R1_ILLEGAL_CMD) { ESP_LOGI(TAG, "cmd=%d, R1 response: command not supported", cmd); *out_err = ESP_ERR_NOT_SUPPORTED; } else if (r1 & SD_SPI_R1_PARAM_ERR) { ESP_LOGI(TAG, "cmd=%d, R1 response: size error", cmd); *out_err = ESP_ERR_INVALID_SIZE; } else if (r1 & SDIO_R1_FUNC_NUM_ERR) { ESP_LOGI(TAG, "cmd=%d, R1 response: function number error", cmd); *out_err = ESP_ERR_INVALID_ARG; } else if (r1 & SD_SPI_R1_IDLE_STATE) { // Idle state is handled at command layer } else if (r1 != 0) { ESP_LOGI(TAG, "cmd=%d, R1 response: unexpected value 0x%02x", cmd, r1); *out_err = ESP_ERR_INVALID_RESPONSE; } } esp_err_t sdspi_host_do_transaction(int slot, sdmmc_command_t *cmdinfo) { _lock_acquire(&s_lock); // Convert the command to wire format WORD_ALIGNED_ATTR sdspi_hw_cmd_t hw_cmd; make_hw_cmd(cmdinfo->opcode, cmdinfo->arg, cmdinfo->timeout_ms, &hw_cmd); // Flags indicate which of the transfer types should be used int flags = 0; if (SCF_CMD(cmdinfo->flags) == SCF_CMD_ADTC) { flags = SDSPI_CMD_FLAG_DATA | SDSPI_CMD_FLAG_WRITE; } else if (SCF_CMD(cmdinfo->flags) == (SCF_CMD_ADTC | SCF_CMD_READ)) { flags = SDSPI_CMD_FLAG_DATA; } // The block size is 512, when larger than 512, the data must send in multi blocks if (cmdinfo->datalen > SDSPI_MAX_DATA_LEN) { flags |= SDSPI_CMD_FLAG_MULTI_BLK; } // In SD host, response format is encoded using SCF_RSP_* flags which come // as part of sdmmc_command_t from the upper layer (sdmmc_cmd.c). // SPI mode uses different command formats. In fact, most of the commands // use R1 response. Therefore, instead of adding another parallel set of // response flags for the SPI mode, response format is determined here: if (!s_app_cmd && cmdinfo->opcode == SD_SEND_IF_COND) { flags |= SDSPI_CMD_FLAG_RSP_R7; } else if (!s_app_cmd && cmdinfo->opcode == MMC_SEND_STATUS) { flags |= SDSPI_CMD_FLAG_RSP_R2; } else if (!s_app_cmd && cmdinfo->opcode == SD_READ_OCR) { flags |= SDSPI_CMD_FLAG_RSP_R3; } else if (s_app_cmd && cmdinfo->opcode == SD_APP_SD_STATUS) { flags |= SDSPI_CMD_FLAG_RSP_R2; } else if (!s_app_cmd && cmdinfo->opcode == MMC_GO_IDLE_STATE && !(cmdinfo->flags & SCF_RSP_R1)) { /* used to send CMD0 without expecting a response */ flags |= SDSPI_CMD_FLAG_NORSP; } else if (!s_app_cmd && cmdinfo->opcode == SD_IO_SEND_OP_COND) { flags |= SDSPI_CMD_FLAG_RSP_R4; } else if (!s_app_cmd && cmdinfo->opcode == SD_IO_RW_DIRECT) { flags |= SDSPI_CMD_FLAG_RSP_R5; } else if (!s_app_cmd && cmdinfo->opcode == SD_IO_RW_EXTENDED) { flags |= SDSPI_CMD_FLAG_RSP_R5 | SDSPI_CMD_FLAG_DATA; if (cmdinfo->arg & SD_ARG_CMD53_WRITE) { flags |= SDSPI_CMD_FLAG_WRITE; } // The CMD53 can assign block mode in the arg when the length is exactly 512 bytes if (cmdinfo->arg & SD_ARG_CMD53_BLOCK_MODE) { flags |= SDSPI_CMD_FLAG_MULTI_BLK; } } else if (!s_app_cmd && (cmdinfo->opcode == MMC_ERASE || cmdinfo->opcode == MMC_STOP_TRANSMISSION)) { flags |= SDSPI_CMD_FLAG_RSP_R1B; } else { flags |= SDSPI_CMD_FLAG_RSP_R1; } // Send the command and get the response. esp_err_t ret = sdspi_host_start_command(slot, &hw_cmd, cmdinfo->data, cmdinfo->datalen, flags); // Extract response bytes and store them into cmdinfo structure if (ret == ESP_OK) { ESP_LOGV(TAG, "r1 = 0x%02x hw_cmd.r[0]=0x%08"PRIx32, hw_cmd.r1, hw_cmd.response[0]); // Some errors should be reported using return code if (flags & (SDSPI_CMD_FLAG_RSP_R1 | SDSPI_CMD_FLAG_RSP_R1B)) { cmdinfo->response[0] = hw_cmd.r1; r1_response_to_err(hw_cmd.r1, cmdinfo->opcode, &ret); } else if (flags & SDSPI_CMD_FLAG_RSP_R2) { cmdinfo->response[0] = ((uint32_t)hw_cmd.r1) | ((hw_cmd.response[0] & 0xff) << 8); } else if (flags & (SDSPI_CMD_FLAG_RSP_R3 | SDSPI_CMD_FLAG_RSP_R7)) { r1_response_to_err(hw_cmd.r1, cmdinfo->opcode, &ret); cmdinfo->response[0] = __builtin_bswap32(hw_cmd.response[0]); } else if (flags & SDSPI_CMD_FLAG_RSP_R4) { r1_sdio_response_to_err(hw_cmd.r1, cmdinfo->opcode, &ret); cmdinfo->response[0] = __builtin_bswap32(hw_cmd.response[0]); } else if (flags & SDSPI_CMD_FLAG_RSP_R5) { r1_sdio_response_to_err(hw_cmd.r1, cmdinfo->opcode, &ret); cmdinfo->response[0] = hw_cmd.response[0]; } } // Save a flag whether the next command is expected to be an app command if (ret == ESP_OK) { s_app_cmd = (cmdinfo->opcode == MMC_APP_CMD); } else { s_app_cmd = false; } _lock_release(&s_lock); return ret; }