Skip to content

Releases

1.5.0 Integration

Choose a tag to compare

@Warksmith Warksmith released this 15 Nov 22:22

Thank you @bbsan2k for all your hard work.

OK! This release brings our custom firmware onto upstream's 1.5.0 features, while retaining our previous work on:

  • Folder-backed memory cards
  • Game2Folder extensions, and
  • USB startup shortcut (while adopting upstream’s updated backend and USB storage implementation.)

Compared with our previous 1.4-based release:

  • Folder cards carry forward, including optional snapshot caching and automatic folder-card creation.
  • Game2Folder retains prefix wildcards and an optional default card, alongside the fix for configuration files without a trailing newline.
  • USB storage now uses upstream’s implementation, with:
    • our "Button 1 startup shortcut" added,
    • batched transfers and clearer connection/eject status. (Always eject through the computer’s OS before disconnecting)
  • Folder-card handoff is improved: IGR proceeds once the selected virtual card can handle reads, while background loading continues.
  • USB initialization no longer enables an unintended blocking UART, addressing a defect found while investigating IGR failures during the port. (More testing here required)

v0.3 - GameID Defaults & Wildcards

Choose a tag to compare

@Warksmith Warksmith released this 03 Nov 03:07

Added wildcard matching and an optional default card to Game2Folder.ini.

Within .sd2psx/Game2Folder.ini you can define the use of Default cards and/or Wildcard matches.

If you want to define only a few GameID groups, but have all other games just use a single card, you can set UseDefaultCard=ON and define a card with DefaultCard=Shared. (if you dont define UseDefaultCard it defaults to OFF)

[PS2]
UseDefaultCard=ON
DefaultCard=Shared

If you want to define broad wildcards, such as "all Japanese games", you can use wildcards with the * character. (Exact IDs take priority over wildcards, regardless of order. Longest matching prefix wins. For equally specific matches, the last entry wins.)

[PS2]
SLUS-*=USGames
SLUS-123**=Series123
SLUS-12345=Dedicated

*Note: Remember to always leave an extra newline at the bottom of the ini file

These features have not been extensively tested on hardware yet, and saves that have not reached the SD card are lost in a power cut. See doc/folder-cards.md before using it and always back up your saves.

v0.2 - Folder-Backed Memory Cards (and USB Storage Mode)

Choose a tag to compare

@Warksmith Warksmith released this 01 Nov 00:52

Folder-Backed Memory Cards and USB Storage Mode

Applies to: sd2psx.uf2 (sd2psx and PSXMemCard Gen2)

Folder-backed PS2 memory cards (experimental)

An 8 MB PS2 card can now keep its saves as ordinary files in a folder on the SD card instead of a single .mcd image. The console sees a normal card, and changes are written back to the files in the background.

  • Enable it per card by adding this to the section of an individual card's ini file.
[Settings]
StorageBackend=FOLDER

  • Add FolderSnapshot=ON to keep an 8 MB copy on the SD card, so the card is available immediately when nothing has changed. This is the better-tested option for boot cards.
  • Set the following within .sd2psx/settings.ini to create new cards as folder cards, including those Game ID creates.
[PS2]
NewCardBackend=FOLDER

[!!!] This is experimental. Saves that have not reached the SD card are lost in a power cut, and multi-version FreeMcBoot installs do not work on folder cards. Back up your saves, and read doc/folder-cards.md before using it.

USB storage mode

Hold Button 1 while connecting USB, with the device out of the console, and the microSD card appears on your computer as a removable drive. Eject it before unplugging, then reconnect to return to normal startup. Memory card emulation does not run in this mode, and speeds are under 1 MB/s, so use a card reader for ISOs and other large files.

Changed: firmware update mode now starts from Button 2 only (it used to be either button). If both are held, Button 2 wins. The BOOTSEL button on the board works as before.

Hotfixes

  • fixed USB safe to disconnect
  • changed device name in windows, was previously a test value

Experimental - USB mass storage mode

Choose a tag to compare

@Warksmith Warksmith released this 01 Nov 00:50

USB Storage Mode

Applies to: pmc+.uf2, pmczero.uf2, psxmemcard.uf2, & sd2psxlite.uf2 only

Your microSD card can now appear on your computer as a removable drive, with no card reader needed.

How to use it

  1. Take the device out of the console.
  2. Hold Button 1 while connecting the USB cable.
  3. Use the drive as normal, and eject it on your computer before unplugging.
  4. Unplug and reconnect to return to normal startup.

Good to know

  • Memory card emulation does not run in this mode.
  • Speeds are under 1 MB/s, which suits saves and settings. Use a card reader for ISOs and other large files.
  • Changed: firmware update mode now starts from Button 2 only (it used to be either button). If both are held, Button 2 wins. The BOOTSEL button on the board works as before.

These devices do not have PSRAM, so they do not support folder-backed memory cards.

[!!!] These builds compile, but have not been tested on hardware. Back up your SD card first.