Skip to content

Memory map

The console has 2 MiB of main RAM at 0x80000000..0x80200000, and the game uses all of it. Two programs stay resident from boot to power-off; every other range is a data bank that an area load overwrites, or an overlay window that holds one overlay at a time. This page maps each range to its owner. Loading explains how each range gets filled.

  • Fixed code. The executable exe/slus_004_22 (0x80149800..0x80190C60) and the resident game program emi/etc/game/00 (0x80195800..0x801CD958) never move and are never replaced.
  • Data banks. Low RAM (0x80010000..0x8003B800) and the area band (0x800D3800..0x80117000) hold per-area data: text, tables, palettes, scripts and the map. Entering a new area overwrites them.
  • Overlay windows. Five windows hold code that other code calls by fixed address, plus the boss and battle data windows 0x800C1800 and 0x80096800 (overlay windows).

The persistent block at 0x801448D8..0x80145988 lies in the executable’s work variables, so no overlay overwrites it (persistent state). An overlay’s own variables live in its window and are overwritten when the next archive loads there.

The code does not record which overlay a window holds; the caller must have loaded the right archive. [inferred] The loader checks only the first word of each entry against its table. There is no unload code: a later load overwrites an earlier one.

Addresses ascend. “Up to” is the largest entry over every archive; other sizes are exact. A dash means the size is not stated.

Address Size Owner Content
0x1F800000 1,024 scratchpad g_SpadWork pointer cell at 0x1F800044; the LZ77 decoder window
0x80010000 up to 21,547 area archive per-area text table
0x8001A000 up to 16,872 FIRST, BATTLE, BOSS archives text resource table
0x80020000..0x80032000 73,728 SYS_PrepareFrame two primitive banks of 36,864 bytes, picked by the buffer index
0x80032000 5,000 area archive area table, read as nibbles by func_801C6FD4
0x800327A0 - LZ77_DecodeBegin LZ77 decoder context
0x80033800 16,384 GFX_ResetPalette palette arena; archives load CLUT slices at 0x80033A00, 0x80033C00, 0x80033E00, 0x80035800, 0x80036C00, 0x80036E00
0x80037800 16,384 g_GraphicsPaletteDst palette work area: 32 rows of 512 bytes, uploaded by GFX_UploadPalette
0x8003B800 - PLCHAR, BPLCHAR, BMAGIC decompression destination for character and effect graphics
0x80096800 up to 133,316 BATTLE, BOSS archives battle data module (battle/15), loaded with battle/03
0x800C1800 up to 7,700 BOSS archives boss module
0x800C3800 up to 3,148 BMAGIC archives spell table
0x800D3800 up to 65,236 area archive area script table
0x800E3800 up to 412 area archive scene table
0x800E4000 1,160 area archive encounter table
0x800E4800..0x800F0800 49,152 EMI_LoadArchive CD ring: one header slot and 23 ring slots of 2,048 bytes; the area work window shares it
0x800F0800 3,692 BATTLE, BOSS archives battle script table
0x800F5000 up to 8,784 3 area archives extra area code block
0x80104000 up to 84,584 area archive map bundle
0x80117000 up to 5,964 9 area archives auxiliary area module
0x8011A000..0x8012C000 73,728 SND_SetBankLayout sound bank RAM; the end depends on the layout [inferred]
0x80143B40..0x801448D8 3,480 exe/slus_004_22 work variables below the persistent block, such as D_80143B40; the lower bound is the lowest one seen
0x801448D8..0x80145988 4,272 exe/slus_004_22 the persistent block: party, flags, clock and scenario state (persistent state)
0x80145988..0x80149800 15,992 exe/slus_004_22 work variables above the persistent block, such as g_EmiRingBase
0x80149800..0x8018B2B4 268,980 exe/slus_004_22 rodata, data and code; the last non-zero word is at 0x8018B2B0
0x8018B2B4..0x8018B2B8 4 exe/slus_004_22 zero bytes; stup1 sets gp to 0x8018B2B4
0x8018B2B8..0x80190C60 22,952 exe/slus_004_22 BSS, cleared by stup2; its first word holds the return address that stup1 saves
0x80195800 229,720 emi/etc/game/00 resident game code and tables, from GAME.EMI entry 0
0x801CE000 120,832 exe/logo the logo program, to 0x801EB800 (BSS to 0x801ECEC0)
0x801CE400 up to 9,932 PLCHAR archives character code window
0x801D0C00 up to 118,224 scene window one menu, title, scenario-effect, battle or area overlay; battle/03 is the largest
0x801EEC00 up to 16,076 shared code window battle end and game over, spell code, dialogue, START entry 9, SHOP entry 8, some area code
0x801F2C00 up to 16,324 area program window the program of the current area, from 200 archives
0x801F6C00 up to 32,384 scenario window the controller of the current scenario, one of 20, ends at 0x801FEA80
0x801FF000 - SYS_StartLogo stack for the Exec of LOGO.EXE
0x801FF400..0x801FFC00 2,048 CallbackInitThreads four 512-byte callback thread stacks

