DOSBox Wii: Difference between revisions

DOSBox Wii
DOSBox Wii
General
Author	Tantric, Carl
Type	Computer
Version	1.7
License	GPL-2.0
Last Updated	2012/06/30
Links
	Download
	Website
	Source

Latest revision as of 14:49, 21 March 2023

A port of DOSBox to the Wii using SDL Wii.

Features

USB Keyboard and mouse support.
Wiimote pointer support.
SD/USB mounting.
Most DOS games are playable.
Home menu, with on-screen keyboard.

User guide

You need a Wii Remote and a USB keyboard. The C: drive will automatically be mounted to sd:/DOSBox/ if loaded from apps/dosbox-wii/. Otherwise, the directory the dol is loaded from will be mounted as C, and sd:/DOSBox as D (if present). The Z: driver is a virtual drive that is part of DOSBox.

Other drives can be mounted using the MOUNT command. Prefix sd: for an SD card, and usb: for a USB drive. The Wii's DVD drive and network folders can't be mounted at this time.

The configuration file is loaded from the directory the dol is located in (if present) and sd:/DOSBox/dosbox.conf otherwise. This file will be created automatically after you start DOSBox. Please edit it with a text editor to choose settings appropriate for each game.

Press the Home button, type "exit", press Ctrl+F9, or press Reset (on the console) to exit.

Compatibility list

Most games work properly now; however, many games will require some sort of adjustment to the dosbox.conf file. It is recommended to try the game you want to play on the PC version of DOSBox first to discover the optimum settings.

At present, DOSBox running on a high-end machine will roughly be the equivalent of a Pentium I PC. DOSBox can be configured to run a wide range of DOS games, from CGA/Tandy/PCjr classics up to games from the Quake era.

DOSBox compatibility list on WiiBrew.

Troubleshooting

A certain game closes DOSBox, crashes with some message or hangs:

Delete the dosbox.conf file to restore the default settings.
Disable the sound (use the sound configuration program that comes with the game, additionally you can set sbtype=none and gus=false in the DOSBox configuration file)
Change some configuration entries in dosbox.conf, especially try:
- fixed cycles (for example cycles=10000)
- memsize
- ems=false
- xms=false
- umb=false

or combinations of the above settings.

Use loadfix before starting the game.

A certain game runs slowly:

Change the CPU cycles. By default DOSBox tries to detect whether a game needs to be run with as many instructions emulated per time interval as possible.
- You can force this behaviour by setting cycles=max in the DOSBox configuration file.
- In this mode you can reduce the amount of cycles on a percentage-basis (hit CTRL-F11) or raise it again (CTRL-F12).
- Sometimes manually setting the number of cycles achieves better results, in the DOSBox configuration file specify for example cycles=30000.
Increase the number of frames skipped. Pressing CTRL-F8 to increase the frameskip by 1. Repeat this until the game runs fast enough for you. You can also set this value permanently in the configuration file.
Disable the sound. You can try to disable the sound through the setup utility of the game to reduce load on your CPU further. Setting nosound=true does NOT disable the emulation of sound devices - just the sound output will be disabled.
Give up. The Wii can only do so much.

Media

DOSBox Wii (Cid2Mizard)

Known issues

The joystick works, but only with the classic controller/nunchuk analog sticks.
Network/CDROM support is missing.

Changelog

1.7 2012/06/30

Support for newer Wiimotes.
Updated to latest DOSBox SVN.
Updated to latest libogc and devkitPPC.

1.6 2011/07/06

Updated to latest DOSBox SVN.
Updated to latest libogc and devkitPPC.

1.5 2010/12/14

Updated to latest DOSBox SVN.
USB compatibility improvements.
Fix tilde key on keyboard.

1.4 2010/08/11

Updated to latest DOSBox SVN.
USB 2.0 via IOS58 support. Requires that IOS58 be pre-installed.
Improved USB keyboard/mouse support.

1.3 2010/06/24

Updated to latest DOSBox SVN.
Updated to latest libwiigui.
Improved on-screen keyboard.

1.2 2010/02/18

Updated to latest DOSBox SVN.

1.1 2009/10/27

Fixed "black screen" issue with numerous games.
Minor optimizations and bug fixes.
Updated to latest DOSBox SVN.

