The Versatile Commodore Emulator

• 1 GNU GENERAL PUBLIC LICENSE
  • Preamble
  • TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
  • How to Apply These Terms to Your New Programs
• 2 About VICE
  • 2.1 Emulator features
    • 2.1.1 C64 emulator features
    • 2.1.2 C64DTV emulator features
    • 2.1.3 C128 emulator features
    • 2.1.4 VIC20 emulator features
    • 2.1.5 PET emulator features
    • 2.1.6 CBM-II emulator features
    • 2.1.7 SCPU64 emulator features
  • 2.2 The keyboard emulation
    • 2.2.1 C64 & VIC20 Keyboard Map
      • 2.2.1.1 Symbolic (US)
      • 2.2.1.2 Positional (US)
      • 2.2.1.3 Symbolic (DE)
      • 2.2.1.4 Positional (DE)
    • 2.2.2 C128 Keyboard Map
      • 2.2.2.1 Symbolic (US)
      • 2.2.2.2 Positional (US)
      • 2.2.2.3 Symbolic (DE)
      • 2.2.2.4 Positional (DE)
    • 2.2.3 C16 & Plus4 Keyboard Map
    • 2.2.4 PET Graphics Keyboard Map
      • 2.2.4.1 Symbolic (US)
      • 2.2.4.2 Positional (US)
      • 2.2.4.3 Symbolic (DE)
      • 2.2.4.4 Positional (DE)
    • 2.2.5 PET Business Keyboard Map
      • 2.2.5.1 Symbolic (US)
      • 2.2.5.2 Positional (US)
      • 2.2.5.3 Symbolic (DE)
      • 2.2.5.4 Positional (DE)
    • 2.2.6 CBM2 Keyboard Map
  • 2.3 The joystick emulation
  • 2.4 The disk drive emulation
  • 2.5 Supported file formats
  • 2.6 Common problems
    • 2.6.1 Sound problems
    • 2.6.2 Video problems
    • 2.6.3 Printer problems
    • 2.6.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.2.1 Comments
    • 4.2.2 Control commands
    • 4.2.3 Key mappings
      • 4.2.3.1 Special Rows
      • 4.2.3.2 Modifier Flags
  • 4.3 Palette files
  • 4.4 Romset files
    • 4.4.1 Romset command line options
  • 4.5 Gtk3 Hotkeys files
  • 4.6 Syntax of the hotkeys files
    • 4.6.1 Comments
    • 4.6.2 Directives
      • 4.6.2.1 !CLEAR
      • 4.6.2.2 !DEBUG
      • 4.6.2.3 !INCLUDE
      • 4.6.2.4 !UNDEF
    • 4.6.3 Hotkey mappings
      • 4.6.3.1 Syntax
    • 4.6.4 List of modifiers
    • 4.6.5 List of action names
    • 4.6.6 Syntax highlighting
