[8bit] Xroar 1.7.3 29/11/2024

Version 1.7.2, Tue 26 Nov 2024

• Fix GIME issue when loading from snapshot
• Fix becker port status polling [Pierre Sarrazin]

Version 1.7.1, Fri 22 Nov 2024

•  Reduce memory use when reading gamepad mappings file
•  Include missing files in tarball distribution [Rui Chen]

Version 1.7, Thu 21 Nov 2024

•  Avoid calling xroar_screenshot() when not supported [with Paul Ripke]
•  Avoid X11 keyboard init when SDL not build with X11 support [Paul Ripke]
•  SDL joystick module supports hotplug where possible
•  SDL joystick module creates Left & Right stick profiles if found
•  Support reading a SDL gamepad DB file for non-SDL joystick modules
•  New -joy-db-file option specifies SDL-compatible gamepad DB file
•  New Linux evdev joystick module (hotplug, internal SDL DB, L/R profiles)
•  Large changes to underlying UI mechanisms
•  New features backported to GTK+ 2 UI

Version 1.10, Fri 21 Nov 2025

• Fixed some 6809/6309 indexed instruction behaviour
• Fix some arming of NMI in 6809/6309
• Implement some more 6809 undocumented behaviour
• Disable vsync by default
• New option -vo-vsync to re-enable vsync.

Version 1.9, Sat 30 Aug 2025

• Trap-triggered traces now include trap instruction
• SDL: don't disable screensaver in windowed mode [Grégori Harbs]
• Windows: explicitly map Pause in automatic keyboard lang [Grégori Harbs]
• Include profile for Prológica CP-400
• SAMx8 support (specify -ram 512 for a Dragon 64)
• Fix second mouse button joystick mapping [Jim Mullis]
• Fix CoCo 3/GIME IRQ issues highlighted by Tim Lindner's test code
• Fix -ram-init set

Version 1.8.2, Fri 14 Feb 2025 

• SDL build fix [by Andrea Musuruane]

Version 1.8.1, Sun  2 Feb 2025

• Fix Mac OS X+ build under more modern compilers [Chad Krokosh]
• Fix Windows UI zoom in/out [Erico Monteiro]

Version 1.8, Thu 30 Jan 2025

• Fix mouse virtual joystick on resize in SDL builds [Richard Kelly]
• New manual and automatic configuration saving from GUI
• Manage HD mounting from drive control dialog
• New MCX128 cartridge support for MC-10
• Fix some of the compatibility modes in GIME emulation
• Assert monitor detect line on CoCo 3 when RGB output selected
• Reduce write latency using Becker port [Ron Klein]
• Add some more flexible command-line trap options

Version 1.6.5, Mon 23 Sep 2024

• SDL: fix use of physical joysticks after disconnecting [Pere Serrat]

Version 1.6.4, Fri 20 Sep 2024

• Fix Control+Shift+digit shortcuts
• Fix LUT-based composite rendering for CoCo 3 [Christian M]

Version 1.6.3, Thu 12 Sep 2024

Jet Set Willy (1984, Software Projects). Photo@Gamebase

•  Ensure data chunk in WAV output is of even length [Stacey Vetzal]

Version 1.6.2, Fri  6 Sep 2024

•  Add missing menus to Windows/Mac OS X+ UIs

Version 1.6.1, Thu  5 Sep 2024

•  Reinstate ROM image header skipping [Davy Mitchell]

Version 1.6, Thu  5 Sep 2024

• New -ram-org option to specify RAM addressing
• New -ram-init option to specify initial RAM state
• 6309 DIVD behaviour fixed against Tim Lindner's fuzzing tool
• 6309 DIVD timing fixed according to David Banks's behaviour notes
• 6309 DIVQ behaviour & timing adjusted similarly, though untested
• More accurate observed NTSC CoCo 3 GIME composite video behaviour
• New GTK+ 3 UI
• New printer control dialog (GTK+ 3, Windows) or menu options (Mac OS X+)
• Update CoCo 3 video timings
• SDL: open joysticks in controller mode if possible
• New unified keyboard abstraction
• Extra default keyboard-based virtual joystick profiles: WASD, IJKL, QAOP
• Dynamically include configs for all physical joysticks on startup
• New machine Dragon Professional (Alpha), 'dragonpro'
• New machine Tandy Deluxe Colour Computer, 'deluxecoco'

Version 1.5.5, Sun 24 Mar 2024

•  Allow SDL to use WASAPI audio (bug fixed in SDL 2.29.3)
•  Use queued audio interface in SDL for all platforms

