ARM9 OS - Revision history

Hallowizer: /* Threads */ kernelSp is a system stack used for thread cleanup and SVCs

2022-10-09T18:47:07Z

Threads: kernelSp is a system stack used for thread cleanup and SVCs

2022-10-09T00:45:26Z

Threads: updated unknown fields

← Older revision		Revision as of 04:45, 9 October 2022
Line 47:		Line 47:
	void *stackLo; // 0x90		void *stackLo; // 0x90
	void *stackHi; // 0x94		void *stackHi; // 0x94
	~~u32~~ unknown2; // 0x98		void *unknown2; // 0x98
	struct OSThreadQueue queueJoin; // 0x9c		struct OSThreadQueue queueJoin; // 0x9c
	u32 unknown3[3]; // 0xa4		u32 unknown3[3]; // 0xa4
	struct OSAlarm *timedSleepAlarm; // 0xb0		struct OSAlarm *timedSleepAlarm; // 0xb0
	u32 ~~unknown4~~; // 0xb4		void (*cleanupFunc)(u32 res); // 0xb4
			u32 unknown4[2];
	}		}

2022-08-15T02:41:10Z

added an interrupt section

← Older revision		Revision as of 06:41, 15 August 2022
Line 114:		Line 114:
	}		}
	</pre>		</pre>

			== Interrupts ==
			The interrupt handler called by the [[ARM9 BIOS]] calls a handler in a table mapping the raw IRQ IDs to handlers. Each handler is either a no-op (not listed in the table below) or a stub that calls <code>__OSDispatchInterrupt</code> with an OS interrupt ID. <code>__OSDispatchInterrupt</code> then calls the handler registered with <code>__OSSetInterruptHandler</code>.

			{\| class="wikitable sortable"
			! Hardware ID
			! Translated ID
			! Name
			\|-
			\| 3
			\| 8
			\| Timer 0 overflow
			\|-
			\| 4
			\| 9
			\| Timer 1 overflow
			\|-
			\| 5
			\| 10
			\| Timer 2 overflow
			\|-
			\| 6
			\| 11
			\| Timer 3 overflow
			\|-
			\| 8
			\| 0
			\| DMA 0
			\|-
			\| 9
			\| 1
			\| DMA 1
			\|-
			\| 10
			\| 2
			\| DMA 2
			\|-
			\| 11
			\| 3
			\| DMA 3
			\|-
			\| 28
			\| 4
			\| New DMA 0
			\|-
			\| 29
			\| 5
			\| New DMA 1
			\|-
			\| 30
			\| 6
			\| New DMA 2
			\|-
			\| 31
			\| 7
			\| New DMA 3
			\|}

2022-08-15T02:18:23Z

Time: made a mistake in my labels which led to incorrect info about timers 2 and 3

← Older revision		Revision as of 06:18, 15 August 2022
Line 94:		Line 94:

	== Time ==		== Time ==
	~~Time~~ is ~~kept with timers 2 and 3~~, while ~~alarm interrupts are handled by~~ timer 1~~; timer 0~~ is ~~presumably reserved~~ for ~~the DMA sound channels~~. The OS orders the alarms by alert time, so that it only needs to keep track of the frontmost alarm.		Timer 0 is used to keep track of global time by manually incrementing a global, while timer 1 is used to generate an interrupt for alarms. The OS orders the alarms by alert time, so that it only needs to keep track of the frontmost alarm.

	<pre>		<pre>

2022-08-01T00:10:59Z

Threads: remove some extra unknown fields that are part of structs

← Older revision		Revision as of 04:10, 1 August 2022
Line 43:		Line 43:
	struct OSThreadQueue *queue; // 0x78		struct OSThreadQueue *queue; // 0x78
	struct OSThreadLink linkQueue; // 0x7c		struct OSThreadLink linkQueue; // 0x7c
	~~u32 unknown2; // 0x80~~
	struct OSMutex *mutex; // 0x84 - set to the mutex the thread is currently trying to lock		struct OSMutex *mutex; // 0x84 - set to the mutex the thread is currently trying to lock
	struct OSMutexQueue queueMutex; // 0x88		struct OSMutexQueue queueMutex; // 0x88
	~~u32 unknown3; // 0x8c~~
	void *stackLo; // 0x90		void *stackLo; // 0x90
	void *stackHi; // 0x94		void *stackHi; // 0x94
	u32 ~~unknown4~~; // 0x98		u32 unknown2; // 0x98
	struct OSThreadQueue queueJoin; // 0x9c		struct OSThreadQueue queueJoin; // 0x9c
	u32 ~~unknown5~~[3]; // 0xa4		u32 unknown3[3]; // 0xa4
	struct OSAlarm *timedSleepAlarm; // 0xb0		struct OSAlarm *timedSleepAlarm; // 0xb0
	u32 ~~unknown6~~; // 0xb4		u32 unknown4; // 0xb4
	}		}

2022-08-01T00:01:20Z

