| Message ID | 1514467754-24499-10-git-send-email-stanislav.nijnikov@wdc.com (mailing list archive) |
|---|---|
| State | Changes Requested |
| Headers | show |
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 <stanislav.nijnikov@wdc.com> > --- > 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 <stanislav.nijnikov@wdc.com> > 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 <stanislav.nijnikov@wdc.com> > 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 <stanislav.nijnikov@wdc.com> > 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 <stanislav.nijnikov@wdc.com> > 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 <stanislav.nijnikov@wdc.com> > 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 <stanislav.nijnikov@wdc.com> > 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 <stanislav.nijnikov@wdc.com> > 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 <stanislav.nijnikov@wdc.com> > 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 <stanislav.nijnikov@wdc.com> > +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 <stanislav.nijnikov@wdc.com> > +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 <stanislav.nijnikov@wdc.com> > +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 <stanislav.nijnikov@wdc.com> > +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 <stanislav.nijnikov@wdc.com> > +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 <stanislav.nijnikov@wdc.com> > +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 <stanislav.nijnikov@wdc.com> > +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 <stanislav.nijnikov@wdc.com> > +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 <stanislav.nijnikov@wdc.com> > +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 <stanislav.nijnikov@wdc.com> > +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 <stanislav.nijnikov@wdc.com> > +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 <stanislav.nijnikov@wdc.com> > +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 <stanislav.nijnikov@wdc.com> > +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 <stanislav.nijnikov@wdc.com> > +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 <stanislav.nijnikov@wdc.com> > +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 <stanislav.nijnikov@wdc.com> > +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 <stanislav.nijnikov@wdc.com> > +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
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 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com> 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 <stanislav.nijnikov@wdc.com> 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 <stanislav.nijnikov@wdc.com> 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 <stanislav.nijnikov@wdc.com> 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 <stanislav.nijnikov@wdc.com> 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 <stanislav.nijnikov@wdc.com> 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 <stanislav.nijnikov@wdc.com> 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 <stanislav.nijnikov@wdc.com> 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 <stanislav.nijnikov@wdc.com> +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 <stanislav.nijnikov@wdc.com> +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 <stanislav.nijnikov@wdc.com> +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 <stanislav.nijnikov@wdc.com> +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 <stanislav.nijnikov@wdc.com> +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 <stanislav.nijnikov@wdc.com> +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 <stanislav.nijnikov@wdc.com> +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 <stanislav.nijnikov@wdc.com> +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 <stanislav.nijnikov@wdc.com> +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 <stanislav.nijnikov@wdc.com> +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 <stanislav.nijnikov@wdc.com> +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 <stanislav.nijnikov@wdc.com> +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 <stanislav.nijnikov@wdc.com> +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 <stanislav.nijnikov@wdc.com> +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 <stanislav.nijnikov@wdc.com> +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 <stanislav.nijnikov@wdc.com> +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 <stanislav.nijnikov@wdc.com> +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,
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 <stanislav.nijnikov@wdc.com> --- 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(-)