The Voodoo.card driver (included in the MEDIATOR PCI drivers package)
written by ELBOX COMPUTER
http://www.elbox.com

Installation Guide

The Voodoo.card driver is 100% compatible with the Picasso96 ver.2.1b.

The Picasso96 graphic system ver.2.0 is available from AmigaOS 3.9 CD,
with updates at http://www.picasso96.cogito.de/LatestRelease.html
The newest P96 versions you can find at: http://www.vgr.com/picasso

Please install the Picasso96 graphic system following its 
documentation. Choose Cybervison 64 3D as the graphic card.

After the Picasso96 installation, please start Picasso96 installation
once again and choose the "Update an installed version". Select only 
"Monitorsettings" and choose the frequency supported by your monitor.

After successful installation you need to:

1. Find the CVision3D and CVision3D.info in the DEVS:Monitors
   drawer, rename these files to Voodoo and Voodoo.info, respectively.

2. Change in the tool type window of Voodoo.icon:
   BOARDTYPE = from CVision3D to Voodoo.

3. Copy the enclosed Voodoo.card driver to the Libs:Picasso96 drawer.

4. Click to the Voodoo icon (in Devs:Monitors drawer).

5. Start the Picasso96Mode program (in SYS:Prefs drawer) and select
   Attach setting to Board0: Voodoo. 
   Exit Picasso96Mode by SAVE.

