hpm6750/controller_yy_app/middleware/hpm_sdmmc/lib/hpm_sdmmc_sd.c

/*
 * Copyright (c) 2021-2024 HPMicro
 *
 * SPDX-License-Identifier: BSD-3-Clause
 *
 */

#include "hpm_sdmmc_sd.h"
#include "hpm_l1c_drv.h"
#include "hpm_clock_drv.h"

#define SPEED_1Kbps (1000U)
#define SPEED_1Mbps (1000UL * 1000UL)
#define MAX_BLOCK_COUNT ((1UL << 26) / 512 - 1U)
#define WRITE_BLOCK_TIMEOUT_IN_MS (1000U)
#define READ_BLOCK_TIMEOUT_IN_MS (100U)

typedef union {
    uint32_t status_words[16];
    struct {
        uint32_t reserved[12];
        uint64_t : 8;
        uint64_t uhs_au_size: 4;
        uint64_t uhs_speed_grade: 4;
        uint64_t erase_offset: 2;
        uint64_t erase_timeout: 6;
        uint64_t erase_size: 16;
        uint64_t : 4;
        uint64_t au_size: 4;
        uint64_t performance_move: 8;
        uint64_t speed_class: 8;

        uint32_t size_of_protected_area;

        uint32_t sd_card_type: 16;
        uint32_t : 6;
        uint32_t : 7;
        uint32_t secured_mode: 1;
        uint32_t data_bus_width: 2;
    };
} sd_raw_status_t;

static uint32_t sd_be2le(uint32_t be);

static void sd_convert_data_endian(uint32_t *word, uint32_t word_count);

static hpm_stat_t sd_send_card_status(sd_card_t *card);

static hpm_stat_t sd_send_rca(sd_card_t *card);

static hpm_stat_t sd_send_csd(sd_card_t *card);

static hpm_stat_t sd_switch_function(sd_card_t *card, uint32_t mode, uint32_t group, uint32_t number);

static void sd_decode_scr(sd_card_t *card, const uint32_t *raw_scr);

static hpm_stat_t sd_send_scr(sd_card_t *card);

static hpm_stat_t sd_app_cmd_send_cond_op(const sd_card_t *card, sd_ocr_t ocr);

static hpm_stat_t sd_send_if_cond(const sd_card_t *card);

static hpm_stat_t sd_probe_bus_voltage(sd_card_t *card);

static hpm_stat_t sd_switch_voltage(const sd_card_t *card);

static void sd_decode_csd(sd_card_t *card, const uint32_t *raw_csd);

static void sd_decode_status(sd_card_t *card, uint32_t *raw_status);

static hpm_stat_t sd_set_bus_width(const sd_card_t *card, sdmmc_buswidth_t buswidth);

static hpm_stat_t sd_set_bus_timing(sd_card_t *card, sdmmc_speed_mode_t timing_mode);

static hpm_stat_t sd_check_card_parameters(const sd_card_t *card);

static hpm_stat_t sd_app_cmd_set_write_block_erase_count(const sd_card_t *card, uint32_t block_count);

static hpm_stat_t sd_error_recovery(const sd_card_t *card, hpm_stat_t last_error);

static hpm_stat_t sd_send_cmd(const sd_card_t *card, const sdmmchost_cmd_t *cmd);

static hpm_stat_t sd_transfer(const sd_card_t *card, const sdmmchost_xfer_t *content);

static hpm_stat_t sd_send_cmd(const sd_card_t *card, const sdmmchost_cmd_t *cmd)
{
    hpm_stat_t status = sdmmchost_send_command(card->host, cmd);

    if ((status >= status_sdxc_busy) && (status <= status_sdxc_tuning_failed)) {
        hpm_stat_t error_recovery_status = sd_error_recovery(card, status);
        if (error_recovery_status != status_success) {
            status = error_recovery_status;
        }
    }
    return status;
}

static hpm_stat_t sd_transfer(const sd_card_t *card, const sdmmchost_xfer_t *content)
{
    hpm_stat_t status = sdmmchost_transfer(card->host, content);

    if ((status >= status_sdxc_busy) && (status <= status_sdxc_tuning_failed)) {
        /* According to IP block this condition can be ignored */
        bool ignore_error = content->data->enable_auto_cmd12 &&
                            (status == status_sdxc_autocmd_cmd_response_error) &&
                            (sdmmchost_get_data_pin_level(card->host) != 0);

        hpm_stat_t error_recovery_status = sd_error_recovery(card, status);
        if (ignore_error && (error_recovery_status == status_sdxc_recoverable_error)) {
            status = status_success;
        } else if (error_recovery_status != status_success) {
            status = error_recovery_status;
        }
    }
    return status;
}

static void sd_convert_data_endian(uint32_t *word, uint32_t word_count)
{
    for (uint32_t i = 0; i < word_count / 2; i++) {
        uint32_t temp = word[i];
        word[i] = word[word_count - i - 1];
        word[word_count - i - 1] = temp;
    }

    for (uint32_t i = 0; i < word_count; i++) {
        word[i] = sd_be2le(word[i]);
    }
}

static hpm_stat_t sd_send_card_status(sd_card_t *card)
{
    sdmmchost_cmd_t *cmd = &card->host->cmd;
    memset(cmd, 0, sizeof(*cmd));
    cmd->cmd_index = sdmmc_cmd_send_status;
    cmd->resp_type = (sdxc_dev_resp_type_t) sdmmc_resp_r1;
    cmd->cmd_argument = (uint32_t) card->relative_addr << 16;
    hpm_stat_t status = sd_send_cmd(card, cmd);
    if (status != status_success) {
        return status;
    }

    card->r1_status.status = cmd->response[0];

    return status;
}

static hpm_stat_t sd_switch_voltage(const sd_card_t *card)
{
    sdmmchost_cmd_t *cmd = &card->host->cmd;
    memset(cmd, 0, sizeof(*cmd));
    cmd->cmd_index = sd_voltage_switch;
    cmd->resp_type = (sdxc_dev_resp_type_t) sdmmc_resp_r1;
    cmd->cmd_argument = 0;
    hpm_stat_t status = sd_send_cmd(card, cmd);

    return status;
}

