mmc: core: Add definitions for SD UHS-II cards
authorVictor Shih <victor.shih@genesyslogic.com.tw>
Fri, 13 Sep 2024 10:28:19 +0000 (18:28 +0800)
committerUlf Hansson <ulf.hansson@linaro.org>
Mon, 14 Oct 2024 10:40:10 +0000 (12:40 +0200)
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 register I/O address and register field definitions: sd_uhs2.h

Signed-off-by: Jason Lai <jason.lai@genesyslogic.com.tw>
Signed-off-by: Victor Shih <victor.shih@genesyslogic.com.tw>
Link: https://lore.kernel.org/r/20240913102836.6144-6-victorshihgli@gmail.com
Signed-off-by: Ulf Hansson <ulf.hansson@linaro.org>
include/linux/mmc/card.h
include/linux/mmc/host.h
include/linux/mmc/sd_uhs2.h [new file with mode: 0644]

index 0bb1ad1ea4dc74dc60ce1598cdaa9851d10139ff..526fce581657542303ff9d11f64659ffd2650a49 100644 (file)
@@ -188,6 +188,12 @@ 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)
+
+#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
 };
 
 struct sd_ext_reg {
@@ -211,7 +217,30 @@ struct sd_ext_reg {
 
 struct sd_uhs2_config {
        u32                     node_id;
-       /* TODO: Extend with more register configs. */
+
+       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                      max_retry_set;
 };
 
 struct sdio_cccr {
index a7f790c75bc8545c72a144276b47274fda3dd161..0980d06ed419f91a0df7786491f24e05ef9516ea 100644 (file)
@@ -17,6 +17,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 */
@@ -100,7 +101,29 @@ 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      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;
 };
 
 enum sd_uhs2_operation {
diff --git a/include/linux/mmc/sd_uhs2.h b/include/linux/mmc/sd_uhs2.h
new file mode 100644 (file)
index 0000000..7abe9bd
--- /dev/null
@@ -0,0 +1,240 @@
+/* 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)
+
+#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
+
+#endif /* LINUX_MMC_UHS2_H */