Threads: added stackLo and stackHi

← Older revision		Revision as of 04:01, 1 August 2022
Line 46:		Line 46:
	struct OSMutex *mutex; // 0x84 - set to the mutex the thread is currently trying to lock		struct OSMutex *mutex; // 0x84 - set to the mutex the thread is currently trying to lock
	struct OSMutexQueue queueMutex; // 0x88		struct OSMutexQueue queueMutex; // 0x88
	u32 unknown3~~[4]~~; // 0x8c		u32 unknown3; // 0x8c
			void *stackLo; // 0x90
			void *stackHi; // 0x94
			u32 unknown4; // 0x98
	struct OSThreadQueue queueJoin; // 0x9c		struct OSThreadQueue queueJoin; // 0x9c
	u32 ~~unknown4~~[3]; // 0xa4		u32 unknown5[3]; // 0xa4
	struct OSAlarm *timedSleepAlarm; // 0xb0		struct OSAlarm *timedSleepAlarm; // 0xb0
	u32 ~~unknown5~~; // 0xb4		u32 unknown6; // 0xb4
	}		}

2022-07-27T03:01:59Z

Threads: apparently those "fp" registers are for integers

← Older revision		Revision as of 07:01, 27 July 2022
Line 4:		Line 4:
	The scheduler only runs the thread with the highest priority, and does not switch between threads if two threads have the same priority. Because of this, rescheduling only happens when a thread-related function is called and the thread with the highest priority can no longer run.		The scheduler only runs the thread with the highest priority, and does not switch between threads if two threads have the same priority. Because of this, rescheduling only happens when a thread-related function is called and the thread with the highest priority can no longer run.
	<pre>		<pre>
	struct ~~OSFpContext~~ {		struct OSMathContext {
	~~f64~~ REG_DIV_NUMER; // 0x0		u64 REG_DIV_NUMER; // 0x0
	~~f64~~ REG_DIV_DENOM; // 0x8		u64 REG_DIV_DENOM; // 0x8
	~~f64~~ SQRT_PARAM; // 0x10		u64 SQRT_PARAM; // 0x10
	u16 REG_DIVCNT; // 0x18		u16 REG_DIVCNT; // 0x18
	u16 REG_SQRTCNT; // 0x1a		u16 REG_SQRTCNT; // 0x1a
Line 31:		Line 31:
	void *pc; // 0x40		void *pc; // 0x40
	void *kernelSp; // 0x44		void *kernelSp; // 0x44
	struct ~~OSFpContext fp~~; // 0x48		struct OSMathContext math; // 0x48
	}		}

2022-07-18T01:44:48Z

Threads: added timedSleepAlarm

← Older revision		Revision as of 05:44, 18 July 2022
Line 48:		Line 48:
	u32 unknown3[4]; // 0x8c		u32 unknown3[4]; // 0x8c
	struct OSThreadQueue queueJoin; // 0x9c		struct OSThreadQueue queueJoin; // 0x9c
	// ~~more unknown fields - the total length is not known~~		u32 unknown4[3]; // 0xa4
			struct OSAlarm *timedSleepAlarm; // 0xb0
			u32 unknown5; // 0xb4
	}		}

2022-07-18T01:27:55Z

added a section on time

← Older revision		Revision as of 05:27, 18 July 2022
Line 89:		Line 89:
	== Memory allocation ==		== Memory allocation ==
	3 types of heaps exist: EXPH (exponential heap), FRMH (frame heap), and UNTH (unit heap).		3 types of heaps exist: EXPH (exponential heap), FRMH (frame heap), and UNTH (unit heap).

			== Time ==
			Time is kept with timers 2 and 3, while alarm interrupts are handled by timer 1; timer 0 is presumably reserved for the DMA sound channels. The OS orders the alarms by alert time, so that it only needs to keep track of the frontmost alarm.

			<pre>
			struct OSAlarm {
			void (handler)(void userData);
			void *userData;
			u32 unknown;
			u64 alertTime;
			struct OSAlarm *prev;
			struct OSAlarm *next;
			u64 repeatInterval; // 0 for non-repeating alarms
			u64 repeatStart; // undefined value for non-repeating alarms
			}

			struct OSAlarmQueue {
			u32 unknown;
			struct OSAlarm *head;
			struct OSAlarm *tail;
			}
			</pre>

2022-07-14T21:57:11Z

Threads: added queueJoin

← Older revision		Revision as of 01:57, 15 July 2022
Line 46:		Line 46:
	struct OSMutex *mutex; // 0x84 - set to the mutex the thread is currently trying to lock		struct OSMutex *mutex; // 0x84 - set to the mutex the thread is currently trying to lock
	struct OSMutexQueue queueMutex; // 0x88		struct OSMutexQueue queueMutex; // 0x88
			u32 unknown3[4]; // 0x8c
			struct OSThreadQueue queueJoin; // 0x9c
	// more unknown fields - the total length is not known		// more unknown fields - the total length is not known
	}		}