VICE, 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 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 Shared memory 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
• 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 Previewing the image contents
    • 5.5.2 "Autostarting" an image
    • 5.5.3 Using compressed files
    • 5.5.4 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 using openGL Rastersynchronization under X11
    • 6.5.2 Video resources
  • 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 Monitor settings
    • 6.13.1 Monitor resources
    • 6.13.2 Monitor command-line options
  • 6.14 Memory settings
    • 6.14.1 Memory resources
    • 6.14.2 Memory command-line options
  • 6.15 Miscellaneous settings
    • 6.15.1 Miscellaneous resources
    • 6.15.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.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 AmigaOS-specific features
    • 8.1.1 Amiga (AmigaOS3/AmigaOS4/MorphOS/AROS) specific resources
    • 8.1.2 Amiga (AmigaOS3/AmigaOS4/MorphOS/AROS) specific command-line options
    • 8.1.3 AmigaOS3-specific features
      • 8.1.3.1 AmigaOS3 specific resources
      • 8.1.3.2 AmigaOS3 specific command-line options
    • 8.1.4 AmigaOS4-specific features
      • 8.1.4.1 AmigaOS4 specific resources
      • 8.1.4.2 AmigaOS4 specific command-line options
    • 8.1.5 MorphOS-specific features
      • 8.1.5.1 MorphOS specific resources
      • 8.1.5.2 MorphOS specific command-line options
    • 8.1.6 AROS-specific features
      • 8.1.6.1 AROS specific resources
      • 8.1.6.2 AROS specific command-line options
  • 8.2 BeOS-specific features
    • 8.2.1 BeOS specific resources
    • 8.2.2 BeOS specific command-line options
  • 8.3 DOS-specific features
    • 8.3.1 DOS joystick hardware types
    • 8.3.2 DOS specific resources
    • 8.3.3 DOS specific command-line options
  • 8.4 OS2-specific features
  • 8.5 SDL-specific features
    • 8.5.1 SDL specific resources
    • 8.5.2 SDL specific command-line options
  • 8.6 Unix-specific features
    • 8.6.1 Unix specific resources
    • 8.6.2 Unix specific command-line options
    • 8.6.3 XAW-specific features
      • 8.6.3.1 XAW GUI specific resources
      • 8.6.3.2 XAW GUI specific command-line options
    • 8.6.4 GTK-specific features
      • 8.6.4.1 GTK GUI specific resources
      • 8.6.4.2 GTK GUI specific command-line options
  • 8.7 Mac OS X-specific features
  • 8.8 Windows-specific features
    • 8.8.1 Windows GUI specific resources
    • 8.8.2 Windows GUI 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 c1541
  • 13.1 Specifying files in c1541
  • 13.2 Using quotes and backslashes
  • 13.3 c1541 commands and options
  • 13.4 Executing shell commands
  • 13.5 c1541 examples
• 14 cartconv
  • 14.1 cartconv command line options
  • 14.2 cartconv examples
• 15 petcat
  • 15.1 petcat command line options
  • 15.2 petcat examples