Each window holds one occupant at a time.

Window Occupants, one at a time Replaced when
0x801CE400 character code (PLCHAR and PLP archives) another character archive loads
0x801D0C00 title (GAME.EMI entry 1), START, STATUS, SHOP, SISYOU, BATE, battle/03, some area code the next menu, battle or area archive
0x801EEC00 START entry 9, SHOP entry 8, COMMU00, BMAGIC, BATL_END, BATL_OVR, some area code the next archive with code at this address
0x801F2C00 the area program of the current area the next area archive
0x801F6C00 the scenario controller of the current scenario the next SCENA archive
0x800C1800 boss module the next BOSS archive

Resident code reaches overlay code through tables of function pointers:

  • The scene-object handler table g_ActorHandlers (187 entries, one per object type; areas) and the scene event table g_SceneEvents mix handlers in the resident program (0x8019xxxx, 0x801Axxxx) with handlers in the scene window (0x801Dxxxx), the area program window and the scenario window.
  • g_SceneScenes (emi/etc/game/00@0x801C8454) holds 20 pointers into the scenario window, and Game_UpdateScenario (emi/etc/game/00@0x801A782C) calls entry_00 of the selected one.
  • g_GameModeHandlers (emi/etc/game/00@0x801C7B54) holds Battle_Update (emi/battle/battle/03@0x801D1014) at index 5.
  • battle/03 (0x801D0C00) and battle/15 (0x80096800) come from one battle archive and coexist.

The logo (0x801CE000..0x801EB800) overlaps only the character window and the scene window. Both are empty while the logo runs, because no overlay loads before it. [inferred]

The PS-X header of SLUS_004.22 states the load address 0x80096800, and a RAM address equals 0x80096000 plus the file offset (executables owns the header fields).

The first 733,184 bytes of the payload are zero apart from a few stamp words; they reserve RAM for later loads. The real code and data sit at 0x80149800..0x8018B2B4, file offsets 0xB3800..0xF52B4. The reserved ranges are 0x80096800 (176,128 bytes), 0x800C1800 (210,944 bytes), 0x800F5000 (139,264 bytes) and 0x80117000 (206,848 bytes). The payload is also zero from 0x8018B2B4 to 0x801D0400, apart from stamp words at 0x80195800 and 0x801CE400, and has a tail pad at 0x801F6800. The stamp words hold values 6 to 0xF, and their meaning is [unknown]. The executable does not occupy its own load address: battle/15 is the first data at 0x80096800, and the resident game program lands in the zero gap at 0x80195800.

The scratchpad is the 1 KiB of fast RAM at 0x1F800000. g_SpadWork is a pointer cell at 0x1F800044, which the overlay handlers use to reach the record they step (scheduler). LZ77_DecodeBegin (exe/slus_004_22@0x80164028) points the LZ77 source at scratchpad offset 6 and its limit at 0x400, so the decoder treats the whole scratchpad as a sector window during a load. How the two uses share the space is [unknown].

Stack Top Set by
Main 0x80200000 stup1; it replaces the header value 0x801FFFF0
LOGO.EXE Exec 0x801FF000 SYS_StartLogo
Callback slot i (0 to 3) 0x801FF400 + 0x200 * (i + 1) CallbackInitThreads

