code_801323D0 (z_schedule) (#509)

* OK

* Initial documentation pass

* Pass 2. Add script by Tharo

* Renamed source file

* Documentation cleanup

* Update to latest master

* Feedback

* Bad merge

* Permissions

* Clang format

* Feedback

* format

* Use calculation instead of constant

* Rename as per suggestions

* Fix bss ordering and minor merge conflicts (from Maide)

* Update to current codebase and address feedback

* Fixup names to match new enums

* Format

* Fix duplicate include

* BSS shenanigans

6 files changed, 283 insertions, 45 deletions

diff --git a/src/code/code_801323D0.c b/src/code/code_801323D0.c
deleted file mode 100644
index 1457f537d..000000000
--- a/src/code/code_801323D0.c
+++ /dev/null
@@ -1,41 +0,0 @@
-#include "global.h"
-
-#pragma GLOBAL_ASM("asm/non_matchings/code/code_801323D0/func_801323D0.s")
-
-#pragma GLOBAL_ASM("asm/non_matchings/code/code_801323D0/func_80132428.s")
-
-#pragma GLOBAL_ASM("asm/non_matchings/code/code_801323D0/func_80132494.s")
-
-#pragma GLOBAL_ASM("asm/non_matchings/code/code_801323D0/func_801326B8.s")
-
-#pragma GLOBAL_ASM("asm/non_matchings/code/code_801323D0/func_801328F0.s")
-
-#pragma GLOBAL_ASM("asm/non_matchings/code/code_801323D0/func_80132920.s")
-
-#pragma GLOBAL_ASM("asm/non_matchings/code/code_801323D0/func_80132938.s")
-
-#pragma GLOBAL_ASM("asm/non_matchings/code/code_801323D0/func_80132954.s")
-
-#pragma GLOBAL_ASM("asm/non_matchings/code/code_801323D0/func_8013296C.s")
-
-#pragma GLOBAL_ASM("asm/non_matchings/code/code_801323D0/func_80132A18.s")
-
-#pragma GLOBAL_ASM("asm/non_matchings/code/code_801323D0/func_80132A3C.s")
-
-#pragma GLOBAL_ASM("asm/non_matchings/code/code_801323D0/func_80132A80.s")
-
-#pragma GLOBAL_ASM("asm/non_matchings/code/code_801323D0/func_80132AD8.s")
-
-#pragma GLOBAL_ASM("asm/non_matchings/code/code_801323D0/func_80132B24.s")
-
-#pragma GLOBAL_ASM("asm/non_matchings/code/code_801323D0/func_80132B84.s")
-
-#pragma GLOBAL_ASM("asm/non_matchings/code/code_801323D0/func_80132D70.s")
-
-#pragma GLOBAL_ASM("asm/non_matchings/code/code_801323D0/func_80132E9C.s")
-
-#pragma GLOBAL_ASM("asm/non_matchings/code/code_801323D0/func_80132FDC.s")
-
-#pragma GLOBAL_ASM("asm/non_matchings/code/code_801323D0/func_80133000.s")
-
-#pragma GLOBAL_ASM("asm/non_matchings/code/code_801323D0/func_80133038.s")
diff --git a/src/code/graph.c b/src/code/graph.c
index 128aa0ee4..28327c35f 100644
--- a/src/code/graph.c
+++ b/src/code/graph.c
@@ -1,4 +1,3 @@
-#include "prevent_bss_reordering.h"
 #include "global.h"
 #include "system_malloc.h"
 #include "overlays/gamestates/ovl_daytelop/z_daytelop.h"
diff --git a/src/code/z_bgcheck.c b/src/code/z_bgcheck.c
index 028f68011..f0ebe5911 100644
--- a/src/code/z_bgcheck.c
+++ b/src/code/z_bgcheck.c
@@ -1,4 +1,3 @@
-#include "prevent_bss_reordering.h"
 #include "global.h"
 #include "vt.h"
 
diff --git a/src/code/z_collision_check.c b/src/code/z_collision_check.c
index 4b7f48696..a08e3f822 100644
--- a/src/code/z_collision_check.c
+++ b/src/code/z_collision_check.c
@@ -1,4 +1,3 @@
-#include "prevent_bss_reordering.h"
 #include "global.h"
 
 Vec3f D_801EDE00;
diff --git a/src/code/z_demo.c b/src/code/z_demo.c
index 762be4538..c9c6253d3 100644
--- a/src/code/z_demo.c
+++ b/src/code/z_demo.c
@@ -1,4 +1,3 @@
-#include "prevent_bss_reordering.h"
 #include "global.h"
 #include "overlays/gamestates/ovl_daytelop/z_daytelop.h"
 
diff --git a/src/code/z_schedule.c b/src/code/z_schedule.c
new file mode 100644
index 000000000..4c57a57d4
--- /dev/null
+++ b/src/code/z_schedule.c
@@ -0,0 +1,283 @@
+#include "global.h"
+
+#define SCHEDULE_CALC_TIME(hour, minute, dest, temp) \
+    (temp) = (hour)*60.0f;                           \
+    (temp) += (minute);                              \
+    (dest) = (temp) * (0x10000 / 60 / 24.0f);        \
+    (dest) = SCHEDULE_CONVERT_TIME(dest);
+
+s32 Schedule_CheckFlagS(GlobalContext* globalCtx, u8** script, ScheduleResult* result) {
+    ScheduleCmdCheckFlagS* cmd = (ScheduleCmdCheckFlagS*)*script;
+    u16 flag = (cmd->flagByte << 8) | cmd->flagMask;
+
+    if (gSaveContext.save.weekEventReg[flag >> 8] & (flag & 0xFF)) {
+        *script += cmd->offset;
+    }
+
+    return false;
+}
+
+s32 Schedule_CheckFlagL(GlobalContext* globalCtx, u8** script, ScheduleResult* result) {
+    ScheduleCmdCheckFlagL* cmd = (ScheduleCmdCheckFlagL*)*script;
+    u16 flag = (cmd->flagByte << 8) | cmd->flagMask;
+
+    if (gSaveContext.save.weekEventReg[flag >> 8] & (flag & 0xFF)) {
+        *script += (s16)((cmd->offsetH << 8) | cmd->offsetL);
+    }
+
+    return false;
+}
+
+s32 Schedule_CheckTimeRangeS(GlobalContext* globalCtx, u8** script, ScheduleResult* result) {
+    s32 inRange = false;
+    ScheduleCmdCheckTimeRangeS* cmd = (ScheduleCmdCheckTimeRangeS*)*script;
+    f32 f;
+    u16 start;
+    u16 end;
+    u16 now;
+
+    SCHEDULE_CALC_TIME(cmd->startHr, cmd->startMin, start, f);
+
+    SCHEDULE_CALC_TIME(cmd->endHr, cmd->endMin, end, f);
+    end--;
+
+    now = SCHEDULE_TIME_NOW;
+
+    if ((start <= now) && (now <= end)) {
+        inRange = true;
+    }
+
+    if (inRange == true) {
+        *script += cmd->offset;
+    }
+
+    return false;
+}
+
+s32 Schedule_CheckTimeRangeL(GlobalContext* globalCtx, u8** script, ScheduleResult* result) {
+    s32 inRange = false;
+    ScheduleCmdCheckTimeRangeL* cmd = (ScheduleCmdCheckTimeRangeL*)*script;
+    f32 f;
+    u16 start;
+    u16 end;
+    u16 now;
+
+    SCHEDULE_CALC_TIME(cmd->startHr, cmd->startMin, start, f);
+
+    SCHEDULE_CALC_TIME(cmd->endHr, cmd->endMin, end, f);
+    end--;
+
+    now = SCHEDULE_TIME_NOW;
+
+    if ((start <= now) && (now <= end)) {
+        inRange = true;
+    }
+
+    if (inRange == true) {
+        *script += (s16)((cmd->offsetH << 8) | cmd->offsetL);
+    }
+
+    return false;
+}
+
+s32 Schedule_ReturnValueL(GlobalContext* globalCtx, u8** script, ScheduleResult* result) {
+    ScheduleCmdReturnValueL* cmd = (ScheduleCmdReturnValueL*)*script;
+
+    //! @bug result is a u8, value is truncated
+    result->result = (cmd->retH << 8) | cmd->retL;
+    result->hasResult = true;
+
+    return true;
+}
+
+s32 Schedule_ReturnNone(GlobalContext* globalCtx, u8** script, ScheduleResult* result) {
+    result->hasResult = false;
+
+    return true;
+}
+
+s32 Schedule_ReturnEmpty(GlobalContext* globalCtx, u8** script, ScheduleResult* result) {
+    result->hasResult = true;
+
+    return true;
+}
+
+s32 Schedule_Nop(GlobalContext* globalCtx, u8** script, ScheduleResult* result) {
+    return false;
+}
+
+s32 Schedule_CheckMiscS(GlobalContext* globalCtx, u8** script, ScheduleResult* result) {
+    ScheduleCmdCheckMiscS* cmd = (ScheduleCmdCheckMiscS*)*script;
+
+    if (((cmd->which == SCHEDULE_CHECK_MISC_ROOM_KEY) && (INV_CONTENT(ITEM_ROOM_KEY) == ITEM_ROOM_KEY)) ||
+        ((cmd->which == SCHEDULE_CHECK_MISC_LETTER_TO_KAFEI) &&
+         (INV_CONTENT(ITEM_LETTER_TO_KAFEI) == ITEM_LETTER_TO_KAFEI)) ||
+        ((cmd->which == SCHEDULE_CHECK_MISC_MASK_ROMANI) && (Player_GetMask(globalCtx) == PLAYER_MASK_ROMANI))) {
+        *script += cmd->offset;
+    }
+
+    return false;
+}
+
+s32 Schedule_ReturnValueS(GlobalContext* globalCtx, u8** script, ScheduleResult* result) {
+    ScheduleCmdReturnValueS* cmd = (ScheduleCmdReturnValueS*)*script;
+
+    result->result = cmd->result;
+    result->hasResult = true;
+
+    return true;
+}
+
+s32 Schedule_CheckNotInSceneS(GlobalContext* globalCtx, u8** script, ScheduleResult* result) {
+    ScheduleCmdCheckNotInSceneS* cmd = (ScheduleCmdCheckNotInSceneS*)*script;
+    s16 scene = (cmd->sceneH << 8) | cmd->sceneL;
+
+    if (scene != globalCtx->sceneNum) {
+        *script += cmd->offset;
+    }
+
+    return false;
+}
+
+s32 Schedule_CheckNotInSceneL(GlobalContext* globalCtx, u8** script, ScheduleResult* result) {
+    ScheduleCmdCheckNotInSceneL* cmd = (ScheduleCmdCheckNotInSceneL*)*script;
+    s16 scene = (cmd->sceneH << 8) | cmd->sceneL;
+
+    if (scene != globalCtx->sceneNum) {
+        *script = *script + (s16)((cmd->offsetH << 8) | cmd->offsetL);
+    }
+
+    return false;
+}
+
+s32 Schedule_CheckNotInDayS(GlobalContext* globalCtx, u8** script, ScheduleResult* result) {
+    ScheduleCmdCheckNotInDayS* cmd = (ScheduleCmdCheckNotInDayS*)*script;
+    s16 day = (cmd->dayH << 8) | cmd->dayL;
+
+    if (day != (s16)gSaveContext.save.day) {
+        *script += cmd->offset;
+    }
+
+    return false;
+}
+
+s32 Schedule_CheckNotInDayL(GlobalContext* globalCtx, u8** script, ScheduleResult* result) {
+    ScheduleCmdCheckNotInDayL* cmd = (ScheduleCmdCheckNotInDayL*)*script;
+    s16 day = (cmd->dayH << 8) | cmd->dayL;
+
+    if (day != (s16)gSaveContext.save.day) {
+        *script += (s16)((cmd->offsetH << 8) | cmd->offsetL);
+    }
+
+    return false;
+}
+
+s32 Schedule_ReturnTime(GlobalContext* globalCtx, u8** script, ScheduleResult* result) {
+    ScheduleCmdReturnTime* cmd = (ScheduleCmdReturnTime*)*script;
+    f32 f;
+    u16 time0;
+    u16 time1;
+
+    SCHEDULE_CALC_TIME(cmd->time0Hr, cmd->time0Min, time0, f);
+
+    SCHEDULE_CALC_TIME(cmd->time1Hr, cmd->time1Min, time1, f);
+    time1--;
+
+    result->result = cmd->result;
+    result->time0 = time0;
+    result->time1 = time1;
+    result->hasResult = true;
+
+    return true;
+}
+
+s32 Schedule_CheckBeforeTimeS(GlobalContext* globalCtx, u8** script, ScheduleResult* result) {
+    ScheduleCmdCheckBeforeTimeS* cmd = (ScheduleCmdCheckBeforeTimeS*)*script;
+    f32 f;
+    u16 testTime;
+    u16 now;
+
+    SCHEDULE_CALC_TIME(cmd->timeHr, cmd->timeMin, testTime, f);
+
+    now = SCHEDULE_TIME_NOW;
+
+    if (now < testTime) {
+        *script += cmd->offset;
+    }
+
+    return false;
+}
+
+s32 Schedule_CheckBeforeTimeL(GlobalContext* globalCtx, u8** script, ScheduleResult* result) {
+    ScheduleCmdCheckBeforeTimeL* cmd = (ScheduleCmdCheckBeforeTimeL*)*script;
+    f32 f;
+    u16 testTime;
+    u16 now;
+
+    SCHEDULE_CALC_TIME(cmd->timeHr, cmd->timeMin, testTime, f);
+
+    now = SCHEDULE_TIME_NOW;
+
+    if (now < testTime) {
+        *script += (s16)((cmd->offsetH << 8) | cmd->offsetL);
+    }
+
+    return false;
+}
+
+s32 Schedule_BranchS(GlobalContext* globalCtx, u8** script, ScheduleResult* result) {
+    ScheduleCmdBranchS* cmd = (ScheduleCmdBranchS*)*script;
+
+    *script += cmd->offset;
+    return false;
+}
+
+s32 Schedule_BranchL(GlobalContext* globalCtx, u8** script, ScheduleResult* result) {
+    ScheduleCmdBranchL* cmd = (ScheduleCmdBranchL*)*script;
+
+    *script += (s16)((cmd->offsetH << 8) | cmd->offsetL);
+    return false;
+}
+
+static s32 (*sScheduleCmdFuncs[])(GlobalContext*, u8**, ScheduleResult*) = {
+    Schedule_CheckFlagS,       Schedule_CheckFlagL,     Schedule_CheckTimeRangeS,  Schedule_CheckTimeRangeL,
+    Schedule_ReturnValueL,     Schedule_ReturnNone,     Schedule_ReturnEmpty,      Schedule_Nop,
+    Schedule_CheckMiscS,       Schedule_ReturnValueS,   Schedule_CheckNotInSceneS, Schedule_CheckNotInSceneL,
+    Schedule_CheckNotInDayS,   Schedule_CheckNotInDayL, Schedule_ReturnTime,       Schedule_CheckBeforeTimeS,
+    Schedule_CheckBeforeTimeL, Schedule_BranchS,        Schedule_BranchL,
+};
+
+static u8 sScheduleCmdSizes[] = {
+    sizeof(ScheduleCmdCheckFlagS),
+    sizeof(ScheduleCmdCheckFlagL),
+    sizeof(ScheduleCmdCheckTimeRangeS),
+    sizeof(ScheduleCmdCheckTimeRangeL),
+    sizeof(ScheduleCmdReturnValueL),
+    sizeof(ScheduleCmdBase),
+    sizeof(ScheduleCmdBase),
+    sizeof(ScheduleCmdNop),
+    sizeof(ScheduleCmdCheckMiscS),
+    sizeof(ScheduleCmdReturnValueS),
+    sizeof(ScheduleCmdCheckNotInSceneS),
+    sizeof(ScheduleCmdCheckNotInSceneL),
+    sizeof(ScheduleCmdCheckNotInDayS),
+    sizeof(ScheduleCmdCheckNotInDayL),
+    sizeof(ScheduleCmdReturnTime),
+    sizeof(ScheduleCmdCheckBeforeTimeS),
+    sizeof(ScheduleCmdCheckBeforeTimeL),
+    sizeof(ScheduleCmdBranchS),
+    sizeof(ScheduleCmdBranchL),
+};
+
+s32 Schedule_RunScript(GlobalContext* globalCtx, u8* script, ScheduleResult* result) {
+    u8 size;
+    s32 stop;
+
+    do {
+        size = sScheduleCmdSizes[*script];
+        stop = (*sScheduleCmdFuncs[*script])(globalCtx, &script, result);
+        script += size;
+    } while (!stop);
+
+    return result->hasResult;
+}