Skip to content

v3.6.1

Choose a tag to compare

@github-actions github-actions released this 05 Sep 12:38
· 122 commits to master since this release
f9a3c89

Virtual Jaguar libretro v3.6.1

A patch release for one thing: booting the core with no content now lands you
in the CD BIOS, which is the screen you insert a disc from.

v3.6.0 shipped no-content boot (#646) and the disk-control interface (#651) so
you could launch the core bare, put in a disc, and reach the Virtual Light
Machine with an audio CD. That combination did not work. This fixes it.


The fix

No-content boot resolved to a bare console: the boot ROM running against a
zeroed cartridge window. That is authentic for a Jaguar with no CD unit
attached — and it is a dead end. The CD BIOS is what offers "insert a disc",
and it is mapped as a cartridge at $800000, so nothing reachable from the
empty-slot screen could ever get to it. The headline feature of v3.6.0 was
unreachable by construction.

Starting with no content now boots the real CD BIOS, which comes up on its
own insert-disc screen. No files are required: an external CD BIOS ROM in your
system directory is preferred if you have one, and otherwise an embedded image
is used.

Two smaller consequences of the same path, fixed alongside:

  • It reported cartridge mode rather than CD mode with an empty tray, which
    inverted the options menu against a machine sitting in the CD BIOS — CD Boot
    Mode and CD BIOS Type were hidden, and the cartridge-BIOS option was shown.
  • The Memory Track cart plugs into the CD unit and is present whether or not
    a disc is, but it stayed absent until the first insert.

supports_no_game was never advertised

dist/info still said supports_no_game = "false" after
RETRO_ENVIRONMENT_SET_SUPPORT_NO_GAME shipped in v3.6.0. RetroArch reads the
info database, not the runtime environment call, to decide whether to offer
a contentless launch — so frontends were never told the core supports it. Now
"true".

If your frontend does not offer "Start Core" without content, its info file is
out of date; update it from the libretro info repository.

Why the tests did not catch this

Two tests asserted which boot strategy resolved and never checked what the
machine did with it, so a correctly-resolved dead end passed cleanly. Both now
pin the corrected behaviour.

One of them is worth noting for anyone reading the diff: test_disk_control
case 1 compared strategy names either side of a disc insert. With no-content now
resolving to "bios" — and a real-BIOS disc also resolving to "bios" — that
comparison would have gone vacuous, passing while asserting nothing. It now
pairs the strategy name with isCDGame, which is what actually moves: false for
the bare BIOS on its insert screen, true once a disc is mounted.


Upgrading

Nothing to do beyond installing the core. Savestates, per-title defaults, hooks
and cheats are unchanged from v3.6.0.

If you reported the v3.6.0 no-content boot as broken, check which core you
have installed.
The original report for #726 was made against a v3.5.1 core —
a version that predates the feature entirely — which is worth ruling out before
anything else.

Known limitations

Unchanged from v3.6.0:

  • Inserting a disc restarts the console. A continuous swap depends on CD BIOS
    disc-presence polling that has not been verified.
  • The enhancement profile governs internal_resolution and true_color only.
  • docs/WHATSNEW has no sections for v3.1.0 through v3.5.1; the per-release
    notes in docs/RELEASE_NOTES_v*.md are authoritative for those.

Artifacts in this release

SHA256SUMS.txt
cue2cdi-linux-x86_64
cue2cdi-macos-universal
cue2cdi-windows-x86_64.exe
jagcd-tools-linux-x64.zip
jagcd-tools-macos.zip
jagcd-tools-windows-x64.zip
virtualjaguar_libretro-android-arm64-v8a-debug.tar.gz
virtualjaguar_libretro-android-arm64-v8a.so
virtualjaguar_libretro-android-armeabi-v7a-debug.tar.gz
virtualjaguar_libretro-android-armeabi-v7a.so
virtualjaguar_libretro-android-x86-debug.tar.gz
virtualjaguar_libretro-android-x86.so
virtualjaguar_libretro-android-x86_64-debug.tar.gz
virtualjaguar_libretro-android-x86_64.so
virtualjaguar_libretro-emscripten-wasm-debug.tar.gz
virtualjaguar_libretro-emscripten-wasm.bc
virtualjaguar_libretro-ios-arm64-debug.tar.gz
virtualjaguar_libretro-ios-arm64.dylib
virtualjaguar_libretro-linux-aarch64-debug.tar.gz
virtualjaguar_libretro-linux-aarch64.so
virtualjaguar_libretro-linux-i686-debug.tar.gz
virtualjaguar_libretro-linux-i686.so
virtualjaguar_libretro-linux-rpi1-armv6-debug.tar.gz
virtualjaguar_libretro-linux-rpi1-armv6.so
virtualjaguar_libretro-linux-rpi2-cortex-a7-debug.tar.gz
virtualjaguar_libretro-linux-rpi2-cortex-a7.so
virtualjaguar_libretro-linux-rpi3-cortex-a53-debug.tar.gz
virtualjaguar_libretro-linux-rpi3-cortex-a53.so
virtualjaguar_libretro-linux-rpi3_64-cortex-a53-debug.tar.gz
virtualjaguar_libretro-linux-rpi3_64-cortex-a53.so
virtualjaguar_libretro-linux-rpi4-cortex-a72-debug.tar.gz
virtualjaguar_libretro-linux-rpi4-cortex-a72.so
virtualjaguar_libretro-linux-rpi4_64-cortex-a72-debug.tar.gz
virtualjaguar_libretro-linux-rpi4_64-cortex-a72.so
virtualjaguar_libretro-linux-rpi5-cortex-a76-debug.tar.gz
virtualjaguar_libretro-linux-rpi5-cortex-a76.so
virtualjaguar_libretro-linux-rpi5_64-cortex-a76-debug.tar.gz
virtualjaguar_libretro-linux-rpi5_64-cortex-a76.so
virtualjaguar_libretro-linux-x86_64-debug.tar.gz
virtualjaguar_libretro-linux-x86_64.so
virtualjaguar_libretro-macos-arm64-debug.tar.gz
virtualjaguar_libretro-macos-arm64.dylib
virtualjaguar_libretro-macos-x86_64-debug.tar.gz
virtualjaguar_libretro-macos-x86_64.dylib
virtualjaguar_libretro-switch-debug.tar.gz
virtualjaguar_libretro-switch.a
virtualjaguar_libretro-tvos-arm64-debug.tar.gz
virtualjaguar_libretro-tvos-arm64.dylib
virtualjaguar_libretro-vita-debug.tar.gz
virtualjaguar_libretro-vita.a
virtualjaguar_libretro-windows-i686-debug.tar.gz
virtualjaguar_libretro-windows-i686.dll
virtualjaguar_libretro-windows-x86_64-debug.tar.gz
virtualjaguar_libretro-windows-x86_64.dll
virtualjaguar_libretro.info

SHA-256 checksums

Verify with sha256sum --check SHA256SUMS.txt (Linux) or
shasum -a 256 --check SHA256SUMS.txt (macOS).
See SECURITY.md
for full verification instructions and antivirus false-positive guidance.

b926e41185057ee9204aaa0aaafff53ceec2cbb6d4f37e478edf7a7ddb353332  cue2cdi-linux-x86_64
c19f65c1be0eab40e58f0a4d619704dcfc4632858d00eef78a737d0f26e7a134  cue2cdi-macos-universal
756017ac959e94bffbe83a13fd7bb9d63fe63a7c9f91cdeaec7a23c46ca5fd18  cue2cdi-windows-x86_64.exe
57ef68d76aef118229e9431dbc21ddb5bc418ecb933b174a0ab7235e7d9d6398  jagcd-tools-linux-x64.zip
2039b1c054d65c36a21c2f1735297330729f9e89bbfa4c408457cf500d688d8e  jagcd-tools-macos.zip
c5da6c0c1407ac490768b506facc00fc9676b2b31e6e6af8e52334c784bc82bb  jagcd-tools-windows-x64.zip
4d572ead8bb31a9b76f4661427cee8ab7b4da835af6baa9c6d9577573deee654  virtualjaguar_libretro-android-arm64-v8a-debug.tar.gz
90ff9c15f83967fe45cabf7638b3d9267f39755350631f4a2f2f9e7698fb3944  virtualjaguar_libretro-android-arm64-v8a.so
190f3b5842719bf14b405a16ccad2c248ca443d254b13b29d27ad5f3b53f9efb  virtualjaguar_libretro-android-armeabi-v7a-debug.tar.gz
7666cbd8e28f097e674a389d049bbc6452bfa41be394c4370b890fedf2e30411  virtualjaguar_libretro-android-armeabi-v7a.so
b69e1e9577ee0683149d031dd4e3c8ebfbc3cdf9cab16655435c6d783f69808c  virtualjaguar_libretro-android-x86-debug.tar.gz
43040a460159a478fd6ff2faf9ea662fc188dda17609d0eafd1bc877e5453e40  virtualjaguar_libretro-android-x86.so
8f995efbde7a451e3acc23e6d2fce6f551adb5bf3560c4dc1daaa1dddfd683f4  virtualjaguar_libretro-android-x86_64-debug.tar.gz
82bca129c4e378d666c705147c421802c652f20a0c8e3a9d6f6b44ba1f776229  virtualjaguar_libretro-android-x86_64.so
a113609a0ba31cd95b51a5909003cfa187b5e7a35d375bee964efabe399d4653  virtualjaguar_libretro-emscripten-wasm-debug.tar.gz
fad419073dd27f6d65ec47fb8cb49765464a1bd1007d8bcde3f5cdd2442eb4f5  virtualjaguar_libretro-emscripten-wasm.bc
9f2785e46f435fbbce215b7c291a14150a2d4f67db15e804a07ad87827cd4c58  virtualjaguar_libretro-ios-arm64-debug.tar.gz
f0b01fb0339c7398f871d0b3a1a0df9a3b588dd3c21c090b0e3540ff2b6d0f2b  virtualjaguar_libretro-ios-arm64.dylib
40e0566423a56be6d1e8a33deb2d4237a9113c609f0f6537cc566e6a27d11313  virtualjaguar_libretro-linux-aarch64-debug.tar.gz
310fbedf906c30c74db4088cee8db8f0272d6eaa818d69b1a005c5b236b226c1  virtualjaguar_libretro-linux-aarch64.so
cd6b75519a37f63ea99a2258280515a14417ba7322391ce44c30aa22eac697cc  virtualjaguar_libretro-linux-i686-debug.tar.gz
65bb9062d773f4446fd4d9735f063379da326f585c5b1a69df3a1f1ce44a406e  virtualjaguar_libretro-linux-i686.so
5aba045416cf8aa3a5398bb0f725691d65f7b07704ba074639370a15ad4d6b07  virtualjaguar_libretro-linux-rpi1-armv6-debug.tar.gz
d39a044d1f691e164f79c5919c1b26b01204fc207622b4f92da1f6e2ae2b5f23  virtualjaguar_libretro-linux-rpi1-armv6.so
6fc084f8b1624118806993ee37e8508d7f3e582513962dd13713e72157f4e9cb  virtualjaguar_libretro-linux-rpi2-cortex-a7-debug.tar.gz
ad2053a8a6a46399cb9b0e5556c17a7b4d4263ff49ec48a63e5331825e153967  virtualjaguar_libretro-linux-rpi2-cortex-a7.so
a2633931a42731f297c695ddcc1001c53aa223d30609a23469d419503fe9ec7e  virtualjaguar_libretro-linux-rpi3-cortex-a53-debug.tar.gz
0039324891277efc426609bc62635e2b7923ea522b15c613c4e1a4450c64cbe0  virtualjaguar_libretro-linux-rpi3-cortex-a53.so
993d6841595155c3314196b99f8ae0cbe99df74e13a77a751114f60c66e83747  virtualjaguar_libretro-linux-rpi3_64-cortex-a53-debug.tar.gz
c6cffea08ce84a26f0093ff419c4a84552960bdeb0a8a8cab5a79b3edc23f887  virtualjaguar_libretro-linux-rpi3_64-cortex-a53.so
8f2f104e7120ac1a48c66dc2f8354fadfea38fdd583a355664207bd140d973ae  virtualjaguar_libretro-linux-rpi4-cortex-a72-debug.tar.gz
d29160705581946e3bee0ad33f34cb45c6c25f48dd860e36d39b4ec048ec6cdf  virtualjaguar_libretro-linux-rpi4-cortex-a72.so
13ed6f0d3d9566abc31b4f6b00693fe0f75f00abf242c15243d9d1d4ec1e39fc  virtualjaguar_libretro-linux-rpi4_64-cortex-a72-debug.tar.gz
75829d79a8cfa0a969f0bbeebb064eebd3f607e38bb3c616c2e9cc6052a3f193  virtualjaguar_libretro-linux-rpi4_64-cortex-a72.so
1a4d8fa135600a6dab4408ffec7a3a310308816b12fa20a20bbe0ecc2ad63814  virtualjaguar_libretro-linux-rpi5-cortex-a76-debug.tar.gz
d5697ff1269101b177207b3026bbd670960355e4f35e471586aeb34dc0a2061e  virtualjaguar_libretro-linux-rpi5-cortex-a76.so
6642a4bbfaa6fe972f3e827c80b32f1357438206704e65599e5d270e36579fa0  virtualjaguar_libretro-linux-rpi5_64-cortex-a76-debug.tar.gz
a8c07c3baaa971622905924da64691af3aade0d15dd6d4ee5823ba5a16a645ec  virtualjaguar_libretro-linux-rpi5_64-cortex-a76.so
f56d87fd4c597646a187a3eec514f496ecd20bb99a9a4e81f6cccf4cafc8d3dc  virtualjaguar_libretro-linux-x86_64-debug.tar.gz
e036c27bb2593a6dfe3aec4de095fe5e16a364cb190f5b3c5c743041f4f7c535  virtualjaguar_libretro-linux-x86_64.so
56958de7ea626c872cd3c3ad3e8ceaa19028700404cc80fdfadfa1a96c3f639d  virtualjaguar_libretro-macos-arm64-debug.tar.gz
ffa7e90fffaf27b9a5f2725276be0e780bcbec20d2eabd42b1a92b89550b6b37  virtualjaguar_libretro-macos-arm64.dylib
beeb2275d01ba04638ee2eee697cae936be56a770abe5a96e414fb57e8fcb580  virtualjaguar_libretro-macos-x86_64-debug.tar.gz
322ebb4550000e389e03cb42e0f597edaa6e182f6dcb4b3fa5c04bc31f5686b3  virtualjaguar_libretro-macos-x86_64.dylib
725b7674f5044ee5ecf54543ac78368892343935181937917c8bbc4e1ff3bd0f  virtualjaguar_libretro-switch-debug.tar.gz
b9c9245b500bdfa6e8c6e5d68924819b2b9940c50a2906ad967873a1b678aad6  virtualjaguar_libretro-switch.a
effe6e56576f1e6ed8bd290b59b22b61c3ae7330f83932e0230a9ef9f2134e83  virtualjaguar_libretro-tvos-arm64-debug.tar.gz
7678b7b0d015ebf8f573d9d273b39097d1f1810cddcc88bdd94024a79d77927a  virtualjaguar_libretro-tvos-arm64.dylib
4a3e58d308c0725f1f85996e2a6686bb4e3c9e20355d8ba5ab7fa6d14789102a  virtualjaguar_libretro-vita-debug.tar.gz
6b43cc4cfb5f9fb4b3bd9420f10f72e0bad00856dcf5a8c54e17e683d18ec855  virtualjaguar_libretro-vita.a
8b57f135c1bc83344daff4deb3fbeaf353f2a87e53c2a3efc64d2eb6d8a814f7  virtualjaguar_libretro-windows-i686-debug.tar.gz
4a24176b482b602c3dbb61426e9046de027765ae6b80ed2de5a7ecc25a21dab8  virtualjaguar_libretro-windows-i686.dll
0acadff218beea9f50b9c77d7e4cf1f909ce3e1f2489b6b35225d7c4cc41ebd4  virtualjaguar_libretro-windows-x86_64-debug.tar.gz
762873a87fd3a3f22bf3d532b0f6e81d598d09298533fc4bf1de23a36f0e73f1  virtualjaguar_libretro-windows-x86_64.dll
c6338c31a4d72706a110e89a94686254a08718479735ad5df156059a1144500a  virtualjaguar_libretro.info