Version 1.5.4, Mon 26 Feb 2024

•  Fixed 6309 register-memory bit ops [R. Allen Murphy]

Version 1.5.3, Tue  6 Feb 2024

•  GIME: fix interrupt fixes fix (fixes RoboCop)

Version 1.5.2, Mon 29 Jan 2024

•  GIME: timer interrupt fixes [Tim Lindner]

Version 1.5.1, Sat 27 Jan 2024

• Include a cartridge database (mostly CoCo 3 32K) for convenience
• Fix potential crash when cartridge loading fails [Russ Le Blang]
• Recognise Windows "<drive-letter>:" [Russ Le Blang]

Version 1.5, Thu 25 Jan 2024

• Add ability to change Picture Area, seeing more or less border
• New option -vo-picture
• Respect -geometry dimensions in SDL-based UIs
• Add optional 60Hz vertical scaling (on by default)
• New option -no-vo-scale-60hz disables 60Hz scaling
• Faster ROM intercept based printing on CoCo and MC-10
• GIME: respect X offset and HVEN in COCO mode
• MPI slot config moved from global to per-cart, included in -config-print
• Add screenshot to PNG from menu or Control+Shift+S
• Fix printing after switching machines [Jak Fearon]
• Better rendering of paths in Windows dialogs
• Fix some CoCo 3 cartridge behaviour [Christian Haitian]
• GIME: reset video address later (fixes Androne) ["EnsignRutherford"]
• GIME: fix various $FExx access problems

Version 1.4.2, Tue 16 Jun 2023

• Fix running with -ui null

Version 1.4.1, Tue  6 Jun 2023

•  Fix composite colour switching in -ccr simple and -ccr 5bit [Keith Palmer]

Version 1.4, Mon  5 Jun 2023

• NTSC colour tweaks for slightly better "cyan"
• Initial support for middle-button paste
• Add brightness, contrast, saturation & hue controls to GTK+ and Windows UIs
• Add gain/volume controls to GTK+ and Windows UIs
• New options: -vo-brightness, -vo-contrast, -vo-colour, -vo-hue
• New tape control & drive control windows in Windows UI
• GIME: implement bug in 16-colour, 16 byte-per-row modes
• New option -vo-pixel-fmt specifies pixel layout and bit depth
• Old NTSC-only composite renderer renamed -ccr partial
• New composite renderer that handles PAL used for -ccr simulated
• WD279x: write sync bytes before DAM (fixes written-to DMK) [Michael Furman]
• New option: -no-vo-colour-killer

Version 1.3.1, Tue 14 Feb 2023

• Further GIME VSC tweaks
• Allow preemption of Control key (for CoCo 3)
• Fix GTK+ zoom in/out
• Work around build issues on Apple Silicon [Allen Huffman, Blair Leduc]

Version 1.3, Wed  4 Jan 2023

Ice Castles (MicroDeal Ltd., 1984). Photo@Gamebase Dragon

• Add -no-ratelimit option to start at maximum speed
• Further fixes to 6809 TFR/EXG involving CC/DP [Tim Lindner]
• Fix Delta density select [Phill Harvey-Smith]
• Track floppy disk 'dirty' state to avoid unnecessary image rewrites
•  Important: disk write-back now defaults to ENABLED
•  Better Vertical SCroll register behaviour in GIME [Ralph Serpas]
•  6309 timing fix for bit operations

Version 1.2, Thu 27 Oct 2022

•  Fixed comma, lowercase 'm', lowercase 'ø' glyphs for GIME [Tim Lindner]
•  Fix SDL-only builds
•  6809: flesh out some illegal instruction behaviours [David Banks]
•  6309: flesh out some undocumented behaviour [David Banks]
•  Fleshed out T1-compatibility in CoCo 3 GIME [R. Allen Murphy]

Version 1.1, Thu 21 Jul 2022

• New GDB monitor commands [by Tormod Volden]
• New configure options to only build specific machine archs
• Support 1M or 2M in CoCo 3 [with Christopher Hawks]
• Support K7 cassette image files (read-only)
• Support UTF-8 block characters in -type for MC-10
• Type ASCII BASIC from file on MC-10
• Matra & Hachette Alice support (keyboard layout, built-in profile)
• New meta-options -machine-opt and -cart-opt
• New ide-addr=address cart-opt
• New abstract block device handling
• IDE support adjusted to use abstracted block devices
• MOOH/NX32 support adjusted to use abstracted block devices
• 6801/6803: fix some illegal instruction timings [George Phillips]
• Fixed uppercase 'G', lowercase 'j' and 'w' glyphs for 6847T1 [Tim Lindner]

