Add support for enumerating MMC card in a given mode using mmc rescan and
mmc dev commands. The speed mode is provided as the last argument in these
commands and is indicated using the index from enum bus_mode in
include/mmc.h. A speed mode can be set only if it has already been enabled
in the device tree.

Signed-off-by: Aswath Govindraju <a-govindr...@ti.com>
---

Changes since v2:
- made init_mmc_device as wrapper function around __init_mmc_device
- rebased on top of latest master
- used dectoul() instead of simple_strtoul() whereever possible

Changes since v1:
- Removed #ifdef around the definition of user_speed_mode field
- Replaced #if with if (IS_ENABLED())
- Removed repeated MMC_CAP(MMC_LEGACY)
- initialized user_speed_mode to MMC_MODES_SPEED in mmc_init_device
  and mmc_dp_preinit
- corrected curr_device to dev and included part check, the case when
  mode is provided in the argument

 cmd/Kconfig              | 10 ++++++++
 cmd/mmc.c                | 52 +++++++++++++++++++++++++++++++++-------
 doc/usage/mmc.rst        | 49 +++++++++++++++++++++++++++++++++++--
 drivers/mmc/mmc-uclass.c |  5 +++-
 drivers/mmc/mmc.c        | 22 ++++++++++++++++-
 include/mmc.h            |  2 ++
 6 files changed, 128 insertions(+), 12 deletions(-)

diff --git a/cmd/Kconfig b/cmd/Kconfig
index ffef3cc76ca4..3a857b3f6e2e 100644
--- a/cmd/Kconfig
+++ b/cmd/Kconfig
@@ -2389,4 +2389,14 @@ config CMD_UBIFS
        help
          UBIFS is a file system for flash devices which works on top of UBI.
 
+config MMC_SPEED_MODE_SET
+       bool "set speed mode using mmc command"
+       depends on CMD_MMC
+       default n
+       help
+         Enable setting speed mode using mmc rescan and mmc dev commands.
+         The speed mode is provided as the last argument in these commands
+         and is indicated using the index from enum bus_mode in
+         include/mmc.h. A speed mode can be set only if it has already
+         been enabled in the device tree.
 endmenu
diff --git a/cmd/mmc.c b/cmd/mmc.c
index c67ad7624227..f1e30d0cf64b 100644
--- a/cmd/mmc.c
+++ b/cmd/mmc.c
@@ -120,7 +120,9 @@ static void print_mmcinfo(struct mmc *mmc)
                }
        }
 }
-static struct mmc *init_mmc_device(int dev, bool force_init)
+
+static struct mmc *__init_mmc_device(int dev, bool force_init,
+                                    enum bus_mode speed_mode)
 {
        struct mmc *mmc;
        mmc = find_mmc_device(dev);
@@ -134,6 +136,10 @@ static struct mmc *init_mmc_device(int dev, bool 
force_init)
 
        if (force_init)
                mmc->has_init = 0;
+
+       if (IS_ENABLED(CONFIG_MMC_SPEED_MODE_SET))
+               mmc->user_speed_mode = speed_mode;
+
        if (mmc_init(mmc))
                return NULL;
 
@@ -145,6 +151,11 @@ static struct mmc *init_mmc_device(int dev, bool 
force_init)
        return mmc;
 }
 
