Complete Guide for Commodore Amiga in HS and HL3 Using WinUAE Only

[rfancella]

Hello All,
This is a companion guide to: http://www.hyperspin-fe.com/topic/2390-complete-guide-for-commodore-amiga-in-hyperspin-and-RL/ so much of the information will be the same. I wanted a guide that goes from start to finish. All the information for this one is in the above guide.
Only this guide will use only WinUAE as the Default Emulator.

NOTICE: be sure you have the latest WinUAE HyperLaunch module (at least v2.0.2) or this will not work.


Scope:
This guide is to help the community to setup a Commodore Amiga wheel in HyperSpin using:
HyperSpin v1.3.2.0
HyperLaunch v3.0.1.0
HyperLaunchHQ v1.0.12.0
WinUAE v3.2.0 - Download page: http://www.winuae.net/frames/download.html
WinUAE Loader v1.78 - Download page: http://headsoft.com.au/index.php?category=winuaeloader (We will only use some of the files in this program **WHDLoad_usr.lha**)
WHDLoad v17.2 - Download page: http://whdload.de/

Note: For most games to work, you need a valid WHDLoad key. It can be purchased from the WHDLoad website link above.


Introduction:
I will skip this part as it's in the guide listed above. If you are interested in some information about the Amiga and the company that built it, refer to that guide.


Ok, let's get started:

The directory structure we are going to use is this:

• H:\HyperSpin - Your HyperSpin instillation.
• H:\HyperSpin\Emulators\WinUAE - The WinUAE emulator
• H:\HyperSpin\Emulators\WinUAE\WHD - The Amiga OS directory ripped out of WinUAELoader.
• H:\HyperSpin\Emulators\WinUAE\WHD\Devs\Kickstarts - Amiga WHDLoad kickstart roms.
• H:\HyperSpin\Emulators\WinUAE\WHD\S - (Optional) Where your WHDLoad registration key and configuration file goes.
• H:\HyperSpin\Emulators\WinUAE\WHD\C - We will put the new version of WHDLoad here.
• H:\HyperSpin\Emulators\WinUAE\rom - Your Amiga OS roms.
• H:\HyperSpin\Emulators\WinUAE\Configurations\Host - WinUAE Amiga host configuration file.
• H:\HyperSpin\HyperLaunch\Modules\WinUAE - Settings.ini and Commodore Amiga.ini configuration files for HyperLaunch.

Go ahead and download WinUAE, WinUAELoader and WHDLoad from the links above.
Extract WinUAE into your H:\HyperSpin\Emulators directory and rename it to WinUAE:



Next we need to install the Amiga boot and OS roms. Create a directory inside WinUAE called rom and place your files there:



Next we will extract the required files from the WinUAELoader archive you downloaded into the WinUAE directory. Open up the WinUAELoader archive and extract the WHD directory and it's contents in the WinUAE directory:



Next we will update WHDLoad to the most current version. Open the WHDLoad archive you downloaded and extract the S and C directory into your H:\HyperSpin\Emulators\WinUAE\WHD directory. When prompted, overwrite all the files:



The next step is optional. If you have purchased WHDLoad, place your WHDLoad.key file in the H:\HyperSpin\Emulators\WinUAE\WHD\S directory:



Ok, almost done with the initial setup. You will need to copy all of your kickstart roms into H:\HyperSpin\Emulators\WinUAE\WHD\Devs\Kickstarts:



The last couple steps are to make sure your module ini files are in order.
Navigate to H:\HyperSpin\HyperLaunch\Modules\WinUAE and there you should see a bunch of files:



If there is not a Commodore Amiga.ini or Settings.ini, copy the Commodore Amiga (Example).ini and rename it as Commodore Amiga.ini. Do the same for the Settings.ini file.

That's it for the folder structure. Now we need to launch WinUAE and get it configured.


Running WinUAE for the first time:

Navigate to H:\HyperSpin\Emulators\WinUAE and run the file winuae.exe



Select Paths on the top left. Below all the path settings is a drop down box, change it to WinUAE default (EXE directory) and hit the Reset to defaults button. That should set all the above paths to your WinUAE directory:



Click the Rescan ROMs button and it should find the boot and OS roms. Click the OK button:



Some of the following steps are optional also, but you will see all the configuration options. Click on Quickstart on the top left. Set the Model: to A1200 and Configuration as seen below:



Next, click on ROM and choose KS ROM v3.1... as shown below:



Now select Display on the left. Choose your options:



