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. In the window that appears next, press the 'New' button. A new
windows then appears.
The window contains the following tab 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). Some emulators support command line switches. 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 set to the specified value only if the emulator
is run with a single sided disk image (*.ssd, *.img or *.bbc).
- Environment variable for ds disk images (optional). This
environment variable is set to the specified value only 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 a disk image to be run
(or a file with BBC software in another format, e.g., a zipped standard
archive file) 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 (or archive file) 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, .bbc, .adf, .uef, or .zip).
- Remove disk image.... This deletes from the
emulator working directory, after quitting an
emulator, the disk image (or archive file) that was run. 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 a rom image to be used
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.
- 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 rom if the emulator is
run again.
- Process BeebEm 'roms.cfg' file... (BeebEm
BBC B). This tells BeebEF to update the BeebEm 'roms.cfg' file (which determines
the rom images that are loaded by BeebEm) when a rom image is to be used by BeebEm. If
the previous option (remove rom image...) was selected, this also updates the
BeebEm 'roms.cfg' file after removing a rom image from the BeebEm working
directory. Always select this option for BeebEm (version 1.32 or higher) BBC B
emulation.
- Process BeebEm 'roms.cfg' file... (BeebEm
Master 128). The same option as the previous one, only for BeebEm (version 1.32 or
higher) Master 128 emulation.
DFS handling

- Enable DFS handling by BeebEF. Select
this option to have BeebEF automatically install the right DFS rom for a
program when you run an emulator. BeebEF comes 'installed' with two DFS roms:
a normal DFS and an E00 DFS (which keeps page at &E00--handy for
tape-based programs).
If you select this option, BeebEF will automatically install the right DFS for
every program you run in an emulator. If you leave this option unselected, the
emulator will use its normal DFS.
Note. The DFS roms in the BeebEF directory 'DFSRoms' are the default Acorn 1.2
DNFS rom and the Solidisk E00 1.2 DFS Rom. You may change these for any DFS
roms you like, as long as you use the correct file names: 'DFS.ROM' and
'E00DFS.ROM', respectively.
- 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.
Note that in order to
make the E00 DFS work, you need to allow write
operations to the sideways rom/ram slot which it was loaded.
Click here for tips on configuring BeebEF
for various emulators.