Skip to content
Remy van Elst edited this page Jan 27, 2021 · 7 revisions

The emulator features an emulated Cirrus VGA adapter, which can be attached to either an SDL frontend or an X11 frontend (the second one being untested). There is also S3 adapter emulation, which is set up the same way. VGA graphics must not be confused with running a desktop GUI, you can find how to do that on this wiki page

The frontend is set using a gui option in the configuration file (on the top level, i.e. outside the tsunami block):

gui = sdl
{
  keyboard.map = "keys.map";
  keyboard.use_mapping = false;
}

The adapter itself is attached to the PCI bus and requires a ROM to work - you can get one from the vgabios project (make sure you don't use the one with "cirrus" in its name - it doesn't work, unlike the one without it).

pci0.2 = cirrus { rom = "rom/vgabios-0.6a.debug.bin"; }

If you want to use the S3 adapter, just change cirrus to s3:

pci0.2 = s3 { rom = "rom/vgabios-0.6a.debug.bin"; }

Some additional configuration related to the GUI is found in the ALi controller options:

  pci0.7 = ali
  {
    mouse.enabled = true;
    vga_console = true;
  }

After the configuration mentioned above VGA should work for you. Don't worry about the window being a strange black vertical strip for a while after startup - that's expected behavior.

OS support

The SRM console and Tru64 UNIX are both known to detect and use the Cirrus adapter correctly, the latter one also can start (guest) X11, but it's not known whether it actually works (it changes resolution to 4:3 correctly, but stays at a black screen - more investigation is needing). OpenVMS requires the S3 adapter (the Cirrus one is not recognized) - currently booting it crashes AXPbox because of unknown read/writes (when patched to be non-fatal, the operator console switches to use its own console instead of the SRM one, but DECwindows doesn't get past setting the resolution).

Pictures

Tru64 console

Tru64 UNIX VGA console

SRM console (OpenVMS bootup)

SRM console

OpenVMS operator console

OpenVMS operator console