Z64K v1.2.3 (c) William McCabe Released 01 June 2019 Quickstart guide Z64K is a pixel exact emulator of the Atari 2600, Commodore 64, Commodore 128, and VIC 20. Keyboard mapping is positional to match real c64/c128/vic 20 key positions and combinations so some keys will not match PC keyboard keys. Refer to Z64K.com for a reference on what the c64 keyboard mapping is. Overview Atari 2600 Pixel exact TIA emulation including sound. F2 COLOR - B/W F3 Left Difficulty F6 Right Difficulty F7 Game Select F8 Game Reset F11 Swap Joystick Commodore 64 Pixel exact VICII emulation - PAL/NTSC/NTSC OLD Cycle exact MOS 6510, SID and CIA. Cartridge support for the following crt types: - Action Replay - KCS Power Cartridge - Final Cartridge III - Simons' Basic - Ocean Type 1 - Expert cartridge - Super Games - Epyx Fastload - Final Cartridge I - Game System - Dinamic - Zaxxon - Magic Desk - Super Snapshot V5 - Comal80 - EasyFlash - GMod2 Digimax REU - 512KB and 16MB GEORAM CPM cartridge Swiftlink cartridge Userport RS232 - UP9600 SID Player SID Analyser F1 - toggle SID voice 1 F2 - toggle SID voice 2 F3 - toggle SID voice 3 F5 - show waveform F6 - show envelope F7 - show accumator F8 - show voice output (default) F11 - decrease samples F12 - increase samples Commodore 128 All featues of Commodore 64 Full VICIIe 2Mhz mode support including correct clock strething timing and graphics output. VICIIe test bit All known VDC modes including interlaced graphics. Full burst mode support. Full MMU support Internal and external function roms VIC 20 Pixel exact VIC emulation including sound. PAL and NTSC Cycle exact MOS 6502, and VIA. NTSC VIC interlace mode Drives Read and write 1541, 1571, and 1581 floppy drives Cycle exact 6502, VIA and CIA Full 2Mhz support for 1571 and 1581. Support for d64, d71, d81,and g64 disk images Tape - read and write Custom ROM support for romsets like JiffyDOS Mouse and gamepad support. Requirements JRE 1.7.0 or higher How to start Z64K If you have Java Runtime Environment 7 or higher installed you should be able to start the emulator by simply double clicking the Z64K.jar file. If you have Java 9 or higher installed and experience display issues I recommend using a batch file to start the emulator and set ui scaling to 1 something similar to the following command for improved display. javaw –Dsun.java2d.uiScale=1.0 -jar Z64K.jar Command Line options Z64K.jar [atari|c64|c128|vic20] [args...] These were initially created to support the VICE testbench scripts. Where possible I use the same format as VICE for consistency between emulators. All options require a computer model to be explicitly declared unless otherwise stated. All computer models -console Disable UI. Used for automatic testing of emulator with testbench developed by the VICE DEV team. -debugcart Enable debug cartridge used with the testbench scripts created by the VICE DEV team. -exitscreenshot Specify name of a screenshot file that will be written when the emulator exits. -limitcycles Automatically exit the emulator after a given number of cycles. -soundrate Specify the sound playback sample rate (SoundSampleRate). (8000..192000) -soundbufsize Specify the size of the audio buffer in milliseconds (25..350). -snapshot Restore emulator to a saved state. This option does not require a computer model to be included in the command line. -warp Start emulator in warp mode C64 -8 attach disk image -cartcrt Attach CRT cartridge image. -georam Enable GEORAM -moncommands Execute the commands from the file in the monitor after starting up. This command line switch is mainly used set breakpoints. Not all other commands are useful to be executed in this way, some may even lead to strange effects. -VICIIpalette Specify the name of the palette file. (currently only pepto-pal.vpl is recognised which is used for testbench) -pal Use PAL sync factor -ntsc Use NTSC sync factor -ntscold Use old NTSC sync factor -ciamodel Set both CIA models. (0: old 6526, 1: new 6526A) -reu Enable REU. reusize required (see below) -reusize Size of the RAM expansion unit. (512, 16384) -sidenginemodel Specify engine and model for the emulated SID chip. (256/resid/residold/resid6581, ReSID 8580: 257/residnew/resid8580) C128 -80col Start in 80 column mode -dualscreen Enable second screen -go64 Start in C64 mode -VDC16KB Set the VDC memory size to 16KB -VDC64KB Set the VDC memory size to 64KB VIC 20 -8 attach disk image -unexp -3k -8k -16k -24k -full -pal Use PAL sync factor -ntsc Use NTSC sync factor -VICIIpalette Specify the name of the palette file. (currently only mike-pal.vpl is recognised which is used for testbench) Command line examples Start c64 emulation javaw –Dsun.java2d.uiScale=1.0 -jar Z64K.jar c64 Start c128 emulation with both screens on and default to 80 column mode. javaw -jar Z64K.jar c128 -80col -dualscreen Restore emulator to saved state. javaw -jar Z64K.jar -snapshot F:\snapshots\samsjourney.zsf Start c128 emulation and execute program at E:\testprogs\c128\d030tester\d030tester2.0.prg java -jar Z64K.jar c128 E:\testprogs\c128\d030tester\d030tester2.0.prg Start VIC 20 with full memory in NTSC mode and insert disk at F:\vic20\retina\color\retina color.d64 java -jar Z64K.jar vic20 -full -ntsc "F:\vic20\retina\color\retina color.d64" Keyboard shortcuts ALT-R soft reset CTRL-ALT-R hard reset ALT-ENTER toggle fullscreen mode ALT-F frame skip (when emulator is paused) ALT-J toggle joystick ports ALT-P toggle pause ALT-Q toggle capture mouse ALT-W toggle warp mode ALT-O toggle c128 VDC/VICII output (c128 only) ALT-2 toggle 2nd screen (c128 only) ALT-INS paste text from clipboard to screen ALT-DELETE copy screen text to clipboard Additional C128 keys F1=ESC F2=TAB F3=ALT F4=CAPS LOCK F5= HELP F6=LINE FEED F7=40/80 DISPLAY F8=NO SCROLL The following keymappings override the values in the keyboard configuration editor for the C128 F9 = F1/F2 F10= F3/F4 F11= F5/F6 F12=F7/F8 Other changes are:- PC CAPS LOCK = C128 SHIFT LOCK For emulated NUMPAD Joystick Num Lock needs to be OFF. C128 NUMPAD keys works with Num Lock ON. There is an option to enable/disable extra c128 keys via settings==>setup==>Extended Keyboard keys in the latest downloadable version of the emulator. Default is enable extended keyboard keys in C128/CPM modes only. The C128 Direction keys are mapped to PC cursor keys, and CRSR U/D and CRSR L/R mapped to PC NUMPAD / and * when Extended Keyboard keys enabled.