Re: [PATCH v3] mmc: Add support for enumerating MMC card in a given mode using mmc command

Hi all,

On 04/08/21 8:08 pm, Aswath Govindraju wrote:

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-govindraju@ti.com

Posted respin(v4) for this patch seperating the documentation changes.

Thanks, Aswath

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)