![]() |
A number of aspects of the simulation can be changed to correspond with typical hardware and software changes that would have been made to real machines.
This configuration is controlled by a set of system properties that are processed when the simulator starts up. There are a number of different ways in which these properties may be provided. Combinations of these methods can also be used, with properties from later in the list taking precedence over those earlier in the list:
uk101.properties
can be
placed in the same directory as the program JAR file.
This can be useful if you always want to set some specific
property values.-configuration
(or
-c
) can be used to point to an alternative properties
file.
This is useful if you want to keep a number of different
configurations available.-properties
(or
-p
) can be used to apply one or more property
overrides from the command line.
If more than one property is required a semicolon should be used
to separate them.
This can be useful to temporarily try the effect of an
individual property or two.
As an example the following start-up command could be used to start up the simulation temporarily with a large size, green display and a 2MHz CPU:
java -jar uk101-n.n.n.jar -p cpu.speed=2;screen.size=2;screen.colour=green
An example of a Java properties file that contains the default configuration can be found in the file:
samples/properties/uk101.properties
An example of a Java properties file that contains settings suitable for emulating an Ohio Scientific Superboard II can be found in the file:
samples/properties/superboard.properties
The following sections list all the property names and property values that can be used. Note that property names and values are case-sensitive.
This setting controls details of the CPU.
Name | Values | Default | Notes |
---|---|---|---|
cpu.speed |
0 , 1 or 2 |
1 |
This defines the maximum simulated CPU speed in MHz.
A standard 6502 ran at 1Mhz but most could be over-clocked to 2Mhz quite
successfully, which doubles the speed of the machine (although some
games may then run too fast).
Setting a value of |
Note: This setting represents a maximum simulation speed. It is possible that an older or slower PC will not be able reach the maximum requested.
These settings control details of the installed RAM and ROMs.
Name | Values | Default | Notes |
---|---|---|---|
ram.size |
from 4 to 40 |
8 |
This defines amount of RAM installed in KBytes. the standard machine came with 4KB and there were sockets on the board to allow up to 8KB to be installed. In theory, with an expansion board, up to another 32KB could be installed giving an absolute maximum contiguous RAM of 40KB. |
rom.monitor |
MONUK02.ROM or filename | This defines the monitor ROM that is installed.
The value can be the built-in name MONUK02.ROM or it can
be the name of a file containing a replacement ROM.
Several better replacement ROMs were available for the UK101, the
most popular being the CEGMON ROM. |
|
rom.basic |
BASUK101.ROM or filename | This defines the BASIC ROM that is installed.
The value can be the built-in name BASUK101.ROM or it can
be the name of a file containing a replacement ROM. |
|
rom.charset |
CHGUK101.ROM or filename | This defines the video character generator ROM that is installed.
The value can be the built-in name CHGUK101.ROM or it can
be the name of a file containing a replacement ROM. |
This setting controls the default baud rate for the ACIA.
Name | Values | Default | Notes |
---|---|---|---|
baud.rate |
from 110 to 115200 |
300 |
This defines default baud rate of the ACIA.
Some programs (in particular some games) relied on the ACIA control signals to generate accurate timings that were independent of the CPU speed. |
Note: The ACIA baud rate setting is ignored when reading or writing to a simulated cassette tape, these operations simply run as fast as they can.
This settings controls the keyboard layout and available keys.
Name | Values | Default | Notes |
---|---|---|---|
keyboard |
uk or us |
uk |
This defines keyboard layout and the available keys.
The setting uk gives a UK101 keyboard and the setting
us gives an Ohio Scientific Superboard II keyboard. |
These settings control the details of the video hardware.
Name | Values | Default | Notes |
---|---|---|---|
video.rows |
from 16 to 32 |
16 |
This defines the number of rows in the video buffer. |
video.cols |
from 32 to 64 |
64 |
This defines the number of columns in the video buffer. |
Note: The settings of the video hardware define the amount of video RAM (rows x columns rounded up to the nearest 1K boundary) and the geometry of screen buffer. This is not quite the same as what gets displayed on the screen as real UK101's simple video hardware was not able to scan all of the memory locations to the TV output. Some characters we "lost" from the beginning and end of each scan line. The screen display section configures this.
These settings control the appearance of the video output.
Name | Values | Default | Notes | ||||
---|---|---|---|---|---|---|---|
screen.width |
from 16 to 64 |
48 |
This defines the number of characters visible on each screen line. | ||||
screen.offset |
from 0 to 63 |
13 |
This defines the offset of the first visible character on each row of the hardware video buffer. | ||||
screen.size |
1 or 2 |
1 |
This defines the size of the video display: 1 is
a smaller display, 2 is a larger display. |
||||
screen.colour screen.color |
white , green or amber |
white |
This defines the colour of the screen display. | ||||
screen.update |
async or sync |
async |
This defines how screen updates are performed.
|
Note: On any modern PC, especially anything with a dual or multicore processor, the default async screen update option is likely to produce the best results. On older hardware the sync option may result in faster and/or smoother operation.
Tim Baldwin April 2011 tjb101@tinymail.co.uk |
Return to index
© Tim Baldwin 2010,2011 |