ov004 — overlay detail · Tongari Boushi Archive

ov004 logo_2d_ui

containers: 2d/changelogo.lzs, Fas00_board00, brandlogo (+2 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 4

File ID 4

RAM load address 0x02155a00

RAM size 7,328 bytes (0x1ca0)

BSS size 0 bytes

On-disk compressed size 5,604 bytes

Compression flag 0x1 (BLZ-compressed)

Functions 36

External calls 88

Jump tables 3

Data items 133

Code coverage 82% (5,992 of 7,328 bytes)

Reading the binary

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

brandlogo → data/mydesign/brandlogo.ofs
changelogo → data/2d/changelogo.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.

2d/changelogo.lzs — no matching container found in clean extract
Fas00_board00 — no matching container found in clean extract
mydesign/brandlogo.ofs — 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 36 functions

#	Address	Size	Calls	Strings	Role hint
1	0x02155a00	226	5	0	code
2	0x02155b80	16	0	0	trampoline / small helper
3	0x02155b90	16	0	0	trampoline / small helper
4	0x02155ba0	688	48	2	refs: 2d/changelogo.lzs \\| mydesign/brandlogo.ofs
5	0x02155e7c	16	0	0	trampoline / small helper
6	0x02155e8c	618	34	0	high-fan-out (likely dispatcher / setup)
7	0x0215610c	86	5	1	refs: changelogo.lzs
8	0x02156168	6	0	0	trampoline / small helper
9	0x02156174	176	9	2	refs: changelogo.lzs \\| changelogo.lzs
10	0x02156230	48	3	0	code
11	0x02156260	1,654	90	0	high-fan-out (likely dispatcher / setup)
12	0x021568e8	126	6	0	code
13	0x02156968	80	3	0	code
14	0x021569cc	100	1	0	code
15	0x02156a44	88	5	0	code
16	0x02156aa4	344	15	0	code
17	0x02156c08	244	10	3	refs: brandlogo.ofs \\| changelogo.lzs \\| changelogo.lzs
18	0x02156d18	48	4	0	code
19	0x02156d4c	48	2	0	code
20	0x02156d80	54	3	0	code
21	0x02156dbc	48	3	0	code
22	0x02156df0	80	3	0	code
23	0x02156e48	74	4	0	code
24	0x02156e9c	76	4	0	code
25	0x02156ef0	168	5	0	code
26	0x02156f9c	44	3	0	code
27	0x02156fd0	78	4	0	code
28	0x02157024	18	0	0	trampoline / small helper
29	0x0215703c	54	2	0	code
30	0x02157078	108	7	2	refs: Fas00_board00 \\| Fas00_board00
31	0x021570fc	120	3	1	refs: brandlogo.ofs
32	0x0215717c	98	3	1	refs: brandlogo.ofs
33	0x021571ec	218	9	0	code
34	0x021572d4	92	6	0	code
35	0x02157338	14	1	0	trampoline / small helper
36	0x02157348	20	2	0	trampoline / small helper

Open questions & conflicts

Open questions / unknowns

Auto-analysis identified 36 functions covering 5992 of 7328 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

Partial overlap: prior-pass had `['changelogo', 'logo']`; Ghidra adds `['2d/changelogo.lzs', 'Fas00_board00', 'brandlogo', 'mydesign/brandlogo.ofs']`.

Source

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

‹ ov003 All overlays ov005 ›