Files
psxrecomp/runtime/include/memcard.h
T
Matthew Stanley c86482cc65 launcher: Phase 4 — memory-card introspection
Wire the launcher's Memory Card 1/2 panels to real on-disk data and make
the per-card enable/path choices flow through to the runtime.

- memcard.c/.h: add stateless introspection (memcard_summary_path parses the
  directory frames for used-block count + mtime + validity, no live state),
  memcard_format_file for "New", and memcard_init_slots for per-slot paths +
  enable flags. memcard_init now delegates to it.
- config_loader: settings.toml [memcard] gains card1/card2 (explicit paths)
  and enable1/enable2; load + save round-trip them (UserSettings extended).
- main.cpp: resolve the effective memcard dir before the launcher so it can
  introspect the real files; seed/apply per-card paths+enable; boot via
  memcard_init_slots (a disabled slot is left absent — SIO reports no device).
- launcher: MC cards now show real filename, size, used-block count, last-
  modified date, and a live 15-cell block grid; Browse picks an existing
  .mcd, New formats a fresh one (overwrite-prompt save dialog). Per-card
  enable + paths are committed to settings on launch.
- The block grid is injected via data-rml (the structural data-for view does
  not capture inner-xml in this RmlUi build; data-rml is the robust path and
  the markup is fully launcher-controlled).
- Add LauncherSystemInterface so RmlUi warnings/errors reach stdout (they
  otherwise go to OutputDebugString on Windows); drop an unsupported
  text-overflow RCSS declaration it surfaced.

Verified on Tomba: card1 3/15 + card2 1/15 match the on-disk directory
frames; disabling slot 2 in settings.toml leaves it not-present via mc_status.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-12 13:55:58 -07:00

78 lines
3.1 KiB
C

#ifndef PSXRECOMP_MEMCARD_H
#define PSXRECOMP_MEMCARD_H
#include <stdint.h>
#ifdef __cplusplus
extern "C" {
#endif
#define MEMCARD_SIZE (128 * 1024) /* 128KB per card */
#define MEMCARD_SECTOR_SIZE 128
#define MEMCARD_SECTORS 1024
/* Initialize memcard subsystem. dir = directory for .mcd files (can be NULL).
* Loads (or formats+creates) card1.mcd / card2.mcd in `dir` for both slots. */
void memcard_init(const char* dir);
/* Per-slot configuration for memcard_init_slots(). */
typedef struct {
const char* path; /* explicit .mcd path; NULL => derive <dir>/card<N>.mcd */
int enabled; /* 0 => slot is empty (no card inserted, never present) */
} MemcardSlotConfig;
/* Initialize memcard subsystem with per-slot paths + enable flags. A disabled
* slot is left absent (memcard_is_present() returns 0, SIO reports no device).
* An enabled slot loads its file, or formats+creates it if missing. `dir` is
* only used to derive default paths for slots whose path is NULL. */
void memcard_init_slots(const char* dir, const MemcardSlotConfig slots[2]);
/* Stateless on-disk introspection (used by the launcher before boot). Parses a
* .mcd file's directory frames without touching the live card array. */
typedef struct {
int exists; /* file present and readable */
int valid; /* 128KB and "MC" magic in frame 0 */
int used_blocks; /* directory frames in use (0..15) */
int total_blocks; /* always 15 */
uint8_t block_used[15];/* per-block: 1 = occupied, 0 = free */
long long mtime; /* file mtime (unix seconds); 0 if unknown */
long long size_bytes; /* on-disk file size */
} MemcardSummary;
/* Parse `path` into `out`. Returns 0 always (out->exists/valid report failure).
* Returns -1 only for a NULL argument. */
int memcard_summary_path(const char* path, MemcardSummary* out);
/* Write a freshly formatted (blank) 128KB card image to `path`, creating or
* overwriting it. Returns 0 on success, -1 on I/O failure. */
int memcard_format_file(const char* path);
/* Read/write 128-byte sectors */
int memcard_read_sector(int card, int sector, uint8_t* buf);
int memcard_write_sector(int card, int sector, const uint8_t* buf);
/* Flush pending writes to disk */
void memcard_flush(int card);
void memcard_flush_all(void);
/* Check if card is present */
int memcard_is_present(int card);
/* Debug accessors: file path used for slot, magic at offset 0..1, total bytes loaded.
* Returns 0 on success, -1 if slot index is out of range. */
int memcard_debug_info(int card, const char **path_out,
uint8_t magic_out[2], int *present_out,
int *dirty_out);
/* Copy raw bytes out of the in-memory card image. Used by the debug server
* to verify that what the runtime loaded matches the on-disk file.
* Returns the number of bytes copied (0 if slot empty / range invalid). */
int memcard_debug_read_buffer(int card, uint32_t offset, uint32_t len,
uint8_t *dst);
#ifdef __cplusplus
}
#endif
#endif /* PSXRECOMP_MEMCARD_H */