VICE Manual
Next:
GNU GENERAL PUBLIC LICENSE
, Previous:
(dir)
, Up:
(dir)
[
Contents
][
Index
]
Table of Contents
1 GNU GENERAL PUBLIC LICENSE
Preamble
How to Apply These Terms to Your New Programs
2 About VICE
2.1 C64 emulator features
2.2 C64DTV emulator features
2.3 C128 emulator features
2.4 VIC20 emulator features
2.5 PET emulator features
2.6 CBM-II emulator features
2.7 SCPU64 emulator features
2.8 The keyboard emulation
2.9 The joystick emulation
2.10 The disk drive emulation
2.11 Supported file formats
2.12 Common problems
2.12.1 Sound problems
2.12.2 Video problems
2.12.3 Printer problems
2.12.4 PET keyboard problems
3 Invoking the emulators
3.1 Command-line options used during initialization
3.2 Autostarting programs from the command-line
4 System files
4.1 ROM files
4.2 Keymap files
4.3 Palette files
4.4 Romset files
4.4.1 Romset command line options
5 Basic operation
5.1 The emulation window
5.2 Using the menus
5.3 Getting help
5.4 Using the file selector
5.5 Using disk and tape images
5.5.1 “Autostarting” an image
5.5.2 Using compressed files
5.5.3 Using Zipcode and Lynx images
5.6 Resetting the machine
6 Settings and resources
6.1 Format of resource files
6.2 Using command-line options to change resources
6.3 Autostart settings
6.3.1 Autostart resources
6.3.2 Autostart command-line options
6.4 Performance settings
6.4.1 Performance resources
6.4.2 Performance command-line options
6.5 Video settings
6.5.1 Video resources
6.5.2 Video command line options
6.6 Keyboard settings
6.6.1 Keyboard resources
6.6.2 Keyboard command-line options
6.6.3 Control port resources
6.6.4 Control port command-line options
6.7 Joystick settings
6.7.1 Joystick resources
6.7.2 Joystick command-line options
6.8 Sound settings
6.8.1 Sound resources
6.8.2 Sound command-line options
6.9 Tape settings
6.9.1 Tape resources
6.9.2 Tape command-line options
6.10 Drive settings
6.10.1 Drive resources
6.10.2 Drive command-line options
6.11 Peripheral settings
6.11.1 Settings for file system devices
6.11.1.1 Resources for file system devices
6.11.1.2 Command-line options for file system devices
6.11.2 Printer settings
6.11.2.1 Printer resources
6.11.2.2 Printer command-line options
6.11.3 Disabling kernal traps
6.11.3.1 Resources to control Kernal traps
6.11.3.2 Command-line options to control Kernal traps
6.12 RS232 settings
6.12.1 RS232 resources
6.12.2 RS232 command-line options
6.12.3 RS232 usage example
6.13 Tape port devices
6.13.1 Tape port resources
6.13.2 Tape port command line options
6.14 Userport devices
6.14.1 Userport resources
6.14.2 Userport command line options
6.15 Monitor settings
6.15.1 Monitor resources
6.15.2 Monitor command-line options
6.16 RAM init pattern settings
6.16.1 RAM init pattern resources
6.16.2 RAM init pattern command-line options
6.17 Debug settings
6.17.1 Debug resources
6.17.2 Debug command-line options
6.18 Network Play settings
6.18.1 Network Play resources
6.18.2 Network Play command-line options
6.19 Miscellaneous settings
6.19.1 Miscellaneous resources
6.19.2 Miscellaneous command-line options
7 Machine-specific features
7.1 C64/128-specific commands and settings
7.1.1 Using cartridges
7.1.1.1 Slot 0
7.1.1.2 Slot 1
7.1.1.3 Main Slot
7.1.1.4 I/O Slot
7.1.1.5 Expected behaviour
7.1.1.6 Common problems
7.1.1.7 IEEE-488 interface
7.1.1.8 The Final Cartridge 3
7.1.1.9 CMD RAMLink
7.1.2 C64 cartridge settings
7.1.2.1 C64 cartridge resources
7.1.2.2 C64 cartridge command-line options
7.1.3 CIA settings
7.1.3.1 CIA resources
7.1.3.2 CIA command-line options
7.1.4 VIC-II settings
7.1.4.1 VIC-II resources
7.1.4.2 VIC-II command-line options
7.1.5 SID settings
7.1.5.1 SID resources
7.1.5.2 SID command-line options
7.1.6 C64 I/O extension settings
7.1.6.1 C64 I/O extension resources
7.1.6.2 C64 I/O extension command-line options
7.1.7 C64 system ROM settings
7.1.7.1 C64 system ROM resources
7.1.7.2 C64 system ROM command-line options
7.1.8 C64 settings
7.1.8.1 C64 resources
7.1.8.2 C64 command-line options
7.2 C128-specific commands and settings
7.2.1 VDC settings
7.2.1.1 VDC resources
7.2.1.2 VDC command-line options
7.2.2 C128 system ROM settings
7.2.2.1 C128 system ROM resources
7.2.2.2 C128 system ROM command-line options
7.2.3 C128 settings
7.2.3.1 C128 resources
7.2.3.2 C128 command-line options
7.3 C64DTV-specific commands and settings
7.3.1 C64DTV ROM image
7.3.2 DTV revision
7.3.3 LumaFix
7.3.4 Userport
7.3.5 Debug
7.3.6 Monitor DTV features
7.3.7 DTV resources
7.3.8 DTV command-line options
7.4 SCPU64-specific commands and settings
7.4.1 SCPU64 resources
7.4.2 SCPU64 command-line options
7.5 VIC20-specific commands and settings
7.5.1 Using cartridge images
7.5.2 VIC20 cartridge settings
7.5.2.1 VIC20 cartridge resources
7.5.2.2 VIC20 cartridge command-line options
7.5.3 VIC settings
7.5.3.1 VIC resources
7.5.3.2 VIC command-line options
7.5.4 Changing memory configuration
7.5.4.1 VIC20 memory configuration resources
7.5.4.2 VIC20 memory configuration command-line options
7.5.5 VIC20 system ROM settings
7.5.5.1 VIC20 system ROM resources
7.5.5.2 VIC20 system ROM command-line options
7.5.6 VIC20 settings
7.5.6.1 VIC20 command-line options
7.6 PLUS4-specific commands and settings
7.6.1 TED settings
7.6.1.1 TED resources
7.6.1.2 TED command-line options
7.6.2 PLUS4 I/O extension settings
7.6.2.1 PLUS4 I/O extension resources
7.6.2.2 PLUS4 I/O extension command-line options
7.6.3 PLUS4 system ROM settings
7.6.3.1 PLUS4 system ROM resources
7.6.3.2 PLUS4 system ROM command-line options
7.6.4 PLUS4 settings
7.6.4.1 PLUS4 resources
7.6.4.2 PLUS4 command-line options
7.7 PET-specific commands and settings
7.7.1 Changing PET model settings
7.7.2 CRTC Settings
7.7.2.1 CRTC resources
7.7.2.2 CRTC command-line options
7.7.3 PET I/O extension settings
7.7.3.1 PET I/O extension resources
7.7.3.2 PET I/O extension command-line options
7.7.4 PET system ROM settings
7.7.4.1 PET system ROM resources
7.7.4.2 PET system ROM command-line options
7.7.5 The PET diagnostic pin
7.7.6 PET settings
7.7.6.1 PET resources
7.7.6.2 PET command line options
7.7.7 Colour PET
7.7.8 Changing screen colors
7.7.9 DWW high resolution graphics
7.7.10 HRE high resolution graphics
7.8 CBM-II-specific commands and settings
7.8.1 Changing CBM-II model
7.8.2 CBM-II system ROM settings
7.8.2.1 CBM-II system ROM resources
7.8.2.2 CBM-II system ROM command line options
7.8.3 CBM-II command line options
7.8.4 Changing screen colors
7.9 VSID-specific commands and settings
7.9.1 VSID settings
7.9.1.1 VSID resources
7.9.1.2 VSID command-line options
8 Platform-specific features
8.1 SDL-specific features
8.1.1 SDL specific resources
8.1.2 SDL specific command-line options
8.2 GTK3 specific features
8.2.1 GTK3 specific resources
8.2.2 GTK3 specific command-line options
9 Snapshots
9.1 Snapshot usage
9.2 Snapshot format
9.2.1 Emulator modules
9.2.1.1 x64 modules
9.2.1.2 x128 modules
9.2.1.3 xvic modules
9.2.1.4 xpet modules
9.2.1.5 xcbm2 and xcbm5x0 modules
9.2.1.6 Drive modules
9.2.2 Module formats
9.2.2.1 Terminology
9.2.2.2 Module framework
9.2.2.3 CPU 6502 module
9.2.2.4 CPU 6809 module
9.2.2.5 CIA module
9.2.2.6 VIA module
9.2.2.7 PIA module
9.2.2.8 TPI module
9.2.2.9 RIOT module
9.2.2.10 SID module
9.2.2.11 ACIA module
9.2.2.12 VIC-I module
9.2.2.13 VIC-II module
9.2.2.14 CRTC module
9.2.2.15 C64 memory module
9.2.2.16 C128 memory module
9.2.2.17 VIC20 memory module
9.2.2.18 PET memory module
9.2.2.19 CBM-II memory module
9.2.2.20 C500 data module
10 Media images
10.1 Media images resources
10.2 Media images command-line options
11 Event history
11.1 Recommended Settings
11.2 Recorded Events
11.3 Recording an Event History
11.4 Setting and Returning to Milestones
11.5 Continuing an Event History
11.6 Playing Back an Event History
11.7 Limitations and Suggestions
11.8 Event history resources
11.9 Event history command-line options
12 Monitor
12.1 Terminology
12.2 Machine state commands
12.3 Memory commands
12.4 Assembly commands
12.5 Checkpoint commands
12.6 General commands
12.7 Disk commands
12.8 Command file commands
12.9 Label commands
12.10 Miscellaneous commands
13 Binary monitor
13.1 Command Structure
13.2 Response Structure
13.3 Example Exchange
13.4 Commands
13.4.1 Memory get (0x01)
13.4.2 Memory set (0x02)
13.4.3 Checkpoint get (0x11)
13.4.4 Checkpoint set (0x12)
13.4.5 Checkpoint delete (0x13)
13.4.6 Checkpoint list (0x14)
13.4.7 Checkpoint toggle (0x15)
13.4.8 Condition set (0x22)
13.4.9 Registers get (0x31)
13.4.10 Registers set (0x32)
13.4.11 Dump (0x41)
13.4.12 Undump (0x42)
13.4.13 Resource Get (0x51)
13.4.14 Resource Set (0x52)
13.4.15 Advance Instructions (0x71)
13.4.16 Keyboard feed (0x72)
13.4.17 Execute until return (0x73)
13.4.18 Ping (0x81)
13.4.19 Banks available (0x82)
13.4.20 Registers available (0x83)
13.4.21 Display Get (0x84)
13.4.22 Exit (0xaa)
13.4.23 Quit (0xbb)
13.4.24 Reset (0xcc)
13.4.25 Autostart / autoload (0xdd)
13.5 Responses
13.5.1 Checkpoint Response (0x11)
13.5.2 Register Response (0x31)
13.5.3 JAM Response (0x61)
13.5.4 Stopped Response (0x62)
13.5.5 Resumed Response (0x63)
14 c1541
14.1 Specifying files in c1541
14.2 Using quotes and backslashes
14.3 c1541 commands and options
14.4 Executing shell commands
14.5 c1541 examples
15 cartconv
15.1 cartconv command line options
15.2 cartconv examples
16 petcat
16.1 petcat command line options
16.2 petcat examples
17 The emulator file formats
17.1 The raw tape image format
17.2 The T64 tape image format
17.2.1 T64 File structure
17.2.2 Tape Record
17.2.3 File record
17.3 The G64 GCR-encoded disk image format
17.3.1 The original format
17.3.2 An extension for double sided disks (Commodore VIC 1571)
17.3.3 Extra mastering info (SPS extension)
17.4 The P64 NRZI flux pulse disk image format
17.4.1 P64 Header Layout
17.4.2 P64 Chunk Header Layout
17.4.3 P64 Chunk ’HTPx’ Layout
17.4.4 ’HTPx’ Range encoded data format
17.4.5 P64 Chunk ’DONE’ Layout
17.5 The D64 disk image format
17.5.1 Non-Standard & Long Directories
17.5.2 BAM layout
17.5.3 Variations on the D64 layout
17.5.4 Error codes
17.6 The X64 disk image format
17.7 The D71 disk image format
17.7.1 Non-Standard & Long Directories
17.7.2 Bam layout
17.8 The D81 disk image format
17.8.1 Non-Standard & Long Directories
17.8.2 BAM layout
17.8.3 REL files
17.8.4 1581 Partitions and Sub-directories
17.8.5 AUTO-BOOT LOADER
17.9 The D80 disk image format
17.9.1 Non-Standard & Long Directories
17.9.2 BAM layout
17.10 The D82 disk image format
17.10.1 Non-Standard & Long Directories
17.10.2 BAM layout
17.11 The D90 disk image format
17.12 The DHD disk image format
17.13 The P00 image format
17.14 The CRT cartridge image format
17.14.1 Header contents
17.14.2 CHIP Contents
17.14.3 Cartridge Specifics
17.14.3.1 0 - Normal cartridge
17.14.3.2 1 - Action Replay
17.14.3.3 2 - KCS Power Cartridge
17.14.3.4 3 - Final Cartridge III
17.14.3.5 4 - Simons’ Basic
17.14.3.6 5 - Ocean type 1
17.14.3.7 6 - Expert Cartridge
17.14.3.8 7 - Fun Play, Power Play
17.14.3.9 8 - Super Games
17.14.3.10 9 - Atomic Power
17.14.3.11 10 - Epyx Fastload
17.14.3.12 11 - Westermann Learning
17.14.3.13 12 - Rex Utility
17.14.3.14 13 - Final Cartridge I
17.14.3.15 14 - Magic Formel
17.14.3.16 15 - C64 Game System, System 3
17.14.3.17 16 - Warp Speed
17.14.3.18 17 - Dinamic
17.14.3.19 18 - Zaxxon, Super Zaxxon (SEGA)
17.14.3.20 19 - Magic Desk, Domark, HES Australia
17.14.3.21 20 - Super Snapshot V5
17.14.3.22 21 - Comal-80
17.14.3.23 22 - Structured Basic
17.14.3.24 23 - Ross
17.14.3.25 24 - Dela EP64
17.14.3.26 25 - Dela EP7x8
17.14.3.27 26 - Dela EP256
17.14.3.28 27 - Rex EP256
17.14.3.29 28 - Mikro Assembler
17.14.3.30 29 - Final Cartridge Plus
17.14.3.31 30 - Action Replay 4
17.14.3.32 31 - Stardos
17.14.3.33 32 - EasyFlash
17.14.3.34 33 - EasyFlash Xbank
17.14.3.35 34 - Capture
17.14.3.36 35 - Action Replay 3
17.14.3.37 36 - Retro Replay
17.14.3.38 37 - MMC64
17.14.3.39 38 - MMC Replay
17.14.3.40 39 - IDE64
17.14.3.41 40 - Super Snapshot V4
17.14.3.42 41 - IEEE-488
17.14.3.43 42 - Game Killer
17.14.3.44 43 - Prophet64
17.14.3.45 44 - EXOS
17.14.3.46 45 - Freeze Frame
17.14.3.47 46 - Freeze Machine
17.14.3.48 47 - Snapshot 64
17.14.3.49 48 - Super Explode V5.0
17.14.3.50 49 - Magic Voice
17.14.3.51 50 - Action Replay 2
17.14.3.52 51 - MACH 5
17.14.3.53 52 - Diashow maker
17.14.3.54 53 - Pagefox
17.14.3.55 54 - Kingsoft
17.14.3.56 55 - Silverrock 128
17.14.3.57 56 - Formel 64
17.14.3.58 57 - RGCD
17.14.3.59 58 - RR-Net MK3
17.14.3.60 59 - EasyCalc
17.14.3.61 60 - GMod2
17.14.3.62 61 - MAX Basic
17.14.3.63 62 - GMod3
17.14.3.64 63 - ZIPP-CODE 48
17.14.3.65 64 - Blackbox V8
17.14.3.66 65 - Blackbox V3
17.14.3.67 66 - Blackbox V4
17.14.3.68 67 - REX RAM-Floppy
17.14.3.69 68 - BIS-Plus Cartridge
17.14.3.70 69 - SD-BOX
17.14.3.71 70 - MultiMAX
17.14.3.72 71 - Blackbox V9
17.14.3.73 72 - Lt. Kernal Host Adaptor
17.14.3.74 73 - RAMLink
17.14.3.75 74 - H.E.R.O.
17.15 The PSID image format for ripped SID tunes
17.15.1 The SID file header v1
17.15.2 The SID file header v2, v3 and v4
17.15.3 The SID file environment
18 Acknowledgments
19 Copyright
20 Contact information
20.1 VICE home page
20.2 How to send feedback
20.3 How to contribute
Concept Index
Index of Resources
Index of Command-line options
Next:
GNU GENERAL PUBLIC LICENSE
, Previous:
(dir)
, Up:
(dir)
[
Contents
][
Index
]