Quelle sd_uhs2.c
Sprache: C
// SPDX-License-Identifier: GPL-2.0-only
/*
* Copyright ( C ) 2021 Linaro Ltd
* Author : Ulf Hansson < ulf . hansson @ linaro . org >
*
* Copyright ( C ) 2014 Intel Corp , All Rights Reserved .
* Author : Yi Sun < yi . y . sun @ intel . com >
*
* Copyright ( C ) 2020 Genesys Logic , Inc .
* Authors : Ben Chuang < ben . chuang @ genesyslogic . com . tw >
*
* Copyright ( C ) 2020 Linaro Limited
* Author : AKASHI Takahiro < takahiro . akashi @ linaro . org >
*
* Copyright ( C ) 2022 Genesys Logic , Inc .
* Authors : Jason Lai < jason . lai @ genesyslogic . com . tw >
*
* Copyright ( C ) 2023 Genesys Logic , Inc .
* Authors : Victor Shih < victor . shih @ genesyslogic . com . tw >
*
* Support for SD UHS - II cards
*/
#include <linux/err.h>
#include <linux/pm_runtime.h>
#include <linux/mmc/host.h>
#include <linux/mmc/card.h>
#include <linux/mmc/mmc.h>
#include <linux/mmc/sd.h>
#include <linux/mmc/sd_uhs2.h>
#include "card.h"
#include "core.h"
#include "bus.h"
#include "sd.h"
#include "sd_ops.h"
#include "mmc_ops.h"
#define UHS2_WAIT_CFG_COMPLETE_PERIOD_US (1 * 1000 )
#define UHS2_WAIT_CFG_COMPLETE_TIMEOUT_MS 100
static const unsigned int sd_uhs2_freqs[] = { 52000000 , 26000000 };
struct sd_uhs2_wait_active_state_data {
struct mmc_host *host;
struct mmc_command *cmd;
};
static int sd_uhs2_power_up(struct mmc_host *host)
{
if (host->ios.power_mode == MMC_POWER_ON)
return 0 ;
host->ios.vdd = fls(host->ocr_avail) - 1 ;
host->ios.clock = host->f_init;
host->ios.timing = MMC_TIMING_UHS2_SPEED_A;
host->ios.power_mode = MMC_POWER_ON;
return host->ops->uhs2_control(host, UHS2_SET_IOS);
}
static int sd_uhs2_power_off(struct mmc_host *host)
{
int err;
if (host->ios.power_mode == MMC_POWER_OFF)
return 0 ;
host->ios.vdd = 0 ;
host->ios.clock = 0 ;
host->ios.power_mode = MMC_POWER_OFF;
host->uhs2_sd_tran = false ;
err = host->ops->uhs2_control(host, UHS2_SET_IOS);
if (err)
return err;
/* For consistency, let's restore the initial timing. */
host->ios.timing = MMC_TIMING_LEGACY;
return 0 ;
}
/*
* Run the phy initialization sequence , which mainly relies on the UHS - II host
* to check that we reach the expected electrical state , between the host and
* the card .
*/
static int sd_uhs2_phy_init(struct mmc_host *host)
{
int err;
err = host->ops->uhs2_control(host, UHS2_PHY_INIT);
if (err) {
pr_debug("%s: failed to initial phy for UHS-II!\n" ,
mmc_hostname(host));
}
return err;
}
/*
* sd_uhs2_cmd_assemble ( ) - build up UHS - II command packet which is embedded in
* mmc_command structure
* @ cmd : MMC command to executed
* @ uhs2_cmd : UHS2 command corresponded to MMC command
* @ header : Header field of UHS - II command cxpacket
* @ arg : Argument field of UHS - II command packet
* @ payload : Payload field of UHS - II command packet
* @ plen : Payload length
* @ resp : Response buffer is allocated by caller and it is used to keep
* the response of CM - TRAN command . For SD - TRAN command , uhs2_resp
* should be null and SD - TRAN command response should be stored in
* resp of mmc_command .
* @ resp_len : Response buffer length
*
* The uhs2_command structure contains message packets which are transmited /
* received on UHS - II bus . This function fills in the contents of uhs2_command
* structure and embededs UHS2 command into mmc_command structure , which is used
* in legacy SD operation functions .
*
*/
static void sd_uhs2_cmd_assemble(struct mmc_command *cmd,
struct uhs2_command *uhs2_cmd,
u8 plen, u8 resp_len)
{
uhs2_cmd->payload_len = plen * sizeof (u32);
uhs2_cmd->packet_len = uhs2_cmd->payload_len + 4 ;
cmd->uhs2_cmd = uhs2_cmd;
cmd->uhs2_cmd->uhs2_resp_len = resp_len;
}
/*
* Do the early initialization of the card , by sending the device init broadcast
* command and wait for the process to be completed .
*/
static int sd_uhs2_dev_init(struct mmc_host *host)
{
struct mmc_command cmd = {0 };
struct uhs2_command uhs2_cmd = {};
u32 cnt;
u32 dap, gap, resp_gap;
u32 payload0;
u8 gd = 0 ;
int err;
dap = host->uhs2_caps.dap;
gap = host->uhs2_caps.gap;
/*
* Refer to UHS - II Addendum Version 1 . 02 Figure 6 - 21 to see DEVICE_INIT CCMD format .
* Head :
* - Control Write ( R / W = 1 ) with 4 - Byte payload ( PLEN = 01 b ) .
* - IOADR = CMD_BASE + 002 h
* Payload :
* - bit [ 3 : 0 ] : GAP ( Group Allocated Power )
* - bit [ 7 : 4 ] : GD ( Group Descriptor )
* - bit [ 11 ] : Complete Flag
* - bit [ 15 : 12 ] : DAP ( Device Allocated Power )
*/
uhs2_cmd.header = UHS2_NATIVE_PACKET | UHS2_PACKET_TYPE_CCMD;
uhs2_cmd.arg = ((UHS2_DEV_CMD_DEVICE_INIT & 0 xFF) << 8 ) |
UHS2_NATIVE_CMD_WRITE |
UHS2_NATIVE_CMD_PLEN_4B |
(UHS2_DEV_CMD_DEVICE_INIT >> 8 );
/*
* Refer to UHS - II Addendum Version 1 . 02 section 6 . 3 . 1 .
* Max . time from DEVICE_INIT CCMD EOP reception on Device
* Rx to its SOP transmission on Device Tx ( Tfwd_init_cmd ) is
* 1 second .
*/
cmd.busy_timeout = 1000 ;
/*
* Refer to UHS - II Addendum Version 1 . 02 section 6 . 2 . 6 . 3 .
* Let ' s retry the DEVICE_INIT command no more than 30 times .
*/
for (cnt = 0 ; cnt < 30 ; cnt++) {
payload0 = ((dap & 0 xF) << 12 ) |
UHS2_DEV_INIT_COMPLETE_FLAG |
((gd & 0 xF) << 4 ) |
(gap & 0 xF);
uhs2_cmd.payload[0 ] = (__force __be32)payload0;
sd_uhs2_cmd_assemble(&cmd, &uhs2_cmd, UHS2_DEV_INIT_PAYLOAD_LEN,
UHS2_DEV_INIT_RESP_LEN);
err = mmc_wait_for_cmd(host, &cmd, 0 );
if (err) {
pr_err("%s: %s: UHS2 CMD send fail, err= 0x%x!\n" ,
mmc_hostname(host), __func__, err);
continue ;
}
if (uhs2_cmd.uhs2_resp[3 ] != (UHS2_DEV_CMD_DEVICE_INIT & 0 xFF)) {
pr_err("%s: DEVICE_INIT response is wrong!\n" ,
mmc_hostname(host));
return -EIO;
}
if (uhs2_cmd.uhs2_resp[5 ] & 0 x8) {
host->uhs2_caps.group_desc = gd;
return 0 ;
}
resp_gap = uhs2_cmd.uhs2_resp[4 ] & 0 x0F;
if (gap == resp_gap)
gd++;
}
if (err) {
pr_err("%s: %s: UHS2 CMD send fail, err= 0x%x!\n" ,
mmc_hostname(host), __func__, err);
return err;
}
return 0 ;
}
/*
* Run the enumeration process by sending the enumerate command to the card .
* Note that , we currently support only the point to point connection , which
* means only one card can be attached per host / slot .
*/
static int sd_uhs2_enum(struct mmc_host *host, u32 *node_id)
{
struct mmc_command cmd = {0 };
struct uhs2_command uhs2_cmd = {};
u32 payload0;
u8 id_f = 0 xF, id_l = 0 x0;
int err;
/*
* Refer to UHS - II Addendum Version 1 . 02 Figure 6 - 28 to see ENUMERATE CCMD format .
* Header :
* - Control Write ( R / W = 1 ) with 4 - Byte payload ( PLEN = 01 b ) .
* - IOADR = CMD_BASE + 003 h
* Payload :
* - bit [ 3 : 0 ] : ID_L ( Last Node ID )
* - bit [ 7 : 4 ] : ID_F ( First Node ID )
*/
uhs2_cmd.header = UHS2_NATIVE_PACKET | UHS2_PACKET_TYPE_CCMD;
uhs2_cmd.arg = ((UHS2_DEV_CMD_ENUMERATE & 0 xFF) << 8 ) |
UHS2_NATIVE_CMD_WRITE |
UHS2_NATIVE_CMD_PLEN_4B |
(UHS2_DEV_CMD_ENUMERATE >> 8 );
payload0 = (id_f << 4 ) | id_l;
uhs2_cmd.payload[0 ] = cpu_to_be32(payload0);
sd_uhs2_cmd_assemble(&cmd, &uhs2_cmd, UHS2_DEV_ENUM_PAYLOAD_LEN, UHS2_DEV_ENUM_RESP_LEN);
err = mmc_wait_for_cmd(host, &cmd, 0 );
if (err) {
pr_err("%s: %s: UHS2 CMD send fail, err= 0x%x!\n" ,
mmc_hostname(host), __func__, err);
return err;
}
if (uhs2_cmd.uhs2_resp[3 ] != (UHS2_DEV_CMD_ENUMERATE & 0 xFF)) {
pr_err("%s: ENUMERATE response is wrong!\n" ,
mmc_hostname(host));
return -EIO;
}
id_f = (uhs2_cmd.uhs2_resp[4 ] >> 4 ) & 0 xF;
id_l = uhs2_cmd.uhs2_resp[4 ] & 0 xF;
*node_id = id_f;
return 0 ;
}
/*
* Read the UHS - II configuration registers ( CFG_REG ) of the card , by sending it
* commands and by parsing the responses . Store a copy of the relevant data in
* card - > uhs2_config .
*/
static int sd_uhs2_config_read(struct mmc_host *host, struct mmc_card *card)
{
struct mmc_command cmd = {0 };
struct uhs2_command uhs2_cmd = {};
u32 cap;
int err;
/*
* Use Control Read CCMD to read Generic Capability from Configuration Register .
* - Control Write ( R / W = 1 ) with 4 - Byte payload ( PLEN = 01 b ) .
* - IOADR = Generic Capability Register ( CFG_BASE + 000 h )
*/
uhs2_cmd.header = UHS2_NATIVE_PACKET | UHS2_PACKET_TYPE_CCMD | card->uhs2_config.node_id;
uhs2_cmd.arg = ((UHS2_DEV_CONFIG_GEN_CAPS & 0 xFF) << 8 ) |
UHS2_NATIVE_CMD_READ |
UHS2_NATIVE_CMD_PLEN_4B |
(UHS2_DEV_CONFIG_GEN_CAPS >> 8 );
/*
* There is no payload because per spec , there should be
* no payload field for read CCMD .
* Plen is set in arg . Per spec , plen for read CCMD
* represents the len of read data which is assigned in payload
* of following RES ( p136 ) .
*/
sd_uhs2_cmd_assemble(&cmd, &uhs2_cmd, 0 , 0 );
err = mmc_wait_for_cmd(host, &cmd, 0 );
if (err) {
pr_err("%s: %s: UHS2 CMD send fail, err= 0x%x!\n" ,
mmc_hostname(host), __func__, err);
return err;
}
/*
* Generic Capability Register :
* bit [ 7 : 0 ] : Reserved
* bit [ 13 : 8 ] : Device - Specific Number of Lanes and Functionality
* bit 8 : 2 L - HD
* bit 9 : 2 D - 1 U FD
* bit 10 : 1 D - 2 U FD
* bit 11 : 2 D - 2 U FD
* Others : Reserved
* bit [ 14 ] : DADR Length
* 0 : 4 bytes
* 1 : Reserved
* bit [ 23 : 16 ] : Application Type
* bit 16 : 0 = Non - SD memory , 1 = SD memory
* bit 17 : 0 = Non - SDIO , 1 = SDIO
* bit 18 : 0 = Card , 1 = Embedded
* bit [ 63 : 24 ] : Reserved
*/
cap = cmd.resp[0 ];
card->uhs2_config.n_lanes =
(cap >> UHS2_DEV_CONFIG_N_LANES_POS) &
UHS2_DEV_CONFIG_N_LANES_MASK;
card->uhs2_config.dadr_len =
(cap >> UHS2_DEV_CONFIG_DADR_POS) &
UHS2_DEV_CONFIG_DADR_MASK;
card->uhs2_config.app_type =
(cap >> UHS2_DEV_CONFIG_APP_POS) &
UHS2_DEV_CONFIG_APP_MASK;
/*
* Use Control Read CCMD to read PHY Capability from Configuration Register .
* - Control Write ( R / W = 1 ) with 8 - Byte payload ( PLEN = 10 b ) .
* - IOADR = PHY Capability Register ( CFG_BASE + 002 h )
*/
uhs2_cmd.arg = ((UHS2_DEV_CONFIG_PHY_CAPS & 0 xFF) << 8 ) |
UHS2_NATIVE_CMD_READ |
UHS2_NATIVE_CMD_PLEN_8B |
(UHS2_DEV_CONFIG_PHY_CAPS >> 8 );
sd_uhs2_cmd_assemble(&cmd, &uhs2_cmd, 0 , 0 );
err = mmc_wait_for_cmd(host, &cmd, 0 );
if (err) {
pr_err("%s: %s: UHS2 CMD send fail, err= 0x%x!\n" ,
mmc_hostname(host), __func__, err);
return err;
}
/*
* PHY Capability Register :
* bit [ 3 : 0 ] : PHY Minor Revision
* bit [ 5 : 4 ] : PHY Major Revision
* bit [ 15 ] : Support Hibernate Mode
* 0 : Not support Hibernate Mode
* 1 : Support Hibernate Mode
* bit [ 31 : 16 ] : Reserved
* bit [ 35 : 32 ] : Device - Specific N_LSS_SYN
* bit [ 39 : 36 ] : Device - Specific N_LSS_DIR
* bit [ 63 : 40 ] : Reserved
*/
cap = cmd.resp[0 ];
card->uhs2_config.phy_minor_rev =
cap & UHS2_DEV_CONFIG_PHY_MINOR_MASK;
card->uhs2_config.phy_major_rev =
(cap >> UHS2_DEV_CONFIG_PHY_MAJOR_POS) &
UHS2_DEV_CONFIG_PHY_MAJOR_MASK;
card->uhs2_config.can_hibernate =
(cap >> UHS2_DEV_CONFIG_CAN_HIBER_POS) &
UHS2_DEV_CONFIG_CAN_HIBER_MASK;
cap = cmd.resp[1 ];
card->uhs2_config.n_lss_sync =
cap & UHS2_DEV_CONFIG_N_LSS_SYN_MASK;
card->uhs2_config.n_lss_dir =
(cap >> UHS2_DEV_CONFIG_N_LSS_DIR_POS) &
UHS2_DEV_CONFIG_N_LSS_DIR_MASK;
if (card->uhs2_config.n_lss_sync == 0 )
card->uhs2_config.n_lss_sync = 16 << 2 ;
else
card->uhs2_config.n_lss_sync <<= 2 ;
if (card->uhs2_config.n_lss_dir == 0 )
card->uhs2_config.n_lss_dir = 16 << 3 ;
else
card->uhs2_config.n_lss_dir <<= 3 ;
/*
* Use Control Read CCMD to read LINK / TRAN Capability from Configuration Register .
* - Control Write ( R / W = 1 ) with 8 - Byte payload ( PLEN = 10 b ) .
* - IOADR = LINK / TRAN Capability Register ( CFG_BASE + 004 h )
*/
uhs2_cmd.arg = ((UHS2_DEV_CONFIG_LINK_TRAN_CAPS & 0 xFF) << 8 ) |
UHS2_NATIVE_CMD_READ |
UHS2_NATIVE_CMD_PLEN_8B |
(UHS2_DEV_CONFIG_LINK_TRAN_CAPS >> 8 );
sd_uhs2_cmd_assemble(&cmd, &uhs2_cmd, 0 , 0 );
err = mmc_wait_for_cmd(host, &cmd, 0 );
if (err) {
pr_err("%s: %s: UHS2 CMD send fail, err= 0x%x!\n" ,
mmc_hostname(host), __func__, err);
return err;
}
/*
* LINK / TRAN Capability Register :
* bit [ 3 : 0 ] : LINK_TRAN Minor Revision
* bit [ 5 : 4 ] : LINK / TRAN Major Revision
* bit [ 7 : 6 ] : Reserved
* bit [ 15 : 8 ] : Device - Specific N_FCU
* bit [ 18 : 16 ] : Device Type
* 001 b = Host
* 010 b = Device
* 011 b = Reserved for CMD issuable Device
* bit [ 19 ] : Reserved
* bit [ 31 : 20 ] : Device - Specific MAX_BLKLEN
* bit [ 39 : 32 ] : Device - Specific N_DATA_GAP
* bit [ 63 : 40 ] : Reserved
*/
cap = cmd.resp[0 ];
card->uhs2_config.link_minor_rev =
cap & UHS2_DEV_CONFIG_LT_MINOR_MASK;
card->uhs2_config.link_major_rev =
(cap >> UHS2_DEV_CONFIG_LT_MAJOR_POS) &
UHS2_DEV_CONFIG_LT_MAJOR_MASK;
card->uhs2_config.n_fcu =
(cap >> UHS2_DEV_CONFIG_N_FCU_POS) &
UHS2_DEV_CONFIG_N_FCU_MASK;
card->uhs2_config.dev_type =
(cap >> UHS2_DEV_CONFIG_DEV_TYPE_POS) &
UHS2_DEV_CONFIG_DEV_TYPE_MASK;
card->uhs2_config.maxblk_len =
(cap >> UHS2_DEV_CONFIG_MAX_BLK_LEN_POS) &
UHS2_DEV_CONFIG_MAX_BLK_LEN_MASK;
cap = cmd.resp[1 ];
card->uhs2_config.n_data_gap =
cap & UHS2_DEV_CONFIG_N_DATA_GAP_MASK;
if (card->uhs2_config.n_fcu == 0 )
card->uhs2_config.n_fcu = 256 ;
return 0 ;
}
/*
* Based on the card ' s and host ' s UHS - II capabilities , let ' s update the
* configuration of the card and the host . This may also include to move to a
* greater speed range / mode . Depending on the updated configuration , we may need
* to do a soft reset of the card via sending it a GO_DORMANT_STATE command .
*
* In the final step , let ' s check if the card signals " config completion " , which
* indicates that the card has moved from config state into active state .
*/
static int sd_uhs2_config_write(struct mmc_host *host, struct mmc_card *card)
{
struct mmc_command cmd = {0 };
struct uhs2_command uhs2_cmd = {};
u32 payload0, payload1;
u8 nMinDataGap;
int err;
/*
* Use Control Write CCMD to set Generic Setting in Configuration Register .
* - Control Write ( R / W = 1 ) with 8 - Byte payload ( PLEN = 10 b ) .
* - IOADR = Generic Setting Register ( CFG_BASE + 008 h )
* - Payload = New contents to be written to Generic Setting Register
*/
uhs2_cmd.header = UHS2_NATIVE_PACKET | UHS2_PACKET_TYPE_CCMD | card->uhs2_config.node_id;
uhs2_cmd.arg = ((UHS2_DEV_CONFIG_GEN_SET & 0 xFF) << 8 ) |
UHS2_NATIVE_CMD_WRITE |
UHS2_NATIVE_CMD_PLEN_8B |
(UHS2_DEV_CONFIG_GEN_SET >> 8 );
/*
* Most UHS - II cards only support FD and 2 L - HD mode . Other lane numbers
* defined in UHS - II addendem Ver1 . 01 are optional .
*/
host->uhs2_caps.n_lanes_set = UHS2_DEV_CONFIG_GEN_SET_2L_FD_HD;
card->uhs2_config.n_lanes_set = UHS2_DEV_CONFIG_GEN_SET_2L_FD_HD;
payload0 = card->uhs2_config.n_lanes_set << UHS2_DEV_CONFIG_N_LANES_POS;
payload1 = 0 ;
uhs2_cmd.payload[0 ] = cpu_to_be32(payload0);
uhs2_cmd.payload[1 ] = cpu_to_be32(payload1);
/*
* There is no payload because per spec , there should be
* no payload field for read CCMD .
* Plen is set in arg . Per spec , plen for read CCMD
* represents the len of read data which is assigned in payload
* of following RES ( p136 ) .
*/
sd_uhs2_cmd_assemble(&cmd, &uhs2_cmd, UHS2_CFG_WRITE_PAYLOAD_LEN, 0 );
err = mmc_wait_for_cmd(host, &cmd, 0 );
if (err) {
pr_err("%s: %s: UHS2 CMD send fail, err= 0x%x!\n" ,
mmc_hostname(host), __func__, err);
return err;
}
/*
* Use Control Write CCMD to set PHY Setting in Configuration Register .
* - Control Write ( R / W = 1 ) with 8 - Byte payload ( PLEN = 10 b ) .
* - IOADR = PHY Setting Register ( CFG_BASE + 00 Ah )
* - Payload = New contents to be written to PHY Setting Register
*/
uhs2_cmd.arg = ((UHS2_DEV_CONFIG_PHY_SET & 0 xFF) << 8 ) |
UHS2_NATIVE_CMD_WRITE |
UHS2_NATIVE_CMD_PLEN_8B |
(UHS2_DEV_CONFIG_PHY_SET >> 8 );
if (host->uhs2_caps.speed_range == UHS2_DEV_CONFIG_PHY_SET_SPEED_B) {
if (card->uhs2_config.n_lanes == UHS2_DEV_CONFIG_2L_HD_FD &&
host->uhs2_caps.n_lanes == UHS2_DEV_CONFIG_2L_HD_FD) {
/* Support HD */
host->ios.timing = MMC_TIMING_UHS2_SPEED_B_HD;
nMinDataGap = 1 ;
} else {
/* Only support 2L-FD so far */
host->ios.timing = MMC_TIMING_UHS2_SPEED_B;
nMinDataGap = 3 ;
}
card->uhs2_config.speed_range_set = UHS2_DEV_CONFIG_PHY_SET_SPEED_B;
} else {
if (card->uhs2_config.n_lanes == UHS2_DEV_CONFIG_2L_HD_FD &&
host->uhs2_caps.n_lanes == UHS2_DEV_CONFIG_2L_HD_FD) {
/* Support HD */
host->ios.timing = MMC_TIMING_UHS2_SPEED_A_HD;
nMinDataGap = 1 ;
} else {
/* Only support 2L-FD so far */
host->ios.timing = MMC_TIMING_UHS2_SPEED_A;
nMinDataGap = 3 ;
}
card->uhs2_config.speed_range_set = UHS2_DEV_CONFIG_PHY_SET_SPEED_A;
}
payload0 = card->uhs2_config.speed_range_set << UHS2_DEV_CONFIG_PHY_SET_SPEED_POS;
card->uhs2_config.n_lss_sync_set = (max(card->uhs2_config.n_lss_sync,
host->uhs2_caps.n_lss_sync) >> 2 ) &
UHS2_DEV_CONFIG_N_LSS_SYN_MASK;
host->uhs2_caps.n_lss_sync_set = card->uhs2_config.n_lss_sync_set;
card->uhs2_config.n_lss_dir_set = (max(card->uhs2_config.n_lss_dir,
host->uhs2_caps.n_lss_dir) >> 3 ) &
UHS2_DEV_CONFIG_N_LSS_DIR_MASK;
host->uhs2_caps.n_lss_dir_set = card->uhs2_config.n_lss_dir_set;
payload1 = (card->uhs2_config.n_lss_dir_set << UHS2_DEV_CONFIG_N_LSS_DIR_POS) |
card->uhs2_config.n_lss_sync_set;
uhs2_cmd.payload[0 ] = cpu_to_be32(payload0);
uhs2_cmd.payload[1 ] = cpu_to_be32(payload1);
memset(uhs2_cmd.uhs2_resp, 0 , sizeof (uhs2_cmd.uhs2_resp));
sd_uhs2_cmd_assemble(&cmd, &uhs2_cmd, UHS2_CFG_WRITE_PAYLOAD_LEN,
UHS2_CFG_WRITE_PHY_SET_RESP_LEN);
err = mmc_wait_for_cmd(host, &cmd, 0 );
if (err) {
pr_err("%s: %s: UHS2 CMD send fail, err= 0x%x!\n" ,
mmc_hostname(host), __func__, err);
return err;
}
if ((uhs2_cmd.uhs2_resp[2 ] & 0 x80)) {
pr_err("%s: %s: UHS2 CMD not accepted, resp= 0x%x!\n" ,
mmc_hostname(host), __func__, uhs2_cmd.uhs2_resp[2 ]);
return -EIO;
}
/*
* Use Control Write CCMD to set LINK / TRAN Setting in Configuration Register .
* - Control Write ( R / W = 1 ) with 8 - Byte payload ( PLEN = 10 b ) .
* - IOADR = LINK / TRAN Setting Register ( CFG_BASE + 00 Ch )
* - Payload = New contents to be written to LINK / TRAN Setting Register
*/
uhs2_cmd.arg = ((UHS2_DEV_CONFIG_LINK_TRAN_SET & 0 xFF) << 8 ) |
UHS2_NATIVE_CMD_WRITE |
UHS2_NATIVE_CMD_PLEN_8B |
(UHS2_DEV_CONFIG_LINK_TRAN_SET >> 8 );
if (card->uhs2_config.app_type == UHS2_DEV_CONFIG_APP_SD_MEM)
card->uhs2_config.maxblk_len_set = UHS2_DEV_CONFIG_LT_SET_MAX_BLK_LEN;
else
card->uhs2_config.maxblk_len_set = min(card->uhs2_config.maxblk_len,
host->uhs2_caps.maxblk_len);
host->uhs2_caps.maxblk_len_set = card->uhs2_config.maxblk_len_set;
card->uhs2_config.n_fcu_set = min(card->uhs2_config.n_fcu, host->uhs2_caps.n_fcu);
host->uhs2_caps.n_fcu_set = card->uhs2_config.n_fcu_set;
card->uhs2_config.n_data_gap_set = max(nMinDataGap, card->uhs2_config.n_data_gap);
host->uhs2_caps.n_data_gap_set = card->uhs2_config.n_data_gap_set;
host->uhs2_caps.max_retry_set = 3 ;
card->uhs2_config.max_retry_set = host->uhs2_caps.max_retry_set;
payload0 = (card->uhs2_config.maxblk_len_set << UHS2_DEV_CONFIG_MAX_BLK_LEN_POS) |
(card->uhs2_config.max_retry_set << UHS2_DEV_CONFIG_LT_SET_MAX_RETRY_POS) |
(card->uhs2_config.n_fcu_set << UHS2_DEV_CONFIG_N_FCU_POS);
payload1 = card->uhs2_config.n_data_gap_set;
uhs2_cmd.payload[0 ] = cpu_to_be32(payload0);
uhs2_cmd.payload[1 ] = cpu_to_be32(payload1);
sd_uhs2_cmd_assemble(&cmd, &uhs2_cmd, UHS2_CFG_WRITE_PAYLOAD_LEN, 0 );
err = mmc_wait_for_cmd(host, &cmd, 0 );
if (err) {
pr_err("%s: %s: UHS2 CMD send fail, err= 0x%x!\n" ,
mmc_hostname(host), __func__, err);
return err;
}
/*
* Use Control Write CCMD to set Config Completion ( payload bit 63 ) in Generic Setting
* Register .
* Header :
* - Control Write ( R / W = 1 ) with 8 - Byte payload ( PLEN = 10 b ) .
* - IOADR = PGeneric Setting Register ( CFG_BASE + 008 h )
* Payload :
* - bit [ 63 ] : Config Completion
*
* DLSM transits to Active state immediately when Config Completion is set to 1 .
*/
uhs2_cmd.arg = ((UHS2_DEV_CONFIG_GEN_SET & 0 xFF) << 8 ) |
UHS2_NATIVE_CMD_WRITE |
UHS2_NATIVE_CMD_PLEN_8B |
(UHS2_DEV_CONFIG_GEN_SET >> 8 );
payload0 = 0 ;
payload1 = UHS2_DEV_CONFIG_GEN_SET_CFG_COMPLETE;
uhs2_cmd.payload[0 ] = cpu_to_be32(payload0);
uhs2_cmd.payload[1 ] = cpu_to_be32(payload1);
memset(uhs2_cmd.uhs2_resp, 0 , sizeof (uhs2_cmd.uhs2_resp));
sd_uhs2_cmd_assemble(&cmd, &uhs2_cmd, UHS2_CFG_WRITE_PAYLOAD_LEN,
UHS2_CFG_WRITE_GENERIC_SET_RESP_LEN);
err = mmc_wait_for_cmd(host, &cmd, 0 );
if (err) {
pr_err("%s: %s: UHS2 CMD send fail, err= 0x%x!\n" ,
mmc_hostname(host), __func__, err);
return err;
}
/* Set host Config Setting registers */
err = host->ops->uhs2_control(host, UHS2_SET_CONFIG);
if (err) {
pr_err("%s: %s: UHS2 SET_CONFIG fail!\n" , mmc_hostname(host), __func__);
return err;
}
return 0 ;
}
static int sd_uhs2_go_dormant(struct mmc_host *host, u32 node_id)
{
struct mmc_command cmd = {0 };
struct uhs2_command uhs2_cmd = {};
int err;
/* Disable Normal INT */
err = host->ops->uhs2_control(host, UHS2_DISABLE_INT);
if (err) {
pr_err("%s: %s: UHS2 DISABLE_INT fail!\n" ,
mmc_hostname(host), __func__);
return err;
}
/*
* Refer to UHS - II Addendum Version 1 . 02 Figure 6 - 17 to see GO_DORMANT_STATE CCMD format .
* Header :
* - Control Write ( R / W = 1 ) with 4 - Byte payload ( PLEN = 01 b ) .
* - IOADR = CMD_BASE + 001 h
* Payload :
* - bit [ 7 ] : HBR ( Entry to Hibernate Mode )
* 1 : Host intends to enter Hibernate mode during Dormant state .
* The default setting is 0 because hibernate is currently not supported .
*/
uhs2_cmd.header = UHS2_NATIVE_PACKET | UHS2_PACKET_TYPE_CCMD | node_id;
uhs2_cmd.arg = ((UHS2_DEV_CMD_GO_DORMANT_STATE & 0 xFF) << 8 ) |
UHS2_NATIVE_CMD_WRITE |
UHS2_NATIVE_CMD_PLEN_4B |
(UHS2_DEV_CMD_GO_DORMANT_STATE >> 8 );
sd_uhs2_cmd_assemble(&cmd, &uhs2_cmd, UHS2_GO_DORMANT_PAYLOAD_LEN, 0 );
err = mmc_wait_for_cmd(host, &cmd, 0 );
if (err) {
pr_err("%s: %s: UHS2 CMD send fail, err= 0x%x!\n" ,
mmc_hostname(host), __func__, err);
return err;
}
/* Check Dormant State in Present */
err = host->ops->uhs2_control(host, UHS2_CHECK_DORMANT);
if (err)
return err;
/* Disable UHS2 card clock */
err = host->ops->uhs2_control(host, UHS2_DISABLE_CLK);
if (err)
return err;
/* Restore sd clock */
mmc_delay(5 );
err = host->ops->uhs2_control(host, UHS2_ENABLE_CLK);
if (err)
return err;
/* Enable Normal INT */
err = host->ops->uhs2_control(host, UHS2_ENABLE_INT);
if (err)
return err;
/* Detect UHS2 */
err = host->ops->uhs2_control(host, UHS2_PHY_INIT);
if (err)
return err;
return 0 ;
}
static int sd_uhs2_wait_active_state_cb(void *cb_data, bool *busy)
{
struct sd_uhs2_wait_active_state_data *data = cb_data;
struct mmc_host *host = data->host;
struct mmc_command *cmd = data->cmd;
int err;
err = mmc_wait_for_cmd(host, cmd, 0 );
if (err)
return err;
if (cmd->resp[1 ] & UHS2_DEV_CONFIG_GEN_SET_CFG_COMPLETE)
*busy = false ;
else
*busy = true ;
return 0 ;
}
static int sd_uhs2_go_dormant_state(struct mmc_host *host, u32 node_id)
{
struct mmc_command cmd = {0 };
struct uhs2_command uhs2_cmd = {};
int err;
struct sd_uhs2_wait_active_state_data cb_data = {
.host = host,
.cmd = &cmd
};
err = sd_uhs2_go_dormant(host, node_id);
if (err) {
pr_err("%s: %s: UHS2 GO_DORMANT_STATE fail, err= 0x%x!\n" ,
mmc_hostname(host), __func__, err);
return err;
}
/*
* Use Control Read CCMD to check Config Completion ( bit 63 ) in Generic Setting Register .
* - Control Read ( R / W = 0 ) with 8 - Byte payload ( PLEN = 10 b ) .
* - IOADR = Generic Setting Register ( CFG_BASE + 008 h )
*
* When UHS - II card been switched to new speed mode , it will set Config Completion to 1 .
*/
uhs2_cmd.header = UHS2_NATIVE_PACKET | UHS2_PACKET_TYPE_CCMD | node_id;
uhs2_cmd.arg = ((UHS2_DEV_CONFIG_GEN_SET & 0 xFF) << 8 ) |
UHS2_NATIVE_CMD_READ |
UHS2_NATIVE_CMD_PLEN_8B |
(UHS2_DEV_CONFIG_GEN_SET >> 8 );
sd_uhs2_cmd_assemble(&cmd, &uhs2_cmd, 0 , 0 );
err = __mmc_poll_for_busy(host, UHS2_WAIT_CFG_COMPLETE_PERIOD_US,
UHS2_WAIT_CFG_COMPLETE_TIMEOUT_MS,
&sd_uhs2_wait_active_state_cb, &cb_data);
if (err) {
pr_err("%s: %s: Not switch to Active in 100 ms\n" , mmc_hostname(host), __func__);
return err;
}
return 0 ;
}
/*
* Allocate the data structure for the mmc_card and run the UHS - II specific
* initialization sequence .
*/
static int sd_uhs2_init_card(struct mmc_host *host, struct mmc_card *oldcard)
{
struct mmc_card *card;
u32 node_id = 0 ;
int err;
err = sd_uhs2_dev_init(host);
if (err)
return err;
err = sd_uhs2_enum(host, &node_id);
if (err)
return err;
if (oldcard) {
card = oldcard;
} else {
card = mmc_alloc_card(host, &sd_type);
if (IS_ERR(card))
return PTR_ERR(card);
}
card->uhs2_config.node_id = node_id;
card->type = MMC_TYPE_SD;
err = sd_uhs2_config_read(host, card);
if (err)
goto err;
err = sd_uhs2_config_write(host, card);
if (err)
goto err;
/* If change speed to Range B, need to GO_DORMANT_STATE */
if (host->ios.timing == MMC_TIMING_UHS2_SPEED_B ||
host->ios.timing == MMC_TIMING_UHS2_SPEED_B_HD) {
err = sd_uhs2_go_dormant_state(host, node_id);
if (err)
goto err;
}
host->uhs2_sd_tran = true ;
host->card = card;
return 0 ;
err:
if (!oldcard)
mmc_remove_card(card);
return err;
}
/*
* Initialize the UHS - II card through the SD - TRAN transport layer . This enables
* commands / requests to be backwards compatible through the legacy SD protocol .
* UHS - II cards has a specific power limit specified for VDD1 / VDD2 , that should
* be set through a legacy CMD6 . Note that , the power limit that becomes set ,
* survives a soft reset through the GO_DORMANT_STATE command .
*/
static int sd_uhs2_legacy_init(struct mmc_host *host, struct mmc_card *card,
bool reinit)
{
int err;
u32 cid[4 ];
u32 ocr;
u32 rocr;
u8 *status;
int ro;
/* Send CMD0 to reset SD card */
err = __mmc_go_idle(host);
if (err)
return err;
mmc_delay(1 );
/* Send CMD8 to communicate SD interface operation condition */
err = mmc_send_if_cond(host, host->ocr_avail);
if (err)
return err;
/*
* Probe SD card working voltage .
*/
err = mmc_send_app_op_cond(host, 0 , &ocr);
if (err)
return err;
card->ocr = ocr;
/*
* Some SD cards claims an out of spec VDD voltage range . Let ' s treat
* these bits as being in - valid and especially also bit7 .
*/
ocr &= ~0 x7FFF;
rocr = mmc_select_voltage(host, ocr);
/*
* Some cards have zero value of rocr in UHS - II mode . Assign host ' s
* ocr value to rocr .
*/
if (!rocr)
rocr = host->ocr_avail;
rocr |= (SD_OCR_CCS | SD_OCR_XPC);
/* Wait SD power on ready */
ocr = rocr;
err = mmc_send_app_op_cond(host, ocr, &rocr);
if (err)
return err;
err = mmc_send_cid(host, cid);
if (err)
return err;
if (reinit) {
if (memcmp(cid, card->raw_cid, sizeof (cid)) != 0 ) {
pr_debug("%s: Perhaps the card was replaced\n" ,
mmc_hostname(host));
return -ENOENT;
}
} else {
memcpy(card->raw_cid, cid, sizeof (card->raw_cid));
mmc_decode_cid(card);
}
/*
* For native busses : get card RCA and quit open drain mode .
*/
err = mmc_send_relative_addr(host, &card->rca);
if (err)
return err;
err = mmc_sd_get_csd(card, false );
if (err)
return err;
/*
* Select card , as all following commands rely on that .
*/
err = mmc_select_card(card);
if (err)
return err;
/*
* Fetch SCR from card .
*/
err = mmc_app_send_scr(card);
if (err)
return err;
err = mmc_decode_scr(card);
if (err)
return err;
/*
* Switch to high power consumption mode .
* Even switch failed , sd card can still work at lower power consumption mode , but
* performance will be lower than high power consumption mode .
*/
status = kmalloc(64 , GFP_KERNEL);
if (!status)
return -ENOMEM;
if (!(card->csd.cmdclass & CCC_SWITCH)) {
pr_warn("%s: card lacks mandatory switch function, performance might suffer\n" ,
mmc_hostname(card->host));
} else {
/*
* Send CMD6 to set Maximum Power Consumption to get better
* performance . Ignore errors and continue .
*/
err = mmc_sd_switch(card, 0 , 3 , SD4_SET_POWER_LIMIT_1_80W, status);
if (!err)
mmc_sd_switch(card, 1 , 3 , SD4_SET_POWER_LIMIT_1_80W, status);
}
/*
* Check if read - only switch is active .
*/
ro = mmc_sd_get_ro(host);
if (ro < 0 )
pr_warn("%s: host does not support read-only switch, assuming write-enable\n" ,
mmc_hostname(host));
else if (ro > 0 )
mmc_card_set_readonly(card);
kfree(status);
return 0 ;
}
static int sd_uhs2_reinit(struct mmc_host *host)
{
struct mmc_card *card = host->card;
int err;
err = sd_uhs2_power_up(host);
if (err)
return err;
err = sd_uhs2_phy_init(host);
if (err)
return err;
err = sd_uhs2_init_card(host, card);
if (err)
return err;
return sd_uhs2_legacy_init(host, card, true );
}
static void sd_uhs2_remove(struct mmc_host *host)
{
mmc_remove_card(host->card);
host->card = NULL;
}
static int sd_uhs2_alive(struct mmc_host *host)
{
return mmc_send_status(host->card, NULL);
}
static void sd_uhs2_detect(struct mmc_host *host)
{
int err;
mmc_get_card(host->card, NULL);
err = _mmc_detect_card_removed(host);
mmc_put_card(host->card, NULL);
if (err) {
sd_uhs2_remove(host);
mmc_claim_host(host);
mmc_detach_bus(host);
sd_uhs2_power_off(host);
mmc_release_host(host);
}
}
static int _sd_uhs2_suspend(struct mmc_host *host)
{
struct mmc_card *card = host->card;
mmc_claim_host(host);
if (mmc_card_suspended(card))
goto out;
sd_uhs2_power_off(host);
mmc_card_set_suspended(card);
out:
mmc_release_host(host);
return 0 ;
}
/*
* Callback for suspend
*/
static int sd_uhs2_suspend(struct mmc_host *host)
{
int err;
err = _sd_uhs2_suspend(host);
if (!err) {
pm_runtime_disable(&host->card->dev);
pm_runtime_set_suspended(&host->card->dev);
}
return err;
}
/*
* This function tries to determine if the same card is still present
* and , if so , restore all state to it .
*/
static int _mmc_sd_uhs2_resume(struct mmc_host *host)
{
int err = 0 ;
mmc_claim_host(host);
if (!mmc_card_suspended(host->card))
goto out;
/* Power up UHS2 SD card and re-initialize it. */
err = sd_uhs2_reinit(host);
mmc_card_clr_suspended(host->card);
out:
mmc_release_host(host);
return err;
}
/*
* Callback for resume
*/
static int sd_uhs2_resume(struct mmc_host *host)
{
pm_runtime_enable(&host->card->dev);
return 0 ;
}
/*
* Callback for runtime_suspend .
*/
static int sd_uhs2_runtime_suspend(struct mmc_host *host)
{
int err;
if (!(host->caps & MMC_CAP_AGGRESSIVE_PM))
return 0 ;
err = _sd_uhs2_suspend(host);
if (err)
pr_err("%s: error %d doing aggressive suspend\n" , mmc_hostname(host), err);
return err;
}
static int sd_uhs2_runtime_resume(struct mmc_host *host)
{
int err;
err = _mmc_sd_uhs2_resume(host);
if (err && err != -ENOMEDIUM)
pr_err("%s: error %d doing runtime resume\n" , mmc_hostname(host), err);
return err;
}
static int sd_uhs2_hw_reset(struct mmc_host *host)
{
sd_uhs2_power_off(host);
/* Wait at least 1 ms according to SD spec */
mmc_delay(1 );
return sd_uhs2_reinit(host);
}
static const struct mmc_bus_ops sd_uhs2_ops = {
.remove = sd_uhs2_remove,
.alive = sd_uhs2_alive,
.detect = sd_uhs2_detect,
.suspend = sd_uhs2_suspend,
.resume = sd_uhs2_resume,
.runtime_suspend = sd_uhs2_runtime_suspend,
.runtime_resume = sd_uhs2_runtime_resume,
.shutdown = sd_uhs2_suspend,
.hw_reset = sd_uhs2_hw_reset,
};
static int sd_uhs2_attach(struct mmc_host *host)
{
int err;
err = sd_uhs2_power_up(host);
if (err)
goto err;
err = sd_uhs2_phy_init(host);
if (err)
goto err;
err = sd_uhs2_init_card(host, NULL);
if (err)
goto err;
err = sd_uhs2_legacy_init(host, host->card, false );
if (err)
goto remove_card;
mmc_attach_bus(host, &sd_uhs2_ops);
mmc_release_host(host);
err = mmc_add_card(host->card);
if (err)
goto remove_card;
mmc_claim_host(host);
return 0 ;
remove_card:
sd_uhs2_remove(host);
mmc_claim_host(host);
err:
mmc_detach_bus(host);
sd_uhs2_power_off(host);
return err;
}
/**
* mmc_attach_sd_uhs2 - select UHS2 interface
* @ host : MMC host
*
* Try to select UHS2 interface and initialize the bus for a given
* frequency , @ freq .
*
* Return : 0 on success , non - zero error on failure
*/
int mmc_attach_sd_uhs2(struct mmc_host *host)
{
int i, err;
if (!(host->caps2 & MMC_CAP2_SD_UHS2))
return -EOPNOTSUPP;
/* Turn off the legacy SD interface before trying with UHS-II. */
mmc_power_off(host);
/*
* Start UHS - II initialization at 52 MHz and possibly make a retry at
* 26 MHz according to the spec . It ' s required that the host driver
* validates ios - > clock , to set a rate within the correct range .
*/
for (i = 0 ; i < ARRAY_SIZE(sd_uhs2_freqs); i++) {
host->f_init = sd_uhs2_freqs[i];
pr_debug("%s: %s: trying to init UHS-II card at %u Hz\n" ,
mmc_hostname(host), __func__, host->f_init);
err = sd_uhs2_attach(host);
if (!err)
break ;
}
return err;
}
/*
* mmc_uhs2_prepare_cmd - prepare for SD command packet
* @ host : MMC host
* @ mrq : MMC request
*
* Initialize and fill in a header and a payload of SD command packet .
* The caller should allocate uhs2_command in host - > cmd - > uhs2_cmd in
* advance .
*
* Return : 0 on success , non - zero error on failure
*/
void mmc_uhs2_prepare_cmd(struct mmc_host *host, struct mmc_request *mrq)
{
struct mmc_command *cmd;
struct uhs2_command *uhs2_cmd;
u8 plen;
cmd = mrq->cmd;
cmd->uhs2_cmd = &mrq->uhs2_cmd;
uhs2_cmd = cmd->uhs2_cmd;
uhs2_cmd->header = host->card->uhs2_config.node_id;
if ((cmd->flags & MMC_CMD_MASK) == MMC_CMD_ADTC)
uhs2_cmd->header |= UHS2_PACKET_TYPE_DCMD;
else
uhs2_cmd->header |= UHS2_PACKET_TYPE_CCMD;
uhs2_cmd->arg = cmd->opcode << UHS2_SD_CMD_INDEX_POS;
if (host->uhs2_app_cmd) {
uhs2_cmd->arg |= UHS2_SD_CMD_APP;
host->uhs2_app_cmd = false ;
}
/*
* UHS - II Addendum 7 . 2 . 1 . 2
* Host may set DM to 1 for DCMD which supports multi - block read / write regardless of
* data transfer length ( e . g . , CMD18 , CMD25 ) . Otherwise , it shall not set DM to 1 .
* ( e . g . , CMD6 , CMD17 , CMD24 ) . These rules are also applied to other multi - block read / write
* commands defined in other Part of SD specifications ( for example , Host may set DM to 1
* for ACMD18 or ACMD25 ) .
*/
if (mmc_op_multi(cmd->opcode))
cmd->uhs2_cmd->tmode_half_duplex = mmc_card_uhs2_hd_mode(host);
else
cmd->uhs2_cmd->tmode_half_duplex = 0 ;
uhs2_cmd = cmd->uhs2_cmd;
plen = 2 ; /* at the maximum */
if ((cmd->flags & MMC_CMD_MASK) == MMC_CMD_ADTC &&
cmd->uhs2_cmd->tmode_half_duplex) {
if (mmc_card_uhs2_hd_mode(host))
uhs2_cmd->arg |= UHS2_DCMD_2L_HD_MODE;
uhs2_cmd->arg |= UHS2_DCMD_LM_TLEN_EXIST;
if (cmd->data->blocks == 1 &&
cmd->data->blksz != 512 &&
cmd->opcode != MMC_READ_SINGLE_BLOCK &&
cmd->opcode != MMC_WRITE_BLOCK) {
uhs2_cmd->arg |= UHS2_DCMD_TLUM_BYTE_MODE;
uhs2_cmd->payload[1 ] = cpu_to_be32(cmd->data->blksz);
} else {
uhs2_cmd->payload[1 ] = cpu_to_be32(cmd->data->blocks);
}
} else {
plen = 1 ;
}
uhs2_cmd->payload[0 ] = cpu_to_be32(cmd->arg);
sd_uhs2_cmd_assemble(cmd, uhs2_cmd, plen, 0 );
}
Messung V0.5 in Prozent C=96 H=89 G=92
¤ Dauer der Verarbeitung: 0.22 Sekunden
(vorverarbeitet am 2026-09-27)
¤
*© Formatika GbR, Deutschland
2026-10-10
Neuigkeiten
Aktuelles
Motto des Tages
Open Source Software
Jenseits des Üblichen ....
Besucherstatistik
Statistik
#Sources=1126864
#Domains=1897691