Version 0.6

This release should be considered an alpha product. Significant feature and overall stability improvements have been made in this version.

All future versions will maintain snapshot capability with this version.. Version 0.5 and earlier snapshots are no longer supported.

Installation Notes

See Installation in the README for details.

The MANUAL.md contains more detailed instructions on using the emulator.

• Windows 10 or later required - Users will likely run into SmartScreen warnings as this is not a signed executable
• macOS Catalina or later
• Linux 64-bit - Tested under Ubuntu 20.xx (.deb file) and Manjaro (source build.)

New Features

For a complete list of changes see the CHANGELOG.md

• Maximized / non-debugger screen view mode added
• macOS Catalina support
• Dual hard drive emulation on Slot 7
• New Debugger Screen (WIP)
• Gamepad support
• Fast emulation mode
• Mouse tracking on the host desktop under GS/OS
• All Self-Diagnostic tests pass

Fixes

• Improved performance
• Better emulation of Apple II graphics modes
• Cycle timings based on the 28mhz IIgs clock
• IWM 3.5" disk emulation improvements to support more copy protection mechanisms and disk switching
• Apple II style floating bus
• Various I/O register fixes
• Shadowing and 80COLSTORE fixes
• ADB keyboard handling improvements
• Disabled s2d1 IWM Smartport
• Snapshot stability

Known Issues

• No 640 mode dithering
• ROM 1 not supported
• SCC only implemented to pass self-diagnostic (i.e. no practical use.)
• No ethernet, printers.
• Mockingboard VIA implementation is inefficient
• Textfunk demo does not work
• Ninjaforce demo does not work (No bit 16 address shadowing)

Tested Software

• Various titles from the "What is the Apple IIgs" launcher
• GS/OS System Software 6.0.1, 6.0.4
• ProDOS 8/16
• Where in the World is Carmen Sandiego (IIgs)
• California Games
• Kings Quest I, IV
• Space Quest I
• Thexder
• Silpheed
• Rastan
• Ultima IV remastered

Version 0.5

This should be considered a pre-release/alpha product.

Included in this release is Gamepad/Joystick support for both Windows and Linux, SmartPort 32MB hard drive support (running from the disk port vs Slot 7) and various emulator library API improvements.

Major IIGS features still missing include fask disk emulation, serial communication (Zilog SCC emulation) and ROM 01 support.

GSOS System 6.0.4 boots to the finder. Many games work with mouse support. There's a small glitch related to vertical refresh rate and the mouse pointer which may become obvious after starting at the screen for a while.

For missing features or documentation questions, feel free to enter issues.

See the README for details on features, build and usage instructions.

Abbreviated instructions - for Windows, drop the clemens_iigs.exe binary in a folder with a 256K ROM 3 binary named gs_rom_3.rom. The executable is not signed so you'll want to follow the usual instructions for running untrusted binaries.
Linux builds currently should be built from source per the instructions in the README.

The Wiki is currently light. Eventually it will contain everything that's currently in the Documentation Folder.

Version 0.6 will contain fast disk emulation, ROM 01 and general usability improvements.

Changelog

• SmartPort 32MB Hard Drive on the disk port, virtual slot 2, drive 1
• Gamepad and Joystick support on Windows (DirectInput) and Linux
• ADB fix allowing Ctrl-RightAlt-F1 to trigger the Control Panel
• IWM properly report spindle status on each drive
• Linux key mapping to support Alt-Fn key combinations
• Decouple Apple IIGS device types and APIs from the 65816 emulator
  library into its own library
  • Moved some graphics mode bitmap rendering into the library
  • Added register set commands in the debugger

Dependencies

• ininh (INI parsing) added to host

Version 0.4

This should be considered a pre-release/alpha product.

Included in this release is a revamped debugger GUI, improved title support, mouse events and Linux builds. The Apple //e side is mostly complete. The IIgs features are almost there with a few missing features: Smartport support being the major piece. Serial (the SCC) is also missing.

GS/OS 5 boots to the finder. Many games work with mouse support. There's a small glitch related to vertical refresh rate and the mouse pointer which may become obvious after starting at the screen for a while.

See the README for details on features, build and usage instructions. For missing features or documentation questions, feel free to enter issues.

Version 0.5 will likely contain Smartport support and be released by the end of the year.

CHANGELOG:

• New Debugger GUI and improved diagnostics display
• New Disk Import/Save/Load system for disk images (save/load as WOZ image)
• Mouse Support
• Lores and Double Lores Support
• Linux Builds with GCC using OpenGL for Rendering
• Fixed Super Hires Renderer to display correct colors
• Ensoniq fix that didn't account for the default voice (Neuromancer music plays)
• Fixed confusion between INTCXROM and SLOTROMSEL switches
• IRQs in native mode were firing the emulated IRQBRK vector
• Incorrect sync timing lead to invalid Vertical and Horizontal VGC counters
• Corrected BIT immediate flag manipulation
• Fixed 3.5" drive emulation disk-in-place query value (allowing GS/OS to boot)
• Flashing Text
• List toolbox calls in program trace
• Updated dependencies
  • ImGui to 1.88 and
  • fmt to 9.1.0
  • sokol to latest

Version 0.3

The "G" and "S" in an Apple IIgs. Also included Mockingboard C support, but this is currently disabled in code within the host application since there's no GUI to toggle Mockingboard card insertion and removal.

Note: ROM 03 is the only ROM currently supported. ROM 1 is on the roadmap.

A lot of Apple II titles work. Mockingboard is limited to the patched Ultima IV release. Mockingboard + IIgs has issues as documented in various online sources due to IIgs ROM implementation. A better fix would be to support an Apple //e ROM + IIgs machine architecture which should be possible.

• Super Hi-res mode and ProDOS 16 boot to finder
• 2MG 3.5 and 5.25" support
• DO, PO and DSK Load and Save
• Mockingboard C without SSI-223 (voice) support (Patched re-mastered Ultima IV)
• Improved Apple II Speaker support (still flawed but better)
• Boots Nox Archaist and various Apple II 128K games
• Ensoniq support - boots Tower of Myraglen