Version 1.0.9, Tue 18 Jan 2022

Rommels Revenge (1986, Microdeal Cornwall)

• Close file after serialisation [Steve Rasmussen]

Version 1.0.8, Thu 13 Jan 2022

• Fix WASM audio for non-Firefox (Greg Dionne)
• Fix crash reading zero-length CAS file
• Fix joystick reads for Pacdude Monster Maze

Version 1.0.7, Sat 1 Jan 2022

• Fix Windows 11 video (set SDL hint to use different renderer)

Version 1.0.6, Fri 31 Dec 2021

• Fix SDL audio thread interactions
• Try multiple SDL video renderers in order
• Fix composite phase setting

Version 1.0.5, Thu 23 Dec 2021

Fruity (ImpSoft, 1983)

• Open IDE images in binary mode under Windows [by Tormod Volden]

Version 1.0.4, Sun 12 Dec 2021

• GIME IO range fixes [Roger Taylor]
• Enable GDB for CoCo 3 [Michael Furman]
• Fix HD6309 TFM when W=0 [Michael Furman, L. Curtis Boyle]

Version 1.0.3, Mon  6 Dec 2021

•  6801/6803: many more illegal instructions [Greg Dionne, Ron Klein]
•  Fix EXTMEM signalling for writes to RAM [Stewart Orchard]
•  MC10: Constrain video to internal 4K RAM [Simon Jonassen]
•  Default -ao-fragments changed for new SDL audio [Steve Bamford]
•  MPI: return to selected slot on reset ["dragonnostalgia", Tim Lindner]

Version 1.0.2, Tue 23 Nov 2021

•  Fix single-bit sound feedback into PIA.
•  Revert SDL audio to callbacks, helps with Windows ["sloopy malibu"]
•  Fix MC10 INT/EXT wiring [Jim Gerrie]
•  6801/6803: implement more illegal instructions [with Greg Dionne]
•  6803: Lower bits of address to data bus for floating reads [Greg Dionne]
•  MC10: Only set lower 6 bits on keyboard read [Greg Dionne]

Version 1.0.1, Sat 20 Nov 2021

• Fix cart disable logic when loading other media [".mad.", Stewart Orchard]
• MC6801/6803: TST resets CC.C, unlike MC6809.
• Revert colourburst for NTSC colour modes with CSS+GM0 [Allen Huffman]

Version 1.0, Tue 16 Nov 2021

• Initial CoCo 3 support.
• Fix MPI FIRQ handling [Paul Fiscarelli]
• New option -tv-input configures type of video used by machine.
• New option -kbd-bind for user mapping of (untranslated) keys.
• Fix duplicate-IDAM issue when reformatting disks [Paul Fiscarelli]
• Initial MC-10 support (including MC6803 emulation).
• Fix occasional spurious NMI in RSDOS [Simon Jonassen]
• New snapshot format to support CoCo 3, MC-10.
• New specific load options: -load-fdX, -load-hdX, -load-sd, -load-tape
• IDE, NX32, MOOH now all require user to specify an image.
• Games Master Cartridge no longer marked autostart by default.
• Tape play/pause function (mainly for MC-10 which has no motor remote).
• Snapshot saves only RAM contents into .ram files [Phill Harvey-Smith]
• List physical joysticks on -joy-axis help or -joy-button help.
• Control+M toggles menubar where appropriate.

Version 1.0, Tue 16 Nov 2021

• Initial CoCo 3 support.
• Fix MPI FIRQ handling [Paul Fiscarelli]
• New option -tv-input configures type of video used by machine.
• New option -kbd-bind for user mapping of (untranslated) keys.
• Fix duplicate-IDAM issue when reformatting disks [Paul Fiscarelli]
• Initial MC-10 support (including MC6803 emulation).
• Fix occasional spurious NMI in RSDOS [Simon Jonassen]
• New snapshot format to support CoCo 3, MC-10.
• New specific load options: -load-fdX, -load-hdX, -load-sd, -load-tape
• IDE, NX32, MOOH now all require user to specify an image.
• Games Master Cartridge no longer marked autostart by default.
• Tape play/pause function (mainly for MC-10 which has no motor remote).
• Snapshot saves only RAM contents into .ram files [Phill Harvey-Smith]
• List physical joysticks on -joy-axis help or -joy-button help.
• Control+M toggles menubar where appropriate.

Version 0.37, Sat 14 Aug 2021

