WiiHandy: Difference between revisions

WiiHandy
WiiHandy
General
Author	Raz0red
Type	Handheld
Version	0.4
License	Mixed
Last Updated	2011/05/12
Links
	Download
	Website
	Source

Revision as of 16:55, 18 March 2023

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.

WiiHandy is a port of the Handy 0.95 with Additional changes by the SDLEmu team.

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

User guide

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.

Controls

Wiimote & Nunchuk

D-Pad or Nunchuk Analog - Move

2 or Nunchuk C - A

1 or Nunchuk Z - B

Plus - Option 1

Minus - Option 2

A - Pause

Home - Exit

Power off - Power

Classic Controller/Pro

D-Pad/Analog - Move

A - A

B - B

Plus - Option 1

Minus - Option 2

L/R - Pause

Home - Exit

GameCube Controller

D-Pad/Analog - Move

A - A

B - B

R - Option 1

L - Option 2

Start - Pause

Z - Exit

Screenshots

Media

WiiHandy (Chris Smith)

Changelog

0.4 2011/06/20

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 2009/03/31

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 2009/01/28

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 2009/01/18

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

External links

Official website - http://www.twitchasylum.com/forum/viewtopic.php?t=510 (archived)
GitHub - https://github.com/raz0red/wiihandy
WiiBrew - https://wiibrew.org/wiki/WiiHandy
GBAtemp - https://gbatemp.net/threads/wiihandy-sdl.130261/

@@ Line 1: / Line 1: @@
-{{#seo:
-|title=Wii Homebrew Emulators (Handheld) - GameBrew
-|title_mode=append
-|image=wiihandywii.jpg
-|image_alt=WiiHandy
-}}
 {{Infobox Wii Homebrews
 |title=WiiHandy
-|image=wiihandywii.jpg
+|image=wiihandy2.png
-|description=Atari Lynx
+|description=Atari Lynx emulator based on Handy.
 |author=Raz0red
 |lastupdated=2011/05/12
@@ Line 14: / Line 8: @@
 |version=0.4
 |license=Mixed
-|download=https://dlhb.gamebrew.org/wiihomebrews/wiihandywii.7z
+|download=https://dlhb.gamebrew.org/wiihomebrews/wiihandy.7z
-|website=https://web.archive.org/web/20220316090822/http://www.twitchasylum.com/forum/viewtopic.php?t=510
+|website=http://www.twitchasylum.com/forum/viewtopic.php?t=510
 |source=https://github.com/raz0red/wiihandy
 }}