static hpm_stat_t sd_send_if_cond(const sd_card_t *card)
{
    sdmmchost_cmd_t *cmd = &card->host->cmd;
    (void) memset(cmd, 0, sizeof(sdmmchost_cmd_t));

    cmd->cmd_index = sd_cmd_send_if_cond;
    cmd->cmd_argument = 0x1aa;
    cmd->resp_type = (sdxc_dev_resp_type_t) sdmmc_resp_r7;

    hpm_stat_t status = sd_send_cmd(card, cmd);
    if (status != status_success) {
        return status;
    }

    if ((cmd->response[0] & 0xFFU) != 0xAAU) {
        return status_sdmmc_card_not_support;
    }

    return status_success;
}

static void sd_decode_csd(sd_card_t *card, const uint32_t *raw_csd)
{
    sd_csd_t *csd = &card->csd;

    csd->csd_structure = (uint8_t) extract_csd_field(raw_csd, 127, 126);
    csd->data_read_access_time1 = (uint8_t) extract_csd_field(raw_csd, 119, 112);
    csd->data_read_access_time2 = (uint8_t) extract_csd_field(raw_csd, 111, 104);
    csd->transfer_speed = (uint8_t) extract_csd_field(raw_csd, 103, 96);
    csd->card_command_class = (uint16_t) extract_csd_field(raw_csd, 95, 84);
    csd->read_block_len = (uint8_t) extract_csd_field(raw_csd, 83, 80);

    if (extract_csd_field(raw_csd, 79, 79) != 0U) {
        csd->support_read_block_partial = true;
    }
    if (extract_csd_field(raw_csd, 78, 78) != 0U) {
        csd->support_write_block_misalignment = true;
    }
    if (extract_csd_field(raw_csd, 77, 77) != 0U) {
        csd->support_read_block_misalignment = true;
    }
    if (extract_csd_field(raw_csd, 76, 76) != 0U) {
        csd->is_dsr_implemented = true;
    }
    if (csd->csd_structure == 0U) {
        csd->device_size = (uint32_t) extract_csd_field(raw_csd, 73, 62);
        csd->read_current_vdd_min = (uint8_t) extract_csd_field(raw_csd, 61, 59);
        csd->read_current_vdd_max = (uint8_t) extract_csd_field(raw_csd, 58, 56);
        csd->write_current_vdd_min = (uint8_t) extract_csd_field(raw_csd, 55, 53);
        csd->write_current_vdd_max = (uint8_t) extract_csd_field(raw_csd, 52, 50);
        csd->device_size_multiplier = (uint8_t) extract_csd_field(raw_csd, 49, 47);

        /* Get card total block count and block size. */
        uint32_t c_size_mult = 1UL << (csd->device_size_multiplier + 2);
        card->block_count = (csd->device_size + 1U) * c_size_mult;
        card->block_size = (1UL << (csd->read_block_len));
        if (card->block_size != SDMMC_BLOCK_SIZE_DEFAULT) {
            card->block_count *= card->block_size;
            card->block_size = SDMMC_BLOCK_SIZE_DEFAULT;
            card->block_count /= card->block_size;
        }
        card->card_size_in_bytes = (uint64_t) card->block_size * card->block_count;
    } else if (csd->csd_structure == 1U) {
        card->block_size = SDMMC_BLOCK_SIZE_DEFAULT;

        csd->device_size = extract_csd_field(raw_csd, 69, 48);
        if (csd->device_size >= 0xFFFFU) {
            csd->support_sdxc = true;
        }
        card->block_count = ((csd->device_size + 1U) * 1024U);
        card->card_size_in_bytes = (uint64_t) (csd->device_size + 1U) * 512UL * 1024UL;
    } else {
        /* Unsupported csd version */
    }

    if (extract_csd_field(raw_csd, 46, 46) != 0U) {
        csd->is_erase_block_enabled = true;
    }
    csd->erase_sector_size = (1UL + extract_csd_field(raw_csd, 45, 39)) * card->block_size;
    csd->write_protect_group_size = (1UL + extract_csd_field(raw_csd, 38, 32)) * card->block_size;
    if (extract_csd_field(raw_csd, 31, 31) != 0U) {
        csd->is_write_protection_group_enabled = true;
    }
    csd->write_speed_factor = (uint8_t) extract_csd_field(raw_csd, 28, 26);
    csd->max_write_block_len = 1UL << extract_csd_field(raw_csd, 25, 22);
    if (extract_csd_field(raw_csd, 21, 21) != 0U) {
        csd->support_write_block_partial = true;
    }
    if (extract_csd_field(raw_csd, 15, 15) != 0U) {
        csd->support_file_format_group = true;
    }
    if (extract_csd_field(raw_csd, 14, 14) != 0U) {
        csd->support_copy = true;
    }
    if (extract_csd_field(raw_csd, 13, 13) != 0U) {
        csd->support_permanent_write_protect = true;
    }
    if (extract_csd_field(raw_csd, 12, 12) != 0U) {
        csd->support_temporary_write_protect = true;
    }
    csd->file_format = (uint8_t) extract_csd_field(raw_csd, 11, 10);


    uint32_t tran_speed = extract_csd_field(raw_csd, 103, 96);
    uint32_t bitrate_unit = tran_speed & 0x7U;
    uint32_t time_value = (tran_speed >> 3) & 0xFU;
    const uint32_t bitrate_unit_list[8] = {100UL * SPEED_1Kbps, SPEED_1Mbps, 10U * SPEED_1Mbps, 100U * SPEED_1Mbps, 0,
                                           0, 0, 0};
    const uint32_t time_value_list[16] = {0, 10, 12, 13, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60, 70, 80};
    card->max_freq = bitrate_unit_list[bitrate_unit] / 10U * time_value_list[time_value];
}

