ov049 β€” overlay detail

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

containers: 2d/itemstackwnd.lzs, 2d/sellitem.lzs, sellitem

ov049 general_2d_ui

containers: 2d/itemstackwnd.lzs, 2d/sellitem.lzs, sellitem

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 49
File ID 49
RAM load address 0x02155a00
RAM size 12,672 bytes (0x3180)
BSS size 0 bytes
On-disk compressed size 10,316 bytes
Compression flag 0x1 (BLZ-compressed)
Functions 40
External calls 96
Jump tables 3
Data items 182
Code coverage 83% (10,558 of 12,672 bytes)

Reading the binary

The overlay ships on the cart at file ID 49 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 + 49 * 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_049.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/ov049.json; the per-overlay descriptive markdown is at notes/overlay_knowledgebase/ov049.md.

Embedded strings

2 UTF-16 LE strings live inside this overlay's compiled binary. These addresses are absolute (inside the overlay's RAM image after load). The text is stored as little-endian UTF-16 code units, NUL-terminated.

0x021571b2 `逆め逆送`
0x02157ef3 `ζ¨žγžζ ‘ε…«θ‘ƒ`

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 40 functions
# Address Size Calls Strings Role hint
1 0x02155b14 756 52 2 refs: 2d/sellitem.lzs \| 2d/itemstackwnd.lzs
2 0x02155e44 16 0 0 trampoline / small helper
3 0x02155e54 1,038 44 0 high-fan-out (likely dispatcher / setup)
4 0x02156280 242 14 3 refs: sellitem.lzs \| sellitem.lzs \| sellitem.lzs
5 0x0215638c 64 5 0 code
6 0x021563d0 198 7 0 code
7 0x021564a0 98 0 0 code
8 0x02156508 136 9 0 code
9 0x021565a0 54 2 0 code
10 0x021565d8 574 20 0 code
11 0x02156824 188 9 0 code
12 0x021568e8 188 5 0 code
13 0x021569b0 446 19 0 code
14 0x02156b8c 16 0 0 trampoline / small helper
15 0x02156ba0 12 1 0 trampoline / small helper
16 0x02156bb0 12 0 0 trampoline / small helper
17 0x02156bc0 12 1 0 trampoline / small helper
18 0x02156bd0 384 9 0 code
19 0x02156d64 486 15 0 code
20 0x02156f6c 986 24 0 high-fan-out (likely dispatcher / setup)
21 0x02157370 298 13 0 code
22 0x021574b4 60 3 0 code
23 0x021574f4 134 6 0 code
24 0x02157588 1,204 34 0 high-fan-out (likely dispatcher / setup)
25 0x02157a7c 1,478 55 0 high-fan-out (likely dispatcher / setup)
26 0x02158080 22 2 0 trampoline / small helper
27 0x02158098 86 4 0 code
28 0x021580f4 74 5 0 code
29 0x02158144 80 5 0 code
30 0x02158198 192 0 0 code
31 0x02158258 66 1 0 code
32 0x021582a4 58 1 0 code
33 0x021582e4 84 0 0 code
34 0x02158338 94 5 0 code
35 0x021583a0 304 23 0 high-fan-out (likely dispatcher / setup)
36 0x021584d8 120 2 0 code
37 0x02158554 60 0 0 code
38 0x02158590 114 4 0 code
39 0x02158608 112 6 0 code
40 0x0215867c 12 1 0 trampoline / small helper

Open questions & conflicts

Open questions / unknowns

Conflicts with the prior shallow pass

Source