WiiUBrew

Changes

Cafe OS (view source)

Revision as of 14:06, 25 January 2025

7,174 bytes added ,  25 January
→‎ReadRegister32Ex: describe other legacy register blocks
Line 1: Line 1:  
Cafe OS is the operating system running on the PowerPC in Wii U mode. It consists of the Cafe OS kernel, the executable loader, and system libraries. Unlike on the Wii, where each game provided its own copy of [https://wiibrew.org/wiki/Revolution_OS Revolution OS] with no isolation between libraries, Wii U applications run under the supervision of a common PowerPC kernel, isolating them from each other. All applications are [[RPL|modified ELFs]], as are the libraries themselves, and applications dynamically link with them to gain access to OS services. Cafe OS also contains a few system processes, like the home menu and error handler.
 
Cafe OS is the operating system running on the PowerPC in Wii U mode. It consists of the Cafe OS kernel, the executable loader, and system libraries. Unlike on the Wii, where each game provided its own copy of [https://wiibrew.org/wiki/Revolution_OS Revolution OS] with no isolation between libraries, Wii U applications run under the supervision of a common PowerPC kernel, isolating them from each other. All applications are [[RPL|modified ELFs]], as are the libraries themselves, and applications dynamically link with them to gain access to OS services. Cafe OS also contains a few system processes, like the home menu and error handler.
   −
== Kernel ==
+
= Kernel =
 
The kernel runs in supervisor mode on the PowerPC, and performs the basic tasks of a microkernel. It is responsible for process isolation, memory management, and interrupt dispatching, as well as communication with [[IOSU]]. Cafe OS applications run as user mode processes, with separate address spaces and W^X memory protection.
 
The kernel runs in supervisor mode on the PowerPC, and performs the basic tasks of a microkernel. It is responsible for process isolation, memory management, and interrupt dispatching, as well as communication with [[IOSU]]. Cafe OS applications run as user mode processes, with separate address spaces and W^X memory protection.
   −
=== Syscalls ===
+
== Syscalls ==
 
Cafe OS syscalls are issued by doing the following:
 
Cafe OS syscalls are issued by doing the following:
 
  li r0, 0x0100 # load syscall value->r0
 
  li r0, 0x0100 # load syscall value->r0
Line 29: Line 29:  
! scope="col" style="width: 24px;" | Ldr
 
! scope="col" style="width: 24px;" | Ldr
 
|-
 
|-
−
| 0x0000 || ConsoleWrite || X || X || X || X (sp)
+
| 0x0 || ConsoleWrite || X || X || X || X (sp)
 
|-
 
|-
−
| 0x0100 || AppPanic || X || X || X || X
+
| 0x100 || AppPanic || X || X || X || X
 
|-
 
|-
−
| 0x0200 || EffectiveToPhysical || X || X || X ||  
+
| 0x200 || EffectiveToPhysical || X || X || X ||  
 
|-
 
|-
−
| 0x0300 || PhysicalToEffectiveCached || X || X || X ||  
+
| 0x300 || PhysicalToEffectiveCached || X || X || X ||  
 
|-
 
|-
−
| 0x0400 || PhysicalToEffectiveUncached || X || X || X ||  
+
| 0x400 || PhysicalToEffectiveUncached || X || X || X ||  
 
|-
 
|-
−
| 0x0500 || ValidateAddrRange || X || X || X || X
+
| 0x500 || ValidateAddressSpaceRange || X || X || X || X
 
|-
 
|-
−
| 0x0600 || UpdateCoreTime || X || X || X ||  
+
| 0x600 || UpdateCoretime || X || X || X ||  
 
|-
 
|-
−
| 0x0800 || SetUserModeExHandler || X || X || X ||  
+
| 0x700 || - || - || - || - || -
 
|-
 
|-
−
| 0x0B00 || AllocateTimer || X || X || X ||  
+
| 0x800 || SetUserModeExHandler || X || X || X ||  
 
|-
 
|-
−
| 0x0C00 || FreeTimer || X || X || X ||  
+
| 0x900 || - || - || - || - || -
 
|-
 
|-
−
| 0x0D00 || PrimeTimer || X || X || X ||  
+
| 0xA00 || - || - || - || - || -
 
|-
 
|-
−
| 0x0E00 || StopTimer || X || X || X ||  
+
| 0xB00 || AllocateTimer || X || X || X ||  
 
|-
 
|-
−
| 0x0F00 || DumpModuleList || X || X || X ||  
+
| 0xC00 || FreeTimer || X || X || X ||
 +
|-
 +
| 0xD00 || PrimeTimer || X || X || X ||
 +
|-
 +
| 0xE00 || StopTimer || X || X || X ||
 +
|-
 +
| 0xF00 || DynLoad_DumpModuleList || X || X || X ||  
 
|-
 
|-
 
| 0x1000 || SetInterruptHandler || X || X || X ||  
 
| 0x1000 || SetInterruptHandler || X || X || X ||  
Line 71: Line 77:  
| 0x1700 || FindClosestSymbol || X || X || X || X (sp)
 
| 0x1700 || FindClosestSymbol || X || X || X || X (sp)
 
|-
 
|-
−
| 0x1900 || Exit/Halt || X || X || X ||  
+
| 0x1800 || Test_Assist ||  ||  ||  ||
 +
|-
 +
| 0x1900 || Exit || X || X || X ||  
 
|-
 
|-
 
| 0x1A00 || GetInfo || X || X || X ||  
 
| 0x1A00 || GetInfo || X || X || X ||  
Line 86: Line 94:  
|-
 
|-
 
| 0x2000 || IPCKDriver_SubmitRequest || X || X || X || X (sp)
 
| 0x2000 || IPCKDriver_SubmitRequest || X || X || X || X (sp)
 +
|-
 +
| 0x2100 || - || - || - || - || -
 
|-
 
|-
 
| 0x2200 || GetEnvironmentVariable || X || X || X ||  
 
| 0x2200 || GetEnvironmentVariable || X || X || X ||  
 
|-
 
|-
−
| 0x2700 || GetNotifyTarget || X || X || X ||  
+
| 0x2300 || - || - || - || - || -
 +
|-
 +
| 0x2400 || - || - || - || - || -
 +
|-
 +
| 0x2500 || - || - || - || - || -
 +
|-
 +
| 0x2600 || - || - || - || - || -
 +
|-
 +
| 0x2700 || Proc_GetNotifyTarget || X || X || X ||  
 
|-
 
|-
−
| 0x2800 || ReleaseForeground || X || X || X ||  
+
| 0x2800 || Proc_ReleaseForeground || X || X || X ||  
 
|-
 
|-
−
| 0x2900 || GetForegroundBucket || X || X || X ||  
+
| 0x2900 || Proc_GetForegroundBucket || X || X || X ||  
 
|-
 
|-
−
| 0x2A00 || RequestSwitch || X || X || X ||  
+
| 0x2A00 || Proc_RequestSwitch || X || X || X ||  
 
|-
 
|-
 
| 0x2B00 || LaunchTitleArgvStr || X || X || X ||  
 
| 0x2B00 || LaunchTitleArgvStr || X || X || X ||  
 
|-
 
|-
−
| 0x2C00 || ProcYield || X || X || X ||  
+
| 0x2C00 || Proc_YieldCore || X || X || X ||  
 +
|-
 +
| 0x2D00 || - || - || - || - || -
 
|-
 
|-
−
| 0x2E00 || GetSystemMessage || X || X || X ||  
+
| 0x2E00 || Proc_GetSystemMessage || X || X || X ||  
 
|-
 
|-
−
| 0x2F00 || GetCallArgs || X || X || X ||  
+
| 0x2F00 || Proc_GetCallArgs || X || X || X ||  
 
|-
 
|-
 
| 0x3000 || GetAbsoluteSystemTimeInternal || X || X || X ||  
 
| 0x3000 || GetAbsoluteSystemTimeInternal || X || X || X ||  
Line 109: Line 129:  
| 0x3100 || SetAbsoluteSystemTimeInternal || X || X || X ||  
 
| 0x3100 || SetAbsoluteSystemTimeInternal || X || X || X ||  
 
|-
 
|-
−
| 0x3200 || Driver_Register || X || X || X ||  
+
| 0x3200 || Drivers_GetInstance || X || X || X ||  
 
|-
 
|-
−
| 0x3300 || Driver_Deregister || X || X || X ||  
+
| 0x3300 || Drivers_PurgeMaster || X || X || X ||  
 +
|-
 +
| 0x3400 || - || - || - || - || -
 +
|-
 +
| 0x3500 || - || - || - || - || -
 +
|-
 +
| 0x3600 || - || - || - || - || -
 +
|-
 +
| 0x3700 || - || - || - || - || -
 
|-
 
|-
 
| 0x3800 || AllocVirtAddr || X || X || X ||  
 
| 0x3800 || AllocVirtAddr || X || X || X ||  
Line 137: Line 165:  
| 0x4300 || LogRetrieve || X || X || X || X
 
| 0x4300 || LogRetrieve || X || X || X || X
 
|-
 
|-
−
| 0x4400 || (unknown) || X || X || X ||  
+
| 0x4400 || LoadUserContext || X || X || X ||  
 
|-
 
|-
−
| 0x4500 || (unknown) || X || X || X ||  
+
| 0x4500 || FlushUserContext || X || X || X ||  
 
|-
 
|-
−
| 0x4600 || save_fpu || X || X || X ||  
+
| 0x4600 || FlushUserFPUContext || X || X || X ||  
 
|-
 
|-
−
| 0x4700 || Driver_CopyFromSaveArea || X || X || X ||  
+
| 0x4700 || Drivers_CopyFromSaveArea || X || X || X ||  
 
|-
 
|-
−
| 0x4800 || Driver_CopyToSaveArea || X || X || X ||  
+
| 0x4800 || Drivers_CopyToSaveArea || X || X || X ||  
 
|-
 
|-
−
| 0x4900 || SavesDone_ReadyToRelease || X || X || X ||  
+
| 0x4900 || Proc_ReadyToRelease || X || X || X ||  
 
|-
 
|-
−
| 0x4A00 || SetAlarm || X || X || X ||  
+
| 0x4A00 || FlushInterrupts || X || X || X ||  
 
|-
 
|-
 
| 0x4B00 || SetDABR || X || X || X ||  
 
| 0x4B00 || SetDABR || X || X || X ||  
Line 155: Line 183:  
| 0x4C00 || SetIABR || X || X || X ||  
 
| 0x4C00 || SetIABR || X || X || X ||  
 
|-
 
|-
−
| 0x4D00 || GetProcessInfo || X || X || X ||  
+
| 0x4D00 || Proc_GetProcessInfo || X || X || X ||  
 
|-
 
|-
 
| 0x4E00 || GetCodegenVirtAddrRange || X || X || X ||  
 
| 0x4E00 || GetCodegenVirtAddrRange || X || X || X ||  
 
|-
 
|-
−
| 0x4F00 || LoaderCall || X || X || X ||  
+
| 0x4F00 || DynLoad_RPLLoaderEntry || X || X || X ||  
 
|-
 
|-
 
| 0x5000 || RPLLoaderResumeContext ||  ||  ||  || X
 
| 0x5000 || RPLLoaderResumeContext ||  ||  ||  || X
 +
|-
 +
| 0x5100 || - || - || - || - || -
 
|-
 
|-
 
| 0x5200 || WaitIopComplete ||  ||  ||  || X
 
| 0x5200 || WaitIopComplete ||  ||  ||  || X
Line 177: Line 207:  
| 0x5800 || GetBusClockSpeed ||  ||  ||  || X
 
| 0x5800 || GetBusClockSpeed ||  ||  ||  || X
 
|-
 
|-
−
| 0x5900 || GetSharedArea || X || X || X ||  
+
| 0x5900 || Shared_GetArea || X || X || X ||  
 
|-
 
|-
−
| 0x5A00 || SendPolicy || X || X || X ||  
+
| 0x5A00 || Proc_SendPolicy || X || X || X ||  
 
|-
 
|-
 
| 0x5B00 || GetProcessIndex ||  ||  ||  || X
 
| 0x5B00 || GetProcessIndex ||  ||  ||  || X
Line 185: Line 215:  
| 0x5C00 || IPCKDriver_PollLoaderCompletion ||  ||  ||  || X
 
| 0x5C00 || IPCKDriver_PollLoaderCompletion ||  ||  ||  || X
 
|-
 
|-
−
| 0x5D00 || BlockLogSave || X || X || X ||  
+
| 0x5D00 || BlockLogSaveHiLo || X || X || X ||  
 
|-
 
|-
−
| 0x5E00 || FinishInitandPreload ||  ||  ||  || X
+
| 0x5E00 || FinishInitAndPreload ||  ||  ||  || X
 
|-
 
|-
 
| 0x5F00 || ContinueStartProcess ||  ||  ||  || X
 
| 0x5F00 || ContinueStartProcess ||  ||  ||  || X
Line 193: Line 223:  
| 0x6000 || OpenMCP ||  ||  ||  || X
 
| 0x6000 || OpenMCP ||  ||  ||  || X
 
|-
 
|-
−
| 0x6100 || QuerySwitchReady || X || X || X ||  
+
| 0x6100 || Proc_QuerySwitchReady || X || X || X ||  
 
|-
 
|-
−
| 0x6200 || launch_title || X || X || X ||  
+
| 0x6200 || Launch || X || X || X ||  
 
|-
 
|-
−
| 0x6300 || call_title || X || X || X ||  
+
| 0x6300 || Call || X || X || X ||  
 
|-
 
|-
 
| 0x6400 || SetTimeInternal ||  || X ||  ||  
 
| 0x6400 || SetTimeInternal ||  || X ||  ||  
 
|-
 
|-
−
| 0x6500 || do_nothing (blr) || X || X || X ||  
+
| 0x6500 || || X || X || X ||  
 +
|-
 +
| 0x6600 || ProfileEntry ||  ||  ||  || X
 
|-
 
|-
−
| 0x6600 || ProfileEntry (blr) || || || || X
+
| 0x6700 || Proc_RequestExit || X || X || X ||  
 
|-
 
|-
−
| 0x6700 || RequestFastExit || X || X || X ||  
+
| 0x6800 || Proc_CoreInitDone || X || X || X ||  
 
|-
 
|-
−
| 0x6800 || CoreInitDone || X || X || X ||  
+
| 0x6900 || Proc_GetSwitchTarget || X || X || X ||  
 
|-
 
|-
−
| 0x6900 || GetSwitchTarget || X || X || X ||  
+
| 0x6A00 || Proc_AcquireDone || X || X || X ||  
 
|-
 
|-
−
| 0x6A00 || AcquireDone || X || X || X ||  
+
| 0x6B00 || Proc_GetBuiltSDKVersion || X || X || X ||  
 
|-
 
|-
−
| 0x6B00 || GetBuiltSDKVersion || X || X || X ||  
+
| 0x6C00 || Proc_SystemFatal || X || X || X ||  
 
|-
 
|-
−
| 0x6C00 || SystemFatal || X || X || X ||  
+
| 0x6D00 || - || - || - || - || -
 
|-
 
|-
 
| 0x6E00 || SwitchSecCodeGenMode || X || X || X ||  
 
| 0x6E00 || SwitchSecCodeGenMode || X || X || X ||  
Line 221: Line 253:  
| 0x6F00 || IopShell_RegisterCallback || X || X || X ||  
 
| 0x6F00 || IopShell_RegisterCallback || X || X || X ||  
 
|-
 
|-
−
| 0x7000 || GetTitleVersion || X || X || X ||  
+
| 0x7000 || Proc_GetTitleVersion || X || X || X ||  
 
|-
 
|-
−
| 0x7100 || IsTestKernel || X || X || X ||  
+
| 0x7100 || Proc_IsTestKernel || X || X || X ||  
 
|-
 
|-
 
| 0x7200 || ForceFullRelaunch || X || X || X ||  
 
| 0x7200 || ForceFullRelaunch || X || X || X ||  
 
|-
 
|-
−
| 0x7300 || Recycle || X ||  ||  ||  
+
| 0x7300 || Proc_Recycle || X ||  ||  ||  
 
|-
 
|-
−
| 0x7400 || get_mode_flags || X || X || X || X
+
| 0x7400 || GetFlags || X || X || X || X
 
|-
 
|-
 
| 0x7500 || QueryVirtAddr || X || X || X ||  
 
| 0x7500 || QueryVirtAddr || X || X || X ||  
 
|-
 
|-
−
| 0x7600 || GetCodegenCore || X || X || X ||  
+
| 0x7600 || GetCodegenInfo || X || X || X ||  
 
|-
 
|-
 
| 0x7700 || GetSecCodeGenMode || X || X || X ||  
 
| 0x7700 || GetSecCodeGenMode || X || X || X ||  
Line 239: Line 271:  
| 0x7800 || CodegenCopy || X || X || X ||  
 
| 0x7800 || CodegenCopy || X || X || X ||  
 
|-
 
|-
−
| 0x7900 || LoadShared || X ||  ||  ||  
+
| 0x7900 || Proc_LoadShared || X ||  ||  ||  
 
|-
 
|-
 
| 0x7A00 || SetExceptionCallback || X || X || X ||  
 
| 0x7A00 || SetExceptionCallback || X || X || X ||  
Line 245: Line 277:  
| 0x7B00 || IopShell_InjectCommand || X || X || X ||  
 
| 0x7B00 || IopShell_InjectCommand || X || X || X ||  
 
|-
 
|-
−
| 0x7C00 || Kill || X || X || X ||  
+
| 0x7C00 || Proc_Kill || X || X || X ||  
 
|-
 
|-
 
| 0x7D00 || EnableOverlayArena || X || X || X ||  
 
| 0x7D00 || EnableOverlayArena || X || X || X ||  
Line 257: Line 289:  
| 0x8100 || ZeroProcessMemory || X ||  ||  ||  
 
| 0x8100 || ZeroProcessMemory || X ||  ||  ||  
 
|-
 
|-
−
| 0x8200 || HandleIopPowerEvents ||  ||  ||  || X
+
| 0x8200 || HandlePowerEvents ||  ||  ||  || X
 
|-
 
|-
−
| 0x8300 || ConsoleTimestamp || X || X || X || X
+
| 0x8300 || ConsoleTimestamp || X || X || X || X
 
|-
 
|-
 
| 0x8400 || ValidateOverlayRange ||  ||  ||  || X
 
| 0x8400 || ValidateOverlayRange ||  ||  ||  || X
 
|-
 
|-
−
| 0x8500 || BadSysCall (jump to null on purpose) || X || X || X || X
+
| 0x8500-0xFF00 || BadSysCall (jump to null on purpose) || X || X || X || X
 
|}
 
|}
   −