NOTE: As quoted by vindic8r here: http://www.hyperspin-fe.com/forum/showthread.php?31472-Complete-Guide-for-Commodore-Amiga-in-HS-and-RL-Using-WinUAE-Only&p=305000&viewfull=1#post305000
 

 

[sNIP]

3) This is probably only of interest to a handful of weirdos like me who are using standard resolution arcade monitors in their cabs w/ an ArcadeVGA, but I found I had to use very specific Display settings to get WinUAE to work properly. Fortunately, there was a thread over on BYOAC that had what I needed:
http://forum.arcadecontrols.com/index.php?topic=83484.0

[/sNIP]

On to Game ports to configure your controller:




NOTE: As quoted by vindic8r here: http://www.hyperspin-fe.com/forum/showthread.php?31472-Complete-Guide-for-Commodore-Amiga-in-HS-and-RL-Using-WinUAE-Only&p=305000&viewfull=1#post305000
 

 

[sNIP]

1) Remapping controls in WinUAE isn't necessarily intuitive. It took me a while to realize that you need to double-click on the key assignment listed under the function, i.e. "Joy 1 Left", to start the remap process.

[/sNIP]

Almost done! Now to save the configuration. Click on Configurations on the top left. Click the Save As... button:



You should now see a save as dialogue box. We want to save the configuration file as amigahost.uae in the H:\HyperSpin\Emulators\WinUAE\Configurations\Host directory:



That's it for WinUAE!!! Go ahead and close out WinUAE by clicking the Quit button.
Now, on to HyperHQ and HyperLaunchHQ!


Setup HyperHQ:

Navigate to H:\HyperSpin and launch HyperHQ to setup your new Commodore Amiga wheel. Be sure and name it "Commodore Amiga" so HLHQ will find it and everything will match up.
Click the Main Menu Wizard tab and add your system. Once the wheel is created, click Wheel Settings and choose Commodore Amiga in the dropdown.
Set your "Rom Path:" and "Extensions:" as shown below:



Note: The next step is only required if you use HyperHQ for filtering your roms.

If you are using HyperHQ to filter your roms. Click on Navigation/Themes as make the following changes:



Now close out HyperHQ and launch HyperLaunchHQ.
Make sure GLOBAL is selected on the top left. Then select the Emulators tab on top. Scroll down and find WinUAE and double-click.
Set your Path to WinUAE and close out that window:



Select Commodore Amiga on the left and Settings across the top. In the Main Settings sub-tab change 7z Enabled to false:



Now we need to set the PathToWHDFolder. Make sure Commodore Amiga is selected on the left. Click on Modules on the top. Select WinUAE.ahk and click the Edit System Speciffic Modules Settings button:



Use the browse Magnifying Glass to browse to H:\HyperSpin\Emulators\WinUAE\WHD and hit the OK button:



Click on the Emulators sub-tab. Hit the green plus next to Rom Paths and point it to your Amiga WHDLoad roms. Click the Magnifying glass and select WinUAE [Global] as your Default Emulator:



Close out that window and click on the Games tab on top and make sure the System Audit is selected. Click the blue play button to audit the games. Select one and hit the Launch Selected game... button to see if it works:




Thank you for reading and please feed me your results and comments!

Thank you,
Ron

PS: I have a how-to make WHDLoad installed packages from an Amiga Desktop further down in this thread:
http://www.hyperspin-fe.com/forum/showthread.php?31472-Complete-Guide-for-Commodore-Amiga-in-HS-and-RL-Using-WinUAE-Only&p=299854&viewfull=1#post299854

[rfancella]

Changes and additions will be posted below:

Here is a post on how to change your controls in WinUAE after you have it all setup:

http://www.hyperspin-fe.com/forums/topic/2702-complete-guide-for-commodore-amiga-in-hs-and-hl3-using-winuae-only/?do=findComment&comment=107904

Here is a post on how to create per-game configurations. This is helpful if you need to change controller assignment for a specific game and don't want to set these every time you launch the game:

http://www.hyperspin-fe.com/forums/topic/2702-complete-guide-for-commodore-amiga-in-hs-and-hl3-using-winuae-only/?do=findComment&comment=112262

Thanks,

Ron

[brolly]

Seems good to me, nice work. Just a couple of notes:

- PathToWHDFolder shouldn't be enclosed by double quotes, kinda surprised it actually works that way. Also I don't like users to be editing ini files manually as that will eventually lead to problems, would be better if you include setting this up in the HLHQ part of the guide. That's why HLHQ was created in the first place ;

