요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
========================================
arkfb - fbdev driver for ARK Logic chips
========================================
Supported Hardware
==================
ARK 2000PV chip
ICS 5342 ramdac
- only BIOS initialized VGA devices supported
- probably not working on big endian
Supported Features
==================
* 4 bpp pseudocolor modes (with 18bit palette, two variants)
* 8 bpp pseudocolor mode (with 18bit palette)
* 16 bpp truecolor modes (RGB 555 and RGB 565)
* 24 bpp truecolor mode (RGB 888)
* 32 bpp truecolor mode (RGB 888)
* text mode (activated by bpp = 0)
* doublescan mode variant (not available in text mode)
* panning in both directions
* suspend/resume support
Text mode is supported even in higher resolutions, but there is limitation to
lower pixclocks (i got maximum about 70 MHz, it is dependent on specific
hardware). This limitation is not enforced by driver. Text mode supports 8bit
wide fonts only (hardware limitation) and 16bit tall fonts (driver
limitation). Unfortunately character attributes (like color) in text mode are
broken for unknown reason, so its usefulness is limited.
There are two 4 bpp modes. First mode (selected if nonstd == 0) is mode with
packed pixels, high nibble first. Second mode (selected if nonstd == 1) is mode
with interleaved planes (1 byte interleave), MSB first. Both modes support
8bit wide fonts only (driver limitation).
Suspend/resume works on systems that initialize video card during resume and
if device is active (for example used by fbcon).
Missing Features
================
(alias TODO list)
* secondary (not initialized by BIOS) device support
* big endian support
* DPMS support
* MMIO support
* interlaced mode variant
* support for fontwidths != 8 in 4 bpp modes
* support for fontheight != 16 in text mode
* hardware cursor
* vsync synchronization
* feature connector support
* acceleration support (8514-like 2D)
Known bugs
==========
* character attributes (and cursor) in text mode are broken
--
Ondrej Zajicek <santiago@crfreenet.org>
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
ARK Logic 지원 hardware
1-14`arkfb`는 ARK Logic chip용 fbdev driver입니다. 지원 조합은 `ARK 2000PV` chip과 `ICS 5342` RAMDAC입니다.
BIOS가 초기화한 VGA device만 지원하며 big-endian system에서는 동작하지 않을 가능성이 있습니다.
========================================
arkfb - fbdev driver for ARK Logic chips
========================================
Supported Hardware
==================
ARK 2000PV chip
ICS 5342 ramdac
- only BIOS initialized VGA devices supported
- probably not working on big endian
지원 mode와 동작 제약
15-44지원 기능은 18-bit palette를 쓰는 두 종류의 4 bpp pseudocolor, 18-bit palette의 8 bpp pseudocolor, RGB 555/565의 16 bpp truecolor, RGB 888의 24/32 bpp truecolor, `bpp=0`으로 활성화하는 text mode입니다.
Doublescan mode는 text mode에서는 사용할 수 없습니다. 수평·수직 panning과 suspend/resume도 지원합니다.
Text mode는 높은 resolution에서도 가능하지만 pixel clock이 낮아야 하며, 작성자가 확인한 최대값은 hardware에 따라 약 70 MHz였습니다. Driver는 이 한계를 강제하지 않습니다. Hardware 제약으로 font width는 8 bit만, driver 제약으로 font height는 16 bit만 지원합니다. Character color 같은 attribute가 알 수 없는 이유로 깨져 실용성이 제한됩니다.
4 bpp에는 두 mode가 있습니다. `nonstd==0`은 high nibble first인 packed pixel mode이고, `nonstd==1`은 1-byte interleave와 MSB first를 쓰는 interleaved plane mode입니다. 두 mode 모두 driver 제약으로 8-bit wide font만 지원합니다.
Suspend/resume은 resume 중 system이 video card를 초기화하고 device가 활성 상태일 때, 예를 들어 `fbcon`에서 사용 중일 때 동작합니다.
Supported Features
==================
* 4 bpp pseudocolor modes (with 18bit palette, two variants)
* 8 bpp pseudocolor mode (with 18bit palette)
* 16 bpp truecolor modes (RGB 555 and RGB 565)
* 24 bpp truecolor mode (RGB 888)
* 32 bpp truecolor mode (RGB 888)
* text mode (activated by bpp = 0)
* doublescan mode variant (not available in text mode)
* panning in both directions
* suspend/resume support
Text mode is supported even in higher resolutions, but there is limitation to
lower pixclocks (i got maximum about 70 MHz, it is dependent on specific
hardware). This limitation is not enforced by driver. Text mode supports 8bit
wide fonts only (hardware limitation) and 16bit tall fonts (driver
limitation). Unfortunately character attributes (like color) in text mode are
broken for unknown reason, so its usefulness is limited.
There are two 4 bpp modes. First mode (selected if nonstd == 0) is mode with
packed pixels, high nibble first. Second mode (selected if nonstd == 1) is mode
with interleaved planes (1 byte interleave), MSB first. Both modes support
8bit wide fonts only (driver limitation).
Suspend/resume works on systems that initialize video card during resume and
if device is active (for example used by fbcon).
미구현 기능과 알려진 문제
45-68미구현 목록에는 BIOS가 초기화하지 않은 secondary device, big-endian, DPMS, MMIO, interlaced mode, 4 bpp에서 width 8 이외 font, text mode에서 height 16 이외 font, hardware cursor, vsync synchronization, feature connector, 8514 계열 2D acceleration 지원이 포함됩니다.
알려진 bug는 text mode에서 character attribute와 cursor가 깨지는 문제입니다.
문서 작성자는 Ondrej Zajicek입니다.
Missing Features
================
(alias TODO list)
* secondary (not initialized by BIOS) device support
* big endian support
* DPMS support
* MMIO support
* interlaced mode variant
* support for fontwidths != 8 in 4 bpp modes
* support for fontheight != 16 in text mode
* hardware cursor
* vsync synchronization
* feature connector support
* acceleration support (8514-like 2D)
Known bugs
==========
* character attributes (and cursor) in text mode are broken
--
Ondrej Zajicek <santiago@crfreenet.org>
요약·해설
arkfb.rst:1-68`arkfb`는 ARK 2000PV와 ICS 5342 조합의 BIOS-initialized VGA를 지원합니다. 여러 pseudocolor/truecolor mode와 text mode를 제공하지만 console attribute, endian, DPMS, acceleration 등에 제약이 있습니다.