View source for /shared2/sys/SYSCONF

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 ==
{| class="wikitable"
|-
! File offset
! Size
! Description
|-
| <code>0x0000</code>
| 4 bytes
| Header magic (<code>SCv0</code>)
|-
| <code>0x0004</code>
| 2 bytes
| Number of items in this file
|-
| <code>0x0006</code>
| 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
| [[#Item structure|Items]], each one at an offset specified by "Item offsets"<br/>Unused offsets are zeroed completely
|-
| <code>0x3FAE</code> ?
| 2 bytes each
| [[#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> 
| 4 bytes
| EOF magic (<code>SCed</code>)
|}

=== Item structure ===
{| class="wikitable"
|-
! Offset
! Size
! Description
|-
| <code>0x00</code>
| 1 byte
| Item header, consists of two components:<br/>[[#Types|Item type]]: 3 high-order bits indicate the item type<br/>Item name length: 5 low-order bits indicate the name of this items length (minus one)
|-
| <code>0x01</code>
| varies
| Item name, length specified by the item name length in the header.
|-
| varies
| varies
| Item data, length depends on the Item type.
|}

=== Types ===
{| class="wikitable"
|-
! Name
! Value
! Size
! Note
|-
| BIGARRAY
| 1
| varies
| 2 bytes of length (minus one), followed by <code>$n</code> bytes of data
|-
| SMALLARRAY
| 2
| varies
| 1 byte of length (minus one), followed by <code>$n</code> 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 <code>false</code>, anything else is <code>true</code> (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 structures|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:
# 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).
# When non-zero, it represents an offset in the Item offset list. Seek to the value read, and read another 2 bytes from there.
# 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''

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

== Known settings ==

=== BT Settings ===
{| class="wikitable"
|-
! Name 
! Type 
! Size 
! Values 
! Description 
|-
| BT.BAR
| BYTE
| 1
| 0 = bottom, 1 = top
| Sensor bar position
|-
| BT.CDIF
| BIGARRAY
| 0x207
| [[#BT.CDIF|struct]]
| List of something connected/paired (?) to the system
|-
| BT.DINF
| BIGARRAY
| 0x463
| [[#BT.DINF|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 ===
{| class="wikitable"
|-
! Name 
! Type 
! Size 
! Values 
! Description 
|-
| IPL.APD
| LONG
| 4
| 0, 60, 120, ..., 720
| Auto power-down (minutes, 0=never). Only used on the [[vWii]] and PAL [[Wii mini]].
|-
| IPL.AR
| BYTE
| 1
| 0 = 4:3, 1 = 16:9
| Aspect ratio setting
|-
| IPL.ARN
| BYTE
| 1
| 0 = Off, 1 = On
| "Auto Run mode".
|-
| 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
| [[#IPL.IDL|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
| [[#IPL.NIK|struct]]
| Console Nickname
|-
| IPL.PC
| SMALLARRAY
| 0x4B
| [[#IPL.PC|struct]]
| Parental Controls
|-
| IPL.PGS
| BYTE
| 1
| 0 = off, 1 = on
| Use Progressive Scan
|-
| IPL.SADR
| BIGARRAY
| 0x100A
| [[#IPL.SADR|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
| 0 = None, 1 = Disc, 2 = Net
| Update Type
|}

=== Misc Settings ===
{| class="wikitable"
|-
! Name 
! Type 
! Size 
! Values 
! Description 
|-
| DEV.BTM
| BYTE
| 1
| 0 = Production, 1 = Development
| Bootmode (used for NDEV)
|-
| DEV.CTC
| BYTE
| 1
| 0 = JPN, 1 = USA, 2 = EUR, 3 = AUS, 4 = BRA, 5 = TWN, 6 = KOR, 7 = HKG, 8 = ASI, 9 = LTN, 10 = SAF, 11 = CHN
| Boot IRDC Code
|-
| DEV.DSM
| BYTE
| 1
| 0 = Disabled, 1 = Enabled, 2 = Debug
| Drive saving (used for NDEV)
|-
| DEV.VIM
| BYTE
| 1
| 0 = NTSC, 1 = PAL
| Boot IRDV Mode
|-
| DVD.CNF
| BYTE
| 1
| [[#DVD.CNF|struct]]
| 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<br/>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
| BOOL
| 1
| always <code>FALSE</code>?
| 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 ===
{| class="wikitable"
|-
! Offset
! Type
! Size
! Value
|-
| <code>0x0000</code>
| Word
| <code>0x0002</code>
| Array Size (minus 1); here: <code>0x0204</code> for 0x0205 bytes
|-
| <code>0x0002</code>
| Byte
| <code>0x0001</code>
| Number of ? devices
|-
| <code>0x0003</code>
| ?
| <code>0x0056</code>
| Entry: <code>{u8 bdaddr[6]; char name[64]; u8 unk[16]}</code>
|-
| <code>0x0059</code>
| until
| <code>0x0207</code>
| Repeats up to a total of 6 entries.
|}

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

=== DVD.CNF ===
{| class="wikitable"
|-
! Offset
! Type
! Size
! Value
|-
| <code>0x00</code>
| Byte
| <code>0x01</code>
| Video mode
|-
| <code>0x01</code>
| Byte
| <code>0x01</code>
| Parental Control Level
|-
| <code>0x02</code>
| Short
| <code>0x02</code>
| Parental Control Country
|}

=== IPL.IDL ===
{| class="wikitable"
|-
! Offset
! Type
! Size
! Value
|-
| <code>0x00</code>
| Byte
| <code>0x01</code>
| Array Size (minus 1); here: <code>0x01</code> for 0x02 bytes
|-
| <code>0x01</code>
| Byte
| <code>0x01</code>
| Standby connection (0 = off, 1 = on)
|-
| <code>0x02</code>
| Byte
| <code>0x01</code>
| Slot illumination (0 = off, 1 = dim, 2 = bright)
|}

=== IPL.NIK ===
{| class="wikitable"
|-
! Offset
! Type
! Size
! Value
|-
| <code>0x00</code>
| Byte
| <code>0x01</code>
| Array Size (minus 1); here: <code>0x15</code> for 0x16 bytes
|-
| <code>0x01</code>
| UTF16BE String
| <code>0x14</code>
| Console Nickname, max. 10 characters (padded with 0x00 at the end)
|-
| <code>0x15</code>
| Word
| <code>0x02</code>
| Actual string length of the Console Nickname
|}

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

==== Secret Questions ====
Questions differ by language. These are the English questions.
{| class="wikitable"
|-
! 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 ===
{| 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°)
|}

=== NET.PROF ===
{| class="wikitable"
|-
! Offset
! Type
! Size
! Value
|-
| <code>?</code>
| Word
| <code>0x0001</code>
| Flags.
|-
| <code>?</code>
| Byte[4]
| <code>0x0004</code>
| IP Address.
|-
| <code>?</code>
| Byte[4]
| <code>0x0004</code>
| IP Netmask.
|-
| <code>?</code>
| Byte[4]
| <code>0x0004</code>
| DNS 1.
|-
| <code>?</code>
| Byte[4]
| <code>0x0004</code>
| DNS 2.
|-
| <code>?</code>
| Char[256]
| <code>0x0100</code>
| Proxy Server Name.
|-
| <code>?</code>
| Word
| <code>0x0002</code>
| Proxy Server Port.
|-
| <code>?</code>
| Char[1024]
| <code>0x0400</code>
| Another server name?
|-
| <code>?</code>
| BOOL
| <code>0x0001</code>
| Enabled?
|-
| <code>?</code>
| BOOL
| <code>0x0400</code>
| ?
|-
| <code>?</code>
| BOOL
| <code>0x0001</code>
| ?
|-
| <code>?</code>
| Char[256]
| <code>0x0100</code>
| ?
|-
| <code>?</code>
| Char[128]
| <code>0x0080</code>
| PPPOE Service Name.
|-
| <code>?</code>
| Char[256]
| <code>0x0100</code>
| PPPOE Service User Name.
|-
| <code>?</code>
| Char[256]
| <code>0x0100</code>
| PPPOE Service Password
|}

The data is then accessed based on the connection type.

==== Wired ====
{| class="wikitable"
|-
! Offset
! Type
! Size
! Value
|-
| <code>0x0000</code>
| Word
| <code>0x0001</code>
| Link Type.
|}

==== Wireless ====
{| class="wikitable"
|-
! Offset
! Type
! Size
! Value
|-
| <code>0x0000</code>
| Word
| <code>0x0002</code>
| Rate Set.
|-
| <code>0x0002</code>
| Byte
| <code>0x0001</code>
| Configuration Method.
|}

{{Navbox filebrowser}}