2020-10-09 14:11:24 +00:00
|
|
|
# SPDX-License-Identifier: GPL-2.0-only
|
|
|
|
|
#
|
|
|
|
|
# Microsoft Surface Platform-Specific Drivers
|
|
|
|
|
#
|
|
|
|
|
|
|
|
|
|
menuconfig SURFACE_PLATFORMS
|
|
|
|
|
bool "Microsoft Surface Platform-Specific Device Drivers"
|
2020-12-16 13:37:52 +00:00
|
|
|
depends on ACPI
|
2020-10-09 14:11:24 +00:00
|
|
|
default y
|
|
|
|
|
help
|
|
|
|
|
Say Y here to get to see options for platform-specific device drivers
|
|
|
|
|
for Microsoft Surface devices. This option alone does not add any
|
|
|
|
|
kernel code.
|
|
|
|
|
|
|
|
|
|
If you say N, all options in this submenu will be skipped and disabled.
|
2020-10-09 14:11:25 +00:00
|
|
|
|
|
|
|
|
if SURFACE_PLATFORMS
|
|
|
|
|
|
|
|
|
|
config SURFACE3_WMI
|
|
|
|
|
tristate "Surface 3 WMI Driver"
|
|
|
|
|
depends on ACPI_WMI
|
|
|
|
|
depends on DMI
|
|
|
|
|
depends on INPUT
|
|
|
|
|
depends on SPI
|
|
|
|
|
help
|
|
|
|
|
Say Y here if you have a Surface 3.
|
|
|
|
|
|
|
|
|
|
To compile this driver as a module, choose M here: the module will
|
|
|
|
|
be called surface3-wmi.
|
|
|
|
|
|
2020-10-09 14:11:26 +00:00
|
|
|
config SURFACE_3_BUTTON
|
|
|
|
|
tristate "Power/home/volume buttons driver for Microsoft Surface 3 tablet"
|
2020-12-16 13:37:52 +00:00
|
|
|
depends on KEYBOARD_GPIO && I2C
|
2020-10-09 14:11:26 +00:00
|
|
|
help
|
|
|
|
|
This driver handles the power/home/volume buttons on the Microsoft Surface 3 tablet.
|
|
|
|
|
|
2020-10-09 14:11:27 +00:00
|
|
|
config SURFACE_3_POWER_OPREGION
|
|
|
|
|
tristate "Surface 3 battery platform operation region support"
|
2020-12-16 13:37:52 +00:00
|
|
|
depends on I2C
|
2020-10-09 14:11:27 +00:00
|
|
|
help
|
|
|
|
|
This driver provides support for ACPI operation
|
|
|
|
|
region of the Surface 3 battery platform driver.
|
|
|
|
|
|
platform/surface: Add Surface ACPI Notify driver
The Surface ACPI Notify (SAN) device provides an ACPI interface to the
Surface Aggregator EC, specifically the Surface Serial Hub interface.
This interface allows EC requests to be made from ACPI code and can
convert a subset of EC events back to ACPI notifications.
Specifically, this interface provides a GenericSerialBus operation
region ACPI code can execute a request by writing the request command
data and payload to this operation region and reading back the
corresponding response via a write-then-read operation. Furthermore,
this interface provides a _DSM method to be called when certain events
from the EC have been received, essentially turning them into ACPI
notifications.
The driver provided in this commit essentially takes care of translating
the request data written to the operation region, executing the request,
waiting for it to finish, and finally writing and translating back the
response (if the request has one). Furthermore, this driver takes care
of enabling the events handled via ACPI _DSM calls. Lastly, this driver
also exposes an interface providing discrete GPU (dGPU) power-on
notifications on the Surface Book 2, which are also received via the
operation region interface (but not handled by the SAN driver directly),
making them accessible to other drivers (such as a dGPU hot-plug driver
that may be added later on).
On 5th and 6th generation Surface devices (Surface Pro 5/2017, Pro 6,
Book 2, Laptop 1 and 2), the SAN interface provides full battery and
thermal subsystem access, as well as other EC based functionality. On
those models, battery and thermal sensor devices are implemented as
standard ACPI devices of that type, however, forward ACPI calls to the
corresponding Surface Aggregator EC request via the SAN interface and
receive corresponding notifications (e.g. battery information change)
from it. This interface is therefore required to provide said
functionality on those devices.
Signed-off-by: Maximilian Luz <luzmaximilian@gmail.com>
Reviewed-by: Hans de Goede <hdegoede@redhat.com>
Link: https://lore.kernel.org/r/20201221183959.1186143-10-luzmaximilian@gmail.com
Signed-off-by: Hans de Goede <hdegoede@redhat.com>
2020-12-21 18:39:59 +00:00
|
|
|
config SURFACE_ACPI_NOTIFY
|
|
|
|
|
tristate "Surface ACPI Notify Driver"
|
|
|
|
|
depends on SURFACE_AGGREGATOR
|
|
|
|
|
help
|
|
|
|
|
Surface ACPI Notify (SAN) driver for Microsoft Surface devices.
|
|
|
|
|
|
|
|
|
|
This driver provides support for the ACPI interface (called SAN) of
|
|
|
|
|
the Surface System Aggregator Module (SSAM) EC. This interface is used
|
|
|
|
|
on 5th- and 6th-generation Microsoft Surface devices (including
|
|
|
|
|
Surface Pro 5 and 6, Surface Book 2, Surface Laptops 1 and 2, and in
|
|
|
|
|
reduced functionality on the Surface Laptop 3) to execute SSAM
|
|
|
|
|
requests directly from ACPI code, as well as receive SSAM events and
|
|
|
|
|
turn them into ACPI notifications. It essentially acts as a
|
|
|
|
|
translation layer between the SSAM controller and ACPI.
|
|
|
|
|
|
|
|
|
|
Specifically, this driver may be needed for battery status reporting,
|
|
|
|
|
thermal sensor access, and real-time clock information, depending on
|
|
|
|
|
the Surface device in question.
|
|
|
|
|
|
2020-12-21 18:39:58 +00:00
|
|
|
config SURFACE_AGGREGATOR_CDEV
|
|
|
|
|
tristate "Surface System Aggregator Module User-Space Interface"
|
|
|
|
|
depends on SURFACE_AGGREGATOR
|
|
|
|
|
help
|
|
|
|
|
Provides a misc-device interface to the Surface System Aggregator
|
|
|
|
|
Module (SSAM) controller.
|
|
|
|
|
|
|
|
|
|
This option provides a module (called surface_aggregator_cdev), that,
|
|
|
|
|
when loaded, will add a client device (and its respective driver) to
|
|
|
|
|
the SSAM controller. Said client device manages a misc-device
|
|
|
|
|
interface (/dev/surface/aggregator), which can be used by user-space
|
|
|
|
|
tools to directly communicate with the SSAM EC by sending requests and
|
|
|
|
|
receiving the corresponding responses.
|
|
|
|
|
|
|
|
|
|
The provided interface is intended for debugging and development only,
|
|
|
|
|
and should not be used otherwise.
|
|
|
|
|
|
platform/surface: Add Driver to set up lid GPEs on MS Surface device
Conventionally, wake-up events for a specific device, in our case the
lid device, are managed via the ACPI _PRW field. While this does not
seem strictly necessary based on ACPI spec, the kernel disables GPE
wakeups to avoid non-wakeup interrupts preventing suspend by default and
only enables GPEs associated via the _PRW field with a wake-up capable
device. This behavior has been introduced in commit f941d3e41da7 ("ACPI:
EC / PM: Disable non-wakeup GPEs for suspend-to-idle") and is described
in more detail in its commit message.
Unfortunately, on MS Surface devices, there is no _PRW field present on
the lid device, thus no GPE is associated with it, and therefore the GPE
responsible for sending the status-change notification to the lid gets
disabled during suspend, making it impossible to wake the device via the
lid.
This patch introduces a pseudo-device and respective driver which, based
on some DMI matching, marks the corresponding GPE of the lid device for
wake and enables it during suspend. The behavior of this driver models
the behavior of the ACPI/PM core for normal wakeup GPEs, properly
declared via the _PRW field.
Signed-off-by: Maximilian Luz <luzmaximilian@gmail.com>
Link: https://lore.kernel.org/r/20201028105427.1593764-1-luzmaximilian@gmail.com
Signed-off-by: Hans de Goede <hdegoede@redhat.com>
2020-10-28 10:54:27 +00:00
|
|
|
config SURFACE_GPE
|
|
|
|
|
tristate "Surface GPE/Lid Support Driver"
|
|
|
|
|
depends on DMI
|
|
|
|
|
help
|
|
|
|
|
This driver marks the GPEs related to the ACPI lid device found on
|
|
|
|
|
Microsoft Surface devices as wakeup sources and prepares them
|
|
|
|
|
accordingly. It is required on those devices to allow wake-ups from
|
|
|
|
|
suspend by opening the lid.
|
|
|
|
|
|
platform/surface: Add Surface Hot-Plug driver
Some Surface Book 2 and 3 models have a discrete GPU (dGPU) that is
hot-pluggable. On those devices, the dGPU is contained in the base,
which can be separated from the tablet part (containing CPU and
touchscreen) while the device is running.
It (in general) is presented as/behaves like a standard PCIe hot-plug
capable device, however, this device can also be put into D3cold. In
D3cold, the device itself is turned off and can thus not submit any
standard PCIe hot-plug events. To properly detect hot-(un)plugging while
the dGPU is in D3cold, out-of-band signaling is required. Without this,
the device state will only get updated during the next bus-check, eg.
via a manually issued lspci call.
This commit adds a driver to handle out-of-band PCIe hot-(un)plug events
on Microsoft Surface devices. On those devices, said events can be
detected via GPIO interrupts, which are then forwarded to the
corresponding ACPI DSM calls by this driver. The DSM then takes care of
issuing the appropriate bus-/device-check, causing the PCI core to
properly pick up the device change.
Signed-off-by: Maximilian Luz <luzmaximilian@gmail.com>
Link: https://lore.kernel.org/r/20210205012657.1951753-1-luzmaximilian@gmail.com
Signed-off-by: Hans de Goede <hdegoede@redhat.com>
2021-02-05 01:26:57 +00:00
|
|
|
config SURFACE_HOTPLUG
|
|
|
|
|
tristate "Surface Hot-Plug Driver"
|
|
|
|
|
depends on GPIOLIB
|
|
|
|
|
help
|
|
|
|
|
Driver for out-of-band hot-plug event signaling on Microsoft Surface
|
|
|
|
|
devices with hot-pluggable PCIe cards.
|
|
|
|
|
|
|
|
|
|
This driver is used on Surface Book (2 and 3) devices with a
|
|
|
|
|
hot-pluggable discrete GPU (dGPU). When not in use, the dGPU on those
|
|
|
|
|
devices can enter D3cold, which prevents in-band (standard) PCIe
|
|
|
|
|
hot-plug signaling. Thus, without this driver, detaching the base
|
|
|
|
|
containing the dGPU will not correctly update the state of the
|
|
|
|
|
corresponding PCIe device if it is in D3cold. This driver adds support
|
|
|
|
|
for out-of-band hot-plug notifications, ensuring that the device state
|
|
|
|
|
is properly updated even when the device in question is in D3cold.
|
|
|
|
|
|
|
|
|
|
Select M or Y here, if you want to (fully) support hot-plugging of
|
|
|
|
|
dGPU devices on the Surface Book 2 and/or 3 during D3cold.
|
|
|
|
|
|
2020-10-09 14:11:28 +00:00
|
|
|
config SURFACE_PRO3_BUTTON
|
|
|
|
|
tristate "Power/home/volume buttons driver for Microsoft Surface Pro 3/4 tablet"
|
2020-12-16 13:37:52 +00:00
|
|
|
depends on INPUT
|
2020-10-09 14:11:28 +00:00
|
|
|
help
|
|
|
|
|
This driver handles the power/home/volume buttons on the Microsoft Surface Pro 3/4 tablet.
|
|
|
|
|
|
platform/surface: Add Surface Aggregator subsystem
Add Surface System Aggregator Module core and Surface Serial Hub driver,
required for the embedded controller found on Microsoft Surface devices.
The Surface System Aggregator Module (SSAM, SAM or Surface Aggregator)
is an embedded controller (EC) found on 4th and later generation
Microsoft Surface devices, with the exception of the Surface Go series.
This EC provides various functionality, depending on the device in
question. This can include battery status and thermal reporting (5th and
later generations), but also HID keyboard (6th+) and touchpad input
(7th+) on Surface Laptop and Surface Book 3 series devices.
This patch provides the basic necessities for communication with the SAM
EC on 5th and later generation devices. On these devices, the EC
provides an interface that acts as serial device, called the Surface
Serial Hub (SSH). 4th generation devices, on which the EC interface is
provided via an HID-over-I2C device, are not supported by this patch.
Specifically, this patch adds a driver for the SSH device (device HID
MSHW0084 in ACPI), as well as a controller structure and associated API.
This represents the functional core of the Surface Aggregator kernel
subsystem, introduced with this patch, and will be expanded upon in
subsequent commits.
The SSH driver acts as the main attachment point for this subsystem and
sets-up and manages the controller structure. The controller in turn
provides a basic communication interface, allowing to send requests from
host to EC and receiving the corresponding responses, as well as
managing and receiving events, sent from EC to host. It is structured
into multiple layers, with the top layer presenting the API used by
other kernel drivers and the lower layers modeled after the serial
protocol used for communication.
Said other drivers are then responsible for providing the (Surface model
specific) functionality accessible through the EC (e.g. battery status
reporting, thermal information, ...) via said controller structure and
API, and will be added in future commits.
Signed-off-by: Maximilian Luz <luzmaximilian@gmail.com>
Link: https://lore.kernel.org/r/20201221183959.1186143-2-luzmaximilian@gmail.com
Signed-off-by: Hans de Goede <hdegoede@redhat.com>
2020-12-21 18:39:51 +00:00
|
|
|
source "drivers/platform/surface/aggregator/Kconfig"
|
|
|
|
|
|
2020-10-09 14:11:25 +00:00
|
|
|
endif # SURFACE_PLATFORMS
|