static hpm_stat_t sd_send_csd(sd_card_t *card)
{
    sdmmchost_cmd_t *cmd = &card->host->cmd;
    (void) memset(cmd, 0, sizeof(sdmmchost_cmd_t));

    cmd->cmd_index = sd_cmd_send_csd;
    cmd->cmd_argument = (uint32_t) card->relative_addr << 16;
    cmd->resp_type = (sdxc_dev_resp_type_t) sdmmc_resp_r2;

    hpm_stat_t status = sd_send_cmd(card, cmd);
    if (status != status_success) {
        return status;
    }

    uint32_t temp_buf[4];
    memcpy(temp_buf, cmd->response, sizeof(temp_buf));
    sd_decode_csd(card, temp_buf);

    return status_success;
}


static hpm_stat_t sd_all_send_cid(sd_card_t *card)
{
    sdmmchost_cmd_t *cmd = &card->host->cmd;
    (void) memset(cmd, 0, sizeof(sdmmchost_cmd_t));

    cmd->cmd_index = sd_cmd_all_send_cid;
    cmd->resp_type = (sdxc_dev_resp_type_t) sdmmc_resp_r2;

    hpm_stat_t status = sd_send_cmd(card, cmd);
    if (status != status_success) {
        return status;
    }

    for (uint32_t i = 0; i < 4; i++) {
        card->cid.cid_words[i] = cmd->response[i];
    }

    return status;
}

static hpm_stat_t sd_send_rca(sd_card_t *card)
{
    sdmmchost_cmd_t *cmd = &card->host->cmd;
    (void) memset(cmd, 0, sizeof(sdmmchost_cmd_t));

    cmd->cmd_index = sd_cmd_send_relative_addr;
    cmd->resp_type = (sdxc_dev_resp_type_t) sdmmc_resp_r6;

    hpm_stat_t status = sd_send_cmd(card, cmd);
    if (status != status_success) {
        return status;
    }
    card->relative_addr = cmd->response[0] >> 16;

    return status;
}

static hpm_stat_t sd_error_recovery(const sd_card_t *card, hpm_stat_t last_error)
{
    sdmmchost_cmd_t *cmd;
    if (((last_error >= status_sdxc_cmd_timeout_error) && (last_error <= status_sdxc_cmd_index_error)) ||
        ((last_error >= status_sdxc_autocmd_cmd_timeout_error) && (last_error <= status_sdxc_autocmd_cmd_response_error))) {
        cmd = NULL;
    } else {
        cmd = &card->host->cmd;
        cmd->cmd_index = sdmmc_cmd_stop_transmission;
        cmd->cmd_type = sdxc_cmd_type_abort_cmd;
        cmd->resp_type = (sdxc_dev_resp_type_t)sdmmc_resp_none;
    }
    return sdmmchost_error_recovery(card->host, cmd);
}

static hpm_stat_t sd_app_cmd_send_cond_op(const sd_card_t *card, sd_ocr_t ocr)
{
    hpm_stat_t status = sdmmc_send_application_command(card->host, card->relative_addr);
    sdmmchost_cmd_t *cmd = &card->host->cmd;
    if (status == status_success) {
        (void) memset(cmd, 0, sizeof(sdmmchost_cmd_t));

        cmd->cmd_index = sd_acmd_sd_send_op_cond;
        cmd->cmd_argument = ocr.ocr_word;
        cmd->resp_type = (sdxc_dev_resp_type_t) sdmmc_resp_r3;
        status = sd_send_cmd(card, cmd);
    }
    return status;
}

static hpm_stat_t sd_app_cmd_set_write_block_erase_count(const sd_card_t *card, uint32_t block_count)
{
    hpm_stat_t status = sdmmc_send_application_command(card->host, card->relative_addr);
    sdmmchost_cmd_t *cmd = &card->host->cmd;
    if (status == status_success) {
        (void) memset(cmd, 0, sizeof(sdmmchost_cmd_t));

        cmd->cmd_index = sd_acmd_set_wr_blk_erase_count;
        cmd->cmd_argument = block_count;
        cmd->resp_type = (sdxc_dev_resp_type_t) sdmmc_resp_r1;
        status = sd_send_cmd(card, cmd);
    }

    return status;
}

static hpm_stat_t sd_probe_bus_voltage(sd_card_t *card)
{
    hpm_stat_t status = status_invalid_argument;

    do {
        status = sdmmc_go_idle_state(card->host, 0);
        HPM_BREAK_IF(status != status_success);

        status = sd_send_if_cond(card);
        if (status == status_sdmmc_card_not_support) {
            status = sdmmc_go_idle_state(card->host, 0);
            HPM_BREAK_IF(status != status_success);
        }
        sd_ocr_t ocr = {.ocr_word = 0};
        const sd_ocr_t sdxc_ocr = {.ocr_word = 0x40ff8000UL};

        /* Query OCR */
        status = sd_app_cmd_send_cond_op(card, ocr);
        HPM_BREAK_IF(status != status_success);
        sdmmchost_cmd_t *cmd = &card->host->cmd;
        ocr.ocr_word = cmd->response[0];
        ocr.ocr_word &= sdxc_ocr.ocr_word;
        ocr.card_capacity_status = 1;
        ocr.switching_to_1v8_accepted = sdmmchost_is_voltage_switch_supported(card->host) ? 1 : 0;

        /* Switch Operation condition */
        sd_ocr_t recv_ocr = {.ocr_word = 0};
        do {
            status = sd_app_cmd_send_cond_op(card, ocr);
            HPM_BREAK_IF(status != status_success);
            recv_ocr.ocr_word = cmd->response[0];
        } while (recv_ocr.card_power_up_status == 0);

        card->sd_flags.is_byte_addressing_mode = (recv_ocr.card_capacity_status == 0) ? 1U : 0;

        card->ocr.ocr_word = recv_ocr.ocr_word;

        if (sdmmchost_is_voltage_switch_supported(card->host) && (card->ocr.switching_to_1v8_accepted != 0U)) {
            status = sd_switch_voltage(card);
            HPM_BREAK_IF(status != status_success);

            status = sdmmchost_switch_to_1v8(card->host);
            HPM_BREAK_IF(status != status_success);

            card->operation_voltage = sdmmc_operation_voltage_1v8;
        } else {
            card->operation_voltage = sdmmc_operation_voltage_3v3;
        }

    } while (false);

    return status;
}

