← Back to branch summary

~ubuntu-branches/ubuntu/gutsy/vnc4/gutsy

« back to all changes in this revision

Viewing changes to unix/xc/programs/Xserver/hw/xfree86/doc/README.agx

  • Committer: Bazaar Package Importer
  • Author(s): Ola Lundqvist
  • Date: 2006-05-15 20:35:17 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20060515203517-l4lre1ku942mn26k
Tags: 4.1.1+X4.3.0-10
* Correction of critical security issue. Thanks to Martin Kogler
  <e9925248@student.tuwien.ac.at> that informed me about the issue,
  and provided the patch.
  This flaw was originally found by Steve Wiseman of intelliadmin.com.
* Applied patch from Javier Kohen <jkohen@users.sourceforge.net> that
  inform the user that only 8 first characters of the password will
  actually be used when typing more than 8 characters, closes:
  #355619.

Show diffs side-by-side

added added

removed removed

Lines of Context:
unix/xc/programs/Xserver/hw/xfree86/doc/README.agx
 
1
                           Notes on the AGX Server
 
2
 
 
3
                                 Henry Worth
 
4
 
 
5
                                24 June 1995
 
6
 
 
7
1.  General Notes
 
8
 
 
9
This server currently supports the IIT AGX-016, AGX-015, AGX-014 and XGA-2
 
10
chipsets. The AGX chipset is based on XGA architecture, but is missing sev-
 
11
eral features and differs on others. There's also untested support for the
 
12
XGA-1 and AGX-010 chipsets.  Pixel depths of 8bpp, 15bpp, 16bpp are generally
 
13
supported.  Unpacked 24bpp (RGBX 32bpp) is not yet stable enough to release.
 
14
 
 
15
RAMDACs currently supported are the Brooktree (BT481, BT482, and BT485) and
 
16
AT&T (20C505) RAMDACs used by the Hercules Graphite series, and Sierra RAM-
 
17
DACs (15025 and 15021), and Generic VGA RAMDAC. Untested support has been
 
18
added for the AT&T 20C490 series.
 
19
 
 
20
The current driver has a number of acceleration routines: solid and dashed
 
21
zero-width lines (except AGX-014), bitblt fills, tiles, and stipples, solid
 
22
arc and polygon fills, character glyphs and font cache for 8-bit characters.
 
23
 
 
24
Boards that have had some testing include ISA and VLB versions of most of the
 
25
Hercules Graphite series, Spider Black Widow VLB and Black Widow Plus VLB,
 
26
Boca Vortek VL, CatsEye/X XGA-2, and the PS/2-57 planar XGA-2. The Orchid
 
27
Celsius is very similar to the Spider and Boca boards, except some batches
 
28
may use one of the AT&T 20C490 series RAMDACs, instead of the Sierra 15025.
 
29
There has also been a report of a generic board that uses a UMC RAMDAC that
 
30
may be an AT&T 20C490 Clone.
 
31
 
 
32
2.  Acknowledgments
 
33
 
 
34
First, to Hercules Customer Support for providing a loaner board to get
 
35
things started.
 
36
 
 
37
Second, to the XFree86 team, and those who who have contributed to their
 
38
efforts to the project, for the foundation of work that provided a basis for
 
39
bootstrapping this server.
 
40
 
 
41
3.  Known Problems
 
42
 
 
43
   o The accelerated line routines don't match lines written by the mi/cfb
 
44
     routines. This is noticeable when switching between virtual consoles
 
45
     while running routines that draw and erase lines. Seems to have been
 
46
     reduced/fixed in previous releases but need more testing.
 
47
 
 
48
   o Some special-case speedup added to cached font rendering in 3.1.1 has
 
49
     been disabled as is over-aggressive in some cases. This cuts the perfor-
 
50
     mance on terminal-fonts in half, and font performance is already low for
 
51
     the AGX chips compared to their contemporaries.
 
52
 
 
53
   o As in all software, needs more testing.
 
54
 
 
55
4.  ToDo
 
56
 
 
57
   o Address the above known problems.
 
58
 
 
59
   o Additional acceleration routines and general performance improvements.
 
