Changes

2,477 bytes added ,  04:43, 27 December 2019
m
Finish off summary: this is why I need to write TODO
Line 1: Line 1: −
Sys is the [[:/dev/bsp]] entity that handles miscellaneous system attributes, like. There is always one instance available.
+
Sys is the [[:/dev/bsp]] entity that handles miscellaneous system attributes, like BSP initialisation, the Starbuck clock muiltiplier, and board information. There is always one instance available.
    
== Attributes ==
 
== Attributes ==
Line 21: Line 21:     
=== Misc ===
 
=== Misc ===
'''Availability''': This attribute is always available.
+
'''Availability''': This attribute is always available. (<code>BSP_AO_INIT_GLOBAL</code>)
    
'''Permissions''': <code>BSP_PERMISSIONS_IOS_SUPV</code> only.
 
'''Permissions''': <code>BSP_PERMISSIONS_IOS_SUPV</code> only.
Line 109: Line 109:  
|
 
|
 
| Calls the same backend function as the Write method, using hardcoded PLL data.
 
| Calls the same backend function as the Write method, using hardcoded PLL data.
 +
|}
 +
 +
=== devicePresence ===
 +
'''Availability''': This attribute is always available.
 +
 +
'''Permissions''': <code>BSP_PERMISSIONS_ALL</code>.
 +
{| class="wikitable"
 +
! Method
 +
! Data Size
 +
! Values
 +
!
 +
|-
 +
| Read
 +
| 4
 +
| constant
 +
| Returns a constant 0x07F17317; or an unknown value if the EE board revision is greater than 4.
 +
|}
 +
 +
=== topLevel ===
 +
'''Availability''': This attribute is always available. (<code>BSP_AO_INIT_GLOBAL</code>)
 +
 +
'''Permissions''': <code>BSP_PERMISSIONS_IOS_SUPV</code>.
 +
{| class="wikitable"
 +
! Method
 +
! Data Size
 +
! Values
 +
!
 +
|-
 +
| Init
 +
| 0
 +
|
 +
| Initialises plenty of hardware and BSP entities; including some of Sys's attributes, GPIO, USB, EE, GFX, AI, VI, SATA, SMC, CCRH, SI, DI, FLA and SDIO.
 +
|}
 +
 +
 +
=== iop2x ===
 +
'''Availability''': This attribute is always available. (<code>BSP_AO_INIT_GLOBAL</code>)
 +
 +
'''Permissions''': <code>BSP_PERMISSIONS_IOS_SUPV | BSP_PERMISSIONS_IOS_USER_READ</code>.
 +
{| class="wikitable"
 +
! Method
 +
! Data Size
 +
! Values
 +
!
 +
|-
 +
| Init
 +
| 1
 +
| 1 or 2
 +
| Calls [[IOSU_Syscalls|syscall]] 0x6c with either 0 or 1 to set the clock multiplier.
 +
|-
 +
| Read
 +
| 1
 +
| 1 or 2
 +
| Returns the state of the IOP clock multiplier - 1x or 2x (based on bit 3 of [[Hardware/Latte Registers#LT_IOP2X|LT_IOP2X]])
 +
|}
 +
 +
=== cpuUtil ===
 +
'''Availability''': This attribute is always available.
 +
 +
'''Permissions''': <code>BSP_PERMISSIONS_ALL</code>.
 +
{| class="wikitable"
 +
! Method
 +
! Data Size
 +
! Values
 +
!
 +
|-
 +
| Read
 +
| 4
 +
| {{check}}
 +
| Returns the Starbuck's CPU utilisation (from [[IOSU_Syscalls|syscall]] 0x60).
 +
|}
 +
 +
=== osVer ===
 +
'''Availability''': This attribute is always available.
 +
 +
'''Permissions''': <code>BSP_PERMISSIONS_ALL</code>.
 +
{| class="wikitable"
 +
! Method
 +
! Data Size
 +
! Values
 +
!
 +
|-
 +
| Read
 +
| 94
 +
| constant
 +
| Returns a structure with data about the current OS/SDK version. This includes the "Cafe OS SDK Version x.xx.xx Build..." string often seen in IOSU logs.
 +
|}
 +
 +
=== powerMode ===
 +
'''Availability''': This attribute is always available.
 +
 +
'''Permissions''': <code>BSP_PERMISSIONS_ALL</code>.
 +
{| class="wikitable"
 +
! Method
 +
! Data Size
 +
! Values
 +
!
 +
|-
 +
| Read
 +
| 4
 +
| {{check}}
 +
|
 +
|}
 +
 +
=== iopClock ===
 +
'''Availability''': This attribute is always available.
 +
 +
'''Permissions''': <code>BSP_PERMISSIONS_ALL</code>.
 +
{| class="wikitable"
 +
! Method
 +
! Data Size
 +
! Values
 +
!
 +
|-
 +
| Read
 +
| 8
 +
|
 +
| Returns 64-bit system uptime (from IOS_GetUpTime64, [[IOSU_Syscalls|syscall]] 0x1a).
 
|}
 
|}