ov056 β€” overlay detail

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

containers: 2d/status/common.lzs, common

ov056 general_2d_ui

containers: 2d/status/common.lzs, common

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 56
File ID 56
RAM load address 0x02155a00
RAM size 8,608 bytes (0x21a0)
BSS size 0 bytes
On-disk compressed size 6,436 bytes
Compression flag 0x1 (BLZ-compressed)
Functions 47
External calls 56
Jump tables 0
Data items 60
Code coverage 48% (4,134 of 8,608 bytes)

Reading the binary

The overlay ships on the cart at file ID 56 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 + 56 * 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_056.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/ov056.json; the per-overlay descriptive markdown is at notes/overlay_knowledgebase/ov056.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 47 functions
# Address Size Calls Strings Role hint
1 0x0215642e 32 3 0 trampoline / small helper
2 0x02156458 8 0 0 trampoline / small helper
3 0x02156460 58 6 0 code
4 0x0215649c 852 22 0 high-fan-out (likely dispatcher / setup)
5 0x02156800 754 27 0 high-fan-out (likely dispatcher / setup)
6 0x02156b00 98 6 0 code
7 0x02156b68 132 4 0 code
8 0x02156de8 24 1 0 trampoline / small helper
9 0x02156e04 16 1 0 trampoline / small helper
10 0x02156e18 150 4 0 code
11 0x02156eb4 18 1 0 trampoline / small helper
12 0x02156f00 62 5 0 code
13 0x02156f40 130 9 0 code
14 0x02156fd4 150 11 0 code
15 0x0215711c 22 0 0 trampoline / small helper
16 0x02157134 114 6 0 code
17 0x021571b4 32 0 0 trampoline / small helper
18 0x021571d4 62 3 0 code
19 0x02157214 56 1 0 code
20 0x02157250 26 2 0 trampoline / small helper
21 0x02157298 22 1 0 trampoline / small helper
22 0x021572fc 30 2 0 trampoline / small helper
23 0x0215731c 60 3 1 refs: common
24 0x0215735c 24 2 0 trampoline / small helper
25 0x02157374 36 2 1 refs: common
26 0x0215739c 8 0 0 trampoline / small helper
27 0x021573f4 10 0 0 trampoline / small helper
28 0x02157404 10 0 0 trampoline / small helper
29 0x02157414 30 3 0 trampoline / small helper
30 0x02157434 88 3 1 refs: common
31 0x02157494 10 0 0 trampoline / small helper
32 0x021574a4 20 2 0 trampoline / small helper
33 0x021574b8 30 3 0 trampoline / small helper
34 0x021574d8 264 12 3 refs: common \| common \| common
35 0x021575f0 50 3 0 code
36 0x02157624 58 3 0 code
37 0x02157660 106 9 0 code
38 0x021576d0 154 3 0 code
39 0x02157770 56 1 0 code
40 0x021577a8 18 0 0 trampoline / small helper
41 0x021577c0 36 0 0 trampoline / small helper
42 0x02157968 40 2 0 code
43 0x02157990 78 3 1 refs: common
44 0x02157a1c 30 1 0 trampoline / small helper
45 0x02157a3c 26 2 0 trampoline / small helper
46 0x02157a58 32 3 0 trampoline / small helper
47 0x02157a7c 12 1 0 trampoline / small helper

Open questions & conflicts

Open questions / unknowns

Conflicts with the prior shallow pass

Source