60
     Many existing acceleration routines are Q&D adaptations of existing rou-
 
61
     tines from other servers that support graphics chips that differ signif-
 
62
     icantly, architecturally, from that XGA and are undoubtedly less than
 
63
     optimal. In particular some of the general per-operation overhead to
 
64
     set-up the graphics context should be moved to the ValidateGC() rou-
 
65
     tines.
 
66
 
 
67
   o Complete HW cursor support, most of the code is done (or borrowed from
 
68
     other servers). There just remains a little setup code and then finding
 
69
     a lot of time to debug and test the numerous permutations.
 
70
 
 
71
   o Complete support for the Graphite Pro's 84-pin RAMDAC.  (the 2MB version
 
72
     of the Graphite Pro has both RAMDACs, the 1Mb only the 44-pin RAMDAC).
 
73
     Currently, the 84-pin RAMDAC is only supported in clock-doubled pixmux
 
74
     mode, the server will switch between RAMDACs as required by the video
 
75
     mode In >8bpp modes this switching does not occur.
 
76
 
 
77
   o Implement more HW probing, this will be difficult as it appears some
 
78
     (all?) AGX-based vendors don't implement the VESA VXE POS registers,
 
79
     although the AGX chip does support it (and some vendors claim VXE com-
 
80
     pliance...).  There are a few rev/vendor registers in the AGX chip but
 
81
     they are not documented. Note: SuperProbe also does not support probing
 
82
     for AGX/XGA chips. ISA POS probing is supported for the XGA chips and
 
83
     some code for EISA POS is also included but not tested.
 
84
 
 
85
   o Micro-optimizations, in particularly reducing processing overhead for
 
86
     common special cases that don't require full generality.
 
87
 
 
88
5.  XF86Config
 
89
 
 
90
Device Section Entries and Options Currently Supported:
 
91
 
 
92
The minimum that must be specified in the XF86Config device section for the
 
93
AGX-014, AGX-015, AGX-016, and ISA-based XGA-1 and XGA-2 is the Chipset. How-
 
94
ever to get full capability out of the AGX-01[456] chips, the RAMDAC should
 
95
be specified.  Other parms may select additional capabilities, or may used to
 
96
override the defaults or reduce start-up time be suppressing probing. XGA
 
97
specific configuration is covered at the end of this document. The XGA
 
98
entries can generally be used to override defaults for the AGX-01[456] as
 
99
well.
 
100
 
 
101
      Ramdac
 
102
            Be sure to check the clock rating of the RAMDAC(s) on your video
 
103
            board and don't exceed that rating even if the server allows it,
 
104
            overclocking RAMDACs will damage them.
 
105
 
 
106
            The clock rating generally appears as a suffix to the part num-
 
107
            ber, may only have the most significant digit(s), and may be
 
108
            mixed with other codes (e.g. package type). For example, an 85MHz
 
109
            Bt481 in a plastic J-lead package has a part number of Bt481KPJ85
 
110
            and a 135MHz AT&T20C505 has a part number of ATT20C505-13. Sierra
 
111
            stamps the rated speed below the part numbers in a dark ink.
 
112
 
 
113
                  "normal"
 
114
                        normal VGA style RAMDAC (6-bit DAC), default if none
 
115
                        specified. Most boards should work with this parm,
 
116
                        but some capabilities will be unavailable. Only 8bpp
 
117
                        is available.
 
118
 
 
119
                  "bt481"
 
120
                        bt481 RAMDAC (supports 8-bit DAC)
 
121
 
 
122
                  "bt482"
 
123
                        bt482 RAMDAC (supports 8-bit DAC) The Hercules
 
124
                        Graphite HG210 uses the BT481 or BT482, the only dif-
 
125
                        ference between these two is the BT482's HW cursor
 
126
                        (not yet supported).  The BT481/2 are limited to
 
127
                        85Mhz.  8bpp, 15bpp, 16bpp are supported.
 
128
 
 
129
                  "ATT20c490"
 
