요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
===================================
efifb - Generic EFI platform driver
===================================
This is a generic EFI platform driver for systems with UEFI firmware. The
system must be booted via the EFI stub for this to be usable. efifb supports
both firmware with Graphics Output Protocol (GOP) displays as well as older
systems with only Universal Graphics Adapter (UGA) displays.
Supported Hardware
==================
- iMac 17"/20"
- Macbook
- Macbook Pro 15"/17"
- MacMini
- ARM/ARM64/X86 systems with UEFI firmware
How to use it?
==============
For UGA displays, efifb does not have any kind of autodetection of your
machine.
You have to add the following kernel parameters in your elilo.conf::
Macbook :
video=efifb:macbook
MacMini :
video=efifb:mini
Macbook Pro 15", iMac 17" :
video=efifb:i17
Macbook Pro 17", iMac 20" :
video=efifb:i20
For GOP displays, efifb can autodetect the display's resolution and framebuffer
address, so these should work out of the box without any special parameters.
Accepted options:
======= ===========================================================
nowc Don't map the framebuffer write combined. This can be used
to workaround side-effects and slowdowns on other CPU cores
when large amounts of console data are written.
======= ===========================================================
Options for GOP displays:
mode=n
The EFI stub will set the mode of the display to mode number n if
possible.
<xres>x<yres>[-(rgb|bgr|<bpp>)]
The EFI stub will search for a display mode that matches the specified
horizontal and vertical resolution, and optionally bit depth, and set
the mode of the display to it if one is found. The bit depth can either
"rgb" or "bgr" to match specifically those pixel formats, or a number
for a mode with matching bits per pixel.
auto
The EFI stub will choose the mode with the highest resolution (product
of horizontal and vertical resolution). If there are multiple modes
with the highest resolution, it will choose one with the highest color
depth.
list
The EFI stub will list out all the display modes that are available. A
specific mode can then be chosen using one of the above options for the
next boot.
Edgar Hucek <[email protected]>
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Generic EFI framebuffer 지원 범위
1-18`efifb`는 UEFI firmware system용 generic EFI platform driver입니다. 사용하려면 system이 EFI stub을 통해 boot되어야 합니다.
Graphics Output Protocol(GOP) display와 Universal Graphics Adapter(UGA) display만 제공하는 구형 system을 모두 지원합니다.
지원 hardware 목록은 iMac 17/20 inch, Macbook, Macbook Pro 15/17 inch, MacMini, UEFI firmware를 갖춘 ARM/ARM64/X86 system입니다.
===================================
efifb - Generic EFI platform driver
===================================
This is a generic EFI platform driver for systems with UEFI firmware. The
system must be booted via the EFI stub for this to be usable. efifb supports
both firmware with Graphics Output Protocol (GOP) displays as well as older
systems with only Universal Graphics Adapter (UGA) displays.
Supported Hardware
==================
- iMac 17"/20"
- Macbook
- Macbook Pro 15"/17"
- MacMini
- ARM/ARM64/X86 systems with UEFI firmware
UGA preset, GOP autodetection과 nowc
19-45UGA display에서는 `efifb`가 machine을 자동 감지하지 못하므로 `elilo.conf`에 kernel parameter를 추가해야 합니다.
Preset은 Macbook의 `video=efifb:macbook`, MacMini의 `video=efifb:mini`, Macbook Pro 15 inch 및 iMac 17 inch의 `video=efifb:i17`, Macbook Pro 17 inch 및 iMac 20 inch의 `video=efifb:i20`입니다.
GOP display에서는 resolution과 framebuffer address를 자동 감지하므로 특별한 parameter 없이 동작해야 합니다.
`nowc` option은 framebuffer를 write-combined로 map하지 않습니다. Console data를 대량으로 쓸 때 다른 CPU core에 생기는 side effect와 slowdown을 우회하는 데 사용할 수 있습니다.
How to use it?
==============
For UGA displays, efifb does not have any kind of autodetection of your
machine.
You have to add the following kernel parameters in your elilo.conf::
Macbook :
video=efifb:macbook
MacMini :
video=efifb:mini
Macbook Pro 15", iMac 17" :
video=efifb:i17
Macbook Pro 17", iMac 20" :
video=efifb:i20
For GOP displays, efifb can autodetect the display's resolution and framebuffer
address, so these should work out of the box without any special parameters.
Accepted options:
======= ===========================================================
nowc Don't map the framebuffer write combined. This can be used
to workaround side-effects and slowdowns on other CPU cores
when large amounts of console data are written.
======= ===========================================================GOP display mode option
46-71`mode=n`은 가능할 경우 EFI stub이 display를 mode number `n`으로 설정하게 합니다.
`<xres>x<yres>[-(rgb|bgr|<bpp>)]`는 지정한 수평·수직 resolution과 선택적 bit depth가 일치하는 mode를 EFI stub이 찾아 설정하게 합니다. Bit depth 자리에는 특정 pixel format을 맞추는 `rgb` 또는 `bgr`, 아니면 bits per pixel 숫자를 사용할 수 있습니다.
`auto`는 수평과 수직 resolution의 곱이 가장 큰 mode를 선택합니다. 최고 resolution mode가 여러 개면 color depth가 가장 높은 것을 선택합니다.
`list`는 사용 가능한 모든 display mode를 출력합니다. 다음 boot에서는 출력된 목록을 바탕으로 앞의 option 중 하나를 사용해 특정 mode를 선택할 수 있습니다.
Options for GOP displays:
mode=n
The EFI stub will set the mode of the display to mode number n if
possible.
<xres>x<yres>[-(rgb|bgr|<bpp>)]
The EFI stub will search for a display mode that matches the specified
horizontal and vertical resolution, and optionally bit depth, and set
the mode of the display to it if one is found. The bit depth can either
"rgb" or "bgr" to match specifically those pixel formats, or a number
for a mode with matching bits per pixel.
auto
The EFI stub will choose the mode with the highest resolution (product
of horizontal and vertical resolution). If there are multiple modes
with the highest resolution, it will choose one with the highest color
depth.
list
The EFI stub will list out all the display modes that are available. A
specific mode can then be chosen using one of the above options for the
next boot.
Edgar Hucek <[email protected]>
요약·해설
efifb.rst:1-71`efifb`는 EFI stub으로 boot한 UEFI system의 GOP/UGA framebuffer를 제공합니다. UGA는 machine preset이 필요할 수 있고 GOP는 resolution과 address를 자동 감지하며 mode selection option을 제공합니다.