Template:VMConfiguration/86Box/doc

To list a configuration for 86Box for use in the Recommended VM configurations page, you must use the "VMConfiguration/86Box" template, which can list the configuration in a structured table.

Usage[edit source]

86Box logo (2021).png 86Box Configuration
Setting type Configuration
Machine
  • Machine: [i486 (Socket 3) SiS 496] Rise Computer R418
  • CPU type: Intel i486DX, 33 Mhz
  • Memory: 64 MB
  • FPU: Internal
Display
  • Display: [PCI] S3 Vision964 (Diamond Stealth64 VRAM)
Input devices
  • Mouse: Microsoft Serial Mouse, COM1
Sound
  • Sound card: [ISA16] Sound Blaster 16
Network
  • Network: SLiRP, [PCI] Realtek RTL8029AS
Ports (COM & LPT)
  • Port(s): Serial ports 1 and 2 enabled, parallel port 1 enabled, LPT1 device Generic Text Printer
Storage controllers
  • HD controller: Internal controller
  • FD controller: Internal controller
  • SCSI controller: None
Hard disks
  • Hard drive: IDE (0:0) drive, 1024 cylinders, 16 heads, 63 sectors (504 MB)
Floppy & CD-ROM drives
  • Floppy drive(s): One 3.5" 2.88 MB drive (A:), one 5.25" 1.2 MB drive (B:)
  • CD-ROM drive(s): ATAPI (0:1) CD-ROM drive at 12x speed
Notes
A MSCDEX 2.23 (MS-DOS CD-ROM driver), S3 Vision964 and Realtek RTL8029AS driver installer are needed to use the CD-ROM drive, graphics card, and network card. A network card only functions in Windows for Workgroups 3.1 or 3.11, otherwise, you can also set the network card to None. For Internet access, you will also need to install the TCP/IP stack for Windows for Workgroups 3.11. The Sound Blaster 16 driver needs to be installed manually from the Drivers Control Panel applet.

The following code will result in the table above:

{{VMConfiguration/86Box|
 |machine = [i486 (Socket 3) SiS 496] Rise Computer R418
 |cpu = Intel i486DX, 33 Mhz
 |ram = 64 MB
 |display = [PCI] S3 Vision964 (Diamond Stealth64 VRAM)
 |mouse = Microsoft Serial Mouse, COM1
 |sound = [ISA16] Sound Blaster 16
 |network = SLiRP, [PCI] Realtek RTL8029AS
 |ports = Serial ports 1 and 2 enabled, parallel port 1 enabled, LPT1 device Generic Text Printer
 |hdd = IDE (0:0) drive, 1024 cylinders, 16 heads, 63 sectors (504 MB)
 |floppy = One 3.5" 2.88 MB drive (A:), one 5.25" 1.2 MB drive (B:)
 |cd = ATAPI (0:1) CD-ROM drive at 12x speed
 |notes = A MSCDEX 2.23 (MS-DOS CD-ROM driver), S3 Vision964 and Realtek RTL8029AS driver installer are needed to use the CD-ROM drive, graphics card, and network card. A network card only functions in Windows for Workgroups 3.1 or 3.11, otherwise, you can also set the network card to None. For Internet access, you will also need to install the TCP/IP stack for Windows for Workgroups 3.11. The Sound Blaster 16 driver needs to be installed manually from the Drivers Control Panel applet.
}}

machine[edit source]

Required: The machine type and machine to be used. Try to be as specific with the machine as possible, per how 86Box lists the machine (using the format of [<machine type> <machine socket>] <machine name>). Failure to provide a machine will default it to "Unknown".

cpu[edit source]

Required: The CPU type and CPU speed. Failure to provide the CPU will default it to "Unknown".

ram[edit source]

Required: Memory to use in the machine. Failure to provide the memory amount will default it to "Unknown".

fpu[edit source]

FPU portion of the CPU to use. Default is "Internal".

display[edit source]

The name of the display adapter, including the bus of the display adapter. Defaults to "None" if not provided.

mouse[edit source]

Required: Input device/mouse to use in the machine. If set to "Serial Mouse", provide also the COM port where the mouse is plugged into. Failure to provide the input device will default it to "Unknown".

network[edit source]

Network type and adapter to use, including the bus of the network card. Defaults to "None" if not provided.

ports[edit source]

List the serial and parallel ports that will be enabled in the configuration, followed by any LPT devices that will be used. Defaults to "All ports disabled" if not provided.

hdcontroller, fdcontroller, and scsi[edit source]

The name of the hard drive, floppy drive, and SCSI controller(s), respectively. Provide the name of the bus with the name of the controller as well. Defaults to "Internal controller" for the HD/FD controller and "None" for the SCSI controller if not provided.

hdd[edit source]

The bus of the hard drive, alongside the cylinder/heads/sectors configuration of the hard drive. Defaults to "None" if not provided.

floppy[edit source]

The type of floppy drive to be used with the configuration. Place the drives in the order they will be seen by the system (the first floppy listed will usually be drive A, and the second is usually drive B). Defaults to "None" if not provided.

cd[edit source]

The bus and speed of the CD-ROM drive. Defaults to "None" if not provided.

notes[edit source]

Any additional notes regarding to the configuration of the machine, such as additional drivers or instructions, can be listed here.