xref: /linux/Documentation/ABI/testing/sysfs-bus-surface_aggregator-tabletsw (revision 24168c5e6dfbdd5b414f048f47f75d64533296ca)
1What:		/sys/bus/surface_aggregator/devices/01:0e:01:00:01/state
2Date:		July 2022
3KernelVersion:	5.20
4Contact:	Maximilian Luz <luzmaximilian@gmail.com>
5Description:
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
33What:		/sys/bus/surface_aggregator/devices/01:26:01:00:01/state
34Date:		July 2022
35KernelVersion:	5.20
36Contact:	Maximilian Luz <luzmaximilian@gmail.com>
37Description:
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.
58