# IDO compilation flowchart ```graphviz digraph{ c [label="C code .c", shape=parallelogram] p [label="Pascal code .p", shape=parallelogram] s [label="Assembly .s", shape=parallelogram] ucode [label="UCode", shape=parallelogram] cc[shape=square] c -> cc p -> cc s -> cc cfe[shape=square] upas[shape=square] as0[shape=square] cc -> as0 [label="Assembly"] cc -> cfe [label="C"] cc -> upas [label="Pascal"] cfe,upas -> ucode uopt[shape=square] ugen[shape=square] ujoin[shape=square] uld[shape=square] usplit[shape=square] umerge[shape=square] as1[shape=square] ld[shape=square] ucode -> ugen [label = "-O0/-O1"] ucode -> uopt [label = "-O2"] ucode -> ujoin [label = "-O3"] ujoin -> uld uld -> u -> usplit -> umerge umerge -> uopt uopt -> ugen ugen -> as1 as1 -> ld u [label = "Ucode .u", shape=parallelogram] sout [label = "Compiled .s", shape=parallelogram] o [label = "Assembled .o", shape=parallelogram] aout [label = "Compiled a.out", shape=parallelogram] ugen -> sout [label = "-S"] as1 -> o [label = "-c"] as0 -> as1 [label = "?"] ld -> aout {rank=same; ugen, sout} {rank=same; as1, o} {rank=same; ld, aout} // {rank=same; s,c,p} // {rank=same; as0, ugen} ujoin[shape=square] usplit[shape=square] } ``` ## Intermediate files | tempstr | temp pref | written | kept suf | read by | name | | ------- | --------- | --------- | -------- | --------------------------- | ----------------------------------- | | 0 | ctmst | cfe | .T | cfe, uopt, ugen, as1 | symtab | | 1 | ctmu | utob | .B | | [utob passout] | | 2 | ctmp | cpp, cfe | .B/.i | | [cfe/cpp passout?] | | 3 | ctmf | cc(?),cfe | .B | ujoin(O3),uopt(O1),ugen(O2) | ? [cfe passout] | | - | - | ujoin | .u | uld | ufile [ujoin passout] | | 4 | ctmlu | uld | u.out.u | usplit | uoutfile [uld passout] | | 5 | ctms | usplit | u.out.S | umerge | [usplit passout] | | 6 | ctmm | umerge | u.out.M | uopt(O3) | [umerge passout] | | 7 | ctmo | uopt | .O | as1 | ? [uopt passout] | | 8 | ctmos | uopt? | - | | optstr | | 9 | ctmcb | ugen | .G | | binasm (for -S only) | | 10 | ctmc | ugen | .G | ugen, as1 | ? [ugen passout] (except -S) | | - | - | ugen | .s | | | | 11 | ctma | as0 | .G | as1 | [as0 passout] | | 12 | ctmb | as1 | | | temp_uldobj [as1 passout] (unused?) | | 13 | ctml | | | | unused | | 14 | ctmm4 | m4 | .p | | [m4 passout] | | 15 | ctmgt | ugen | - | | gentmp | | 33 | ctmcmd | cc(?) | - | cfe | commandfile [related to -g] | ## Compilation procedure cc calls appropriate programs cfe: .c -> .T (symtab), .B (binasm? ucode?) ### -O1 | Program | In | Out | | ------- | ------ | --- | | ugen | .T, .B | .G | | as1 | .T, .G | .o | ### -O2 | Program | In | Out | | ------- | ------ | --- | | uopt | .T, .B | .O | | ugen | .T, .O | .G | | as1 | .T, .G | .o | ### -O3 | Program | In | Out | | ------- | ---------------- | ---------------- | | ujoin | .T, .B | .u | | uld | .u | u.out.u | | usplit | u.out.u | u.out.S, u.out.T | | umerge | u.out.T, u.out.S | u.out.M | | uopt | u.out.T, u.out.M | u.out.O | | ugen | u.out.T, u.out.O | u.out.G | | as1 | u.out.T, u.out.G | .o |
Last changed by  
 
EllipticEllipsis
143

Read more

Ocarina of Time Gateway changes

Introduction The build date of the newly-discovered Gateway rom is 99-01-19 11:37:17. This is later than every released Nintendo 64 version (the last of these being in November 1998): the last NTSC version (commonly referred to as 1.2 or NN2) was built on 98-11-12, and the last PAL version (the second PAL version, referred to as NP1) on 98-11-18. Summary The vast majority of the rom is the same as NN2. A small number of the changes made between NN2 and NP1 are present, but plenty of others are not (such as the Gerudo who gives you Gerudo card's clothes, which are patched to be stay a single colour in NP1 and later). These are noted below. The most visible change is that the new Gerudo symbol is used instead of the original crescent and star, in both scene model textures and actor model textures. This change was originally thought to come from Majora's Mask first; this rom is now the earliest known build of a Zelda game to use it.[^gerudo] Most interestingly, this also includes textures in Dampe's race and Iron Knuckles, which are not patched in any other known rom version. The file choice screen is changed to only display a single file, and no copy/erase functionality. A new file (which we may guess is called gateway_title_static) contains 3 new textures for this, a Start button, and textures for Please Select., Press A button to decide., Press B button to exit.. After entering a name, the game starts immediately END is pressed. The Save option is disabled in the pause menu, and the Game Over screen goes straight to the "Continue playing?" choice, skipping the save screen. Since these are the only way to save, saving is impossible. No text is changed, so the tutorial signs still explain how to save the game. Rumble is completely disabled (so just as in the Virtual Console release, the Stone of Agony is completely useless).

4/26/2023
Majora's Mask Gateway changes

Introduction The build date of the newly-discovered Gateway rom is 00-08-08 09:25:41. This is between the US retail version (00-07-31, referred to as NE0) and the first PAL version (00-09-25, referred to as NP0) Summary Most of the rom is the same as NE0. A number of patches/changes previously only known in NP0 and after are also present, surprising considering that this rom was built only 10 days after NE0. Several unused functions are removed from various files, as they are in NP0. Several patches from NP0 (in z_eventmgr, z_kaleido_setup), but not all. The file choice screen is changed to only display a single file, and no copy/erase functionality. A new file (which we may guess is called gateway_title_static) contains 3 new textures for this, a Start button, and textures for Please Select., Press A button to decide., Press B button to exit.. The Options screen is changed to remove the Dolby logo. After entering a name, the game starts immediately END is pressed. Other standard gateway-compliant changes (removing rumble capability, adding and enabling the pause/unpause code).

4/25/2023
Bitfields in IDO

Bitfields Bitfields are a stupid[^stupid] C optimisation to pack unaligned variables made of a small or odd number of bits. Their memory layout is unspecified, the notation looks like [^stupid]: See, e.g. https://lwn.net/Articles/478657/ struct example1 { u32 m1 : 1; u32 m2 : 4; u32 m3 : 7; };

4/7/2023
Characteristics of Nintendo 64 compiler output

Or: heuristics for distinguishing them. General compiler stuff IDO Unconditional branches use b. Float literals can be loaded with lui followed by mtc1 or from rodata with lui and lwc1. These can be reordered among other instructions in the function. (It seems to never use lui, ori, mtc1 but this needs to be verified) This is the only compiler where an instruction that isn't mfhi or mflo can follow a break 6. The expansion of division and modulus for ido in general allows for reorderings that the other compilers don't have, but this is the easiest to check.

12/16/2022
Read more from EllipticEllipsis
Published on HackMD