Pixel exact emulation of the Commodore 128,Commodore 64, Spectrum 48/128K,VIC 20 and Atari 2600
Z64K should run on any platform with an updated java runtime environment installed. I will update this site when I get some free time but in the mean time feel free to drop me a message via the contact page with feedback or questions. The changelog only includes changes not shown on this homepage.
*tip: ALT-ENTER togglesfullscreen mode
***JAVA 9, 10 and 11 users should use the -Dsun.java2d.uiScale=1.0 option if the screen does not render nicely on your setup. See https://bugs.openjdk.java.net/browse/JDK-8189416***
LINUX users: You might need to change the permission of Z64K.jar to allow execution. e.g. chmod +x Z64K.jar.
Requires JRE 8 or better. For latest features use this version.*
* last updated 9 September 2022
Size : 2114.502 Kb
Type : jar
Size : 2.583 Kb
Type : txt
Size : 1104.5 Kb
Type : doc
Size : 6.989 Kb
Type : txt
- ALT+O = Toggle output of VICIIe/VDC to main screen (C128 only)
- ALT+2 = Toggle 2nd display ON/OFF (C128 only)
- ALT+ENTER = Toggle Fullscreen mode
- ALT+INSERT = Paste text from clipboard
- ALT+DELETE = Copy screen text to clipboard
- ALT+Q = Toggle capture mouse (C128 & C64)
- ALT+R = Soft reset
- CTRL+ALT+R = Hard reset
- ALT+W = Toggle Warp mode
The following keymappings override the values in the keyboard configuration editor for the C128
F9 = F1/F2
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.
Version 2 - http://www.z64k.com/resources/version2/Z64K.jar
- Fix bug with Testbench not starting if it hasn't been previouslyconfigured
- Minor updates to improve catching of filechooser race conditions that very rarely causes null value error that crashes emulator.
- Machine monitor peeks IO range for C128 when mapped in.
- Update MMU to behave like majority of tested C128's where zeropage and stack are both set to the same page. All mmu tests in VICE test repository pass.
- Allow mapping in of C128 kernal while in Z80 mode.
- Virtual FS scratch command will add .del extension to "deleted" file. When saving new file with same filename as "deleted" file, the "deleted" file will be removed from the host file system.
- Show read only flag if set when displaying directory in Virtual FS.
- Prevent saving of files with invalid host system filename when using Virtual FS.
- Allow wildcard (* and ?) filters when loading Virtual FS directory.
- Virtual FS scratch command simulated but does not currently delete any files from host file system.
- Select correct drive when loading disk image if Virtual FS is currently selected
- Disk viewer can be scrolled by mouse wheel.
- Improved accuracy of clickable disk viewer when scrolled
- Fix bug when loading file via double clicking disk viewer for device 10 and 11.
- Double clicking DIR file types in disk viewer will open that directory.
- Show files in Disk preview for Virtual FS.
- Adjust calculated file block size s for virtual FS
- Fix minor bug where Virtual FS CD doesn't work immediately after reset
- Allow saving of files with Virtual FS.
- Virtual FS load"*",8 will load the last loaded program. If no programs have previously been loaded, the first program will be loaded.
- Fix bug with Virtual FS where JiffyDOS protocol could be incorrectly triggered when byte $61 is received directly after a talk request
- Current folder selector for Virtual FS available in drive settings.
- Fixed wildcard loading of firstfile with Virtual VS
- Fixed bug that prevented JiffyDOS command @$ from working with Virtual FS
- Improved Virtual FS JiffyDOS timing.
- Implement Virtual FS UI command. C128 "warm resets" drive message on error channel.
- Flash LED when error occurs with Virtual FS
- Improved reliability of Virtual FS JiffyDOS support.
- Ordered Virtual FS display of subdirectories and files.
- Included Virtual FS CD command
- Update status of Virtual FS in disk UI
- Improved Virtual FS error handling
- Improved C128 Virtual FS device support
- Improved Virtual FS device JiffyDOS support
- load programs with .prg extension without needing to include the .prg in the load command
- New Virtual FS device available under drive type settings - Experimental and still a work in progress. Location set to prg path in paths setting.
- Fixed bug that caused emulator to crash on exit with older versions of saved config
- Include SID Analyzer in version 2 of Z64K.
F1 = Toggle voice 1 ON/OFF
F2 = Toggle voice 2 ON/OFF
F3 = Toggle voice 3 ON/OFF
F4 = Toggle voice 4 (volume samples) ON/OFF
F5 = Display waveform
F6 = Display envelope
F7 = Display oscillator
F8 = Display combined
F9 = Pause (press F5-F8 to un-pause)
F11 = speed down
F12 = speed up
- Decommission version 1 of Z64K.
- Improved emulation of single pixel mode when char total horizontal less than 8 pixels .
- Implement some odd behaviors of VDC in single pixel mode when char total horizontal less than 8 pixels.
- Mouse can be captured using eitherVDC or VIC screen
- Double click of mouse toggles full screen
- Fixed bug with c1541 and c1571 snapshot component that wasn't saving VIA state correctly.
- Fixed bug with C128 snapshots that prevented VDC and 2nd 64K RAM bank from saving.
- U2+/U64 "enhanced" g71 read support.
- Save current ROM configuration on exit.
- add ASCII/DIN option for c128 chargen in ROM settings.
- Use correct part of c128 chargen ROMin C128 mode.
- Bug fix with size of each stored track in g71 header to use LO/HI
- Assembler updates to add support for equ, dc and ds keywords
- Minor fixes to saving and loading of g71 images
- Improved IMD disk image support
- Loading of 5.25 Imagedisk (.imd) image support.
- Fixed bug that wouldn't allow all MFM sectors to load from g71 images
- Minor update to g71 format to keep header as GCR-1571 for images with MFM tracks
- Included support to save g64 images
- Included support to load and save g71 images (includes saving of MFM tracks if they exist). note: preview window for some g71 images might not work.
- Fixed bug when load g64 images with half tracks
- remove debugging output
- Minor improvements forsupport of g64 images
- Improved diskSYNC detection
- update from today's previous version:- 1571 MFM uses the same disk surface as GCR.
- Major update to 5.25 disk surface.
Improved custom speed zone handling. All VICE test repository RPM tests pass.
1571 burst MFM support. All R/W tests of the 1571 system version test 1.2.1 including MFM format and mfm burst write/read/compare pass.
- Improve VIA shift register behavior. All VICE test repository shift register tests pass
- Fix VIA handshaking of CB2. Majority of VICE VIC 20 VIA SR tests pass.
- VICIIModel command line option. Possible values 6569, 8565, 6567, 8562, or 6567r56a.
- Fixed update of Testbench directory. Can use testbench straight away once valid testbench directory is configured.
- Add drive8type, drive9type, drive10type, and drive11type command line options. Possible values are none,1541, 1571, or 1581. e.g Z64K.jar c64 -drive8type 1571
- Updated Userport DAC to have four 8 bit D/A Convertors. ModPlay DigiMAX stereo - 8 bit userport DAC driver is now supported.
- Removed debug output I forgot to comment out when testing snow effect behavior for ZX Spectrum
- Update to Z80 flag behavior for interrupted block instructions as discussed at Z80 Block Flags Test for the "recently" discovered behavior of the block instructions of the Z80 CPU.
- Use correct palette for VIC20 testbench
- Increase timeout before hard reset when autoloading file off disk via command line options. C128 can start programs off disk in c64 mode now.
- Autostart of program of mounted disk using wildcard via command line options loads first PRG file off disk
- Fix z80 behavior using bank 2 without extended memory
- Updates to c128 mmu. mmuswap-08 and mmuswap-16 pass. All test results match real hardware.
- Use correct block for zero page and stack when RAM backs 2 & 3 are enabled. Fixes PIA globe test
3 January 2022
- Update to c128 mmu swap of zero page to stack and vice versa. All test results at https://sourceforge.net/p/vice-emu/code/HEAD/tree/testprogs/c128/mmu/ match real hardware.
- Allow autoload of file on disk via command line. Append disk source filename with colon and file to be automatically loaded. eg java -jar Z64K.jar c64-8 G:\old_school\C64\disks\geos-plain.d64:boot
- 128, 256, 512, 1024, 2024, and 4096 selectable GEORAM sizes.
- Include updating Z80 registers HL in machine monitor
- C128 writes to dxxx RAM in Z80 mode for bank 0
- Enable beeper by default for ZX Spectrum
- Fixed bug that prevented path and rom locations being reloaded from saved configuration.
- opengl disabled by default. Should only be enabled if UI issues occur on newer graphic cards. Option to enable is available in General Global Settings. Emulator needs to be restarted before effects are applied.
- new command line option -safemode. Disables opengl in config if unable to access settings to unselect the opengl option, All other command line options are ignored in safemode eg. java -jar Z64K.jar -safemode
- Use opengl for hardware acceleration. Fixes glitches in UI without need for Dsun.java2d.d3d=false as a VM option at startup. Improves screen refresh.
- Swiftlink cartridge supports Turbo232 speeds
- Cartridges that don't use IO1 and/or IO2 can be connected at the same time as other expansion devices.
- UI changes to cartridge settings.
- Disable audio master gain adjustment for systems that don't support it.
- Updates to Swiftlink cartridge to support retroterm
- Included buffer free progress bar in settings for internal userport modem.
- Improved some rs232 badly formed address error handling.
- Echo, quiet and verbose toggle button available in settings for userport internal modem
- Set echo default to false. Prevents UP9600 driver in Striketerm being locked if modem on when driver selected
- Detect when client disconnects.
- Minor improvements to Hayes Modem command mode behavior.
- Internal modem echo on and quiet off by default. Echo only in command mode.
- Improved timing of userport rs232 receiving of data. Streaming of audio using retroterm 0.13 plays audio stream at correct speed and no longer causes modem buffer to overflow when playing long streams.
- Increase internal modem buffer size
- Minor Improvements to Machine Monitor next command behaviour.
- Added Machine Monitor next (n) command. Single steps instruction but treats subroutines as a single instruction. Note to self: Must find some decent icons for the single stepping icons. :)
- Fixed debugging with monitor for C128 Z80 cpu memory locations $1800-$3fff
- REU retains memory after reset
- Allow Userport modem to send and receive data at same time
- Added 57600 baud rate option for userport rs232 to support Retroterm V0.13
- Fixed reset bug that wasn't clearing Z80 HALT state when interrupts were disabled.
- Improvements with Z80 HALT timing
- More improvements to ZX spectrum snow effect
- Applied some improvements to ZX Spectrum snow effect as discussed at Playing Robotics on ZX UNO+ - Page 3 - Spectrum Computing Forums
- Setting of Z80 registers using machine monitor is now functional
- Setting of Z80/6502 registers with machine monitoruses current radix
- C128 d7xx floating IO
- refresh DRAM in 2 Mhz mode reads valid data. https://sourceforge.net/p/vice-emu/code/HEAD/tree/testprogs/c128/openio/htst.prg flickers display like real hardware
- Default internal modem with echo off, verbose on, and quiet on.
- Improved internal modem Hayes command set.
- Option to disable userport rs232 modem emulation. Allows connection to tcpser etc.
- Fixed broken fast 1581 serial caused by recent changes to support UP9600
- Included a default keyboard mapping for German keyboards thanks to Tokra . Disclaimer: not thoroughly tested but is much better than the default English mapping when using a German Keyboard. :)
- Fixed restore key for VIC20.
- VIC 20 uses mike-pal.vpl as default
- Some minor fixes with timing of VIC interlace signal
- Userport rs232 modem synchronisation greatly improved. Data transfers much more reliable with UP9600 and standard userport drivers.
- Minor adjustment to value read for VIC $9004 register when in NTSC mode depending on cycle
- Added UP9600 rs232 modem support.
- Fixed bug with automatic loading of SDR value into CIA shift register when loaded at same time as final bit of previous SDRshifted out.
- Improvements to Userport RS232. Huge improvement with sending valid data!
- Fixed ZX spectrum settings title
- Allow ZX spectrum to be default application on startup
- Fixed bug with command line option -limitcycles that caused it not to trigger with TestBench scripts.
- Minor change to latching behaviour to trigger on correct edge as set in ACR. Drive sends pulse from byte ready signalto trigger latching.
- Update to VIA port latching. Fixes VICE bug#582 and Freespin still works!
- Fixed bug with VIA latching not clearing when CA1 interrupt is cleared. Freespin demo doesn't crash anymore. :)
- Added undocumented drive machine monitor commands motor and track
motor [on:off] - turn motor on/off , without arguments prints status of drive motor
track [in:out] - move rw head in/out 1 half track, without arguments prints current track
- Adjusted disk SYNC detection. his-protection test passes.
- Enabled Internal Palette selector available in settings.
- Updated default VDC palette to c128-vdc-deekay.vpl as suggested by Deekay in the readme of the Colour Spectrum demo.
- Freespin runs on 1571 drive in addition to 1541
- C128 support of drive GPU required for Freespin demo
- Improved sync detection. Freespin display a lot more stable (when it actually runs).
- Fixed bug with VIA reset code that would lock drive if PB7 output was on. Freespin no longer locks the drive after reset.
- Show correct frames/second in the frame title for all video chips, including simulated drive gpu.
- Added sound support for Freespin demo. note: Demo still does not run reliably every time yet in emulation but it is improving.
- Improved Freespin demo support. Better drive sync detection. Displays graphical effects correctly (when it works) warning: sometimes crashes the drive where the entire emulator needs to be closed and restarted. Freespin support is still a work in progress.
To play the Freespin demo, after the drive code has loaded, select Drive GPU from Machine settings==> Model panel. When screen turn blacks reattach the same disk image to start the demo.
- Fix debugging of Z80 LD A,I and LD A,R
- Added option to use disk drive as GPU for Freespin demo. note: Not reliable and does not play sounds yet.
- Some improvements to userport rs232 emulation.