aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/ABI/testing/sysfs-bus-surface_aggregator-tabletsw
blob: 74cd9d754e60b8e5f1da5f323c1b9ea76fec8531 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
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.