1.0 2009/10/09

Home menu and on-screen keyboard (a proof of concept showing SDL + libwiigui).
Small speed increases via SDL Wii improvements.
Compiled with devkitPPC r18 and libogc 1.8.0.
Updated to latest DOSBox SVN.

0.73.02 2009/07/01

Upgraded DOSBox engine to latest SVN .
Fixed lockup when only using the Wiimote (no attachments connected) .
Compiled with latest libogc and SDL Wii.

0.73.01 2009/06/03

Upgraded DOSBox engine to 0.73.
Sound issues fixed.
Compiled with latest libogc and SDL Wii.

0.72.01 2009/05/14

Initial release.

External links

GitHub - https://github.com/dborth/dosbox-wii
WiiBrew - https://wiibrew.org/wiki/DOSBox_Wii

@@ Line 1: / Line 1: @@
-{{#seo:
-|title=Wii Homebrew Emulators (Computer) - GameBrew
-|title_mode=append
-|image=dosboxwii.jpg
-|image_alt=DOSBox Wii
-}}
 {{Infobox Wii Homebrews
 |title=DOSBox Wii
-|image=dosboxwii.jpg
+|image=dosboxwii2.png
-|description=Dos
+|description=DOS emulator.
 |author=Tantric, Carl
 |lastupdated=2012/06/30
 |type=Computer
 |version=1.7
-|license=Mixed
+|license=GPL-2.0
 |download=https://dlhb.gamebrew.org/wiihomebrews/dosboxwii.7z
-|website=https://www.dosbox.com/
+|website=https://github.com/dborth/dosbox-wii
 |source=https://github.com/dborth/dosbox-wii
 }}
