DOSBox s60 Port
release 20090305

this document describes the s60 specifics. you should be familiar with DOSBox, and have read the appropriate DOSBox docs for general information before continuing.

DISCLAIMER

this release is porovided as is, use at your own risk, i take no responsibilty to damage this might cause to you or your phone... you get the idea.

LICENSE AND REDIST

all this (exepct for the nokia openc plugin) is covered by GPL (inherited from dosbox). you should not even contemplate selling or otherwise commercializing the contents of this release.
if you repack, you should include an unmodified version of this readme.

CREDITS

- the DOSBox team!!!
- the VOGONS forum community
- M-HT for the arm core, and help plugging it in
- the gurus at NewLC and ForumNokia
- the community on www.nokiaprogramok.hu :-)

SOURCE

start looking here.

GENERAL INFORMATION

this port has been built from the 0.72 dosbox sources. a number of features have been dumped, to reduce the footprint (most of these are not real sacrifices as they don't make much sense on a smartphone platform anyway):
- debugging support
- cdrom support
- joystick support
- all audio modules except for sb/adlib
- serial support
- ipx support
- modem support

the port implements two cores:
- normal
- dynamic (faster, but requires more RAM)

INSTALLATION

(you will probably have to set phone security to accept untrusted packages)

1) install all dependencies (download from here)
2) install dosbox (after uninstalling previous versions) chose slim (no dynamic core) version if you have memory issues.
3) edit dosbox.conf: be sure to set the location you will install premapper.txt to, and the autoexec.bat section with special respect to the mount command, and whatever you want to launch. (typing into the shell is no joy on s60.) (c: drive is the phone's memory, for my e51 the microsd is drive e:). refer to the comments in the sample file. you should probably not experiment with settings dosbox options omitted from the sample.
4) copy dosbox.conf to the /Data directory on you phone's memory (tested), or your storage's (not tested, but should work)
5) copy a dos tree to the appropriate location (as specified for the mount command in the autoexec section of dosbox.conf)
6) edit premaper.txt to suit your needs (the provided example is a basic config file for my e51 defining only tow maps: the default map, and one for virtual mouse)
7) copy premapper.txt to wherever you've specified it in dosbox.conf

notes: you probably need to place your dos dir under /Data. i'm keeping the conf and mapper file and my /dos tree in 'C:/Data' (my phone's memory), and have not tested any other setups. the provided config and mapper file reflect my personal preference for playing eye of the beholder on my e51.

hint: if all you have is your t9 keypad, create numbered .bat files in your dos root dir to launch stuff

KEY MAPPING

refer to to the comments on the provided premapper.txt

the native codes transmitted by the phones keys:
left softie: SAPCE
right softie: ESCAPE
answert call (greeny): HOME
delete: BACKSPACE
thumb thingy: ARROW KEYS and ENTER
hang-up (reddy): (hard exit from DOSBox)

VIRTUAL MOUSE

refer to to the comments on the provided premapper.txt

SCREEN PAGING

if you set the 'oversize' option to 'page' in the config file, oversized resolution (like 640x480) will not be shrunk to fit your display. instead you will be able to pan the displayed region if you map the appropriate special keys for the premapper.

FEEDBACK/SUPPORT

the forums here

CONTRIBUTE

if you wish to join as a developer, contact me over the forums here

DONATIONS

this is FREE software. you are under no obligation to provide financial or material donations! but its nice to support the people who make software you like, so...

if you wish to help the effort by donating money for hardware purchases (5th ed. nokia device), you can do so by clicking here. if you have the means to support this project, also consider doanting to the main DOSBox project, head to their homepage.

if you can donate hardware, contact me over the forums here

thank you!