Sunday 26 August 2012

Configuration

UAE takes it's cues from the configuration file "Default.fs-uae" - this sits in the /Documents/FS-UAE/Configurations/ directory. This is going to be quite a large post... Here's the version I am currently using to boot into an Amiga system with emulated hard drives and graphics card:

# FS-UAE example configuration file
# The encoding of the configuration file must be UTF-8 (or ASCII)
#
# All paths can be either absolute, or relative to the current working
# directory. The same is true for all paths in the configuration file.
#
# If you on Windows specify paths with backslash, you must escape them
# (use \\ instead of just \ - c:\\path\\to\\file). You can also just use
# forward slashes instead (c:/path/to/file).
#
# You can start paths with ~/ or $HOME/ to refer to the user's home.
# Example: ~/Documents/Floppies/example.adf
#
# There are many options available to configure FS-UAE.
# See http://fengestad.no/wp/fs-uae/configuration
# for a complete list of configuration options with documentation

[config]
amiga_model = A4000/040
kickstart_file = /Users/amipal/Documents/FS-UAE/Kickstarts/kick31.rom
floppy_drive_0 =  C:/Amiga/Floppies/Disk.adf
chip_memory = 2048
fast_memory = 8192
zorro_iii_memory = 65536
bsdsocket_library = 1
hard_drive_0 = /Users/amipal/Documents/FS-UAE/Hard Drives/workbench/
hard_drive_1 = /Users/amipal/Documents/FS-UAE/Hard Drives/work/
hard_drive_2 = /Users/amipal/Documents/FS-UAE/Hard Drives/games/
uae_gfxcard_size = 16
fullscreen = 1
fullscreen_mode = fullscreen
fsaa = 2
cdrom_drive_0 = /Users/amipal/Documents/FS-UAE/CD-ROMs/AmigaOS3.9.iso
The file starts at the [config] line - all lines prior to that are comments using a hash. I'll go through each line one at a time to attempt to fully explain them. Please note that for more detailed explanations of the config file, the help on the FS-UAE homepage is invaluable.


amiga_model
FS-UAE has a list of pre-defined models to use, so unlike other version of UAE, you don't need to establish CPU type etc. Models available are: A500, A500+, A600, A1200, A1200/020, A4000/040, CD32, CDTV

kickstart_file
Locating of the Kickstart ROM file. If you've setup the directories with the Launcher, then it should be in your /Documents/ folder.

floppy_drive_0
Point this to any .adf file you want to boot from. Mine is set to "Disk.adf" as I want to boot from the hard disk. The Amiga's boot priority will want to boot from floppy first.

chip_memory
Amiga memory is divided into different blocks. All Amigas come with Chip memory - this is Shared between the CPU and custom chips. The A500 had 512 KB of it, while later Amigas had 1 MB as standard. AGA Amigas like the A1200, A4000 and CD32 have 2 MB.
The amiga_model setting will set this for the specific model but you can override with this setting. Values are in kilobytes.

fast_memory
The type of memory is only available for use by the CPU itself, hence why it is "fast". For games, you won't need to set this unless you're running a much later release. If you're booting into Workbench, however, it is very useful. Values are in kilobytes.

zorro_iii_memory
Zorro was a bus system for the Amiga - think of PCI for the PC. All manner of expansions were available, including 24-bit graphics cards. If you'll be installing Picasso96 to drive an emulated graphics card, you'll need to assign some ZIII memory. You'll also need to make sure you set the amiga_model to A1200/020 or A4000. Values are in kilobytes.

bsdsocketlibrary
This is to allow the emulated Amiga to connect to the internet. I haven't attempted this yet, but have already enabled with a value of 1.

hard_drive_0
Hard drives can be created by simply pointing this at a directory location. You can create a number of hard drives just by incrementing the number. You can boot from a hard drive if you have Workbench installed. Luckily, this came supplied on CD when I purchased my AmigaOne system from Eyetech so I already had a bootable system. My suggestion would be to purchase AmigaForever from Cloanto.

uae_gfx_card_size
Assign some memory to a Picasso96 graphics card. You will only need to do this if you decide to install an emulated graphics card - not normally required for classic OCS/ECS/AGA games. Values are in megabytes.

fullscreen
This flags whether to start the emulation in fullscreen or not. A zero value will open in a window. Not that you cannot change this once the emulation has started, so make sure you have the correct setting you want.

fullscreen_mode
Switches to real fullscreen if supported by your version of MacOSX.

fsaa
This enables anti-aliasing, accepted values are 0, 2, 4, 8. Set to your liking, but may affect speed.

cdrom_drive_0
Point this to an .ISO file if you want to read from a CD. This is how I was able to install AmigaOS3.9 on my emulated Amiga.

Note that I've added a couple of config URLs to the left pane if you require further help with the configuration file, or additional changes to the video options.

No comments:

Post a Comment