Panic codes

From Nintendo Switch Brew
Jump to navigation Jump to search

All elements in the Switch's boot chain up to the kernel have the ability to issue a system panic.

Panics are handled by writing a panic code in the PMC_SCRATCH200 register and requesting a reboot by programming a dedicated hardware watchdog (WDT4). The bootloaders and the Secure Monitor are able to do this right away, but the kernel must invoke the Panic SMC.

When the system reboots, the encrypted bootloader checks if the reset was requested by the watchdog (PMC_RST_STATUS register is set to 0x01) and parses the panic code stored in PMC_SCRATCH200.

If a panic did occur, the Switch will paint the main screen with a solid color and halt execution.

Structure

Bits Field
31-28 Blue value
27-24 Green value
23-20 Red value
19-0 Description

The blue, green and red values are nibbles which represent the color that will fill the panic screen. Each nibble is duplicated to form a full byte before writing the final color to the display's MMIO.

Panic colors

Different colors are used to represent panic events coming from different execution levels within the system.

Color Value Level
0x000000 Default
0x0000FF Kernel
0xFF7700 Secure Monitor (exception vectors)
0x00FFFF Secure Monitor (general errors)
0x00AAFF Secure Monitor (deep sleep) [1.0.0+]
0xFF77FF Secure Monitor (deep sleep) [4.0.0+]
0xAA00FF Bootloader (general errors)
0xFFFFAA Bootloader (booting SafeMode) [1.0.0-3.0.2]

Panic codes

While any combination of panic colors and codes is possible, several panic codes are specifically tied to a certain color.

Value Color Description
0x0 Any No information
0x1
Package2 signature verification failed
0x2
Package2 meta verification failed
0x3
Package2 version check failed
0x4
Package2 payload verification failed
0x5
Unknown SMC
0x6
Unknown Abort
0x7
Invalid CPU context
0x8
Invalid SE state
0x9
CPU is already awake [2.0.0+]
0x10
Unknown exception
0x20
Rebooting into SafeMode
0x21
Rebooting for anti-downgrade
0x30
General bootloader error
0x31
Invalid DRAM ID
0x32
Invalid size
0x33
Invalid argument
0x34
Bad GPT
0x35
Failed to boot SafeMode
0x36
Activity Monitor fired [4.0.0+]
0x40
Show error called (kernel panic)