Commit 2f79d3d1 authored by Alexander Usyskin's avatar Alexander Usyskin Committed by Greg Kroah-Hartman
Browse files

mei: add device kind to sysfs 



Some of the mei device heads are not generic and have
a specific purpose, we need to announce it to the user space
so it is possible to detect the correct device node via
matching attributes.

Generic heads are marked as 'mei' while special purpose heads
have their own names. Currently we are adding 'itouch' string
for Intel IPTS 1.0, 2.0 devices.

This is done via new sysfs attribute 'kind'.

Signed-off-by: default avatarAlexander Usyskin <alexander.usyskin@intel.com>
Signed-off-by: default avatarTomas Winkler <tomas.winkler@intel.com>
Link: https://lore.kernel.org/r/20200728192242.3117779-1-tomas.winkler@intel.com


Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent 9bb01fe1

Documentation/ABI/testing/sysfs-class-mei

+13 −0
Original line number Diff line number Diff line
@@ -90,3 +90,16 @@ Description: Display trc status register content 
		The ME FW writes Glitch Detection HW (TRC)

		status information into trc status register

		for BIOS and OS to monitor fw health.



What:		/sys/class/mei/meiN/kind

Date:		Jul 2020

KernelVersion:	5.8

Contact:	Tomas Winkler <tomas.winkler@intel.com>

Description:	Display kind of the device



		Generic devices are marked as "mei"

		while special purpose have their own

		names.

		Available options:

		- mei:  generic mei device.

		- itouch:  itouch (ipts) mei device.

drivers/misc/mei/hw-me.c

+18 −4
Original line number Diff line number Diff line
@@ -1430,6 +1430,9 @@ static bool mei_me_fw_type_sps(const struct pci_dev *pdev) 
	return fw_type == PCI_CFG_HFS_3_FW_SKU_SPS;

}



#define MEI_CFG_KIND_ITOUCH                     \

	.kind = "itouch"



#define MEI_CFG_FW_SPS                          \

	.quirk_probe = mei_me_fw_type_sps
@@ -1499,6 +1502,13 @@ static const struct mei_cfg mei_me_pch8_cfg = { 
	MEI_CFG_FW_VER_SUPP,

};



/* PCH8 Lynx Point and newer devices - iTouch */

static const struct mei_cfg mei_me_pch8_itouch_cfg = {

	MEI_CFG_KIND_ITOUCH,

	MEI_CFG_PCH8_HFS,

	MEI_CFG_FW_VER_SUPP,

};



/* PCH8 Lynx Point with quirk for SPS Firmware exclusion */

