Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit d10b2a8e authored by Stanislav Nijnikov's avatar Stanislav Nijnikov Committed by Martin K. Petersen
Browse files

scsi: ufs: sysfs: flags 



This patch introduces a sysfs group entry for the UFS flags. The group adds
"flags" folder under the UFS driver sysfs entry
(/sys/bus/platform/drivers/ufshcd/*). The flags are shown as boolean value
("true" or "false"). The full information about the UFS flags could be
found at UFS specifications 2.1.

Signed-off-by: default avatarStanislav Nijnikov <stanislav.nijnikov@wdc.com>
Reviewed-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
Signed-off-by: default avatarMartin K. Petersen <martin.petersen@oracle.com>
parent d829fc8a

Documentation/ABI/testing/sysfs-driver-ufs

+65 −0
Original line number Diff line number Diff line
@@ -598,3 +598,68 @@ Description: This file shows the granularity of the LUN. This is one of 
		the UFS unit descriptor parameters. The full information

		about the descriptor could be found at UFS specifications 2.1.

		The file is read only.





What:		/sys/bus/platform/drivers/ufshcd/*/flags/device_init

Date:		February 2018

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:		February 2018

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

		UFS specifications 2.1.

		The file is read only.



What:		/sys/bus/platform/drivers/ufshcd/*/flags/power_on_wpe

Date:		February 2018

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

		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/bkops_enable

Date:		February 2018

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

		found at UFS specifications 2.1.

		The file is read only.



What:		/sys/bus/platform/drivers/ufshcd/*/flags/life_span_mode_enable

Date:		February 2018

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

		UFS specifications 2.1.

		The file is read only.



What:		/sys/bus/platform/drivers/ufshcd/*/flags/phy_resource_removal

Date:		February 2018

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

		UFS specifications 2.1.

		The file is read only.



What:		/sys/bus/platform/drivers/ufshcd/*/flags/busy_rtc

Date:		February 2018

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

		about the flag could be found at UFS specifications 2.1.

		The file is read only.



What:		/sys/bus/platform/drivers/ufshcd/*/flags/disable_fw_update

Date:		February 2018

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.

drivers/scsi/ufs/ufs-sysfs.c

+39 −0
Original line number Diff line number Diff line
@@ -538,6 +538,44 @@ static const struct attribute_group ufs_sysfs_string_descriptors_group = { 
	.attrs = ufs_sysfs_string_descriptors,

};



#define UFS_FLAG(_name, _uname)						\

static ssize_t _name##_show(struct device *dev,				\

	struct device_attribute *attr, char *buf)			\

{									\

	bool flag;							\

	struct ufs_hba *hba = dev_get_drvdata(dev);			\

	if (ufshcd_query_flag(hba, UPIU_QUERY_OPCODE_READ_FLAG,		\

		QUERY_FLAG_IDN##_uname, &flag))				\

		return -EINVAL;						\

	return sprintf(buf, "%s\n", flag ? "true" : "false");		\

}									\

static DEVICE_ATTR_RO(_name)



UFS_FLAG(device_init, _FDEVICEINIT);

UFS_FLAG(permanent_wpe, _PERMANENT_WPE);

UFS_FLAG(power_on_wpe, _PWR_ON_WPE);

UFS_FLAG(bkops_enable, _BKOPS_EN);

UFS_FLAG(life_span_mode_enable, _LIFE_SPAN_MODE_ENABLE);

UFS_FLAG(phy_resource_removal, _FPHYRESOURCEREMOVAL);

UFS_FLAG(busy_rtc, _BUSY_RTC);

UFS_FLAG(disable_fw_update, _PERMANENTLY_DISABLE_FW_UPDATE);



static struct attribute *ufs_sysfs_device_flags[] = {

	&dev_attr_device_init.attr,

	&dev_attr_permanent_wpe.attr,

	&dev_attr_power_on_wpe.attr,

	&dev_attr_bkops_enable.attr,

	&dev_attr_life_span_mode_enable.attr,

	&dev_attr_phy_resource_removal.attr,

	&dev_attr_busy_rtc.attr,

	&dev_attr_disable_fw_update.attr,

	NULL,

};



static const struct attribute_group ufs_sysfs_flags_group = {

	.name = "flags",

	.attrs = ufs_sysfs_device_flags,

};



static const struct attribute_group *ufs_sysfs_groups[] = {

	&ufs_sysfs_default_group,
@@ -547,6 +585,7 @@ static const struct attribute_group *ufs_sysfs_groups[] = { 
	&ufs_sysfs_health_descriptor_group,

	&ufs_sysfs_power_descriptor_group,

	&ufs_sysfs_string_descriptors_group,

	&ufs_sysfs_flags_group,

	NULL,

};

drivers/scsi/ufs/ufs.h

+11 −3
Original line number Diff line number Diff line
@@ -131,8 +131,16 @@ enum { 
/* Flag idn for Query Requests*/

enum flag_idn {

	QUERY_FLAG_IDN_FDEVICEINIT			= 0x01,

	QUERY_FLAG_IDN_PERMANENT_WPE			= 0x02,

	QUERY_FLAG_IDN_PWR_ON_WPE			= 0x03,

	QUERY_FLAG_IDN_BKOPS_EN				= 0x04,

	QUERY_FLAG_IDN_LIFE_SPAN_MODE_ENABLE		= 0x05,

	QUERY_FLAG_IDN_PURGE_ENABLE			= 0x06,

	QUERY_FLAG_IDN_RESERVED2			= 0x07,

	QUERY_FLAG_IDN_FPHYRESOURCEREMOVAL		= 0x08,

	QUERY_FLAG_IDN_BUSY_RTC				= 0x09,

	QUERY_FLAG_IDN_RESERVED3			= 0x0A,

	QUERY_FLAG_IDN_PERMANENTLY_DISABLE_FW_UPDATE	= 0x0B,

};



/* Attribute idn for Query requests */