ov057 β€” overlay detail

DS game only γ¨γ‚“γŒγ‚Šγƒœγ‚¦γ‚·γ¨γŠγ—γ‚ƒγ‚Œγͺまほう぀かい The field guide documents the DS game's internals.

containers: map/field/place.lzs, title/titledata.lzs, titledata

ov057 title_2d_ui

containers: map/field/place.lzs, title/titledata.lzs, titledata

Header

Numeric metadata for this overlay as read from the overlay table at ROM offset 0x8DE00 (per-entry stride 32 bytes). Function counts, data-item counts, and the call-graph fan-out are from a Ghidra 11.3.1 headless auto-analysis pass.

Overlay ID 57
File ID 57
RAM load address 0x02155a00
RAM size 4,192 bytes (0x1060)
BSS size 32 bytes
On-disk compressed size 3,944 bytes
Compression flag 0x1 (BLZ-compressed)
Functions 14
External calls 40
Jump tables 0
Data items 80
Code coverage 45% (1,880 of 4,192 bytes)

Reading the binary

The overlay ships on the cart at file ID 57 under the BLZ code-LZ compression wrapper (the same backward-LZ scheme Nintendo uses for executable ARM9 code). At load time the engine reads the overlay table entry at ROM offset 0x8DE00 + 57 * 0x20, allocates the destination RAM region at 0x02155a00, decompresses the body in-place (if compressed), and resolves any external relocations.

To inspect this overlay outside the running game, decompress overlay/overlay_057.bin with ndspy.codeCompression.decompress() (Python ndspy library) and load the resulting plaintext into Ghidra or IDA at base address 0x02155a00. The raw Ghidra auto-analysis dump used to populate this page lives at notes/overlay_knowledgebase/raw/ov057.json; the per-overlay descriptive markdown is at notes/overlay_knowledgebase/ov057.md.

Embedded strings

No UTF-16 LE strings are embedded directly in this overlay's binary. Any text it displays at runtime comes from a container file loaded via the content cache.

Container references

Distinct container basenames referenced by this overlay. Each is loaded via the content cache by passing the basename string to a lookup that resolves it to a file ID in the ROM's FAT. The path column shows the file's location in the clean extract, where resolved.

Unresolved

These container basenames appeared in the overlay's string table but no file of that name was found in the clean extract. Most are false-positive ASCII matches (function names, register maps, fragments of other strings); a few may be containers that the overlay names but never actually opens. Listed for completeness.

Function list

Functions Ghidra auto-identified inside this overlay's RAM range. Names prefixed FUN_ are auto-generated from the function's entry address; size is in bytes; the "calls" column counts both intra-overlay branches and external ARM9 call targets. The "strings" column counts how many UTF-16 LE strings each function references.

Show all 14 functions
# Address Size Calls Strings Role hint
1 0x02155b84 680 25 3 refs: title/titledata.lzs \| map/field/place.lzs \| titledata
2 0x02155e4c 16 0 0 trampoline / small helper
3 0x02155e60 12 1 0 trampoline / small helper
4 0x02155e70 12 0 0 trampoline / small helper
5 0x02155edc 358 14 0 code
6 0x02156270 10 0 0 trampoline / small helper
7 0x02156280 16 0 0 trampoline / small helper
8 0x02156290 128 11 0 code
9 0x02156334 102 3 0 code
10 0x021564f4 44 0 0 code
11 0x02156528 56 3 0 code
12 0x02156560 8 0 0 trampoline / small helper
13 0x02156568 376 7 0 code
14 0x02156940 62 4 0 code

Open questions & conflicts

Open questions / unknowns

Conflicts with the prior shallow pass

Source