This was modified on April 22 by Erik Troan to reflect the new release of
the TGA X server. Jay Estabrook is aware of the changes.
------------------------------------------------------------------------------

axpbin-Xtga-BETA-0.0.gz				01 February 1996
=======================				================

This archive contains the first BETA test version of an unsupported release
of an Xserver for the DEC DC21030 display controller chip, better known as
the TGA, running under Linux on a DEC Alpha CPU based platform.

This server is a *very* early version, with a number of glaring weaknesses
and omissions from the normal level expected of such. But it does appear
quite useful even at this early point, hence its availability.

Support for anything other than the 8-plane TGA is not currently working;
I hope this will change in the near future, but for now, it WILL NOT WORK
on 24-plane TGA's. Often, the 8-plane version, builtin to the UDB (called
the MULTIA when running NT), is identified as ZLXp-E1; it's the E1 that's
important, the E2 and E3 are 24-plane and beyond, and won't work.

Things missing:

	no 24-bit support at this time
	graceful transitions to/from Virtual Consoles
	changing between multiple resolutions

Please use the XF86Config config file at the end, as it defines only the
resolutions that will currently work. CHOOSE ONLY ONE in the "Screen"
section, for now.

YOU MUST FILL IN AN APPROPRIATE VALUE FOR THE "MemBase" option, look for
the "Prefetchable 32 bit memory at 0x????????" line doing "cat /proc/pci"
as shown in the examples below. UDB seems always to be at 0x2000000 but
other platforms can and will be different.

Finally, if you run across common apps that give it problems, PLEASE let me
know.

Good luck!

Jay Estabrook
jestabro@amt.tay1.dec.com

==============================================================================


Do a "cat /proc/pci" and examine it for the DEC DC21030 (TGA) device.

On an Alpha XL-266 it looks like:

PCI devices found:
  Bus  0, device  13, function  0:
    Display controller: DEC DC21030 (rev 2).
      Medium devsel.  Fast back-to-back capable.  Master Capable.  Latency=32.  
      Prefetchable 32 bit memory at 0x2000000.


and on the UDB, like:

> PCI devices found:
>   Bus  0, device  11, function  0:
>     Display controller: DEC DC21030 (rev 2).
>       Medium devsel.  Fast back-to-back capable.  Master Capable.  Latency=15.
>       Prefetchable 32 bit memory at 0x2000000.

===============================================================================

# File generated by xf86config.

#
# Copyright (c) 1994 by The XFree86 Project, Inc.
#
# Permission is hereby granted, free of charge, to any person obtaining a
# copy of this software and associated documentation files (the "Software"),
# to deal in the Software without restriction, including without limitation
# the rights to use, copy, modify, merge, publish, distribute, sublicense,
# and/or sell copies of the Software, and to permit persons to whom the
# Software is furnished to do so, subject to the following conditions:
# 
# The above copyright notice and this permission notice shall be included in
# all copies or substantial portions of the Software.
# 
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
# THE XFREE86 PROJECT BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
# OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
# SOFTWARE.
# 
# Except as contained in this notice, the name of the XFree86 Project shall
# not be used in advertising or otherwise to promote the sale, use or other
# dealings in this Software without prior written authorization from the
# XFree86 Project.
#

# **********************************************************************
# Refer to the XF86Config(4/5) man page for details about the format of 
# this file.
# **********************************************************************

# **********************************************************************
# Files section.  This allows default font and rgb paths to be set
# **********************************************************************

Section "Files"

# The location of the RGB database.  Note, this is the name of the
# file minus the extension (like ".txt" or ".db").  There is normally
# no need to change the default.

    RgbPath	"/usr/X11R6/lib/X11/rgb"

# Multiple FontPath entries are allowed (which are concatenated together),
# as well as specifying multiple comma-separated entries in one FontPath
# command (or a combination of both methods)
# 
# If you don't have a floating point coprocessor and emacs, Mosaic or other
# programs take long to start up, try moving the Type1 and Speedo directory
# to the end of this list (or comment them out).
# 

    FontPath	"/usr/X11R6/lib/X11/fonts/misc/"
    FontPath	"/usr/X11R6/lib/X11/fonts/75dpi/"
    FontPath	"/usr/X11R6/lib/X11/fonts/100dpi/"
    FontPath	"/usr/X11R6/lib/X11/fonts/Type1/"
    FontPath	"/usr/X11R6/lib/X11/fonts/Speedo/"

EndSection

# **********************************************************************
# Server flags section.
# **********************************************************************

Section "ServerFlags"

# Uncomment this to cause a core dump at the spot where a signal is 
# received.  This may leave the console in an unusable state, but may
# provide a better stack trace in the core dump to aid in debugging

#    NoTrapSignals

# Uncomment this to disable the <Crtl><Alt><BS> server abort sequence
# This allows clients to receive this key event.

#    DontZap

# Uncomment this to disable the <Crtl><Alt><KP_+>/<KP_-> mode switching
# sequences.  This allows clients to receive these key events.

#    DontZoom

EndSection

# **********************************************************************
# Input devices
# **********************************************************************

# **********************************************************************
# Keyboard section
# **********************************************************************

Section "Keyboard"

    Protocol	"Standard"

# when using XQUEUE, comment out the above line, and uncomment the
# following line

#    Protocol	"Xqueue"

    AutoRepeat	500 5
# Let the server do the NumLock processing.  This should only be required
# when using pre-R6 clients
#    ServerNumLock

# Specifiy which keyboard LEDs can be user-controlled (eg, with xset(1))
#    Xleds      1 2 3

