Emulator: Difference between revisions
No edit summary |
No edit summary |
||
Line 23: | Line 23: | ||
===Download=== | ===Download=== | ||
Get the last Uzebox version from http://code.google.com/p/uzebox/ | Get the last Uzebox version from http://code.google.com/p/uzebox/ | ||
'''Note:''' If you are going to download from the SVN server, the current development tree is the branch '''rev_beta5''' | '''Note:''' If you are going to download from the SVN server, the current development tree is the branch '''rev_beta5''' | ||
===Compiling=== | ===Compiling=== | ||
*Unpack it | *Unpack it | ||
* | *Open a command line terminal, go to the '''tools/emulator/''' directory | ||
* | *To see the available options, type '''make help''' | ||
*Type '''make''' for the default options | |||
To see the available options, type '''make help''' | |||
This process will create two executables: uzem and uzemdbg. | This process will create two executables: uzem and uzemdbg. | ||
Line 38: | Line 38: | ||
==Using== | ==Using== | ||
Just run the emulator in the command line and pass the game (iHex file) as parameter: '''uzem path/to/your/game.hex''' | Just run the emulator in the command line and pass the game (iHex file) as parameter: '''uzem path/to/your/game.hex''' | ||
To see all the options available | |||
To see all the options available run: '''uzem --help''' | |||
==GDB== | ==GDB== | ||
Execute '''uzem''' with the option '''-d''' and the game file: | |||
<code> | |||
$ ./uzem -d ../../demos/Arkanoid/default/Arkanoid.hex | |||
NOTE THIS IS AN EXPERIMENTAL BRANCH OF THE UZEBOX EMULATOR | |||
PLEASE SEE THE FORUM FOR MORE DETAILS: http://uzebox.org/forums | |||
Loading Hex Image... | |||
Waiting on port 1284 for gdb client to connect... | |||
</code> | |||
==FAQ== | ==FAQ== |
Revision as of 01:45, 6 January 2010
Description
Uzebox has its own emulator called Uzem. You can use it for both kernel and games development.
Features:
- Multi-platform (Linux, Windows and MacOS)
- Implements the CPU atmega644 used by Uzebox
- Video and Sound using [www.libsdl.org/ SDL]
- Mouse (Uzebox supports SNES mouse)
- SDCard (for the Gameloader)
- GDB Server
Building
Prerequisites
- GCC compiler and SDL
- Windows: Download them from http://www.mingw.org/ and http://www.libsdl.org
- Linux:
- Ubuntu: sudo apt-get install build-essential libsdl1.2-dev
- OpenSuse: sudo zypper install -t pattern devel_C_C++ SDL-devel
- Fedora: yum install gcc gcc-c++ SDL-devel
- Mac OS X: Download them from Xcode and http://www.libsdl.org
Download
Get the last Uzebox version from http://code.google.com/p/uzebox/
Note: If you are going to download from the SVN server, the current development tree is the branch rev_beta5
Compiling
- Unpack it
- Open a command line terminal, go to the tools/emulator/ directory
- To see the available options, type make help
- Type make for the default options
This process will create two executables: uzem and uzemdbg. Important: The uzemdbg is only used for the Emulator development, it generates a lot of debugging messages and is very slow.
Using
Just run the emulator in the command line and pass the game (iHex file) as parameter: uzem path/to/your/game.hex
To see all the options available run: uzem --help
GDB
Execute uzem with the option -d and the game file:
$ ./uzem -d ../../demos/Arkanoid/default/Arkanoid.hex
NOTE THIS IS AN EXPERIMENTAL BRANCH OF THE UZEBOX EMULATOR
PLEASE SEE THE FORUM FOR MORE DETAILS: http://uzebox.org/forums
Loading Hex Image...
Waiting on port 1284 for gdb client to connect...