mirror of
https://github.com/torvalds/linux
synced 2024-07-22 11:10:46 +00:00
9f794056db
Add a driver providing a tablet-mode switch input device for Microsoft Surface devices using the Surface Aggregator KIP subsystem (to manage detachable peripherals) or POS subsystem (to obtain device posture information). The KIP (full name unknown, abbreviation found through reverse engineering) subsystem is used on the Surface Pro 8 and Surface Pro X to manage the keyboard cover. Among other things, it provides information on the positioning (posture) of the cover (closed, laptop-style, detached, folded-back, ...), which can be used to implement an input device providing the SW_TABLET_MODE event. Similarly, the POS (posture information) subsystem provides such information on the Surface Laptop Studio, with the difference being that the keyboard is not detachable. As implementing the tablet-mode switch for both subsystems is largely similar, the driver proposed in this commit, in large, acts as a generic tablet mode switch driver framework for the Surface Aggregator Module. Specific implementations using this framework are provided for the KIP and POS subsystems, adding tablet-mode switch support to the aforementioned devices. A few more notes on the Surface Laptop Studio: A peculiarity of the Surface Laptop Studio is its "slate/tent" mode (symbolized: user> _/\). In this mode, the screen covers the keyboard but leaves the touchpad exposed. This is essentially a mode in-between tablet and laptop, and it is debatable whether tablet-mode should be enabled in this mode. We therefore let the user decide this via a module parameter. In particular, tablet-mode may bring up the on-screen touch keyboard more easily, which would be desirable in this mode. However, some user-space software currently also decides to disable keyboard and, more importantly, touchpad input, while the touchpad is still accessible in the "slate/tent" mode. Furthermore, this mode shares its identifier with "slate/flipped" mode where the screen is flipped 180° and the keyboard points away from the user (symbolized: user> /_). In this mode we would like to enable auto-rotation, something that user-space software may only do when tablet-mode is enabled. We therefore default to the slate-mode enabling the tablet-mode switch. Signed-off-by: Maximilian Luz <luzmaximilian@gmail.com> Link: https://lore.kernel.org/r/20220624183642.910893-3-luzmaximilian@gmail.com Reviewed-by: Hans de Goede <hdegoede@redhat.com> Signed-off-by: Hans de Goede <hdegoede@redhat.com>
58 lines
2.1 KiB
Plaintext
58 lines
2.1 KiB
Plaintext
What: /sys/bus/surface_aggregator/devices/01:0e:01:00:01/state
|
|
Date: July 2022
|
|
KernelVersion: 5.20
|
|
Contact: Maximilian Luz <luzmaximilian@gmail.com>
|
|
Description:
|
|
This attribute returns a string with the current type-cover
|
|
or device posture, as indicated by the embedded controller.
|
|
Currently returned posture states are:
|
|
|
|
- "disconnected": The type-cover has been disconnected.
|
|
|
|
- "closed": The type-cover has been folded closed and lies on
|
|
top of the display.
|
|
|
|
- "laptop": The type-cover is open and in laptop-mode, i.e.,
|
|
ready for normal use.
|
|
|
|
- "folded-canvas": The type-cover has been folded back
|
|
part-ways, but does not lie flush with the back side of the
|
|
device. In general, this means that the kick-stand is used
|
|
and extended atop of the cover.
|
|
|
|
- "folded-back": The type cover has been fully folded back and
|
|
lies flush with the back side of the device.
|
|
|
|
- "<unknown>": The current state is unknown to the driver, for
|
|
example due to newer as-of-yet unsupported hardware.
|
|
|
|
New states may be introduced with new hardware. Users therefore
|
|
must not rely on this list of states being exhaustive and
|
|
gracefully handle unknown states.
|
|
|
|
What: /sys/bus/surface_aggregator/devices/01:26:01:00:01/state
|
|
Date: July 2022
|
|
KernelVersion: 5.20
|
|
Contact: Maximilian Luz <luzmaximilian@gmail.com>
|
|
Description:
|
|
This attribute returns a string with the current device posture, as indicated by the embedded controller. Currently
|
|
returned posture states are:
|
|
|
|
- "closed": The lid of the device is closed.
|
|
|
|
- "laptop": The lid of the device is opened and the device
|
|
operates as a normal laptop.
|
|
|
|
- "slate": The screen covers the keyboard or has been flipped
|
|
back and the device operates mainly based on touch input.
|
|
|
|
- "tablet": The device operates as tablet and exclusively
|
|
relies on touch input (or external peripherals).
|
|
|
|
- "<unknown>": The current state is unknown to the driver, for
|
|
example due to newer as-of-yet unsupported hardware.
|
|
|
|
New states may be introduced with new hardware. Users therefore
|
|
must not rely on this list of states being exhaustive and
|
|
gracefully handle unknown states.
|