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

Aswath Govindraju a-govindraju at ti.com
Fri Aug 13 19:36:59 CEST 2021


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 at 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)
> 



More information about the U-Boot mailing list