xref: /linux/Documentation/ABI/testing/sysfs-driver-intc_sar (revision c532de5a67a70f8533d495f8f2aaa9a0491c3ad0)
1What:		/sys/bus/platform/devices/INTC1092:00/intc_reg
2Date:		August 2021
3KernelVersion:	5.15
4Contact:	Shravan S <s.shravan@intel.com>,
5		An Sudhakar <sudhakar.an@intel.com>
6Description:
7		Specific Absorption Rate (SAR) regulatory mode is typically
8		derived based on information like mcc (Mobile Country Code) and
9		mnc (Mobile Network Code) that is available for the currently
10		attached LTE network. A userspace application is required to set
11		the current SAR regulatory mode on the Dynamic SAR driver using
12		this sysfs node. Such an application can also read back using
13		this sysfs node, the currently configured regulatory mode value
14		from the Dynamic SAR driver.
15
16		Acceptable regulatory modes are:
17			==	====
18			0	FCC
19			1	CE
20			2	ISED
21			==	====
22
23		- The regulatory mode value has one of the above values.
24		- The default regulatory mode used in the driver is 0.
25
26What:		/sys/bus/platform/devices/INTC1092:00/intc_data
27Date:		August 2021
28KernelVersion:	5.15
29Contact:	Shravan S <s.shravan@intel.com>,
30		An Sudhakar <sudhakar.an@intel.com>
31Description:
32		This sysfs entry is used to retrieve Dynamic SAR information
33		emitted/maintained by a BIOS that supports Dynamic SAR.
34
35		The retrieved information is in the order given below:
36		- device_mode
37		- bandtable_index
38		- antennatable_index
39		- sartable_index
40
41		The above information is sent as integer values separated
42		by a single space. This information can then be pushed to a
43		WWAN modem that uses this to control the transmit signal
44		level using the Band/Antenna/SAR table index information.
45		These parameters are derived/decided by aggregating
46		device-mode like laptop/tablet/clamshell etc. and the
47		proximity-sensor data available to the embedded controller on
48		given host. The regulatory mode configured on Dynamic SAR
49		driver also influences these values.
50
51		The userspace applications can poll for changes to this file
52		using POLLPRI event on file-descriptor (fd) obtained by opening
53		this sysfs entry. Application can then read this information from
54		the sysfs node and consume the given information.
55