• 16 The emulator file formats
  • 16.1 The T64 tape image format
    • 16.1.1 T64 File structure
    • 16.1.2 Tape Record
    • 16.1.3 File record
  • 16.2 The G64 GCR-encoded disk image format
    • 16.2.1 The original format
    • 16.2.2 An extension for double sided disks (Commodore VIC 1571)
  • 16.3 The P64 NRZI flux pulse disk image format
    • 16.3.1 P64 Header Layout
    • 16.3.2 P64 Chunk Header Layout
    • 16.3.3 P64 Chunk 'HTPx' Layout
    • 16.3.4 'HTPx' Range encoded data format
    • 16.3.5 P64 Chunk 'DONE' Layout
  • 16.4 The D64 disk image format
    • 16.4.1 Non-Standard & Long Directories
    • 16.4.2 BAM layout
    • 16.4.3 Variations on the D64 layout
    • 16.4.4 Error codes
  • 16.5 The X64 disk image format
  • 16.6 The D71 disk image format
    • 16.6.1 Non-Standard & Long Directories
    • 16.6.2 Bam layout The BAM is somewhat different as it now has to
  • 16.7 The D81 disk image format
    • 16.7.1 Non-Standard & Long Directories
    • 16.7.2 BAM layout
    • 16.7.3 REL files The REL filetype requires some extra explaining.
    • 16.7.4 1581 Partitions and Sub-directories
    • 16.7.5 AUTO-BOOT LOADER
  • 16.8 The D80 disk image format
    • 16.8.1 Non-Standard & Long Directories
    • 16.8.2 BAM layout
  • 16.9 The D82 disk image format
    • 16.9.1 Non-Standard & Long Directories
    • 16.9.2 BAM layout
  • 16.10 The P00 image format
  • 16.11 The CRT cartridge image format
    • 16.11.1 Header contents
    • 16.11.2 CHIP Contents
    • 16.11.3 Cartridge Specifics
      • 16.11.3.1 0 - Normal cartridge
      • 16.11.3.2 1 - Action Replay
      • 16.11.3.3 2 - KCS Power Cartridge
      • 16.11.3.4 3 - Final Cartridge III
      • 16.11.3.5 4 - Simons' Basic
      • 16.11.3.6 5 - Ocean type 1
      • 16.11.3.7 6 - Expert Cartridge
      • 16.11.3.8 7 - Fun Play, Power Play
      • 16.11.3.9 8 - Super Games
      • 16.11.3.10 9 - Atomic Power
      • 16.11.3.11 10 - Epyx Fastload
      • 16.11.3.12 11 - Westermann Learning
      • 16.11.3.13 12 - Rex Utility
      • 16.11.3.14 13 - Final Cartridge I
      • 16.11.3.15 14 - Magic Formel
      • 16.11.3.16 15 - C64 Game System, System 3
      • 16.11.3.17 16 - Warp Speed
      • 16.11.3.18 17 - Dinamic
      • 16.11.3.19 18 - Zaxxon, Super Zaxxon (SEGA)
      • 16.11.3.20 19 - Magic Desk, Domark, HES Australia
      • 16.11.3.21 20 - Super Snapshot V5
      • 16.11.3.22 21 - Comal-80
      • 16.11.3.23 22 - Structured Basic
      • 16.11.3.24 23 - Ross
      • 16.11.3.25 24 - Dela EP64
      • 16.11.3.26 25 - Dela EP7x8
      • 16.11.3.27 26 - Dela EP256
      • 16.11.3.28 27 - Rex EP256
      • 16.11.3.29 28 - Mikro Assembler
      • 16.11.3.30 29 - Final Cartridge Plus
      • 16.11.3.31 30 - Action Replay 4
      • 16.11.3.32 31 - Stardos
      • 16.11.3.33 32 - EasyFlash
      • 16.11.3.34 33 - EasyFlash Xbank
      • 16.11.3.35 34 - Capture
      • 16.11.3.36 35 - Action Replay 3
      • 16.11.3.37 36 - Retro Replay
      • 16.11.3.38 37 - MMC64
      • 16.11.3.39 38 - MMC Replay
      • 16.11.3.40 39 - IDE64
      • 16.11.3.41 40 - Super Snapshot V4
      • 16.11.3.42 41 - IEEE-488
      • 16.11.3.43 42 - Game Killer
      • 16.11.3.44 43 - Prophet64
      • 16.11.3.45 44 - EXOS
      • 16.11.3.46 45 - Freeze Frame
      • 16.11.3.47 46 - Freeze Machine
      • 16.11.3.48 47 - Snapshot 64
      • 16.11.3.49 48 - Super Explode V5.0
      • 16.11.3.50 49 - Magic Voice
      • 16.11.3.51 50 - Action Replay 2
      • 16.11.3.52 51 - MACH 5
      • 16.11.3.53 52 - Diashow maker
      • 16.11.3.54 53 - Pagefox
      • 16.11.3.55 54 - Kingsoft
      • 16.11.3.56 55 - Silverrock 128
      • 16.11.3.57 56 - Formel 64
      • 16.11.3.58 57 - RGCD
      • 16.11.3.59 58 - RR-Net MK3
      • 16.11.3.60 59 - EasyCalc
      • 16.11.3.61 60 - GMod2
  • 16.12 The PSID image format for ripped SID tunes
    • 16.12.1 The SID file header v1
    • 16.12.2 The SID file header v2, v3 and v4
    • 16.12.3 The SID file environment
• 17 Acknowledgments
• 18 Copyright
• 19 Contact information
  • 19.1 VICE home page
  • 19.2 How to send feedback
  • 19.3 How to contribute
  • 19.4 Interesting newsgroups
  • 19.5 FAQs you should read
• Concept Index
• Index of Resources
• Index of Command-line options

This document was generated on 6 November 2017 using a slightly modified version of the texi2html translator version 1.52.