ov059 — overlay detail · Tongari Boushi Archive

ov059 trendranking_2d_ui

containers: npcicon, trendranking, trendranking/npcicon.ofs (+1 more)

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 59

File ID 59

RAM load address 0x02155a00

RAM size 7,040 bytes (0x1b80)

BSS size 0 bytes

On-disk compressed size 5,884 bytes

Compression flag 0x1 (BLZ-compressed)

Functions 31

External calls 65

Jump tables 1

Data items 132

Code coverage 67% (4,696 of 7,040 bytes)

Reading the binary

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

Embedded strings

1 UTF-16 LE string 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.

0x0215752c `とんがり`

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.

npcicon → data/trendranking/npcicon.ofs
trendranking → data/trendranking/trendranking.lzs

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.

trendranking/npcicon.ofs — no matching container found in clean extract
trendranking/trendranking.lzs — no matching container found in clean extract

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 31 functions

#	Address	Size	Calls	Strings	Role hint
1	0x021560b0	36	4	0	trampoline / small helper
2	0x021560d4	872	43	0	high-fan-out (likely dispatcher / setup)
3	0x0215644c	58	7	0	code
4	0x02156490	30	3	0	trampoline / small helper
5	0x021564b8	46	5	0	code
6	0x021564ec	86	0	0	code
7	0x02156548	162	6	0	code
8	0x021565ec	56	1	0	code
9	0x02156628	22	1	0	trampoline / small helper
10	0x02156644	196	13	0	code
11	0x02156714	62	7	0	code
12	0x02156758	10	0	0	trampoline / small helper
13	0x0215676c	10	0	0	trampoline / small helper
14	0x02156780	10	0	0	trampoline / small helper
15	0x02156794	36	3	0	trampoline / small helper
16	0x021567bc	286	15	0	code
17	0x021568e8	64	2	0	code
18	0x02156930	240	5	0	code
19	0x02156a30	258	16	3	refs: trendranking \\| trendranking \\| trendranking
20	0x02156b54	96	9	0	code
21	0x02156bb8	760	48	0	high-fan-out (likely dispatcher / setup)
22	0x02156edc	624	15	0	code
23	0x02157154	86	0	0	code
24	0x021571ac	54	3	0	code
25	0x021571e4	28	2	0	trampoline / small helper
26	0x02157200	100	3	0	code
27	0x02157264	94	4	0	code
28	0x021572cc	156	7	0	code
29	0x0215738c	120	6	0	code
30	0x02157414	16	1	0	trampoline / small helper
31	0x02157428	22	2	0	trampoline / small helper

Open questions & conflicts

Open questions / unknowns

Auto-analysis identified 31 functions covering 4696 of 7040 overlay bytes.
Function names are auto-generated `FUN_<addr>`. Manual renaming based on call-graph + string-ref analysis is a follow-up.
BSS size is 0 bytes; Ghidra-imported overlay does not include BSS so any references into the BSS range appear as unresolved.

Conflicts with the prior shallow pass

No major conflicts detected with prior-pass `overlay_role_final.json` record.

Source

Per-overlay markdown: notes/overlay_knowledgebase/ov059.md
Raw Ghidra dump: notes/overlay_knowledgebase/raw/ov059.json
Overlay-system explainer: overlays system
Plain-English overlay primer: overlay knowledgebase

‹ ov058 All overlays ov060 ›