Installation - schmurtzm/test GitHub Wiki

banner CrossMix

 

bar

Remarks about the required firmware

CrossMix-OS doesn't require any firmware update before installation: it will guide you to update it if required, just let yourself be guided on the first boot.

CrossMix-OS use the firmware 1.0.4 hotfix 6 (20240413) by default (no need to update it before your CrossMix installation), hotfix 9 is also supported but boot logo change is disabled.

To make a fresh install

Format your SD card in FAT32. (⚠ use a genuine, name-brand SD card and not the stock one sold with your console)

Prepare your SD card to receive CrossMix-OS:

bar

Formatting an SD card in FAT 32

Windows

  1. Use fat32format
  2. Set options
    • Drive
      The drive letter of your SD card
    • Allocation unit size
      Card capacity Allocation unit size
      < 128 GB 512
      < 256 GB 1024
      < 512 GB 2048
      < 1 TB 4096
      < 2 TB 8192
    • Volume label
      CrossMix
    • Quick Format:
      ✔️ Yes
  3. Press Start and wait for the process to finish.
    It can take a couple of minutes depending on the size and speed of the card and the reader.

Mac OS

  1. Plug in the SD card in the reader, then plug in the reader to your Mac.
  2. Choose "Application" > "Utilities" > "Disk Utilities"
  3. From the sidebar, click on the USB drive you want to format to FAT32.
  4. Choose "Erase" from the toolbar
  5. In the "Format" drop-down menu, select the option "MS-DOS (FAT)".
  6. In the "Scheme" drop-down menu (if it exists), select the option "Master Boot Record".
  7. Click "Erase" and wait for the process to finish.
    It can take a couple of minutes depending on the size and speed of the card and the reader.

image image

bar

CrossMix installation

  • Download the latest release of CrossMix-OS (in the "assets", at the bottom of the release page, look for CrossMix-OS_v1.x.x.zip)
  • Extract the archive to the root of your formatted SD card.
  • Copy your BIOS files into the BIOS folder (on stock SD card copy it from RetroArch/.retroarch/system to BIOS folder)
  • Copy your own ROMs into the Roms folder. If you want to keep roms from stock SD card, copy the content of each Roms subfolder from stock SD card one by one, some rom paths are different from Stock so if you don't find the target folder or if you have any doubts, find the right path in CrossMix emulator list. (Some examples of rom path changes : PPSSPP -> PSP , OPERA -> PANASONIC , PICO8 -> PICO)
  • Insert your SD card into your TrimUI Smart Pro and start CrossMix-OS. (the first boot is a little longer than usual to setup some components like PortMaster)

bar

To update from a previous CrossMix Version

  • Run a check disk on your SD card first (as there are many bad SD cards, it's always a good idea to check for errors with chkdsk on Windows, fsck on linux or Disk Utility on Mac) (use a genuine, name-brand SD card and not the stock one sold with your console)
  • Copy the archive "CrossMix-OS_v1.x.x.zip" (⚠ archive not extracted ⚠) on SD card root
  • ⚠ Update the file _FirmwareCheck.sh located in System/starts with the new version from the archive "CrossMix-OS_v1.x.x.zip" or from here⚠.
  • At reboot the update will be automatically installed

Notes about the automatic update:

The decompression time is around 4 minutes with a good SD card (it can be longer depending the SD quality).

The following folders are not altered during the update:

- SDCARD/Data
- SDCARD/BIOS
- SDCARD/Best
- SDCARD/Imgs
- SDCARD/Roms

The automatic update process will move your previous files in SDCARD/_Updates folder. You'll also find the migration log in this directory.

The saves/savestates from Retroarch, PPSSPP, Drastic are automatically copied from the backup to the new installation.

After an update, it is recommended to keep this _Updates folder for some time. Once you have spent some time on CrossMix and verified that all your saves are functional, you can delete this _update directory to free up storage space on your SD card.

bar

To migrate from an another OS version (Stock/Tomato)

You can't just override the files to have a good result. Do not use the stock SD card (otherwise you'll have corruption of filesystem very often and loosing files). This procedure is to migrate to CrossMix on a guenuine SD card which is already used for another OS. The process is similar with a separate/dedicated SD card except that you copy the stock files from the initial SD card instead of "_Mybackup" folder.

  • Run a check disk on your SD card first (many SD card filesystem are already partially corrupted before installing so it's always a good idea to check for errors with scandisk or chkdsk on Windows, fsck on linux or Disk Utility on Mac)
  • create a folder called "_Mybackup" for example and put all your existing files/folders in it. You now have only one folders on your SD card.
  • extract the CrossMix archive on your SD card root.
  • copy your BIOS files into the BIOS folder (on stock SD card copy it from /_Mybackup/RetroArch/.retroarch/system to BIOS folder to /BIOS)
  • move Roms folders but don't import roms folders which are not coming from CrossMix ! Some name are different: PPSSPP -> PSP , OPERA -> PANASONIC , PICO8 -> PICO (so for example copy the content of _Mybackup/Roms/PPSSPP/* in Roms/PSP, if you don't find the target folder or if you have any doubts, find the right path in CrossMix emulator list)
  • Insert your SD card into your TrimUI Smart Pro and boot the console.
  • Refresh roms

About saves and save states:

  • The save states made with the in game menu are contained in Roms folder, most of them should work directly except if the core is different: in this case the content folder will not have the same name.
  • if you really need some save and save states from Retroarch the paths have changed for a more clean organization. It's probably easier to make a save with the in game menu before migrate to CrossMix, otherwise the migration is manual: the base folder is the same (RetroArch\.retroarch\saves and RetroArch\.retroarch\states) but on CrossMix it is RetroArch\.> retroarch\saves\**RomFolderName**\**Corename** .

For example : RetroArch\.retroarch\saves\001 Donkey Kong Land.srm wil go into : RetroArch\.retroarch\saves\GB\Gambatte

bar

 
 
 
 

Previous: Home                                               Back to top                                                  Next up: Emulators

 
 
 
 

Back to top

⚠️ **GitHub.com Fallback** ⚠️