130
                        AT&T490 RAMDAC (includes 49[123] - supports 8-bit
 
131
                        DAC). Limited to 110Mhz at 8bpp. 8bpp, 15bpp, and
 
132
                        16bpp are supported.
 
133
 
 
134
                  "SC15025"
 
135
                        Sierra SC15025 and SC15021 RAMDAC (support 8-bit
 
136
                        DAC). The SC15025 is limited to 125Mhz, and the
 
137
                        SC15021 135Mhz. Check the RAMDAC's actual rating,
 
138
                        some SC15025's used in AGX based boards are only
 
139
                        rated to 110Mhz. 8bpp, 15bpp, and 16bpp are sup-
 
140
                        ported.
 
141
 
 
142
                  "herc_dual_dac"
 
143
                        Hercules Graphite Pro RAMDAC probe.  If the 84-pin
 
144
                        Big-RAMDAC is installed (2MB models), will use the
 
145
                        Big RAMDAC, but only clocks-doubled, pixel- multi-
 
146
                        plexed modes (higher clock values only!). Lower
 
147
                        clocks and resolutions in 8bpp mode are supported by
 
148
                        switching to the Small 44-pin RAMDAC. 15bpp and 16bpp
 
149
                        are supported.
 
150
 
 
151
                        There has been one report of the "dac-8-bit" option
 
152
                        not working with a Graphite Pro equipped with a BT485
 
153
                        RAMDAC, puzzling since it should be identical to the
 
154
                        AT&T20C505 in this regard. No startup messages or
 
155
                        XF86Config were submitted to aid problem isolation.
 
156
 
 
157
                        Not supported by the HG210 Graphite.
 
158
 
 
159
                  "herc_small_dac"
 
160
                        Hercules Graphite Pro RAMDAC probe.  Forces use of
 
161
                        only the BT481/482 RAMDAC. 8bpp, 15bpp, 16bpp, and
 
162
                        unpacked 24/32bpp are supported.
 
163
 
 
164
                        Not supported by the HG210 Graphite.
 
165
 
 
166
                  "xga"
 
167
                        To allow overriding the default VGA style RAMDAC con-
 
168
                        trol for the AGX-010.
 
169
 
 
170
      Ramdac related Option Flags:
 
171
 
 
172
                  "dac_6_bit"
 
173
                        Sets RAMDAC to VGA default 6-bit DAC mode (default
 
174
                        for "normal").
 
175
 
 
176
                  "dac_8_bit"
 
177
                        Sets supported RAMDAC's to 8-bit DAC mode (default
 
178
                        for all but "normal").
 
179
 
 
180
                  "sync_on_green"
 
181
                        Composite sync on green for RAMDAC's that support
 
182
                        this feature (BT481/481 and AT&T20c490). However,
 
183
                        whether any boards have necessary traces and glue
 
184
                        logic is doubtful.
 
185
 
 
186
      Chipset:
 
187
            Must be specified, possible values: "AGX-016", "AGX-015",
 
188
            "AGX-014", "AGX-010", "XGA-2", or "XGA-1". Some AGX vendors place
 
189
            stickers over the chip, in general, if it's a VLB board it's
 
190
            probably an AGX-015 and if it's an ISA board it may be an
 
191
            AGX-014. The Hercules Graphite Power Pro and Spider Black Widow
 
192
            Plus use the AGX-016 chipset. In general, specifying a lower
 
193
            revision in the AGX-0{14,15,16} series does not seem to causes
 
194
            problems (except lower performance from the AGX-014's non-accel-
 
195
            erated line drawing).
 
196
 
 
197
            Note: Only the AGX-016, AGX-015, AGX-014 and XGA-2 have had any
 
198
            testing. Most of the development has been with an AGX-015 based
 
199
            2MB Hercules Graphite VL PRO (HG720) and most of testers for pre-
 
200
            vious releases had AGX-014 based 1MB Hercules Graphite (HG210).
 
201
 
 
202
            The limited documentation I have for the AGX-010 is that is is a
 
203
            clone of the XGA architecture with a few additional configuration
 
204
            registers. What is not clear is whether to use XGA or extended-
 
205
            VGA RAMDAC control registers.  The post-3.1.1 default is now VGA
 