=== Fastcalls ===
+
== Fastcalls ==
 
Fastcalls, on the other hand, are system calls that aren't routed through the dispatcher and can be accessed by any RAMPID.
 
Fastcalls, on the other hand, are system calls that aren't routed through the dispatcher and can be accessed by any RAMPID.
 
Attempting to access an unimplemented fastcall will redirect the code flow to syscall 0x0100 (AppPanic).
 
Attempting to access an unimplemented fastcall will redirect the code flow to syscall 0x0100 (AppPanic).
Line 277: Line 309:  
! scope="col" | Name
 
! scope="col" | Name
 
|-
 
|-
−
| 0x0000 || (default branch to syscall dispatcher)
+
| 0x0 || SysCall (default branch to syscall dispatcher)
 +
|-
 +
| 0x1 || MemoryBarrier
 
|-
 
|-
−
| 0x0001 || SyncEIEIO
+
| 0x2 || EnableInterrupts (deprecated, jumps to error)
 
|-
 
|-
−
| 0x0006 || LoadContext
+
| 0x3 || DisableInterrupts (deprecated, jumps to error)
 
|-
 
|-
−
| 0x0007 || SaveContext
+
| 0x4 || IsInterruptEnabled (deprecated, jumps to error)
 
|-
 
|-
−
| 0x0008 || SetCurrentContext
+
| 0x5 || RestoreInterrupts (deprecated, jumps to error)
 