uint32_t sd_be2le(uint32_t be)
{
    uint32_t value = be;

    uint8_t *be_u8 = (uint8_t *) &value;

    for (uint32_t i = 0; i < 2; i++) {
        uint8_t tmp = be_u8[i];
        be_u8[i] = be_u8[3 - i];
        be_u8[3 - i] = tmp;
    }

    return value;
}

static hpm_stat_t sd_send_scr(sd_card_t *card)
{
    hpm_stat_t status = status_invalid_argument;

    status = sdmmc_send_application_command(card->host, card->relative_addr);
    if (status != status_success) {
        return status;
    }

    sdmmchost_cmd_t *cmd = &card->host->cmd;
    (void) memset(cmd, 0, sizeof(*cmd));
    cmd->cmd_index = sd_acmd_send_scr;
    cmd->resp_type = (sdxc_dev_resp_type_t) sdmmc_resp_r1;
    sdmmchost_data_t *data = &card->host->data;
    memset(data, 0, sizeof(*data));
    data->block_size = 8;
    data->block_cnt = 1;
    data->rx_data = card->host->buffer;
    sdmmchost_xfer_t *content = &card->host->xfer;
    content->data = data;
    content->command = cmd;
    status = sd_transfer(card, content);
    if (status != status_success) {
        return status;
    }

    /* Get SCR value */
    sd_scr_t scr;
    scr.scr_word[0] = data->rx_data[0];
    scr.scr_word[1] = data->rx_data[1];
    sd_convert_data_endian(&scr.scr_word[0], ARRAY_SIZE(scr.scr_word));

    sd_decode_scr(card, &scr.scr_word[0]);

    return status;
}

void sd_decode_scr(sd_card_t *card, const uint32_t *raw_scr)
{
    sd_scr_t *scr = &card->scr;

    scr->scr_word[0] = raw_scr[0];
    scr->scr_word[1] = raw_scr[1];

    card->sd_flags.support_4bit_width = ((scr->sd_bus_widths & 0x04) != 0) ? 1 : 0;

    /* The following fields are supported by SD spec 3.0 or above */
    card->sd_flags.support_set_block_count_cmd = 0;
    if (scr->sd_spec3 == 1) {
        card->sd_flags.support_speed_class_control_cmd = (scr->support_cmd20 != 0) ? 1 : 0;
        card->sd_flags.support_set_block_count_cmd = (scr->support_cmd23 != 0) ? 1 : 0;
    }
}

static hpm_stat_t sd_check_card_parameters(const sd_card_t *card)
{
    hpm_stat_t status;
    if ((card == NULL) || (card->host == NULL) || (card->host->host_param.base == NULL)) {
        status = status_invalid_argument;
    } else if (!sdmmchost_is_card_detected(card->host)) {
        status = status_sdmmc_device_init_required;
    } else {
        card->host->card_inserted = true;
        status = status_success;
    }
    return status;
}


static hpm_stat_t sd_set_bus_width(const sd_card_t *card, sdmmc_buswidth_t buswidth)
{
    hpm_stat_t status = sdmmc_send_application_command(card->host, card->relative_addr);
    if (status != status_success) {
        return status;
    }

    sdmmchost_cmd_t *cmd = &card->host->cmd;
    memset(cmd, 0, sizeof(*cmd));
    cmd->cmd_index = sd_acmd_set_bus_width;
    cmd->resp_type = (sdxc_dev_resp_type_t) sdmmc_resp_r1;

    if (buswidth == sdmmc_bus_width_1bit) {
        cmd->cmd_argument = 0;
    } else if (buswidth == sdmmc_bus_width_4bit) {
        cmd->cmd_argument = 2;
    } else {
        return status_invalid_argument;
    }
    status = sd_send_cmd(card, cmd);

    return status;
}

static hpm_stat_t sd_set_bus_timing(sd_card_t *card, sdmmc_speed_mode_t timing_mode)
{
    uint32_t timing_mode_option = (uint32_t) sd_timing_sdr25_highspeed;
    uint32_t clock_option = SD_CLOCK_50MHZ;
    bool need_reverse = true;
    sdmmc_speed_mode_t speed;
    switch (timing_mode) {
    default:
        clock_option = SD_CLOCK_25MHZ;
        speed = sdmmc_sd_speed_sdr12;
        timing_mode_option = sd_timing_sdr12_default;
        break;
    case sd_timing_sdr25_highspeed:
        clock_option = SD_CLOCK_50MHZ;
        speed = sdmmc_sd_speed_sdr25;
        timing_mode_option = sd_timing_sdr25_highspeed;
        break;
    case sd_timing_sdr50:
        clock_option = SD_CLOCK_100MHZ;
        speed = sdmmc_sd_speed_sdr50;
        timing_mode_option = sd_timing_sdr50;
        break;
    case sd_timing_ddr50:
        need_reverse = false;
        clock_option = SD_CLOCK_50MHZ;
        speed = sdmmc_sd_speed_ddr50;
        timing_mode_option = sd_timing_ddr50;
        break;
    case sd_timing_sdr104:
        clock_option = SD_CLOCK_208MHZ;
        speed = sdmmc_sd_speed_sdr104;
        timing_mode_option = sd_timing_sdr104;
        break;
    }

    card->current_timing = speed;

    hpm_stat_t status = sd_switch_function(card,
                                           (uint32_t) sd_switch_function_mode_set,
                                           (uint32_t) sd_switch_function_group_access_mode,
                                           timing_mode_option);
    if (status != status_success) {
        return status;
    }

    sdmmchost_set_speed_mode(card->host, speed);
    card->host->clock_freq = sdmmchost_set_card_clock(card->host, clock_option, need_reverse);
    return status;
}

