==============================================================================
C64 USER'S MANUAL
The Commodore 64 inside your VIXEN-32
==============================================================================
CONTENTS
Welcome
1. What you need
2. Starting the C64
3. The game menu
4. Starting a game
5. Disks in drive 8, and tapes
6. Paddles and the 1351 mouse
7. Moving the picture
8. Back to BASIC
Appendix A: All the keys
Appendix B: Messages
==============================================================================
WELCOME
==============================================================================
Your VIXEN-32 has a Commodore 64 inside it. Not a program pretending to be
one: the VIXEN-32 has the C64's own chips built in -- its processor, its
VIC-II picture chip, its SID sound chip, its two CIA chips for the keyboard,
the joysticks and the timers, and the PLA that lays out its memory. They run
the C64's own BASIC and KERNAL at the speed of a real PAL C64, so C64 games
and programs behave exactly as they did in 1982.
This manual shows you, step by step:
- what you must put on your SD card first,
- how to start the C64,
- how to choose and start a game from the game menu,
- how to use disks (.D64 files) in drive 8, and tapes (.TAP files),
- how to use the Amiga mouse as paddles or as a C64 mouse,
- how to move the picture, and how to go back to C64 BASIC.
You do not need to know anything about the C64 to use it. If you do, you will
feel at home at once: it is the same machine.
==============================================================================
1. WHAT YOU NEED
==============================================================================
The C64's ROMs
--------------
A C64 cannot start without its three ROMs -- the chips that hold C64 BASIC,
the KERNAL (the part that runs the screen, the keyboard and loading) and the
character set. They are not included with the VIXEN-32. The ROMs are
Commodore's software and still under copyright, so you must get your own copy:
for example read them out of your own C64, or get them from a source that is
allowed to give them to you.
You need three files. Give them exactly these names:
File Size What it is
------------ ----------------------- ---------------------------------------
KERNAL.ROM 8 KBytes (8192 bytes) the KERNAL (Commodore part 901227-03)
BASIC.ROM 8 KBytes (8192 bytes) C64 BASIC V2 (901226-01)
CHAR.ROM 4 KBytes (4096 bytes) the character set (901225-01)
Copies found on the internet often have names like kernal.901227-03.bin --
just rename them. Use Commodore's own KERNAL: the game menu starts games and
runs drive 8 with it. A changed KERNAL (a fast-loader KERNAL, for example) may
not start games from the menu.
Games
-----
The C64 understands four kinds of game files:
- .PRG -- a program, as it would load from tape or disk;
- .CRT -- a cartridge, as it would sit in the cartridge slot;
- .D64 -- a whole floppy disk, as it would sit in a 1541 disk drive;
- .TAP -- a whole cassette tape, as it would sit in the Datasette (with core
v0.98 or newer).
Like the ROMs, games are not included: use your own, or the many free games
people still write for the C64 today.
A game that came on two disks, or on both sides of one, comes as two .D64
files. Keep them together, in a folder of their own.
Where everything goes on the SD card
------------------------------------
Copy the files to your SD card (with a card reader on your PC), like this:
/VIXEN-32/C64/
KERNAL.ROM
BASIC.ROM
CHAR.ROM
GAMES/
Arkanoid.d64
Fred's Back 1.prg
Ghostbusters.crt
Cartridges/
Demos/
Inside GAMES you may make as many folders as you like -- by year, by
publisher, one per game.
Joysticks
---------
Plug your joysticks into the VIXEN-32's two joystick ports. They are the C64's
control ports 1 and 2, exactly as on a C64. Most C64 games are played with the
joystick in port 2; a few want port 1, and games for two players use both. If
a game wants its joystick in the other port, you need not move the plug:
SHIFT+F3 in the game menu swaps the two ports (chapter 3).
The Amiga mouse
---------------
An Amiga mouse in port 1 can be the C64's paddles or its 1351 mouse (chapter
6). Left as it is, port 1 is a joystick port, as on a real C64: a mouse left
in it can look like a joystick to a game, or even press keys. Unplug it, or
switch it to paddles or a 1351 with F3 in the game menu.
==============================================================================
2. STARTING THE C64
==============================================================================
GO 64
-----
Switch your VIXEN-32 on. When the VIXEN-32's BASIC says Ready, type
GO 64
and press RETURN (GO64 works too). The machine asks ARE YOU SURE (Y/N)? --
because the C64 takes over the whole machine, a program you had typed into the
VIXEN-32's BASIC is lost. Press Y. (N takes you back to Ready.)
[Picture: GO 64 at the VIXEN-32's Ready]
A moment later the C64 starts, exactly as a real one does:
[Picture: The C64 has started: 38911 BASIC bytes free]
If a ROM is missing, the C64 does not start and the VIXEN-32 tells you which
one, for example
?/VIXEN-32/C64/KERNAL.ROM NOT FOUND
?CHAR.ROM IS NOT 4 KBYTES
Check the name, the folder and the size of that file (chapter 1).
To leave the C64 and go back to the VIXEN-32, press the reset button on the
side of the machine.
Try C64 BASIC
-------------
You are now in C64 BASIC. Type
PRINT "HELLO"
and press RETURN. Then type this little program, a line at a time:
10 PRINT "VIXEN-32 ";
20 GOTO 10
and type RUN. Press RUN/STOP to stop it.
The keyboard
------------
The VIXEN-32's keyboard is the C64's keyboard, key for key, with a few extras:
- F1, F3, F5, F7 are the C64's function keys; F2, F4, F6 and F8 are SHIFT
with them, as on the C64.
- All four cursor keys work. (The C64 itself had two, with SHIFT for up and
left.)
- RESTORE is the C64's RESTORE key. RUN/STOP and RESTORE together stop a
program and clear the screen, as on a real C64.
- C= is the key with the Commodore sign (MEGA on the VIXEN-32).
- HELP opens the game menu. The C64 had no HELP key, so no game ever needs
it.
- ALT with a cursor key moves the picture on the screen (chapter 7). The C64
had no ALT key either: the game never sees these presses.
LOAD without ,8 loads from tape. With no tape in (chapter 5) it waits for one,
as a C64 does: press RUN/STOP.
==============================================================================
3. THE GAME MENU
==============================================================================
Press HELP at any time, in BASIC or in the middle of a game. The C64 stops
where it is and its sound goes quiet, and the game menu opens over it:
[Picture: The game menu]
The menu has four parts:
- The top line shows the folder you are in, and on the right the version of
the C64 program (C64HW B20).
- The list shows what is in that folder: folders first, marked
, then
the games, by name. A .PRG or .CRT shows its size in BLOCKS, as the C64
counts them; a .D64 shows DISK and a .TAP TAPE.
- The two key lines under the list show the keys you need most, the mouse
setting (F3), the mouse speed (F5 / F7, chapter 6) and SHIFT+F3, which
swaps the joystick ports.
- The bottom line shows how many games and folders this folder holds -- and
messages, when there is something to say. On its right it shows PORTS
SWAPPED while the joystick ports are swapped, the disk in drive 8 and the
tape, if they are in (chapter 5).
Moving around the menu
----------------------
-----------------------------------------------------------------------------
Key What it does
-------------------------------------- --------------------------------------
Cursor up, cursor down move the bar (held: on and on)
Cursor left, cursor right a whole page up or down
CLR/HOME the first line
a letter or a digit jump to the next game starting with it
RETURN open the folder, or start the game the
bar is on
SHIFT+RETURN a .D64 or a .TAP: put it in drive 8 or
the tape only (chapter 5)
INST/DEL or the left-arrow key (left go back up one folder
of 1)
F1 switch the C64 off and on: BASIC
(chapter 8)
F3 the Amiga mouse: joystick, paddles or
1351 (chapter 6)
SHIFT+F3 swap the joystick ports: the
VIXEN-32's port 1 is the C64's port 2,
and port 2 its port 1; again: back
F5, F7 the mouse slower, faster (chapter 6)
HELP, ESC or RUN/STOP close the menu: back to the C64 where
it was
-----------------------------------------------------------------------------
Closing the menu with HELP, ESC or RUN/STOP changes nothing: the game you were
playing goes on from the very same moment.
The joystick ports stay swapped from game to game until you press SHIFT+F3
again or leave the C64.
==============================================================================
4. STARTING A GAME
==============================================================================
Put the bar on a game and press RETURN. The C64 is switched off and on, and
the game is started in it -- a new machine for every game, just as if you had
switched your C64 off and on before loading.
Programs (.PRG)
---------------
Most C64 games are a BASIC program: a short BASIC line that starts the machine
code behind it. The menu puts such a game straight into the C64's memory and
types RUN for you. There is no loading time.
A few programs are pure machine code that a C64 user started with SYS and an
address. The menu loads such a program but cannot know where to start it; the
bottom line of the menu says where it went in memory, for example Loaded at
$C000: start it with SYS. Close the menu and type the SYS its instructions
give.
Cartridges (.CRT)
-----------------
A cartridge is plugged in, the C64 is switched on with it, and the cartridge
starts itself as it did on a real C64. It stays plugged in until you start
another game or press F1.
The menu knows these kinds of cartridge:
Type Cartridge
------ --------------------------------------------------------------------
0 normal 8K, 16K and Ultimax cartridges -- most games
3 Final Cartridge III
4 Simons' Basic
5 Ocean
7 Fun Play, Power Play
8 Super Games
11 Westermann
12 Rex Utility
13 Final Cartridge I
15 C64 Game System
17 Dinamic
18 Zaxxon
19 Magic Desk
21 Comal 80
32 EasyFlash
60 GMod2 -- newer games that save, such as Sam's Journey and Wormhole
Any other kind is not started: the bottom line says Cartridge type 1 is not
supported (1 is Action Replay). There is no freeze button.
Saved games on GMod2 cartridges
-------------------------------
A GMod2 cartridge has a small memory chip of its own where the game keeps its
saved games and high scores. The VIXEN-32 keeps that memory on your SD card,
in a file next to the cartridge, with .EEP at the end of its name:
Sams Journey.crt saves into Sams Journey.eep.
The file is written a second after the game saves, and read again the next
time you start the game -- so a saved game is safe even if you press the reset
button. Delete the .EEP file, and the game starts as new. A .EEP file made by
the VICE emulator works too.
Disks (.D64) and tapes (.TAP)
-----------------------------
A disk is put in drive 8, a tape in the tape drive, and the game on it is
loaded and started for you. That is the next chapter.
==============================================================================
5. DISKS IN DRIVE 8, AND TAPES
==============================================================================
The VIXEN-32's C64 has a drive 8 of its own for .D64 files. It is not a 1541
disk drive: the C64's KERNAL asks for the files, and the VIXEN-32 reads them
from the .D64 on your SD card. LOAD, the directory and reading files work as
with a 1541.
Starting the game on a disk: RETURN
-----------------------------------
Put the bar on a .D64 and press RETURN. The disk goes into drive 8, the C64 is
switched off and on, and the menu types for you what you would type on a C64:
LOAD"*",8,1
RUN
LOAD"*",8,1 loads the first program on the disk, and once it has loaded, RUN
starts it:
[Picture: RETURN on a .D64: LOAD"*",8,1 and RUN, typed for you]
The LOAD line looks odd on the screen -- an L and a graphics sign where you
expect LOAD. That is LOAD's short form, L and SHIFT+O, just as C64 users typed
it: the whole line must fit into the C64's keyboard buffer of ten keys, and
the C64 shows SHIFT+O as a graphics sign. Many games start themselves while
they load; then no RUN is needed, and none is typed.
Only putting a disk in: SHIFT+RETURN
------------------------------------
Put the bar on a .D64 and press SHIFT+RETURN. The disk goes into drive 8, and
the C64 goes on exactly where it was -- nothing is typed, nothing restarted.
The bottom line of the menu shows the disk in drive 8 on its right, and on
that disk the key line now says SHIFT+RETURN out of drive 8:
[Picture: The disk in drive 8: the bottom line shows it]
Use SHIFT+RETURN:
- to look at a disk first. Type LOAD"$",8 and then LIST, as on a C64, to see
what is on it:
[LOAD"$",8 and LIST: the disk's directory]
LOAD"$",8 and LIST: the disk's directory
Then load the program you want, for example LOAD"HELLO",8, and type RUN.
- for the second disk of a game. When a game asks you to put in disk 2 or
turn the disk over, press HELP, put the bar on the other .D64 and press
SHIFT+RETURN. You are back in the game at once: press what the game asks
for, as you would after changing the disk in a 1541.
- to take the disk out. SHIFT+RETURN on the disk that is in drive 8 takes it
out again.
How long a disk stays in
------------------------
The disk stays in drive 8 when you start a .PRG or a .CRT game and when F1
switches the C64 off and on -- as a disk stays in a 1541 when you switch the
C64 off and on. It is forgotten when you leave the C64.
What drive 8 can do -- and what it cannot
-----------------------------------------
-----------------------------------------------------------------------------
Works Does not work
-------------------------------------- --------------------------------------
LOAD and LOAD"$",8 (the directory) SAVE: the disk is read only
games that load their next part with games with their own fast loader
the KERNAL
reading files with OPEN, GET# and writing files, formatting, deleting
INPUT#
the error channel, OPEN 15,8,15 direct disk access (# buffers)
drives 9, 10 and 11
-----------------------------------------------------------------------------
- The disk is read only. Nothing is ever written to your .D64 file. SAVE
seems to work but saves nothing, and the error channel says 26,WRITE
PROTECT ON -- as a 1541 does with a write-protected disk.
- Fast loaders do not load. Many games and most demos read the disk with
their own fast loader, which talks to the 1541's own processor. Drive 8
has none: such a game hangs at its loading screen or says ?DEVICE NOT
PRESENT ERROR. For these games, use a MEGA65 core with a full 1541 in it.
- Drive 8 only. LOAD from device 9, 10 or 11 says ?DEVICE NOT PRESENT ERROR
-- and so does drive 8 when no disk has been put in since the C64 was
switched on.
.D64 files of 35 and of 40 tracks are read, with or without the error bytes
some copies carry at their end.
The error channel
-----------------
Programs that ask the drive how it is doing get the 1541's own answers:
OPEN 15,8,15:INPUT#15,A,B$:PRINT A;B$:CLOSE 15
Number Message When
-------- ------------------- -----------------------------------------------------
0 OK all is well
73 CBM DOS V2.6 1541 the first time after the C64 was switched on
62 FILE NOT FOUND there is no file of that name on the disk
26 WRITE PROTECT ON something tried to write to the disk
74 DRIVE NOT READY the disk was taken out of drive 8
70 NO CHANNEL a program asked for direct disk access (a # buffer)
31, 34 SYNTAX ERROR the drive does not know that command
Tapes (.TAP)
------------
Many C64 games came on cassette tape. A .TAP file is such a tape, recorded
pulse for pulse, and the VIXEN-32 plays it into the C64 exactly as the
Datasette tape drive did, at the same speed. So games with their own fast
("turbo") loader -- the way most tape games loaded -- load as well. Tapes need
core v0.98 or newer.
Put the bar on a .TAP and press RETURN. The tape goes in, PLAY is pressed for
you, the C64 is switched off and on, and the menu types what SHIFT+RUN/STOP
types on a C64:
LOAD
RUN
The C64 says SEARCHING, FOUND and LOADING; then, on most tapes, the game's own
loader takes over, with its loading picture, music or stripes in the border,
as on a real C64. Loading takes as long as it did then -- often a few minutes.
Put the bar on a .TAP and press SHIFT+RETURN to put the tape in and press PLAY
only, the C64 going on where it was: for side 2 of a game, or a game that asks
you to press PLAY. SHIFT+RETURN on the tape that is in takes it out. The
bottom line of the menu shows the tape on its right.
- The tape stands while the game menu is open, and goes on when you close
it.
- The C64's motor control works: a game that stops the tape between its
parts stops it, and starts it again when it wants the next one.
- Switching the C64 off and on (F1, or starting another game) rewinds the
tape. It is forgotten when you leave the C64.
- At the end of the tape PLAY comes up, as the Datasette's keys did.
- Nothing is ever recorded onto a tape, and only C64 tapes (.TAP version 0
and 1) are read.
==============================================================================
6. PADDLES AND THE 1351 MOUSE
==============================================================================
Some C64 games are played with paddles (the turning knobs of Pong-like games),
and some with Commodore's 1351 mouse. The Amiga mouse in port 1 can be either.
Press HELP, then F3, until the key line shows the one you want:
-----------------------------------------------------------------------------
Setting What the mouse is
-------------------------------------- --------------------------------------
JOYSTICK IN PORT 1 nothing: port 1 is a plain joystick
port, as on a C64 (at first; with the
ports swapped it reads JOYSTICK IN
PORT 2)
PADDLES IN PORT 1 two paddles in control port 1
PADDLES IN PORT 2 two paddles in control port 2
1351 MOUSE IN PORT 1 a 1351 mouse in control port 1
1351 MOUSE IN PORT 2 a 1351 mouse in control port 2
-----------------------------------------------------------------------------
As paddles, moving the mouse left and right turns the first paddle, up and
down the second; the left button is the first paddle's fire button, the right
button the second's.
As a 1351, the mouse moves the pointer; the left button is fire, and the right
button is the 1351's other button.
F5 makes the mouse slower and F7 faster: 12%, 25%, 33%, 50%, 75%, 100% or
150%. It starts at 50%. The key line shows the speed.
The settings stay from game to game until you leave the C64. A game still
needs its own setting for paddles or a mouse, often in its menu, as on a real
C64 -- and most 1351 games want the mouse in port 1. Real paddles are not
read. The PORT in these settings is always the C64's control port: swapping
the joystick ports (SHIFT+F3) does not move the paddles or the 1351.
==============================================================================
7. MOVING THE PICTURE
==============================================================================
The C64 shows its picture the way a TV of the time did: the C64's screen of 40
columns by 25 rows, with its border round it. Some demos and a few games draw
sprites far out into the border, beyond what a TV showed. To see them, move
the picture.
Hold down ALT and press a cursor key: the picture moves 4 dots sideways or 2
lines up or down. Hold the cursor key down too, and it goes on moving. ALT and
CLR/HOME put it back where it was.
The C64 has no ALT key, so the game never sees these presses -- you can move
the picture in the middle of a game, and in C64 BASIC too.
The picture stays where you put it while the game runs. It is not remembered:
every time the C64 is switched on -- a game started from the menu, or F1 --
the picture is back in its normal place.
==============================================================================
8. BACK TO BASIC
==============================================================================
Press HELP, then F1. The C64 is switched off and on, into C64 BASIC, as if you
had pressed the power switch of a real one. The game that was running is gone,
and so is a cartridge; a disk stays in drive 8.
To leave the C64 altogether and go back to the VIXEN-32, press the reset
button.
==============================================================================
APPENDIX A: ALL THE KEYS
==============================================================================
While the C64 runs
Key What it does
-------------------- ------------------------------------------------------
HELP open the game menu
ALT + cursor keys move the picture (until the C64 is next switched on)
ALT + CLR/HOME the picture back in its normal place
RUN/STOP + RESTORE stop the program, as on a C64
the reset button leave the C64: back to the VIXEN-32
In the game menu
-----------------------------------------------------------------------------
Key What it does
-------------------------------------- --------------------------------------
Cursor up, cursor down move the bar
Cursor left, cursor right a page up, down
CLR/HOME the first line
a letter or a digit the next game starting with it
RETURN open the folder / start the game (a
.D64 or .TAP: LOAD and RUN)
SHIFT+RETURN a .D64 into drive 8 / a .TAP into the
tape only; on the one in: out
INST/DEL, left-arrow key up one folder
F1 switch the C64 off and on: BASIC
F3 the mouse: joystick, paddles or 1351,
port 1 or 2
SHIFT+F3 the joystick ports swapped, or back
F5, F7 the mouse slower, faster
HELP, ESC, RUN/STOP back to the C64
-----------------------------------------------------------------------------
==============================================================================
APPENDIX B: MESSAGES
==============================================================================
When you type GO 64
-----------------------------------------------------------------------------
Message What to do
-------------------------------------- --------------------------------------
?/VIXEN-32/C64/KERNAL.ROM NOT FOUND the file is not there: check its name
and folder (BASIC.ROM and CHAR.ROM the
same)
?KERNAL.ROM IS NOT 8 KBYTES the file is the wrong size: it is not
the right ROM (CHAR.ROM must be 4
KBytes)
?UNMOUNT A: AND B: FIRST unmount the VIXEN-32's disk drives A:
and B:, then try again
-----------------------------------------------------------------------------
In the game menu
-----------------------------------------------------------------------------
Message What to do
-------------------------------------- --------------------------------------
There is no /VIXEN-32/C64/GAMES folder make the GAMES folder and put your
on the card games in it
The card cannot be read check that the SD card is in
That folder cannot be read the folder is damaged: check the card
on your PC
The name is too long for the card's give the folder or the file a shorter
paths name
The game cannot be read the file is damaged
The file holds nothing but its load the .PRG file is empty
address
Loaded at $C000: start it with SYS machine code: type the SYS its
instructions give (chapter 4)
Not loaded: the C64 never got to READY the game could not be put in: is
KERNAL.ROM Commodore's own?
Not a cartridge (.CRT) file the file is not a C64 cartridge
Cartridge type 1 is not supported a kind of cartridge the menu does not
know (chapter 4)
The game's save could not be written the card is full or locked: free it,
to the card and the save is written a second later
The cartridge cannot be read / The the file is damaged
cartridge file is damaged
The cartridge file has a chip it the file is damaged or not a C64
cannot hold / holds no chips cartridge
The disk cannot be read the .D64 file is damaged
Not a .D64 disk (35 or 40 tracks) the file is not a C64 disk, or a kind
drive 8 does not read
This KERNAL has no jump table drive 8 use Commodore's own KERNAL.ROM
can use (chapter 1)
Tapes need core v0.98 or newer update the VIXEN-32 core
The tape cannot be read the .TAP file is damaged
Not a .TAP tape the file is not a C64 tape
A version 2 tape is a C16's, not a the tape is for another Commodore
C64's
The tape is larger than 8 MBytes no C64 tape is that long: the file is
damaged
-----------------------------------------------------------------------------