stup1 leaves 32,768 bytes for the main stack: the heap ends at 0x801F8004. The range 0x801F8000..0x80200000 already holds most of the scenario window and the thread stacks, which end at 0x801FFC00, so the main stack has 1,024 bytes above them. A deeper main stack writes into slot 3’s stack. [inferred] The real depth is [unknown]. The Exec stack is used only while the logo runs.

  • Heap. stup1 calls InitHeap over 0x80190C64..0x801F8004, which overlaps the resident program and the overlay arena. The executable has no allocator thunk, so the heap is unused [inferred] (boot).
  • Primitive banks. SYS_PrepareFrame sets g_GfxPrimCursor to 0x80020000 + buffer_index * 0x9000. Two banks end at 0x80032000. Each bank accepts primitives only up to 36,812 bytes (frame loop).
  • CD ring. g_EmiRingBase is 0x800E4800; slot 0 receives the header sector of the archive. SYS_LoadExec reads its header sector to the same address.
  • Area work window. AREA_WORK_WINDOW is also 0x800E4800, so no area work data is safe there while an archive streams. [inferred] D_801459FC holds 0x800F5000, the area code base.
  • Palettes. GFX_ResetPalette zeroes rows 28 to 31 of the arena, then copies 32 rows of 512 bytes to the work area. GFX_UploadPalette sends the rectangle (0, 0x1E0, 0x100, 0x20) from there to VRAM whenever g_GfxPalettePending is set.

SND_SetBankLayout (exe/slus_004_22@0x80161808) starts at 0x8011A000 and advances by two per-bank size tables, D_8018239C and D_801823F0. The SPU RAM address of each bank comes from D_80182348[3][7]. The sums put the end of the bank RAM at 0x8012C000 (layout 0), 0x8012B840 (layout 1) and 0x8012B5E0 (layout 2). [inferred]

The audio system lists the three layouts with their banks, window sizes and SPU addresses. All three put bank 0 at SPU address 0x1010, so a layout change reuses SPU RAM. XA audio bypasses main RAM: the CD hardware sends it straight to the SPU.

The code addresses VRAM only through LoadImage rectangles. Three uses are fixed:

Rectangle Source Writer
(0, 0x1E0, 0x100, 0x20) 0x80037800 palette work GFX_UploadPalette
32 by 32 blocks at x = column * 32, y = (row & 0x3F) * 32 ring sectors EMI_UploadSectorImage, bounded to x below 1001 and y below 501
24-wide slices logo decode buffer Logo_DecodeSlice

The full split of VRAM between frame buffers, textures and palettes is [unknown] (rendering).

Question What would settle it
Meaning of the stamp words 6 to 0xF in the executable Find a reader, or compare with the linker map
Whether the area table at 0x80032000 is live while the LZ77 context at 0x800327A0 is in use The two ranges overlap; trace their uses during an area load
The final VRAM split A VRAM dump during play
The field that each per-bank size block feeds; the real end of used SPU RAM; the real main stack depth A trace of SND_SetBankLayout users, an SPU dump, a stack watermark
Whether anything between 0x8012C000 and 0x80143B40 is in use g_AreaCellPrims, the cell-row pool, is the one symbol seen there; search the assembly for others
Whether a load into a window can start while its previous overlay still runs No guard was found; a runtime watch on the loader
Which occupant of a shared window is live at a given moment The code does not record it; a runtime watch on the loader
Callers of the BOSS slot 0x1B3 No immediate use of 0x1B3 exists in the assembly; find where a caller builds the slot id
  • Confidence: medium. The ranges and sizes are measured on every archive, but the stack depth, the SPU end addresses, the VRAM split and which occupant a window holds are [inferred] or [unknown].
  • Evidence: the load address and size of every entry over all archives on the disc; the executable header and the code of stup1, stup2, SYS_PrepareFrame, LZ77_DecodeBegin, GFX_ResetPalette, SND_SetBankLayout and CallbackInitThreads.