static void sd_decode_status(sd_card_t *card, uint32_t *raw_status)
{
    sd_raw_status_t *sd_raw_status = (sd_raw_status_t *) raw_status;

    card->status.bus_width = sd_raw_status->data_bus_width;
    card->status.secure_mode = sd_raw_status->secured_mode;
    card->status.card_type = sd_raw_status->sd_card_type;
    card->status.protected_size = sd_raw_status->size_of_protected_area;
    switch (sd_raw_status->speed_class) {
    case 0:
        card->status.speed_class = 0;
        break;
    case 1:
        card->status.speed_class = 2;
        break;
    case 2:
        card->status.speed_class = 4;
        break;
    case 3:
        card->status.speed_class = 6;
        break;
    case 4:
        card->status.speed_class = 10;
        break;
    default:
        card->status.speed_class = 0;
        break;
    }
    card->status.performance_move = sd_raw_status->performance_move;
    if (sd_raw_status->au_size < 0xB) {
        card->status.au_size = (0x4000UL << sd_raw_status->au_size);
    } else {
        switch (sd_raw_status->au_size) {
        case 0xB:
            card->status.au_size = SIZE_1MB * 12;
            break;
        case 0xC:
            card->status.au_size = SIZE_1MB * 16;
            break;
        case 0xD:
            card->status.au_size = SIZE_1MB * 24;
            break;
        case 0xE:
            card->status.au_size = SIZE_1MB * 32;
            break;
        default:
            card->status.au_size = SIZE_1MB * 64;
            break;
        }
    }

    card->status.erase_size = sd_raw_status->au_size * sd_raw_status->erase_size;
    card->status.uhs_au_size = (0x4000UL << sd_raw_status->uhs_au_size);
    card->status.erase_timeout = sd_raw_status->erase_timeout;
    card->status.uhs_speed_grade = sd_raw_status->uhs_speed_grade;
}

void sd_card_deinit(sd_card_t *card)
{
    if (card->is_host_ready) {
        card->is_host_ready = false;
        sdmmchost_deinit(card->host);
    }
}

hpm_stat_t sd_host_init(sd_card_t *card)
{
    hpm_stat_t status = status_success;
    assert(card != NULL);

    status = sdmmchost_init(card->host);
    if (status == status_success) {
        card->is_host_ready = true;
        card->operation_voltage = sdmmc_operation_voltage_3v3;
    }

    return status_success;
}


hpm_stat_t sd_init(sd_card_t *card)
{
    hpm_stat_t status = status_invalid_argument;
    do {
        HPM_BREAK_IF(card == NULL);

        status = sd_host_init(card);
        HPM_BREAK_IF(status != status_success);

        card->host->card_init_done = false;
        card->relative_addr = 0;
        card->current_timing = sdmmc_sd_speed_normal;

        /* Check whether card is present */
        int32_t delay_cnt = 10;
        while (!sd_is_card_present(card)) {
            sdmmchost_delay_ms(card->host, 100);
            delay_cnt--;
            if (delay_cnt < 0) {
                break;
            }
        }
        if (!sd_is_card_present(card)) {
            status = status_sdmmc_wait_card_insert_timeout;
            break;
        }
        card->host->card_inserted = true;
        sdmmchost_delay_ms(card->host, 100); /* Wait a while in case the card connection is still not stable */

        status = sd_card_init(card);

    } while (false);

    return status;
}

void sd_deinit(const sd_card_t *card)
{
    (void) card;
}


