Phoinix, the free Gameboy emulator for PalmOS

by Bodo Wenzel
Sitemap:
Home (downloads)
F. A. Q.
Compatibility of...
  free cartridges
  commercial cartridges
How to...
  use the emulator ==>
  convert cartridges
  make cartridges run
  get in touch
About...
  the history
  the future
  the playability testing
  skipping frames
  some accessories
  limits and extensions
Thank you for the cookies

This site is kindly hosted by SourceForge Logo

How to use the emulator

On this page: - Installation - The games manager - Running games - Compatibility with other Palm OS stuff - Runtime errors and crashes


Installation:

Basically there's just one file to install: "Phoinix.prc". Please hotsync this file in your usual way... Additionally you need to hotsync a database for each game you like to play, see below.

To uninstall Phoinix, simply choose "Delete..." in the application launcher. The emulator and all games will be removed, leaving no trace.

Phoinix only emulates the Gameboy's hardware, to play a game requires the game's binary data. You'll find these as files, commonly with a "*.GB" file extension.

After obtaining a game's file, it must be converted to a Palm database ("*.PDB"). This is achieved with the converter "gb2pdb" on your personal computer. For a quick start download a collection of already converted free games.

Phoinix can't run in Flash memory currently, but converted games can be stored in Flash memory. If they use cartridge RAM it is created in a separate place, anyway.


The games manager:

The manager shows the name of the currently selected game, some information about it (cartridge type and sizes of cartridge memory), and a big "GO!" button.

Screenshot of popup list.

Select a game by either of two ways:

  • Use the popup trigger to select out of the list (see screenshot).
  • Press the scrollbuttons.

To begin emulation tap "GO!" and the game starts as if the Gameboy was just switched on.

You may rename the game for your convenience. To cancel the entry simply select the game in the popup list again.

To delete a game, select this action from the menu.

Setting up your favourite button mapping does not require to start the game. In the Options menu you'll find the entry, too. The mapping is stored per game, a new game gets your last set-up.



Running games:

After virtually switching on the emulated Gameboy, the selected game is run. To return to the manager, select "Quit" in the menu; this is equivalent to switching off the Gameboy, the game's state is not preserved!

To restart a game as if switching off-and-on with a real Gameboy, use "Reset".

If you exit Phoinix while playing a game (i. e. via the "Home" icon), the state of the game is saved. Launching Phoinix again brings you back where you left.

Screenshot of info popup.

The info popup is located on the right side at the bottom of the screen (see screenshot). Please choose what you like to see:

  • The accumulated time you played the game. It is shown in hours and minutes.
  • The power of the battery, as returned by the system. Hint: the shortcut "dot-seven" switches between several battery types.
  • The speed of the emulation compared to the real GB. It is shown in "times", sorry about the low values. :-(

To stop a game momentarily, uncheck "Run". This is convenient for screenshots. The hard keys get back their standard function so you can launch your favourite applications.


Screenshot of button mapping form. This screenshot shows the default button mapping. If it doesn't meet your taste, choose how the emulated buttons are mapped to the hard keys. "Select" and "Start" are on the screen and can't be mapped.

For the Handspring GameFace assign "Left" and "Right" to the AddressBook and ToDo keys respectively. Assign "A" and "B" as you wish.



Compatibility with other Palm OS stuff

Here is a list of reported or tested compatibility with devices and other applications:

Kyocera Smartphone QCP 6035:
Phoinix works with OS version 3.5.3, the problem with non-functional silk buttons are gone.
Screenshots via TealPaint:
If you stop the emulator and use TealPaint v.4.92, screenshots are perfect. I don't know whether other versions capture the grey level image correctly.

Runtime errors and crashes

When Phoinix detects a runtime error while emulating, it will notify you. The current state of the game is saved into a crash database which can be transfered to your PC via the standard backup procedure. Please contact me for further help. Describe the circumstances as verbose as you can!

If you experience crashes, something may have corrupted the internal memory organization of your device. I recommend strongly to perform a hard reset erasing all memory! Otherwise you have a good chance for data losses...

palm.gb_emu@gmx.de