ov025 — overlay detail · Tongari Boushi Archive

ov025 general_2d_ui

containers: B0B0B0B0B0B0, Locker, defcos

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 25

File ID 25

RAM load address 0x02155a00

RAM size 9,568 bytes (0x2560)

BSS size 0 bytes

On-disk compressed size 7,612 bytes

Compression flag 0x1 (BLZ-compressed)

Functions 51

External calls 120

Jump tables 9

Data items 253

Code coverage 83% (7,986 of 9,568 bytes)

Reading the binary

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

defcos → data/defcos.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.

B0B0B0B0B0B0 — no matching container found in clean extract
Locker — 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 51 functions

#	Address	Size	Calls	Strings	Role hint
1	0x02155ac8	110	13	0	code
2	0x02155b40	1,402	92	3	refs: B0B0B0B0B0B0 \\| Locker.lzs \\| defcos.lzs
3	0x02156150	48	6	0	code
4	0x02156180	816	31	0	high-fan-out (likely dispatcher / setup)
5	0x021564cc	148	6	0	code
6	0x02156580	20	0	0	trampoline / small helper
7	0x0215659c	66	2	0	code
8	0x021565e4	30	2	0	trampoline / small helper
9	0x02156608	256	12	0	code
10	0x02156714	68	0	0	code
11	0x02156760	656	33	0	high-fan-out (likely dispatcher / setup)
12	0x021569fc	26	0	0	trampoline / small helper
13	0x02156a1c	38	2	0	trampoline / small helper
14	0x02156a44	20	0	0	trampoline / small helper
15	0x02156a5c	38	1	0	trampoline / small helper
16	0x02156a84	154	2	0	code
17	0x02156b28	68	2	0	code
18	0x02156b74	42	0	0	code
19	0x02156bac	138	8	0	code
20	0x02156c40	60	1	0	code
21	0x02156c84	150	11	0	code
22	0x02156d30	142	11	0	code
23	0x02156dc8	50	3	0	code
24	0x02156dfc	270	18	0	code
25	0x02156f34	98	2	0	code
26	0x02156fa4	114	4	0	code
27	0x0215701c	56	1	0	code
28	0x02157058	22	1	0	trampoline / small helper
29	0x02157074	174	9	0	code
30	0x02157130	40	4	0	code
31	0x0215715c	10	0	0	trampoline / small helper
32	0x02157170	26	2	0	trampoline / small helper
33	0x02157190	234	11	0	code
34	0x02157380	144	7	2	refs: Locker \\| Locker
35	0x02157424	54	4	0	code
36	0x02157460	354	24	0	high-fan-out (likely dispatcher / setup)
37	0x021575d4	312	15	0	code
38	0x02157738	6	0	0	trampoline / small helper
39	0x02157744	86	3	0	code
40	0x021577a0	106	4	0	code
41	0x02157810	54	0	0	code
42	0x02157848	140	9	0	code
43	0x021578dc	60	2	0	code
44	0x0215791c	470	22	0	high-fan-out (likely dispatcher / setup)
45	0x02157b18	44	2	0	code
46	0x02157b44	86	3	0	code
47	0x02157ba4	74	4	0	code
48	0x02157bf8	60	0	0	code
49	0x02157c44	160	5	0	code
50	0x02157cec	90	7	0	code
51	0x02157d5c	96	8	0	code

Open questions & conflicts

Open questions / unknowns

Auto-analysis identified 51 functions covering 7986 of 9568 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/ov025.md
Raw Ghidra dump: notes/overlay_knowledgebase/raw/ov025.json
Overlay-system explainer: overlays system
Plain-English overlay primer: overlay knowledgebase

‹ ov024 All overlays ov026 ›