58
edits
Changes
Turn the prose file format description into more expressive tables
Line 1:
Line 1:
The format of the file is fairly simple. Its size is 0x4000, and it contains a header that reads "SCv0", followed by the number of settings in the file (be u16), and then a list of offsets of each setting (be u16). Each setting (aka "Item") contains first a u8, specifying the type of the value, and the length of the name. The low-order 5 bits specify the length of the name, minus one. The high-order three bits specify the type of the value, as given by the table below. This is followed by a name, in ASCII, then a value.+Last 4 bytes of the file read "SCed".+
+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.+Some settings from the file:+
The SYSCONF contains many Wii system settings.
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>0x3FB0</code> ?
+| 2 bytes each
+| 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)<br/>''The offset is a guess, as well as the length (based on names dumped from the system menu). Assuming there are no other item names in this LUT and there is one entry for every known setting, it should be located (76 + 4) bytes from the end of file''
+|-
+| <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 ==
+=== Types ===
{| class="wikitable"
{| class="wikitable"
|-
|-
Line 18:
Line 72:
| 1
| 1
| varies
| varies
−| 2 bytes of length, followed by <code>$n</code> bytes of data
+| 2 bytes of length (minus one), followed by <code>$n</code> bytes of data
|-
|-
| SMALLARRAY
| SMALLARRAY
| 2
| 2
| varies
| varies
−| 1 byte of length, followed by <code>$n</code> bytes of data
+| 1 byte of length (minus one), followed by <code>$n</code> bytes of data
|-
|-
| BYTE
| BYTE
Line 51:
Line 105:
|}
|}
−Note that both BIGARRAY and SMALLARRAY store the length minus one in the beginning. A length of 0x06 means that 7 bytes of data follow. The name "ARRAY" need not indicate the actual content type; most settings store an application defined structure in them.
+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.
−== Known settings ==
−== BT Settings ==
+=== BT Settings ===
{| class="wikitable"
{| class="wikitable"
|-
|-
Line 101:
Line 155:
|}
|}
−== IPL Settings ==
+=== IPL Settings ===
{| class="wikitable"
{| class="wikitable"
|-
|-
Line 227:
Line 281:
Offset 0 is a [[Country Codes|Country Code]] and offset 1 seems to be a more localized region code.
Offset 0 is a [[Country Codes|Country Code]] and offset 1 seems to be a more localized region code.
−== Misc Settings ==
+=== Misc Settings ===
{| class="wikitable"
{| class="wikitable"
|-
|-