Note: 1024x768 and higher resolution modes require switching
      interlace off (Voodoo chipset doesn't support interlace) 
      and calibration of the proper frequency parameters.
      With the Picasso96Mode you can prepare your own modes of work 
      suitable for your monitor. 
      Here are some sample settings for the 1024x768 resolution for 
      Amiga M1438S and CTX V710 monitors:

      Amiga M1438S:
      Clock pixel  53.42 MHz
      Timings                   horiz.     vert.
      FrameSize                  1256       807
      BorderSize                    0         0
      Position                      0         7
      SynchSize                   144         8
      SynchPolarity                 v
      Frequency                    43 kHz    52 Hz            

      CTX V710
      Clock pixel 124.46 MHz
      Timings                   horiz.     vert.
      FrameSize                  1320       802
      BorderSize                    0         0
      Position                     47         2
      SynchSize                   144         8
      SynchPolarity                 v
      Frequency                    94 kHz   117 Hz

    
      and sample setting for the 1920x1440 resolution:

      CTX V710
      Clock pixel 124.46 MHz
      Timings                   horiz.     vert.
      FrameSize                  2544      1520
      BorderSize                    0         0
      Position                     88        23 
      SynchSize                   144         8
      SynchPolarity                 v
      Frequency                    88 kHz    58 Hz

Note: Here are the reference P96 settings for the VGA output 
      for the the most popular LCD monitors and LCD or PDP TV. 
      For the best picture quality use always the native resolution
      of monitor or TV.

      Resolution: 1360 x 768
      Clock:       85.50 MHz
      Timings                   horiz.     vert.
      FrameSize                  1792       795
      BorderSize                    0         0
      Position                     64         3
      SynchSize                   112         6
      SynchPolarity                 v         v
      Frequency                    48 kHz    60 Hz  

      Resolution: 1680 x 1050
      Clock:      146.25 MHz
      Timings                   horiz.     vert.
      FrameSize                  2240      1089
      BorderSize                    0         0
      Position                    104         3
      SynchSize                   176         6
      SynchPolarity                           v
      Frequency                    65 kHz    59 Hz   
         
      Resolution: 1920 x 1080
      Clock:      148.50 MHz
      Timings                   horiz.     vert.
      FrameSize                  2200      1125
      BorderSize                    0         0
      Position                     88         4
      SynchSize                    44         5
      SynchPolarity                 v         v
      Frequency                    68 kHz    60 Hz  


      Resolution: 1920 x 1200
      Clock:      154.13 MHz
      Timings                   horiz.     vert.
      FrameSize                  2080      1235
      BorderSize                    0         0
      Position                     48         3
      SynchSize                    32         6
      SynchPolarity                 v         
      Frequency                    74 kHz    59 Hz  



--------------------
Voodoo3.card history
--------------------
1.0 (13 Nov 2000) - the first version,
                    some hardware accelerations not implemented yet
                    (to be implemented in ver. 1.1),
                    miscolouring background in 24- and 32-bit modes
                    appears at >= 1024 x 768 resolutions 
                    (worked around in ver.1.1).

1.1 (30 Nov 2000) - all the main hardware accelerations included,
                    supports all the SDRAM & SGRAM Voodoo3 card
                    versions.

------------------------------------
Voodoo.card history (NO_MMU version)
------------------------------------
1.0 (13 Feb 2001) - Voodoo5 5500 64 MB support (only 24-bit BRG),
                    Voodoo4 4500 32 MB support (only 24-bit BRG),
                    Voodoo3 2000/3000 full support,
                    Voodoo Banshe 8 MB full support,
                    new features:
                         * hardware clipping,
                         * vblank interrupts,
                         * PIP,
                         * overlay,
                         * scaling,
                         * DPMS support,
                         * big-endian 16-bit modes,
                         * pixel clock up to 230 MHz 
                           (up to 141 MHz for Voodoo Banshee),
                    cursor position correction (one pixel).

0.9 (20 Jan 2001) - all the features like in 1.0 but without
                    vblank interrupts 

1.1 (28 Feb 2001) - bilinear scaling added,
                  - compensating calculation of the number of lines 
                    displayed at screen scaling (Voodoo3 cards 
                    calculate this number inaccurately)

1.2 (31 Mar 2001) - vblank interrupts controlled by preferences
                    file (see: Envarc:Mediator/VoodooInt),
                  - overclocking of memory of Voodoo card enabled
                    (controlled by tooltype MEMORYCLOCK in Voodoo icon),
                  - Voodoo3 big-endian 32-bit suppport added

1.3 (06 Apr 2001) - drawing lines procedure improved

1.4 (12 May 2001) - RectFill and interrupts procedures improved


Note: Voodoo.card ver.1.x requires pci.library ver.2.x (NO_MMU).


---------------------------------
Voodoo.card history (MMU version)
--------------------------------- 
2.0 (18 Mar 2001) - all Voodoo memory could be reserved as frame buffer
                    (see: preferences file Envarc:Mediator/VoodooMem),
                  - vblank interrupts controlled by preferences
                    file (see: Envarc:Mediator/VoodooInt),
                  - overclocking of memory of Voodoo card enabled
                    (controlled by tooltype MEMORYCLOCK in Voodoo icon),
                  - Voodoo3 big-endian 32-bit suppport added

2.1 (31 Mar 2001) - 64 MB of Voodoo5 memory available as frame buffer,
                  - pci.library 3.1 supports 68060 imprecise caching mode    

2.2 (06 Apr 2001) - drawing lines procedure improved

2.3 (12 May 2001) - RectFill and interrupts procedures improved


Note: Voodoo.card ver.2.x requires pci.library ver.3.x (MMU).            



----------------------------------
Voodoo.card history (MMU & NO_MMU) 
----------------------------------


2.5 (25 Aug 2001) - common MMU and NO_MMU version,
                    RectFill faster, 
                    many small improvements

2.7 (19 Sep 2001) - ready for Warp3D 


Note: Voodoo.card ver.2.7 requires pci.library ver.4.2 (MMU / NO_MMU). 

--------------------------------------
Voodoo.card for Mediator MM CD history
--------------------------------------

4.6 (28 Aug 2001) - Voodoo4 and Voodoo5 supported modes:  
                    8-bit (CHANKY)
                    15-bit (R5G5B5)
                    15-bit PC (R5G5B5PC)
                    16-bit (R5G6B5
                    16-bit PC (R5G6B5PC)
                    24-bit (B8R8G8)
                    32-bit (A8R8G8B8)
                    32-bit PC (B8G8R8A8)
                    Y4U2V2
                    Y4U1V1

4.8 (22 Sep 2001) - Warp3D variable added

4.9 (08 Nov 2001) - Warp3D variable for Voodoo3 correction 

4.10 (01 Dec 2001)- Vooodoo Banshee memory size detection 
                    procedure corrected

4.11 (10 Dec 2001) - Mediator PCI 4000 support added

4.12 (05 Jan 2002) - the backgound corruption in certain specific
                     situation when sitching between 24-bit modes
                     eliminated by workaround of one P96 function

4.13 (09 Jan 2002) - elimination of changing the border colour when 
                     switching between 8 and 24-bit screens, which
                     was possible in 4.12 version

4.14 (11 Mar 2002) - the workaround to P96 is added to prevent 
                     graphic corruptions when gfx card memory 
                     overflow occurs

4.15 (09 Apr 2002) - clipping improved 

4.16 (10 Sep 2002) - support for Mediator PCI 1200 SX added

4.17               - test version

4.18 (10 Oct 2002) - displaying the border in 8-bits modes corrected

4.19 (18 Nov 2002) - the stability of VSA-100 display improved    
4.20 (06 Jun 2003) - internal changes
4.21 (01 Jul 2003) - support for Mediator PCI 1200LT and LT4 added
4.22 (28 Jul 2003) - Voodoo4/5 SDRAM initialisation changed
                     acceleration of drawn line with pattern function
4.23 (17 Nov 2003) - protection against the second driver start added,
                   - switching between 68k and PPC accesses to the 
                     Voodoo card space in A1200 accelerated
4.27 (13 Dec 2007) - support for Mediator 1200 TX added
4.28 (17 May 2008) - support for busmaster PCI cards in the big
                     endian modes corrected

(...)
4.30 (03 Sep 2010) - support for Mediator 4000 MK-II added
                   - adding the Voodoo memory to Amiga 3/4000 system
 
Note: Voodoo.card ver.4.30 requires pci.library ver.9.0 or newer. 
      
Note: From ver.5.1 on, the pci.library has been enhanced to be 
      able to work in the MMU mode also when the THOR's MMULib 
      package is installed in the computer.
      A workaround was required to correct some erroneous settings 
      of MMU tables generated by the THOR's mmu.library. 
      (E.g. mmu.library sets descriptors' table for the 68060 
      processor in the cacheable area.) Pci.library works independent 
      of the MMLib package and does not call its functions.
      The pci.library is compliant with the THOR's MMULib package, 
      except for supporting programs with proprietary procedures 
      for Bus Error Exception. Any programs of this type must be run 
      before the first opening of the pci.library if they are to work 
      correctly. This may lead to some limitations in operation of 
      such programs. For example, in MuForce it means inability to 
      direct its reports straight to the Voodoo graphic card screen. 
      (Its reports may be saved in a file.) To eliminate this 
      limitation, it is necessary to alter the method of Bus Error 
      Exception support by the THOR's MMULIB package.
     
Note: Little-endian modes are the main modes for all the PCI type cards
      designed for PC computers.
      For full compatibility with future drivers releases (TV tuner,
      Sound card, 100MBps NIC cards, USB cards, ...) we recommend
      using little-endian modes. 
      We added in Voodoo.card 16-bits big-endian support for full
      compatibility with games prepared only for big-endian modes.

Note: Do not use screens open in different endian modes simultaneousely.
      Any program, which write to inactive screen, when active screen 
      is opened in other endian mode may cause graphic corruption
      of the content of inactive screen. Changing endian modes (outside
      the allowed group) destroys also the data stored by PCI busmaster 
      cards (Spider, FastEthernet, SB128, Terratec 512i,...) in their 
      DMA buffers located in the gfx card memory.
      
      You can freely use simultanousely only screen among the following 
      groups of modes:
      1. all little endian modes:
         8-bit, 15-bit PC (Voodoo4/5), 16-bit PC, 24-bit, 32-bit BGRA
      2. big endian modes:
         15-bit (voodoo4/5), 16-bit
      3. big endian modes:
         32-bit ARGB

Note: In big-endian 32 bit modes, Voodoo frame buffer should 
      be accessed in long-word only (requirement of the Voodoo chipset).

Note: Big-endian modes do not support overlay.

Note: We do not recommend any Voodoo memory overlocking! 
      Voodoo.card driver sets Voodoo memory clock according to the
      Voodoo card BootROM setting.

Please report any bugs to developer@elbox.com

Related links:
Unofficial Mediator Mailing List
http://groups.yahoo.com/group/Amiga-Mediator
For subscribe mailto:Amiga-Mediator-subscribe@yahoogroups.com