[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <20240806020604epcms2p3c9b035a6ef19e3b8b241d1ecadc03043@epcms2p3>
Date: Tue, 06 Aug 2024 11:06:04 +0900
From: Keoseong Park <keosung.park@...sung.com>
To: Avri Altman <avri.altman@....com>, "Martin K . Petersen"
<martin.petersen@...cle.com>
CC: "linux-scsi@...r.kernel.org" <linux-scsi@...r.kernel.org>,
"linux-kernel@...r.kernel.org" <linux-kernel@...r.kernel.org>, Bart Van
Assche <bvanassche@....org>
Subject: RE: [PATCH v2 2/2] scsi: ufs: Add HCI capabilities sysfs group
Hi Avri,
> The standard register map of UFSHCI is comprised of several groups. The
> first group (starting from offset 0x00), is the host capabilities group.
> It contains some interesting information, that otherwise is not
> available, e.g. the UFS version of the platform etc.
>
> Signed-off-by: Avri Altman <avri.altman@....com>
> ---
> Documentation/ABI/testing/sysfs-driver-ufs | 48 +++++++++++
> drivers/ufs/core/ufs-sysfs.c | 95 ++++++++++++++++++++++
> 2 files changed, 143 insertions(+)
>
> diff --git a/Documentation/ABI/testing/sysfs-driver-ufs b/Documentation/ABI/testing/sysfs-driver-ufs
> index fe943ce76c60..6c6cf12d25ca 100644
> --- a/Documentation/ABI/testing/sysfs-driver-ufs
> +++ b/Documentation/ABI/testing/sysfs-driver-ufs
> @@ -1532,3 +1532,51 @@ Contact: Bean Huo <beanhuo@...ron.com>
> Description:
> rtc_update_ms indicates how often the host should synchronize or update the
> UFS RTC. If set to 0, this will disable UFS RTC periodic update.
> +
> +What: /sys/bus/platform/drivers/ufshcd/ufshci_capabilities/capabilities
> +What: /sys/bus/platform/devices/*.ufs/ufshci_capabilities/capabilities
> +Date: August 2024
> +Contact: Avri Altman <avri.altman@....com>
> +Description:
> + Host Capabilities register group: host controller capabiities register.
A nit: s/capabiities/capabilities
With above addressed,
Reviewed-by: Keoseong Park <keosung.park@...sung.com>
Best Regards,
Keoseong
> + Symbol - CAP. Offset: 0x00 - 0x03.
> +
> +What: /sys/bus/platform/drivers/ufshcd/ufshci_capabilities/mcq_cap
> +What: /sys/bus/platform/devices/*.ufs/ufshci_capabilities/mcq_cap
> +Date: August 2024
> +Contact: Avri Altman <avri.altman@....com>
> +Description:
> + Host Capabilities register group: multi-circular queue capability register.
> + Symbol - MCQCAP. Offset: 0x04 - 0x07.
> +
> +What: /sys/bus/platform/drivers/ufshcd/ufshci_capabilities/version
> +What: /sys/bus/platform/devices/*.ufs/ufshci_capabilities/version
> +Date: August 2024
> +Contact: Avri Altman <avri.altman@....com>
> +Description:
> + Host Capabilities register group: UFS version register.
> + Symbol - VER. Offset: 0x08 - 0x0B.
> +
> +What: /sys/bus/platform/drivers/ufshcd/ufshci_capabilities/ext_capabilities
> +What: /sys/bus/platform/devices/*.ufs/ufshci_capabilities/ext_capabilities
> +Date: August 2024
> +Contact: Avri Altman <avri.altman@....com>
> +Description:
> + Host Capabilities register group: extended controller capabilities register.
> + Symbol - EXT_CAP. Offset: 0x0C - 0x0F.
> +
> +What: /sys/bus/platform/drivers/ufshcd/ufshci_capabilities/product_id
> +What: /sys/bus/platform/devices/*.ufs/ufshci_capabilities/product_id
> +Date: August 2024
> +Contact: Avri Altman <avri.altman@....com>
> +Description:
> + Host Capabilities register group: product ID register.
> + Symbol - HCPID. Offset: 0x10 - 0x13.
> +
> +What: /sys/bus/platform/drivers/ufshcd/ufshci_capabilities/man_id
> +What: /sys/bus/platform/devices/*.ufs/ufshci_capabilities/man_id
> +Date: August 2024
> +Contact: Avri Altman <avri.altman@....com>
> +Description:
> + Host Capabilities register group: manufacturer ID register.
> + Symbol - HCMID. Offset: 0x14 - 0x17.
> diff --git a/drivers/ufs/core/ufs-sysfs.c b/drivers/ufs/core/ufs-sysfs.c
> index dec7746c98e0..751d5ff406da 100644
> --- a/drivers/ufs/core/ufs-sysfs.c
> +++ b/drivers/ufs/core/ufs-sysfs.c
> @@ -525,6 +525,100 @@ static const struct attribute_group ufs_sysfs_capabilities_group = {
> .attrs = ufs_sysfs_capabilities_attrs,
> };
>
> +static ssize_t capabilities_show(struct device *dev,
> + struct device_attribute *attr, char *buf)
> +{
> + struct ufs_hba *hba = dev_get_drvdata(dev);
> +
> + return sysfs_emit(buf, "0x%x\n", hba->capabilities);
> +}
> +
> +static ssize_t mcq_cap_show(struct device *dev,
> + struct device_attribute *attr, char *buf)
> +{
> + struct ufs_hba *hba = dev_get_drvdata(dev);
> +
> + if (hba->ufs_version < ufshci_version(4, 0))
> + return -EOPNOTSUPP;
> +
> + return sysfs_emit(buf, "0x%x\n", hba->mcq_capabilities);
> +}
> +
> +static ssize_t version_show(struct device *dev,
> + struct device_attribute *attr, char *buf)
> +{
> + struct ufs_hba *hba = dev_get_drvdata(dev);
> +
> + return sysfs_emit(buf, "0x%x\n", hba->ufs_version);
> +}
> +
> +static ssize_t ext_capabilities_show(struct device *dev,
> + struct device_attribute *attr, char *buf)
> +{
> + int ret;
> + u32 val;
> + struct ufs_hba *hba = dev_get_drvdata(dev);
> +
> + if (hba->ufs_version < ufshci_version(4, 0))
> + return -EOPNOTSUPP;
> +
> + ret = ufshcd_read_hci_reg(hba, &val, REG_EXT_CONTROLLER_CAPABILITIES);
> + if (ret)
> + return ret;
> +
> + return sysfs_emit(buf, "0x%x\n", val);
> +}
> +
> +static ssize_t product_id_show(struct device *dev,
> + struct device_attribute *attr, char *buf)
> +{
> + int ret;
> + u32 val;
> + struct ufs_hba *hba = dev_get_drvdata(dev);
> +
> + ret = ufshcd_read_hci_reg(hba, &val, REG_CONTROLLER_PID);
> + if (ret)
> + return ret;
> +
> + return sysfs_emit(buf, "0x%x\n", val);
> +}
> +
> +static ssize_t man_id_show(struct device *dev,
> + struct device_attribute *attr, char *buf)
> +{
> + int ret;
> + u32 val;
> + struct ufs_hba *hba = dev_get_drvdata(dev);
> +
> + ret = ufshcd_read_hci_reg(hba, &val, REG_CONTROLLER_MID);
> + if (ret)
> + return ret;
> +
> + return sysfs_emit(buf, "0x%x\n", val);
> +}
> +
> +static DEVICE_ATTR_RO(capabilities);
> +static DEVICE_ATTR_RO(mcq_cap);
> +static DEVICE_ATTR_RO(version);
> +static DEVICE_ATTR_RO(ext_capabilities);
> +static DEVICE_ATTR_RO(product_id);
> +static DEVICE_ATTR_RO(man_id);
> +
> +static struct attribute *ufs_sysfs_ufshci_cap_attrs[] = {
> + &dev_attr_capabilities.attr,
> + &dev_attr_mcq_cap.attr,
> + &dev_attr_version.attr,
> + &dev_attr_ext_capabilities.attr,
> + &dev_attr_product_id.attr,
> + &dev_attr_man_id.attr,
> + NULL
> +};
> +
> +static const struct attribute_group ufs_sysfs_ufshci_group = {
> + .name = "ufshci_capabilities",
> + .attrs = ufs_sysfs_ufshci_cap_attrs,
> +};
> +
> static ssize_t monitor_enable_show(struct device *dev,
> struct device_attribute *attr, char *buf)
> {
> @@ -1508,6 +1602,7 @@ static const struct attribute_group ufs_sysfs_attributes_group = {
> static const struct attribute_group *ufs_sysfs_groups[] = {
> &ufs_sysfs_default_group,
> &ufs_sysfs_capabilities_group,
> + &ufs_sysfs_ufshci_group,
> &ufs_sysfs_monitor_group,
> &ufs_sysfs_power_info_group,
> &ufs_sysfs_device_descriptor_group,
> --
> 2.25.1
Powered by blists - more mailing lists