hpm_stat_t sd_card_init(sd_card_t *card)
{
    hpm_stat_t status = sd_check_card_parameters(card);
    do {
        HPM_BREAK_IF(status != status_success);

        sdmmchost_set_card_bus_width(card->host, sdmmc_bus_width_1bit);
        sdmmchost_set_card_clock(card->host, SDMMC_CLOCK_400KHZ, true);
        status = sd_probe_bus_voltage(card);
        card->host->operation_mode = hpm_sdmmc_operation_mode_identification;
        sdmmchost_init_io(card->host, card->host->operation_mode);

        HPM_BREAK_IF(status != status_success);

        card->host->dev_type = sdmmc_dev_type_sd;

        /* Send CMD2 */
        status = sd_all_send_cid(card);
        HPM_BREAK_IF(status != status_success);
        /* Send CMD3 */
        status = sd_send_rca(card);
        HPM_BREAK_IF(status != status_success);
        /* Send CMD9 */
        status = sd_send_csd(card);
        HPM_BREAK_IF(status != status_success);
        /* Send CMD7 */
        status = sd_select_card(card, true);
        HPM_BREAK_IF(status != status_success);

        sdmmchost_set_card_clock(card->host, SD_CLOCK_25MHZ, true);
        card->host->operation_mode = hpm_sdmmc_operation_mode_transfer;
        sdmmchost_init_io(card->host, card->host->operation_mode);

        /* Send ACMD13 */
        status = sd_read_status(card);
        HPM_BREAK_IF(status != status_success);

        /* Send ACMD51 */
        status = sd_send_scr(card);
        HPM_BREAK_IF(status != status_success);

        /* TODO: Add CMD42 handling if the CARD in under locked state */

        /*  Send ACMD6 */
        bool support_4bit = IS_HPM_BITMASK_SET(card->host->host_param.host_flags, HPM_SDMMC_HOST_SUPPORT_4BIT);
        if (support_4bit && (card->sd_flags.support_4bit_width != 0)) {
            status = sd_set_bus_width(card, sdmmc_bus_width_4bit);
            if (status != status_success) {
                return status;
            }
            sdmmchost_set_card_bus_width(card->host, sdmmc_bus_width_4bit);
        }
        /* Send CMD16: Set block size */
        status = sdmmc_set_block_size(card->host, SDMMC_BLOCK_SIZE_DEFAULT);
        if (status != status_success) {
            return status;
        }

        /***************************************************************************************************************
         *
         *      Switch to specified highest frequency
         *
         *      Steps:
         *
         *      1. Find the allowed maximum speed mode
         *      2. Switch to the maximum speed mode following the eMMC specification
         *
         **************************************************************************************************************/

        sdmmc_speed_mode_t speed_mode = sdmmc_sd_speed_normal;
        bool support_1v8 = IS_HPM_BITMASK_SET(card->host->host_param.host_flags, HPM_SDMMC_HOST_SUPPORT_1V8);
        bool support_ddr = IS_HPM_BITMASK_SET(card->host->host_param.host_flags, HPM_SDMMC_HOST_SUPPORT_DDR);
        bool support_sdr104 = IS_HPM_BITMASK_SET(card->host->host_param.host_flags, HPM_SDMMC_HOST_SUPPORT_SDR104);
        bool support_sdr50 = IS_HPM_BITMASK_SET(card->host->host_param.host_flags, HPM_SDMMC_HOST_SUPPORT_SDR50);

        bool need_manual_set_cardclk_delay_chain = false;
        if (card->operation_voltage == sdmmc_operation_voltage_1v8) {
            if (support_sdr104 && support_1v8 && support_4bit) {
                speed_mode = sdmmc_sd_speed_sdr104;
            } else if (support_sdr50 && support_1v8 && support_4bit) {
                speed_mode = sdmmc_sd_speed_sdr50;
            } else if (support_ddr && support_1v8 && support_4bit) {
                speed_mode = sdmmc_sd_speed_ddr50;
                need_manual_set_cardclk_delay_chain = true;
            } else {
                speed_mode = sdmmc_sd_speed_high;
            }
        } else {
            speed_mode = sdmmc_sd_speed_high;
        }

        /* Send CMD6: Set bus timing  */
        status = sd_set_bus_timing(card, speed_mode);
        HPM_BREAK_IF(status != status_success);

        /* Perform Tuning process if necessary */
        if ((card->current_timing == sdmmc_sd_speed_sdr50) || (card->current_timing == sdmmc_sd_speed_sdr104)) {
            status = sdmmc_enable_auto_tuning(card->host);
            HPM_BREAK_IF(status != status_success);
        }

        /** Send CMD: Set power limit */
        status = sd_set_max_current(card, sd_current_limit_600ma);
        HPM_BREAK_IF(status != status_success);

        /* Switch to 1.8V signaling, mandatory for DDR50 mode */
        if (speed_mode == sdmmc_sd_speed_ddr50) {
            sdmmchost_select_voltage(card->host, hpm_sdmmc_io_voltage_1v8);
        }

        if (need_manual_set_cardclk_delay_chain) {
            (void) sdmmchost_set_cardclk_delay_chain(card->host);
        }

        /* Try to get new CSD and look up the TRAN_SPEED */
        status = sd_select_card(card, false);
        HPM_BREAK_IF(status != status_success);
        status = sd_send_csd(card);
        HPM_BREAK_IF(status != status_success);

        status = sd_select_card(card, true);
        HPM_BREAK_IF(status != status_success);

    } while (false);

        if (status == status_success) {
        card->host->card_init_done = true;
    }

    return status;
}


bool sd_is_card_present(const sd_card_t *card)
{
    return sdmmchost_is_card_detected(card->host);
}

hpm_stat_t sd_select_card(const sd_card_t *card, bool is_selected)
{
    uint16_t rca = (is_selected) ? card->relative_addr : 0;
    return sdmmc_select_card(card->host, rca, is_selected);
}

hpm_stat_t sd_read_status(sd_card_t *card)
{
    hpm_stat_t status = sdmmc_send_application_command(card->host, card->relative_addr);
    if (status != status_success) {
        return status;
    }

    sdmmchost_cmd_t *cmd = &card->host->cmd;
    sdmmchost_data_t *data = &card->host->data;
    sdmmchost_xfer_t *content = &card->host->xfer;
    cmd->cmd_index = sd_acmd_sd_status;
    cmd->resp_type = (sdxc_dev_resp_type_t) sdmmc_resp_r1;
    data->block_size = 64;
    data->block_cnt = 1;
    data->rx_data = card->host->buffer;
    content->data = data;
    content->command = cmd;
    status = sd_transfer(card, content);
    if (status != status_success) {
        return status;
    }
    uint32_t raw_status[16];
    memcpy(raw_status, card->host->buffer, 64);
    sd_convert_data_endian(raw_status, ARRAY_SIZE(raw_status));

    sd_decode_status(card, raw_status);

    return status;
}

