← Documents Documentation/ABI/testing/debugfs-ec GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

ACPI Embedded Controller debugfs ABI

ACPI Embedded Controller에 할당된 GPE와 global lock 사용 여부, 관련 ACPI interrupt counter 및 256개 EC registers의 binary io access와 안전 경고를 설명합니다.

Source pathDocumentation/ABI/testing/debugfs-ec
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

EC GPE, global lock, binary register I/O

debugfs-ec:1-21

EC의 GPE·global lock 정보를 조회하고 ACPI GPE interrupt count를 추적할 수 있으며 binary io file로 256개 EC registers를 읽고 쓸 수 있습니다. 잘못된 write는 냉각과 fan 동작에 영향을 줄 수 있습니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/kernel/debug/ec/*/{gpe,use_global_lock,io}
2 Date: July 2010
3 Contact: Thomas Renninger <trenn@suse.de>
4 Description:
5
6 General information like which GPE is assigned to the EC and whether
7 the global lock should get used.
8 Knowing the EC GPE one can watch the amount of HW events related to
9 the EC here (XY -> GPE number from `/sys/kernel/debug/ec/*/gpe`):
10 /sys/firmware/acpi/interrupts/gpeXY
11
12 The io file is binary and a userspace tool located here:
13 ftp://ftp.suse.com/pub/people/trenn/sources/ec/
14 should get used to read out the 256 Embedded Controller registers
15 or writing to them.
16
17 CAUTION:
18 Do not write to the Embedded Controller if you don't know
19 what you are doing! Rebooting afterwards also is a good idea.
20 This can influence the way your machine is cooled and fans may
21 not get switched on again after you did a wrong write.
22

3. 한국어 전문 번역

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

Embedded Controller debugfs interface

1-21
항목내용
What/sys/kernel/debug/ec/*/{gpe,use_global_lock,io}
Date2010년 7월
ContactThomas Renninger <trenn@suse.de>

EC에 어떤 GPE가 할당되었는지, global lock을 사용해야 하는지 같은 일반 정보를 제공합니다.

EC GPE를 알면 다음 경로에서 EC와 관련된 hardware event 수를 관찰할 수 있습니다. XY는 /sys/kernel/debug/ec/*/gpe에서 읽은 GPE number입니다.

/sys/firmware/acpi/interrupts/gpeXY

io file은 binary입니다. 아래 위치의 userspace tool을 사용해 256개 Embedded Controller registers를 읽거나 써야 합니다.

주의내용
EC write무엇을 하는지 정확히 알지 못하면 Embedded Controller에 쓰지 마십시오.
Write 이후작업 뒤 reboot하는 것도 권장됩니다.
위험잘못된 write는 machine cooling 방식을 바꿀 수 있고 fan이 다시 켜지지 않을 수 있습니다.
EC debugfs 정보와 ACPI event·register 접근
/sys/kernel/debug/ec/*/gpeGPE number XY/sys/firmware/acpi/interrupts/gpeXYEC hardware event count
EC userspace toolbinary io file256 EC registers
use_global_lockGlobal lock requirement

gpe에서 number를 얻어 ACPI interrupt counter를 찾고, register I/O는 별도 userspace tool이 binary io file을 통해 수행한다.