-A port of DOSBox to the Wii using SDL Wii.
+A port of [https://www.dosbox.com/ DOSBox] to the Wii using SDL Wii.
 ==Features==
-* USB Keyboard and mouse support
+* USB Keyboard and mouse support.
-* Wiimote pointer support
+* Wiimote pointer support.
-* SD/USB mounting
+* SD/USB mounting.
-* Most DOS games are playable
+* Most DOS games are playable.
-* Home menu, with on-screen keyboard
+* Home menu, with on-screen keyboard.
+==User guide==
+You need a Wii Remote and a USB keyboard. The C: drive will automatically be mounted to sd:/DOSBox/ if loaded from apps/dosbox-wii/. Otherwise, the directory the dol is loaded from will be mounted as C, and sd:/DOSBox as D (if present). The Z: driver is a virtual drive that is part of DOSBox.
+Other drives can be mounted using the MOUNT command. Prefix sd: for an SD card, and usb: for a USB drive. The Wii's DVD drive and network folders can't be mounted at this time.
+The configuration file is loaded from the directory the dol is located in (if present) and sd:/DOSBox/dosbox.conf otherwise. This file will be created automatically after you start DOSBox. Please edit it with a text editor to choose settings appropriate for each game.
+Press the Home button, type "exit", press Ctrl+F9, or press Reset (on the console) to exit.
+===Compatibility list===
+Most games work properly now; however, many games will require some sort of adjustment to the dosbox.conf file. It is recommended to try the game you want to play on the PC version of DOSBox first to discover the optimum settings.
-==Instructions==
+At present, DOSBox running on a high-end machine will roughly be the equivalent of a Pentium I PC. DOSBox can be configured to run a wide range of DOS games, from CGA/Tandy/PCjr classics up to games from the Quake era.
-You need a Wii Remote and a USB keyboard. The C: drive will automatically be
-mounted to sd:/DOSBox/ if loaded from apps/dosbox-wii/. Otherwise, the
-directory the dol is loaded from will be mounted as C, and sd:/DOSBox as D
-(if present). The Z: driver is a virtual drive that is part of DOSBox.
-Other drives can be mounted using the MOUNT command. Prefix sd: for an SD card,
+[http://wiibrew.org/wiki/DOSBox_Wii/Compatibility_List DOSBox compatibility list on WiiBrew].
-and usb: for a USB drive. The Wii's DVD drive and network folders can't be
-mounted at this time.
-The configuration file is loaded from the directory the dol is located in
+===Troubleshooting===
-(if present) and sd:/DOSBox/dosbox.conf otherwise. This file will be created
+'''A certain game closes DOSBox, crashes with some message or hangs:'''
-automatically after you start DOSBox. Please edit it with a text editor
-to choose settings appropriate for each game.
-Press the Home button, type "exit", press Ctrl+F9, or press Reset (on the
+*Delete the dosbox.conf file to restore the default settings.
-console) to exit.
+*Disable the sound (use the sound configuration program that comes with the game, additionally you can set sbtype=none and gus=false in the DOSBox configuration file)
+*Change some configuration entries in dosbox.conf, especially try:
+**fixed cycles (for example cycles=10000)
+**memsize
+**ems=false
+**xms=false
+**umb=false
-==Compatibility==
+or combinations of the above settings.
+*Use loadfix before starting the game.
-Most games work properly now; however, many games will require some sort
+'''A certain game runs slowly:'''
-of adjustment to the dosbox.conf file. It is recommended to try the game
-you want to play on the PC version of DOSBox first to discover the optimum
-settings.
-==Screenshots==
+*Change the CPU cycles. By default DOSBox tries to detect whether a game needs to be run with as many instructions emulated per time interval as possible.
-https://dlhb.gamebrew.org/wiihomebrews/dosboxwii-01.png
+**You can force this behaviour by setting cycles=max in the DOSBox configuration file.
-https://dlhb.gamebrew.org/wiihomebrews/dosboxwii-02.png
+**In this mode you can reduce the amount of cycles on a percentage-basis (hit CTRL-F11) or raise it again (CTRL-F12).
-https://dlhb.gamebrew.org/wiihomebrews/dosboxwii-03.png
+**Sometimes manually setting the number of cycles achieves better results, in the DOSBox configuration file specify for example cycles=30000.
-https://dlhb.gamebrew.org/wiihomebrews/dosboxwii-04.png
+*Increase the number of frames skipped. Pressing CTRL-F8 to increase the frameskip by 1. Repeat this until the game runs fast enough for you. You can also set this value permanently in the configuration file.
-https://dlhb.gamebrew.org/wiihomebrews/dosboxwii-05.png
+*Disable the sound. You can try to disable the sound through the setup utility of the game to reduce load on your CPU further. Setting nosound=true does NOT disable the emulation of sound devices - just the sound output will be disabled.
-https://dlhb.gamebrew.org/wiihomebrews/dosboxwii-06.png
+*Give up. The Wii can only do so much.
 ==Media==
+'''DOSBox Wii''' ([https://www.youtube.com/watch?v=-7s3u5IZQ4c Cid2Mizard]) <br>
 <youtube>-7s3u5IZQ4c</youtube>
-== Known Issues ==
+== Known issues ==
-* The joystick works, but only with the classic controller/nunchuk analog sticks
+* The joystick works, but only with the classic controller/nunchuk analog sticks.
 * Network/CDROM support is missing.
-== Troubleshooting ==
-=== A certain game closes DOSBox, crashes with some message or hangs: ===
-* '''Delete the dosbox.conf file''' to restore the default settings.
-* '''Disable the sound''' (use the sound configuration program that comes with the game, additionally you can set sbtype=none and gus=false in the DOSBox configuration file)
-* '''Change some configuration entries''' in dosbox.conf, especially try:
-** fixed cycles (for example cycles=10000)
-** memsize
-** ems=false
-** xms=false
-** umb=false
-or combinations of the above settings.
-* '''Use loadfix''' before starting the game
-=== A certain game runs slowly: ===
-* '''Change the CPU cycles.''' By default DOSBox tries to detect whether a game needs to be run with as many instructions emulated per time interval as possible. You can force this behaviour by setting cycles=max in the DOSBox configuration file. In this mode you can reduce the amount of cycles on a percentage-basis (hit CTRL-F11) or raise it again (CTRL-F12). Sometimes manually setting the number of cycles achieves better results, in the DOSBox configuration file specify for example cycles=30000.
-* '''Increase the number of frames skipped.''' Pressing CTRL-F8 to increase the frameskip by 1. Repeat this until the game runs fast enough for you. You can also set this value permanently in the configuration file.
-* '''Disable the sound.''' You can try to disable the sound through the setup utility of the game to reduce load on your CPU further. Setting nosound=true does NOT disable the emulation of sound devices - just the sound output will be disabled.
-* '''Give up.''' The Wii can only do so much!
 ==Changelog==
-'''1.7 - June 30, 2012'''
+'''1.7 2012/06/30'''
-* Support for newer Wiimotes
+* Support for newer Wiimotes.
-* Updated to latest DOSBox SVN
+* Updated to latest DOSBox SVN.
-* Updated to latest libogc and devkitPPC
+* Updated to latest libogc and devkitPPC.
-'''1.6 - July 6, 2011'''
+'''1.6 2011/07/06'''
-* Updated to latest DOSBox SVN
+* Updated to latest DOSBox SVN.
-* Updated to latest libogc and devkitPPC
+* Updated to latest libogc and devkitPPC.
-'''1.5 - December 14, 2010'''
+'''1.5 2010/12/14'''
-* Updated to latest DOSBox SVN
+* Updated to latest DOSBox SVN.
-* USB compatibility improvements
+* USB compatibility improvements.
-* Fix tilde key on keyboard
+* Fix tilde key on keyboard.
-'''1.4 - August 11, 2010'''
+'''1.4 2010/08/11'''
-* Updated to latest DOSBox SVN
+* Updated to latest DOSBox SVN.
 * USB 2.0 via IOS58 support. Requires that IOS58 be pre-installed.
-* Improved USB keyboard/mouse support
+* Improved USB keyboard/mouse support.
-'''1.3 - June 24, 2010'''
+'''1.3 2010/06/24'''
-* Updated to latest DOSBox SVN
+* Updated to latest DOSBox SVN.
-* Updated to latest libwiigui
+* Updated to latest libwiigui.
-* Improved on-screen keyboard
+* Improved on-screen keyboard.
-'''1.2 - February 18, 2010'''
+'''1.2 2010/02/18'''
-* Updated to latest DOSBox SVN
+* Updated to latest DOSBox SVN.
-'''1.1 - October 27, 2009'''
+'''1.1 2009/10/27'''
-* Fixed "black screen" issue with numerous games
+* Fixed "black screen" issue with numerous games.
-* Minor optimizations and bug fixes
+* Minor optimizations and bug fixes.
-* Updated to latest DOSBox SVN
+* Updated to latest DOSBox SVN.
-'''1.0 - October 9, 2009'''
+'''1.0 2009/10/09'''
-* Home menu and on-screen keyboard (a proof of concept showing SDL + libwiigui)
+* Home menu and on-screen keyboard (a proof of concept showing SDL + libwiigui).
-* Small speed increases via SDL Wii improvements
+* Small speed increases via SDL Wii improvements.
-* Compiled with devkitPPC r18 and libogc 1.8.0
+* Compiled with devkitPPC r18 and libogc 1.8.0.
-* Updated to latest DOSBox SVN
+* Updated to latest DOSBox SVN.
-'''0.73.02 - July 1, 2009'''
+'''0.73.02 2009/07/01'''
-* Upgraded DOSBox engine to latest SVN
+* Upgraded DOSBox engine to latest SVN .
-* Fixed lockup when only using the Wiimote (no attachments connected)
+* Fixed lockup when only using the Wiimote (no attachments connected) .
-* Compiled with latest libogc and SDL Wii
+* Compiled with latest libogc and SDL Wii.
-'''0.73.01 - June 3, 2009'''
+'''0.73.01 2009/06/03'''
-* Upgraded DOSBox engine to 0.73
+* Upgraded DOSBox engine to 0.73.
-* Sound issues fixed
+* Sound issues fixed.
-* Compiled with latest libogc and SDL Wii
+* Compiled with latest libogc and SDL Wii.
-'''0.72.01 - May 14, 2009'''
+'''0.72.01 2009/05/14'''
-* Initial release
+* Initial release.
 == External links ==
-* Official Website - https://www.dosbox.com/
+* GitHub - https://github.com/dborth/dosbox-wii
-* Wiibrew - https://wiibrew.org/wiki/DOSBox_Wii
+* WiiBrew - https://wiibrew.org/wiki/DOSBox_Wii
-* Github - https://github.com/dborth/dosbox-wii