Skip to content

Commit ddc8342

Browse files
authored
Merge pull request #1053 from andreas-jonsson/virtualxt_1_3
Updates for VirtualXT 1.3
2 parents 468f156 + 357cfc6 commit ddc8342

File tree

2 files changed

+46
-14
lines changed

2 files changed

+46
-14
lines changed

docs/development/licenses.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -217,7 +217,7 @@ See below for a summary of the licenses behind RetroArch and its cores:
217217
| Video Processor | [BSD-2-Clause](https://github.com/jaredmcneill/libretro-v4l2/blob/master/LICENSE) | |
218218
| [Vircon32](../library/vircon32.md) | [BSD-3-Clause](https://github.com/vircon32/vircon32-libretro/blob/main/LICENSE.md) | |
219219
| [Virtual Jaguar](../library/virtual_jaguar.md) | [GPLv3](https://github.com/libretro/virtualjaguar-libretro/blob/master/docs/GPLv3) | |
220-
| [VirtualXT](../library/virtualxt.md) | [zlib-acknowledgement](https://github.com/andreas-jonsson/virtualxt/blob/develop/LICENSE) | |
220+
| [VirtualXT](../library/virtualxt.md) | [zlib](https://github.com/andreas-jonsson/virtualxt/blob/develop/LICENSE) | |
221221
| [XRick](../library/xrick.md) | [GPLv3](https://github.com/libretro/xrick-libretro/blob/master/README) | |
222222
| [YabaSanshiro](../library/yabasanshiro.md) | [GPLv2](https://github.com/libretro/yabasanshiro/blob/master/yabause/COPYING) | |
223223
| [Yabause](../library/yabause.md) | [GPLv2](https://github.com/libretro/yabause/blob/master/yabause/COPYING) | |

docs/library/virtualxt.md

Lines changed: 45 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,15 @@
22

33
## Background
44

5-
VirtualXT is an IBM PC/XT emulator that runs on modern hardware and operating systems. It is designed to be simple and lightweight yet still capable enough to run a large library of old application and games.
5+
VirtualXT is a Turbo PC/XT emulator that runs on modern hardware and operating systems. It is designed to be simple and lightweight yet still capable enough to run a large library of old application and games.
66

77
The VirtualXT core has been authored by
88

99
- [Andreas T Jonsson]
1010

1111
The VirtualXT core is licensed under
1212

13-
- [zlib-acknowledgement](https://spdx.org/licenses/preview/zlib-acknowledgement.html)
13+
- [zlib](https://spdx.org/licenses/Zlib.html)
1414

1515
A summary of the licenses behind RetroArch and its cores can be found [here](../development/licenses.md).
1616

@@ -19,19 +19,20 @@ A summary of the licenses behind RetroArch and its cores can be found [here](../
1919
The core has no external dependacies. You only need to load the .so/dll file and preferably install the .info file and you are good to go.
2020

2121
The default system emulated is a XT class machine with an Intel 8088 CPU. This means that most DOS games form the 90's wont run. VirtualXT is intended to run older CGA games and applications from the 80's, like PC booters.
22+
There is also optional support for 80186 CPU's and VGA adapters if you want to try some more "modern" software.
2223

2324
## BIOS
2425

25-
BIOS is integerated in the core and can currently not be replaced or changed.
26+
There is an option to use [GLaBIOS](https://github.com/640-KB/GLaBIOS/) or [TurboXT BIOS 3.1](https://www.phatcode.net/downloads.php?id=101). Both are included in the core.
2627

2728
## Extensions
2829

2930
Content that can be loaded by the VirtualXT core have the following file extensions:
3031

3132
- .img
32-
- .zip
33-
34-
(Zip archives are read-only and any state will be lost after reboot.)
33+
- .exe
34+
- .com
35+
- [.ini](https://raw.githubusercontent.com/virtualxt/virtualxt/refs/heads/develop/tools/config/basic.ini)
3536

3637
## Features
3738

@@ -79,31 +80,62 @@ The VirtualXT core has the following option(s) that can be tweaked from the core
7980

8081
Settings with (Restart) means that core has to be closed for the new setting to be applied on next launch.
8182

82-
- **NEC V20 (Restart)** [virtualxt_v20] (enable|**disable**)
83+
- **Reset default disk (Restart)** [virtualxt_reset_default_disk] (true|**false**)
84+
85+
The default disk image will be reverted to it's original state upon boot.
86+
87+
- **Boot priority (Restart)** [virtualxt_boot_priority] (**FD**|HD)
88+
89+
Set preferred boot device.
90+
91+
- **Video standard (Restart)** [virtualxt_video] (**CGA**|VGA)
8392

84-
Emulate an NEC V20 CPU with the 186 instructionset.
93+
Selects default video adapter.
8594

86-
- **CPU Frequency** [virtualxt_cpu_frequency] (**4.77MHz**|6MHz|8MHz|10MHz|12MHz|16MHz)
95+
- **CPU Frequency** [virtualxt_cpu_frequency] (**4.77MHz**|7.15MHz|14.3MHz)
8796

8897
Set the CPU frequency. If this is set to a higher value then the host system can emulate
8998
the time will appear to go slower in the guest environment.
9099

100+
- **186 instructions (Restart)** [virtualxt_186] (**true**|false)
101+
102+
Enable emulation of 186 instruction.
103+
104+
- **286 flag register (Restart)** [virtualxt_flag_286] (true|**false**)
105+
106+
Pull the high nibble of the flag register low. This will trick most software that a 286 CPU is installed.
107+
108+
- **EMS memory (Restart)** [virtualxt_ems] (**true**|false)
109+
110+
Emulate the Lo-tech EMS Board.
111+
112+
- **BIOS (Restart)** [virtualxt_bios] (**GLaBIOS 0.2.6**|TurboXT 3.1)
113+
114+
Select system BIOS.
115+
116+
- **RTC type (Restart)** [virtualxt_rtc] (**GLaTICK 0.8.4**|none)
117+
118+
Enable RTC and BIOS extension. (This is not supported in freestanding builds.)
119+
120+
- **Host RIFS2 (Restart)** [virtualxt_rifs] (**true**|false)
121+
122+
Enable direct file share with host system. (Defaults to Z:)
123+
91124
## Device types
92125

93126
The VirtualXT core supports the following device type(s), bolded device type(s) are required:
94127

95-
- Joystick - Analog
96128
- **Keyboard** - Keyboard
97129
- Mouse
98130

99131
## Compatibility
100132

101-
This core emulates a Intel 8088 CPU running at 4.77 Mhz just like the original IBM 5150/5160. This is quite a slow system and the original 8088 only operates in real-mode. This means that no protected-mode or 32 bit applications will run. Most DOS software from the 90's requires a VGA card and a later CPU.
133+
This core emulates a Intel 8088 CPU running at 4.77 Mhz just like the original IBM 5150/5160. This is quite a slow system and the original 8088 only operates in real-mode. This means that no protected-mode or 32 bit applications will run.
102134

103135
Try software released in the 80's, like classic PC booters.
104136

105137
## External Links
106138

107139
- [VirtualXT Homepage](https://virtualxt.org)
108-
- [VirtualXT Repository](https://github.com/andreas-jonsson/virtualxt)
109-
- [VirtualXT Issues Here](https://github.com/andreas-jonsson/virtualxt/issues)
140+
- [VirtualXT Repository](https://github.com/virtualxt/virtualxt)
141+
- [VirtualXT Issues Here](https://github.com/virtualxt/virtualxt/issues)

0 commit comments

Comments
 (0)