Re: [PATCH V5 05/26] mmc: core: Add definitions for SD UHS-II cards

From: Ben Chuang
Date: Thu Nov 17 2022 - 01:19:58 EST

Next message: Zheng Yongjun: "[PATCH] ARM: mxs: fix memory leak in mxs_machine_init()"
Previous message: Xiaoyong Lu: "[RFC PATCH v6] media: mediatek: vcodec: support stateless AV1 decoder"
In reply to: Adrian Hunter: "Re: [PATCH V5 05/26] mmc: core: Add definitions for SD UHS-II cards"
Next in thread: Adrian Hunter: "Re: [PATCH V5 05/26] mmc: core: Add definitions for SD UHS-II cards"
Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]

Hi,

On Wed, Nov 16, 2022 at 9:48 PM Adrian Hunter <adrian.hunter@xxxxxxxxx> wrote:
>
> On 16/11/22 13:06, Victor Shih wrote:
> > Hi, Adrian
> >
> > On Wed, Nov 2, 2022 at 1:12 AM Adrian Hunter <adrian.hunter@xxxxxxxxx> wrote:
> >>
> >> On 19/10/22 14:06, Victor Shih wrote:
> >>> Add UHS-II specific data structures for commands and defines for
> >>> registers, as described in Part 1 UHS-II Addendum Version 1.01.
> >>>
> >>> UHS-II related definitions are listed below:
> >>> 1. UHS-II card capability: sd_uhs2_caps{}
> >>> 2. UHS-II configuration: sd_uhs2_config{}
> >>> 3. UHS-II Command structure: uhs2_command{}
> >>> 4. UHS-II register I/O address and register field definitions: sd_uhs2.h
> >>>
> >>> Signed-off-by: Ulf Hansson <ulf.hansson@xxxxxxxxxx>
> >>> Signed-off-by: Jason Lai <jason.lai@xxxxxxxxxxxxxxxxxxx>
> >>> Signed-off-by: Victor Shih <victor.shih@xxxxxxxxxxxxxxxxxxx>
> >>> ---
> >>>
> >>> Updates in V5:
> >>> - Added UHS2 interfaces in mmc_host_ops: host.h
> >>> - Added UHS2 VDD2 power supply in mmc_supply: host.h
> >>> - Added UHS2-specific OCR and UHS2 VDD2 max current in mmc_host: host.h
> >>> - Added definition of UHS2 VDD2 1.65v-1.95v in mmc_host: host.h
> >>> - Added flags/MMC_UHS2_SUPPORT/MMC_UHS2_2L_HD in mmc_host: host.h
> >>> ---
> >>> include/linux/mmc/card.h | 42 +++++-
> >>> include/linux/mmc/core.h | 13 ++
> >>> include/linux/mmc/host.h | 70 +++++++++-
> >>> include/linux/mmc/sd_uhs2.h | 263 ++++++++++++++++++++++++++++++++++++
> >>> 4 files changed, 386 insertions(+), 2 deletions(-)
> >>> create mode 100644 include/linux/mmc/sd_uhs2.h
> >>>
> >>> diff --git a/include/linux/mmc/card.h b/include/linux/mmc/card.h
> >>> index 4a42f31b7bb0..d638a2c689cf 100644
> >>> --- a/include/linux/mmc/card.h
> >>> +++ b/include/linux/mmc/card.h
> >>> @@ -190,6 +190,13 @@ struct sd_switch_caps {
> >>> #define SD_MAX_CURRENT_400 (1 << SD_SET_CURRENT_LIMIT_400)
> >>> #define SD_MAX_CURRENT_600 (1 << SD_SET_CURRENT_LIMIT_600)
> >>> #define SD_MAX_CURRENT_800 (1 << SD_SET_CURRENT_LIMIT_800)
> >>> + unsigned int sd4_curr_limit;
> >>> +#define SD4_SET_POWER_LIMIT_0_72W 0
> >>> +#define SD4_SET_POWER_LIMIT_1_44W 1
> >>> +#define SD4_SET_POWER_LIMIT_2_16W 2
> >>> +#define SD4_SET_POWER_LIMIT_2_88W 3
> >>> +#define SD4_SET_POWER_LIMIT_1_80W 4
> >>> +#define SD4_SET_POWER_NO_CHANGE (-1)
> >>> };
> >>>
> >>> struct sd_ext_reg {
> >>> @@ -213,7 +220,35 @@ struct sd_ext_reg {
> >>>
> >>> struct sd_uhs2_config {
> >>> u32 node_id;
> >>> - /* TODO: Extend with more register configs. */
> >>> +
> >>> + u32 dap;
> >>> + u32 gap;
> >>> + u32 n_fcu;
> >>> + u32 maxblk_len;
> >>> + u8 n_lanes;
> >>> + u8 dadr_len;
> >>> + u8 app_type;
> >>> + u8 phy_minor_rev;
> >>> + u8 phy_major_rev;
> >>> + u8 can_hibernate;
> >>> + u8 n_lss_sync;
> >>> + u8 n_lss_dir;
> >>> + u8 link_minor_rev;
> >>> + u8 link_major_rev;
> >>> + u8 dev_type;
> >>> + u8 n_data_gap;
> >>> +
> >>> + u32 n_fcu_set;
> >>> + u32 maxblk_len_set;
> >>> + u8 n_lanes_set;
> >>> + u8 speed_range_set;
> >>> + u8 n_lss_sync_set;
> >>> + u8 n_lss_dir_set;
> >>> + u8 n_data_gap_set;
> >>> + u8 pwrctrl_mode_set;
> >>> + u8 max_retry_set;
> >>> +
> >>> + u8 cfg_complete;
> >>> };
> >>>
> >>> struct sdio_cccr {
> >>> @@ -323,6 +358,9 @@ struct mmc_card {
> >>> struct sd_ext_reg ext_perf; /* SD extension reg for PERF */
> >>>
> >>> struct sd_uhs2_config uhs2_config; /* SD UHS-II config */
> >>> + u8 uhs2_state; /* SD UHS-II states */
> >>> +#define MMC_UHS2_INITIALIZED BIT(1)
> >>> +#define MMC_UHS2_SPEED_B BIT(2)
> >>>
> >>> unsigned int sdio_funcs; /* number of SDIO functions */
> >>> atomic_t sdio_funcs_probed; /* number of probed SDIO funcs */
> >>> @@ -364,4 +402,6 @@ bool mmc_card_is_blockaddr(struct mmc_card *card);
> >>> #define mmc_card_sdio(c) ((c)->type == MMC_TYPE_SDIO)
> >>> #define mmc_card_sd_combo(c) ((c)->type == MMC_TYPE_SD_COMBO)
> >>>
> >>> +#define mmc_card_can_poweroff_notify(c) ((c)->ext_power.feature_support & SD_EXT_POWER_OFF_NOTIFY)
> >>> +
> >>> #endif /* LINUX_MMC_CARD_H */
> >>> diff --git a/include/linux/mmc/core.h b/include/linux/mmc/core.h
> >>> index 6efec0b9820c..2a0581d87706 100644
> >>> --- a/include/linux/mmc/core.h
> >>> +++ b/include/linux/mmc/core.h
> >>> @@ -23,6 +23,14 @@ enum mmc_blk_status {
> >>> MMC_BLK_NEW_REQUEST,
> >>> };
> >>>
> >>> +struct uhs2_command {
> >>> + u16 header;
> >>> + u16 arg;
> >>> + __be32 *payload;
> >>> + u32 payload_len;
> >>> + u32 packet_len;
> >>> +};
> >>> +
> >>> struct mmc_command {
> >>> u32 opcode;
> >>> u32 arg;
> >>> @@ -109,6 +117,11 @@ struct mmc_command {
> >>> unsigned int busy_timeout; /* busy detect timeout in ms */
> >>> struct mmc_data *data; /* data segment associated with cmd */
> >>> struct mmc_request *mrq; /* associated request */
> >>> +
> >>> + struct uhs2_command *uhs2_cmd; /* UHS2 command */
> >>> + u8 *uhs2_resp; /* UHS2 native cmd resp */
> >>> + u8 uhs2_resp_len; /* UHS2 native cmd resp len */
> >>> + u8 uhs2_tmode0_flag; /* UHS2 transfer mode flag */
> >>> };
> >>>
> >>> struct mmc_data {
> >>> diff --git a/include/linux/mmc/host.h b/include/linux/mmc/host.h
> >>> index 895bcf7f80b7..249a9414ad10 100644
> >>> --- a/include/linux/mmc/host.h
> >>> +++ b/include/linux/mmc/host.h
> >>> @@ -16,6 +16,7 @@
> >>> #include <linux/mmc/pm.h>
> >>> #include <linux/dma-direction.h>
> >>> #include <linux/blk-crypto-profile.h>
> >>> +#include <linux/mmc/sd_uhs2.h>
> >>>
> >>> struct mmc_ios {
> >>> unsigned int clock; /* clock rate */
> >>> @@ -96,7 +97,48 @@ struct mmc_clk_phase_map {
> >>> };
> >>>
> >>> struct sd_uhs2_caps {
> >>> - /* TODO: Add UHS-II capabilities for the host. */
> >>> + u32 dap;
> >>> + u32 gap;
> >>> + u32 group_desc;
> >>> + u32 maxblk_len;
> >>> + u32 n_fcu;
> >>> + u8 n_lanes;
> >>> + u8 addr64;
> >>> + u8 card_type;
> >>> + u8 phy_rev;
> >>> + u8 speed_range;
> >>> + u8 can_hibernate;
> >>> + u8 n_lss_sync;
> >>> + u8 n_lss_dir;
> >>> + u8 link_rev;
> >>> + u8 host_type;
> >>> + u8 n_data_gap;
> >>> +
> >>> + u32 maxblk_len_set;
> >>> + u32 n_fcu_set;
> >>> + u8 n_lanes_set;
> >>> + u8 n_lss_sync_set;
> >>> + u8 n_lss_dir_set;
> >>> + u8 n_data_gap_set;
> >>> + u8 max_retry_set;
> >>> +};
> >>> +
> >>> +struct sd_uhs2_ios {
> >>> + bool is_2L_HD_mode;
> >>> + bool is_APP_CMD;
> >>> + unsigned int power_delay_ms; /* waiting for stable power */
> >>> +};
> >>> +
> >>> +enum sd_uhs2_operation {
> >>> + UHS2_PHY_INIT = 0,
> >>> + UHS2_SET_CONFIG,
> >>> + UHS2_ENABLE_INT,
> >>> + UHS2_DISABLE_INT,
> >>> + UHS2_ENABLE_CLK,
> >>> + UHS2_DISABLE_CLK,
> >>> + UHS2_CHECK_DORMANT,
> >>> + UHS2_SET_SPEED_B,
> >>> + UHS2_POST_ATTACH_SD,
> >>> };
> >>>
> >>> struct mmc_host;
> >>> @@ -231,6 +273,20 @@ struct mmc_host_ops {
> >>>
> >>> /* Initialize an SD express card, mandatory for MMC_CAP2_SD_EXP. */
> >>> int (*init_sd_express)(struct mmc_host *host, struct mmc_ios *ios);
> >>> +
> >>> + /* UHS2 interfaces */
> >>> + int (*uhs2_detect_init)(struct mmc_host *host);
> >>
> >> Never called?
> >
> > Yes, I will delete it.
> >
> >>
> >>> + int (*uhs2_set_reg)(struct mmc_host *host, enum sd_uhs2_operation act);
> >>
> >> Never called?
> >
> > Yes, I will delete it.
> >
> >>
> >>> + int (*uhs2_disable_clk)(struct mmc_host *host);
> >>
> >> Never called?
> >
> > Yes, I will delete it.
> >
> >>
> >>> + int (*uhs2_enable_clk)(struct mmc_host *host);
> >>
> >> Never called?
> >
> > Yes, I will delete it.
> >
> >>
> >>> +
> >>> + /*
> >>> + * The uhs2_control callback is used to execute SD UHS-II specific
> >>> + * operations. It's mandatory to implement for hosts that supports the
> >>> + * SD UHS-II interface (MMC_CAP2_SD_UHS2). Expected return values are a
> >>> + * negative errno in case of a failure or zero for success.
> >>> + */
> >>> + int (*uhs2_control)(struct mmc_host *host, enum sd_uhs2_operation op);
> >>> };
> >>>
> >>> struct mmc_cqe_ops {
> >>> @@ -323,6 +379,7 @@ struct mmc_pwrseq;
> >>>
> >>> struct mmc_supply {
> >>> struct regulator *vmmc; /* Card power supply */
> >>> + struct regulator *vmmc2; /* UHS2 VDD2 power supply */
> >>> struct regulator *vqmmc; /* Optional Vccq supply */
> >>> struct regulator *vqmmc2; /* Optional supply for phy */
> >>> };
> >>> @@ -344,10 +401,12 @@ struct mmc_host {
> >>> u32 ocr_avail_sdio; /* SDIO-specific OCR */
> >>> u32 ocr_avail_sd; /* SD-specific OCR */
> >>> u32 ocr_avail_mmc; /* MMC-specific OCR */
> >>> + u32 ocr_avail_uhs2; /* UHS2-specific OCR */
> >>> struct wakeup_source *ws; /* Enable consume of uevents */
> >>> u32 max_current_330;
> >>> u32 max_current_300;
> >>> u32 max_current_180;
> >>> + u32 max_current_180_vdd2; /* UHS2 vdd2 max curt. */
> >>>
> >>> #define MMC_VDD_165_195 0x00000080 /* VDD voltage 1.65 - 1.95 */
> >>> #define MMC_VDD_20_21 0x00000100 /* VDD voltage 2.0 ~ 2.1 */
> >>> @@ -366,6 +425,7 @@ struct mmc_host {
> >>> #define MMC_VDD_33_34 0x00200000 /* VDD voltage 3.3 ~ 3.4 */
> >>> #define MMC_VDD_34_35 0x00400000 /* VDD voltage 3.4 ~ 3.5 */
> >>> #define MMC_VDD_35_36 0x00800000 /* VDD voltage 3.5 ~ 3.6 */
> >>> +#define MMC_VDD2_165_195 0x00000080 /* UHS2 VDD2 1.65 ~ 1.95 */
> >>>
> >>> u32 caps; /* Host capabilities */
> >>>
> >>> @@ -443,7 +503,12 @@ struct mmc_host {
> >>> #endif
> >>> #define MMC_CAP2_ALT_GPT_TEGRA (1 << 28) /* Host with eMMC that has GPT entry at a non-standard location */
> >>>
> >>> + int flags;
> >>> +#define MMC_UHS2_SUPPORT (1 << 0)
> >>
> >> MMC_UHS2_SUPPORT is getting mixed up with MMC_UHS2_INITIALIZED.
> >> Both have the same value, but MMC_UHS2_SUPPORT is for
> >> host->flags and MMC_UHS2_INITIALIZED is for card->uhs2_state
> >>
> >> Please use the correct flag with the correct variable.
> >>
> >
> > The value of MMC_UHS2_SUPPORT is (1<<0) and the value of
> > MMC_UHS2_INITIALIZED is BIT(1).
> > Both have different values, therefore I'm not sure what you mean.
> > May you give me some more advice? Thanks.
>
> I guess I got confused about the values, however it is not OK to
> use MMC_UHS2_INITIALIZED for both mmc->flags and card->uhs2_state.
> Please make a separate define with a different name for mmc->flags
> version of MMC_UHS2_INITIALIZED.

MMC_UHS2_INITIALIZED here is used to judge that the UHS-II I/F has been
initialized and can run in SD-TRAN. In this state, some SD commands
require a distinction. For example, ACMD (CMD55) should be set by the APP
field in UHS-II packet.

>
> Also, I am confused about the purpose of mmc->flags and
> card->uhs2_state.

It looks like the mmc->flags and card->uhs2_state have the same purpose.
I think it is having trouble with card == NULL in mmc_app_cmd(*host, *card)
in patch [V5, 06/26] so just add one more mmc->flags.
Can wait for confirmation from Victor.

>
> A host is UHS-II capable as represented by MMC_CAP2_SD_UHS2.
> To initialize and use a UHS-II card in UHS-II mode, the host
> must be in UHS-II mode.
> To initialize and use a UHS-II card in SD mode, the host
> must be in SD mode.
> So the state of the card and host is always the same:
> either UHS-II or not. Note, that is a consequence of the
> hardware I/F. Whether SD I/F or UHS-II I/F is used is
> decided before sending any UHS-II commands. SD I/F is
> disabled during UHS-II PHY initialization, whereas
> UHS-II I/F is disabled before execution of ACMD41 is
> completed.
>
> So it seems like there would only be a need for one flag
> to indicate UHS-II mode?
>
> >
> >>> +#define MMC_UHS2_2L_HD (1 << 2)
> >>
> >> MMC_UHS2_2L_HD does not seem to be used. Is it needed?
> >
> > I confirmed this, I don't use it, I will delete it.
> >
> >>
> >>> +
> >>> struct sd_uhs2_caps uhs2_caps; /* Host UHS-II capabilities */
> >>> + struct sd_uhs2_ios uhs2_ios; /* Host UHS-II capabilities */
> >>>
> >>> int fixed_drv_type; /* fixed driver type for non-removable media */
> >>>
> >>> @@ -695,4 +760,7 @@ int mmc_send_tuning(struct mmc_host *host, u32 opcode, int *cmd_error);
> >>> int mmc_send_abort_tuning(struct mmc_host *host, u32 opcode);
> >>> int mmc_get_ext_csd(struct mmc_card *card, u8 **new_ext_csd);
> >>>
> >>> +#define mmc_uhs2_2L_HD_mode(h) ((h)->uhs2_ios.is_2L_HD_mode)
> >>> +#define mmc_uhs2_APP_cmd(h) ((h)->uhs2_ios.is_APP_CMD)
> >>> +
> >>> #endif /* LINUX_MMC_HOST_H */
> >>> diff --git a/include/linux/mmc/sd_uhs2.h b/include/linux/mmc/sd_uhs2.h
> >>> new file mode 100644
> >>> index 000000000000..8fcf702cf4a5
> >>> --- /dev/null
> >>> +++ b/include/linux/mmc/sd_uhs2.h
> >>> @@ -0,0 +1,263 @@
> >>> +/* SPDX-License-Identifier: GPL-2.0-or-later */
> >>> +/*
> >>> + * Header file for UHS-II packets, Host Controller registers and I/O
> >>> + * accessors.
> >>> + *
> >>> + * Copyright (C) 2014 Intel Corp, All Rights Reserved.
> >>> + */
> >>> +#ifndef LINUX_MMC_UHS2_H
> >>> +#define LINUX_MMC_UHS2_H
> >>> +
> >>> +/* LINK Layer definition */
> >>> +/*
> >>> + * UHS2 Header:
> >>> + * Refer to UHS-II Addendum Version 1.02 Figure 5-2, the format of CCMD Header is described below:
> >>> + * bit [3:0] : DID(Destination ID = Node ID of UHS2 card)
> >>> + * bit [6:4] : TYP(Packet Type)
> >>> + * 000b: CCMD(Control command packet)
> >>> + * 001b: DCMD(Data command packet)
> >>> + * 010b: RES(Response packet)
> >>> + * 011b: DATA(Data payload packet)
> >>> + * 111b: MSG(Message packet)
> >>> + * Others: Reserved
> >>> + * bit [7] : NP(Native Packet)
> >>> + * bit [10:8] : TID(Transaction ID)
> >>> + * bit [11] : Reserved
> >>> + * bit [15:12]: SID(Source ID 0: Node ID of Host)
> >>> + *
> >>> + * Broadcast CCMD issued by Host is represented as DID=SID=0.
> >>> + */
> >>> +/*
> >>> + * UHS2 Argument:
> >>> + * Refer to UHS-II Addendum Version 1.02 Figure 6-5, the format of CCMD Argument is described below:
> >>> + * bit [3:0] : MSB of IOADR
> >>> + * bit [5:4] : PLEN(Payload Length)
> >>> + * 00b: 0 byte
> >>> + * 01b: 4 bytes
> >>> + * 10b: 8 bytes
> >>> + * 11b: 16 bytes
> >>> + * bit [6] : Reserved
> >>> + * bit [7] : R/W(Read/Write)
> >>> + * 0: Control read command
> >>> + * 1: Control write command
> >>> + * bit [15:8] : LSB of IOADR
> >>> + *
> >>> + * I/O Address specifies the address of register in UHS-II I/O space accessed by CCMD.
> >>> + * The unit of I/O Address is 4 Bytes. It is transmitted in MSB first, LSB last.
> >>> + */
> >>> +#define UHS2_NATIVE_PACKET_POS 7
> >>> +#define UHS2_NATIVE_PACKET (1 << UHS2_NATIVE_PACKET_POS)
> >>> +
> >>> +#define UHS2_PACKET_TYPE_POS 4
> >>> +#define UHS2_PACKET_TYPE_CCMD (0 << UHS2_PACKET_TYPE_POS)
> >>> +#define UHS2_PACKET_TYPE_DCMD (1 << UHS2_PACKET_TYPE_POS)
> >>> +#define UHS2_PACKET_TYPE_RES (2 << UHS2_PACKET_TYPE_POS)
> >>> +#define UHS2_PACKET_TYPE_DATA (3 << UHS2_PACKET_TYPE_POS)
> >>> +#define UHS2_PACKET_TYPE_MSG (7 << UHS2_PACKET_TYPE_POS)
> >>> +
> >>> +#define UHS2_DEST_ID_MASK 0x0F
> >>> +#define UHS2_DEST_ID 0x1
> >>> +
> >>> +#define UHS2_SRC_ID_POS 12
> >>> +#define UHS2_SRC_ID_MASK 0xF000
> >>> +
> >>> +#define UHS2_TRANS_ID_POS 8
> >>> +#define UHS2_TRANS_ID_MASK 0x0700
> >>> +
> >>> +/* UHS2 MSG */
> >>> +#define UHS2_MSG_CTG_POS 5
> >>> +#define UHS2_MSG_CTG_LMSG 0x00
> >>> +#define UHS2_MSG_CTG_INT 0x60
> >>> +#define UHS2_MSG_CTG_AMSG 0x80
> >>> +
> >>> +#define UHS2_MSG_CTG_FCREQ 0x00
> >>> +#define UHS2_MSG_CTG_FCRDY 0x01
> >>> +#define UHS2_MSG_CTG_STAT 0x02
> >>> +
> >>> +#define UHS2_MSG_CODE_POS 8
> >>> +#define UHS2_MSG_CODE_FC_UNRECOVER_ERR 0x8
> >>> +#define UHS2_MSG_CODE_STAT_UNRECOVER_ERR 0x8
> >>> +#define UHS2_MSG_CODE_STAT_RECOVER_ERR 0x1
> >>> +
> >>> +/* TRANS Layer definition */
> >>> +
> >>> +/* Native packets*/
> >>> +#define UHS2_NATIVE_CMD_RW_POS 7
> >>> +#define UHS2_NATIVE_CMD_WRITE (1 << UHS2_NATIVE_CMD_RW_POS)
> >>> +#define UHS2_NATIVE_CMD_READ (0 << UHS2_NATIVE_CMD_RW_POS)
> >>> +
> >>> +#define UHS2_NATIVE_CMD_PLEN_POS 4
> >>> +#define UHS2_NATIVE_CMD_PLEN_4B (1 << UHS2_NATIVE_CMD_PLEN_POS)
> >>> +#define UHS2_NATIVE_CMD_PLEN_8B (2 << UHS2_NATIVE_CMD_PLEN_POS)
> >>> +#define UHS2_NATIVE_CMD_PLEN_16B (3 << UHS2_NATIVE_CMD_PLEN_POS)
> >>> +
> >>> +#define UHS2_NATIVE_CCMD_GET_MIOADR_MASK 0xF00
> >>> +#define UHS2_NATIVE_CCMD_MIOADR_MASK 0x0F
> >>> +
> >>> +#define UHS2_NATIVE_CCMD_LIOADR_POS 8
> >>> +#define UHS2_NATIVE_CCMD_GET_LIOADR_MASK 0x0FF
> >>> +
> >>> +#define UHS2_CCMD_DEV_INIT_COMPLETE_FLAG BIT(11)
> >>> +#define UHS2_DEV_INIT_PAYLOAD_LEN 1
> >>> +#define UHS2_DEV_INIT_RESP_LEN 6
> >>> +#define UHS2_DEV_ENUM_PAYLOAD_LEN 1
> >>> +#define UHS2_DEV_ENUM_RESP_LEN 8
> >>> +#define UHS2_CFG_WRITE_PAYLOAD_LEN 2
> >>> +#define UHS2_CFG_WRITE_PHY_SET_RESP_LEN 4
> >>> +#define UHS2_CFG_WRITE_GENERIC_SET_RESP_LEN 5
> >>> +#define UHS2_GO_DORMANT_PAYLOAD_LEN 1
> >>> +
> >>> +/*
> >>> + * UHS2 Argument:
> >>> + * Refer to UHS-II Addendum Version 1.02 Figure 6-8, the format of DCMD Argument is described below:
> >>> + * bit [3:0] : Reserved
> >>> + * bit [6:3] : TMODE(Transfer Mode)
> >>> + * bit 3: DAM(Data Access Mode)
> >>> + * bit 4: TLUM(TLEN Unit Mode)
> >>> + * bit 5: LM(Length Mode)
> >>> + * bit 6: DM(Duplex Mode)
> >>> + * bit [7] : R/W(Read/Write)
> >>> + * 0: Control read command
> >>> + * 1: Control write command
> >>> + * bit [15:8] : Reserved
> >>> + *
> >>> + * I/O Address specifies the address of register in UHS-II I/O space accessed by CCMD.
> >>> + * The unit of I/O Address is 4 Bytes. It is transmitted in MSB first, LSB last.
> >>> + */
> >>> +#define UHS2_DCMD_DM_POS 6
> >>> +#define UHS2_DCMD_2L_HD_MODE (1 << UHS2_DCMD_DM_POS)
> >>> +#define UHS2_DCMD_LM_POS 5
> >>> +#define UHS2_DCMD_LM_TLEN_EXIST (1 << UHS2_DCMD_LM_POS)
> >>> +#define UHS2_DCMD_TLUM_POS 4
> >>> +#define UHS2_DCMD_TLUM_BYTE_MODE (1 << UHS2_DCMD_TLUM_POS)
> >>> +#define UHS2_NATIVE_DCMD_DAM_POS 3
> >>> +#define UHS2_NATIVE_DCMD_DAM_IO (1 << UHS2_NATIVE_DCMD_DAM_POS)
> >>> +
> >>> +/*
> >>> + * Per UHS2 spec, DCMD payload should be MSB first. There may be
> >>> + * two types of data be assembled to MSB:
> >>> + * 1. TLEN: Input block size for single read/write and number of blocks
> >>> + * for multiple read/write to calculate TLEN as MSB first per spec.
> >>> + * 2. SD command argument.
> >>> + */
> >>> +static inline __be32 uhs2_dcmd_convert_msb(u32 input)
> >>> +{
> >>> + u32 ret = 0;
> >>> +
> >>> + ret = ((input & 0xFF) << 24) |
> >>> + (((input >> 8) & 0xFF) << 16) |
> >>> + (((input >> 16) & 0xFF) << 8) |
> >>> + ((input >> 24) & 0xFF);
> >>> + return cpu_to_be32(ret);
> >>> +}
> >>> +
> >>> +#define UHS2_RES_NACK_POS 7
> >>> +#define UHS2_RES_NACK_MASK (0x1 << UHS2_RES_NACK_POS)
> >>> +
> >>> +#define UHS2_RES_ECODE_POS 4
> >>> +#define UHS2_RES_ECODE_MASK 0x7
> >>> +#define UHS2_RES_ECODE_COND 1
> >>> +#define UHS2_RES_ECODE_ARG 2
> >>> +#define UHS2_RES_ECODE_GEN 3
> >>> +
> >>> +/* IOADR of device registers */
> >>> +#define UHS2_IOADR_GENERIC_CAPS 0x00
> >>> +#define UHS2_IOADR_PHY_CAPS 0x02
> >>> +#define UHS2_IOADR_LINK_CAPS 0x04
> >>> +#define UHS2_IOADR_RSV_CAPS 0x06
> >>> +#define UHS2_IOADR_GENERIC_SETTINGS 0x08
> >>> +#define UHS2_IOADR_PHY_SETTINGS 0x0A
> >>> +#define UHS2_IOADR_LINK_SETTINGS 0x0C
> >>> +#define UHS2_IOADR_PRESET 0x40
> >>> +
> >>> +/* SD application packets */
> >>> +#define UHS2_SD_CMD_INDEX_POS 8
> >>> +
> >>> +#define UHS2_SD_CMD_APP_POS 14
> >>> +#define UHS2_SD_CMD_APP (1 << UHS2_SD_CMD_APP_POS)
> >>> +
> >>> +/* UHS-II Device Registers */
> >>> +#define UHS2_DEV_CONFIG_REG 0x000
> >>> +
> >>> +/* General Caps and Settings registers */
> >>> +#define UHS2_DEV_CONFIG_GEN_CAPS (UHS2_DEV_CONFIG_REG + 0x000)
> >>> +#define UHS2_DEV_CONFIG_N_LANES_POS 8
> >>> +#define UHS2_DEV_CONFIG_N_LANES_MASK 0x3F
> >>> +#define UHS2_DEV_CONFIG_2L_HD_FD 0x1
> >>> +#define UHS2_DEV_CONFIG_2D1U_FD 0x2
> >>> +#define UHS2_DEV_CONFIG_1D2U_FD 0x4
> >>> +#define UHS2_DEV_CONFIG_2D2U_FD 0x8
> >>> +#define UHS2_DEV_CONFIG_DADR_POS 14
> >>> +#define UHS2_DEV_CONFIG_DADR_MASK 0x1
> >>> +#define UHS2_DEV_CONFIG_APP_POS 16
> >>> +#define UHS2_DEV_CONFIG_APP_MASK 0xFF
> >>> +#define UHS2_DEV_CONFIG_APP_SD_MEM 0x1
> >>> +
> >>> +#define UHS2_DEV_CONFIG_GEN_SET (UHS2_DEV_CONFIG_REG + 0x008)
> >>> +#define UHS2_DEV_CONFIG_GEN_SET_N_LANES_POS 8
> >>> +#define UHS2_DEV_CONFIG_GEN_SET_2L_FD_HD 0x0
> >>> +#define UHS2_DEV_CONFIG_GEN_SET_2D1U_FD 0x2
> >>> +#define UHS2_DEV_CONFIG_GEN_SET_1D2U_FD 0x3
> >>> +#define UHS2_DEV_CONFIG_GEN_SET_2D2U_FD 0x4
> >>> +#define UHS2_DEV_CONFIG_GEN_SET_CFG_COMPLETE BIT(31)
> >>> +
> >>> +/* PHY Caps and Settings registers */
> >>> +#define UHS2_DEV_CONFIG_PHY_CAPS (UHS2_DEV_CONFIG_REG + 0x002)
> >>> +#define UHS2_DEV_CONFIG_PHY_MINOR_MASK 0xF
> >>> +#define UHS2_DEV_CONFIG_PHY_MAJOR_POS 4
> >>> +#define UHS2_DEV_CONFIG_PHY_MAJOR_MASK 0x3
> >>> +#define UHS2_DEV_CONFIG_CAN_HIBER_POS 15
> >>> +#define UHS2_DEV_CONFIG_CAN_HIBER_MASK 0x1
> >>> +#define UHS2_DEV_CONFIG_PHY_CAPS1 (UHS2_DEV_CONFIG_REG + 0x003)
> >>> +#define UHS2_DEV_CONFIG_N_LSS_SYN_MASK 0xF
> >>> +#define UHS2_DEV_CONFIG_N_LSS_DIR_POS 4
> >>> +#define UHS2_DEV_CONFIG_N_LSS_DIR_MASK 0xF
> >>> +
> >>> +#define UHS2_DEV_CONFIG_PHY_SET (UHS2_DEV_CONFIG_REG + 0x00A)
> >>> +#define UHS2_DEV_CONFIG_PHY_SET_SPEED_POS 6
> >>> +#define UHS2_DEV_CONFIG_PHY_SET_SPEED_A 0x0
> >>> +#define UHS2_DEV_CONFIG_PHY_SET_SPEED_B 0x1
> >>> +
> >>> +/* LINK-TRAN Caps and Settings registers */
> >>> +#define UHS2_DEV_CONFIG_LINK_TRAN_CAPS (UHS2_DEV_CONFIG_REG + 0x004)
> >>> +#define UHS2_DEV_CONFIG_LT_MINOR_MASK 0xF
> >>> +#define UHS2_DEV_CONFIG_LT_MAJOR_POS 4
> >>> +#define UHS2_DEV_CONFIG_LT_MAJOR_MASK 0x3
> >>> +#define UHS2_DEV_CONFIG_N_FCU_POS 8
> >>> +#define UHS2_DEV_CONFIG_N_FCU_MASK 0xFF
> >>> +#define UHS2_DEV_CONFIG_DEV_TYPE_POS 16
> >>> +#define UHS2_DEV_CONFIG_DEV_TYPE_MASK 0x7
> >>> +#define UHS2_DEV_CONFIG_MAX_BLK_LEN_POS 20
> >>> +#define UHS2_DEV_CONFIG_MAX_BLK_LEN_MASK 0xFFF
> >>> +#define UHS2_DEV_CONFIG_LINK_TRAN_CAPS1 (UHS2_DEV_CONFIG_REG + 0x005)
> >>> +#define UHS2_DEV_CONFIG_N_DATA_GAP_MASK 0xFF
> >>> +
> >>> +#define UHS2_DEV_CONFIG_LINK_TRAN_SET (UHS2_DEV_CONFIG_REG + 0x00C)
> >>> +#define UHS2_DEV_CONFIG_LT_SET_MAX_BLK_LEN 0x200
> >>> +#define UHS2_DEV_CONFIG_LT_SET_MAX_RETRY_POS 16
> >>> +
> >>> +/* Preset register */
> >>> +#define UHS2_DEV_CONFIG_PRESET (UHS2_DEV_CONFIG_REG + 0x040)
> >>> +
> >>> +#define UHS2_DEV_INT_REG 0x100
> >>> +
> >>> +#define UHS2_DEV_STATUS_REG 0x180
> >>> +
> >>> +#define UHS2_DEV_CMD_REG 0x200
> >>> +#define UHS2_DEV_CMD_FULL_RESET (UHS2_DEV_CMD_REG + 0x000)
> >>> +#define UHS2_DEV_CMD_GO_DORMANT_STATE (UHS2_DEV_CMD_REG + 0x001)
> >>> +#define UHS2_DEV_CMD_DORMANT_HIBER BIT(7)
> >>> +#define UHS2_DEV_CMD_DEVICE_INIT (UHS2_DEV_CMD_REG + 0x002)
> >>> +#define UHS2_DEV_INIT_COMPLETE_FLAG BIT(11)
> >>> +#define UHS2_DEV_CMD_ENUMERATE (UHS2_DEV_CMD_REG + 0x003)
> >>> +#define UHS2_DEV_CMD_TRANS_ABORT (UHS2_DEV_CMD_REG + 0x004)
> >>> +
> >>> +#define UHS2_RCLK_MAX 52000000
> >>> +#define UHS2_RCLK_MIN 26000000
> >>> +
> >>> +struct sd_uhs2_wait_active_state_data {
> >>> + struct mmc_host *host;
> >>> + struct mmc_command *cmd;
> >>> +};
> >>> +
> >>> +#endif /* LINUX_MMC_UHS2_H */
> >>
> >
> > Thanks, Victor Shih
>

Best regards,
Ben Chuang

Next message: Zheng Yongjun: "[PATCH] ARM: mxs: fix memory leak in mxs_machine_init()"
Previous message: Xiaoyong Lu: "[RFC PATCH v6] media: mediatek: vcodec: support stateless AV1 decoder"
In reply to: Adrian Hunter: "Re: [PATCH V5 05/26] mmc: core: Add definitions for SD UHS-II cards"
Next in thread: Adrian Hunter: "Re: [PATCH V5 05/26] mmc: core: Add definitions for SD UHS-II cards"
Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]