← Documents Documentation/ABI/testing/sysfs-devices-platform-ACPI-TAD GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

ACPI Time and Alarm device sysfs ABI

ACPI TAD capability bitmask, AC/DC alarm timer·wake policy·status와 S3/S4/S5 wakeup 및 explicit status clear 동작을 설명합니다.

Source pathDocumentation/ABI/testing/sysfs-devices-platform-ACPI-TAD
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

Firmware-reported capabilities

sysfs-devices-platform-ACPI-TAD:1-23

caps는 AC/DC wakeup, real-time access·accuracy, S4/S5 status와 timer wake support를 firmware bitmask로 제공합니다.

AC alarm value and policy

sysfs-devices-platform-ACPI-TAD:24-56

ac_alarm은 timer seconds 또는 disabled를, ac_policy는 DC power일 때 expired AC wakeup을 지연하거나 버리는 정책을 관리합니다.

Alarm status and explicit clearing

sysfs-devices-platform-ACPI-TAD:57-84

ac_status는 expiry와 sleep-state wakeup bit를 반환하고 read 또는 0 write로 clear되며, clear 전까지 expired timer가 즉시 wakeup을 유발합니다.

Optional separate DC timer

sysfs-devices-platform-ACPI-TAD:85-117

TAD가 별도 DC timer를 지원하면 dc_alarm·dc_policy·dc_status가 나타나며 각각 AC counterpart와 같은 semantics를 사용합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 ACPI Time and Alarm (TAD) device attributes.
2
3 What: /sys/bus/platform/devices/ACPI000E:00/caps
4 Date: March 2018
5 Contact: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
6 Description:
7 (RO) Hexadecimal bitmask of the TAD attributes are reported by
8 the platform firmware (see ACPI 6.2, section 9.18.2):
9
10 ======= ======================================================
11 BIT(0): AC wakeup implemented if set
12 BIT(1): DC wakeup implemented if set
13 BIT(2): Get/set real time features implemented if set
14 BIT(3): Real time accuracy in milliseconds if set
15 BIT(4): Correct status reported for wakeups from S4/S5 if set
16 BIT(5): The AC timer wakes up from S4 if set
17 BIT(6): The AC timer wakes up from S5 if set
18 BIT(7): The DC timer wakes up from S4 if set
19 BIT(8): The DC timer wakes up from S5 if set
20 ======= ======================================================
21
22 The other bits are reserved.
23
24 What: /sys/bus/platform/devices/ACPI000E:00/ac_alarm
25 Date: March 2018
26 Contact: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
27 Description:
28 (RW) The AC alarm timer value.
29
30 Reads return the current AC alarm timer value in seconds or
31 "disabled", if the AC alarm is not set to wake up the system.
32
33 Write a new AC alarm timer value in seconds or "disabled" to it
34 to set the AC alarm timer or to disable it, respectively.
35
36 If the AC alarm timer is set through this attribute and it
37 expires, it will immediately wake up the system from the S3
38 sleep state (and from S4/S5 too if supported) until its status
39 is explicitly cleared via the ac_status attribute.
40
41 What: /sys/bus/platform/devices/ACPI000E:00/ac_policy
42 Date: March 2018
43 Contact: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
44 Description:
45 (RW) The AC alarm expired timer wake policy (see ACPI 6.2,
46 Section 9.18 for details).
47
48 Reads return the current expired timer wake delay for the AC
49 alarm timer or "never", if the policy is to discard AC timer
50 wakeups if the system is on DC power.
51
52 Write a new expired timer wake delay for the AC alarm timer in
53 seconds or "never" to it to set the expired timer wake delay for
54 the AC alarm timer or to set its expired wake policy to discard
55 wakeups if the system is on DC power, respectively.
56
57 What: /sys/bus/platform/devices/ACPI000E:00/ac_status
58 Date: March 2018
59 Contact: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
60 Description:
61 (RW) The AC alarm status.
62
63 Reads return a hexadecimal bitmask representing the AC alarm
64 timer status with the following meaning of bits (see ACPI 6.2,
65 Section 9.18.5):
66
67 ======= ======================================================
68 Bit(0): The timer has expired if set.
69 Bit(1): The timer has woken up the system from a sleep state
70 (S3 or S4/S5 if supported) if set.
71 ======= ======================================================
72
73 The other bits are reserved.
74
75 Reads also cause the AC alarm timer status to be reset.
76
77 Another way to reset the status of the AC alarm timer is to
78 write (the number) 0 to this file.
79
80 If the status return value indicates that the timer has expired,
81 it will immediately wake up the system from the S3 sleep state
82 (and from S4/S5 too if supported) until its status is explicitly
83 cleared through this attribute.
84
85 What: /sys/bus/platform/devices/ACPI000E:00/dc_alarm
86 Date: March 2018
87 Contact: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
88 Description:
89 (RW,optional) The DC alarm timer value.
90
91 This attribute is only present if the TAD supports a separate
92 DC timer.
93
94 It is analogous to the ac_alarm attribute.
95
96 What: /sys/bus/platform/devices/ACPI000E:00/dc_policy
97 Date: March 2018
98 Contact: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
99 Description:
100 (RW,optional) The DC alarm expired timer wake policy.
101
102 This attribute is only present if the TAD supports a separate
103 DC timer.
104
105 It is analogous to the ac_policy attribute.
106
107 What: /sys/bus/platform/devices/ACPI000E:00/dc_status
108 Date: March 2018
109 Contact: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
110
111 Description:
112 (RW,optional) The DC alarm status.
113
114 This attribute is only present if the TAD supports a separate
115 DC timer.
116
117 It is analogous to the ac_status attribute.
118

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

