UAE Wii

From WiiBrew
Jump to: navigation, search
UAE
UAE-icon.png
General
Author(s)Oibaf, Simon Kagstrom
TypeComputer emulator
LicenseGPL
Links
Download
Source
Downloadable via the Homebrew Browser
Peripherals
WiiMote2.svg Nunchuck alternative.svg ClassicController.svg GameCube Controller USB Keyboard USB Mouse Loads files from the Front SD slot USB mass storage device Local WiFi


Contents

Introduction

UAE is a famous Amiga emulator ported to the Wii. UAE Wii can be found on googlecode at uae-wii.googlecode.com, and is based on the source code of E-UAE. It allows you to play Stunt car racer, Turrican, Midwinter and the other good old Amiga games on your Wii. The port uses SDL Wii. The initial port was made by Simon Kagstrom. From release 6 the project is carried out by Fabio Olimpieri (Oibaf).

Budbrain megademo on the wii
Stunt car racer on the wii

Installation

Untar the binary release on your SD card, which gives you a structure as follows:

uae/
uae/uaerc
uae/floppies/
uae/roms/
uae/harddisks/
uae/harddir/
uae/saves/
apps/uae/
apps/uae/boot.dol
apps/uae/...

Amiga kickstart images go into /uae/roms/, with the default name from uaerc being kick.rom. Thereafter put your floppy images in /uae/floppies/ and you are set to go. The first filename character should not be "[" . You can also load the images from usb HD or from computer with a wi-fi connection through SMB protocol. In the last case, you should configure uaerc.smb file and select the option in the option menu. See the tinysmb page for additional information and troubleshooting.

UAE Wii comes with 3 freeware games: Sqrxz, Sqrxz2, Solid-Gold. Set "correct aspect ratio" to 100% to better play them.

Where do I get Amiga kickstart roms?

The easiest way to legally get a set of Amiga kickstart roms (and games) is to buy the Amiga forever CD from Cloanto. To use this with UAE-Wii, perform the following steps on your host computer:

1. Copy everything from the "/Amiga Files/Shared/adf" directory on your Amiga Forever CD to /uae/roms/ on your SD card.

2. Copy /Amiga Files/Shared/rom/amiga-os-130.rom to /uae/roms/kick.rom on your SD card

3. Copy /Amiga Files/Shared/rom/amiga-os-xx.rom to /uae/roms/kickxx.rom on your SD card following this mapping:

  • uae/roms/amiga-os-120.rom to /uae/roms/kick12.rom
  • uae/roms/amiga-os-130.rom to /uae/roms/kick13.rom
  • uae/roms/amiga-os-205.rom to /uae/roms/kick205.rom
  • uae/roms/amiga-os-310.rom to /uae/roms/kick31.rom

Note that amiga-os-130.rom must be copied twice.

4. If you have upgraded from an older version than 3, remove /uae/uaerc.saved from your SD card

You can also dump the kickstart-rom of one of your own real Amigas, this requires a rom-dumper program (can be found here) and you will need to be able to transfer files to and from your Amiga. The easiest way to achieve this is to also use an Amiga that can write PC-DOS disks (Amiga Workbench 2.0 or higher) or by using a terminal program on both ends and a null-modem cable. Lemon Amiga has more help on the subject here, they also explain how to transfer games.

Configuration

UAE is very configurable, so take some time to lookup how the configuration file format works. At start up UAE loads uaerc (default configurations) and, if it is present, uaerc.saved which will override uaerc. A lot of configuration options are configurable from the menu system and you can save the current configuration as uaerc.saved or as one of 5 configuration files (uaerc.user[1-5]).

The menu support allows selecting which amiga model to emulate. When switching model, UAE wii will try to load a matching kickstart image and thereafter reset the computer. If the kickstart is not found, it will keep the current, but remember that this might not give you a functioning Amiga. The model/kickstart mapping is as follows:

  • A1000: uae/roms/amiga-os-120.rom /uae/roms/kick12.rom
  • A500: uae/roms/amiga-os-130.rom /uae/roms/kick13.rom
  • A600: uae/roms/amiga-os-205.rom /uae/roms/kick205.rom
  • A1200: uae/roms/amiga-os-310.rom /uae/roms/kick31.rom

If you experience some problems in the emulation try to change the configurations. If you hear some glicthes in the sound or some slowing down try to set "CPU emulation accuracy" to fast, "CPU to chipset speed" to max, and possibly reduce the framerate. If you have some problems in the loading of files or in the emulation try to set "floppy speed" to normal, "CPU emulation accuracy" to compatible and "CPU to chipset speed" to real.

Usage

Wiimote 1 acts as both mouse in port 1 and joystick in port 2. To use Wiimote as mouse you have to point it towards the screen, also for the buttons. Some games require the disabling of the mouse emulation to work; others require the disabling of the second and third joystick button. You can also use a real mouse plugged into the usb port. There is a graphic virtual keybord called by "+" button which uses the IR Wiimote pointer.

In-emulator controls

WiimoteHorizontal.svg ClassicController.svg Nunchuck alternative.svg GameCube Controller USB Keyboard Action
Wiimote D-Pad Classic D-Pad Classic Left Control Stick Classic Right Control Stick Nunchuck Control Stick GameCube Control Stick Joystick direction
Wiimote 2 Button Classic a Button Gamecube A Button Fire button
Wii Remote Aim Wiimote A Button Wiimote B Button Mouse (A for left button, B for right)
Wiimote 1 Button Wiimote - Button Classic b Button Classic x Button Classic y Button Classic - Button Classic L Trigger Classic R Trigger Classic ZR Button Classic ZL Button Nunchuck C Button Nunchuck Z Button Configurable for keypresses in the menu
Wiimote HOME Button Classic HOME Button GameCube START Button F12 Enter menu
Wiimote + Button Classic + Button Enter graphic vitual keyboard

