Documentation/ABI/testing/sysfs-driver-intc_sar

   1 What:           /sys/bus/platform/devices/INTC1092:00/intc_reg
   2 Date:           August 2021
   3 KernelVersion:  5.15
   4 Contact:        Shravan S <s.shravan@intel.com>,
   5                 An Sudhakar <sudhakar.an@intel.com>
   6 Description:
   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
  26 What:           /sys/bus/platform/devices/INTC1092:00/intc_data
  27 Date:           August 2021
  28 KernelVersion:  5.15
  29 Contact:        Shravan S <s.shravan@intel.com>,
  30                 An Sudhakar <sudhakar.an@intel.com>
  31 Description:
  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.