Emulator: Difference between revisions

From Uzebox Wiki
Jump to navigation Jump to search
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
*Using the console, go to the '''tools/emulator/''' directory
*Open a command line terminal, go to the '''tools/emulator/''' directory
*Type '''Make'''
*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., run '''uzem --help'''  
 
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

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...


FAQ