In memory of Ben “bushing” Byer, who passed away on Monday, February 8th, 2016.

Difference between revisions of "/shared2/sys/SYSCONF"

From WiiBrew
< /shared2‎ | sys
Jump to navigation Jump to search
m (Navbox)
(add IPL.APD, remove "?" from offsets for NET.WCPC & IPL.SND (see talk page), indicate that secret questions differ by language, add struct for IPL.SADR.)
Line 32: Line 32:
 
| [[#Item structure|Items]], each one at an offset specified by "Item offsets"<br/>Unused offsets are zeroed completely
 
| [[#Item structure|Items]], each one at an offset specified by "Item offsets"<br/>Unused offsets are zeroed completely
 
|-
 
|-
−
| <code>0x3FB0</code> ?
+
| <code>0x3FAE</code> ?
 
| 2 bytes each
 
| 2 bytes each
−
| [[#Lookup table for settings|Lookup table for specific item names]], 38 entries long. When the value is non-zero, it contains the offset where the item offset is stored (name LUT → item offset → actual item)
+
| [[#Lookup table for settings|Lookup table for specific item names]], 39 entries long. When the value is non-zero, it contains the offset where the item offset is stored (name LUT → item offset → actual item)
 
|-
 
|-
 
| <code>0x3FFC</code>  
 
| <code>0x3FFC</code>  
Line 109: Line 109:
 
=== Lookup table for settings ===
 
=== Lookup table for settings ===
 
The end of the SYSCONF file acts as lookup table, supposedly to make finding settings easier/quicker. A lookup looks like this:
 
The end of the SYSCONF file acts as lookup table, supposedly to make finding settings easier/quicker. A lookup looks like this:
−
# Seek 80 bytes (2 bytes per entry, 38 known entries at this point, plus 4 bytes for the <code>SCed</code> marker) backwards from the end of the file and read 76 bytes to obtain the lookup table.
+
# Seek 82 bytes (2 bytes per entry, 39 known entries at this point, plus 4 bytes for the <code>SCed</code> marker) backwards from the end of the file and read 78 bytes to obtain the lookup table.
 
# Read the desired setting offset. In case this value is <code>0x0000</code>, the [[System Menu]] falls back to searching for the entry (otherwise [[Dolphin]] generated SYSCONF files would not work).
 
# Read the desired setting offset. In case this value is <code>0x0000</code>, the [[System Menu]] falls back to searching for the entry (otherwise [[Dolphin]] generated SYSCONF files would not work).
 
# When non-zero, it represents an offset in the Item offset list. Seek to the value read, and read another 2 bytes from there.
 
# When non-zero, it represents an offset in the Item offset list. Seek to the value read, and read another 2 bytes from there.
Line 122: Line 122:
 
! File offset
 
! File offset
 
! Setting
 
! Setting
 +
|-
 +
| <code>0x3FAE</code>
 +
| <code>IPL.APD</code>
 
|-
 
|-
 
| <code>0x3FB0</code>
 
| <code>0x3FB0</code>
Line 169: Line 172:
 
|-  
 
|-  
 
| <code>0x3FCE</code>
 
| <code>0x3FCE</code>
−
| <code>NET.WCPC</code>?
+
| <code>NET.WCPC</code>
 
|-  
 
|-  
 
| <code>0x3FD0</code>
 
| <code>0x3FD0</code>
Line 184: Line 187:
 
|-  
 
|-  
 
| <code>0x3FD8</code>
 
| <code>0x3FD8</code>
−
| <code>IPL.SND</code>?
+
| <code>IPL.SND</code>
 
|-  
 
|-  
 
| <code>0x3FDA</code>
 
| <code>0x3FDA</code>
Line 294: Line 297:
 
! Values  
 
! Values  
 
! Description  
 
! Description  
 +
|-
 +
| IPL.APD
 +
| LONG
 +
| 4
 +
| 0, 60, 120, ..., 720
 +
| Auto power-down (minutes, 0=never)
 
|-
 
|-
 
| IPL.AR
 
| IPL.AR
Line 388: Line 397:
 
| BIGARRAY
 
| BIGARRAY
 
| 0x100A
 
| 0x100A
−
| struct
+
| [[#IPL.SADR|struct]]
−
| "Simple Address" Contains some region info<br/>Offset 0 is a [[Country Codes|Country Code]] and offset 1 seems to be a more localized region code.
+
| "Simple Address"
 
|-
 
|-
 
| IPL.SND
 
| IPL.SND
Line 677: Line 686:
  
 
==== Secret Questions ====
 
==== Secret Questions ====
 +
Questions differ by language. These are the English questions.
 +
<!-- re: not just different languages, but the questions being asked are different. -->
 +
<!-- French Q0: Quelle était votre matière préférée à l'école? What was your favourite subject in school? -->
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
Line 699: Line 711:
 
| 5
 
| 5
 
| "If you could go anywhere, where would you go?"
 
| "If you could go anywhere, where would you go?"
 +
|}
 +
 +
=== IPL.SADR ===
 +
{| class="wikitable"
 +
|-
 +
! Offset
 +
! Type
 +
! Size
 +
! Value
 +
|-
 +
| <code>0x0000</code>
 +
| Word
 +
| <code>0x0002</code>
 +
| Array Size (minus 1); here: <code>0x1007</code> for 0x1008 bytes
 +
|-
 +
| <code>0x0002</code>
 +
| Byte
 +
| <code>0x0001</code>
 +
| Country code
 +
|-
 +
| <code>0x0003</code>
 +
| Byte
 +
| <code>0x0001</code>
 +
| Region code
 +
|-
 +
| <code>0x0004</code>
 +
| Word
 +
| <code>0x0002</code>
 +
| City code (where relevant, e.g. [[News Channel]], [[Forecast Channel]])
 +
|-
 +
| <code>0x0006</code>
 +
| UTF16BE String
 +
| <code>0x0080</code>
 +
| Japanese country name
 +
|-
 +
| <code>0x0086</code>
 +
| until
 +
| <code>0x0805</code>
 +
| Repeats up to a total of 16 entries (Japanese, English, German, French, Spanish, Italian, Dutch,<!--Simp. Chinese, Trad. Chinese, Korean, 6 undefined--> 9 undefined).
 +
|-
 +
| <code>0x0806</code>
 +
| UTF16BE String
 +
| <code>0x0080</code>
 +
| Japanese region name
 +
|-
 +
| <code>0x0886</code>
 +
| until
 +
| <code>0x1005</code>
 +
| Repeats up to a total of 16 entries (same order).
 +
|-
 +
| <code>0x1006</code>
 +
| Word
 +
| <code>0x0002</code>
 +
| Latitude (N+/S-, measured in increments of 45/8192 degree, allowing up to 180°, though latitude never exceeds 90°)
 +
|-
 +
| <code>0x1008</code>
 +
| Word
 +
| <code>0x0002</code>
 +
| Longitude (E+/W-, measured in increments of 45/8192 degree, allowing up to 180°)
 
|}
 
|}
  
 
{{Navbox filebrowser}}
 
{{Navbox filebrowser}}

Revision as of 17:58, 19 July 2022

The SYSCONF contains many Wii system settings.

Its size is always 0x4000, and its values are always encoded in Big Endian. Size/Length indicators are usually "length minus one" (ie. a length of 0x06 means that 7 bytes of data follow.)

Conventions for adding or removing settings to the file are currently unknown, but shouldn't be too hard to determine--although that's not necessarily a useful function.

File structure

File offset Size Description
0x0000 4 bytes Header magic (SCv0)
0x0004 2 bytes Number of items in this file
0x0006 2 bytes each Item offsets, one for every item ("Number of items" times)
varies 2 bytes Offset past the end of the last valid entry, follows immediately after "Item offsets"
varies varies Items, each one at an offset specified by "Item offsets"
Unused offsets are zeroed completely
0x3FAE ? 2 bytes each Lookup table for specific item names, 39 entries long. When the value is non-zero, it contains the offset where the item offset is stored (name LUT → item offset → actual item)
0x3FFC 4 bytes EOF magic (SCed)

Item structure

Offset Size Description
0x00 1 byte Item header, consists of two components:
Item type: 3 high-order bits indicate the item type
Item name length: 5 low-order bits indicate the name of this items length (minus one)
0x01 varies Item name, length specified by the item name length in the header.
varies varies Item data, length depends on the Item type.

Types

Name Value Size Note
BIGARRAY 1 varies 2 bytes of length (minus one), followed by $n bytes of data
SMALLARRAY 2 varies 1 byte of length (minus one), followed by $n bytes of data
BYTE 3 1 byte
SHORT 4 2 bytes
LONG 5 4 bytes
LONGLONG 6 8 bytes
BOOL 7 1 byte 0 is false, anything else is true (most commonly 1)

Note that both BIGARRAY and SMALLARRAY store the length (minus one) in the beginning and their actual size must be calculated from there. The name "ARRAY" need not indicate the actual content type; most settings store an application defined structure in them.

Lookup table for settings

The end of the SYSCONF file acts as lookup table, supposedly to make finding settings easier/quicker. A lookup looks like this:

  1. Seek 82 bytes (2 bytes per entry, 39 known entries at this point, plus 4 bytes for the SCed marker) backwards from the end of the file and read 78 bytes to obtain the lookup table.
  2. Read the desired setting offset. In case this value is 0x0000, the System Menu falls back to searching for the entry (otherwise Dolphin generated SYSCONF files would not work).
  3. When non-zero, it represents an offset in the Item offset list. Seek to the value read, and read another 2 bytes from there.
  4. Seek to the location indicated by the previous read (which is inside the Item offset list, and exists regardless of whether the lookup table is correct) to find the actual setting.

New settings are added at the beginning, supposedly for backwards compatibility.

Settings marked with ? are guesses, since they were not seen in any of the SYSCONF files available while writing

File offset Setting
0x3FAE IPL.APD
0x3FB0 MPLS.MOVIE?
0x3FB2 IPL.TID
0x3FB4 WWW.RST
0x3FB6 DVD.CNF?
0x3FB8 BT.BAR
0x3FBA BT.MOT
0x3FBC BT.SPKV
0x3FBE BT.SENS
0x3FC0 BT.CDIF
0x3FC2 BT.DINF
0x3FC4 DEV.DSM?
0x3FC6 DEV.CTC?
0x3FC8 DEV.VIM?
0x3FCA DEV.BTM?
0x3FCC NET.WCFG
0x3FCE NET.WCPC
0x3FD0 NET.PROF?
0x3FD2 NET.CTPC
0x3FD4 NET.CNF?
0x3FD6 IPL.UPT
0x3FD8 IPL.SND
0x3FDA IPL.SADR
0x3FDC IPL.SSV
0x3FDE IPL.PGS
0x3FE0 IPL.PC
0x3FE2 IPL.NIK
0x3FE4 IPL.LNG
0x3FE6 IPL.INC
0x3FE8 IPL.IDL
0x3FEA IPL.FRC
0x3FEC IPL.EULA
0x3FEE IPL.E60
0x3FF0 IPL.DH
0x3FF2 IPL.CD2
0x3FF4 IPL.CD
0x3FF6 IPL.ARN?
0x3FF8 IPL.AR
0x3FFA IPL.CB

Known settings

BT Settings

Name Type Size Values Description
BT.BAR BYTE 1 0 = bottom, 1 = top Sensor bar position
BT.CDIF BIGARRAY 0x207 struct List of something connected/paired (?) to the system
BT.DINF BIGARRAY 0x463 struct List of Wiimotes "synced" to the system
BT.MOT BYTE 1 0 = off, 1 = on Wiimote motor
BT.SENS LONG 4 0-4? Wiimote sensitivity setting
BT.SPKV BYTE 1 varies Wiimote speaker volume

IPL Settings

Name Type Size Values Description
IPL.APD LONG 4 0, 60, 120, ..., 720 Auto power-down (minutes, 0=never)
IPL.AR BYTE 1 0 = 4:3, 1 = 16:9 Aspect ratio setting
IPL.ARN ? ? ? ?
IPL.CB LONG 4 ? Counter Bias (difference between RTC and local time, in seconds)
IPL.CD BOOL 1 bool Config Done flag -- has initial setup been performed?
IPL.CD2 BOOL 1 bool Config2 Done flag -- has network setup been performed?
IPL.DH BYTE 1 signed byte Display Offset (horizontal)
IPL.E60 BYTE 1 0 = 50Hz, 1 = 60Hz Use EuRGB60/PAL60
IPL.EULA BOOL 1 bool EULA Done flag -- has EULA been acknowledged?
IPL.FRC LONG 4 ? "Free Channel App Count": Number of free Channel slots on the system menu (max. 48 slots total)
IPL.INC LONG 4 ? "Installed Channel App Count": Number of used Channel slots on the system menu (max. 48 slots total)
IPL.IDL SMALLARRAY 0x03 struct WiiConnect24 standby settings (Standby connection, Slot illumination)
IPL.LNG BYTE 1 0,1 System Language, see conf.c for some values
IPL.NIK SMALLARRAY 0x17 struct Console Nickname
IPL.PC SMALLARRAY 0x4B struct Parental Controls
IPL.PGS BYTE 1 0 = off, 1 = on Use Progressive Scan
IPL.SADR BIGARRAY 0x100A struct "Simple Address"
IPL.SND BYTE 1 0 = Mono, 1 = Stereo, 2 = Surround Sound setting
IPL.SSV BYTE 1 0 = off, 1 = on Screen Saver/burn-in reduction
IPL.TID LONGLONG 8 Title ID or 0 ID of the temporarily installed title for the SD channel feature. Set to 0 after erasing the title.
IPL.UPT BYTE 1 2,? Update Type

Misc Settings

Name Type Size Values Description
DEV.BTM BYTE 1 0 = Production, 1 = Development Bootmode (used for NDEV)
DEV.CTC BYTE 1 0 ?
DEV.DSM BYTE 1 0 = Disabled, 1 = Enabled, 2 = Debug Drive saving (used for NDEV)
DEV.VIM BYTE 1 ? ?
DVD.CNF BYTE 1 ? DVD Config?
MPLS.MOVIE BYTE 1 0 = Not Watched, 1 = Watched Wii Motion Plus Tutorial Movie
NET.CNF ? ? ? Network Config?
NET.CTPC LONG 4 bit 0x01 = Internet Channel
bit 0x02 = Wii Message Board, bit 0x04 = Wii Points/purchases 		Parental Control network content restrictions
NET.PROF ? ? ? Network Config?
NET.WCFG LONG 4 0 = off, 1 = on WiiConnect24 Configuration flag
NET.WCPC LONG 4 ? WiiConnect24 Parental control flags?
WWW.RST BYTE 1 0 = no, 1 = yes Restrict Internet Channel

Application-defined structures

Most SMALLARRAY and BIGARRAY values follow an application-defined structure to store data in a structured way. The type SMALLARRAY or BIGARRAY gives no indication of what kind of data is stored, only that it may not exceed 255 or 65535 bytes in size.

BT.CDIF

Offset Type Size Value
0x0000 Word 0x0002 Array Size (minus 1); here: 0x0204 for 0x0205 bytes
0x0002 Byte 0x0001 Number of ? devices
0x0003 ? 0x0056 Entry: {u8 bdaddr[6]; char name[64]; u8 unk[16]}
0x0059 until 0x0207 Repeats up to a total of 6 entries.

BT.DINF

Offset Type Size Value
0x0000 Word 0x0002 Array Size (minus 1); here: 0x0460 for 0x0461 bytes
0x0002 Byte 0x0001 Number of registered Wiimotes
0x0003 MAC Address 0x0006 Bluetooth MAC Address of registered/known Wiimote No. 1
0x0009 ASCII String 0x0040 Zero-terminated Device Name of registered/known Wiimote No. 1
0x0049 until 0x02BE Repeats up to a total of 10 entries.
0x02BF MAC Address 0x0006 Bluetooth MAC Address of active Wiimote No. 1 (only set at runtime, when a Wiimote is actually connected)
0x02C5 ASCII String? 0x0040 Zero-terminated Device Name of active Wiimote No. 1? Usually empty, probably doesn't matter (but reuses the same struct as registered Wiimotes)
0x0305 until 0x0463 Repeats up to a total of 6 entries.

IPL.IDL

Offset Type Size Value
0x00 Byte 0x01 Array Size (minus 1); here: 0x01 for 0x02 bytes
0x01 Byte 0x01 Standby connection (0 = off, 1 = on)
0x02 Byte 0x01 Slot illumination (0 = off, 1 = dim, 2 = bright)

IPL.NIK

Offset Type Size Value
0x00 Byte 0x01 Array Size (minus 1); here: 0x15 for 0x16 bytes
0x01 UTF16BE String 0x14 Console Nickname, max. 10 characters (padded with 0x00 at the end)
0x15 Word 0x02 Actual string length of the Console Nickname

IPL.PC

Offset Type Size Value
0x00 Byte 0x01 Array Size (minus 1); here: 0x49 for 0x4A bytes
0x01 Byte 0x01 Are parental controls enabled? (0x00 = off, 0x80 = on)
0x02 Byte 0x01 Always 0x04? Maybe PIN length?
0x03 Byte 0x01 Highest game rating allowed (value equals minimum age; 0x14 = 20 years/up = no restriction)
0x04 ASCII String 0x04 PIN, not delimited by a null-terminator, exactly 4 digits
0x08 Byte 0x01 Secret Question (in case you forget your PIN)
0x09 UTF16BE String 0x40 Answer, max. 32 characters (padded with 0x00 at the end)
0x49 Word 0x02 Actual string length of the Answer

Secret Questions

Questions differ by language. These are the English questions.

Question ID Question
0 "What is your mother's maiden name?"
1 "What is your place of birth?"
2 "What is your favorite sports team?"
3 "What was your favorite birthday present?"
4 "What's your favorite movie?"
5 "If you could go anywhere, where would you go?"

IPL.SADR

Offset Type Size Value
0x0000 Word 0x0002 Array Size (minus 1); here: 0x1007 for 0x1008 bytes
0x0002 Byte 0x0001 Country code
0x0003 Byte 0x0001 Region code
0x0004 Word 0x0002 City code (where relevant, e.g. News Channel, Forecast Channel)
0x0006 UTF16BE String 0x0080 Japanese country name
0x0086 until 0x0805 Repeats up to a total of 16 entries (Japanese, English, German, French, Spanish, Italian, Dutch, 9 undefined).
0x0806 UTF16BE String 0x0080 Japanese region name
0x0886 until 0x1005 Repeats up to a total of 16 entries (same order).
0x1006 Word 0x0002 Latitude (N+/S-, measured in increments of 45/8192 degree, allowing up to 180°, though latitude never exceeds 90°)
0x1008 Word 0x0002 Longitude (E+/W-, measured in increments of 45/8192 degree, allowing up to 180°)
Wii Filesystem
DiskIcon.pngNAND
FrontSD.svgFront SD
Disc.svgWii Disc
FolderIcon.pngdev
FolderIcon.pngimport
FolderIcon.pngmeta
FolderIcon.pngshared1
FolderIcon.pngshared2
FolderIcon.pngsys
FolderIcon.pngticket
FolderIcon.pngtitle
FolderIcon.pngtmp
FolderIcon.pngwfs
FolderIcon.pngaging
FileIcon.pngcntcache.txt
FolderIcon.pngDIAG
FolderIcon.pngdiag
FileIcon.pngDWC_AUTHDATA
FolderIcon.pngec
FileIcon.pngexpired
FolderIcon.pngFaceLib
FolderIcon.pngmenu
FolderIcon.pngsuccession
FolderIcon.pngsys
FolderIcon.pngtest
FolderIcon.pngtest2
FolderIcon.pngtitle
FolderIcon.pngwc24
FileIcon.pngflags.dat
FileIcon.pngNANDBOOTINFO
FolderIcon.pngnet
FileIcon.pngSYSCONF
Retrieved from "https://wiibrew.org/w/index.php?title=/shared2/sys/SYSCONF&oldid=117568"