Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754045AbdL1Tw0 (ORCPT ); Thu, 28 Dec 2017 14:52:26 -0500 Received: from mail.kernel.org ([198.145.29.99]:42322 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1750854AbdL1TwY (ORCPT ); Thu, 28 Dec 2017 14:52:24 -0500 DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 4E0B72187C Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=kernel.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=jaegeuk@kernel.org Date: Thu, 28 Dec 2017 11:52:23 -0800 From: Jaegeuk Kim To: Stanislav Nijnikov Cc: linux-scsi@vger.kernel.org, linux-kernel@vger.kernel.org, gregkh@linuxfoundation.org, alex.lemberg@wdc.com Subject: Re: [PATCH v3 9/9] ufs: sysfs: attributes Message-ID: <20171228195223.GC47637@jaegeuk-macbookpro.roam.corp.google.com> References: <1514467754-24499-1-git-send-email-stanislav.nijnikov@wdc.com> <1514467754-24499-10-git-send-email-stanislav.nijnikov@wdc.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1514467754-24499-10-git-send-email-stanislav.nijnikov@wdc.com> User-Agent: Mutt/1.8.2 (2017-04-18) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 19431 Lines: 438 On 12/28, Stanislav Nijnikov wrote: > This patch introduces a sysfs group entry for the UFS attributes. The > group adds "attributes" folder under the UFS driver sysfs entry > (/sys/bus/platform/drivers/ufshcd/*). The attributes are shown > as hexadecimal numbers. The full information about the attributes could > be found at UFS specifications 2.1. > > Signed-off-by: Stanislav Nijnikov > --- > Documentation/ABI/testing/sysfs-driver-ufs | 155 +++++++++++++++++++++++++++-- > drivers/scsi/ufs/ufs-sysfs.c | 89 +++++++++++++++++ > drivers/scsi/ufs/ufs-sysfs.h | 1 + > drivers/scsi/ufs/ufs.h | 27 ++++- > drivers/scsi/ufs/ufshcd.c | 5 +- > drivers/scsi/ufs/ufshcd.h | 2 + > 6 files changed, 265 insertions(+), 14 deletions(-) > > diff --git a/Documentation/ABI/testing/sysfs-driver-ufs b/Documentation/ABI/testing/sysfs-driver-ufs > index 90f8574..f2c3679 100644 > --- a/Documentation/ABI/testing/sysfs-driver-ufs > +++ b/Documentation/ABI/testing/sysfs-driver-ufs > @@ -601,14 +601,14 @@ Description: This file shows the granularity of the LUN. This is one of > > > What: /sys/bus/platform/drivers/ufshcd/*/flags/device_init > -Date: August 2017 > +Date: December 2017 Must be fixed in the original patch. Thanks, > Contact: Stanislav Nijnikov > Description: This file shows the device init status. The full information > about the flag could be found at UFS specifications 2.1. > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/flags/permanent_wpe > -Date: August 2017 > +Date: December 2017 > Contact: Stanislav Nijnikov > Description: This file shows whether permanent write protection is enabled. > The full information about the flag could be found at > @@ -616,7 +616,7 @@ Description: This file shows whether permanent write protection is enabled. > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/flags/power_on_wpe > -Date: August 2017 > +Date: December 2017 > Contact: Stanislav Nijnikov > Description: This file shows whether write protection is enabled on all > logical units configured as power on write protected. The > @@ -625,7 +625,7 @@ Description: This file shows whether write protection is enabled on all > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/flags/bkops_enable > -Date: August 2017 > +Date: December 2017 > Contact: Stanislav Nijnikov > Description: This file shows whether the device background operations are > enabled. The full information about the flag could be > @@ -633,7 +633,7 @@ Description: This file shows whether the device background operations are > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/flags/life_span_mode_enable > -Date: August 2017 > +Date: December 2017 > Contact: Stanislav Nijnikov > Description: This file shows whether the device life span mode is enabled. > The full information about the flag could be found at > @@ -641,7 +641,7 @@ Description: This file shows whether the device life span mode is enabled. > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/flags/phy_resource_removal > -Date: August 2017 > +Date: December 2017 > Contact: Stanislav Nijnikov > Description: This file shows whether physical resource removal is enable. > The full information about the flag could be found at > @@ -649,7 +649,7 @@ Description: This file shows whether physical resource removal is enable. > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/flags/busy_rtc > -Date: August 2017 > +Date: December 2017 > Contact: Stanislav Nijnikov > Description: This file shows whether the device is executing internal > operation related to real time clock. The full information > @@ -657,9 +657,148 @@ Description: This file shows whether the device is executing internal > The file is read only. > > What: /sys/bus/platform/drivers/ufshcd/*/flags/disable_fw_update > -Date: August 2017 > +Date: December 2017 > Contact: Stanislav Nijnikov > Description: This file shows whether the device FW update is permanently > disabled. The full information about the flag could be found > at UFS specifications 2.1. > The file is read only. > + > + > +What: /sys/bus/platform/drivers/ufshcd/*/attributes/boot_lun_enabled > +Date: December 2017 > +Contact: Stanislav Nijnikov > +Description: This file provides the boot lun enabled UFS device attribute. > + The full information about the attribute could be found at > + UFS specifications 2.1. > + The file is read only. > + > +What: /sys/bus/platform/drivers/ufshcd/*/attributes/current_power_mode > +Date: December 2017 > +Contact: Stanislav Nijnikov > +Description: This file provides the current power mode UFS device attribute. > + The full information about the attribute could be found at > + UFS specifications 2.1. > + The file is read only. > + > +What: /sys/bus/platform/drivers/ufshcd/*/attributes/active_icc_level > +Date: December 2017 > +Contact: Stanislav Nijnikov > +Description: This file provides the active icc level UFS device attribute. > + The full information about the attribute could be found at > + UFS specifications 2.1. > + The file is read only. > + > +What: /sys/bus/platform/drivers/ufshcd/*/attributes/ooo_data_enabled > +Date: December 2017 > +Contact: Stanislav Nijnikov > +Description: This file provides the out of order data transfer enabled UFS > + device attribute. The full information about the attribute > + could be found at UFS specifications 2.1. > + The file is read only. > + > +What: /sys/bus/platform/drivers/ufshcd/*/attributes/bkops_status > +Date: December 2017 > +Contact: Stanislav Nijnikov > +Description: This file provides the background operations status UFS device > + attribute. The full information about the attribute could > + be found at UFS specifications 2.1. > + The file is read only. > + > +What: /sys/bus/platform/drivers/ufshcd/*/attributes/purge_status > +Date: December 2017 > +Contact: Stanislav Nijnikov > +Description: This file provides the purge operation status UFS device > + attribute. The full information about the attribute could > + be found at UFS specifications 2.1. > + The file is read only. > + > +What: /sys/bus/platform/drivers/ufshcd/*/attributes/max_data_in_size > +Date: December 2017 > +Contact: Stanislav Nijnikov > +Description: This file shows the maximum data size in a DATA IN > + UPIU. The full information about the attribute could > + be found at UFS specifications 2.1. > + The file is read only. > + > +What: /sys/bus/platform/drivers/ufshcd/*/attributes/max_data_out_size > +Date: December 2017 > +Contact: Stanislav Nijnikov > +Description: This file shows the maximum number of bytes that can be > + requested with a READY TO TRANSFER UPIU. The full information > + about the attribute could be found at UFS specifications 2.1. > + The file is read only. > + > +What: /sys/bus/platform/drivers/ufshcd/*/attributes/reference_clock_frequency > +Date: December 2017 > +Contact: Stanislav Nijnikov > +Description: This file provides the reference clock frequency UFS device > + attribute. The full information about the attribute could > + be found at UFS specifications 2.1. > + The file is read only. > + > +What: /sys/bus/platform/drivers/ufshcd/*/attributes/configuration_descriptor_lock > +Date: December 2017 > +Contact: Stanislav Nijnikov > +Description: This file shows whether the configuration descriptor is locked. > + The full information about the attribute could be found at > + UFS specifications 2.1. The file is read only. > + > +What: /sys/bus/platform/drivers/ufshcd/*/attributes/max_number_of_rtt > +Date: December 2017 > +Contact: Stanislav Nijnikov > +Description: This file provides the maximum current number of > + outstanding RTTs in device that is allowed. The full > + information about the attribute could be found at > + UFS specifications 2.1. > + The file is read only. > + > +What: /sys/bus/platform/drivers/ufshcd/*/attributes/exception_event_control > +Date: December 2017 > +Contact: Stanislav Nijnikov > +Description: This file provides the exception event control UFS device > + attribute. The full information about the attribute could > + be found at UFS specifications 2.1. > + The file is read only. > + > +What: /sys/bus/platform/drivers/ufshcd/*/attributes/exception_event_status > +Date: December 2017 > +Contact: Stanislav Nijnikov > +Description: This file provides the exception event status UFS device > + attribute. The full information about the attribute could > + be found at UFS specifications 2.1. > + The file is read only. > + > +What: /sys/bus/platform/drivers/ufshcd/*/attributes/ffu_status > +Date: December 2017 > +Contact: Stanislav Nijnikov > +Description: This file provides the ffu status UFS device attribute. > + The full information about the attribute could be found at > + UFS specifications 2.1. > + The file is read only. > + > +What: /sys/bus/platform/drivers/ufshcd/*/attributes/psa_state > +Date: December 2017 > +Contact: Stanislav Nijnikov > +Description: This file show the PSA feature status. The full information > + about the attribute could be found at UFS specifications 2.1. > + The file is read only. > + > +What: /sys/bus/platform/drivers/ufshcd/*/attributes/psa_data_size > +Date: December 2017 > +Contact: Stanislav Nijnikov > +Description: This file shows the amount of data that the host plans to > + load to all logical units in pre-soldering state. > + The full information about the attribute could be found at > + UFS specifications 2.1. > + The file is read only. > + > + > +What: /sys/class/scsi_device/*/device/dyn_cap_needed > +Date: December 2017 > +Contact: Stanislav Nijnikov > +Description: This file shows the The amount of physical memory needed > + to be removed from the physical memory resources pool of > + the particular logical unit. The full information about > + the attribute could be found at UFS specifications 2.1. > + The file is read only. > diff --git a/drivers/scsi/ufs/ufs-sysfs.c b/drivers/scsi/ufs/ufs-sysfs.c > index 2095124..f3ec1b0 100644 > --- a/drivers/scsi/ufs/ufs-sysfs.c > +++ b/drivers/scsi/ufs/ufs-sysfs.c > @@ -485,6 +485,64 @@ static const struct attribute_group ufs_sysfs_flags_group = { > .attrs = ufs_sysfs_device_flags, > }; > > +#define ufs_sysfs_attribute_show_function(_name, _uname) \ > +static ssize_t _name##_show(struct device *dev, \ > + struct device_attribute *attr, char *buf) \ > +{ \ > + struct ufs_hba *hba = dev_get_drvdata(dev); \ > + u32 value; \ > + if (ufshcd_query_attr(hba, UPIU_QUERY_OPCODE_READ_ATTR, \ > + QUERY_ATTR_IDN_##_uname, 0, 0, &value)) \ > + return -EINVAL; \ > + return sprintf(buf, "0x%08X\n", value); \ > +} > + > +#define UFS_ATTRIBUTE(_name, _uname) \ > + ufs_sysfs_attribute_show_function(_name, _uname) \ > + static DEVICE_ATTR_RO(_name) > + > +UFS_ATTRIBUTE(boot_lun_enabled, BOOT_LU_EN); > +UFS_ATTRIBUTE(current_power_mode, POWER_MODE); > +UFS_ATTRIBUTE(active_icc_level, ACTIVE_ICC_LVL); > +UFS_ATTRIBUTE(ooo_data_enabled, OOO_DATA_EN); > +UFS_ATTRIBUTE(bkops_status, BKOPS_STATUS); > +UFS_ATTRIBUTE(purge_status, PURGE_STATUS); > +UFS_ATTRIBUTE(max_data_in_size, MAX_DATA_IN); > +UFS_ATTRIBUTE(max_data_out_size, MAX_DATA_OUT); > +UFS_ATTRIBUTE(reference_clock_frequency, REF_CLK_FREQ); > +UFS_ATTRIBUTE(configuration_descriptor_lock, CONF_DESC_LOCK); > +UFS_ATTRIBUTE(max_number_of_rtt, MAX_NUM_OF_RTT); > +UFS_ATTRIBUTE(exception_event_control, EE_CONTROL); > +UFS_ATTRIBUTE(exception_event_status, EE_STATUS); > +UFS_ATTRIBUTE(ffu_status, FFU_STATUS); > +UFS_ATTRIBUTE(psa_state, PSA_STATE); > +UFS_ATTRIBUTE(psa_data_size, PSA_DATA_SIZE); > + > +static struct attribute *ufs_sysfs_attributes[] = { > + &dev_attr_boot_lun_enabled.attr, > + &dev_attr_current_power_mode.attr, > + &dev_attr_active_icc_level.attr, > + &dev_attr_ooo_data_enabled.attr, > + &dev_attr_bkops_status.attr, > + &dev_attr_purge_status.attr, > + &dev_attr_max_data_in_size.attr, > + &dev_attr_max_data_out_size.attr, > + &dev_attr_reference_clock_frequency.attr, > + &dev_attr_configuration_descriptor_lock.attr, > + &dev_attr_max_number_of_rtt.attr, > + &dev_attr_exception_event_control.attr, > + &dev_attr_exception_event_status.attr, > + &dev_attr_ffu_status.attr, > + &dev_attr_psa_state.attr, > + &dev_attr_psa_data_size.attr, > + NULL, > +}; > + > +static const struct attribute_group ufs_sysfs_attributes_group = { > + .name = "attributes", > + .attrs = ufs_sysfs_attributes, > +}; > + > static const struct attribute_group *ufs_sysfs_groups[] = { > &ufs_sysfs_device_descriptor_group, > &ufs_sysfs_interconnect_descriptor_group, > @@ -493,6 +551,7 @@ static const struct attribute_group *ufs_sysfs_groups[] = { > &ufs_sysfs_power_descriptor_group, > &ufs_sysfs_string_descriptors_group, > &ufs_sysfs_flags_group, > + &ufs_sysfs_attributes_group, > NULL, > }; > > @@ -553,6 +612,36 @@ struct attribute_group ufs_sysfs_unit_descriptor_group = { > .attrs = ufs_sysfs_unit_descriptor, > }; > > +#define ufs_sysfs_lun_attribute_show_function(_name, _uname) \ > +static ssize_t _name##_attribute_show(struct device *dev, \ > + struct device_attribute *attr, char *buf) \ > +{ \ > + u32 value; \ > + struct scsi_device *sdev = to_scsi_device(dev); \ > + struct ufs_hba *hba = shost_priv(sdev->host); \ > + u8 lun = ufshcd_scsi_to_upiu_lun(sdev->lun); \ > + if (ufshcd_query_attr(hba, UPIU_QUERY_OPCODE_READ_ATTR, \ > + QUERY_ATTR_IDN_##_uname, lun, 0, &value)) \ > + return -EINVAL; \ > + return sprintf(buf, "0x%08X\n", value); \ > +} > + > +#define UFS_LUN_ATTRIBUTE(_name, _uname) \ > + ufs_sysfs_lun_attribute_show_function(_name, _uname) \ > + static DEVICE_ATTR_RO(_name##_attribute) > + > + > +UFS_LUN_ATTRIBUTE(dyn_cap_needed, DYN_CAP_NEEDED); > + > +static struct attribute *ufs_sysfs_lun_attributes[] = { > + &dev_attr_dyn_cap_needed_attribute.attr, > + NULL, > +}; > + > +struct attribute_group ufs_sysfs_lun_attributes_group = { > + .attrs = ufs_sysfs_lun_attributes, > +}; > + > void ufs_sysfs_add_device_management(struct ufs_hba *hba) > { > int ret; > diff --git a/drivers/scsi/ufs/ufs-sysfs.h b/drivers/scsi/ufs/ufs-sysfs.h > index 1ec1217..cff5360 100644 > --- a/drivers/scsi/ufs/ufs-sysfs.h > +++ b/drivers/scsi/ufs/ufs-sysfs.h > @@ -25,4 +25,5 @@ void ufs_sysfs_add_device_management(struct ufs_hba *hba); > void ufs_sysfs_remove_device_management(struct ufs_hba *hba); > > extern struct attribute_group ufs_sysfs_unit_descriptor_group; > +extern struct attribute_group ufs_sysfs_lun_attributes_group; > #endif > diff --git a/drivers/scsi/ufs/ufs.h b/drivers/scsi/ufs/ufs.h > index df5e73e..14e5bf7 100644 > --- a/drivers/scsi/ufs/ufs.h > +++ b/drivers/scsi/ufs/ufs.h > @@ -145,10 +145,29 @@ enum flag_idn { > > /* Attribute idn for Query requests */ > enum attr_idn { > - QUERY_ATTR_IDN_ACTIVE_ICC_LVL = 0x03, > - QUERY_ATTR_IDN_BKOPS_STATUS = 0x05, > - QUERY_ATTR_IDN_EE_CONTROL = 0x0D, > - QUERY_ATTR_IDN_EE_STATUS = 0x0E, > + QUERY_ATTR_IDN_BOOT_LU_EN = 0x00, > + QUERY_ATTR_IDN_RESERVED = 0x01, > + QUERY_ATTR_IDN_POWER_MODE = 0x02, > + QUERY_ATTR_IDN_ACTIVE_ICC_LVL = 0x03, > + QUERY_ATTR_IDN_OOO_DATA_EN = 0x04, > + QUERY_ATTR_IDN_BKOPS_STATUS = 0x05, > + QUERY_ATTR_IDN_PURGE_STATUS = 0x06, > + QUERY_ATTR_IDN_MAX_DATA_IN = 0x07, > + QUERY_ATTR_IDN_MAX_DATA_OUT = 0x08, > + QUERY_ATTR_IDN_DYN_CAP_NEEDED = 0x09, > + QUERY_ATTR_IDN_REF_CLK_FREQ = 0x0A, > + QUERY_ATTR_IDN_CONF_DESC_LOCK = 0x0B, > + QUERY_ATTR_IDN_MAX_NUM_OF_RTT = 0x0C, > + QUERY_ATTR_IDN_EE_CONTROL = 0x0D, > + QUERY_ATTR_IDN_EE_STATUS = 0x0E, > + QUERY_ATTR_IDN_SECONDS_PASSED = 0x0F, > + QUERY_ATTR_IDN_CNTX_CONF = 0x10, > + QUERY_ATTR_IDN_CORR_PRG_BLK_NUM = 0x11, > + QUERY_ATTR_IDN_RESERVED2 = 0x12, > + QUERY_ATTR_IDN_RESERVED3 = 0x13, > + QUERY_ATTR_IDN_FFU_STATUS = 0x14, > + QUERY_ATTR_IDN_PSA_STATE = 0x15, > + QUERY_ATTR_IDN_PSA_DATA_SIZE = 0x16, > }; > > /* Descriptor idn for Query requests */ > diff --git a/drivers/scsi/ufs/ufshcd.c b/drivers/scsi/ufs/ufshcd.c > index 3ddab23..6dab9a6 100644 > --- a/drivers/scsi/ufs/ufshcd.c > +++ b/drivers/scsi/ufs/ufshcd.c > @@ -2711,8 +2711,8 @@ int ufshcd_query_flag(struct ufs_hba *hba, enum query_opcode opcode, > * > * Returns 0 for success, non-zero in case of failure > */ > -static int ufshcd_query_attr(struct ufs_hba *hba, enum query_opcode opcode, > - enum attr_idn idn, u8 index, u8 selector, u32 *attr_val) > +int ufshcd_query_attr(struct ufs_hba *hba, enum query_opcode opcode, > + enum attr_idn idn, u8 index, u8 selector, u32 *attr_val) > { > struct ufs_query_req *request = NULL; > struct ufs_query_res *response = NULL; > @@ -6489,6 +6489,7 @@ static enum blk_eh_timer_return ufshcd_eh_timed_out(struct scsi_cmnd *scmd) > > static struct attribute_group *ufshcd_driver_groups[] = { > &ufs_sysfs_unit_descriptor_group, > + &ufs_sysfs_lun_attributes_group, > NULL, > }; > > diff --git a/drivers/scsi/ufs/ufshcd.h b/drivers/scsi/ufs/ufshcd.h > index 209c563..5a1b21b 100644 > --- a/drivers/scsi/ufs/ufshcd.h > +++ b/drivers/scsi/ufs/ufshcd.h > @@ -846,6 +846,8 @@ int ufshcd_query_descriptor_retry(struct ufs_hba *hba, > enum query_opcode opcode, > enum desc_idn idn, u8 index, u8 selector, > u8 *desc_buf, int *buf_len); > +int ufshcd_query_attr(struct ufs_hba *hba, enum query_opcode opcode, > + enum attr_idn idn, u8 index, u8 selector, u32 *attr_val); > int ufshcd_query_flag(struct ufs_hba *hba, enum query_opcode opcode, > enum flag_idn idn, bool *flag_res); > int ufshcd_read_string_desc(struct ufs_hba *hba, int desc_index, > -- > 2.7.4