Sparkle loader support

Most productions from CSDb crediting Sparta for the loader have been tested and work. See the table at the end of doc/sparkle.txt for details.
thierer · Aug 31, 2023 · ff2603f · ff2603f
1 parent bc56ffa
commit ff2603f
Show file tree

Hide file tree

Showing 16 changed files with 1,195 additions and 7 deletions.
diff --git a/NEWS b/NEWS
@@ -20,7 +20,7 @@
         - New fastloader: Hypra-Load
         - create D64 images in the FAT FS with N: if no image is mounted
         - Krill's IRQ loader
-        - Demo loaders: Bitfire, BoozeLoader, Spindle
+        - Demo loaders: Bitfire, BoozeLoader, Sparkle, Spindle
 
 2012-02-26 - release 0.10.3
         - Bugfix: Un-break I2C display communication

diff --git a/README b/README
@@ -776,17 +776,26 @@ Note: Using sd2iec without an external crystal or similiar precise
   loader were tested. Other productions might use configuration
   options which are not supported and therefore might not work.
 
-  Demo loaders: Bitfire, BoozeLoader, Spindle
-  -------------------------------------------
+  Demo loaders: Bitfire, BoozeLoader, Sparkle, Spindle
+  ----------------------------------------------------
 
   All these loaders use sector addressing and non-standard directories
   and therefore only work from the original D64 images, not from the
   FAT filesytem.
 
+  The Highscore-Saver available in Sparkle >= 2.0 is supported.
+
   Like Krill's Loader, Bitfire >= 1.0 and Spindle >= 3.0 include an
   ATN responder which activates "Sleep Mode" in a sd2iec present on
   the bus as a passive device.
 
+  The loaders are captive, but often support some form of command to
+  make the loader's job loop exit at the end of the demo (but not all
+  productions actually issue them). That said, host reset detection
+  works rather well in practice. Spindle 2.1 and Bitfire 0.1 are
+  slightly subpar in this regard, but even with these a second reset
+  will normally do.
+
   With a few exceptions, only productions released on CSDb which
   credit the respective author for the loader were tested. Others
   might not work. For a list of known productions using these loaders

diff --git a/configs/config-arm2iec1 b/configs/config-arm2iec1
@@ -76,3 +76,4 @@ CONFIG_LOADER_KRILL=n
 CONFIG_LOADER_BOOZE=n
 CONFIG_LOADER_SPINDLE=n
 CONFIG_LOADER_BITFIRE=n
+CONFIG_LOADER_SPARKLE=n
diff --git a/configs/config-example b/configs/config-example
@@ -135,6 +135,9 @@ CONFIG_LOADER_SPINDLE=n
 # Enable Bitfire loader
 CONFIG_LOADER_BITFIRE=n
 
+# Enable Sparkle loader
+CONFIG_LOADER_SPARKLE=n
+
 # Enable DolphinDOS parallel speeder
 CONFIG_PARALLEL_DOLPHIN=y
 

diff --git a/configs/config-larsp b/configs/config-larsp
@@ -72,3 +72,4 @@ CONFIG_LOADER_KRILL=y
 CONFIG_LOADER_BOOZE=y
 CONFIG_LOADER_SPINDLE=y
 CONFIG_LOADER_BITFIRE=y
+CONFIG_LOADER_SPARKLE=y
diff --git a/configs/config-mbed b/configs/config-mbed
@@ -52,6 +52,7 @@ CONFIG_LOADER_KRILL=n
 CONFIG_LOADER_BOOZE=n
 CONFIG_LOADER_SPINDLE=n
 CONFIG_LOADER_BITFIRE=n
+CONFIG_LOADER_SPARKLE=n
 CONFIG_HARDWARE_VARIANT=100
 CONFIG_HARDWARE_NAME=sd2iec-mbed
 CONFIG_SD_AUTO_RETRIES=10

diff --git a/configs/config-sw1 b/configs/config-sw1
@@ -70,3 +70,4 @@ CONFIG_LOADER_KRILL=y
 CONFIG_LOADER_BOOZE=y
 CONFIG_LOADER_SPINDLE=y
 CONFIG_LOADER_BITFIRE=y
+CONFIG_LOADER_SPARKLE=y
diff --git a/configs/config-sw2 b/configs/config-sw2
@@ -72,3 +72,4 @@ CONFIG_LOADER_KRILL=y
 CONFIG_LOADER_BOOZE=y
 CONFIG_LOADER_SPINDLE=y
 CONFIG_LOADER_BITFIRE=y
+CONFIG_LOADER_SPARKLE=y
diff --git a/configs/config-uIEC b/configs/config-uIEC
@@ -74,3 +74,4 @@ CONFIG_LOADER_KRILL=y
 CONFIG_LOADER_BOOZE=y
 CONFIG_LOADER_SPINDLE=y
 CONFIG_LOADER_BITFIRE=y
+CONFIG_LOADER_SPARKLE=y
diff --git a/configs/config-uIEC3 b/configs/config-uIEC3
@@ -72,3 +72,4 @@ CONFIG_LOADER_KRILL=y
 CONFIG_LOADER_BOOZE=y
 CONFIG_LOADER_SPINDLE=y
 CONFIG_LOADER_BITFIRE=y
+CONFIG_LOADER_SPARKLE=y