ov010 — overlay detail · Tongari Boushi Archive

ov010 general_2d_ui

containers: 2d/designcloth.lzs, designcloth, designpalset (+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 10

File ID 10

RAM load address 0x02155a00

RAM size 13,632 bytes (0x3540)

BSS size 0 bytes

On-disk compressed size 10,376 bytes

Compression flag 0x1 (BLZ-compressed)

Functions 62

External calls 44

Jump tables 14

Data items 285

Code coverage 76% (10,390 of 13,632 bytes)

Reading the binary

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

0x02158304 `适ぁ适餂`

0x0215831e `送ぁ送餁`

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.

designcloth → data/2d/designcloth.lzs
designpalset → data/mydesign/designpalset.ofs

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/designcloth.lzs — no matching container found in clean extract
mydesign/designpalset.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 62 functions

#	Address	Size	Calls	Strings	Role hint
1	0x02155ff0	16	0	0	trampoline / small helper
2	0x02156000	654	33	0	high-fan-out (likely dispatcher / setup)
3	0x021562b0	476	27	3	refs: designcloth.lzs \\| designcloth.lzs \\| designcloth.lzs
4	0x021564a8	94	9	0	code
5	0x02156510	78	2	1	refs: designcloth.lzs
6	0x02156564	1,336	47	0	high-fan-out (likely dispatcher / setup)
7	0x02156ab4	54	4	0	code
8	0x02156af0	140	2	0	code
9	0x02156b8c	72	2	0	code
10	0x02156be4	616	22	0	high-fan-out (likely dispatcher / setup)
11	0x02156e64	52	0	0	code
12	0x02156e98	66	0	0	code
13	0x02156edc	178	5	0	code
14	0x02156f94	178	5	0	code
15	0x0215704c	86	4	0	code
16	0x021570a4	56	1	0	code
17	0x021570e0	64	2	0	code
18	0x02157124	86	3	0	code
19	0x0215717c	88	0	0	code
20	0x021571d8	24	1	0	trampoline / small helper
21	0x021571f0	118	3	0	code
22	0x0215726c	110	3	0	code
23	0x021572dc	88	6	1	refs: designpalset.ofs
24	0x02157344	1,688	80	0	high-fan-out (likely dispatcher / setup)
25	0x02157a64	84	0	0	code
26	0x02157abc	230	14	0	code
27	0x02157bb0	154	5	0	code
28	0x02157c68	112	0	0	code
29	0x02157cd8	76	6	0	code
30	0x02157d38	58	5	0	code
31	0x02157d78	112	2	0	code
32	0x02157de8	108	5	0	code
33	0x02157e60	102	5	0	code
34	0x02157ed4	110	5	0	code
35	0x02157f54	112	5	0	code
36	0x02157fd4	92	3	0	code
37	0x02158040	126	1	0	code
38	0x021580c4	112	3	0	code
39	0x02158140	22	0	0	trampoline / small helper
40	0x02158158	102	1	0	code
41	0x021581c0	42	2	0	code
42	0x021581f4	40	2	0	code
43	0x02158224	42	2	0	code
44	0x02158258	40	2	0	code
45	0x02158288	40	2	0	code
46	0x021582b8	48	1	0	code
47	0x021582e8	112	4	0	code
48	0x02158358	66	0	0	code
49	0x021583a0	92	6	0	code
50	0x02158400	104	1	0	code
51	0x02158474	24	0	0	trampoline / small helper
52	0x02158490	20	0	0	trampoline / small helper
53	0x021584a8	98	1	0	code
54	0x02158510	176	4	0	code
55	0x021585c8	498	12	0	code
56	0x021587cc	74	3	0	code
57	0x0215881c	84	3	0	code
58	0x02158870	146	1	0	code
59	0x02158908	66	0	0	code
60	0x02158950	52	2	0	code
61	0x02158984	384	21	0	high-fan-out (likely dispatcher / setup)
62	0x02158b20	12	1	0	trampoline / small helper

Open questions & conflicts

Open questions / unknowns

Auto-analysis identified 62 functions covering 10390 of 13632 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 `['designcloth']`; Ghidra adds `['2d/designcloth.lzs', 'designpalset', 'mydesign/designpalset.ofs']`.

Source

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

‹ ov009 All overlays ov011 ›