Setting up emulators
To set up an emulator for use with BeebEF, select 'Edit|Emulators'
from the main screen, or press the 'Edit emulators' button on the tool
bar (the button with gears).
In the window that appears next, press the 'New' button. A new
windows then appears.
The window contains the following tabbed pages.
Emulator
- Name. The name of the emulator.
- File name. The file name of the emulator. Press the 'browse'
button (the button with the three dots) to select the file name.
- Command line switches (optional). Command line switches
required when running the emulator. If you enter any, don't forget to
include the - or / symbol.
- Environment variable (optional). This environment variable is
set to the specified value just before the emulator is run.
- Environment variable for ss disk images (optional). This
environment variable is only set to the specified value if the emulator
is run with a single sided disk image (*.ssd or *.img).
This is, for example, useful for BeebEm: it sets the environment
variable BeebDiscLoad0 (which specifies the disk image that is loaded
into drive 0) only to S:80:discims/test.ssd (which specifies a
particular single sided disk image) only for single sided disk images.
This is the correct value for single sided disk images, but not for
double sided disk images (which require the value D:80:disims/test.dsd).
- Environment variable for ds disk images (optional). This
environment variable is only set to the specified value if the emulator
is run with a single sided disk image (*.dsd).
Disk/rom images
- Disk images working directory. This is the disk working
directory of the emulator, the directory where its disk images should be
stored. Press the 'browse' button (the button with the three dots) to
select the directory.
- Disk image file name (optional). This field should be filled
out if the emulator expects a disk image of a particular name. This
field should then contain the name.
If this field is left blank, the disk image to be run is copied without
a name change to the emulator working directory. If this field is set,
the name of the disk image is overrided to the set name after copying.
Setting this field does not override the file extension of the disk
image (*.ssd, *.dsd, *.img, or *.adf).
- Remove disk image.... This deletes, after quitting an
emulator, the disk image that was run from the emulator working
directory. This is useful to prevent cluttering of the working
directory.
- Rom images working directory. This is the rom working
directory of the emulator, the directory where its rom images should be
stored. Press the 'browse' button (the button with the three dots) to
select the directory.
- Rom image file name (optional). These fields should be filled
out if the emulator expects a rom image of a particular name. These
fields should then contain the name.
If these fields are left blank, the rom image to be run is copied
without a name change to the emulator working directory. If these fields
are set, the name of the rom image is overrided to the set name after
copying.
Setting the first field overrides the base name of the rom image
(i.e., its file name without extension). Setting the second field
overrides the file extension of the rom image. This is, for example,
useful for the emulator 'PCBBC' which does not care about the base name
of a rom image, but which uses its extension to determine into which slot
the rom image is to be loaded (i.e., a rom image with extension 'ROA' is
loaded into slot A, 'ROB' into slot B, etc.).
- Remove rom image.... This deletes, after quitting an
emulator, the rom image that was run from the emulator working
directory. This is useful to prevent cluttering of the working directory
and to prevent automatic re-loading of the disk image if the emulator is
run again.
DFS Roms
Note: this page is disabled if you set up that
BeebEF should not handle emulator DFS's.
- Default DFS rom image file name. This is the file name
(without path, but with extension) of the default DFS rom image used by
the emulator.
In other words: BeebEF copies its default DFS rom (in
the directory 'DFSRoms') to a file with this name if you run a program
that requires a normal DFS.
- E00 DFS rom image file name. This is the file name of the E00
DFS rom image used by the emulator.
In other words: BeebEF copies
its E00 DFS rom (in the directory 'DFSRoms') to a file with this name if
you run a program that requires an E00 DFS.
Back to the main document