mirror of
https://github.com/RetroPortingToolKit/psxrecomp
synced 2026-10-26 02:11:36 -04:00
Alex Vanderveen
81 lines
3.2 KiB
C
81 lines
3.2 KiB
C
/* psx_bios_image.h — the linked recompiled BIOS describes itself.
|
|
*
|
|
* The generated <stem>_dispatch.c DEFINES these symbols; the runtime READS
|
|
* them instead of hardcoding per-image constants (memory.c's old
|
|
* KBLESS_RAM_LO/HI/ROM_OFF, bios_hle.c's old PSX_SHELL_ENTRY_PHYS /
|
|
* KADDR_DELIVER_RET). Because the values are emitted next to the code they
|
|
* describe — couriered verbatim from the BIOS profile by the emitter — they
|
|
* cannot disagree with the linked BIOS. Same seam as psx_bios_kernel_bodies.
|
|
*
|
|
* A zero value means "this BIOS has no such thing" (no kernel-bless window,
|
|
* no shell boot-skip entry, no DeliverEvent HLE return): consumers must treat
|
|
* zero as structurally-unavailable, never as address 0.
|
|
*/
|
|
#ifndef PSX_BIOS_IMAGE_H
|
|
#define PSX_BIOS_IMAGE_H
|
|
|
|
#include <stdint.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/* Kernel body-extent table for the kernel-image bless mechanism (memory.c).
|
|
* Emitted by full_function_emitter.cpp next to psx_bios_image. */
|
|
typedef struct {
|
|
uint32_t key; /* dispatch key (RAM, normalized) */
|
|
uint32_t body_lo; /* RAM extent of code reachable from key */
|
|
uint32_t body_hi; /* exclusive */
|
|
} PsxKernelBody;
|
|
|
|
/* Published from the ACTIVE backend at selection (psx_bios_backend.c),
|
|
* hence a pointer rather than an array: a build links more than one
|
|
* recompiled BIOS and each carries its own table. Indexing is unchanged
|
|
* for consumers. */
|
|
extern const PsxKernelBody *psx_bios_kernel_bodies;
|
|
extern uint32_t psx_bios_kernel_body_count;
|
|
|
|
/* Native call-stub extents (A0/B0/C0). Layout shared with the generated
|
|
* dispatch, which keeps its own static table. */
|
|
typedef struct {
|
|
uint32_t key;
|
|
uint32_t body_lo;
|
|
uint32_t body_hi;
|
|
} PsxNativeStub;
|
|
|
|
typedef struct {
|
|
/* Kernel-bless window (profile address_model copy with kernel_bless):
|
|
* RAM [kbless_ram_lo, kbless_ram_hi) is the BIOS's boot-time verbatim
|
|
* copy of ROM file offset kbless_rom_off. All zero = no bless window. */
|
|
uint32_t kbless_ram_lo;
|
|
uint32_t kbless_ram_hi;
|
|
uint32_t kbless_rom_off;
|
|
|
|
/* HLE anchors (profile [recompiler.runtime_exports]); 0 = unavailable. */
|
|
uint32_t shell_entry_phys; /* boot-skip trigger (bios_hle.c) */
|
|
uint32_t deliver_event_ret; /* $ra after the kernel DeliverEvent jalr */
|
|
|
|
/* Image identity, computed from the ROM bytes at emit time. */
|
|
uint32_t image_size; /* bytes */
|
|
uint32_t image_crc32; /* IEEE CRC-32 (zlib) */
|
|
uint32_t image_wordsum; /* sum of LE u32 words (savestate checksum) */
|
|
const char* image_sha256; /* 64 lowercase hex chars */
|
|
const char* image_id; /* profile [program] id, e.g. "SCPH-1001" */
|
|
|
|
/* Profile [program.image] redistributable: the BIOS ships WITH the game
|
|
* (e.g. OpenBIOS, MIT). The runtime then resolves the bundled image
|
|
* next to the build and hides the entire BIOS-selection surface
|
|
* (no picker, no bios.cfg, no launcher row). */
|
|
int image_bundled;
|
|
} PsxBiosImageInfo;
|
|
|
|
/* Assigned from the active backend at selection; not const for that
|
|
* reason. Reads are unchanged. */
|
|
extern PsxBiosImageInfo psx_bios_image;
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* PSX_BIOS_IMAGE_H */
|