Difference between revisions of "UAE Wii"

	UAE
General
Author(s)	Simon Kagstrom
Type	Computer emulator
License	GPL
Links
	Download
	Source
	Downloadable via the Homebrew Browser
Peripherals

Revision as of 12:22, 27 November 2011

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.

You can read about the current status on my blog. Interested developers should mail me at simon.kagstrom@gmail.com and I'll give you commit access to the googlecode repository.

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/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. You can also load the images from usb HD or from computer through SMB protocol.

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. 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. There are three configuration files, uaerc, uaerc.saved and uaerc.user. A lot of configuration options are configurable from the menu system, and UAE wii will save the current configuration as uaerc.saved if something has been changed. The contents of this file will override the defaults in uaerc, and the contents of uaerc.user (optional) will override both other configuration files.

You can also load games from your computer with a wi-fi connection through SMB protocol. You should configure uaerc.smb file and select the option in the option menu. See the tinysmb page for additional information and troubleshooting.

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

Usage

Wiimote 1 acts as both mouse in port 1 and joystick in port 2. 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 usb port. Button mapping should be filled in here.

In-emulator controls

				Action
				Joystick direction
				Fire button
				Mouse (A for left button, B for right)
				Configurable for keypresses in the menu
			F12	Enter menu

Menu controls

				Action
			Up, Down, Left, Right	Move up/down/left/right in the menu
			Pgup/Pgdown	Move one page down/up in the menu
			Enter	Select current entry
			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 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!

@@ Line 5: / Line 5: @@
 | type        = computer emulator
 | author      = [[User:SimonKagstrom|Simon Kagstrom]]
-| download    = http://uae-wii.googlecode.com/files/uae-wii-6-bin.tar.gz
+| download    = http://uae-wii.googlecode.com/files/uae-wii-7-bin.tar.gz
 | source      = http://uae-wii.googlecode.com
 | peripherals = {{wiimote2}} {{Nunchuck}} {{ClassicController}} {{USBKeyboard}} {{USBMouse}} {{FrontSD}} {{USBMSD}} {{WiFi}}
@@ Line 99: / Line 99: @@
 == Changelog ==
+==== 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 ====