-'''WiiHandy''' is a port of the Handy 0.95 Atari Lynx emulator developed by Keith Wilkins. Additional changes by the SDLEmu team.
+Handy is dedicated to emulating the Atari Lynx hardware on a standard PC. The software was originally developed by Keith Wilkins [http://handy.sourceforge.net/] and was released under the GPL on 14th April 2004.
-Handy is dedicated to emulating the Atari Lynx hardware on a standard PC.
-The software was originally developed by Keith Wilkins [http://handy.sourceforge.net/]
-and was released under the GPL on 14th April 2004.
-Additional changes developed by the SDLEmu team [https://web.archive.org/web/20130927094032/http://sdlemu.ngemu.com/].
+WiiHandy is a port of the Handy 0.95 with Additional changes by the SDLEmu team.
 == Installation ==
-To install WiiHandy, simply extract the zip file directly to your SD card
+To install WiiHandy, simply extract the zip file directly to your SD card or USB device (retain the hierarchical structure exactly).
-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"
+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).
-(lynxboot.img). This file must be obtained and placed in the WiiHandy
-directory (/wiihandysdl).
+==User guide==
+=== 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.
+==Controls==
+===Wiimote & Nunchuk===
+D-Pad or Nunchuk Analog - Move
+or Nunchuk C - A
+or Nunchuk Z - B
+Plus - Option 1
+Minus - Option 2
+A - Pause
+Home - Exit
+Power off - Power
+===Classic Controller/Pro===
+D-Pad/Analog - Move
+A - A
+B - B
+Plus - Option 1
+Minus - Option 2
+L/R - Pause
+Home - Exit
+===GameCube Controller===
+D-Pad/Analog - Move
+A - A
+B - B
+R - Option 1
+L - Option 2
-== Cartridge Database ==
+Start - Pause
-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
+Z - Exit
-(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
+==Screenshots==
-following steps:
+https://dlhb.gamebrew.org/wiihomebrews/wiihandy3.png
-* Load the cartridge (via the "Load cartridge" menu item)
+https://dlhb.gamebrew.org/wiihomebrews/wiihandy4.png
-* Return to the WiiHandy menu
-* Select "Cartridge settings (current cartridge)" menu item
-* Examine and modify settings for the cartridge
 ==Media==
+'''WiiHandy''' ([https://www.youtube.com/watch?v=zNElRr7pPqk Chris Smith]) <br>
 <youtube>zNElRr7pPqk</youtube>
 == Changelog ==
-''' 0.4 - May 20, 2011 '''
+''' 0.4 2011/06/20 '''
 * 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
+* 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
+* Rewrite of sound layer:
-** Audio skipping has been fixed
+** Audio skipping has been fixed.
-** Audio plays at correct rate when the maximum frame rate is adjusted
+** Audio plays at correct rate when the maximum frame rate is adjusted.
-* Rewrite of timing loop
+* Rewrite of timing loop.
-* Support for Nunchuk and Classic Controller Pro
+* Support for Nunchuk and Classic Controller Pro.
-* Analog stick support (Classic/Pro, Nunchuk)
+* Analog stick support (Classic/Pro, Nunchuk).
-* USB support
+* USB support.
-* SDHC support
+* SDHC support.
-* Updated menu system
+* Updated menu system.
-''' 0.3 - March 31, 2009 '''
+''' 0.3 2009/03/31 '''
-* Ability to enable/disable vertical sync (NTSC/PAL60 only)
+* Ability to enable/disable vertical sync (NTSC/PAL60 only).
-* Ability to set the gamma level of the display
+* Ability to set the gamma level of the display.
-* Added option to load Lynx boot ROM from the root directory
+* Added option to load Lynx boot ROM from the root directory.
-* Gamecube controller support
+* Gamecube controller support.
-* Fixed a couple of buffer overflow issues causing periodic crashes
+* Fixed a couple of buffer overflow issues causing periodic crashes .
-* Refactor of the source code
+* Refactor of the source code.
-''' 0.2 - January 28, 2009 '''
+''' 0.2 2009/01/28 '''
-* Save/restore game snapshots
+* Save/restore game snapshots.
-* Resuming a game (after quitting with Home)
+* Resuming a game (after quitting with Home).
-* Resetting 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 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 freeze if left idle for about an hour.
-* Fixed a bug where games would not load after file error
+* Fixed a bug where games would not load after file error.
-* Fixed minor glitches in frame rate (reworked game loop)
+* Fixed minor glitches in frame rate (reworked game loop).
-* Ability to rotate controls w/ game screen
+* Ability to rotate controls w/ game screen.
-* Ability to patch Lynx ROMs w/ rotation settings (not supported for .zip)
+* Ability to patch Lynx ROMs w/ rotation settings (not supported for .zip).
-* Advanced menu allowing for enabling debug mode, frame rate adjustments
+* Advanced menu allowing for enabling debug mode, frame rate adjustments.
-* Auto-chain detection
+* Auto-chain detection.
-* Reset/power functions (via Wii and Wiimote)
+* Reset/power functions (via Wii and Wiimote).
-* Ability to use a custom directory name for application files
+* Ability to use a custom directory name for application files.
-''' 0.1 - January 18, 2009 '''
+''' 0.1 2009/01/18 '''
-* Initial version
+* Initial version.
-* Sound support
+* Sound support.
-* Wiimote/Classic controller support
+* Wiimote/Classic controller support.
 == External links ==
-* Official Website - https://web.archive.org/web/20220316090822/http://www.twitchasylum.com/forum/viewtopic.php?t=510
+* Official website - [https://web.archive.org/web/20220316090822/http://www.twitchasylum.com/forum/viewtopic.php?t=510 http://www.twitchasylum.com/forum/viewtopic.php?t=510] (archived)
-* Github - https://github.com/raz0red/wiihandy
+* GitHub - https://github.com/raz0red/wiihandy
-* Wiibrew - https://wiibrew.org/wiki/WiiHandy
+* WiiBrew - https://wiibrew.org/wiki/WiiHandy
+* GBAtemp - https://gbatemp.net/threads/wiihandy-sdl.130261/