# To set the LeftAlt to Meta, RightAlt key to ModeShift, 
# RightCtl key to Compose, and ScrollLock key to ModeLock:

    LeftAlt     Meta
    RightAlt    ModeShift
#    RightCtl    Compose
#    ScrollLock  ModeLock

EndSection


# **********************************************************************
# Pointer section
# **********************************************************************

Section "Pointer"
    Protocol    "PS/2"
#   Protocol	"Microsoft"
    Device      "/dev/mouse"

# When using XQUEUE, comment out the above two lines, and uncomment
# the following line.

#    Protocol	"Xqueue"

# Baudrate and SampleRate are only for some Logitech mice

#   BaudRate	1200
#   SampleRate	150

# Emulate3Buttons is an option for 2-button Microsoft mice

#    Emulate3Buttons

# ChordMiddle is an option for some 3-button Logitech mice

#   ChordMiddle

EndSection


# **********************************************************************
# Monitor section
# **********************************************************************

# Any number of monitor sections may be present

Section "Monitor"

    Identifier  "PCXBV"
    VendorName  "DEC"
    ModelName   "PCXBV-KA/KB"

# Bandwidth is in MHz unless units are specified

#    Bandwidth	25.2

# HorizSync is in kHz unless units are specified.
# HorizSync may be a comma separated list of discrete values, or a
# comma separated list of ranges of values.
# NOTE: THE VALUES HERE ARE EXAMPLES ONLY.  REFER TO YOUR MONITOR'S
# USER MANUAL FOR THE CORRECT NUMBERS.

    HorizSync   30-66

#    HorizSync	30-64         # multisync
#    HorizSync	31.5, 35.2    # multiple fixed sync frequencies
#    HorizSync	15-25, 30-50  # multiple ranges of sync frequencies

# VertRefresh is in Hz unless units are specified.
# VertRefresh may be a comma separated list of discrete values, or a
# comma separated list of ranges of values.
# NOTE: THE VALUES HERE ARE EXAMPLES ONLY.  REFER TO YOUR MONITOR'S
# USER MANUAL FOR THE CORRECT NUMBERS.

    VertRefresh 50-130

# Modes can be specified in two formats.  A compact one-line format, or
# a multi-line format.

# These two are equivalent

#    ModeLine "1024x768i" 45 1024 1048 1208 1264 768 776 784 817 Interlace

#    Mode "1024x768i"
#        DotClock	45
#        HTimings	1024 1048 1208 1264
#        VTimings	768 776 784 817
#        Flags		"Interlace"
#    EndMode

# This is a set of standard mode timings. Modes that are out of monitor spec
# are automatically deleted by the server (provided the HorizSync and
# VertRefresh lines are correct), so there's no immediate need to
# delete mode timings (unless particular mode timings don't work on your
# monitor). With these modes, the best standard mode that your monitor
# and video card can support for a given resolution is automatically
# used.

# 640x480 @ 60 Hz, 31.5 kHz hsync
#Modeline "640x480"     25.175 640  664  760  800   480  491  493  525
# 640x480 @ 72 Hz, 36.5 kHz hsync
#Modeline "640x480"     31.5   640  680  720  864   480  488  491  521

# 800x600 @ 60 Hz, 37.8 kHz hsync
#Modeline "800x600"     40     800  840  968 1056   600  601  605  628 +hsync +vsync
# 800x600 @ 72 Hz, 48.0 kHz hsync
#Modeline "800x600"     50     800  856  976 1040   600  637  643  666 +hsync +vsync

# 1024x768 @ 60 Hz, 48.4 kHz hsync
#Modeline "1024x768"    65    1024 1032 1176 1344   768  771  777  806 -hsync -vsync
# 1024x768 @ 70 Hz, 56.5 kHz hsync
Modeline "1024x768"    75    1024 1048 1184 1328   768  771  777  806 -hsync -vsync

# 1280x1024 @ 61 Hz, 64.2 kHz hsync
#Modeline "1280x1024"  110    1280 1328 1512 1712  1024 1025 1028 1054
# 1280x1024 @ 74 Hz, 78.85 kHz hsync
#Modeline "1280x1024"  135    1280 1312 1456 1712  1024 1027 1030 1064

EndSection


# **********************************************************************
# Graphics device section
# **********************************************************************

# Any number of graphics device sections may be present

# Device configured by xf86config:

Section "Device"
    Identifier  "TGA"
    VendorName  "DEC"
    BoardName   "ZLXp-E1"
# NOTE: for now, MemBase option is *REQUIRED* !!!!!!
    MemBase	0x02000000
# NOTE: the BETA 0.2 server only works correctly with a hardware cursor
    #Option	"sw_cursor"
EndSection


# **********************************************************************
# Screen sections
# **********************************************************************

# The accelerated servers (S3, Mach32, Mach8, 8514, P9000, AGX, W32, Mach64)
# ...and now, DEC's TGA!!! :-)

Section "Screen"
    Driver      "accel"
    Device      "TGA"
    Monitor     "PCXBV"
    Subsection "Display"
        Depth       8
#       Modes       "640x480" "800x600" "1024x768" "1280x1024"
#       Modes       "1280x1024" "1024x768" "800x600" "640x480"
#       Modes       "1024x768" "800x600" "640x480"
        Modes       "1024x768"
        ViewPort    0 0
#       Virtual     1600 1200
    EndSubsection
    Subsection "Display"
        Depth       16
        Modes       "640x480" "800x600" "1024x768"
        ViewPort    0 0
#       Virtual     1152 900
    EndSubsection
    Subsection "Display"
        Depth       32
        Modes       "640x480" "800x600"
        ViewPort    0 0
        Virtual     800 600
    EndSubsection
EndSection