Difference between revisions of "Configuration Memory"
| Line 90: | Line 90: | ||
|} | |} | ||
| − | This memory page is [[Memory_layout|read-only]] for ARM11 processes. | + | This memory page is [[Memory_layout|read-only]] for ARM11 processes. This memory and the kernel code for it only exists under NATIVE_FIRM/SAFE_MODE_FIRM. |
The FIRM_* fields are by default identical to the KERNEL_* fields. However, the FIRM_* fields can be overridden via FIRM-launch parameters, see [[FIRM|here]]. | The FIRM_* fields are by default identical to the KERNEL_* fields. However, the FIRM_* fields can be overridden via FIRM-launch parameters, see [[FIRM|here]]. | ||
| Line 159: | Line 159: | ||
|} | |} | ||
| − | This memory page is normally read-only for ARM11 processes, write-access is [[Memory_layout|determined]] by the process exheader kernel "shared page writing" flag. | + | This memory page is normally read-only for ARM11 processes, write-access is [[Memory_layout|determined]] by the process exheader kernel "shared page writing" flag. This memory only exists under NATIVE_FIRM/SAFE_MODE_FIRM. |
= ARM11 Kernel Config Fields = | = ARM11 Kernel Config Fields = | ||
Revision as of 16:42, 25 April 2015
ARM11 Kernel Configuration Memory
| NAME | PROCESS VIRTUAL ADDRESS | WIDTH |
|---|---|---|
| KERNEL_? | 0x1FF80000 | 1 |
| KERNEL_VERSIONREVISION | 0x1FF80001 | 1 |
| KERNEL_VERSIONMINOR | 0x1FF80002 | 1 |
| KERNEL_VERSIONMAJOR | 0x1FF80003 | 1 |
| UPDATEFLAG | 0x1FF80004 | 4 |
| NSTID | 0x1FF80008 | 8 |
| SYSCOREVER | 0x1FF80010 | 4 |
| UNITINFO | 0x1FF80014 | 1 |
| BOOT_FIRM | 0x1FF80015 | 1 |
| PREV_FIRM | 0x1FF80016 | 1 |
| KERNEL_CTRSDKVERSION | 0x1FF80018 | 4 |
| APPMEMTYPE | 0x1FF80030 | 4 |
| APPMEMALLOC | 0x1FF80040 | 4 |
| SYSMEMALLOC | 0x1FF80044 | 4 |
| BASEMEMALLOC | 0x1FF80048 | 4 |
| FIRM_? | 0x1FF80060 | 1 |
| FIRM_VERSIONREVISION | 0x1FF80061 | 1 |
| FIRM_VERSIONMINOR | 0x1FF80062 | 1 |
| FIRM_VERSIONMAJOR | 0x1FF80063 | 1 |
| FIRM_SYSCOREVER | 0x1FF80064 | 4 |
| FIRM_CTRSDKVERSION | 0x1FF80068 | 4 |
This memory page is read-only for ARM11 processes. This memory and the kernel code for it only exists under NATIVE_FIRM/SAFE_MODE_FIRM.
The FIRM_* fields are by default identical to the KERNEL_* fields. However, the FIRM_* fields can be overridden via FIRM-launch parameters, see here.
Besides mem-region related fields, the data written here by the old 3DS/new 3DS kernels is identical.
| NAME | PROCESS VIRTUAL ADDRESS | WIDTH |
|---|---|---|
| bit0 selects DATETIME_0 or DATETIME_1. | 0x1FF81000 | 4 |
| RUNNING_HW (1=product, 2=devboard, 3=debugger, 4=capture) | 0x1FF81004 | 1 |
| MCU_HW_INFO | 0x1FF81005 | 1 |
| DATETIME_0 {(u64)MillisecondsSinceFirstJan1900,(u64)SystemTickLastTimeThisWasUpdated,(u32)unk,(u32)unk,(u32)unk,(u32)unk} | 0x1FF81020 | 32 |
| DATETIME_1 | 0x1FF81040 | 32 |
| WIFI_MACADDR | 0x1FF81060 | 6 |
| WIFI_? Likely wifi hardware related, NWM module initializes this. Regular Old3DS value = 0x00, regular New3DS value = 0x03. | 0x1FF81066 | 1 |
| WIFI_? Likely wifi hardware related, NWM module initializes this. Regular Old3DS value = 0x00, regular New3DS value = 0x02. | 0x1FF81067 | 1 |
| 3D_SLIDERSTATE | 0x1FF81080 | 4 |
| 3D_LEDSTATE | 0x1FF81084 | 1 |
| BATTERY_LEDSTATE | 0x1FF81085 | 1 |
| MENUTID | 0x1FF810A0 | 8 |
| ACTIVEMENUTID | 0x1FF810A8 | 8 |
| Signed? Headsets connected? | 0x1FF810C0 | 1 |
This memory page is normally read-only for ARM11 processes, write-access is determined by the process exheader kernel "shared page writing" flag. This memory only exists under NATIVE_FIRM/SAFE_MODE_FIRM.
ARM11 Kernel Config Fields
0x1FF80000 / 0x1FF80060
Unknown, this is normally value 0.
KERNEL_VERSIONREVISION / FIRM_VERSIONREVISION
This is the version-revision for the currently running FIRM.
KERNEL_VERSIONMINOR
This is the version-minor from ((title-version & 0x3FF) >> 4), for the currently running FIRM. The values from KERNEL_VERSIONMINOR and KERNEL_VERSIONMAJOR can be stored in applications' CXI exheader.
FIRM_VERSIONMINOR
This is the same as KERNEL_VERSIONMINOR. After AM:InstallNATIVEFIRM checks FIRM_SYSCOREVER, AM:InstallNATIVEFIRM then compares FIRM_VERSIONMINOR with the NATIVE_FIRM ((title-version & 0x3FF) >> 4), when the latter is larger than FIRM_VERSIONMINOR AM:InstallNATIVEFIRM will trigger a FIRM install.
KERNEL_VERSIONMAJOR / FIRM_VERSIONMAJOR
This is the version-major for the currently running FIRM.
UPDATEFLAG
Normally this flag is zero. When the ARM11 kernel is booting on non-factory FIRM it will set this flag to 1, when bit0 from the data which field 0x1FF80016 is loaded from is clear, if the following PAD buttons are pressed: L, R, A, Up. When this flag is set, NS will launch the System Updater title instead of Home Menu.
NSTID
This field contains the titleID of the first title to launch from CTR-NAND after the FIRM system processes are loaded. The PM module launches this title. If this field titleID is all-zero, the system will not attempt to launch the title. The regular ARM11 kernel sets this to the regular NS titleID, while the SAFE_MODE ARM11 kernel sets this to the SAFE_MODE NS titleID. The factory FIRM ARM11-kernel sets this to the NS TID from here.
SYSCOREVER
This field is initialized by the ARM11 kernel, this is the programID-low of the running FIRM. When launching CXIs, the value stored here must match the core version field stored in the CXI exheader. If they do not match, the PM module will refuse to launch the ARM11 process.
With factory NATIVE_FIRM, this is set to 0x0, even though the FIRM programID-low is 0x2. However, the factory system-titles have core-version set to 0x2. Hence, this config-mem SYSCOREVER field might not be used by factory system processes?
FIRM_SYSCOREVER
Normally this is the same as SYSCOREVER. This used by AM:InstallNATIVEFIRM for comparing with the NATIVE_FIRM titleID-low. When the low u8 from the NATIVE_FIRM titleID-low is larger than FIRMSYSCOREVER, AM:InstallNATIVEFIRM will trigger FIRM installing. When that u8 is not larger than FIRM_SYSCOREVER, and these two values don't match, AM:InstallNATIVEFIRM will return an error.
UNITINFO
| Bit | Description |
|---|---|
| 0 | Clear for developer unit, set for retail.(See 0x1FF80015) |
| 1 | Set for debug units |
| 2-7 | ? |
Bit1 in this field is set by the ARM11 kernel when ARM debug CP14 DSCR bit14 is set. NS loads the menu TID from MENUTID when bits 1-7 of this field are clear. ErrDisp will display development error info when bit0 is clear.
0x1FF80015
The ARM11 loads this value from 0x1FFFFFF0+1 during startup, which is written by the ARM9 during ARM9<>ARM11 kernel sync.
When this field is zero, bit0 for UNITINFO is set for retail. When this field is non-zero, bit0 for UNITINFO is clear for dev/debug units, and an ARM11 kernel state flag which enables debugging is set. Bit1 means JTAG connected.
0x1FF80016
The ARM11 loads this value from 0x1FFFFFF0+2 during startup, which is written by the ARM9 during ARM9<>ARM11 kernel sync.
This originates from the low 8-bits of register 0x10010000. When bit0 is set, the ARM11 kernel will not set the UPDATEFLAG to value 1.
KERNEL_CTRSDKVERSION / FIRM_CTRSDKVERSION
This is the CTR-SDK version which was used to build the currently running FIRM.
APPMEMTYPE
The value of this field determines the size for APPMEMALLOC. The retail type(value0) is used when the type is not values 2-5. See Memory_layout for the table of values for this and the mem-region sizes.
APPMEMALLOC
This contains the total size of the memory that can be allocated with the APPLICATION memory-region, see here.
SYSMEMALLOC
Same as APPMEMALLOC except for the SYSTEM mem-region, see here.
BASEMEMALLOC
Same as APPMEMALLOC except for the BASE mem-region, see here.
WIFI_MACADDR
This is the WiFi MAC address for the 3DS. This is initialized by the NWM module, it's unknown where the MAC address written here was originally loaded from.
3D_SLIDERSTATE
This float contains the state of the 3D slider. The range of this float is value 0.0f for "off", and 1.0f for max.
This is written/updated by HID module.
3D_LEDSTATE
When non-zero, the 3D LED is disabled. See GSPGPU:SetLedForceOff.
MENUTID
Unknown, contains the menu TID (used by NS)
ACTIVEMENUTID
This contains the titleID of the currently running menu launched by NS.
NATIVE_FIRM Versions
| System version | old 3DS title version | old 3DS hex title contentID | Kernel/FIRM version (old 3DS/new 3DS) |
|---|---|---|---|
| Factory FIRM (titleID 00040001-00000002) | v0 | 00 | 2.3-0 |
| 1.0.0 | v432 | 00 | 2.27-0 |
| 1.1.0 | v1472 | 02 | 2.28-0 |
| 2.0.0 | v2516 | 09 | 2.29-7 |
| 2.1.0 | v3553 | 0B | 2.30-18 |
| 2.2.0 | v4595 | 0F | 2.31-40 |
| 3.0.0 | v5647 | 18 | 2.32-15 |
| 4.0.0 | v6677 | 1D | 2.33-4 |
| 4.1.0 | v7712 | 1F | 2.34-0 |
| 5.0.0 | v8758 | 25 | 2.35-6 |
| 5.1.0 | v9792 | 26 | 2.36-0 |
| 6.0.0 | v10833 | 29 | 2.37-0 |
| 6.1.0 | v11872 | 2A | 2.38-0 |
| 7.0.0 | v12916 | 2E | 2.39-4 |
| 7.2.0 | v13956 | 30 | 2.40-0 |
| 8.0.0 | v15047 | 37 | 2.44-6 |
| 8.1.0-0_New3DS | N/A | N/A | 2.45-5 |
| 9.0.0 | v17120 | 38 | 2.46-0 |
| 9.3.0 | v18182 | 3F | 2.48-3 |
| 9.5.0 | v19216 | 40 | 2.49-0 |
| 9.6.0 | v20262 | 49 | 2.50-1 |
The above kernel/FIRM versions are in the format: <KERNEL_VERSIONMAJOR>.<KERNEL_VERSIONMINOR>-<KERNEL_VERSIONREVISION>.