|-
 
|-
−
| 0x0009 || GetCurrentFPUContext
+
| 0x6 || LoadContext
 
|-
 
|-
−
| 0x000A || SetCurrentFPUContext
+
| 0x7 || GetMSR
 
|-
 
|-
−
| 0x000B || CompareAndSwapCurrentFPUContext
+
| 0x8 || SetCurrentContext
 
|-
 
|-
−
| 0x000C || WriteGatherInit
+
| 0x9 || GetCurrentFPUContext
 
|-
 
|-
−
| 0x000D || SetPerformanceMonitor
+
| 0xA || SetCurrentFPUContext
 
|-
 
|-
−
| 0x000E || FlushDMAQueue
+
| 0xB || CompareAndSwapCurrentFPUContext
 
|-
 
|-
−
| 0x000F || do_nothing (rfi)
+
| 0xC || WriteGatherInit
 
|-
 
|-
−
| 0x0010 || DisableFPU (???)
+
| 0xD || SetPerformanceMonitor
 
|-
 
|-
−
| 0x0011 || ReadRegister32Ex
+
| 0xE || SetUserDMA
 
|-
 
|-
−
| 0x0012 || WriteRegister32Ex
+
| 0xF || ReturnFromInterrupt
 
|-
 
|-
−
| 0x0013 || Unknown (FPU?)
+
| 0x10 || FlushFPUContext
 