+static struct mmc *init_mmc_device(int dev, bool force_init)
+{
+       return __init_mmc_device(dev, force_init, MMC_MODES_END);
+}
+
 static int do_mmcinfo(struct cmd_tbl *cmdtp, int flag, int argc,
                      char *const argv[])
 {
@@ -482,8 +493,17 @@ static int do_mmc_rescan(struct cmd_tbl *cmdtp, int flag,
                         int argc, char *const argv[])
 {
        struct mmc *mmc;
+       enum bus_mode speed_mode = MMC_MODES_END;
+
+       if (argc == 1) {
+               mmc = init_mmc_device(curr_device, true);
+       } else if (argc == 2) {
+               speed_mode = (int)dectoul(argv[1], NULL);
+               mmc = __init_mmc_device(curr_device, true, speed_mode);
+       } else {
+               return CMD_RET_USAGE;
+       }
 
-       mmc = init_mmc_device(curr_device, true);
        if (!mmc)
                return CMD_RET_FAILURE;
 
@@ -515,11 +535,14 @@ static int do_mmc_dev(struct cmd_tbl *cmdtp, int flag,
 {
        int dev, part = 0, ret;
        struct mmc *mmc;
+       enum bus_mode speed_mode = MMC_MODES_END;
 
        if (argc == 1) {
                dev = curr_device;
+               mmc = init_mmc_device(dev, true);
        } else if (argc == 2) {
-               dev = dectoul(argv[1], NULL);
+               dev = (int)dectoul(argv[1], NULL);
+               mmc = init_mmc_device(dev, true);
        } else if (argc == 3) {
                dev = (int)dectoul(argv[1], NULL);
                part = (int)dectoul(argv[2], NULL);
@@ -528,11 +551,21 @@ static int do_mmc_dev(struct cmd_tbl *cmdtp, int flag,
                               PART_ACCESS_MASK);
                        return CMD_RET_FAILURE;
                }
+               mmc = init_mmc_device(dev, true);
+       } else if (argc == 4) {
+               dev = (int)dectoul(argv[1], NULL);
+               part = (int)dectoul(argv[2], NULL);
+               if (part > PART_ACCESS_MASK) {
+                       printf("#part_num shouldn't be larger than %d\n",
+                              PART_ACCESS_MASK);
+                       return CMD_RET_FAILURE;
+               }
+               speed_mode = (int)dectoul(argv[3], NULL);
+               mmc = __init_mmc_device(dev, true, speed_mode);
        } else {
                return CMD_RET_USAGE;
        }
 
-       mmc = init_mmc_device(dev, true);
        if (!mmc)
                return CMD_RET_FAILURE;
 
@@ -983,9 +1016,9 @@ static struct cmd_tbl cmd_mmc[] = {
 #if CONFIG_IS_ENABLED(CMD_MMC_SWRITE)
        U_BOOT_CMD_MKENT(swrite, 3, 0, do_mmc_sparse_write, "", ""),
 #endif
-       U_BOOT_CMD_MKENT(rescan, 1, 1, do_mmc_rescan, "", ""),
+       U_BOOT_CMD_MKENT(rescan, 2, 1, do_mmc_rescan, "", ""),
        U_BOOT_CMD_MKENT(part, 1, 1, do_mmc_part, "", ""),
-       U_BOOT_CMD_MKENT(dev, 3, 0, do_mmc_dev, "", ""),
+       U_BOOT_CMD_MKENT(dev, 4, 0, do_mmc_dev, "", ""),
        U_BOOT_CMD_MKENT(list, 1, 1, do_mmc_list, "", ""),
 #if CONFIG_IS_ENABLED(MMC_HW_PARTITIONING)
        U_BOOT_CMD_MKENT(hwpartition, 28, 0, do_mmc_hwpartition, "", ""),
@@ -1042,9 +1075,12 @@ U_BOOT_CMD(
        "mmc swrite addr blk#\n"
 #endif
        "mmc erase blk# cnt\n"
-       "mmc rescan\n"
+       "mmc rescan [mode]\n"
        "mmc part - lists available partition on current mmc device\n"
-       "mmc dev [dev] [part] - show or set current mmc device [partition]\n"
+       "mmc dev [dev] [part] [mode] - show or set current mmc device 
[partition] and set mode\n"
+       "  - the required speed mode is passed as the index from the following 
list\n"
+       "    [MMC_LEGACY, MMC_HS, SD_HS, MMC_HS_52, MMC_DDR_52, UHS_SDR12, 
UHS_SDR25,\n"
+       "    UHS_SDR50, UHS_DDR50, UHS_SDR104, MMC_HS_200, MMC_HS_400, 
MMC_HS_400_ES]\n"
        "mmc list - lists available devices\n"
        "mmc wp - power on write protect boot partitions\n"
 #if CONFIG_IS_ENABLED(MMC_HW_PARTITIONING)
diff --git a/doc/usage/mmc.rst b/doc/usage/mmc.rst
index f20efe3d7063..d15b151884fd 100644
--- a/doc/usage/mmc.rst
+++ b/doc/usage/mmc.rst
@@ -12,9 +12,9 @@ Synopsis
     mmc read addr blk# cnt
     mmc write addr blk# cnt
     mmc erase blk# cnt
-    mmc rescan
+    mmc rescan [mode]
     mmc part
-    mmc dev [dev] [part]
+    mmc dev [dev] [part] [mode]
     mmc list
     mmc wp
     mmc bootbus <dev> <boot_bus_width> <reset_boot_bus_width> <boot_mode>
@@ -49,6 +49,27 @@ The 'mmc erase' command erases *cnt* blocks on the MMC 
device starting at block
 
 The 'mmc rescan' command scans the available MMC device.
 
+   mode
+       speed mode to set.
+       CONFIG_MMC_SPEED_MODE_SET should be enabled. The required speed mode is
+       passed as the index from the following list.
+
+       0   - MMC_LEGACY
+       1   - MMC_HS
+       2   - SD_HS
+       3   - MMC_HS_52
+       4   - MMC_DDR_52
+       5   - UHS_SDR12
+       6   - UHS_SDR25
+       7   - UHS_SDR50
+       8   - UHS_DDR50
+       9   - UHS_SDR104
+       10  - MMC_HS_200
+       11  - MMC_HS_400
+       12  - MMC_HS_400_ES
+
+       A speed mode can be set only if it has already been enabled in the 
device tree
+
 The 'mmc part' command displays the list available partition on current mmc 
device.
 
 The 'mmc dev' command shows or set current mmc device.
@@ -58,6 +79,27 @@ The 'mmc dev' command shows or set current mmc device.
     part
         partition number to change
 
+   mode
+       speed mode to set.
+       CONFIG_MMC_SPEED_MODE_SET should be enabled. The required speed mode is
+       passed as the index from the following list.
+
+       0   - MMC_LEGACY
+       1   - MMC_HS
+       2   - SD_HS
+       3   - MMC_HS_52
+       4   - MMC_DDR_52
+       5   - UHS_SDR12
+       6   - UHS_SDR25
+       7   - UHS_SDR50
+       8   - UHS_DDR50
+       9   - UHS_SDR104
+       10  - MMC_HS_200
+       11  - MMC_HS_400
+       12  - MMC_HS_400_ES
+
+       A speed mode can be set only if it has already been enabled in the 
device tree
+
 The 'mmc list' command displays the list available devices.
 
 The 'mmc wp' command enables "power on write protect" function for boot 
partitions.
@@ -194,6 +236,9 @@ The current device can be shown or set via 'mmc dev' 
command:
     => mmc dev 2 0
     switch to partitions #0, OK
     mmc2 is current device
+    => mmc dev 0 1 4
+    switch to partitions #1, OK
+    mmc0(part 1) is current device
 
 The list of available devices can be shown via 'mmc list' command:
 ::
diff --git a/drivers/mmc/mmc-uclass.c b/drivers/mmc/mmc-uclass.c
index 0e13238c7e7a..3ee92d03ca23 100644
--- a/drivers/mmc/mmc-uclass.c
+++ b/drivers/mmc/mmc-uclass.c
@@ -342,6 +342,9 @@ void mmc_do_preinit(void)
 
                if (!m)
                        continue;
+
+               m->user_speed_mode = MMC_MODES_END;  /* Initialising user set 
speed mode */
+
                if (m->preinit)
                        mmc_start_init(m);
        }
@@ -414,7 +417,7 @@ int mmc_bind(struct udevice *dev, struct mmc *mmc, const 
struct mmc_config *cfg)
        /* setup initial part type */
        bdesc->part_type = cfg->part_type;
        mmc->dev = dev;
-
+       mmc->user_speed_mode = MMC_MODES_END;
        return 0;
 }
 
diff --git a/drivers/mmc/mmc.c b/drivers/mmc/mmc.c
index 8078a89f18cb..bd348974ae7d 100644
--- a/drivers/mmc/mmc.c
+++ b/drivers/mmc/mmc.c
@@ -2862,7 +2862,25 @@ int mmc_start_init(struct mmc *mmc)
         * timings.
         */
        mmc->host_caps = mmc->cfg->host_caps | MMC_CAP(MMC_LEGACY) |
-                        MMC_CAP(MMC_LEGACY) | MMC_MODE_1BIT;
+                        MMC_MODE_1BIT;
+
+       if (IS_ENABLED(CONFIG_MMC_SPEED_MODE_SET)) {
+               if (mmc->user_speed_mode != MMC_MODES_END) {
+                       int i;
+                       /* set host caps */
+                       if (mmc->host_caps & MMC_CAP(mmc->user_speed_mode)) {
+                               /* Remove all existing speed capabilities */
+                               for (i = MMC_LEGACY; i < MMC_MODES_END; i++)
+                                       mmc->host_caps &= ~MMC_CAP(i);
+                               mmc->host_caps |= (MMC_CAP(mmc->user_speed_mode)
+                                                  | MMC_CAP(MMC_LEGACY) |
+                                                  MMC_MODE_1BIT);
+                       } else {
+                               pr_err("bus_mode requested is not supported\n");
+                               return -EINVAL;
+                       }
+               }
+       }
 #if CONFIG_IS_ENABLED(DM_MMC)
        mmc_deferred_probe(mmc);
 #endif
@@ -3060,6 +3078,8 @@ int mmc_init_device(int num)
        }
 
        m = mmc_get_mmc_dev(dev);
+       m->user_speed_mode = MMC_MODES_END; /* Initialising user set speed mode 
*/
+
        if (!m)
                return 0;
        if (m->preinit)
diff --git a/include/mmc.h b/include/mmc.h
index 0bf19de20e52..b92e25534021 100644
--- a/include/mmc.h
+++ b/include/mmc.h
@@ -726,6 +726,8 @@ struct mmc {
                                  */
        u32 quirks;
        u8 hs400_tuning;
+
+       enum bus_mode user_speed_mode; /* input speed mode from user */
 };
 
 #if CONFIG_IS_ENABLED(DM_MMC)
-- 
2.17.1

Reply via email to