static const struct mei_cfg mei_me_pch8_sps_4_cfg = {

	MEI_CFG_PCH8_HFS,
@@ -1528,10 +1538,11 @@ static const struct mei_cfg mei_me_pch12_sps_cfg = { 
	MEI_CFG_FW_SPS,

};



/* Cannon Lake with quirk for SPS 5.0 and newer Firmware exclusion

 * w/o DMA support

/* Cannon Lake itouch with quirk for SPS 5.0 and newer Firmware exclusion

 * w/o DMA support.

 */

static const struct mei_cfg mei_me_pch12_nodma_sps_cfg = {

static const struct mei_cfg mei_me_pch12_itouch_sps_cfg = {

	MEI_CFG_KIND_ITOUCH,

	MEI_CFG_PCH8_HFS,

	MEI_CFG_FW_VER_SUPP,

	MEI_CFG_FW_SPS,
@@ -1566,11 +1577,12 @@ static const struct mei_cfg *const mei_cfg_list[] = { 
	[MEI_ME_PCH7_CFG] = &mei_me_pch7_cfg,

	[MEI_ME_PCH_CPT_PBG_CFG] = &mei_me_pch_cpt_pbg_cfg,

	[MEI_ME_PCH8_CFG] = &mei_me_pch8_cfg,

	[MEI_ME_PCH8_ITOUCH_CFG] = &mei_me_pch8_itouch_cfg,

	[MEI_ME_PCH8_SPS_4_CFG] = &mei_me_pch8_sps_4_cfg,

	[MEI_ME_PCH12_CFG] = &mei_me_pch12_cfg,

	[MEI_ME_PCH12_SPS_4_CFG] = &mei_me_pch12_sps_4_cfg,

	[MEI_ME_PCH12_SPS_CFG] = &mei_me_pch12_sps_cfg,

	[MEI_ME_PCH12_SPS_NODMA_CFG] = &mei_me_pch12_nodma_sps_cfg,

	[MEI_ME_PCH12_SPS_ITOUCH_CFG] = &mei_me_pch12_itouch_sps_cfg,

	[MEI_ME_PCH15_CFG] = &mei_me_pch15_cfg,

	[MEI_ME_PCH15_SPS_CFG] = &mei_me_pch15_sps_cfg,

};
@@ -1614,6 +1626,8 @@ struct mei_device *mei_me_dev_init(struct device *parent, 


	dev->fw_f_fw_ver_supported = cfg->fw_ver_supported;



	dev->kind = cfg->kind;



	return dev;

}

drivers/misc/mei/hw-me.h

+6 −1
Original line number Diff line number Diff line
@@ -19,6 +19,7 @@ 
 *

 * @fw_status: FW status

 * @quirk_probe: device exclusion quirk

 * @kind: MEI head kind

 * @dma_size: device DMA buffers size

 * @fw_ver_supported: is fw version retrievable from FW

 * @hw_trc_supported: does the hw support trc register
@@ -26,6 +27,7 @@ 
struct mei_cfg {

	const struct mei_fw_status fw_status;

	bool (*quirk_probe)(const struct pci_dev *pdev);

	const char *kind;

	size_t dma_size[DMA_DSCR_NUM];

	u32 fw_ver_supported:1;

	u32 hw_trc_supported:1;
@@ -76,6 +78,8 @@ struct mei_me_hw { 
 *                         with quirk for Node Manager exclusion.

 * @MEI_ME_PCH8_CFG:       Platform Controller Hub Gen8 and newer

 *                         client platforms.

 * @MEI_ME_PCH8_ITOUCH_CFG:Platform Controller Hub Gen8 and newer

 *                         client platforms (iTouch).

 * @MEI_ME_PCH8_SPS_4_CFG: Platform Controller Hub Gen8 and newer

 *                         servers platforms with quirk for

 *                         SPS firmware exclusion.
@@ -100,11 +104,12 @@ enum mei_cfg_idx { 
	MEI_ME_PCH7_CFG,

	MEI_ME_PCH_CPT_PBG_CFG,

	MEI_ME_PCH8_CFG,

	MEI_ME_PCH8_ITOUCH_CFG,

	MEI_ME_PCH8_SPS_4_CFG,

	MEI_ME_PCH12_CFG,

	MEI_ME_PCH12_SPS_4_CFG,

	MEI_ME_PCH12_SPS_CFG,

	MEI_ME_PCH12_SPS_NODMA_CFG,

	MEI_ME_PCH12_SPS_ITOUCH_CFG,

	MEI_ME_PCH15_CFG,

	MEI_ME_PCH15_SPS_CFG,

	MEI_ME_NUM_CFG,

drivers/misc/mei/main.c

+25 −0
Original line number Diff line number Diff line
@@ -885,6 +885,30 @@ void mei_set_devstate(struct mei_device *dev, enum mei_dev_state state) 
	}

}



/**

 * kind_show - display device kind

 *

 * @device: device pointer

 * @attr: attribute pointer

 * @buf: char out buffer

 *

 * Return: number of the bytes printed into buf or error

 */

static ssize_t kind_show(struct device *device,

			 struct device_attribute *attr, char *buf)

{

	struct mei_device *dev = dev_get_drvdata(device);

	ssize_t ret;



	if (dev->kind)

		ret = sprintf(buf, "%s\n", dev->kind);

	else

		ret = sprintf(buf, "%s\n", "mei");



	return ret;

}

static DEVICE_ATTR_RO(kind);



static struct attribute *mei_attrs[] = {

	&dev_attr_fw_status.attr,

	&dev_attr_hbm_ver.attr,
@@ -893,6 +917,7 @@ static struct attribute *mei_attrs[] = { 
	&dev_attr_fw_ver.attr,

	&dev_attr_dev_state.attr,

	&dev_attr_trc.attr,

	&dev_attr_kind.attr,

	NULL

};

ATTRIBUTE_GROUPS(mei);

drivers/misc/mei/mei_dev.h

+4 −0
Original line number Diff line number Diff line
@@ -445,6 +445,8 @@ struct mei_fw_version { 
 * @device_list : mei client bus list

 * @cl_bus_lock : client bus list lock

 *

 * @kind        : kind of mei device

 *

 * @dbgfs_dir   : debugfs mei root directory

 *

 * @ops:        : hw specific operations
@@ -528,6 +530,8 @@ struct mei_device { 
	struct list_head device_list;

	struct mutex cl_bus_lock;



	const char *kind;



#if IS_ENABLED(CONFIG_DEBUG_FS)

	struct dentry *dbgfs_dir;

#endif /* CONFIG_DEBUG_FS */

CRA Git | Maintained and supported by SUSTech CRA and CCSE