WiiHandy

A forum to discuss Wii homebrew development.
User avatar
raz0red
Site Admin
Posts: 669
Joined: Sat Oct 29, 2005 8:21 pm
Location: Britannia
Contact:

WiiHandy

Post by raz0red » Sun Jan 18, 2009 10:42 am

Image


Current production release (v0.4):

https://github.com/raz0red/wiihandy/rel ... dy-0_4.zip (Binaries)
https://github.com/raz0red/wiihandy/archive/0.4.tar.gz (Source)

Code: Select all

--------------------------------------------
WiiHandy v0.4 release README
--------------------------------------------

Ported by raz0red 
[http://www.twitchasylum.com]

--------------------------------------------
Overview
--------------------------------------------

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

Additional changes developed by the SDLEmu team [http://sdlemu.ngemu.com].

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

[http://www.wiibrew.org/wiki/WiiHandy/Cartridge_Compatbility]

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

    Wiimote:
    
        Move      : D-pad
        A         : 2
        B         : 1
        Option 1  : Plus
        Option 2  : Minus
        Pause     : A
        Exit      : Home
        Power     : Power off
        
    Nunchuk:

        Move      : Analog
        A         : C
        B         : Z

    Classic controller/Pro:
    
        Move      : D-pad/Analog
        A         : A
        B         : B
        Option 1  : Plus
        Option 2  : Minus
        Pause     : L/R
        Exit      : Home
                
    Gamecube controller:
    
        Move      : D-pad/Analog
        A         : A
        B         : B
        Option 1  : R Trigger
        Option 2  : L Trigger
        Pause     : Start
        Exit      : Z Trigger

--------------------------------------------
WiiHandy crashes, code dumps, etc.
--------------------------------------------

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

[http://www.wiibrew.org/wiki/Talk:WiiHandy]
[http://www.twitchasylum.com/forum/viewtopic.php?t=510]

--------------------------------------------
Special Thanks
--------------------------------------------

DJ Dynamite  : Testing 
Murph74      : Testing
yossi        : Testing
Wilsoff      : Icon

--------------------------------------------
Change Log
--------------------------------------------

05/09/11 (0.4)
--------------    
  - 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
  
03/28/09 (0.3)
--------------    
  - 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     

01/28/09 (0.2)
--------------
  - 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    

01/18/09 (0.1)
--------------
  - Initial version
  - Sound support
  - Wiimote/Classic controller support
  
Thanks.

--Raz.
Last edited by raz0red on Fri May 20, 2011 11:24 am, edited 9 times in total.

TechRat
Posts: 2
Joined: Sun Jan 18, 2009 9:13 pm

Post by TechRat » Sun Jan 18, 2009 9:22 pm

It works nearly perfect right off the bat! :D

I only have one suggestion regarding vertically-oriented games (Gauntlet, etc.). Though having to hold the Wiimote vertically adds to the authenticity, it would be nice to have the option to rotate the controls along with the screen so that the Wiimote could still be held normally.

One other thing which really surprises me is the high quality of the music and sound effects. It seems like the Lynx sound hardware couldn't really handle what these games put out, as many games sound much better through the emulator.

User avatar
raz0red
Site Admin
Posts: 669
Joined: Sat Oct 29, 2005 8:21 pm
Location: Britannia
Contact:

Post by raz0red » Sun Jan 18, 2009 10:50 pm

TechRat wrote:It works nearly perfect right off the bat! :D

I only have one suggestion regarding vertically-oriented games (Gauntlet, etc.). Though having to hold the Wiimote vertically adds to the authenticity, it would be nice to have the option to rotate the controls along with the screen so that the Wiimote could still be held normally.

One other thing which really surprises me is the high quality of the music and sound effects. It seems like the Lynx sound hardware couldn't really handle what these games put out, as many games sound much better through the emulator.
I am totally with you. I will definitely have the control rotation issue fixed in the next release which should be mid-week.

Yeah, the sound is pretty impressive for a handheld device. I still haven't fixed all of the quirks with the sound either, so it should sound even better in upcoming releases.

--Raz.

Guest

Post by Guest » Mon Jan 19, 2009 5:06 am

absolute perfect, sounds great, rom speed superb..... just a few todo will be nice, which are on your wiibrew page :)

TechRat
Posts: 2
Joined: Sun Jan 18, 2009 9:13 pm

Post by TechRat » Mon Jan 19, 2009 7:13 am

raz0red wrote: I am totally with you. I will definitely have the control rotation issue fixed in the next release which should be mid-week.
--Raz.
Awesome. My only request is that you make it an optional setting, so people can still have that Lynx "feel" if they want. ;)

Thanks for the fantastic emulator!

User avatar
raz0red
Site Admin
Posts: 669
Joined: Sat Oct 29, 2005 8:21 pm
Location: Britannia
Contact:

Post by raz0red » Mon Jan 19, 2009 10:53 am

TechRat wrote: Awesome. My only request is that you make it an optional setting, so people can still have that Lynx "feel" if they want. ;)

Thanks for the fantastic emulator!
Definitely. The way it works is that you can select to rotate w/ the screen or force it to "No rotation", "rotate left", or "rotate right". If you select "No rotation" it will have the Lynx feel.

--Raz.

User avatar
raz0red
Site Admin
Posts: 669
Joined: Sat Oct 29, 2005 8:21 pm
Location: Britannia
Contact:

Post by raz0red » Wed Jan 28, 2009 11:16 am

Just released 0.2...


--Raz.

User avatar
raz0red
Site Admin
Posts: 669
Joined: Sat Oct 29, 2005 8:21 pm
Location: Britannia
Contact:

Post by raz0red » Sat Mar 28, 2009 7:53 pm

Just posted a new preview version of WiiHandy/SDL:

http://www.twitchasylum.com/wiihandysdl ... 3-pre3.zip (Binaries)

Code: Select all

03/28/09 (0.3)
--------------   
    - 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      
Any testing on this would be greatly appreciated.

If you do test it, I would really like to get feedback on the following:

1.) Does the default "gamma" (located under "advanced") look correct? I think it may be a tad bit too dark, thinking 60 may be a better default.

2.) For NTSC/PAL60 users, is the default for "vertical sync" (located under "advanced") enabled?

