DOSBox s60 Port
release 20090623
this document describes the s60 specifics. you should be familiar with DOSBox, and have read the appropriate DOSBox docs for general information before continuing.
did you read the release notes and the changelog? you should.
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 :-)
- Viking, for letting me put my hands on their 5800 for a few hours.
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 edit the autoexec.bat section with special respect to the mount and s60map commands, 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 the provided mapping files (premaper.txt and virtkeybmap.txt), or create your own 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 the mapping file(s) to wherever you've specified it for the s60map command in the autoexec section of dosbox.conf
notes: you probably need to place your dos dir under /Data. i'm keeping the conf and mapper file(s) and my /dos tree in 'C:/Data' (my phone's memory), and have not tested any other setups.
hint: if all you have is your t9 keypad, create numbered .bat files in your dos root dir to launch stuff
KEY AND VIRTUAL KEYBOARD MAPPING
refer to to the comments on the provided premapper.txt and virtkeybmap.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)
note: in case you were wondering: no!, you can't use the virtual mouse to operate the virtual keyboard... duh!
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 s60mapper.
REPORTING BUGS
do so at the forums here
BUT... before you do, consider the following:
- please refrain from reporting game specific bugs (i'm just one man)
- make sure the bug is reproducable
- make sure its s60 port sepcific (test with one of the "standard" dosbox ports)
- try the 'normal' core, try different memory settings
- i'm not (yet) supporting audio issues. (make sure you disable sound in the game's setup/options.)
- don't post bugs related to running windows in dosbox. its really not what this port is (meant) for.
- i exercise my rights and freedom to prioritize bugs. once you've posted a bug, don't post status requests. if its worthy, i'll do my best.
- learn some c++/symbian and fix it yourself, ha! thats what open source is all about! ...just kidding :-)
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!