• Add Control+Shift+D to flush disk images
• Support leading "~/" in filenames, not just path elements
• New option -tape-hysteresis (with new default of 1% tape input hysteresis)
• New option -tape-rewrite-gap-ms _ms_ sets gap length during rewrite
• New option -tape-rewrite-leader _bytes_ sets leader length during rewrite
• Document previously added option -tape-pan
• Detect pulse widths for CUE data when using -tape-rewrite
• RACE Computer Expansion Cage support (-cart mpi-race)
• Removed -fast-sound option (and related menu options)

Version 0.36.2, Wed 22 Jul 2020

• Fix -lp-file option [Pere Serrat]
• Change default CoCo disk interleave to 5 [Simon Jonassen]

Version 0.37.1, Thu Aug 26 2021

• Fix MPI FIRQ handling [Paul Fiscarelli]

Version 0.37, Sat Aug 14 2021

• Add Control+Shift+D to flush disk images
• Support leading "~/" in filenames, not just path elements
• New option -tape-hysteresis (with new default of 1% tape input hysteresis)
• New option -tape-rewrite-gap-ms _ms_ sets gap length during rewrite
• New option -tape-rewrite-leader _bytes_ sets leader length during rewrite
• Document previously added option -tape-pan
• Detect pulse widths for CUE data when using -tape-rewrite
• RACE Computer Expansion Cage support (-cart mpi-race)
• Removed -fast-sound option (and related menu options)

Version 0.36.2, Wed Jul 22 2020

• Fix -lp-file option [Pere Serrat]
• Change default CoCo disk interleave to 5 [Simon Jonassen]

Version 0.36.1, Thu Jun 18 2020

• Support CAS padding without fast loading enabled
• Don't escape option arguments if they expect a filename [".mad."]
• Fix setting 6309 registers from GDB
• Fix GDB listen on machine reconfigure (eg snapshot load) [Pere Serrat]
• Fix joystick axis & button option parsing [David Ladd]

Version 0.36, Mon Jun 8 2020

• Fix SAM S output in map type 1 [Pere Serrat]
• Work around Windows audio failure when 5.1 is available [Gerald Stefan]
• Cleaner PulseAudio output
• Try harder to find working SDL2 audio format
• Avoid buggy 'wasapi' SDL audio backend under Windows
• HD6309: Clear MD register on reset [Pere Serrat]
• Relicensed to GPLv3+
• WebAssembly target support
• MC6809: LEA instructions work in page 1 [Stewart Orchard]
• Recognise .dgn and .cco as potential binary files
• Migrated Mac OS X UI to SDL2
• Updates for IDE and IDE cartridge [by Alan Cox]
• SAM VDG counter switching behaviour updates [with Stewart Orchard]
• Reload cartridge ROMs on each reset to aid test cycle [Steve Bamford]
• Try first listed UI module if user-specified one not found
• New configuration parsing with quotes and escape sequences
• In Windows, search Documents/XRoar/ (for config file) and
• Documents/XRoar/roms/ (for ROM images).

Fixes in version 0.35.2

Dancing Devil (1982,Tom Mix Software)

• Work around Windows audio failure when 5.1 is available [Gerald Stefan]
• Include PDF in source tarball

Fixes in version 0.35.1

• Fix SAM S output in map type 1 [Pere Serrat]

Notes for version 0.35

• New NX32 RAM cartridge [by Tormod Volden]
• New option -ao-gain specifies volume in dBFS
• New CAS CUE support
• New -C option allocates debug console in Windows (must be first option)
• New MOOH RAM + SD card cartridge [by Tormod Volden]
• Support JVC/DSK files with non-standard sectors per track
• MC6809: Assume certain page2 illegal ops are same as page0 [David Ladd]
• WD279x: implement multiple-sector type 2 ops
• New SN76489 sound chip support
• New Games Master Cartridge support (-cart gmc)
• Use SDL2 audio queueing interface where -ao-fragments > 1
• Optional --disable-simulated-ntsc configure option for speed (e.g., for Raspberry Pi)
• HD6309: Fix interrupt handling during TFM instruction [David Ladd]

Version 0.34, Sun Aug  7 2016

• Zoom controls fixed or added where missing
• Dragon 200-E "CLS 9" alternate text mode fixed
• Control+C to quit removed from SDL UI (use Control+Q as per the docs)
• SDL2 support
•  -vo help lists video modules by UI
• Large structural changes to support more machine types
• Pixel rate doubled anticipating more machine types (could be slower)
• NTSC filtering renderer: -ccr simulated (note: slower than 5bit)
• Add cross-colour rendering menu to GUI
• PAL-M magenta-green artifacting supported with -ccr simulated
• Fix treatment of empty drives in DOS carts
• Initial IDE code [by Alan Cox]
   