3.) For PAL users, the "vertical sync" menu should not show up at all. Please let me know if it is showing up...

Thanks a lot.

--Raz.

User avatar
raz0red
Site Admin
Posts: 669
Joined: Sat Oct 29, 2005 8:21 pm
Location: Britannia
Contact:

Post by raz0red » Sun Mar 29, 2009 10:10 pm

Found a minor bug, new version:

http://www.twitchasylum.com/wiihandysdl ... 3-pre4.zip (Binaries)

User avatar
raz0red
Site Admin
Posts: 669
Joined: Sat Oct 29, 2005 8:21 pm
Location: Britannia
Contact:

Post by raz0red » Tue Mar 31, 2009 8:12 pm


sontom115
Posts: 1
Joined: Fri May 15, 2009 8:12 pm

Post by sontom115 » Fri May 15, 2009 8:13 pm

Hi all :lol:
I am a new member of forums :oops:


pret auto

ranmori
Posts: 1
Joined: Mon May 25, 2009 6:01 pm

Post by ranmori » Mon May 25, 2009 6:04 pm


icqmatt2k
Posts: 1
Joined: Fri Jun 05, 2009 4:56 am

Help help!

Post by icqmatt2k » Fri Jun 05, 2009 5:03 am

Okay, first off greetings, I'm new to homebrew, and Wiihandy/SDL. I think it's terrific! But I'm having an issue right off the bat, as far as I can tell everything is setup correctly, but when i open wiihandy/SDL and try to load a cartridge, it tells me no cartriges found, and then there is a code dump. I tried the prerelease version as well as a lsited suggestion here:
http://www.wiibrew.org/wiki/Talk:WiiHandy/SDL

I've places the lynxboot.img in the correct place, double checked the roms dir, still, i see nothing listed.

Any help would be greatly appreciated! Keep up the great work!

-Matt

User avatar
raz0red
Site Admin
Posts: 669
Joined: Sat Oct 29, 2005 8:21 pm
Location: Britannia
Contact:

Re: Help help!

Post by raz0red » Fri Jun 05, 2009 10:03 am

icqmatt2k wrote:Okay, first off greetings, I'm new to homebrew, and Wiihandy/SDL. I think it's terrific! But I'm having an issue right off the bat, as far as I can tell everything is setup correctly, but when i open wiihandy/SDL and try to load a cartridge, it tells me no cartriges found, and then there is a code dump. I tried the prerelease version as well as a lsited suggestion here:
http://www.wiibrew.org/wiki/Talk:WiiHandy/SDL

I've places the lynxboot.img in the correct place, double checked the roms dir, still, i see nothing listed.

Any help would be greatly appreciated! Keep up the great work!

-Matt
Hmm, that is very strange, are you running version 0.3?

http://www.twitchasylum.com/wiihandysdl ... dl-0_3.zip

Also, make sure you are using the correct BIOS image, use this one:

http://www.atariage.com/Lynx/roms/LynxBoot.zip (make sure you unzip it and place it in the /apps/wiihandysdl) directory.

If all that fails, send me a PM and we can walk through it step by step.

Thanks.

--Raz.

mopenstein
Posts: 1
Joined: Sun Jun 07, 2009 3:39 pm

Post by mopenstein » Sun Jun 07, 2009 3:43 pm

Just in case anyone else was having this problem:

Don't include Sub Directories in the roms/ folder the emulator does not recognize them, all roms must be in the roms/ folder.
Also if you installed from the Homebrew Browser you may have to manually create the wiihandysdl/roms and wiihandysdl/saves folders in the root directory of your SD card (i had to)

I'd like to request that sub-directories be included in the future, just makes the roms easier to browse, thanks.

Post Reply