Difference between revisions of "/dev/bsp/Sys"

From WiiUBrew
< /dev‎ | bsp
Jump to navigation Jump to search
(Add rest of bsp:Sys attributes)
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 ==

Latest revision as of 04:43, 27 December 2019

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

WorkArounds

Availability: This attribute is always available.

Permissions: BSP_PERMISSIONS_IOS_SUPV only.

Method Data Size Values
Init 0 Sets various hardware-dependent workaround registers depending on the hardware version. For Latte boards, this includes bits 10 and 11 in HW_SPARE1, bits 4 through 1 in HW_SPARE0, and bits 18 through 13 in AHMN_WORKAROUND (dev boards only).

Misc

Availability: This attribute is always available. (BSP_AO_INIT_GLOBAL)

Permissions: BSP_PERMISSIONS_IOS_SUPV only.

Method Data Size Values
Init 0 Sets various pin strength controls, including bits in HW_IOSTRCTRL0, HW_IOSTRCTRL1, HW_CLKSTRCTRL and LT_IOSTRCTRL2.

ClockInfo

Availability: This attribute is always available.

Permissions: BSP_PERMISSIONS_ALL.

Method Data Size Values
Read 8 constant Returns the system bus speed in Hz (248625000 on retail consoles) in the first 4 bytes, and the same value divided by 128 in the second 4 bytes.

ASICRevision

Availability: This attribute is always available.

Permissions: BSP_PERMISSIONS_ALL.

Method Data Size Values
Read 8 constant Returns HW_CHIPREVID in the first 4 bytes, and LT_CHIPREVID in the last 8 bytes (where supported).

BoardRevision

Availability: This attribute is always available.

Permissions: BSP_PERMISSIONS_ALL.

Method Data Size Values
Read 2 constant Returns the board revision from BSP's global BoardConfig struct.

SYSPLL

Availability: This attribute is always available.

Permissions: BSP_PERMISSIONS_PPC_SUPV_READ | BSP_PERMISSIONS_IOS_USER_READ | BSP_PERMISSIONS_IOS_SUPV

Method Data Size Values
Read 0x36 Constructs a buffer with values from ABIF.[check]
Write 0x36 Sends values from the input buffer out over ABIF, wrapped by toggling values in HW_CLOCKS (sets FX on entry, clears SPEED and FX on exit), conditionally setting bit 1 in LT_PLLSYS and holding RSTB_SYSPLL, RSTB_MEMRSTB and RSTB_DSKPLL in reset during the operation.
Init 0 Calls the same backend function as the Write method, using hardcoded PLL data.

devicePresence

Availability: This attribute is always available.

Permissions: BSP_PERMISSIONS_ALL.

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. (BSP_AO_INIT_GLOBAL)

Permissions: BSP_PERMISSIONS_IOS_SUPV.

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. (BSP_AO_INIT_GLOBAL)

Permissions: BSP_PERMISSIONS_IOS_SUPV | BSP_PERMISSIONS_IOS_USER_READ.

Method Data Size Values
Init 1 1 or 2 Calls 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 LT_IOP2X)

cpuUtil

Availability: This attribute is always available.

Permissions: BSP_PERMISSIONS_ALL.

Method Data Size Values
Read 4 [check] Returns the Starbuck's CPU utilisation (from syscall 0x60).

osVer

Availability: This attribute is always available.

Permissions: BSP_PERMISSIONS_ALL.

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: BSP_PERMISSIONS_ALL.

Method Data Size Values
Read 4 [check]

iopClock

Availability: This attribute is always available.

Permissions: BSP_PERMISSIONS_ALL.

Method Data Size Values
Read 8 Returns 64-bit system uptime (from IOS_GetUpTime64, syscall 0x1a).