platform-driver-x86.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Shravan S <s.shravan@intel.com>
To: hdegoede@redhat.com, mgross@linux.intel.com,
	platform-driver-x86@vger.kernel.org
Cc: sudhakar.an@intel.com, s.shravan@intel.com
Subject: [PATCH V3 0/1] platform/x86: Add BIOS Dynamic SAR driver for Intel M.2 Modem
Date: Wed,  2 Jun 2021 10:31:48 +0530	[thread overview]
Message-ID: <20210602050149.6230-1-s.shravan@intel.com> (raw)

SAR (Specific Absorption Rate) driver is a host driver implemented for Linux
or chrome platform to limit the exposure of human body to RF frequency by informing
the Intel M.2 modem to regulate the RF power based on SAR data obtained from the sensors
captured in the BIOS. ACPI interface exposes this data from the BIOS to SAR driver. The
front end application in userspace ( eg: Modem Manager) will interact with SAR driver 
to obtain information like the device mode (Example: tablets, laptops, etx), Antenna index,
baseband index, SAR table index and use available communication like MBIM interface to enable
data communication to modem for RF power regulation.

The BIOS gets notified about device mode changes through Sensor Driver. This information is 
given to a (newly created) WWAN ACPI function driver when there is a device mode change. 
The driver then uses a _DSM method to retrieve the required information from BIOS. 
This information is then forwarded to the User-space using the sysfs_notify interface.
A lookup table is maintained inside the BIOS which suggests the SAR Table index and Antenna 
Tuner Table Index values for individual device modes.

The SAR parameters to be used on the Modem differs for each Regulatory Mode like FCC, CE and ISED.
Hence, the SAR parameters are stored separately in the SMBIOS table in the OEM BIOS, 
for each of the Regulatory mode. Regulatory modes will be different based on the region and network
available in that region.

Hence the entire SAR functionality handling is divided into 2 parts:

•	A ACPI function driver implemented that uses a dedicated ACPI node for WWAN device.
    Sends notifications whenever there is change in Device Mode. (each OEM has different mechanism
    of updating this DEVICE Mode info). This is notified to User-space applications using 
    the sysfs_notify interface.
•	WWAN Device Service listens for sysfs_notify messages and reads the sysfs data and routes them 
	to Modem using MBIM.


Shravan S (1):
  platform/x86: Add BIOS Dynamic SAR driver for Intel M.2 Modem

 .../networking/device_drivers/wwan/index.rst  |   9 +-
 .../device_drivers/wwan/intc_sar.rst          |  60 ++++
 drivers/platform/x86/Kconfig                  |  12 +
 drivers/platform/x86/Makefile                 |   1 +
 drivers/platform/x86/intel-sar.c              | 326 ++++++++++++++++++
 include/linux/platform_data/x86/intel-sar.h   |  89 +++++
 6 files changed, 493 insertions(+), 4 deletions(-)
 create mode 100644 Documentation/networking/device_drivers/wwan/intc_sar.rst
 create mode 100644 drivers/platform/x86/intel-sar.c
 create mode 100644 include/linux/platform_data/x86/intel-sar.h


base-commit: d936eb23874433caa3e3d841cfa16f5434b85dcf
-- 
2.17.1


             reply	other threads:[~2021-07-16 11:25 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-06-02  5:01 Shravan S [this message]
2021-06-02  5:01 ` [PATCH V3 1/1] platform/x86: Add BIOS Dynamic SAR driver for Intel M.2 Modem Shravan S
2021-08-02  8:59   ` Hans de Goede
     [not found]     ` <0126d03d-893d-3df4-67d8-586c73426f36@metux.net>
2023-03-01 15:09       ` Hans de Goede
2021-08-02 10:09   ` Hans de Goede

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20210602050149.6230-1-s.shravan@intel.com \
    --to=s.shravan@intel.com \
    --cc=hdegoede@redhat.com \
    --cc=mgross@linux.intel.com \
    --cc=platform-driver-x86@vger.kernel.org \
    --cc=sudhakar.an@intel.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).