hpm_stat_t sd_read_blocks(sd_card_t *card, uint8_t *buffer, uint32_t start_block, uint32_t block_count)
{
    hpm_stat_t status = sd_check_card_parameters(card);
    do {
        HPM_BREAK_IF(status != status_success);

        if (!card->host->card_init_done) {
            status = status_sdmmc_device_init_required;
            break;
        }

        sdmmchost_cmd_t *cmd = &card->host->cmd;
        sdmmchost_data_t *data = &card->host->data;
        sdmmchost_xfer_t *content = &card->host->xfer;
        memset(cmd, 0, sizeof(*cmd));
        memset(data, 0, sizeof(*data));
        memset(content, 0, sizeof(*content));

        while (block_count > 0) {
            uint32_t read_block_count = (block_count >= MAX_BLOCK_COUNT) ? MAX_BLOCK_COUNT : block_count;
            if (read_block_count > 1) {
                cmd->cmd_index = sdmmc_cmd_read_multiple_block;
                if (card->sd_flags.support_set_block_count_cmd != 0) {
                    data->enable_auto_cmd23 = true;
                } else {
                    data->enable_auto_cmd12 = true;
                }
            } else {
                cmd->cmd_index = sdmmc_cmd_read_single_block;
            }

            uint32_t start_addr = start_block;
            if (card->sd_flags.is_byte_addressing_mode == 1U) {
                start_addr *= card->block_size;
            }
            cmd->resp_type = (sdxc_dev_resp_type_t) sdmmc_resp_r1;
            cmd->cmd_argument = start_addr;
            data->block_size = SDMMC_BLOCK_SIZE_DEFAULT;
            data->block_cnt = read_block_count;
            data->rx_data = (uint32_t *) sdmmc_get_sys_addr(card->host, (uint32_t) buffer);
            content->data = data;
            content->command = cmd;
#if !defined(HPM_SDMMC_ENABLE_CACHE_MAINTENANCE) || (HPM_SDMMC_ENABLE_CACHE_MAINTENANCE == 1)
            uint32_t buf_start = (uint32_t) data->rx_data;
            uint32_t aligned_start = HPM_L1C_CACHELINE_ALIGN_DOWN(buf_start);
            uint32_t end_addr = buf_start + card->block_size * block_count;
            uint32_t aligned_end = HPM_L1C_CACHELINE_ALIGN_UP(end_addr);
            uint32_t aligned_size = aligned_end - aligned_start;
            /* FLUSH un-cacheline aligned memory region */
            if ((buf_start % HPM_L1C_CACHELINE_SIZE) != 0) {
                l1c_dc_writeback(aligned_start, HPM_L1C_CACHELINE_SIZE);
            }
            if ((end_addr % HPM_L1C_CACHELINE_SIZE) != 0) {
                uint32_t aligned_tail = HPM_L1C_CACHELINE_ALIGN_DOWN(end_addr);
                l1c_dc_writeback(aligned_tail, HPM_L1C_CACHELINE_SIZE);
            }
#endif
            status = sd_transfer(card, content);
#if !defined(HPM_SDMMC_ENABLE_CACHE_MAINTENANCE) || (HPM_SDMMC_ENABLE_CACHE_MAINTENANCE == 1)
            l1c_dc_invalidate(aligned_start, aligned_size);
#endif
            if (status != status_success) {
                break;
            }
            block_count -= read_block_count;
            start_block += read_block_count;
            buffer += SDMMC_BLOCK_SIZE_DEFAULT * read_block_count;
        }
    } while (false);

    return status;
}

hpm_stat_t sd_write_blocks(sd_card_t *card, const uint8_t *buffer, uint32_t start_block, uint32_t block_count)
{
    hpm_stat_t status = sd_check_card_parameters(card);
    do {
        HPM_BREAK_IF(status != status_success);

        if (!card->host->card_init_done) {
            status = status_sdmmc_device_init_required;
            break;
        }

        sdmmchost_cmd_t *cmd = &card->host->cmd;
        sdmmchost_data_t *data = &card->host->data;
        sdmmchost_xfer_t *content = &card->host->xfer;
        memset(cmd, 0, sizeof(*cmd));
        memset(data, 0, sizeof(*data));
        memset(content, 0, sizeof(*content));

        status = sd_polling_card_status_busy(card, WRITE_BLOCK_TIMEOUT_IN_MS);
        HPM_BREAK_IF(status != status_success);
        while (block_count > 0) {
            uint32_t write_block_count = (block_count >= MAX_BLOCK_COUNT) ? MAX_BLOCK_COUNT : block_count;

            /* If the card is not an SDUC card, issue ACMD23 to accelerate write performance  */
            if (card->csd.csd_structure <= 1) {
                status = sd_app_cmd_set_write_block_erase_count(card, write_block_count);
                HPM_BREAK_IF(status != status_success);
            }
            if (write_block_count > 1) {
                cmd->cmd_index = sdmmc_cmd_write_multiple_block;
                if (card->sd_flags.support_set_block_count_cmd != 0) {
                    data->enable_auto_cmd23 = true;
                } else {
                    data->enable_auto_cmd12 = true;
                }
            } else {
                cmd->cmd_index = sdmmc_cmd_write_single_block;
                data->enable_auto_cmd12 = false;
            }
            uint32_t start_addr = start_block;
            if (card->sd_flags.is_byte_addressing_mode == 1U) {
                start_addr *= card->block_size;
            }
            cmd->resp_type = (sdxc_dev_resp_type_t) sdmmc_resp_r1;
            cmd->cmd_argument = start_addr;
            data->block_size = SDMMC_BLOCK_SIZE_DEFAULT;
            data->block_cnt = write_block_count;
            data->tx_data = (const uint32_t *) sdmmc_get_sys_addr(card->host, (uint32_t) buffer);
            content->data = data;
            content->command = cmd;
#if !defined(HPM_SDMMC_ENABLE_CACHE_MAINTENANCE) || (HPM_SDMMC_ENABLE_CACHE_MAINTENANCE == 1)
            uint32_t aligned_start = HPM_L1C_CACHELINE_ALIGN_DOWN((uint32_t) data->tx_data);
            uint32_t aligned_end = HPM_L1C_CACHELINE_ALIGN_UP(
                    (uint32_t) data->tx_data + card->block_size * write_block_count);
            uint32_t aligned_size = aligned_end - aligned_start;
            l1c_dc_flush(aligned_start, aligned_size);
#endif
            status = sd_transfer(card, content);
            if (status != status_success) {
                break;
            }
            status = sd_polling_card_status_busy(card, WRITE_BLOCK_TIMEOUT_IN_MS);
            HPM_BREAK_IF(status != status_success);
            block_count -= write_block_count;
            start_block += write_block_count;
            buffer += SDMMC_BLOCK_SIZE_DEFAULT * write_block_count;
        }

    } while (false);

    return status;
}

/**
 * @brief Calculate SD erase timeout value
 * Refer to SD_Specification_Part1_Physical_Layer_Specification_Version4.20.pdf, section 4.14 for more details.
 */