- The quickstart and ROM selection on WinUAE aren't needed, configuring this won't do anything because this info isn't saved in a host config file;

Other than it's fine, seems easy for everyone to follow.

[Deadly]

Nice job Ron!

[Dirilu]

Thanks for your complete guides. This was a big help for me since many of my WHD games did not work without issues with winuaeloader. Now all is good. These guides need to be sticky.. :-)

[potts43]

Ron,

What roms are required here? I've set mine up using your WHDLoader tutorial and uses the preinstalled whd roms. Does this use the same ones or Adf etc?

[rfancella]

Seems good to me, nice work. Just a couple of notes:

- PathToWHDFolder shouldn't be enclosed by double quotes, kinda surprised it actually works that way. Also I don't like users to be editing ini files manually as that will eventually lead to problems, would be better if you include setting this up in the HLHQ part of the guide. That's why HLHQ was created in the first place ;

- The quickstart and ROM selection on WinUAE aren't needed, configuring this won't do anything because this info isn't saved in a host config file;

Other than it's fine, seems easy for everyone to follow.

Brolly,

Thank you for your review and input. I didn't see a place to put in the path. Dug around some more in HLHQ and found it!! Nice! I will fix that. Wow, never saw those settings before. I thought that would be in Global Module Settings not System Specific Settings.

The reason I put in the Quickstart section is because it set's CPU, FPU, etc... settings. You are correct, it does not store the settings for that screen, but the settings it changes are stored.

Again, thank you Brolly!

Thanks,

Ron

[rfancella]

Ron,

What roms are required here? I've set mine up using your WHDLoader tutorial and uses the preinstalled whd roms. Does this use the same ones or Adf etc?

Potts,

For this guide, the pre-installed WHDLoad packages. I am working on and adf setup now.

Thanks,

Ron

[potts43]

Hopefully this setup will sort out some errors.

[potts43]

So...this setup is preferable to your WHDLoader setup? Is it because it negates having to use WHDLoader program? How does HLHQ pass the individual game params to WinUAE as the whdload.xml had them and that appears to be missing?

[rfancella]

Seems good to me, nice work. Just a couple of notes:

- PathToWHDFolder shouldn't be enclosed by double quotes, kinda surprised it actually works that way. Also I don't like users to be editing ini files manually as that will eventually lead to problems, would be better if you include setting this up in the HLHQ part of the guide. That's why HLHQ was created in the first place ;

- The quickstart and ROM selection on WinUAE aren't needed, configuring this won't do anything because this info isn't saved in a host config file;

Other than it's fine, seems easy for everyone to follow.

Brolly,

Question...

Could the PathToWorkbenchBase image be a HDF or rp9 image?? I'll read through the module and see how it works.

Thanks,

Ron

[rfancella]

So...this setup is preferable to your WHDLoader setup? Is it because it negates having to use WHDLoader program? How does HLHQ pass the individual game params to WinUAE as the whdload.xml had them and that appears to be missing?

Potts,

The majority of the settings required for the WHDLoad game to run is in the WHDLoad package. It sets what boot and OS roms and the OS variables needed to make the game run. That info is in the slave. Or at least, that's the way I understand it.

http://whdload.de/docs/en/howto.html

I'll do a little write up here on how to install WHDLoad packages... Hopefully today!

Thanks,

Ron

[rfancella]

Hopefully this setup will sort out some errors.

I already have some reports that going this route does solve some problems with some games.

Thanks,

Ron

[potts43]

Much appreciated Ron!

[showstopper]

Great tutorial. Maybe put something in near the start that says this only really works with a valid whdload.key. otherwise you can't use whdfiles.

Sent from my GT-I9300 using Tapatalk

[rfancella]

Great tutorial. Maybe put something in near the start that says this only really works with a valid whdload.key. otherwise you can't use whdfiles.

Sent from my GT-I9300 using Tapatalk

Noted. Won't work for most games? I believe some will work. But i've always had a key. So i'm not sure. Can someone validate that??

Thanks,

Ron

[showstopper]

Ok maybe not most but a fair chunk.

Sent from my GT-I9300 using Tapatalk

[rfancella]

Ok maybe not most but a fair chunk.

Sent from my GT-I9300 using Tapatalk

Thank you for the input! Changes made.

Thanks,

Ron

[rfancella]

Much appreciated Ron!

Potts,