206
            control registers, but XGA control registers can be forced with
 
207
            the XGA RAMDAC parm.  Likewise the configuration parms described
 
208
            in the XGA section can be used to override the AGX defaults for
 
209
            I/O and memory addresses.
 
210
 
 
211
      VideoRam:
 
212
            Will be probed if not specified. The startup will be a little
 
213
            faster if specified.
 
214
 
 
215
      Tuning Option flags:
 
216
 
 
217
                  Bus I/O interface:
 
218
 
 
219
                              "8_bit_bus"
 
220
                                    Force 8-bit I/O bus.
 
221
 
 
222
                              "wait_state", "no_wait_state"
 
223
                                    Set or clear CPU access wait state,
 
224
                                    default is the POST setting.
 
225
 
 
226
                              "fifo_conserv"
 
227
                                    Disable Memory I/O Buffer, AGX-015 and
 
228
                                    AGX-016.  MS-Windows driver default.
 
229
                                    Required by some VLB systems with
 
230
                                    `aggressive timing'.  The default for
 
231
                                    this server is to disable the buffer.
 
232
 
 
233
                              "fifo_moderate"
 
234
                                    Enable the AGX-015/016's Memory I/O
 
235
                                    buffer.
 
236
 
 
237
                              "fifo_aggressive"
 
238
                                    Enable the AGX-016's extra-large buffer.
 
239
                                    Either option may result in garbage being
 
240
                                    left about the screen, disabled by
 
241
                                    default.  A good test is the xbench or
 
242
                                    x11perf dashed lines tests, if random
 
243
                                    dots are drawn, fifo_conserv is required.
 
244
                                    So far, no boards have been reported that
 
245
                                    worked correctly with the buffers
 
246
                                    enabled.
 
247
 
 
248
                  Memory Timing:
 
249
                        POST defaults should be ok.
 
250
 
 
251
                              "vram_delay_latch",      "vram delay_ras",      "vram_extend_ras"
 
252
                                    Vram timing options.
 
253
 
 
254
                              "slow_vram",      "slow_dram"
 
255
                                    Set all of the vram timing options.
 
256
 
 
257
                              "med_dram"
 
258
                                    Set vram latch delay, clear others.
 
259
 
 
260
                              "fast_vram",
 
261
                                         "fast_dram"" All of the vram timing
 
262
                                    options are cleared.  Should be specified
 
263
                                    if directly specifying VRAM options in
 
264
                                    order to clear POST settings.
 
265
 
 
266
                  Debugging:
 
267
                        These shouldn't generally be required:
 
268
 
 
269
                              "noaccel"
 
270
                                    (AGX,XGA) Disable Font Cache.
 
271
 
 
272
                              "crtc_delay"
 
273
                                    (AGX) Force XGA mode CRTC delay.
 
274
 
 
275
                              "engine_delay"
 
276
                                    AGX-015 only? adds additional VLB wait
 
277
                                    state.
 
278
 
 
279
                              "vram_128", "vram_256"
 
280
                                    Sets VRAM shift frequency, vram_128 is
 
281
                                    for 128Kx8 VRAM. Default is to leave this
 
282
                                    bit unchanged from POST setting.
 
283
 
 
284
                              "refresh_20", "refresh_25"
 
285
                                    Number of clock cycles between screen
 
286
                                    refreshes. Default is to leave this bit
 
287
                                    unchanged from POST setting.
 
288
 
 
289
                              "screen_refresh"
 
290
                                    Disable screen refresh during non-blanked
 
291
                                    intervals, AGX-016. Default is leave them
 
292
                                    enabled.
 
293
 
 
294
                              "vlb_a", "vlb_b"
 
295
                                    VLB transaction type, default is to leave
 
296
                                    this bit unchanged from POST value.
 
297
 
 
298
      Virtual resolution:
 
299
            The server now accepts any virtual width, however the actual
 
300
            usable CRTC line width is restricted when using the graphics
 
301
            engine and depends upon the chip revision. The CRTC line width
 
302
            and not the virtual width determine the amount of memory used.
 
303
            The server currently does not make use of any of the unused CRTC
 
304
            line's memory. CRTC line width is restricted by the following
 
305
            rules:
 
306
 
 
307
                 AGX-014 : 512, 1024 and 2048. (also AGX-010)
 
308
 
 
309
                 AGX-015 : 512, 1024, 1280, and 2048.
 
310
 
 
311
                 AGX-016 : 512, 640, 800, 1024, 1280, and 2048.
 
312
 
 
313
                 XGA,AGX-010 : 512, 640, 800, 1024, 1280, 1152, and
 
314
                 2048.
 
315
 
 
316
            When panning I occasionally get streaks if the virtual resolution
 
317
            is much greater than the physical resolution.  Moving the mouse a
 
318
            little makes it disappear. The Hercules manual indicates this
 
319
            also happens with the MS-Windows drivers.
 
320
 
 
321
            The server requires at least a 64KB scratchpad (16KB for XGA's).
 
322
            Additional memory is useful for font cache and a larger scratch-
 
323
            pad.
 
324
 
 
325
      AGX Clocks:
 
326
            Probing is supported, but of course the usual warnings and dis-
 
327
            claimers apply. Probing may momentarily subject your monitor to
 
328
            sweep frequencies in excess of its rating.  The cautious may wish
 
329
            to turn off the monitor while the probe is running.
 
330
 
 
331
            Once clocks are known, they can be entered into XF86Config, then
 
332
            subsequent runs won't probe clocks and will be quicker to
 
333
            startup. For the clock probe it is recommended that the X server
 
334
            be run with the -probeonly option. The values in the clocks
 
335
            statement are the hardware input clocks and correspond to the
 
336
            pixel clock only at 8bpp in direct-clocking RAMDAC modes. The
 
337
            server will divide/multiply those values as appropriate for the
 
338
            RAMDAC modes available at the current pixel depth. The available
 
339
            pixel clocks will be displayed in the startup messages.
 
340
 
 
341
            For the 2MB Hercules Graphites, with the "herc-dual-dac" RAMDAC
 
342
            specified, earlier versions of the server generated an additional
 
343
            16 clocks with values doubled and some zeroed.  Those are no
 
344
            longer needed and you should re-probe and re-enter the clock val-
 
345
            ues to ensure all clocks are available to you.
 
346
 
 
347
            The AGX-015 2MB Hercules Graphite VL Pro with an ICS1494M
 
348
            9251-516 clock chip has probed clock values of:
 
349
 
 
350
                                25.18  28.80  32.70  36.00  40.00  45.00  50.40  64.70
 
351
                                70.10  76.10  80.60  86.30  90.40  95.90 100.70 109.40
 
352
 
 
353
            Actual values according to Hercules are:
 
354
 
 
355
                                25.175 28.322 32.512 36.000 40.00 44.90 50.35 65.00
 
356
                                70.00  75.00  80.00  85.00  90.00 95.00 100.0 108.0
 
357
 
 
358
            These are the values to be used in the clock statement if speci-
 
359
            fying the "normal", "bt481", or "herc_small_dac" RAMDAC in your
 
360
            XF86Config and your clockchip matches that above.
 
361
 
 
362
            Clock probing assumes that the first clock is 25.175Mhz and uses
 
363
            that to derive the rest. A warning is displayed if the second is
 
364
            not near 28.322Mhz. If this warning appears, you should not use
 
365
            the probed clock values without additional verification from
 
366
            other sources.
 
367
 
 
368
            In the case of the AGX-014 and later AGX's, only the external
 
369
            clock select lines are used, this means the clock values corre-
 
370
            spond to the values of the video board's clock chip.
 
371
 
 
372
            For the AGX-010, the first 8 clocks use the standard XGA internal
 
373
            clock selects and the second 8 are based on AGX extensions. For
 
374
            the XGA-1 only 8 clocks are available.  The XGA-2 uses a pro-
 
375
            grammable clock and no clocks or clockchip line is required.
 
376
 
 
377
            The maximum pixel clock generally allowed is 85MHz, but some RAM-
 
378
            DACs support higher values. In any case you, should check your
 
379
            RAMDAC, some RAMDACs used on AGX based boards are produced in
 
380
            versions rated to lesser values than the server assumes. You
 
381
            should check the rating and limit yourself to that value.
 
382
 
 
383
      Modes:
 
384
            One difference I've noted from the Mach8, is that the AGX's CRTC
 
385
            doesn't like the start of the horizontal sync to be equal to
 
386
            horiz blank start (vert sync may have the same problem, I need to
 
387
            test some more). Interlaced and +/-sync flags are supported but
 
388
            have had very little testing. For interlaced modes make sure the
 
389
            number of lines is an odd number.
 
390
 
 
391
            The doublescan flag is now supported, however the minimum clock
 
392
            supported is generally 25MHz, so resolutions of less than 400x300
 
393
            are not likely to be supported by most monitors.  In creating
 
394
            doublescan mode timings, the vertical timings will match the
 
395
            apparent resolutions, e.g. for 400x300 the timings should
 
396
            describe 300 lines, not 600.
 
397
 
 
398
      Examples:
 
399
 
 
400
                      For the Hercules HG720 (2MB VLB AGX-015, with BT481 and
 
401
            AT&T20C5050 RAMDACs), I use the following XF86Config "Device"
 
402
            section:
 
403
 
 
404
                              Section "Device"
 
405
                                  Identifier "HG720"
 
406
                                  VendorName "Hercules"
 
407
                                  BoardName  "Graphite VL Pro"
 
408
                                  Chipset    "AGX-015"
 
409
                                  Clocks     25.2  28.3  32.5  36.0  40.0  45.0  50.4  65.0
 
410
                                             70.00  75.00  80.00  85.00  90.00 95.00 100.0 108.0
 
411
                                  Videoram   2048
 
412
                                  RamDac     "herc_dual_dac"
 
413
                                  Option     "dac_8_bit"
 
414
                                  Option     "no_wait_state"
 
415
                              EndSection
 
416
 
 
417
            For the Spider Black Widow Plus (2MB VLB AGX-016, with Sierra
 
418
            SC15021 RAMDAC):
 
419
 
 
420
                              Section "Device"
 
421
                                  Identifier "SBWP"
 
422
                                  VendorName "Spider"
 
423
                                  BoardName  "Black Widow Plus"
 
424
                                  Chipset    "AGX-016"
 
425
                                  Clocks      25.2  28.3  39.9  72.2  50.0  76.9  36.1  44.8
 
426
                                              89.0  119.8 79.9  31.5 110.0  64.9  74.9  94.9
 
427
                                  Videoram   2048
 
428
                                  RamDac     "SC15025"
 
429
                                  Option     "dac_8_bit"
 
430
                                  Option     "no_wait_state"
 
431
                              EndSection
 
432
 
 
433
6.  Xga configuration
 
434
 
 
435
          This server now has tested support for XGA-2 compatible boards
 
436
(aka. XGA-NI). The main issue for XGA-1 support is whether clock probing
 
437
works. At this time probing for board configuration is limited and detailed
 
438
configuration may need to be done manually.
 
439
 
 
440
       By default the ISA POS register will be performed. If the XGA Instance
 
441
number is specified the scope of probing will be narrowed a bit. To override
 
442
or disable probing, a minimum of the Instance, COPbase, and MEMbase must be
 
443
specified in the XF86Config device section for the XGA card. MCA probing is
 
444
not supported.
 
445
 
 
446
      Instance       nn
 
447
            XGA instance number (0-7).
 
448
 
 
449
      IObase        nnnn
 
450
            The I/O address of the the XGA general control registers. The
 
451
            standard, and default, is 0x21i0, where i is the instance number.
 
452
 
 
453
      MEMbase        nnnn
 
454
            The XGA display memory address (the address the XGA coprocessor
 
455
            uses for video memory). This is also the system memory address of
 
456
            the linear aperture on boards that support it.
 
457
 
 
458
            POS register 4 bits 7-1 contains bits 31-25 of the XGA's display
 
459
            memory address. Bits 24-22 of of the display memory address con-
 
460
            tains the XGA instance number.  Bit 0 of POS register 4 is not
 
461
            used by this server as the XGA's linear aperture is not used.
 
462
            However, the coprocessor must still be configured with this.
 
463
 
 
464
            The AGX-01[456] chips have a fixed display memory address.
 
465
 
 
466
      COPbase     nnnnnn
 
467
            Address of the graphics engine's memory mapped control registers.
 
468
 
 
469
            Typically:
 
470
 
 
471
            0xC1C00 + (ext_mem_addr * 0x2000) + (instance * 0x80)
 
472
 
 
473
            where ext_mem_addr is the high order 4-bits of POS register 2
 
474
            (0-16 the server assumes zero).
 
475
 
 
476
            The AGX-01[456] chips support 0xB1F00 (default) and 0xD1F00.
 
477
 
 
478
      BIOSbase     nnnnnn
 
479
            Address of the XGA BIOS (not VGA BIOS).  Can be specified as an
 
480
            alternate to COPbase.
 
481
 
 
482
            Typically:
 
483
 
 
484
            0xC0000 + (ext_mem_addr * 0x2000)
 
485
 
 
486
            where ext_mem_addr is the high order 4-bits of POS register 2
 
487
            (0-16 -- the server assumes zero).
 
488
 
 
489
      VGAbase        nnnn
 
490
            Can be used to override the default 0xA0000 address for the 64KB
 
491
            video memory address used by the server. The only values accept-
 
492
            able are 0xA0000 and 0xB0000. VGA text mode restore does not work
 
493
            under Linux if 0xB0000 is specified.
 
494
 
 
495
            AGX-01[456] also default to 0xA0000.
 
496
 
 
497
      POSbase       nnnn
 
498
            Can be used to specify an alternate POS register probe address
 
499
            base from the ISA default of 0x100. The VESA VXE standard for
 
500
            EISA is 0xzC80, where z is the slot number).
 
501
 
 
502
            A value of zero will disable POS register probing (required for
 
503
            MCA).
 
504
 
 
505
      DACspeed      nnnn
 
506
            Can be used to override the servers default maximum Pixel Clock
 
507
            for XGA-2 of 80Mhz.  The limit can be raised as high as 90Mhz, or
 
508
            set to lower values.
 
509
 
 
510
        An alternate way to determine the POS register values is with the
 
511
setup/diag programs that should have been included with your video board, or
 
512
possibly from jumper values.
 
513
 
 
514
The XGA-2 has programmable clocks up to 90MHz, however at 1024x768, 72MHz is
 
515
generally the max that will produce a stable display with the CatsEye/XGA-2
 
516
used for testing (IBM coprocessor and INMOS RAMDAC/serializer). Higher clocks
 
517
will often generate artifacts at the top and left edges of the screen. Such
 
518
artifacts can sometimes be tuned out by increasing the vertical and horizon-
 
519
tal blanking intervals or slightly changing the clock. At pixel clock rates
 
520
above 80Mhz I have seen the chip lose sync after running for several minutes,
 
521
so 80Mhz has been set as the default limit for XGA-2 pixel clocks. I don't
 
522
have specs on actual limits, and as there are a number of different XGA
 
523
chipsets, you should use the modes documented in your owner's manual as a
 
524
guide to max refresh rates. No clocks or clockchip parm are required to spec-
 
525
ify use of programmable clocks for the XGA-2.
 
526
 
 
527
8bpp and 16bpp are supported for the XGA-2.
 
528
 
 
529
For XGA-1 cards the clocks must be specified as for the AGX chips, it is not
 
530
known whether the clockprobing will work. Some XGA-1 chips may support 16bpp.
 
531
 
 
532
     Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/agx.sgml,v 3.19 1997/01/25 03:22:19 dawes Exp $
 
533
 
 
534
     $XConsortium: agx.sgml /main/9 1996/10/19 18:03:50 kaleb $
 
535
 
 
536
 
 
537
$XFree86: xc/programs/Xserver/hw/xfree86/doc/README.agx,v 3.41 2000/03/01 01:48:18 dawes Exp $