UAE Wii: Difference between revisions

From GameBrew
(Created page with "{{#seo: |title=Wii Homebrew Emulators (Computer) - GameBrew |title_mode=append |image=uaewii.jpg |image_alt=UAE Wii }} {{Infobox Wii Homebrews |title=UAE Wii |image=uaewii.jpg...")
 
No edit summary
Line 15: Line 15:
|license=GPL
|license=GPL
|download=https://dlhb.gamebrew.org/wiihomebrews/uaewii.7z
|download=https://dlhb.gamebrew.org/wiihomebrews/uaewii.7z
|website=#LNF
|website=https://web.archive.org/web/20130430045631/http://www.amigaemulator.org/
|source=https://github.com/Oibaf66/uae-wii
|source=https://github.com/Oibaf66/uae-wii
}}
}}
https://wiibrew.org/wiki/UAE_Wii
[https://web.archive.org/web/20130430045631/http://www.amigaemulator.org/ UAE] is a famous Amiga emulator ported to the Wii. UAE Wii can be found on Github at [https://github.com/Oibaf66/uae-wii github.com/Oibaf66/uae-wii], and is based on the source code of [http://www.rcdrummond.net/uae/ 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 5.1 the project is carried out by Fabio Olimpieri (Oibaf).
 
== 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/HD/
*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: [https://www.retroguru.com/sqrxz/ Sqrxz], [https://www.retroguru.com/sqrxz/ Sqrxz2], [https://www.retromagazine.eu/retro/2013-12/brandneu-fuer-amiga-500-solid-gold/ 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 [http://www.amigaforever.com 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 [http://aminet.net/package/util/cli/ks13tofile (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 [https://www.lemonamiga.com/help/faq_crossplatform.php 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, resolution to 320X240 and possibly reduce the framerate. Another very small improvement can be added setting "Collision level" to none (most of the games do not require the collision detection) and "leds" to off.
 
Most of the games can run at 100% framerate if the 320X240 resolution is set. Only very few AGA based games can not reach 50 fps.
 
If you have some problems in loading the files or in the emulation try to set "floppy speed" to normal, "CPU emulation accuracy" to compatible and "CPU to chipset speed" to real.


==Screenshots==
==Media==
==Media==
<youtube></youtube>
<youtube>vriALklKyng</youtube>
 
== 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 ===
{| class="wikitable"
|-
! Wiimote Horizontal !! Classic Controller !! Nun chuck !! GCN Controller !! USB Keyboard !! Action
|-
| Wiimote DPad || Classic DPad / Classic L Control Stick / Classic R Control Stick || Nunchuck Control Stick ||GC Control Stick || || Joystick direction
|-
| Wiimote 2 Button || Classic A Button || || GC A Button || || Fire button
|-
| Wiimote Aim / Wiimote A Button / Wiimote B Button || || || || || Mouse (A for left button, B for right)
|-
| Wiimote 1 Button / Wiimote Minus Button || Classic B Button / Classic X Button / Classic Y Button / Classic Minus 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 || ||GC Start Button || F12 || Enter menu
|-
|Wiimote Plus Button || Classic Plus Button || || || || Enter graphic vitual keyboard
|}
 
=== Menu controls ===
{| class="wikitable"
|-
! Wiimote Horizontal !! Nunchuck  !! Classic Controller !! GC N Controller!! USB Keyboard !! Action
|-
| Wiimote DPad || Nunchuck Control Stick || Classic DPad|| GC Control Stick || Up, Down, Left, Right ||Move up/down/left/right in the menu
|-
| Wiimote Plus Button / Wiimote Minus Button || || Classic Plus Button / Classic Minus Button || GC R Trigger / GC Z Button || Pgup/Pgdown || Move one page down/up in the menu
|-
| Wiimote 2 Button / Wiimote A Button || || Classic A Button / Classic X Button || GC A Button / GC Y Button || Enter || Select current entry
|-
| Wiimote 1 Button || || Classic B Button / Classic Y Button || GC X Button || Esc || Exit from menu
|}
 
== Changelog ==
''' Version 12 '''
* Added background image in the GUI
* Added sound in the GUI
* Horizontally scrolling menu
* More readable fonts in the GUI
* Added autofire (configurable from virtual Keyboard)
* Added vsync option
* Moved Rumble option in wiimote menu
* Changed the refresh rate option
* Shorter bootstrap
* Fixed file attributes in virtual filesystem emulation
* Other bug fixes
 
''' Version 11 '''
* Update to E-UAE 0.8.29 (more compatibility)
* Added 320X240 resolution (more emulation speed)
* Added hardfile and Virtual File System support in the GUI
* Amiga colors for GUI, added borders to the windows
* Set sound frequency to 48k
* Small bug fixes
 
''' 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!
 
== 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
* Indigo69 for the background image of the menu
 
== External links ==
* Official Website - https://web.archive.org/web/20130430045631/http://www.amigaemulator.org/
* Wiibrew - https://wiibrew.org/wiki/UAE_Wii
* Github - https://github.com/Oibaf66/uae-wii

Revision as of 03:18, 21 September 2022

UAE Wii
File:Uaewii.jpg
General
AuthorSimon Kagstrom, Oibaf
TypeComputer
Version12
LicenseGPL
Last Updated2015/01/24
Links
Download
Website
Source

UAE is a famous Amiga emulator ported to the Wii. UAE Wii can be found on Github at github.com/Oibaf66/uae-wii, 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 5.1 the project is carried out by Fabio Olimpieri (Oibaf).

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/HD/
  • 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, resolution to 320X240 and possibly reduce the framerate. Another very small improvement can be added setting "Collision level" to none (most of the games do not require the collision detection) and "leds" to off.

Most of the games can run at 100% framerate if the 320X240 resolution is set. Only very few AGA based games can not reach 50 fps.

If you have some problems in loading the files or in the emulation try to set "floppy speed" to normal, "CPU emulation accuracy" to compatible and "CPU to chipset speed" to real.

Media

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

Wiimote Horizontal Classic Controller Nun chuck GCN Controller USB Keyboard Action
Wiimote DPad Classic DPad / Classic L Control Stick / Classic R Control Stick Nunchuck Control Stick GC Control Stick Joystick direction
Wiimote 2 Button Classic A Button GC A Button Fire button
Wiimote Aim / Wiimote A Button / Wiimote B Button Mouse (A for left button, B for right)
Wiimote 1 Button / Wiimote Minus Button Classic B Button / Classic X Button / Classic Y Button / Classic Minus 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 GC Start Button F12 Enter menu
Wiimote Plus Button Classic Plus Button Enter graphic vitual keyboard

Menu controls

Wiimote Horizontal Nunchuck Classic Controller GC N Controller USB Keyboard Action
Wiimote DPad Nunchuck Control Stick Classic DPad GC Control Stick Up, Down, Left, Right Move up/down/left/right in the menu
Wiimote Plus Button / Wiimote Minus Button Classic Plus Button / Classic Minus Button GC R Trigger / GC Z Button Pgup/Pgdown Move one page down/up in the menu
Wiimote 2 Button / Wiimote A Button Classic A Button / Classic X Button GC A Button / GC Y Button Enter Select current entry
Wiimote 1 Button Classic B Button / Classic Y Button GC X Button Esc Exit from menu

Changelog

Version 12

  • Added background image in the GUI
  • Added sound in the GUI
  • Horizontally scrolling menu
  • More readable fonts in the GUI
  • Added autofire (configurable from virtual Keyboard)
  • Added vsync option
  • Moved Rumble option in wiimote menu
  • Changed the refresh rate option
  • Shorter bootstrap
  • Fixed file attributes in virtual filesystem emulation
  • Other bug fixes

Version 11

  • Update to E-UAE 0.8.29 (more compatibility)
  • Added 320X240 resolution (more emulation speed)
  • Added hardfile and Virtual File System support in the GUI
  • Amiga colors for GUI, added borders to the windows
  • Set sound frequency to 48k
  • Small bug fixes

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!

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
  • Indigo69 for the background image of the menu

External links

Retrieved from ‘https://www.gamebrew.org/index.php?title=UAE_Wii&oldid=85988’

Advertising: