Difference between revisions of "DOSBox"

From Pandora Wiki
Jump to: navigation, search
(Assigning action keys to A/B/X/Y: moving it around so that the easiest & most reliable option is the first)
(added link to latest version of Dosbox from the repo)
 
(10 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
{{Infobox Emulator|title=DOSBox
 
{{Infobox Emulator|title=DOSBox
 
|image=
 
|image=
|download=[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,72,54 File Archive]
+
|download=[http://repo.openpandora.org/includes/download.php?app=dosbox.pickle repo] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,72,54 File Archive]
 
|developer=
 
|developer=
 
|porter=Pickle
 
|porter=Pickle
|version=0.74svn
+
|version=1.0.0.0 repo  0.74svn file archive
 
|webpage=[http://www.dosbox.com/ dosbox.com]
 
|webpage=[http://www.dosbox.com/ dosbox.com]
 
|status=Available
 
|status=Available
Line 13: Line 13:
  
 
The Pandora can emulate "[http://www.gp32x.com/board/index.php?/topic/53942-post-your-dosbox-successes-here/page__view__findpost__p__875218 about 5000 cycles in DosBox], which is roughly a 386/33Mhz x86 PC.
 
The Pandora can emulate "[http://www.gp32x.com/board/index.php?/topic/53942-post-your-dosbox-successes-here/page__view__findpost__p__875218 about 5000 cycles in DosBox], which is roughly a 386/33Mhz x86 PC.
 
Note: In order to use the colon symbol, [http://www.gp32x.com/board/index.php?/topic/53973-dosbox-cant-use-colon/page__pid__933150__st__0&#entry933150 you have to press shift (left shoulder button) + Fn + ";"]. This also goes for the underscore symbol.
 
  
 
==Simple way to get DOSBox working==
 
==Simple way to get DOSBox working==
Line 27: Line 25:
 
5. Type in the name of the executable file for your game, with or without the extension (it's usually the one ending in .exe or .bat). So for "keen4.exe", you would type in <code>keen4</code>. (some games will want you to run setup.exe first - in which case, you type in <code>setup</code>)
 
5. Type in the name of the executable file for your game, with or without the extension (it's usually the one ending in .exe or .bat). So for "keen4.exe", you would type in <code>keen4</code>. (some games will want you to run setup.exe first - in which case, you type in <code>setup</code>)
  
6. The game should now start. By the way, at any time in steps 4 or 5, you can type in <code>dir /p</code> to see a list of the files and directories in that folder
+
6. The game should now start. By the way, at any time in steps 4 or 5, you can type in <code>dir /p</code> or just <code>dir</code> to see a list of the files and directories in that folder
  
 
7. To quit DOSBox, close your game (in most games, you press the "Esc" key), then type in <code>exit</code>.
 
7. To quit DOSBox, close your game (in most games, you press the "Esc" key), then type in <code>exit</code>.
  
==Assigning action keys to A/B/X/Y==
+
== Keyboard ==
 +
 
 +
*In order to use the colon symbol, [http://www.gp32x.com/board/index.php?/topic/53973-dosbox-cant-use-colon/page__pid__933150__st__0&#entry933150 you have to press shift (left shoulder button) + Fn + ";"]. This also goes for the underscore symbol.
 +
 
 +
===Assigning action keys to A/B/X/Y===
 
By default, DOSBox on the Pandora just assigns keys to their regular keyboard positions. This makes playing games very awkward unless you remap them to the action buttons.
 
By default, DOSBox on the Pandora just assigns keys to their regular keyboard positions. This makes playing games very awkward unless you remap them to the action buttons.
  
The simplest way to do this is to go to the <code>/media/[your SD card]/pandora/appdata/dosbox/.dboxfe</code> directory and edit the mapper.txt file that you'll find there.  
+
The simplest way to do this is to go to the <code>/media/[your SD card]/pandora/appdata/dosbox/.dboxfe</code> directory and edit the [http://www.dosbox.com/wiki/Mapper mapper.txt] file that you'll find there (if you can't see it, press CTRL and the "H" key to view hidden files).
  
 
To make things really simple, download [http://pandorawiki.org/images/Mapper.txt this mapper.txt file] and copy it into that directory, replacing the existing mapper.txt file. Then you'll get the following key mappings when you start a game in Dboxfe:
 
To make things really simple, download [http://pandorawiki.org/images/Mapper.txt this mapper.txt file] and copy it into that directory, replacing the existing mapper.txt file. Then you'll get the following key mappings when you start a game in Dboxfe:
  
A (key 278)=lctrl
+
{| class="wikitable"
 
+
!Pandora key (Keycode)!!DOSBox key
B (key 279)=rshift
+
|-
 
+
|A (key 278)||lctrl
Y (key 280)=space
+
|-
 
+
|B (key 279)||rshift
X (key 281)=lalt
+
|-
 
+
|Y (key 280)||space
L (key 303)=rshift
+
|-
 
+
|X (key 281)||lalt
R (key 305)=lalt
+
|-
 +
|L (key 303)||rshift
 +
|-
 +
|R (key 305)||lalt
 +
|-
 +
|}
  
 
That should be comfortable, since most DOS games use Space, Alt, Ctrl or Shift for their action buttons. Enter is also used (usually to bring up a menu), but it's already in a comfortable spot on the Pandora.
 
That should be comfortable, since most DOS games use Space, Alt, Ctrl or Shift for their action buttons. Enter is also used (usually to bring up a menu), but it's already in a comfortable spot on the Pandora.
Line 63: Line 70:
 
4. "Ctrl", "Alt", "Shift" and "Space" are used as the action keys by most DOS games. By default, A/B/X/Y are mapped to home/end/pg up/pg down.[http://www.gp32x.com/board/index.php?/topic/58346-dosbox-problems/page__view__findpost__p__935632] Remove the mappings for those keys (select them in the keymapper window, and press "del" for each in turn), and then map "Ctrl", "Alt", "Shift" and "Space" to A/B/X/Y.
 
4. "Ctrl", "Alt", "Shift" and "Space" are used as the action keys by most DOS games. By default, A/B/X/Y are mapped to home/end/pg up/pg down.[http://www.gp32x.com/board/index.php?/topic/58346-dosbox-problems/page__view__findpost__p__935632] Remove the mappings for those keys (select them in the keymapper window, and press "del" for each in turn), and then map "Ctrl", "Alt", "Shift" and "Space" to A/B/X/Y.
  
==Mounting ISOs==
+
== Mounting ISOs (CD games) ==
Read [http://www.gp32x.com/board/index.php?/topic/54011-dosbox-guide/page__view__findpost__p__882686 this].
+
 
 +
[http://www.gp32x.com/board/index.php?/topic/54011-dosbox-guide/page__view__findpost__p__882686]
 +
 
 +
mount c games
 +
c:
 +
imgmount D "FILENAME.iso" -t iso
 +
 
 +
==Known bugs and how to fix them==
 +
 
 +
*For mysterious reasons, dboxfe will sometimes open up in Z: instead of in C:, as it should. If that happens, go to <code>/media/[your SD card]/pandora/appdata/dosbox/</code>, and delete the configuration files for DOSBox and DOSBoxFE (if you can't see any, press CTRL and the "H" key to view hidden files). Running it again after that should show that everything is back to normal. -[http://boards.openpandora.org/index.php?/topic/2063-dosbox/page__view__findpost__p__41700]
 +
*In '''Jazz Jackrabbit CD''', the character will always walk to the left. Prometheus [http://boards.openpandora.org/index.php?/topic/2063-dosbox/page__view__findpost__p__42081 says]: ''"Whilst I do not know what causes it, I now know that trying to load Jazz from a folder that was set up on another machine (in this case, my main computer, which runs Xubuntu) seems to result in the problem with Jazz automatically walking to the left. Just now, I re-copied the files afresh (which I described on the other forum, previously), and, here's the important bit: I ran the setup program on the Pandora. This seems to have solved the issue for me, although I don't know exactly why that would be."''
 +
*Note that activating the checkbox of "dboxFE -> System -> Render -> aspect" will enable the correct aspect ratio (4:3) for most games but it will also render your nub input and touch screen unusable [http://www.gp32x.com/board/index.php?/topic/56659-dosbox-problems-with-nub-input/page__view__findpost__p__941226]. Fix still needed.
  
 
==Other tips==
 
==Other tips==
Replace DOS4GW with DOS/32A extender (Not working for some games...for example, later Sierra Games like Larry 7 or Gabriel Knight 2). Every little bit helps. -[http://www.gp32x.com/board/index.php?/topic/53942-post-your-dosbox-successes-here/page__view__findpost__p__891743]
+
*Replace DOS4GW with DOS/32A extender (Not working for some games...for example, later Sierra Games like Larry 7 or Gabriel Knight 2). Every little bit helps. -[http://www.gp32x.com/board/index.php?/topic/53942-post-your-dosbox-successes-here/page__view__findpost__p__891743]
 +
 
 +
*An important thing to try when game doesn't work or is unstable is to run it with the normal core setting rather than dynamic. -[http://www.gp32x.com/board/index.php?/topic/53942-post-your-dosbox-successes-here/page__view__findpost__p__892011]
  
An important thing to try when game doesn't work or is unstable is to run it with the normal core setting rather than dynamic. -[http://www.gp32x.com/board/index.php?/topic/53942-post-your-dosbox-successes-here/page__view__findpost__p__892011]
+
*[http://boards.openpandora.org/index.php?/topic/3469-nethack/ How to get NetHack working through DOSBox]
  
 
== External links ==
 
== External links ==

Latest revision as of 18:18, 8 March 2015

DOSBox
Download(s) repo File Archive
License {{{license}}}
Developer(s)
Porting
developer(s)
Pickle
Version 1.0.0.0 repo 0.74svn file archive
Status Available
Webpage dosbox.com
DOSBox compatibility list
Non-Pandora-specific compatibility list
Forum Discussion About Compatibility

DOSBox is an emulator for older x86 systems. Latest update: Nov. 9, 2010.

The Pandora can emulate "about 5000 cycles in DosBox, which is roughly a 386/33Mhz x86 PC.

Simple way to get DOSBox working

1. Put your DOS game directories in /media/[your SD card]/pandora/appdata/dosbox/games

2. Open up dboxfe, the DOSBox GUI that comes with the download.

3. Click on the default profile, click "start". (before doing that, you can click on the "systems" tab, and set "cycles" to "max", for better speed)

4. Type in cd [directory where your game is located]. For example, if you want to play Keen 4 and it's in the directory "Keen4", you would type in cd keen4

5. Type in the name of the executable file for your game, with or without the extension (it's usually the one ending in .exe or .bat). So for "keen4.exe", you would type in keen4. (some games will want you to run setup.exe first - in which case, you type in setup)

6. The game should now start. By the way, at any time in steps 4 or 5, you can type in dir /p or just dir to see a list of the files and directories in that folder

7. To quit DOSBox, close your game (in most games, you press the "Esc" key), then type in exit.

Keyboard

Assigning action keys to A/B/X/Y

By default, DOSBox on the Pandora just assigns keys to their regular keyboard positions. This makes playing games very awkward unless you remap them to the action buttons.

The simplest way to do this is to go to the /media/[your SD card]/pandora/appdata/dosbox/.dboxfe directory and edit the mapper.txt file that you'll find there (if you can't see it, press CTRL and the "H" key to view hidden files).

To make things really simple, download this mapper.txt file and copy it into that directory, replacing the existing mapper.txt file. Then you'll get the following key mappings when you start a game in Dboxfe:

Pandora key (Keycode) DOSBox key
A (key 278) lctrl
B (key 279) rshift
Y (key 280) space
X (key 281) lalt
L (key 303) rshift
R (key 305) lalt

That should be comfortable, since most DOS games use Space, Alt, Ctrl or Shift for their action buttons. Enter is also used (usually to bring up a menu), but it's already in a comfortable spot on the Pandora.

Using the keymapper

You can also re-assign keys by using the keymapper in dboxfe. However, for mysterious reasons, the method doesn't work for some people ([1]).

1. Open dboxfe, select your profile, press "start".

2. As it says on the blue box at the top, press Ctrl+F1 to activate the keymapper (by the way: R is also Ctrl on the Pandora)

3. A screen will pop up. Use the touchscreen to select keys. The bottom part of the screen is below the taskbar on the Pandora, so you'll need to press Shift+leftclick to move the window around. The easiest way is to hold the left shoulder button (which is "Shift", by default) while moving the window with the stylus.

4. "Ctrl", "Alt", "Shift" and "Space" are used as the action keys by most DOS games. By default, A/B/X/Y are mapped to home/end/pg up/pg down.[2] Remove the mappings for those keys (select them in the keymapper window, and press "del" for each in turn), and then map "Ctrl", "Alt", "Shift" and "Space" to A/B/X/Y.

Mounting ISOs (CD games)

[3]
mount c games
c:
imgmount D "FILENAME.iso" -t iso

Known bugs and how to fix them

  • For mysterious reasons, dboxfe will sometimes open up in Z: instead of in C:, as it should. If that happens, go to /media/[your SD card]/pandora/appdata/dosbox/, and delete the configuration files for DOSBox and DOSBoxFE (if you can't see any, press CTRL and the "H" key to view hidden files). Running it again after that should show that everything is back to normal. -[4]
  • In Jazz Jackrabbit CD, the character will always walk to the left. Prometheus says: "Whilst I do not know what causes it, I now know that trying to load Jazz from a folder that was set up on another machine (in this case, my main computer, which runs Xubuntu) seems to result in the problem with Jazz automatically walking to the left. Just now, I re-copied the files afresh (which I described on the other forum, previously), and, here's the important bit: I ran the setup program on the Pandora. This seems to have solved the issue for me, although I don't know exactly why that would be."
  • Note that activating the checkbox of "dboxFE -> System -> Render -> aspect" will enable the correct aspect ratio (4:3) for most games but it will also render your nub input and touch screen unusable [5]. Fix still needed.

Other tips

  • Replace DOS4GW with DOS/32A extender (Not working for some games...for example, later Sierra Games like Larry 7 or Gabriel Knight 2). Every little bit helps. -[6]
  • An important thing to try when game doesn't work or is unstable is to run it with the normal core setting rather than dynamic. -[7]

External links

Videos: