Documentation/fb/arkfb.rst GitHub 원문 ↗

Linux 6.18.37 · Frame Buffer

arkfb - fbdev driver for ARK Logic chips

ARK Logic framebuffer의 지원 mode, text-mode 제약과 미구현 기능을 다룬 한국어 전문 번역입니다.

Source pathDocumentation/fb/arkfb.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약·해설

arkfb.rst:1-68

`arkfb`는 ARK 2000PV와 ICS 5342 조합의 BIOS-initialized VGA를 지원합니다. 여러 pseudocolor/truecolor mode와 text mode를 제공하지만 console attribute, endian, DPMS, acceleration 등에 제약이 있습니다.

arkfb 핵심
지원제약
4/8 bpp pseudocolor, 16/24/32 bpp truecolorBIOS initialized VGA only
Text, doublescan, panning, suspend/resumeBig-endian, DPMS, MMIO, acceleration 미지원

2. 영어 원문 전체

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

원문 전체 펼치기
1 ========================================
2 arkfb - fbdev driver for ARK Logic chips
3 ========================================
4
5
6 Supported Hardware
7 ==================
8
9 ARK 2000PV chip
10 ICS 5342 ramdac
11
12 - only BIOS initialized VGA devices supported
13 - probably not working on big endian
14
15
16 Supported Features
17 ==================
18
19 * 4 bpp pseudocolor modes (with 18bit palette, two variants)
20 * 8 bpp pseudocolor mode (with 18bit palette)
21 * 16 bpp truecolor modes (RGB 555 and RGB 565)
22 * 24 bpp truecolor mode (RGB 888)
23 * 32 bpp truecolor mode (RGB 888)
24 * text mode (activated by bpp = 0)
25 * doublescan mode variant (not available in text mode)
26 * panning in both directions
27 * suspend/resume support
28
29 Text mode is supported even in higher resolutions, but there is limitation to
30 lower pixclocks (i got maximum about 70 MHz, it is dependent on specific
31 hardware). This limitation is not enforced by driver. Text mode supports 8bit
32 wide fonts only (hardware limitation) and 16bit tall fonts (driver
33 limitation). Unfortunately character attributes (like color) in text mode are
34 broken for unknown reason, so its usefulness is limited.
35
36 There are two 4 bpp modes. First mode (selected if nonstd == 0) is mode with
37 packed pixels, high nibble first. Second mode (selected if nonstd == 1) is mode
38 with interleaved planes (1 byte interleave), MSB first. Both modes support
39 8bit wide fonts only (driver limitation).
40
41 Suspend/resume works on systems that initialize video card during resume and
42 if device is active (for example used by fbcon).
43
44
45 Missing Features
46 ================
47 (alias TODO list)
48
49 * secondary (not initialized by BIOS) device support
50 * big endian support
51 * DPMS support
52 * MMIO support
53 * interlaced mode variant
54 * support for fontwidths != 8 in 4 bpp modes
55 * support for fontheight != 16 in text mode
56 * hardware cursor
57 * vsync synchronization
58 * feature connector support
59 * acceleration support (8514-like 2D)
60
61
62 Known bugs
63 ==========
64
65 * character attributes (and cursor) in text mode are broken
66
67 --
68 Ondrej Zajicek <[email protected]>
69

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 hardware 전제
항목지원·제약
Graphics chipARK 2000PV
RAMDACICS 5342
초기화BIOS initialized VGA만 지원
EndianBig-endian 미지원 가능성

========================================
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`에서 사용 중일 때 동작합니다.

arkfb pixel mode
BppVisual·layout비고
4Pseudocolor packed 또는 interleaved planes18-bit palette, font width 8
8Pseudocolor18-bit palette
16Truecolor RGB 555/565두 RGB layout
24/32Truecolor RGB 88824/32 bpp
0Text mode8x16 font, attribute 문제


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입니다.

arkfb TODO
영역미지원 항목
PlatformSecondary device, big-endian
Display power·timingDPMS, interlace, vsync
Access·accelerationMMIO, 8514-like 2D acceleration
Console다른 font 크기, hardware cursor, character attribute
ExpansionFeature connector

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 <[email protected]>