static uint32_t sd_calculate_erase_timeout(const sd_card_t *card, uint32_t start_block, uint32_t block_count)
{
    uint32_t erase_timeout;
    if (card->status.erase_timeout == 0) {
        erase_timeout = block_count * 250U;
    } else {
        uint32_t blocks_per_au = card->status.au_size / card->block_size;
        uint32_t start_block_offset_in_au = start_block % blocks_per_au;
        uint32_t end_block = start_block + block_count;
        uint32_t end_block_offset_in_au = end_block % blocks_per_au;
        uint32_t extra_timeout_in_ms = 0;
        extra_timeout_in_ms += (start_block_offset_in_au > 0) ? 250 : 0;
        extra_timeout_in_ms += (end_block_offset_in_au > 0) ? 250 : 0;

        uint32_t full_erase_au_count = (block_count - (blocks_per_au - start_block_offset_in_au)) / blocks_per_au;

        /* Erase timeout =  Terase/Nerase * AU_COUNT + ERASE_OFFSET */
        erase_timeout = 1000U * card->status.erase_timeout / card->status.erase_size * full_erase_au_count +
                        card->status.erase_offset * 1000;
        if (erase_timeout < 1000) {
            erase_timeout = 1000;
        }
        erase_timeout += extra_timeout_in_ms;
    }
    return erase_timeout;
}

hpm_stat_t sd_erase_blocks(sd_card_t *card, uint32_t start_block, uint32_t block_count)
{
    hpm_stat_t status = sd_check_card_parameters(card);
    do {
        HPM_BREAK_IF(status != status_success);

        if (!card->host->card_init_done) {
            status = status_sdmmc_device_init_required;
            break;
        }

        sdmmchost_cmd_t *cmd = &card->host->cmd;
        memset(cmd, 0, sizeof(*cmd));
        uint32_t erase_start_addr = start_block;
        uint32_t erase_end_addr = start_block + block_count - 1U;
        if (card->sd_flags.is_byte_addressing_mode == 1U) {
            erase_start_addr *= card->block_size;
            erase_end_addr *= card->block_size;
        }
        uint32_t erase_timeout = sd_calculate_erase_timeout(card, start_block, block_count);
        /* Send erase start */
        cmd->cmd_index = sd_cmd_erase_start;
        cmd->cmd_argument = erase_start_addr;
        cmd->resp_type = (sdxc_dev_resp_type_t) sdmmc_resp_r1;
        status = sd_send_cmd(card, cmd);
        HPM_BREAK_IF(status != status_success);
        /* Send Erase end */
        cmd->cmd_index = sd_cmd_erase_end;
        cmd->cmd_argument = erase_end_addr;
        status = sd_send_cmd(card, cmd);
        HPM_BREAK_IF(status != status_success);

        /* Send erase command */
        cmd->cmd_index = sdmmc_cmd_erase;
        cmd->cmd_argument = 0xFF;
        cmd->resp_type = (sdxc_dev_resp_type_t) sdmmc_resp_r1b;
        cmd->cmd_timeout_ms = erase_timeout;
        status = sd_send_cmd(card, cmd);
        HPM_BREAK_IF(status != status_success);

        /* Wait until erase completed. */
        status = sd_polling_card_status_busy(card, erase_timeout);

    } while (false);

    return status;
}

hpm_stat_t sd_set_driver_strength(sd_card_t *card, sd_drive_strength_t driver_strength)
{
    return sd_switch_function(card, (uint32_t) sd_switch_function_mode_set,
                              (uint32_t) sd_switch_function_group_drive_strength, (uint32_t) driver_strength);
}

hpm_stat_t sd_set_max_current(sd_card_t *card, sd_max_current_t max_current)
{
    return sd_switch_function(card, (uint32_t) sd_switch_function_mode_set,
                              (uint32_t) sd_switch_function_group_power_limit, (uint32_t) max_current);
}

hpm_stat_t sd_polling_card_status_busy(sd_card_t *card, uint32_t timeout_ms)
{
    hpm_stat_t status = status_invalid_argument;
    bool is_busy = true;

    volatile uint64_t start_tick = hpm_csr_get_core_mcycle();
    uint64_t timeout_ms_in_ticks = (uint64_t) timeout_ms * (clock_get_frequency(clock_cpu0) / 1000UL);
    do {
        HPM_BREAK_IF((card == NULL) || (card->host == NULL));

        status = sd_send_card_status(card);
        if (status != status_success) {
            break;
        }
        if ((card->r1_status.status == sdmmc_state_program) || (card->r1_status.ready_for_data == 0U)) {
            is_busy = true;
            uint64_t current_tick = hpm_csr_get_core_mcycle();
            if (current_tick - start_tick > timeout_ms_in_ticks) {
                break;
            }
        } else {
            is_busy = false;
        }

    } while (is_busy && (timeout_ms > 0));

    if ((status == status_success) && is_busy) {
        status = status_sdmmc_wait_busy_timeout;
    }

    return status;
}

hpm_stat_t sd_switch_function(sd_card_t *card, uint32_t mode, uint32_t group, uint32_t number)
{
    hpm_stat_t error = status_invalid_argument;

    do {
        HPM_BREAK_IF((card == NULL) || (group > 6) || (group < 1) || (number > 15U));

        sdmmchost_cmd_t *cmd = &card->host->cmd;
        sdmmchost_data_t *data = &card->host->data;
        sdmmchost_xfer_t *content = &card->host->xfer;
        memset(cmd, 0, sizeof(*cmd));
        memset(data, 0, sizeof(*data));
        memset(content, 0, sizeof(*content));

        cmd->cmd_index = sd_cmd_switch;
        cmd->resp_type = (sdxc_dev_resp_type_t) sdmmc_resp_r1;
        cmd->cmd_argument =
                (mode << 31) | (0x00FFFFFFUL & (~(0xFUL << ((group - 1U) * 4)))) | (number << ((group - 1U) * 4));
        data->block_size = sizeof(switch_function_status_t);
        data->block_cnt = 1;
        data->rx_data = (uint32_t *) sdmmc_get_sys_addr(card->host, (uint32_t) &card->host->buffer);
        content->data = data;
        content->command = cmd;
        error = sd_transfer(card, content);
        if (error != status_success) {
            break;
        }

        memcpy(card->sfs.status_word, card->host->buffer, sizeof(switch_function_status_t));
        sd_convert_data_endian(card->sfs.status_word, ARRAY_SIZE(card->sfs.status_word));

    } while (false);

    return error;
}