Notes for version 0.34.2 2016-08-19

• Worked around initialisation bug in GCC 4
• Worked around accept() and recv() seemingly not being cancellation points in MinGW pthreads (XRoar failed to shut down if GDB was attached)

Notes for version 0.34

• SDL2 support
• NTSC filtering renderer: -ccr simulated (note: slower than 5bit)
• Add cross-colour rendering menu to GUI
• PAL-M magenta-green artifacting supported with -ccr simulated
• Initial IDE code [Alan Cox]

Version 0.34, Sun Aug 7 2016

• Zoom controls fixed or added where missing
• Dragon 200-E "CLS 9" alternate text mode fixed
• Control+C to quit removed from SDL UI (use Control+Q as per the docs)
• SDL2 support
• -vo help lists video modules by UI
• Large structural changes to support more machine types
• Pixel rate doubled anticipating more machine types (could be slower)
• NTSC filtering renderer: -ccr simulated (note: slower than 5bit)
• Add cross-colour rendering menu to GUI
• PAL-M magenta-green artifacting supported with -ccr simulated
• Fix treatment of empty drives in DOS carts
• Initial IDE code [Alan Cox]

Version 0.33, Fri May 22 2015

• Capped mouse polling frequency (could cause high CPU load).
• Slight SAM timing tweak.
• Fix builtin machine "coco2bus" to use 6847T1.
• Tape rewriting now emits sine waves instead of square waves.
• New option -tape-ao-rate _hz_ specifies output samplerate for wav files.
• New option -timeout-motoroff _s_ quits _s_ seconds after tape motor off.
• New option -snap-motoroff _file_ creates snapshots on tape motor off.
• New option -tape-channel-mode _mode_ specifies how to read stereo audio
• files: mix, left or right.
• New option -config-print-all prints even default values.
• Fix PIA address decode for Dragon 32, Dragon 64.
• Timing fixes in fast tape loading.
• Recognise key shortcuts in GTK+ tape/drive control dialogues.
• Unverified fix for hang in Windows using SDL audio.
• IRQ timing tweaked, passes Stewart Orchard's PAL timing test v1.2.
• Special-case autorun instructions for some tape programs.
• Building from source now uses GNU build system (autotools).
• Fix Windows menu selection event drops.
• Warn about unrecognised BASIC ROM CRCs.
• MPI support.
• Add 'eject' option to disk menus on Windows/Mac OS.
• Assume single density JVC/DSK where sectors = 10. Disable with
• -no-disk-auto-sd.
• Fix hook-based printing on switching machines.
• Fix GTK+ tape dialog when attached from command line.
• Fix Dragon PAL padding. Passes Stewart Orchard's PAL tests v1.3.
• Work around breakpoint re-add bug.

Fruity Machine (GameBase)

Notes for version 0.33

• Building from source now uses GNU build system (autotools).
• Various timing fixes.
• New option -tape-ao-rate hz specifies output samplerate for wav files.
• New option -timeout-motoroff s quits s seconds after tape motor off.
• New option -snap-motoroff file creates snapshots on tape motor off.
• New option -tape-channel-mode mode specifies how to read stereo audio files: mix, left or right.
• New option -config-print-all prints even default values.
• Better defaults for Windows use of SDL audio.
• Special-case autorun instructions for some tape programs.
• Fix Windows menu selection event drops.
• Basic MPI support.
• Assume single density JVC/DSK where sectors = 10. Disable with -no-disk-auto-sd.
• Fix hook-based printing on switching machines.

Version 0.32, Tue Apr 22 2014

• Fix keyboard handling - CoCo Tetris now playable again.
• SDL, CoreAudio: allow -ao-fragments more than 1.
• Binary file loading no longer assumes 64K RAM organisation.
• Warn about use of deprecated options.
• Add joystick menus to GTK+ interface.
• New option -ao-format to select audio sample format.
• Fix 6309 timing issue (CMPU, CMPS).
• Fix issue with 6309 STBT instruction.
• Use endian.h where available.
• Preserve extra VDK header information in rewritten images.
• New Windows UI adding menus to the SDL window.
• Detect headerless JVC image geometry from OS-9 filesystem information.
• New option -no-disk-auto-os9 disables automatic geometry detection.
• Recognise ".os9" as extension for JVC images, ignores -no-disk-auto-os9.
• Deprecated option -disk-jvc-hack (now ignored in favour of above). 

Notes for version 0.31.1

• Fix potential deadlocks in new SDL and CoreAudio code.