DS game only ov016 general_2d_ui
containers: 2d/hair_catalog/hc_bg.ofs, 2d/hair_catalog/hc_catalog.ofs, 2d/hair_catalog/hc_common.lzs (+10 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.
Reading the binary
The overlay ships on the cart at file ID 16 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 + 16 * 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_016.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/ov016.json;
the per-overlay descriptive markdown is at
notes/overlay_knowledgebase/ov016.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.
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.
-
hc_bgβdata/2d/hair_catalog/hc_bg.ofs -
hc_catalogβdata/2d/hair_catalog/hc_catalog.ofs -
hc_commonβdata/2d/hair_catalog/hc_common.lzs -
ho_bgβdata/2d/hair_catalog/ho_bg.ofs -
ho_colorβdata/2d/hair_catalog/ho_color.lzs -
ho_styleβdata/2d/hair_catalog/ho_style.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/hair_catalog/hc_bg.ofsβ no matching container found in clean extract -
2d/hair_catalog/hc_catalog.ofsβ no matching container found in clean extract -
2d/hair_catalog/hc_common.lzsβ no matching container found in clean extract -
2d/hair_catalog/ho_bg.ofsβ no matching container found in clean extract -
2d/hair_catalog/ho_color.lzsβ no matching container found in clean extract -
2d/hair_catalog/ho_style.lzsβ no matching container found in clean extract -
2d/hair_catalog/thum_%c%d.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 65 functions
| # | Address | Size | Calls | Strings | Role hint |
|---|---|---|---|---|---|
| 1 | 0x02155ab4 | 6 | 0 | 0 | trampoline / small helper |
| 2 | 0x02155ba4 | 216 | 9 | 0 | code |
| 3 | 0x02155c8c | 4 | 0 | 0 | trampoline / small helper |
| 4 | 0x02155c94 | 374 | 12 | 0 | code |
| 5 | 0x02155e20 | 54 | 2 | 0 | code |
| 6 | 0x02155e58 | 38 | 3 | 0 | trampoline / small helper |
| 7 | 0x02155e80 | 408 | 10 | 6 | refs: 2d/hair_catalog/hc_common.lzs \| 2d/hair_catalog/ho_style.lzs \| 2d/hair_catalog/ho_color.lzs \| 2d/hair_catalog/hc_bg.ofs \| 2d/hair_catalog/ho_bg.ofs \| 2d/hair_catalog/hc_catalog.ofs |
| 8 | 0x02156048 | 176 | 11 | 0 | code |
| 9 | 0x021560f8 | 36 | 0 | 0 | trampoline / small helper |
| 10 | 0x0215611c | 20 | 0 | 0 | trampoline / small helper |
| 11 | 0x02156138 | 24 | 2 | 0 | trampoline / small helper |
| 12 | 0x02156150 | 52 | 3 | 0 | code |
| 13 | 0x02156190 | 150 | 4 | 0 | code |
| 14 | 0x02156230 | 18 | 0 | 0 | trampoline / small helper |
| 15 | 0x02156244 | 64 | 3 | 0 | code |
| 16 | 0x0215628c | 32 | 3 | 0 | trampoline / small helper |
| 17 | 0x021562b0 | 10 | 0 | 0 | trampoline / small helper |
| 18 | 0x021562c4 | 10 | 0 | 0 | trampoline / small helper |
| 19 | 0x021562d8 | 184 | 10 | 0 | code |
| 20 | 0x021563a4 | 164 | 6 | 0 | code |
| 21 | 0x0215644c | 94 | 2 | 0 | code |
| 22 | 0x021564b0 | 42 | 2 | 0 | code |
| 23 | 0x021564e0 | 52 | 3 | 0 | code |
| 24 | 0x02156514 | 56 | 3 | 0 | code |
| 25 | 0x0215654c | 44 | 3 | 0 | code |
| 26 | 0x0215657c | 36 | 0 | 0 | trampoline / small helper |
| 27 | 0x021565a0 | 38 | 1 | 0 | trampoline / small helper |
| 28 | 0x021565cc | 20 | 0 | 0 | trampoline / small helper |
| 29 | 0x021565e0 | 46 | 5 | 0 | code |
| 30 | 0x02156610 | 34 | 1 | 0 | trampoline / small helper |
| 31 | 0x02156634 | 342 | 27 | 0 | high-fan-out (likely dispatcher / setup) |
| 32 | 0x0215679c | 232 | 7 | 2 | refs: 2d/hair_catalog/thum_%c%d.lzs \| thum_%c%d |
| 33 | 0x0215689c | 36 | 1 | 0 | trampoline / small helper |
| 34 | 0x021568c8 | 38 | 5 | 0 | trampoline / small helper |
| 35 | 0x021568f0 | 92 | 5 | 1 | refs: hc_bg |
| 36 | 0x02156960 | 38 | 4 | 0 | trampoline / small helper |
| 37 | 0x02156988 | 456 | 12 | 6 | refs: hc_catalog \| hc_common \| hc_common \| hc_common \| hc_common \| hc_common |
| 38 | 0x02156b8c | 28 | 1 | 0 | trampoline / small helper |
| 39 | 0x02156ba8 | 158 | 4 | 0 | code |
| 40 | 0x02156cd8 | 56 | 1 | 0 | code |
| 41 | 0x02156d28 | 8 | 0 | 0 | trampoline / small helper |
| 42 | 0x021571b4 | 40 | 2 | 0 | code |
| 43 | 0x021571dc | 14 | 0 | 0 | trampoline / small helper |
| 44 | 0x021572c4 | 90 | 2 | 0 | code |
| 45 | 0x02157320 | 20 | 0 | 0 | trampoline / small helper |
| 46 | 0x02157334 | 46 | 5 | 0 | code |
| 47 | 0x02157364 | 30 | 1 | 0 | trampoline / small helper |
| 48 | 0x02157384 | 94 | 4 | 0 | code |
| 49 | 0x021573e4 | 496 | 35 | 0 | high-fan-out (likely dispatcher / setup) |
| 50 | 0x021575ec | 420 | 13 | 2 | refs: 2d/hair_catalog/thum_%c%d.lzs \| thum_%c%d |
| 51 | 0x021577b8 | 30 | 1 | 0 | trampoline / small helper |
| 52 | 0x021577dc | 38 | 5 | 0 | trampoline / small helper |
| 53 | 0x02157804 | 92 | 5 | 1 | refs: ho_bg |
| 54 | 0x02157874 | 38 | 4 | 0 | trampoline / small helper |
| 55 | 0x0215789c | 602 | 23 | 7 | refs: hc_common \| hc_common \| hc_common \| hc_common \| hc_common \| ho_style |
| 56 | 0x02157b24 | 54 | 2 | 0 | code |
| 57 | 0x02157cb4 | 56 | 1 | 0 | code |
| 58 | 0x02157d04 | 570 | 28 | 0 | high-fan-out (likely dispatcher / setup) |
| 59 | 0x02158380 | 112 | 4 | 0 | code |
| 60 | 0x021583f4 | 30 | 0 | 0 | trampoline / small helper |
| 61 | 0x02158448 | 12 | 0 | 0 | trampoline / small helper |
| 62 | 0x02158454 | 42 | 2 | 0 | code |
| 63 | 0x02158480 | 56 | 2 | 0 | code |
| 64 | 0x021584b8 | 110 | 3 | 0 | code |
| 65 | 0x02158540 | 12 | 1 | 0 | trampoline / small helper |
Open questions & conflicts
Open questions / unknowns
- Auto-analysis identified 65 functions covering 7090 of 12160 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
- **Mismatch:** prior-pass `controls_containers` = `['hair_catalog']`; Ghidra-extracted containers = `['2d/hair_catalog/hc_bg.ofs', '2d/hair_catalog/hc_catalog.ofs', '2d/hair_catalog/hc_common.lzs', '2d/hair_catalog/ho_bg.ofs', '2d/hair_catalog/ho_color.lzs', '2d/hair_catalog/ho_style.lzs', '2d/hair_catalog/thum_%c%d.lzs', 'hc_bg', 'hc_catalog', 'hc_common', 'ho_bg', 'ho_color', 'ho_style']`. Ghidra wins.
Source
- Per-overlay markdown:
notes/overlay_knowledgebase/ov016.md - Raw Ghidra dump:
notes/overlay_knowledgebase/raw/ov016.json - Overlay-system explainer: overlays system
- Plain-English overlay primer: overlay knowledgebase