Menu controls

WiimoteHorizontal.svg Nunchuck alternative.svg ClassicController.svg GameCube Controller USB Keyboard Action
Wiimote D-Pad Nunchuck Control Stick Classic D-Pad GameCube Control Stick Up, Down, Left, Right Move up/down/left/right in the menu
Wiimote + Button Wiimote - Button Classic + Button Classic - Button GameCube R Trigger GameCube Z Button Pgup/Pgdown Move one page down/up in the menu
Wiimote 2 Button Wiimote A Button Classic a Button Classic x Button Gamecube A Button Gamecube Y Button Enter Select current entry
Wiimote 1 Button Classic b Button Classic y Button Gamecube X Button Esc Exit from menu

Development

The googlecode page for UAE Wii contains build instructions, first look at those if you want to build UAE Wii.

Reporting issues

Please report issues and feature requests in the uae-wii issue tracker on googlecode.

Changelog

Version 10

  • Added Gamecube controller support
  • Added graphic virtual keyboard with IR Wiimote pointer called by "+" button
  • Added Wiiflow support
  • Added new menus to save and load 5 configuration files
  • Added audio menu with new options
  • Path of last selected file remembered in the menu
  • Added Picasso96 memory configuration
  • Added number of floppies configuration
  • Added refresh rate option
  • Added blitter exact cycle option
  • Added 24/32 bit cpu address space option
  • Chip memory up to 8MB
  • Consistency check of configuration options with gui messages
  • Automatic reset emulator after memory or kickrom change
  • Removed noise entering the GUI
  • Fixed bug in blitter exact and adreess space configuration
  • Fixed bug in sound floppy configuration
  • Fixed bug in page up/down
  • Patch to increase rendering speed in double buffer mode
  • Case insensitive file order in the file menu

Version 9.1

  • Compiled against libogc 1.8.11 and SDL-Wii r101
  • Fixed full resolution in 576i video mode

Version 9

  • Added dms and zip support
  • Added drive sound
  • (build) Compiled against libogc 1.8.9

Version 8

  • Added rumble support
  • Added configurable aspect ratio
  • Reduced font size of list file menu
  • Utf8 font support

Version 7

  • Fixed Hardfile and virtual filesystem support
  • Added virtual keyboard
  • Added several menu options (immediate blits, collision level, real CPU speed, scanlines, ntsc and sound)
  • Menu reorganization
  • Other small improvements

Version 6

  • Added SMB support
  • Added USB FAT mass storage support
  • Many menu improvements (new colors, new popup messages, browsing with nunchuk, wider screen, etc.)
  • Added nunchuck menu browsing
  • Configuration file saved manually
  • Several improvements in input configuration menu (single wiimote configurations, snd and trd button joystick, enable/disable mouse emulation, etc.)
  • Name of the loaded file in the menu header
  • Added logfile option
  • Fixed correct aspect option (to adapt the Amiga screen to Wii screen)
  • Fixed mouse jerkiness
  • Fixed second Joystick configuration issue
  • Other small fixes

Version 5.1

  • (Binary) Rebuild against the latest devkitPPC (r24), libogc (1.8.7) and SDL (restores keyboard support)

Version 5

  • Fix the workbench graphics issue
  • (Binary) Rebuild against the latest devkitPPC, libogc and SDL (fixes some SD corruption issues caused by the old libfat)

Version 4

  • Support for the Mario Kart wheel in games where it makes sense to use it (stunt car racer!)
  • (Binary) Rebuild against the latest devkitPPC, libogc and SDL

Version 3

  • Correct banner showing errors. With this fix, a dialogue box is now opened if kick.rom is missing
  • Support Cloanto's amiga forever ROMs in the default config

Version 2

  • Allow configuring most important options from the menu (Amiga models etc)
  • Fix Nunchuk/Classic controller conflict
  • Add virtual keyboard to set keyboard-to-controller-button bindings
  • Store configuration when modified in the menu and allow uaerc.user to override the configuration
  • Saving and restoring states now work
  • Harddisk support is now built in, but works so-so (and has no menu support)
  • Hundreds of small fixes here and there

Version 1

  • Initial release
  • This version has only received light testing and there will be bugs
    • Graphics look bad in Workbench, but hey - who cares about that?
  • There is a menu, but few menu options actually work. Patches are welcome!

Other topics

License

UAE is GPLv2. I've always liked the "PostcardWare" concept though, so if someone likes the emulator, send a postcard to

Simon Kågström
Birkagatan 21A
113 36 Stockholm
Sweden

Other UAE Wii implementations

"Gouky" has ported UAE4All to the Wii as well, and has now also released the source code for it. You can get the source code here. Unfortunately, the differences between E-UAE and UAE4All are large, so it will be difficult to integrate changes from there.

Thanks to

  • The upstream developers who did more than 99.995% of the work!
  • Christopher Follett from the PSPUAE project who has implemented a large chunk of the Amiga setup code and made various other improvements
  • Tantric for the various improvements of SDL without which this would have been impossible
  • Knitax for various suggestions on the code and the icon
Personal tools
Resources
Community