Initial commit

1 files changed, 102 insertions, 0 deletions

diff --git a/Source/System.h b/Source/System.h
new file mode 100755
index 0000000..cbb22ea
--- /dev/null
+++ b/Source/System.h
@@ -0,0 +1,102 @@
+#ifndef __SYSTEM_HEADER__
+#define __SYSTEM_HEADER__
+
+/* **************************************
+ * 	Includes							*							
+ * **************************************/
+
+#include "Global_Inc.h"
+#include "Menu.h"
+#include "Gfx.h"
+#include "MemCard.h"
+
+/* **************************************
+ * 	Defines								*
+ * **************************************/
+
+#define TIMEBASE_1_SECOND	REFRESH_FREQUENCY
+#define TIMEBASE_1_MINUTE	TIMEBASE_1_SECOND * 60
+
+/* **************************************
+ * 	Global Prototypes					*
+ * **************************************/
+
+// Calls PSXSDK init routines
+void SystemInit(void);
+// Sets default VSync (only sets flag to true and increases global_timer)
+void ISR_SystemDefaultVBlank(void);
+// Calls srand() using current global_timer value as seed
+void SystemSetRandSeed(void);
+// Returns VSync flag value
+bool SystemRefreshNeeded(void);
+// Tells whether CPU->GPU DMA transfer is ready
+bool SystemDMAReady(void);
+// Tells whether CPU->GPU DMA transfer is busy
+bool SystemDMABusy(void);
+// Loads a file into system's internal buffer
+bool SystemLoadFile(char *fname);
+// Loads a file into desired buffer
+bool SystemLoadFileToBuffer(char * fname, uint8_t * buffer, uint32_t szBuffer);
+// Clears VSync flag after each frame
+void SystemDisableScreenRefresh(void);
+// Returns file buffer address
+uint8_t * SystemGetBufferAddress(void);
+// Tells whether srand() has been called using a pseudo-random value
+bool SystemIsRandSeedSet(void);
+// Stops program flow during X cycles
+void SystemWaitCycles(uint32_t cycles);
+// To be called from GfxDrawScene after each cycle
+void SystemRunTimers(void);
+// 1 cycle-length flag with a frequency of 1 Hz
+bool System1SecondTick(void);
+// 1 cycle-length flag with a frequency of 2 Hz
+bool System500msTick(void);
+// 1 cycle-length flag with a frequency of 10 Hz
+bool System100msTick(void);
+// Returns random value between given minimum and maximum values
+uint32_t SystemRand(uint32_t min, uint32_t max);
+// Increases global timer by 1 step
+void SystemIncreaseGlobalTimer(void);
+// Sets value to emergency mode flag
+void SystemSetEmergencyMode(bool value);
+// Returns emergency mode flag state
+bool SystemGetEmergencyMode(void);
+// (Experimental)
+uint64_t SystemGetGlobalTimer(void);
+// Returns whether critical section of code is being entered
+bool SystemIsBusy(void);
+// Returns whether indicated value is contained inside buffer
+bool SystemContains_u8(uint8_t value, uint8_t * buffer, size_t sz);
+// Overload for uint16_t
+bool SystemContains_u16(uint16_t value, uint16_t * buffer, size_t sz);
+// Creates a timer instance wiht a determined value and associates it to a callback
+// Once time expires, callback is automatically called right after GfxDrawScene().
+TYPE_TIMER * SystemCreateTimer(uint32_t seconds, bool rf, void (*timer_callback)(void) );
+// Reportedly, sets all timer data to zero.
+void SystemResetTimers(void);
+// To be called every cycle (i.e.: inside GfxDrawScene() ).
+void SystemUserTimersHandler(void);
+// Sets timer remaining time to initial value.
+void SystemTimerRestart(TYPE_TIMER * timer);
+// Flushes a timer pointed to by timer.
+void SystemTimerRemove(TYPE_TIMER * timer);
+// Compares two arrays of unsigned short type.
+bool SystemArrayCompare(unsigned short * arr1, unsigned short * arr2, size_t sz);
+// Prints stack pointer address using dprintf()
+void SystemPrintStackPointerAddress(void);
+// Checks if a 32-bit pattern set at the end of the stack has been
+// accidentally modified by program flow.
+void SystemCheckStack(void);
+// Looks for string "str" inside a string array pointed to by "array".
+// Returns index inside string array on success, -1 if not found.
+int32_t SystemIndexOfStringArray(char * str, char ** array);
+// Function overload for uint16_t data type.
+int32_t SystemIndexOf_U16(uint16_t value, uint16_t * array, uint32_t sz);
+// Function overload for uint8_t data type.
+int32_t SystemIndexOf_U8(uint8_t value, uint8_t * array, uint32_t from, uint32_t sz);
+
+/* **************************************
+ * 	Global Variables					*	
+ * **************************************/
+
+#endif //__SYSTEM_HEADER__