OpenMSX

From DingooWiki

openMSX
Platform(s):	Dingoo-Linux
Download(s):	SourceForge
Developer(s):	mth
Version:	0.8.0
Status:	Released
Homepage:	SourceForge Project Page

This is an official openMSX release built for Dingux. It has almost all of the features that the desktop version has, but several features are not accessible because there is no menu option for them yet. Key bindings are sufficient for most games and an on-screen virtual keyboard is included, but it is not yet possible to set up custom key bindings via the menu.

In its current state openMSX is certainly usable on Dingux, but there are a lot of things that can still be improved. If you have ideas or want to help improve openMSX on Dingux, please contact us (see included documentation for contact info).

Contents 1 Installation 2 Controls 3 Customizing 4 Building

[edit] Installation

Copy the directory named "local" from the openMSX for Dingux ZIP file to the root of the miniSD card. If you have run Dingux from the minSD card before, there will already be a directory named "local". You can safely merge both directories.

openMSX comes with the C-BIOS system ROMs, which is an open source MSX BIOS. If you'd like to use other system ROMs, for example to get disk support or because you want to emulate the exact MSX model you had years ago, you have to install those yourself. Please read this for more info:

 http://openmsx.sourceforge.net/manual/setup.html#systemroms

To launch it with dmenu use this in your dmenu.cfg (adjust your folders accordingly):

   	MenuItem openMSX
	{
		Icon = "res/emulators/msx.png"
		Name = " openMSX"
		Executable = "./openmsx-start.sh"
		WorkDir = "/usr/local/emulators/openmsx"
	}

[edit] Controls

Dingoo key	MSX action	OSD action
D-pad up	Joystick/cursor up	Previous item
D-pad down	Joystick/cursor down	Next item
D-pad left	Joystick/cursor left	Value - / Previous page
D-pad right	Joystick/cursor right	Value + / Next page
A button	Joysyick trigger A / CTRL	Confirm
B button	Joystick trigger B / Graph	Cancel
X button	Space
Y button	Shift
Left shoulder	Tab
Right shoulder	Backspace
START button	Enter	Toggle OSD keyboard
SELECT button	Escape	Toggle OSD menu

[edit] Customizing

openMSX can be configured using the settings.xml file. This file only stores settings that have a non-default value.

Things like key bindings can be customized by writing short Tcl scripts. Please have a look in the share/openmsx/scripts directory for examples. Any script you place there will be executed by openMSX on startup.

Please read this document to learn about the commands and settings of openMSX:

 http://openmsx.sourceforge.net/manual/commands.html

[edit] Building

If you want to make bigger changes, you have to compile your own openMSX for Dingux.

The first step is to download the Dingux toolchain. This toolchain is for x86 Linux; if you have an x86 machine but no Linux, you can install Linux in a virtual machine. Extract the toolchain to /opt; anywhere else won't work.

Now get the openMSX sources from Subversion:

 svn co https://openmsx.svn.sourceforge.net/svnroot/openmsx/openmsx/trunk

Now you can start the build:

 make staticbindist OPENMSX_TARGET_CPU=mipsel OPENMSX_TARGET_OS=dingux OPENMSX_FLAVOUR=opt

After the build is done, you can find the executable in:

 derived/mipsel-linux-opt-3rd/bin

More information about building openMSX:

 http://openmsx.sourceforge.net/manual/compile.html