Not a problem... I love the Amiga!!! (If you can't tell)

So, you have Amiga Forever. With it should be an AmigaSYS System. That's what we will use for creating the installed game from the adf images and the WHDLoad installer.

I chose AmigaSYS because it comes with a Work drive that is a Windows directory. On my install, it's at c:\Users\Public\Documents\Amiga Files\Shared\dir\AmigaSYS4-Work

So the first step is to download the WHDLoad Installer from http://whdload.de

Go to the website. Click on Installs on the very top of the page. In the section Games, click on the PR-PY link. Scroll down to the bottom and download the Putty Squad installer. It's an LHA file, but that's ok. Amiga uses them just fine.

Copy that file to your AmigaSYS4-Work directory.

Next, grab the adf disc images for Putty Squad and put them somewhere you know where they are. You will need to mount them with Amiga Forever.

Now, go ahead and launch the AmigaSYS system from the Amiga Forever Player.

Once you see the desktop:

Double click the Work icon. That will open the Work drive. Right click somewhere inside that window, click on Window, go over to Show and click All Files:

Find the Putty Squad.lha icon and double click it. That will open up Packmaster. Hit the Unpack button:

That will extract the contents into your Ram Disk. Click the Close button as described in the window. Then close Packmaster and the Work folder.

Open the Ram Disk by double clicking on it's icon at the top left of the screen. Then open the PuttySquadHD drawer. There you will find the Install program.

Now, we mount the ADF image for Disc One. Hold down the escape key on your keyboard to release the mouse. At the very bottom left of the screen you will see a floppy disc image. Left click on it, then Insert and From File...

Browse to where the Putty Squad adf files are at and load the first disk. Double click the Install icon on your Desktop to start the install process.

Click Proceed twice and close the Read Me file. If it doesn't default to the Selected Drawer: Work: then hit the Show Drives button and click on Work: and hit Proceed.

It will ask what Icon do you want. I always choose the OS3.5 Icon or NewIcon. Click Proceed again.

Choose DF0: and hit Proceed.

Hit the Start button and it will read the first disk. It will get about half way through and ask you for Disk 2. Hold escape to release the mouse and mount the second disk.

Hit Start for the last time. It will read the second disk and finish out. Close the last Install box by hitting the Proceed button.

Thats all. Its done. You can check your work by opening the Work Drive from the icon on your desktop and run the game. If everything works. Close out the AmigaSYS workbench and Amiga Forever Player.

Now, navigate to your AmigaSYS4-Work folder and there should now be a PuttySquad folder and PuttySquad.info file. Zip both these up and you now have a Working Putty Squad WHDLoad install!!!

Comments and suggestions are always welcome.

Thanks,

Ron

[potts43]

I love the amiga too. Still have an a1200 going yellow in the loft! This tutorial is brilliant but a lot to take in. I will have to read it many times until I Suss it.

Your tuts are without doubt a great help to all of us. The pics speak a thousand words!

[rfancella]

I love the amiga too. Still have an a1200 going yellow in the loft! This tutorial is brilliant but a lot to take in. I will have to read it many times until I Suss it.

Your tuts are without doubt a great help to all of us. The pics speak a thousand words!

Potts,

Really??? Get that bad boy out! Some vinegar will clear up that yellowing! And there are tons of addons to bring that bad boy up to date!

Ugh! Pictures good!

LOL...

Thanks,

Ron

[potts43]

Addons? Interesting...

[rfancella]

Addons? Interesting...

What HDD do you have in it?? There are a handful of IDE to CF adapters for it. Video adapters. Network adapters... etc.

Check out these guys:

http://amigakit.leamancomputing.com/catalog/?currency=GBP&currency=GBP

EDIT:

Expensive... but will allow you to connect a DVI monitor: http://amigakit.leamancomputing.com/catalog/product_info.php?cPath=82&products_id=1148

A CF to IDE HDD: http://amigakit.leamancomputing.com/catalog/product_info.php?products_id=883

Thanks,

Ron

[potts43]

Cheers for the info. It has a Hdd but it's been a while (years) since I fired it up. It has an excelerator card too!

[brolly]

Brolly,

Question...

Could the PathToWorkbenchBase image be a HDF or rp9 image?? I'll read through the module and see how it works.

Should be a HDF or VHD file, but could probably work with any of the supported WinUAE HDD files, but I only tested with these 2. I should probably limit the extensions in the ISD. You'll only need to have this setting configured if you want to run games that require Workbench to be installed btw.