요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
=========================================
aty128fb - ATI Rage128 framebuffer driver
=========================================
This is a driver for a graphic framebuffer for ATI Rage128 based devices
on Intel and PPC boxes.
Advantages:
* It provides a nice large console (128 cols + 48 lines with 1024x768)
without using tiny, unreadable fonts.
* You can run XF68_FBDev on top of /dev/fb0
* Most important: boot logo :-)
Disadvantages:
* graphic mode is slower than text mode... but you should not notice
if you use same resolution as you used in textmode.
* still experimental.
How to use it?
==============
Switching modes is done using the video=aty128fb:<resolution>... modedb
boot parameter or using `fbset` program.
See Documentation/fb/modedb.rst for more information on modedb
resolutions.
You should compile in both vgacon (to boot if you remove your Rage128 from
box) and aty128fb (for graphics mode). You should not compile-in vesafb
unless you have primary display on non-Rage128 VBE2.0 device (see
Documentation/fb/vesafb.rst for details).
X11
===
XF68_FBDev should generally work fine, but it is non-accelerated. As of
this document, 8 and 32bpp works fine. There have been palette issues
when switching from X to console and back to X. You will have to restart
X to fix this.
Configuration
=============
You can pass kernel command line options to vesafb with
`video=aty128fb:option1,option2:value2,option3` (multiple options should
be separated by comma, values are separated from options by `:`).
Accepted options:
========= =======================================================
noaccel do not use acceleration engine. It is default.
accel use acceleration engine. Not finished.
vmode:x chooses PowerMacintosh video mode <x>. Deprecated.
cmode:x chooses PowerMacintosh colour mode <x>. Deprecated.
<XxX@X> selects startup videomode. See modedb.txt for detailed
explanation. Default is 640x480x8bpp.
========= =======================================================
Limitations
===========
There are known and unknown bugs, features and misfeatures.
Currently there are following known bugs:
- This driver is still experimental and is not finished. Too many
bugs/errata to list here.
Brad Douglas <brad@neruo.com>
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
ATI Rage128 framebuffer driver 개요
1-20`aty128fb`는 Intel 및 PPC system의 ATI Rage128 기반 device를 위한 graphics framebuffer driver입니다.
장점은 1024x768에서 아주 작은 font 없이도 128 column과 48 line의 큰 console을 제공하고, `/dev/fb0` 위에서 `XF68_FBDev`를 실행할 수 있으며 boot logo를 표시할 수 있다는 점입니다.
단점은 graphics mode가 text mode보다 느리다는 점이지만 같은 resolution을 사용하면 대체로 체감되지 않습니다. Driver는 아직 experimental 상태입니다.
=========================================
aty128fb - ATI Rage128 framebuffer driver
=========================================
This is a driver for a graphic framebuffer for ATI Rage128 based devices
on Intel and PPC boxes.
Advantages:
* It provides a nice large console (128 cols + 48 lines with 1024x768)
without using tiny, unreadable fonts.
* You can run XF68_FBDev on top of /dev/fb0
* Most important: boot logo :-)
Disadvantages:
* graphic mode is slower than text mode... but you should not notice
if you use same resolution as you used in textmode.
* still experimental.
Mode 선택과 kernel 구성
21-35Mode 전환은 `video=aty128fb:<resolution>...` modedb boot parameter 또는 `fbset` program으로 수행합니다. Modedb resolution에 관한 자세한 내용은 `Documentation/fb/modedb.rst`를 참조합니다.
Rage128 card를 제거한 경우에도 boot할 수 있도록 `vgacon`과 graphics mode용 `aty128fb`를 모두 built-in으로 compile하는 것이 좋습니다.
Primary display가 Rage128이 아닌 VBE 2.0 device에 연결된 경우가 아니라면 `vesafb`를 built-in으로 compile하지 않아야 합니다. 세부 내용은 `Documentation/fb/vesafb.rst`를 참조합니다.
Boot parameter 또는 runtime tool로 mode를 고릅니다.
How to use it?
==============
Switching modes is done using the video=aty128fb:<resolution>... modedb
boot parameter or using `fbset` program.
See Documentation/fb/modedb.rst for more information on modedb
resolutions.
You should compile in both vgacon (to boot if you remove your Rage128 from
box) and aty128fb (for graphics mode). You should not compile-in vesafb
unless you have primary display on non-Rage128 VBE2.0 device (see
Documentation/fb/vesafb.rst for details).
X11 사용과 palette 문제
36-45`XF68_FBDev`는 일반적으로 정상 동작하지만 acceleration은 사용하지 않습니다. 문서 작성 시점에는 8 bpp와 32 bpp가 정상 동작했습니다.
X에서 console로 전환한 뒤 다시 X로 돌아갈 때 palette 문제가 발생한 사례가 있으며, 이 경우 X를 재시작해야 복구됩니다.
X11
===
XF68_FBDev should generally work fine, but it is non-accelerated. As of
this document, 8 and 32bpp works fine. There have been palette issues
when switching from X to console and back to X. You will have to restart
X to fix this.
Command line option과 한계
46-73Kernel command line 형식은 `video=aty128fb:option1,option2:value2,option3`입니다. 여러 option은 comma로 구분하고 option과 값은 colon으로 구분합니다. 원문은 이 문장에서 vesafb에 option을 전달한다고 표현하지만 실제 parameter prefix는 `aty128fb`입니다.
`noaccel`은 acceleration engine을 사용하지 않으며 기본값입니다. `accel`은 미완성 acceleration engine을 사용합니다. `vmode:x`와 `cmode:x`는 각각 PowerMacintosh video mode와 color mode를 선택하는 deprecated option입니다.
`<XxX@X>`는 startup video mode를 선택하며 자세한 형식은 modedb 문서를 참조합니다. 기본 mode는 640x480x8bpp입니다.
Driver는 아직 experimental이며 완성되지 않았고, 열거하기 어려울 정도로 많은 알려진 bug와 errata가 있습니다.
Configuration
=============
You can pass kernel command line options to vesafb with
`video=aty128fb:option1,option2:value2,option3` (multiple options should
be separated by comma, values are separated from options by `:`).
Accepted options:
========= =======================================================
noaccel do not use acceleration engine. It is default.
accel use acceleration engine. Not finished.
vmode:x chooses PowerMacintosh video mode <x>. Deprecated.
cmode:x chooses PowerMacintosh colour mode <x>. Deprecated.
<XxX@X> selects startup videomode. See modedb.txt for detailed
explanation. Default is 640x480x8bpp.
========= =======================================================
Limitations
===========
There are known and unknown bugs, features and misfeatures.
Currently there are following known bugs:
- This driver is still experimental and is not finished. Too many
bugs/errata to list here.
Brad Douglas <brad@neruo.com>
요약·해설
aty128fb.rst:1-73`aty128fb`는 Intel/PPC의 ATI Rage128 framebuffer driver입니다. Modedb 또는 `fbset`으로 mode를 선택하고 XF68_FBDev를 사용할 수 있지만 acceleration과 palette 전환에는 experimental 제약이 있습니다.
Boot와 graphics console 구성의 핵심 순서입니다.