16
16
permission notice identical to this one.
19
File: vice.info, Node: PET model, Next: PET diagnostic pin, Prev: PET-specific, Up: PET-specific
21
Changing PET model settings
22
---------------------------
24
With `xpet', it is possible to change at runtime the characteristics
25
of the emulated PET so that it matches (or not) the ones of a certain
26
PET model, and it is also possible to select from a common set of PET
27
models so that all the features are selected accordingly.
29
The former is done by changing the following resources (via resource
30
file, command line options or right-menu items):
33
Size of memory in kByte. 96k denotes a 8096, 128k a 8296.
36
Size of I/O area in Byte. Either 2048 or 256 for 8296.
39
Enables CRTC 6545 emulation (all models from 40xx and above)
42
The number of columns on the screen (40 or 80). A 0 auto-detects
46
The 8296 can map RAM into the address range $9***
49
The 8296 can map RAM into the address range $A***
52
This resource enables the SuperPET (MicroMainFrame 9000) I/O and
53
disables the 8x96 mappings.
56
If (by checksum) a version 1 kernal is detected, then the kernal
57
ROM is patched to make the IEEE488 interface work.
60
Exchanges some character in the character ROM that have changed
61
between the first PET 2001 and all newer versions.
64
This resource enables the "blank screen on EOI" feature of the
68
Enable emulator ID (at `$e8a0-$e8ff', for use see C64).
71
Set the diagnositc pin on the PET userport (see below).
74
Specify `NAME' as the character generator ROM file
77
Specify `NAME' as the kernal ROM file. This file contains the
78
complete BASIC, EDITOR and KERNAL ROMs and is either 16k (BASIC 1
79
and 2) or 20k (BASIC 4) in size.
82
Specify `NAME' as the editor ROM file. This file contains an
83
overlay for the editor ROM at $E000-$E7FF if necessary.
86
Specify `NAME' as the $9*** Expansion ROM file. This file contains
87
an expansion ROM image of 4k.
90
Specify `NAME' as the $A*** Expansion ROM file. This file contains
91
an expansion ROM image of 4k.
94
Specify `NAME' as the $B*** Expansion ROM file. This file contains
95
an expansion ROM image of 4k. This file overlays the lowest 4k of
99
Choosing a common PET model is done from the right-button menu
100
instead, by choosing an item from the "Model defaults" submenu.
101
Available models are:
127
Notice that this will *reset the emulated machine*.
129
It is also possible to select the PET model at startup, with the
130
`-model' command-line option: for example, `xpet -model 3032' will
131
emulate a PET 3032 while `xpet -model 8296' will emulate a PET 8296.
134
File: vice.info, Node: PET diagnostic pin, Next: PET commandline options, Prev: PET model, Up: PET-specific
136
The PET diagnostic pin
137
----------------------
139
It is possible to enable or disable emulation of the PET diagnostic
140
pin via the `DiagPin' resource, or the "PET userport diagnostic pin"
141
item in the right-button menu.
143
When the diagnostic pin is set, the Kernal does not try to initialize
144
the BASIC, but directly jumps into the builtin machine monitor.
147
File: vice.info, Node: PET commandline options, Next: PET colors, Prev: PET diagnostic pin, Up: PET-specific
149
PET command line options
150
------------------------
152
These are the commandline options specific for the CBM-II models.
155
Specify the PET model you want to emulate.
158
Specify `NAME' as the Kernal/BASIC ROM file (`KernalName').
161
Specify `NAME' as the editor ROM file (`EditorName').
164
Specify `NAME' as the character generator ROM file (`ChargenName').
166
`-rom9 NAME, -romA NAME, -romB NAME'
167
Specify `NAME' as the ROM image file for the respective cartridge
168
areas (`RomModule9Name', `RomModuleAName', `RomModuleBName').
171
Switch on RAM mapping on addresses $9000-$9fff, $a000-$afff
174
`-superpet, +superpet'
175
Enable/Disable SuperPET I/O emulation (`SuperPET').
178
Enable/Disable patching the IEEE488 section of the PET2001 ROM
179
when detected (`Basic1').
181
`-basic1char, +basic1char'
182
Enable/Disable PET 2001 character generator (`Basic1Chars').
184
`-eoiblank, +eoiblank'
185
Enable/Disable EOI blanking the screen (`EoiBlank').
189
Enable (`EmuID=1') or disable (`EmuID=0') the emulation
190
identification extension (at `$e8a0-$e8ff').
194
Enable (`DiagPin=1') or disable (`DiagPin=0') the diagnostic pin
199
File: vice.info, Node: PET colors, Prev: PET commandline options, Up: PET-specific
201
Changing screen colors
202
----------------------
204
It is also possible to choose what color set is used for the
205
emulation window. This is done by specifying a palette file name
206
(*note Palette files::) in the `PaletteName' resource. The menu
207
provides the following values:
209
* `green.vpl' (default, "green)"), the good old green-on-black
212
* `amber.vpl' ("amber"), an amber phosphor lookalike;
214
* `white.vpl' ("white"), simple white-on-black palette.
217
File: vice.info, Node: CBM-II-specific, Prev: PET-specific, Up: Machine-specific features
219
CBM-II-specific commands and settings
220
=====================================
222
This section lists the settings and commands that are
223
CBM-II-specific and thus are not present in the other emulators.
228
* CBM-II commandline options::
232
19
File: vice.info, Node: CBM-II model, Next: CBM-II commandline options, Prev: CBM-II-specific, Up: CBM-II-specific
234
21
Changing CBM-II model
1194
981
ARRAY BLK2B 4k ROM image $5*** (if CONFIG & 8;
985
File: vice.info, Node: PET memory module, Next: CBM-II memory module, Prev: VIC20 memory module, Up: Module formats
990
The PET memory module actually consists of two modules. The
991
"PETMEM" module is mandatory and contains the RAM dump. The "PETROM"
992
module is optional and contains a dump of the ROM images.
994
The size of the PET memory modules differs with each different memory
995
configuration. The RAM configuration is saved in the snapshot, and
996
restored when the snapshot is loaded.
1000
Version numbers: Major 1, Minor 2
1002
Type Name Description
1003
BYTE CONFIG Configuration value. Bits 0-3: 0=
1004
40 col PET without CRTC; 1= 40 col
1005
PET with CRTC; 2 = 80 col PET (with
1006
CRTC); 3= SuperPET; 4= 8096; 5=
1007
8296. Bit 6: 1= RAM at $9***. Bit
1009
BYTE KEYBOARD Keyboard type. 0= UK business; 1=
1010
Graphics; 2= German business
1011
BYTE MEMSIZE memory size of low 32k in k
1012
(possible values 4, 8, 16, 32)
1013
BYTE CONF8X96 Value of the 8x96 configuration
1015
BYTE SUPERPET SuperPET config. Bit 0: 1= $9***
1016
RAM enabled. Bit 1: 1= RAM write
1017
protected. Bit 2: 1= CTRL register
1018
write protected. Bit 3: 0= DIAG pin
1019
active. Bits 4-7: RAM block in use.
1020
ARRAY RAM 4-32k RAM (not 8296, size depends
1022
ARRAY VRAM 2/4k RAM (not 8296, size depends on
1024
ARRAY EXTRAM 64k expansion RAM (SuperPET and
1026
ARRAY RAM 128k RAM (8296 only)
1027
- - The following item has been added
1029
BYTE POSITIONAL bit 0=0 = symbolic keyboard
1030
mapping, bit 0=1 = positional
1032
- - The following item has been added
1034
BYTE EOIBLANK bit 0=0 = EOI does not blank
1035
screen, bit 0=1 = EOI blanks screen.
1037
The last item has been added in PETMEM snapshot version 1.1. It is
1038
ignored by earlier restore routines (V1.0) and the V1.1 restore routines
1039
do not change the current setting when reading a V1.0 snapshot.
1041
In V1.2 the new EOIBLANK variable has been added. This implements
1042
the "blank screen on EOI" feature that was previously linked to a wrong
1047
Version numbers: Major 1, Minor 0
1049
Type Name Description
1050
BYTE CONFIG Bit 0: 1= $9*** ROM included. Bit
1051
1: 1= $A*** ROM included. Bit 2: 1=
1052
$B*** ROM included. Bit 3: 1=
1053
$e900-$efff ROM included
1054
ARRAY KERNAL 4k KERNAL ROM image $f000-$ffff
1055
ARRAY EDITOR 2k EDITOR ROM image $e000-$e7ff
1056
ARRAY CHARGEN 2k CHARGEN ROM image
1057
ARRAY ROM9 4k $9*** ROM image (if CONFIG & 1)
1058
ARRAY ROMA 4k $A*** ROM image (if CONFIG & 2)
1059
ARRAY ROMB 4k $B*** ROM image (if CONFIG & 4)
1060
ARRAY ROMC 4k $C*** ROM image
1061
ARRAY ROMD 4k $D*** ROM image
1062
ARRAY ROME9 7 blocks $e900-$efff ROM image (if