WiiHandy

From WiiBrew
Jump to navigation Jump to search
WiiHandy
Lynxicon.png
General
Author(s)raz0red
TypeHandheld emulator
Version0.4
Links
Download
Website
Source
Downloadable via the Homebrew Browser
Downloadable via the Open Shop Channel
Peripherals
WiiMote2.svg Nunchuck alternative.svg ClassicController.svg GameCube Controller Loads files from the Front SD slot Loads files from SDHC cards in the Front SD slot USB mass storage device

WiiHandy is a port of the Handy 0.95 Atari Lynx emulator developed by Keith Wilkins. Additional changes by the SDLEmu team.


Overview

Handy is dedicated to emulating the Atari Lynx hardware on a standard PC. The software was originally developed by Keith Wilkins [1] and was released under the GPL on 14th April 2004.

Additional changes developed by the SDLEmu team [2].

Video



Installation

To install WiiHandy, simply extract the zip file directly to your SD card or USB device (retain the hierarchical structure exactly).

Cartridge images must be placed in the roms directory (/wiihandysdl/roms).

For the emulator to function, you must provide the "Atari Lynx boot rom" (lynxboot.img). This file must be obtained and placed in the WiiHandy directory (/wiihandysdl).

Cartridge Database

WiiHandy ships with a database that contains recommended settings for several cartridges. Specifically, it should contain the proper orientation (rotation) for any cartridges that don't use the typical horizontal orientation. This eliminates the need to modify cartridge header information to have a game rotate properly.

It should also be noted that if you look inside the database file, the hashes (MD5) being calculated do not include the 64-byte header for the purposes of increased compatibility. If you want to view the hash for a particular cartridge enable the "Debug mode" option under "Advanced". The hash will be displayed when the cartridge is playing.

To view/edit the settings applied for a particular cartridge perform the following steps:

  • Load the cartridge (via the "Load cartridge" menu item)
  • Return to the WiiHandy menu
  • Select "Cartridge settings (current cartridge)" menu item
  • Examine and modify settings for the cartridge

Cartridge/ROM Compatibility

It is worth noting that there are quite a number of bad Lynx ROM dumps floating around. In an attempt to reduce the incorrect reporting of incompatible games due to bad dumps, I have created the following page:

Cartridge Compatibility

This page lists each game that has been tested with WiiHandy along with its associated hash values (one for the full file, one that excludes the header information).

Enable the "Debug mode" option within the "Advanced" menu to view the hash (excluding header information) when a catridge is playing.

Controls

In Menu

Wiimote.svg Wiimote.svg + Nunchuck alternative.svg ClassicController.svg GameCube Controller Action
Wiimote D-Pad Up / Wiimote D-Pad Down Wiimote D-Pad Up / Wiimote D-Pad Down or Nunchuck Control Stick Classic D-Pad Up / Classic D-Pad Down or Classic Left Control Stick Gamecube D-Pad Up / Gamecube D-Pad Down or GameCube Control Stick Scroll through the Menu
Wiimote D-Pad Left / Wiimote D-Pad Right Wiimote D-Pad Left / Wiimote D-Pad Right or Nunchuck Control Stick Classic D-Pad Left / Classic D-Pad Right or Classic Left Control Stick Gamecube D-Pad Left / Gamecube D-Pad Right or GameCube Control Stick Page through the Menu
Wiimote A Button Wiimote A Button or Nunchuck C Button Classic a Button Gamecube A Button Select menu item
Wiimote B Button Wiimote B Button or Nunchuck Z Button Classic b Button Gamecube B Button Previous menu
Wiimote HOME Button Wiimote HOME Button Classic HOME Button GameCube Z Button Exit to Homebrew channel

In Game

Wiimote.svg Wiimote.svg + Nunchuck alternative.svg ClassicController.svg GameCube Controller Action
Wiimote D-Pad Wiimote D-Pad or Nunchuck Control Stick Classic D-Pad or Classic Left Control Stick GameCube D-Pad or Classic Left Control Stick Move
Wiimote 2 Button Wiimote 2 Button or Nunchuck C Button Classic a Button Gamecube A Button A Button
Wiimote 1 Button Wiimote 1 Button or Nunchuck Z Button Classic b Button Gamecube B Button B Button
Wiimote + Button Wiimote + Button Classic + Button GameCube R Trigger Option 1
Wiimote - Button Wiimote - Button Classic - Button GameCube L Trigger Option 2
Wiimote A Button Wiimote A Button Classic L Trigger or Classic R Trigger GameCube START Button Pause
Wiimote HOME Button Wiimote HOME Button Classic HOME Button GameCube Z Button Exit to menu

WiiHandy crashes, code dumps, etc.

If you are having issues with WiiHandy, please let me know about it via one of the following locations:

I would really like to resolve these issues, and it would be great to work along with the people who are experiencing them to get them resolved.

Credits

  • DJ Dynamite
    • Testing
  • Murph74
    • Testing
  • yossi
    • Testing
  • Wilsoff
    • Icon

Special thanks

  • Tantric
    • Menu example code and SDL enhancements

Screenshots

Changelog

0.4 - May 20, 2011

  • Pretty close to a full "re-port" based on the original Handy 0.95 sources.
  • Cartridge database for storing cart-specific settings (screen orientation, maximum frame rate).
  • Rewrite of display layer, GX based scaler
    • Ability to adjust horizontal and vertical screens to any size/dimensions via "Screen Size" options under "Display". If these are entered after loading a cartridge, the last frame will be displayed to assist in sizing.
  • Rewrite of sound layer
    • Audio skipping has been fixed
    • Audio plays at correct rate when the maximum frame rate is adjusted
  • Rewrite of timing loop
  • Support for Nunchuk and Classic Controller Pro
  • Analog stick support (Classic/Pro, Nunchuk)
  • USB support
  • SDHC support
  • Updated menu system

0.3 - March 31, 2009

  • Ability to enable/disable vertical sync (NTSC/PAL60 only)
  • Ability to set the gamma level of the display
  • Added option to load Lynx boot ROM from the root directory
  • Gamecube controller support
  • Fixed a couple of buffer overflow issues causing periodic crashes
  • Refactor of the source code

0.2 - January 28, 2009

  • Save/restore game snapshots
  • Resuming a game (after quitting with Home)
  • Resetting a game (after quitting with Home)
  • Fixed a bug causing homebrew games to crash on load (Lode Runner, etc.)
  • Fixed a bug where games would freeze if left idle for about an hour
  • Fixed a bug where games would not load after file error
  • Fixed minor glitches in frame rate (reworked game loop)
  • Ability to rotate controls w/ game screen
  • Ability to patch Lynx ROMs w/ rotation settings (not supported for .zip)
  • Advanced menu allowing for enabling debug mode, frame rate adjustments
  • Auto-chain detection
  • Reset/power functions (via Wii and Wiimote)
  • Ability to use a custom directory name for application files

0.1 - January 18, 2009

  • Initial version
  • Sound support
  • Wiimote/Classic controller support