• 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 Using printer emulation
  • 5.7 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.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.6.5 Control port and devices
  • 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 Ethernet emulation
    • 6.13.1 Ethernet usage example
    • 6.13.2 Ethernet resources
    • 6.13.3 Ethernet command line options
  • 6.14 Tape port devices
    • 6.14.1 Tape port resources
    • 6.14.2 Tape port command line options
  • 6.15 Userport devices
    • 6.15.1 Userport resources
    • 6.15.2 Userport command line options
  • 6.16 Monitor settings
    • 6.16.1 Monitor resources
    • 6.16.2 Monitor command-line options
  • 6.17 RAM init pattern settings
    • 6.17.1 RAM init pattern resources
    • 6.17.2 RAM init pattern command-line options
  • 6.18 Debug settings
    • 6.18.1 Debug resources
    • 6.18.2 Debug command-line options
  • 6.19 Network Play settings
    • 6.19.1 Network Play resources
    • 6.19.2 Network Play command-line options
  • 6.20 Miscellaneous settings
    • 6.20.1 Miscellaneous resources
    • 6.20.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 C128 cartridge settings
      • 7.2.1.1 C128 cartridge resources
      • 7.2.1.2 C128 cartridge command-line options
    • 7.2.2 VDC settings
      • 7.2.2.1 VDC resources
      • 7.2.2.2 VDC command-line options
    • 7.2.3 C128 system ROM settings
      • 7.2.3.1 C128 system ROM resources
      • 7.2.3.2 C128 system ROM command-line options
    • 7.2.4 C128 settings
      • 7.2.4.1 C128 resources
      • 7.2.4.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 prg files
    • 7.5.2 Using cartridge images
    • 7.5.3 VIC20 cartridge settings
      • 7.5.3.1 VIC20 cartridge resources
      • 7.5.3.2 VIC20 cartridge command-line options
    • 7.5.4 VIC settings
      • 7.5.4.1 VIC resources
      • 7.5.4.2 VIC command-line options
    • 7.5.5 Changing memory configuration
      • 7.5.5.1 VIC20 memory configuration resources
      • 7.5.5.2 VIC20 memory configuration command-line options
    • 7.5.6 VIC20 system ROM settings
      • 7.5.6.1 VIC20 system ROM resources
      • 7.5.6.2 VIC20 system ROM command-line options
    • 7.5.7 VIC20 settings
      • 7.5.7.1 VIC20 command-line options
  • 7.6 PLUS4-specific commands and settings
    • 7.6.1 Using cartridge images
    • 7.6.2 PLUS4 cartridge settings
      • 7.6.2.1 PLUS4 cartridge resources
      • 7.6.2.2 PLUS4 cartridge command-line options
    • 7.6.3 TED settings
      • 7.6.3.1 TED resources
      • 7.6.3.2 TED command-line options
    • 7.6.4 PLUS4 I/O extension settings
      • 7.6.4.1 PLUS4 I/O extension resources
      • 7.6.4.2 PLUS4 I/O extension command-line options
    • 7.6.5 PLUS4 system ROM settings
      • 7.6.5.1 PLUS4 system ROM resources
      • 7.6.5.2 PLUS4 system ROM command-line options
    • 7.6.6 PLUS4 settings
      • 7.6.6.1 PLUS4 resources
      • 7.6.6.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 VICE info (0x85)
    • 13.4.23 Palette get (0x91)
    • 13.4.24 Joyport set (0xa2)
    • 13.4.25 Userport set (0xb2)
    • 13.4.26 Exit (0xaa)
    • 13.4.27 Quit (0xbb)
    • 13.4.28 Reset (0xcc)
    • 13.4.29 Autostart / autoload (0xdd)
  • 13.5 Responses
    • 13.5.1 Invalid Response (0x00)
    • 13.5.2 Checkpoint Response (0x11)
    • 13.5.3 Register Response (0x31)
    • 13.5.4 JAM Response (0x61)
    • 13.5.5 Stopped Response (0x62)
    • 13.5.6 Resumed Response (0x63)
  • 13.6 Example Projects
• 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 supported cartridge types
  • 15.3 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 C64 Cartridge Specifics
      • 17.14.3.1 0 - generic 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 - Drean
      • 17.14.3.76 75 - IEEE Flash! 64
      • 17.14.3.77 76 - Turtle Graphics II
      • 17.14.3.78 77 - Freeze Frame MK2
      • 17.14.3.79 78 - Partner 64
    • 17.14.4 C128 Cartridge Specifics
      • 17.14.4.1 0 - generic (external Function ROM)
      • 17.14.4.2 1 - Warpspeed128
      • 17.14.4.3 2 - Partner 128
      • 17.14.4.4 3 - Comal 80
      • 17.14.4.5 4 - Magic Desk 128
      • 17.14.4.6 5 - Gmod2-C128
    • 17.14.5 VIC20 Cartridge Specifics
      • 17.14.5.1 0 - generic cartridge
      • 17.14.5.2 1 - Mega-Cart
      • 17.14.5.3 2 - Behr Bonz
      • 17.14.5.4 3 - Vic Flash Plugin
      • 17.14.5.5 4 - UltiMem
      • 17.14.5.6 5 - Final Expansion
    • 17.14.6 PLUS4 Cartridge Specifics
      • 17.14.6.1 0 - generic cartridge
      • 17.14.6.2 1 - c264 magic cart
      • 17.14.6.3 2 - Plus4 multi cart
      • 17.14.6.4 3 - 1MB Cartridge
    • 17.14.7 CBM2 Cartridge Specifics
      • 17.14.7.1 0 - generic cartridge
  • 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
  • 17.16 The Swaplist (.vfl, .lst) file format
    • 17.16.1 general
    • 17.16.2 extensions
      • 17.16.2.1 VICE
      • 17.16.2.2 sd2iec
      • 17.16.2.3 Chameleon
      • 17.16.2.4 pi1541
    • 17.16.3 Examples
• 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

This document was generated on 27 December 2022 using a slightly modified version of the texi2html translator version 1.52.