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