Linux 6.7-rc7
[linux-modified.git] / Documentation / ABI / testing / sysfs-bus-surface_aggregator-tabletsw
1 What:           /sys/bus/surface_aggregator/devices/01:0e:01:00:01/state
2 Date:           July 2022
3 KernelVersion:  5.20
4 Contact:        Maximilian Luz <luzmaximilian@gmail.com>
5 Description:
6                 This attribute returns a string with the current type-cover
7                 or device posture, as indicated by the embedded controller.
8                 Currently returned posture states are:
9
10                 - "disconnected": The type-cover has been disconnected.
11
12                 - "closed": The type-cover has been folded closed and lies on
13                   top of the display.
14
15                 - "laptop": The type-cover is open and in laptop-mode, i.e.,
16                   ready for normal use.
17
18                 - "folded-canvas": The type-cover has been folded back
19                   part-ways, but does not lie flush with the back side of the
20                   device. In general, this means that the kick-stand is used
21                   and extended atop of the cover.
22
23                 - "folded-back": The type cover has been fully folded back and
24                   lies flush with the back side of the device.
25
26                 - "<unknown>": The current state is unknown to the driver, for
27                   example due to newer as-of-yet unsupported hardware.
28
29                 New states may be introduced with new hardware. Users therefore
30                 must not rely on this list of states being exhaustive and
31                 gracefully handle unknown states.
32
33 What:           /sys/bus/surface_aggregator/devices/01:26:01:00:01/state
34 Date:           July 2022
35 KernelVersion:  5.20
36 Contact:        Maximilian Luz <luzmaximilian@gmail.com>
37 Description:
38                 This attribute returns a string with the current device posture, as indicated by the embedded controller. Currently
39                 returned posture states are:
40
41                 - "closed": The lid of the device is closed.
42
43                 - "laptop": The lid of the device is opened and the device
44                   operates as a normal laptop.
45
46                 - "slate": The screen covers the keyboard or has been flipped
47                   back and the device operates mainly based on touch input.
48
49                 - "tablet": The device operates as tablet and exclusively
50                   relies on touch input (or external peripherals).
51
52                 - "<unknown>": The current state is unknown to the driver, for
53                   example due to newer as-of-yet unsupported hardware.
54
55                 New states may be introduced with new hardware. Users therefore
56                 must not rely on this list of states being exhaustive and
57                 gracefully handle unknown states.