TAD capability bitmask

1-23
항목한국어 전문 번역
What/sys/bus/platform/devices/ACPI000E:00/caps
Date2018년 3월
ContactRafael J. Wysocki <rafael.j.wysocki@intel.com>
Description(RO) Platform firmware가 보고한 TAD attribute의 hexadecimal bitmask입니다(ACPI 6.2 section 9.18.2). 아래 bit 외의 bit는 reserved입니다.
TAD capability bits
BitSet일 때 의미
BIT(0)AC wakeup 구현
BIT(1)DC wakeup 구현
BIT(2)Real time get/set feature 구현
BIT(3)Real time accuracy를 milliseconds로 제공
BIT(4)S4/S5 wakeup의 correct status 보고
BIT(5)AC timer가 S4에서 wakeup
BIT(6)AC timer가 S5에서 wakeup
BIT(7)DC timer가 S4에서 wakeup
BIT(8)DC timer가 S5에서 wakeup

Set된 각 bit가 firmware에서 구현되었다고 표시하는 기능입니다.

AC alarm timer value

24-40
항목한국어 전문 번역
What/sys/bus/platform/devices/ACPI000E:00/ac_alarm
Date2018년 3월
ContactRafael J. Wysocki <rafael.j.wysocki@intel.com>
Description(RW) AC alarm timer 값입니다. Read는 현재 값을 seconds 단위로 반환하며 system wakeup용 AC alarm이 설정되지 않았으면 "disabled"를 반환합니다. 새 seconds 값 또는 "disabled"를 write하여 각각 timer를 설정하거나 비활성화합니다. 이 attribute로 설정한 AC alarm이 만료되면 ac_status로 status를 명시적으로 clear할 때까지 system을 S3에서 즉시 깨우며, 지원되는 경우 S4/S5에서도 깨웁니다.
AC alarm wake and clear lifecycle
ac_alarm에 seconds writeTimer expiresS3, supported S4/S5 wakeupac_status read 또는 0 writeExpired status cleared

Expired timer는 status가 남아 있는 동안 sleep entry에서 즉시 wakeup을 유발합니다.

AC expired-timer wake policy

41-56
항목한국어 전문 번역
What/sys/bus/platform/devices/ACPI000E:00/ac_policy
Date2018년 3월
ContactRafael J. Wysocki <rafael.j.wysocki@intel.com>
Description(RW) AC alarm의 expired timer wake policy입니다(ACPI 6.2 section 9.18). Read는 현재 expired-timer wake delay를 반환합니다. System이 DC power인 경우 AC timer wakeup을 버리는 정책이면 "never"를 반환합니다. 새 delay seconds 또는 "never"를 write하여 각각 AC alarm의 expired wake delay를 설정하거나 DC power 상태에서 wakeup을 버리도록 설정합니다.
AC alarm value and policy writes
AttributeNumeric writeKeyword write
ac_alarmAlarm value in secondsdisabled
ac_policyExpired wake delay in secondsnever

Timer 자체와 expired wake policy는 별도 attribute로 설정합니다.

AC alarm status and reset

57-84
항목한국어 전문 번역
What/sys/bus/platform/devices/ACPI000E:00/ac_status
Date2018년 3월
ContactRafael J. Wysocki <rafael.j.wysocki@intel.com>
Description(RW) AC alarm status입니다. Read는 ACPI 6.2 section 9.18.5의 bit 의미를 따르는 hexadecimal bitmask를 반환하며, 동시에 AC alarm timer status를 reset합니다. 숫자 0을 write하는 것도 status를 reset하는 방법입니다. 반환 status가 timer expiry를 나타내면 이 attribute로 status를 명시적으로 clear할 때까지 S3에서 system을 즉시 깨우고, 지원되는 경우 S4/S5에서도 깨웁니다. 정의된 bit 외의 bit는 reserved입니다.
AC alarm status bits
BitSet일 때 의미
Bit(0)Timer가 만료됨
Bit(1)Timer가 S3 또는 supported S4/S5에서 system을 깨움

Read 결과의 두 defined status bit입니다.

Status-reset paths
ac_status contains status bitsRead ac_status 또는 write numeric 0AC alarm timer status reset

두 operation 모두 expired/wakeup status를 clear합니다.

Optional DC alarm timer

85-95
항목한국어 전문 번역
What/sys/bus/platform/devices/ACPI000E:00/dc_alarm
Date2018년 3월
ContactRafael J. Wysocki <rafael.j.wysocki@intel.com>
Description(RW, optional) DC alarm timer 값입니다. TAD가 별도 DC timer를 지원할 때만 존재하며 ac_alarm attribute와 같습니다.

Optional DC wake policy

96-106
항목한국어 전문 번역
What/sys/bus/platform/devices/ACPI000E:00/dc_policy
Date2018년 3월
ContactRafael J. Wysocki <rafael.j.wysocki@intel.com>
Description(RW, optional) DC alarm의 expired timer wake policy입니다. TAD가 별도 DC timer를 지원할 때만 존재하며 ac_policy attribute와 같습니다.

Optional DC alarm status

107-117
항목한국어 전문 번역
What/sys/bus/platform/devices/ACPI000E:00/dc_status
Date2018년 3월
ContactRafael J. Wysocki <rafael.j.wysocki@intel.com>
Description(RW, optional) DC alarm status입니다. TAD가 별도 DC timer를 지원할 때만 존재하며 ac_status attribute와 같습니다.
Optional DC timer counterparts
DC attributeAC counterpart
dc_alarmac_alarm
dc_policyac_policy
dc_statusac_status

Separate DC timer를 지원할 때만 세 attribute가 나타납니다.