Repository navigation
ember
Ember is the second PS1 core beside POPStarter. The two do not compete for a preference: .VCD uses POPStarter, while Ember's own folder/image layout uses Ember automatically.
bios.bin (exactly 512 KB). If the target umbrella lacks ember.elf, Launchstation can copy the selected ELF into that umbrella as ember.elf once before launch. Older folder-valued settings remain supported.The umbrella folder can be named anything and live anywhere on the device.
DEVICE:/
└── MY-EMBER/
├── ember.elf
├── bios.bin
└── games/
├── Spyro 2 (Ripto's Rage)/
│ ├── game.cue
│ ├── track01.bin
│ ├── MC1.vmc created/used by Ember
│ └── MC2.vmc created/used by Ember
└── Another Game/
└── game.binSelect a .CUE, .BIN or PS1 .EXE directly inside the game folder. Launchstation derives the bare folder name and passes that to Ember.
Ember can resolve looser layouts, but its memory-card path is always composed as games/<argument>/MC1.vmc and MC2.vmc. A loose games/Game.cue can boot while silently making the save path impossible. The browser therefore offers only the folder layout that can both launch and save correctly.
Ember derives its working directory from target argv[0], so Launchstation preserves the real live path to ember.elf as target argv[0]. The bare game-folder name is the only game argument. Names containing path separators, a colon, a leading .., or more than 180 characters are refused.
Ember requires a working game-device stack when control reaches it. For USB/MASS, LAUNCHSTATION first finishes background I/O and audio, prepares a clean IOP without its own PADMAN, re-discovers the USB game and ember.elf even if the drive's logical unit has changed, then executes Ember with no further IOP reset. A mismatched or ambiguous remount is refused rather than silently launching another drive. For non-USB paths the existing mounted stack is retained for handoff. On APA/PFS, the Ember partition is mounted writable with write-through for its save files.
Ember CUE/BIN launches use the same brief Game ID signal as POPStarter and Neutrino. Enable Settings > Launching > Game ID output > Game ID launch signal for discs. Launchstation reads the CUE data track's SYSTEM.CNF boot serial, then tries the existing PS1 volume-timestamp database and filename fallback. CUE track offsets are respected; BIN files use a matching CUE when available, or probe supported raw/cooked sector layouts. A standalone PS1 EXE has no disc filesystem to identify.
The ID is read before cleanup and displayed for two frames after a successful USB remount, immediately before Ember starts. An unreadable, malformed or unsupported image omits the optional signal and retains the normal launch behavior. This uses the upstream identity implementation and adds no MMCE card-selection command. RetroGEM recognition on physical hardware remains to be verified.
| Format/layout | Launcher |
|---|---|
POPS/*.VCD |
POPStarter |
MY-EMBER/games/<Game>/*.CUE |
Ember |
MY-EMBER/games/<Game>/*.BIN |
Ember |
MY-EMBER/games/<Game>/*.EXE |
Ember |
- Confirm the selected image is directly under
<umbrella>/games/<Game>/. - Confirm
<umbrella>/bios.binexists and is exactly 512 KB. - If
<umbrella>/ember.elfis missing, choose a valid ELF under Ember path so Launchstation can stage the executable into the target umbrella. - Use the dedicated Ember handoff; its controlled USB-only remount and final keep-IOP execution ignore the normal ELF reset preference.
LAUNCHSTATION repository · Live documentation · Release downloads
Maintained from documentation sources. Do not edit generated pages directly; propose changes in the source repository.