[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <BL0PR04MB65642CD12B5CFBCBB14CF602FC399@BL0PR04MB6564.namprd04.prod.outlook.com>
Date: Wed, 2 Nov 2022 07:46:08 +0000
From: Avri Altman <Avri.Altman@....com>
To: Jiaming Li <lijiaming3@...omi.corp-partner.google.com>,
"alim.akhtar@...sung.com" <alim.akhtar@...sung.com>,
"bvanassche@....org" <bvanassche@....org>
CC: "linux-scsi@...r.kernel.org" <linux-scsi@...r.kernel.org>,
"linux-kernel@...r.kernel.org" <linux-kernel@...r.kernel.org>,
lijiaming3 <lijiaming3@...omi.com>
Subject: RE: [RESEND PATCH 2/4] scsi:ufs:add File-Based Optimization
descriptor
> From: lijiaming3 <lijiaming3@...omi.com>
>
> The full information about the descriptor could be found at UFS
> specifications - FBO extension.
>
> Signed-off-by: lijiaming3 <lijiaming3@...omi.com>
For some reason there are spaces missing in the patch header: scsi: ufs: Add....
Other than that:
Reviewed-by: Avri Altman <avri.altman@....com>
> ---
> Documentation/ABI/testing/sysfs-driver-ufs | 65 ++++++++++++++++++++++
> drivers/ufs/core/ufs-sysfs.c | 26 +++++++++
> include/ufs/ufs.h | 13 +++++
> 3 files changed, 104 insertions(+)
>
> diff --git a/Documentation/ABI/testing/sysfs-driver-ufs
> b/Documentation/ABI/testing/sysfs-driver-ufs
> index 228aa43e14ed..63daccbf7a8d 100644
> --- a/Documentation/ABI/testing/sysfs-driver-ufs
> +++ b/Documentation/ABI/testing/sysfs-driver-ufs
> @@ -1710,3 +1710,68 @@ Contact: Avri Altman <avri.altman@....com>
> Description: In host control mode the host is the originator of map
> requests.
> To avoid flooding the device with map requests, use a simple
> throttling
> mechanism that limits the number of inflight map requests.
> +
> +What:
> /sys/bus/platform/drivers/ufshcd/*/fbo_descriptor/fbo_version
> +What: /sys/bus/platform/devices/*.ufs/fbo_descriptor/fbo_version
> +Date: November 2022
> +Contact: li jiaming <lijiaming3@...omi.com>
> +Description: This file shows the version of UFS file-based optimization. This
> + is one of the UFS fbo descriptor parameters. The full information
> about
> + the descriptor could be found at UFS specifications - FBO extension.
> +
> + The file is read only.
> +
> +What: /sys/bus/platform/drivers/ufshcd/*/fbo_descriptor/fbo_rec_lrs
> +What: /sys/bus/platform/devices/*.ufs/fbo_descriptor/fbo_rec_lrs
> +Date: November 2022
> +Contact: li jiaming <lijiaming3@...omi.com>
> +Description: This file shows the recommended LBA range size of UFS file-
> based
> + optimization to be used by the host. This is one of the UFS fbo
> descriptor
> + parameters. The full information about the descriptor could be
> found at UFS
> + specifications - FBO extension.
> +
> + The file is read only.
> +
> +What:
> /sys/bus/platform/drivers/ufshcd/*/fbo_descriptor/fbo_max_lrs
> +What: /sys/bus/platform/devices/*.ufs/fbo_descriptor/fbo_max_lrs
> +Date: November 2022
> +Contact: li jiaming <lijiaming3@...omi.com>
> +Description: This file shows the max LBA range size of UFS file-based
> + optimization to be used by the host. This is one of the UFS fbo
> descriptor
> + parameters. The full information about the descriptor could be
> found at UFS
> + specifications - FBO extension.
> +
> + The file is read only.
> +
> +What:
> /sys/bus/platform/drivers/ufshcd/*/fbo_descriptor/fbo_min_lrs
> +What: /sys/bus/platform/devices/*.ufs/fbo_descriptor/fbo_min_lrs
> +Date: November 2022
> +Contact: li jiaming <lijiaming3@...omi.com>
> +Description: This file shows the min LBA range size of UFS file-based
> + optimization to be used by the host. This is one of the UFS fbo
> descriptor
> + parameters. The full information about the descriptor could be
> found at UFS
> + specifications - FBO extension.
> +
> + The file is read only.
> +
> +What:
> /sys/bus/platform/drivers/ufshcd/*/fbo_descriptor/fbo_max_lrc
> +What: /sys/bus/platform/devices/*.ufs/fbo_descriptor/fbo_max_lrc
> +Date: November 2022
> +Contact: li jiaming <lijiaming3@...omi.com>
> +Description: This file shows the max number of LBA ranges supported by
> read/write
> + buffer command of UFS file-based optimization. This is one of the
> UFS fbo
> + descriptor parameters. The full information about the descriptor
> could be
> + found at UFS specifications - FBO extension.
> +
> + The file is read only.
> +
> +What: /sys/bus/platform/drivers/ufshcd/*/fbo_descriptor/fbo_lra
> +What: /sys/bus/platform/devices/*.ufs/fbo_descriptor/fbo_lra
> +Date: November 2022
> +Contact: li jiaming <lijiaming3@...omi.com>
> +Description: This file shows the alignment requirement of UFS file-based
> + optimization. This is one of the UFS fbo descriptor parameters. The
> + full information about the descriptor could be found at UFS
> + specifications - FBO extension.
> +
> + The file is read only.
> diff --git a/drivers/ufs/core/ufs-sysfs.c b/drivers/ufs/core/ufs-sysfs.c index
> 53aea56d1de1..006d99b15be0 100644
> --- a/drivers/ufs/core/ufs-sysfs.c
> +++ b/drivers/ufs/core/ufs-sysfs.c
> @@ -871,6 +871,31 @@ static const struct attribute_group
> ufs_sysfs_health_descriptor_group = {
> .attrs = ufs_sysfs_health_descriptor, };
>
> +#define UFS_FBO_DESC_PARAM(_name, _uname, _size) \
> + UFS_DESC_PARAM(_name, _uname, FBO, _size)
> +
> +UFS_FBO_DESC_PARAM(fbo_version, _VERSION, 2);
> +UFS_FBO_DESC_PARAM(fbo_rec_lrs, _REC_LBA_RANGE_SIZE, 4);
> +UFS_FBO_DESC_PARAM(fbo_max_lrs, _MAX_LBA_RANGE_SIZE, 4);
> +UFS_FBO_DESC_PARAM(fbo_min_lrs, _MIN_LBA_RANGE_SIZE, 4);
> +UFS_FBO_DESC_PARAM(fbo_max_lrc, _MAX_LBA_RANGE_CONUT, 1);
> +UFS_FBO_DESC_PARAM(fbo_lra, _MAX_LBA_RANGE_ALIGNMENT, 2);
> +
> +static struct attribute *ufs_sysfs_fbo_descriptor[] = {
> + &dev_attr_fbo_version.attr,
> + &dev_attr_fbo_rec_lrs.attr,
> + &dev_attr_fbo_max_lrs.attr,
> + &dev_attr_fbo_min_lrs.attr,
> + &dev_attr_fbo_max_lrc.attr,
> + &dev_attr_fbo_lra.attr,
> + NULL,
> +};
> +
> +static const struct attribute_group ufs_sysfs_fbo_descriptor_group = {
> + .name = "fbo_descriptor",
> + .attrs = ufs_sysfs_fbo_descriptor, };
> +
> #define UFS_POWER_DESC_PARAM(_name, _uname, _index) \
> static ssize_t _name##_index##_show(struct device *dev, \
> struct device_attribute *attr, char *buf) \
> @@ -1220,6 +1245,7 @@ static const struct attribute_group
> *ufs_sysfs_groups[] = {
> &ufs_sysfs_interconnect_descriptor_group,
> &ufs_sysfs_geometry_descriptor_group,
> &ufs_sysfs_health_descriptor_group,
> + &ufs_sysfs_fbo_descriptor_group,
> &ufs_sysfs_power_descriptor_group,
> &ufs_sysfs_string_descriptors_group,
> &ufs_sysfs_flags_group,
> diff --git a/include/ufs/ufs.h b/include/ufs/ufs.h index
> 1bba3fead2ce..c3fd954ce005 100644
> --- a/include/ufs/ufs.h
> +++ b/include/ufs/ufs.h
> @@ -179,6 +179,7 @@ enum desc_idn {
> QUERY_DESC_IDN_GEOMETRY = 0x7,
> QUERY_DESC_IDN_POWER = 0x8,
> QUERY_DESC_IDN_HEALTH = 0x9,
> + QUERY_DESC_IDN_FBO = 0xA,
> QUERY_DESC_IDN_MAX,
> };
>
> @@ -319,6 +320,17 @@ enum health_desc_param {
> HEALTH_DESC_PARAM_LIFE_TIME_EST_B = 0x4,
> };
>
> +/* File-based Optimization descriptor parameters offsets in bytes */
> +enum fbo_desc_param {
> + FBO_DESC_PARAM_LEN = 0x0,
> + FBO_DESC_PARAM_VERSION = 0x1,
> + FBO_DESC_PARAM_REC_LBA_RANGE_SIZE = 0x3,
> + FBO_DESC_PARAM_MAX_LBA_RANGE_SIZE = 0x7,
> + FBO_DESC_PARAM_MIN_LBA_RANGE_SIZE = 0xB,
> + FBO_DESC_PARAM_MAX_LBA_RANGE_CONUT = 0xF,
> + FBO_DESC_PARAM_MAX_LBA_RANGE_ALIGNMENT = 0x10, };
> +
> /* WriteBooster buffer mode */
> enum {
> WB_BUF_MODE_LU_DEDICATED = 0x0,
> @@ -352,6 +364,7 @@ enum {
> UFS_DEV_EXT_TEMP_NOTIF = BIT(6),
> UFS_DEV_HPB_SUPPORT = BIT(7),
> UFS_DEV_WRITE_BOOSTER_SUP = BIT(8),
> + UFS_DEV_FBO_SUP = BIT(17),
> };
> #define UFS_DEV_HPB_SUPPORT_VERSION 0x310
>
> --
> 2.38.1
Powered by blists - more mailing lists