EllipticEllipsis
d5b71bd0f5
* ObjTree OK, data imported * EnMs OK, data imported * And the spec * OK * Some minor edits * A lot of preliminary stuff * Mostly complete beginning * First draft of other functions doc * Whoops, forgot the GlobalContext pad * Draw functions (minus colour), create Data * Data * gitignore, some progress on documenting * Review comments, continue documenting * spec * Finish off documentation * undefined_syms * Add a couple of todos * One more * At least add tools for object decomp * Start conversion table stuff * Document ObjTree * Document EnMs * Add more tables to conversions * Maide's review * Review * Review * Typos and incomplete thoughts * Update vscode.md * Correct function/variable names * Review suggestions * Format * Missed one * Rename functions and format * Fix ObjTree * Update actorfixer.py, fix some variable names * Some review * Review suggestions * More review * Hopefully fix all the thisx references * Missed one
1.9 KiB
Disassembly quirks
As MM's disassembly is automatic, there are certain unique problems it has.
Renaming functions and variables
A function must be renamed in tools/disasm/functions.txt in addition to the source code, for the disassembler to know what to call the symbol at that address when it sees it.
Variables must be renamed in tools/disasm/variables.txt. It may also be necessary to change their type, count or size to stop the disassembler misusing them.
You can avoid having to redisassemble every time by running rename_global_asm.py, which will rename the individual functions' assembly files in asm/nonmatchings/ to the name of the function they contain.
Fake and incorrect symbols
TODO
Resplitting a file
The files boot and code are each divided up into dozens of separate files, that are all joined together into one text, data, rodata and bss section when building the ROM. As such, it has been necessary to guess where the file boundaries are, and not every file contains the correct functions or the correct data (rodata is mostly the exception since it is automatically split).
To change a split for a file, find its entry in tools/disasm/files.txt, and change or create entries to accurately reflect where the file(s) should start. For example, it was found that the last function in z_nmi_buff.c had nothing to do with the rest, so it should be split into its own file. Looking up the address of the last function, it was found to be at 0x8010C1B0, so adding the line:
0x8010C0C0 : "z_nmi_buff",
+++ 0x8010C1B0 : "code_8010C1B0",
0x8010C230 : "z_olib",
to the file will extract it correctly as a separate file. It also is necessary to make a new C file and move the GLOBAL_ASM declaration into it.
Unfortunately you essentially have to redisassemble after telling the disassembler to resplit a file.