s3fb - fbdev driver for S3 Trio/Virge chips

지원 하드웨어와 전제 조건

`s3fb`는 S3 Trio/Virge 칩용 fbdev 드라이버입니다. 지원 목록은 S3 Trio32, Trio64와 V+/UV+/V2/DX/V2/GX 변형, Virge와 VX/DX/GX/GX2+ 변형입니다. S3 Plato/PX와 S3 Aurora64V+도 목록에는 있지만 전혀 시험되지 않았습니다.

PCI 버스만 지원하며 BIOS가 초기화한 VGA 장치만 사용할 수 있습니다. 빅 엔디언 시스템에서는 아마 동작하지 않습니다. 작성자가 실제 시험한 대상은 i386의 Trio64 기본형/V+/V2/DX와 Virge 기본형/VX/DX입니다.

===========================================
s3fb - fbdev driver for S3 Trio/Virge chips
===========================================


Supported Hardware
==================

        S3 Trio32
        S3 Trio64 (and variants V+, UV+, V2/DX, V2/GX)
        S3 Virge  (and variants VX, DX, GX and GX2+)
        S3 Plato/PX                (completely untested)
        S3 Aurora64V+                (completely untested)

        - only PCI bus supported
        - only BIOS initialized VGA devices supported
        - probably not working on big endian

I tested s3fb on Trio64 (plain, V+ and V2/DX) and Virge (plain, VX, DX),
all on i386.

색상 모드, 텍스트 모드와 전원 관리

지원 기능은 18비트 팔레트를 쓰는 두 종류의 4 bpp 의사색 모드와 8 bpp 의사색 모드, RGB 555/565의 16 bpp 트루컬러 모드입니다. RGB 888의 24 bpp는 Virge VX에서만, 32 bpp는 Virge VX를 제외한 카드에서 지원됩니다. `bpp = 0`이면 텍스트 모드가 활성화됩니다.

인터레이스와 더블스캔 변형은 텍스트 모드에서 사용할 수 없습니다. 양방향 패닝, suspend/resume, DPMS도 지원합니다. 고해상도 텍스트 모드는 가능하지만 픽셀 클록은 보통 하드웨어에 따라 50~60 MHz가 한계이고, 기본 Trio32에서는 약 75 MHz가 가장 좋은 결과였습니다. 드라이버는 이 한계를 강제하지 않습니다.

텍스트 모드는 하드웨어 제약으로 너비 8픽셀 글꼴만, 드라이버 제약으로 높이 16픽셀 글꼴만 지원하며 S3 Trio64 V2/DX에서는 깨져 있습니다. 4 bpp에서 `nonstd == 0`은 상위 니블 우선의 packed pixel, `nonstd == 1`은 1바이트 인터리브와 MSB 우선의 interleaved plane입니다. 두 방식 모두 너비 8픽셀 글꼴만 지원합니다.

suspend/resume은 재개 과정에서 비디오 카드를 초기화하는 시스템에서, 그리고 장치가 `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) on (only on Virge VX)
        * 32 bpp truecolor mode (RGB 888) on (not on Virge VX)
        * text mode (activated by bpp = 0)
        * interlaced mode variant (not available in text mode)
        * doublescan mode variant (not available in text mode)
        * panning in both directions
        * suspend/resume support
        * DPMS support

Text mode is supported even in higher resolutions, but there is limitation to
lower pixclocks (maximum usually between 50-60 MHz, depending on specific
hardware, i get best results from plain S3 Trio32 card - about 75 MHz). This
limitation is not enforced by driver. Text mode supports 8bit wide fonts only
(hardware limitation) and 16bit tall fonts (driver limitation). Text mode
support is broken on S3 Trio64 V2/DX.

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).

미구현 기능과 알려진 버그

TODO에는 BIOS가 초기화하지 않은 보조 장치, 빅 엔디언, Zorro 버스, MMIO, 더 많은 카드의 24 bpp, 4 bpp에서 너비 8이 아닌 글꼴, 텍스트 모드에서 높이 16이 아닌 글꼴 지원이 포함됩니다.

composite/external sync, 하드웨어 커서, 비디오 overlay, vsync 동기화, feature connector도 아직 없습니다. 8514 계열 2D, Virge 3D, busmaster 전송 가속과 성능에 영향을 주는 일부 magic register 값의 개선도 남아 있습니다.

알려진 버그는 텍스트 모드에서 커서 비활성화가 동작하지 않는 문제와 S3 Trio64 V2/DX의 텍스트 모드 고장입니다. 작성자는 Ondrej Zajicek입니다.

Missing Features
================
(alias TODO list)

        * secondary (not initialized by BIOS) device support
        * big endian support
        * Zorro bus support
        * MMIO support
        * 24 bpp mode support on more cards
        * support for fontwidths != 8 in 4 bpp modes
        * support for fontheight != 16 in text mode
        * composite and external sync (is anyone able to test this?)
        * hardware cursor
        * video overlay support
        * vsync synchronization
        * feature connector support
        * acceleration support (8514-like 2D, Virge 3D, busmaster transfers)
        * better values for some magic registers (performance issues)


Known bugs
==========

        * cursor disable in text mode doesn't work
        * text mode broken on S3 Trio64 V2/DX


--
Ondrej Zajicek <santiago@crfreenet.org>