Documentation/fb/tridentfb.rst GitHub 원문 ↗

Linux 6.18.37 · Frame Buffer

Tridentfb

Trident TGUI·Cyber·Blade 계열의 지원 범위와 설정 옵션 전문 번역입니다.

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

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

1. 요약·해설

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

요약·해설

tridentfb.rst:1-78

`Tridentfb`는 PCI/AGP TGUI·Cyber·Blade 계열에서 8/16/32 bpp와 acceleration을 제공하며, flat panel·메모리 탐지·모드 매개변수를 세밀하게 조정할 수 있습니다.

Tridentfb 설정 축
옵션
가속`noaccel`
출력`fp`, `crt`, `center`, `stretch`
메모리`memsize`, `memdiff`
패널/모드`nativex`, `bpp`, `mode`

2. 영어 원문 전체

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

원문 전체 펼치기
1 =========
2 Tridentfb
3 =========
4
5 Tridentfb is a framebuffer driver for some Trident chip based cards.
6
7 The following list of chips is thought to be supported although not all are
8 tested:
9
10 those from the TGUI series 9440/96XX and with Cyber in their names
11 those from the Image series and with Cyber in their names
12 those with Blade in their names (Blade3D,CyberBlade...)
13 the newer CyberBladeXP family
14
15 All families are accelerated. Only PCI/AGP based cards are supported,
16 none of the older Tridents.
17 The driver supports 8, 16 and 32 bits per pixel depths.
18 The TGUI family requires a line length to be power of 2 if acceleration
19 is enabled. This means that range of possible resolutions and bpp is
20 limited comparing to the range if acceleration is disabled (see list
21 of parameters below).
22
23 Known bugs:
24
25 1. The driver randomly locks up on 3DImage975 chip with acceleration
26 enabled. The same happens in X11 (Xorg).
27 2. The ramdac speeds require some more fine tuning. It is possible to
28 switch resolution which the chip does not support at some depths for
29 older chips.
30
31 How to use it?
32 ==============
33
34 When booting you can pass the video parameter::
35
36 video=tridentfb
37
38 The parameters for tridentfb are concatenated with a ':' as in this example::
39
40 video=tridentfb:800x600-16@75,noaccel
41
42 The second level parameters that tridentfb understands are:
43
44 ======== =====================================================================
45 noaccel turns off acceleration (when it doesn't work for your card)
46
47 fp use flat panel related stuff
48 crt assume monitor is present instead of fp
49
50 center for flat panels and resolutions smaller than native size center the
51 image, otherwise use
52 stretch
53
54 memsize integer value in KB, use if your card's memory size is misdetected.
55 look at the driver output to see what it says when initializing.
56
57 memdiff integer value in KB, should be nonzero if your card reports
58 more memory than it actually has. For instance mine is 192K less than
59 detection says in all three BIOS selectable situations 2M, 4M, 8M.
60 Only use if your video memory is taken from main memory hence of
61 configurable size. Otherwise use memsize.
62 If in some modes which barely fit the memory you see garbage
63 at the bottom this might help by not letting change to that mode
64 anymore.
65
66 nativex the width in pixels of the flat panel.If you know it (usually 1024
67 800 or 1280) and it is not what the driver seems to detect use it.
68
69 bpp bits per pixel (8,16 or 32)
70 mode a mode name like 800x600-8@75 as described in
71 Documentation/fb/modedb.rst
72 ======== =====================================================================
73
74 Using insane values for the above parameters will probably result in driver
75 misbehaviour so take care(for instance memsize=12345678 or memdiff=23784 or
76 nativex=93)
77
79

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

지원 칩·가속 제약·버그

1-30

`Tridentfb`는 일부 Trident 칩 기반 카드용 framebuffer 드라이버입니다. 모두 시험된 것은 아니지만 TGUI 9440/96XX와 이름에 Cyber가 붙은 칩, Image 계열의 Cyber 칩, Blade3D와 CyberBlade처럼 Blade가 붙은 칩, 최신 CyberBladeXP 계열을 지원하는 것으로 간주합니다.

모든 계열에 acceleration이 있으며 PCI/AGP 카드만 지원합니다. 오래된 Trident 카드는 지원하지 않습니다. 색 깊이는 8, 16, 32 bpp입니다.

TGUI 계열은 acceleration을 켜면 line length가 2의 거듭제곱이어야 하므로 acceleration을 끈 경우보다 가능한 해상도와 bpp 조합이 제한됩니다.

알려진 버그로 acceleration을 켠 3DImage975에서 드라이버가 무작위로 lockup하며 X11(Xorg)에서도 같습니다. RAMDAC 속도도 더 조정해야 하므로 구형 칩에서 특정 색 깊이가 지원하지 않는 해상도로 전환될 수 있습니다.

Tridentfb 지원 범위
영역내용
칩 계열TGUI 9440/96XX, Cyber/Image, Blade, CyberBladeXP
버스PCI/AGP만
색 깊이8, 16, 32 bpp
TGUI 가속line length가 2의 거듭제곱이어야 함
버그3DImage975 lockup, RAMDAC mode 검증 부족

=========
Tridentfb
=========

Tridentfb is a framebuffer driver for some Trident chip based cards.

The following list of chips is thought to be supported although not all are
tested:

those from the TGUI series 9440/96XX and with Cyber in their names
those from the Image series and with Cyber in their names
those with Blade in their names (Blade3D,CyberBlade...)
the newer CyberBladeXP family

All families are accelerated. Only PCI/AGP based cards are supported,
none of the older Tridents.
The driver supports 8, 16 and 32 bits per pixel depths.
The TGUI family requires a line length to be power of 2 if acceleration
is enabled. This means that range of possible resolutions and bpp is
limited comparing to the range if acceleration is disabled (see list
of parameters below).

Known bugs:

1. The driver randomly locks up on 3DImage975 chip with acceleration
   enabled. The same happens in X11 (Xorg).
2. The ramdac speeds require some more fine tuning. It is possible to
   switch resolution which the chip does not support at some depths for
   older chips.

부팅 형식과 옵션

31-78

기본 부팅 매개변수는 `video=tridentfb`입니다. 하위 매개변수는 콜론 뒤에 이어 붙이며 예는 `video=tridentfb:800x600-16@75,noaccel`입니다.

`noaccel`은 카드에서 acceleration이 동작하지 않을 때 이를 끕니다. `fp`는 flat panel 관련 기능을 사용하고 `crt`는 flat panel 대신 monitor가 있다고 가정합니다. native 크기보다 작은 해상도에서 `center`는 이미지를 중앙에 두고, 그렇지 않으면 `stretch`를 사용합니다.

`memsize`는 메모리 크기가 잘못 탐지될 때 실제 크기를 KB 정수로 지정합니다. 초기화 시 드라이버 출력으로 탐지값을 확인합니다. `memdiff`는 카드가 실제보다 더 많은 메모리를 보고할 때 차이를 KB로 지정합니다. 예를 들어 문서 작성자의 카드는 BIOS에서 2M, 4M, 8M 어느 값을 선택해도 탐지값보다 192K 작았습니다.

`memdiff`는 비디오 메모리가 주 메모리에서 분리되어 크기를 구성할 수 있을 때만 사용하고, 그 밖에는 `memsize`를 사용합니다. 메모리에 간신히 들어가는 모드에서 화면 아래쪽에 garbage가 보이면 `memdiff`로 해당 모드 전환을 막을 수 있습니다.

`nativex`는 flat panel의 가로 native 픽셀 수입니다. 보통 1024, 800, 1280이며 드라이버 탐지값이 틀릴 때 지정합니다. `bpp`는 8, 16, 32 가운데 하나이고 `mode`는 `Documentation/fb/modedb.rst`에 설명된 `800x600-8@75` 같은 이름입니다.

`memsize=12345678`, `memdiff=23784`, `nativex=93`처럼 비현실적인 값을 사용하면 드라이버가 오동작할 가능성이 높으므로 주의해야 합니다. 연락처는 `[email protected]`입니다.

Tridentfb 옵션
옵션역할값/주의
`noaccel`acceleration 비활성화문제 카드용
`fp` / `crt`flat panel / monitor 선택출력 종류
`center` / `stretch`작은 모드 표시 방법중앙/확대
`memsize`실제 VRAM 크기KB
`memdiff`과대 탐지 차이KB, shared memory만
`nativex`flat panel native width800/1024/1280 등
`bpp`색 깊이8/16/32
`mode`video mode 이름`Documentation/fb/modedb.rst`

How to use it?
==============

When booting you can pass the video parameter::

        video=tridentfb

The parameters for tridentfb are concatenated with a ':' as in this example::

        video=tridentfb:800x600-16@75,noaccel

The second level parameters that tridentfb understands are:

========  =====================================================================
noaccel   turns off acceleration (when it doesn't work for your card)

fp          use flat panel related stuff
crt           assume monitor is present instead of fp

center           for flat panels and resolutions smaller than native size center the
          image, otherwise use
stretch

memsize   integer value in KB, use if your card's memory size is misdetected.
          look at the driver output to see what it says when initializing.

memdiff   integer value in KB, should be nonzero if your card reports
          more memory than it actually has. For instance mine is 192K less than
          detection says in all three BIOS selectable situations 2M, 4M, 8M.
          Only use if your video memory is taken from main memory hence of
          configurable size. Otherwise use memsize.
          If in some modes which barely fit the memory you see garbage
          at the bottom this might help by not letting change to that mode
          anymore.

nativex   the width in pixels of the flat panel.If you know it (usually 1024
          800 or 1280) and it is not what the driver seems to detect use it.

bpp          bits per pixel (8,16 or 32)
mode          a mode name like 800x600-8@75 as described in
          Documentation/fb/modedb.rst
========  =====================================================================

Using insane values for the above parameters will probably result in driver
misbehaviour so take care(for instance memsize=12345678 or memdiff=23784 or
nativex=93)

Contact: [email protected]