PDK API Guide for J721E
MMCSD Driver API

Introduction

MMCSD driver interface

Files

file  MMCSD.h
 MMCSD driver interface.
 
#define MMCSD_OK   (0)
 
#define MMCSD_CMD_RESERVED   (32U)
 
#define MMCSD_ERR   (-(1))
 
#define MMCSD_UNDEFINEDCMD   (-(2))
 
#define MMCSD_ERR_1P8V_SWITCH_CARD_NOT_RESPONDING   (-(3))
 
#define MMCSD_ERR_1P8V_SWITCH_MMCIO_SWITCH_FAILURE   (-(4))
 
#define MMCSD_ERR_1P8V_SWITCH_CARD_CMD11_FAILURE   (-(5))
 
#define MMCSD_ERR_INVALID_FREQ   (-(6))
 
#define MMCSD_ERR_FREQ_SWITCH_UNSUCCESSFUL   (-(7))
 
#define MMCSD_ERR_VOLTAGE_SWITCH_FAILURE   (-(8))
 
#define MMCSD_ERR_SET_SOC_INTERRUPT_PATH   (-(9))
 
#define MMCSD_ERR_REL_SOC_INTERRUPT_PATH   (-(10))
 
#define MMCSD_ERR_TUNING_CMD_ERROR   (-(11))
 

Macro Definition Documentation

◆ MMCSD_OK

#define MMCSD_OK   (0)

MMCSD return code – Function executed successfully

◆ MMCSD_CMD_RESERVED

#define MMCSD_CMD_RESERVED   (32U)

MMCSD driver implementations should offset command codes with MMCSD_CMD_RESERVED growing positively

◆ MMCSD_ERR

#define MMCSD_ERR   (-(1))

MMCSD return code – Function executed failed

◆ MMCSD_UNDEFINEDCMD

#define MMCSD_UNDEFINEDCMD   (-(2))

MMCSD_control() returns MMCSD_UNDEFINEDCMD if the control code is not recognized by the driver implementation.

◆ MMCSD_ERR_1P8V_SWITCH_CARD_NOT_RESPONDING

#define MMCSD_ERR_1P8V_SWITCH_CARD_NOT_RESPONDING   (-(3))

MMCSD_Open() returns this if a 1.8V switch was attempted by the controller with the consent of the card (S18A=1), but the card stopped responding thereafter.

◆ MMCSD_ERR_1P8V_SWITCH_MMCIO_SWITCH_FAILURE

#define MMCSD_ERR_1P8V_SWITCH_MMCIO_SWITCH_FAILURE   (-(4))

MMCSD_Open() returns this if changing the MMC controller's voltage to 1.8V stopped the controller working with CMD and DAT lines always powered low. In other words, the 1.8V switch was not succesful as far as the controller is concerned.

◆ MMCSD_ERR_1P8V_SWITCH_CARD_CMD11_FAILURE

#define MMCSD_ERR_1P8V_SWITCH_CARD_CMD11_FAILURE   (-(5))

MMCSD_Open() returns this if the card indicated that a switch is possible via ACMD41 (S18A=1) but stopped responding to CMD11. It could be that some cards may not support CMD11 switch eventhough they advertise it

MMCSD_Control(SET_BUS_FREQ) returns this if a switch to a frequency/mode is not supported by the card. The busFreq should be selected among four types 25MBPS,50MBPS,SDR50/DDR50 (100MBps), SDR104 (200MBPs).

◆ MMCSD_ERR_INVALID_FREQ

#define MMCSD_ERR_INVALID_FREQ   (-(6))

◆ MMCSD_ERR_FREQ_SWITCH_UNSUCCESSFUL

#define MMCSD_ERR_FREQ_SWITCH_UNSUCCESSFUL   (-(7))

MMCSD_Control(SET_BUS_FREQ) returns this if a switch to a frequency switch was attempted but failed.

◆ MMCSD_ERR_VOLTAGE_SWITCH_FAILURE

#define MMCSD_ERR_VOLTAGE_SWITCH_FAILURE   (-(8))

The user defined function MMCSD_voltageSwitchFxn() returns this if a switch to a desired voltage was attempted but failed.

◆ MMCSD_ERR_SET_SOC_INTERRUPT_PATH

#define MMCSD_ERR_SET_SOC_INTERRUPT_PATH   (-(9))

Error encountered in setting SOC interrupt path was attempted but failed.

◆ MMCSD_ERR_REL_SOC_INTERRUPT_PATH

#define MMCSD_ERR_REL_SOC_INTERRUPT_PATH   (-(10))

Error encountered in setting SOC interrupt path was attempted but failed.

◆ MMCSD_ERR_TUNING_CMD_ERROR

#define MMCSD_ERR_TUNING_CMD_ERROR   (-(11))