← Documents Documentation/ABI/stable/sysfs-class-backlight GitHub 원문 ↗

Linux 6.18.37 · ABI / stable

Backlight class stable sysfs ABI

Backlight power, 설정·실제·최대 brightness와 firmware·platform·raw control interface type 및 선택 우선순위를 설명합니다.

Source pathDocumentation/ABI/stable/sysfs-class-backlight
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

Power와 brightness

sysfs-class-backlight:1-43

FB_BLANK 호환 power 값과 driver 저장 brightness, hardware actual brightness, 최대 범위를 다룹니다.

Control interface type

sysfs-class-backlight:45-63

동일 device에 여러 interface가 있으면 firmware, platform, raw 순서로 선호합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/class/backlight/<backlight>/bl_power
2 Date: April 2005
3 KernelVersion: 2.6.12
4 Contact: Richard Purdie <rpurdie@rpsys.net>
5 Description:
6 Control BACKLIGHT power, values are compatible with
7 FB_BLANK_* from fb.h
8
9 - 0 (FB_BLANK_UNBLANK) : power on.
10 - 4 (FB_BLANK_POWERDOWN) : power off
11 Users: HAL
12
13 What: /sys/class/backlight/<backlight>/brightness
14 Date: April 2005
15 KernelVersion: 2.6.12
16 Contact: Richard Purdie <rpurdie@rpsys.net>
17 Description:
18 Control the brightness for this <backlight>. Values
19 are between 0 and max_brightness. This file will also
20 show the brightness level stored in the driver, which
21 may not be the actual brightness (see actual_brightness).
22 Users: HAL
23
24 What: /sys/class/backlight/<backlight>/actual_brightness
25 Date: March 2006
26 KernelVersion: 2.6.17
27 Contact: Richard Purdie <rpurdie@rpsys.net>
28 Description:
29 Show the actual brightness by querying the hardware. Due
30 to implementation differences in hardware this may not
31 match the value in 'brightness'. For example some hardware
32 may treat blanking differently or have custom power saving
33 features. Userspace should generally use the values in
34 'brightness' to make decisions.
35 Users: HAL
36
37 What: /sys/class/backlight/<backlight>/max_brightness
38 Date: April 2005
39 KernelVersion: 2.6.12
40 Contact: Richard Purdie <rpurdie@rpsys.net>
41 Description:
42 Maximum brightness for <backlight>.
43 Users: HAL
44
45 What: /sys/class/backlight/<backlight>/type
46 Date: September 2010
47 KernelVersion: 2.6.37
48 Contact: Matthew Garrett <mjg@redhat.com>
49 Description:
50 The type of interface controlled by <backlight>.
51 "firmware": The driver uses a standard firmware interface
52 "platform": The driver uses a platform-specific interface
53 "raw": The driver controls hardware registers directly
54
55 In the general case, when multiple backlight
56 interfaces are available for a single device, firmware
57 control should be preferred to platform control should
58 be preferred to raw control. Using a firmware
59 interface reduces the probability of confusion with
60 the hardware and the OS independently updating the
61 backlight state. Platform interfaces are mostly a
62 holdover from pre-standardisation of firmware
63 interfaces.
64

3. 한국어 전문 번역

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

Backlight power와 brightness

1-43

아래 attribute는 HAL이 사용하며 담당자는 Richard Purdie <rpurdie@rpsys.net>다.

경로도입의미
/sys/class/backlight/<backlight>/bl_power2005년 4월 · kernel 2.6.12BACKLIGHT power를 제어하며 값은 fb.h의 FB_BLANK_*와 호환된다. 0(FB_BLANK_UNBLANK)은 power on, 4(FB_BLANK_POWERDOWN)는 power off다.
/sys/class/backlight/<backlight>/brightness2005년 4월 · kernel 2.6.120부터 max_brightness 사이 값으로 backlight brightness를 제어한다. 읽으면 driver에 저장된 level을 표시하며 실제 brightness와 다를 수 있다.
/sys/class/backlight/<backlight>/actual_brightness2006년 3월 · kernel 2.6.17Hardware를 조회해 실제 brightness를 표시한다. Hardware별 blanking 처리나 고유 power-saving 기능 때문에 brightness 값과 다를 수 있다. User space는 일반적으로 판단에 brightness 값을 사용해야 한다.
/sys/class/backlight/<backlight>/max_brightness2005년 4월 · kernel 2.6.12해당 backlight의 최대 brightness다.

Backlight control interface type

45-63
항목값
What/sys/class/backlight/<backlight>/type
Date2010년 9월
KernelVersion2.6.37
ContactMatthew Garrett <mjg@redhat.com>
값Driver 제어 방식
firmware표준 firmware interface를 사용한다.
platformplatform별 고유 interface를 사용한다.
rawhardware register를 직접 제어한다.

일반적으로 device 하나에 여러 backlight interface가 있으면 firmware control을 platform control보다, platform control을 raw control보다 우선해야 한다. Firmware interface를 쓰면 hardware와 OS가 각각 backlight state를 갱신해 혼란이 생길 가능성을 줄인다. Platform interface는 대체로 firmware interface 표준화 이전의 유산이다.