|-
 
|-
−
| 0x0014 || Unknown (FPU?)
+
| 0x11 || [[#ReadRegister32Ex|ReadRegister32Ex]]
 
|-
 
|-
−
| 0x0015 || Unknown (FPU?)
+
| 0x12 || [[#WriteRegister32Ex|WriteRegister32Ex]]
 
|-
 
|-
−
| 0x0016 || Unknown (FPU?)
+
| 0x13 ||  
 
|-
 
|-
−
| 0x0017 || WriteGatherGetPtr
+
| 0x14 ||  
 
|-
 
|-
−
| 0x0018 || EnableFPU (???)
+
| 0x15 || WriteGatherInitWritePtr
 
|-
 
|-
−
| 0x0019 || GetSecurityLevel (always zero)
+
| 0x16 ||  
 
|-
 
|-
−
| 0x001A || BadFastCall (jump to error on purpose)
+
| 0x17 || WriteGatherReadWritePtr
 +
|-
 +
| 0x18 || EnableFPU
 +
|-
 +
| 0x19 || GetSecurityLevel
 +
|-
 +
| 0x1A-0x1F || BadFastCall (jump to error on purpose)
 
|}
 
|}
   −
=== CosParams ===
+
=== ReadRegister32Ex ===
 +
Takes two u32s '''WhitelistIndex''' and '''RegisterIndex'''. Returns an u32 '''RegisterValue'''.
 +
 
 +
Reads a hardware register from the following whitelist:
 +
0                // Invalid
 +
0xFD020068      // 2 registers at 0x0D000068 (HW_I2CIOPINTEN to HW_I2CIOPINTSTS)
 +
0xFD0100C0      // 1 registers at 0x0D0000C0 (HW_GPIOPPCOUT)
 +
0xFD04021C      // 4 registers at 0x0D00021C
 +
0xFD040250      // 4 registers at 0x0D000250 (HW_I2CMCTRL to HW_I2CMDATARD)
 +
0xFD060520      // 6 registers at 0x0D000520 (LT_GPIOPPCOUT to LT_GPIOPPCINTEN)
 +
0xFD106400      // 16 registers at 0x0D006400 (SI0_OUTBUF to SIEXI_LOCK)
 +
0xFD046C00      // 4 registers at 0x0D006C00 (AI_CR to AI_IT)
 +
0xFD046E00      // 4 registers at 0x0D006E00
 +
0xFD0F6800      // 15 registers at 0x0D006800 (EXI0_CSR to EXI2_DATA)
 +
0                // Invalid
 +
0                // Invalid
 +
0                // Invalid
 +
0                // Invalid
 +
0                // Invalid
 +
0                // Invalid
 +
 
 +
=== WriteRegister32Ex ===
 +
Takes three u32s '''WhitelistIndex''', '''RegisterIndex''' and '''RegisterValue'''. No output.
 +
 
 +
Same as [[#ReadRegister32Ex|ReadRegister32Ex]], but for writing to a whitelisted hardware register instead.
 +
 
 +
== OSPlatformInfo ==
 
This is a structure mapped to address 0x1FFF000 in MEM1 for communicating with the [[IOSU|MCP]] process.
 
This is a structure mapped to address 0x1FFF000 in MEM1 for communicating with the [[IOSU|MCP]] process.
   Line 335: Line 401:  
| 0x4 || 0x4 || Size (0x40C)
 
| 0x4 || 0x4 || Size (0x40C)
 
|-
 
|-
−
| 0x8 || 0x4 || PpcFlags
+
| 0x8 || 0x4 || [[#Flags|Flags]]
 
|-
 
|-
 
| 0xC || 0x4 || ConsoleType
 
| 0xC || 0x4 || ConsoleType
Line 409: Line 475:  
| 0x370 || 0x4 || HardwareVersion
 
| 0x370 || 0x4 || HardwareVersion
 
|-
 
|-
−
| 0x374 || 0x8C || Reserved
+
| 0x374 || 0x40 || Reserved
 +
|-
 +
| 0x3B4 || 0x4 || SmdBaseAddress
 +
|-
 +
| 0x3B8 || 0x48 || Reserved
 +
|-
 +
| 0x400 || 0x4 || LastPMState
 +
|-
 +
| 0x404 || 0x4 || CurrentPMState
 +
|-
 +
| 0x408 || 0x4 || [[Boot1#PowerFlags|BootPMFlags]]
 +
|}
 +
 
 +
=== Flags ===
 +
{| class="wikitable" border="1"
 +
|-
 +
! Bits
 +
! Description
 +
|-
 +
| 0-25
 +
|
 +
|-
 +
| 26
 +
| IsEnterBgNormalMode
 +
|-
 +
| 27
 +
| IsDevMode
 +
|-
 +
| 28
 +
| IsFastRelaunch
 +
|-
 +
| 29
 +
| IsColdBoot
 +
|-
 +
| 30
 +
| IsSynchronousPrintingEnabled
 +
|-
 +
| 31
 +
|
 +
|}
 +
 
 +
== OSContext ==
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x8 || Tag
 +
|-
 +
| 0x8 || 0x80 || Gpr
 +
|-
 +
| 0x88 || 0x4 || Cr
 +
|-
 +
| 0x8C || 0x4 || Lr
 +
|-
 +
| 0x90 || 0x4 || Ctr
 +
|-
 +
| 0x94 || 0x4 || Xer
 +
|-
 +
| 0x98 || 0x4 || Srr0
 +
|-
 +
| 0x9C || 0x4 || Srr1
 +
|-
 +
| 0xA0 || 0x4 || Dsisr
 +
|-
 +
| 0xA4 || 0x4 || Dar
 +
|-
 +
| 0xA8 || 0x4 || CrashType
 +
|-
 +
| 0xAC || 0x4 || Reserved
 +
|-
 +
| 0xB0 || 0x4 || FpscrHigh
 +
|-
 +
| 0xB4 || 0x4 || FpscrLow
 +
|-
 +
| 0xB8 || 0x100 || Fpr
 
|-
 
|-
−
| 0x400 || 0x4 || BootSystemMode
+
| 0x1B8 || 0x2 || SpinLockCount
 
|-
 
|-
−
| 0x404 || 0x4 || McpSystemMode
+
| 0x1BA || 0x2 || ContextState
 
|-
 
|-
−
| 0x408 || 0x4 || [[Boot1#PowerFlags|PowerFlags]]
+
| 0x1BC || 0x20 || Ugqr
 +
|-
 +
| 0x1DC || 0x4 || Pir
 +
|-
 +
| 0x1E0 || 0x100 || Psf
 +
|-
 +
| 0x2E0 || 0x18 || Coretime
 +
|-
 +
| 0x2F8 || 0x8 || Starttime
 +
|-
 +
| 0x300 || 0x4 || Error
 +
|-
 +
| 0x304 || 0x4 || Attributes
 +
|-
 +
| 0x308 || 0x4 || Pmc1
 +
|-
 +
| 0x30C || 0x4 || Pmc2
 +
|-
 +
| 0x310 || 0x4 || Pmc3
 +
|-
 +
| 0x314 || 0x4 || Pmc4
 +
|-
 +
| 0x318 || 0x4 || Mmcr0
 +
|-
 +
| 0x31C || 0x4 || Mmcr1
 
|}
 
|}
   −
== Processes ==
+
== CoreControl ==
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x40 ||
 +
|-
 +
| 0x40 || 0x4 || BootStage
 +
|-
 +
| 0x44 || 0x4 || CoreInitFunc
 +
|-
 +
| 0x48 || 0x4 || CoreState
 +
|-
 +
| 0x4C || 0x4 ||
 +
|-
 +
| 0x50 || 0x4 ||
 +
|-
 +
| 0x54 || 0x4 || IsKernelPanic
 +
|-
 +
| 0x58 || 0x4 || InterruptedContext
 +
|-
 +
| 0x5C || 0x4 || CurrentFpuContext
 +
|-
 +
| 0x60 || 0x4 || CurrentCoreControl
 +
|-
 +
| 0x64 || 0x4 || SysCallTableAddress
 +
|-
 +
| 0x68 || 0x4 || FastCallBaseAddress
 +
|-
 +
| 0x6C || 0x4 || NonRecoverableExceptionHandlerTableAddress
 +
|-
 +
| 0x70 || 0x4 || RecoverableExceptionHandlerTableAddress
 +
|-
 +
| 0x74 || 0x2 ||
 +
|-
 +
| 0x76 || 0x2 ||
 +
|-
 +
| 0x78 || 0x4 || LoadPerfMonContext
 +
|-
 +
| 0x7C || 0x4 || CurrentSysCallAddress
 +
|-
 +
| 0x80 || 0x4 || CurrentSysCallCallback
 +
|-
 +
| 0x84 || 0x4 || NonRecoverableExceptionContextAddress
 +
|-
 +
| 0x88 || 0x4 || RecoverableExceptionContextAddress
 +
|-
 +
| 0x8C || 0x4 || NormalSysCalls
 +
|-
 +
| 0x90 || 0x4 || FpuExceptions
 +
|-
 +
| 0x94 || 0x4 || DsiExceptions
 +
|-
 +
| 0x98 || 0x4 || IciExceptions
 +
|-
 +
| 0x9C || 0x4 ||
 +
|-
 +
| 0xA0 || 0x4 || Ps0
 +
|-
 +
| 0xA4 || 0x4 || Ps1
 +
|-
 +
| 0xA8 || 0x8 || ProcessWork
 +
|-
 +
| 0xB0 || 0x4 ||
 +
|-
 +
| 0xB4 || 0x4 || RamPid
 +
|-
 +
| 0xB8 || 0x4 || Upid
 +
|-
 +
| 0xBC || 0x4 || Mem1Address
 +
|-
 +
| 0xC0 || 0x4 || InterceptedLoadContext
 +
|-
 +
| 0xC4 || 0x4 || SintEnableAfterKernelExit
 +
|-
 +
| 0xC8 || 0x4 || AddrConfig
 +
|-
 +
| 0xCC || 0x20 || SysCallCallbackGpr
 +
|-
 +
| 0xEC || 0x4 || EaDataBegin
 +
|-
 +
| 0xF0 || 0x4 || EaDataEnd
 +
|-
 +
| 0xF4 || 0x18 ||
 +
|-
 +
| 0x10C || 0x4 || WriteGatherDataOffset
 +
|-
 +
| 0x110 || 0x30 || [[#ExceptionInfo|ExceptionInfo]]
 +
|-
 +
| 0x140 || 0x4 || OverwriteGprOnExceptionExit
 +
|-
 +
| 0x144 || 0x28 || ExceptionExitGpr
 +
|-
 +
| 0x16C || 0x28 || [[#PostException|PostException]]
 +
|-
 +
| 0x194 || 0x4 ||
 +
|-
 +
| 0x198 || 0x128 || [[#ExceptionContext|RecoverableExceptionContext]]
 +
|-
 +
| 0x2C0 || 0x14 ||
 +
|-
 +
| 0x2D8 || 0x128 || [[#ExceptionContext|NonRecoverableExceptionContext]]
 +
|}
 +
 
 +
== ExceptionContext ==
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x8 || Tbr64
 +
|-
 +
| 0x8 || 0x80 || Gpr
 +
|-
 +
| 0x88 || 0x4 || Cr
 +
|-
 +
| 0x8C || 0x4 || Lr
 +
|-
 +
| 0x90 || 0x4 || Ctr
 +
|-
 +
| 0x94 || 0x4 || Xer
 +
|-
 +
| 0x98 || 0x4 || Srr0
 +
|-
 +
| 0x9C || 0x4 || Srr1
 +
|-
 +
| 0xA0 || 0x88 ||
 +
|}
 +
 
 +
== ExceptionInfo ==
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x4 ||
 +
|-
 +
| 0x4 || 0x4 ||
 +
|-
 +
| 0x8 || 0x4 || UserStackPtr
 +
|-
 +
| 0xC || 0x4 || ExHandler
 +
|-
 +
| 0x10 || 0x4 || Msr
 +
|-
 +
| 0x14 || 0x4 || Sprg0
 +
|-
 +
| 0x18 || 0x4 || Dsisr
 +
|-
 +
| 0x1C || 0x4 || Dar
 +
|-
 +
| 0x20 || 0x4 ||
 +
|-
 +
| 0x24 || 0x4 ||
 +
|-
 +
| 0x28 || 0x4 ||
 +
|-
 +
| 0x2C || 0x4 || CallbackContext
 +
|}
 +
 
 +
== PostException ==
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x4 || OldUpid
 +
|-
 +
| 0x4 || 0x4 || TargetUpid
 +
|-
 +
| 0x8 || 0x4 || Exit
 +
|-
 +
| 0xC || 0x4 || Callback
 +
|-
 +
| 0x10 || 0x4 || CurrentExceptionContext
 +
|-
 +
| 0x14 || 0x4 || InterruptedContext
 +
|-
 +
| 0x18 || 0x4 ||
 +
|-
 +
| 0x1C || 0x4 ||
 +
|-
 +
| 0x20 || 0x4 ||
 +
|-
 +
| 0x24 || 0x4 ||
 +
|}
 +
 
 +
== NewExecCtx ==
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x4 || InterruptedContext
 +
|-
 +
| 0x4 || 0x4 || CurrentFpuContext
 +
|-
 +
| 0x8 || 0x4 ||
 +
|-
 +
| 0xC || 0x4 || FastCallBaseAddress
 +
|-
 +
| 0x10 || 0x4 || SintEnableAfterKernelExit
 +
|-
 +
| 0x14 || 0x4 ||
 +
|-
 +
| 0x18 || 0x4 ||
 +
|-
 +
| 0x1C || 0x4 || Dabr
 +
|-
 +
| 0x20 || 0x4 || Iabr
 +
|-
 +
| 0x24 || 0x4 || EaDataBegin
 +
|-
 +
| 0x24 || 0x4 || EaDataEnd
 +
|-
 +
| 0x28 || 0x1C ||
 +
|-
 +
| 0x48 || 0x4 || AddrConfig
 +
|-
 +
| 0x4C || 0x3C || [[#PerCore|PerCore]]
 +
|}
 +
 
 +
== PerCore ==
 +
This is a structure mapped to address 0xFFFFFFC0.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x18 ||
 +
|-
 +
| 0x18 || 0x4 || UserHeartBeat
 +
|-
 +
| 0x1C || 0x4 ||
 +
|-
 +
| 0x20 || 0x4 || CurrentThread
 +
|-
 +
| 0x24 || 0x4 || SoftIntEnabled
 +
|-
 +
| 0x28 || 0x4 || SoftIntPending
 +
|-
 +
| 0x2C || 0x4 || CurrentContext
 +
|-
 +
| 0x30 || 0x4 ||
 +
|-
 +
| 0x34 || 0x4 ||
 +
|-
 +
| 0x38 || 0x4 || ThreadQueue
 +
|}
 +
 
 +
= Processes =
 
A process in Cafe OS represents a single running application, with its own code, memory, and permissions. Cafe OS only executes the code of a single process at a time, but it can hold the data of multiple processes in memory simultaneously, and switch between them. Rather than allowing arbitrary process creation, there is RAM reserved for a single foreground app, a single background app, and various other special processes. Each running process is assigned a unique identifier called a RAMPID:
 
A process in Cafe OS represents a single running application, with its own code, memory, and permissions. Cafe OS only executes the code of a single process at a time, but it can hold the data of multiple processes in memory simultaneously, and switch between them. Rather than allowing arbitrary process creation, there is RAM reserved for a single foreground app, a single background app, and various other special processes. Each running process is assigned a unique identifier called a RAMPID:
 
{| class="wikitable"
 
{| class="wikitable"
Line 531: Line 941:  
|}
 
|}
   −
== Loader ==
+
= Loader =
 
{{Main|Loader}}
 
{{Main|Loader}}
    
The loader is responsible for loading RPL formatted libraries and executables into memory. It is a standard ELF executable named loader.elf. It includes a statically linked copy of zlib, probably for decompressing sections of RPL files.
 
The loader is responsible for loading RPL formatted libraries and executables into memory. It is a standard ELF executable named loader.elf. It includes a statically linked copy of zlib, probably for decompressing sections of RPL files.
   −
== Libraries ==
+
= Libraries =
 
Cafe OS applications dynamically link with system libraries to get access to OS services. These OS services include memory management, graphics, audio, and controller input. All libraries are [[RPL|RPL files]], a modification of the standard ELF format with compressed sections and more Windows-like dynamic linking. The main system libraries are listed below, with some having their own pages of documentation:
 
Cafe OS applications dynamically link with system libraries to get access to OS services. These OS services include memory management, graphics, audio, and controller input. All libraries are [[RPL|RPL files]], a modification of the standard ELF format with compressed sections and more Windows-like dynamic linking. The main system libraries are listed below, with some having their own pages of documentation:
 
*[[avm.rpl]] - Audio/Video Manager
 
*[[avm.rpl]] - Audio/Video Manager
Line 605: Line 1,015:  
*[https://github.com/madler/zlib/tree/9712272c78b9d9c93746d9c8e156a3728c65ca72 zlib125.rpl] - ZLIB 1.2.5, functions match official library
 
*[https://github.com/madler/zlib/tree/9712272c78b9d9c93746d9c8e156a3728c65ca72 zlib125.rpl] - ZLIB 1.2.5, functions match official library
   −
== Virtual Memory Map ==
+
= Virtual Memory Map =
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
Line 702: Line 1,112:  
| 0xC1E0000
 
| 0xC1E0000
 
| 0x78100024
 
| 0x78100024
−
|  
+
| VI
 
|-
 
|-
 
| 0xFC200000
 
| 0xFC200000
Line 708: Line 1,118:  
| 0xC200000
 
| 0xC200000
 
| 0x78100024
 
| 0x78100024
−
| {{hw|GX2 Registers}}
+
| GFXSP
 
|-
 
|-
 
| 0xFC280000
 
| 0xFC280000
Line 714: Line 1,124:  
| 0xC280000
 
| 0xC280000
 
| 0x78100024
 
| 0x78100024
−
| DSP registers
+
| DSP
 
|-
 
|-
 
| 0xFC2A0000
 
| 0xFC2A0000
Line 720: Line 1,130:  
| 0xC2A0000
 
| 0xC2A0000
 
| 0x78100023
 
| 0x78100023
−
| GX2 FIFO space? (Radeon PKT3 sent here)
+
| Write Gather Pipe
 
|-
 
|-
 
| 0xFC300000
 
| 0xFC300000
Line 732: Line 1,142:  
| 0xC320000
 
| 0xC320000
 
| 0x70100022
 
| 0x70100022
−
| Espresso OTP (and other stuff?)
+
| Espresso eFuses
 
|-
 
|-
 
| 0xFD000000
 
| 0xFD000000
Rairii
1

edit

Retrieved from "https://wiiubrew.org/wiki/Special:MobileDiff/3856...4140"