요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Device lid, slate, and tablet posture
sysfs-bus-surface_aggregator-tabletsw:33-57Device posture는 closed·laptop·slate·tablet을 구분하며 userspace는 목록 밖 상태를 안전하게 처리해야 합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
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:
10
- "disconnected": The type-cover has been disconnected.
12
- "closed": The type-cover has been folded closed and lies on
13
top of the display.
15
- "laptop": The type-cover is open and in laptop-mode, i.e.,
16
ready for normal use.
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.
23
- "folded-back": The type cover has been fully folded back and
24
lies flush with the back side of the device.
26
- "<unknown>": The current state is unknown to the driver, for
27
example due to newer as-of-yet unsupported hardware.
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.
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:
41
- "closed": The lid of the device is closed.
43
- "laptop": The lid of the device is opened and the device
44
operates as a normal laptop.
46
- "slate": The screen covers the keyboard or has been flipped
47
back and the device operates mainly based on touch input.
49
- "tablet": The device operates as tablet and exclusively
50
relies on touch input (or external peripherals).
52
- "<unknown>": The current state is unknown to the driver, for
53
example due to newer as-of-yet unsupported hardware.
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.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Surface type-cover posture
1-32| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/surface_aggregator/devices/01:0e:01:00:01/state |
| Date | 2022년 7월 |
| KernelVersion | 5.20 |
| Contact | Maximilian Luz <luzmaximilian@gmail.com> |
| Description | Embedded controller가 알려 준 현재 type-cover 또는 device posture를 문자열로 반환합니다. |
| 반환 상태 | 한국어 전문 번역 |
|---|---|
| disconnected | Type-cover가 분리되었습니다. |
| closed | Type-cover를 닫힌 상태로 접어 display 위에 놓았습니다. |
| laptop | Type-cover가 열려 있고 laptop mode여서 일반적인 사용 준비가 된 상태입니다. |
| folded-canvas | Type-cover를 뒤쪽으로 일부 접었지만 device 뒷면에 완전히 밀착되지는 않은 상태입니다. 일반적으로 kick-stand를 사용하며 cover 위쪽으로 펼친 상태를 뜻합니다. |
| folded-back | Type-cover를 뒤로 완전히 접어 device 뒷면에 밀착시킨 상태입니다. |
| <unknown> | 아직 지원하지 않는 새 hardware 등의 이유로 driver가 현재 상태를 알지 못합니다. |
새 hardware에서 새 상태가 추가될 수 있습니다. 따라서 userspace는 이 상태 목록이 완전하다고 가정해서는 안 되며 알 수 없는 상태를 정상적으로 처리해야 합니다.
Surface device posture
33-57| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/surface_aggregator/devices/01:26:01:00:01/state |
| Date | 2022년 7월 |
| KernelVersion | 5.20 |
| Contact | Maximilian Luz <luzmaximilian@gmail.com> |
| Description | Embedded controller가 알려 준 현재 device posture를 문자열로 반환합니다. |
| 반환 상태 | 한국어 전문 번역 |
|---|---|
| closed | Device의 lid가 닫힌 상태입니다. |
| laptop | Device lid가 열려 있고 일반 laptop으로 동작하는 상태입니다. |
| slate | Screen이 keyboard를 덮거나 뒤로 뒤집혀 device가 주로 touch input으로 동작하는 상태입니다. |
| tablet | Device가 tablet으로 동작하며 touch input 또는 외부 peripheral에만 의존하는 상태입니다. |
| <unknown> | 아직 지원하지 않는 새 hardware 등의 이유로 driver가 현재 상태를 알지 못합니다. |
새 hardware에서 새 상태가 추가될 수 있습니다. 따라서 userspace는 이 상태 목록이 완전하다고 가정해서는 안 되며 알 수 없는 상태를 정상적으로 처리해야 합니다.
Type-cover fold and attachment posture
sysfs-bus-surface_aggregator-tabletsw:1-32Type-cover는 분리·닫힘·laptop·부분 접힘·완전 접힘 상태를 구분하며 새로운 unknown 상태도 허용합니다.