crash_screen.c File Reference

#include <ultra64.h>
#include <macros.h>
#include <mk64.h>
#include <stdarg.h>
#include <string.h>
#include "crash_screen.h"
#include "main.h"
#include "textures/crash_screen/crash_screen_font.ia1.inc.c"

Include dependency graph for crash_screen.c:

Macros
#define	DRAW_CODE   0xFFFF
#define	CHARACTER_DASH   16
#define	WHITE_COLOUR   0xFFFF
#define	RED_COLOUR   0xF801
#define	SQUARE_X   40
#define	SQUARE_Y   40
#define	SQUARE_SIZE_X   6
#define	SQUARE_SIZE_Y   6
#define	BORDER_WIDTH   1
#define	SQUARE_X2   SQUARE_X + SQUARE_SIZE_Y
#define	SQUARE_Y2   SQUARE_Y + SQUARE_SIZE_X
#define	BLACK_COLOUR   0x0001

Functions
void	osSetEventMesg (OSEvent, OSMesgQueue *, OSMesg)
s32	osRecvMesg (OSMesgQueue *, OSMesg *, s32)
void	crash_screen_draw_glyph (u16 *framebuffer, s32 x, s32 y, s32 glyph)
void	crash_screen_draw_square (u16 *framebuffer)
void	crash_screen_draw_info (u16 *framebuffer, OSThread *thread)
OSThread *	get_faulted_thread (void)
void	thread9_crash_screen (UNUSED void *arg0)
	Retrieves faulted thread and displays debug info after the user inputs the button sequence. Button sequence: L, Up, Left, Down, Right, R, L, B, A.
void	crash_screen_set_framebuffer (u16 *framebuffer)
void	thread9_crash_screen (void *)
void	create_debug_thread (void)
void	start_debug_thread (void)

Variables
OSThread	D_80162790
ALIGNED8 u8	gDebugThreadStack [0x400]
OSMesgQueue	D_80162D40
OSMesg	D_80162D58
u16 *	pFramebuffer
s32	sButtonSequenceIndex
s32	sCounter = 0
u8	crashScreenFont [][8]
u16	sCrashScreenButtonSequence []

Macro Definition Documentation

BLACK_COLOUR

#define BLACK_COLOUR   0x0001

Draws three black boxes then prints crash info in the following format: Line 1: threadId - address of faulted instruction - error code Line 2: Address in the return address register Line 3: Machine code of faulted instruction

The R4300i manual discusses exceptions in more depth.

Parameters

framebuffer
faulted	thread

BORDER_WIDTH

#define BORDER_WIDTH   1

CHARACTER_DASH

#define CHARACTER_DASH   16

DRAW_CODE

#define DRAW_CODE   0xFFFF

RED_COLOUR

#define RED_COLOUR   0xF801

SQUARE_SIZE_X

#define SQUARE_SIZE_X   6

SQUARE_SIZE_Y

#define SQUARE_SIZE_Y   6

SQUARE_X

#define SQUARE_X   40

SQUARE_X2

#define SQUARE_X2   SQUARE_X + SQUARE_SIZE_Y

SQUARE_Y

#define SQUARE_Y   40

SQUARE_Y2

#define SQUARE_Y2   SQUARE_Y + SQUARE_SIZE_X

WHITE_COLOUR

#define WHITE_COLOUR   0xFFFF

Function Documentation

crash_screen_draw_glyph()

void crash_screen_draw_glyph	(	u16 *	framebuffer,
		s32	x,
		s32	y,
		s32	glyph )

Here is the caller graph for this function:

crash_screen_draw_info()

void crash_screen_draw_info	(	u16 *	framebuffer,
		OSThread *	thread )

Bug

if this check fails, the ra register is printed a second time.

Here is the call graph for this function:

Here is the caller graph for this function:

crash_screen_draw_square()

void crash_screen_draw_square

(

u16 *

framebuffer

)

Here is the call graph for this function:

Here is the caller graph for this function:

crash_screen_set_framebuffer()

void crash_screen_set_framebuffer

(

u16 *

framebuffer

)

Here is the caller graph for this function:

create_debug_thread()

void create_debug_thread

(

void

)

Here is the call graph for this function:

Here is the caller graph for this function:

get_faulted_thread()

OSThread * get_faulted_thread

(

void

)

Here is the call graph for this function:

Here is the caller graph for this function:

osRecvMesg()

s32 osRecvMesg ( OSMesgQueue * mq, OSMesg * msg, s32 flag )

extern

Here is the call graph for this function:

Here is the caller graph for this function:

osSetEventMesg()

void osSetEventMesg ( OSEvent e, OSMesgQueue * mq, OSMesg msg )

extern

Here is the call graph for this function:

Here is the caller graph for this function:

start_debug_thread()

void start_debug_thread

(

void

)

Here is the call graph for this function:

Here is the caller graph for this function:

thread9_crash_screen() [1/2]

void thread9_crash_screen

(

UNUSED void *

arg0

)

Retrieves faulted thread and displays debug info after the user inputs the button sequence. Button sequence: L, Up, Left, Down, Right, R, L, B, A.

Here is the call graph for this function:

Here is the caller graph for this function:

thread9_crash_screen() [2/2]

void thread9_crash_screen ( void * )

extern

Variable Documentation

crashScreenFont

u8 crashScreenFont[][8]

Initial value:

= {
 
}

D_80162790

OSThread D_80162790

D_80162D40

OSMesgQueue D_80162D40

D_80162D58

OSMesg D_80162D58

gDebugThreadStack

ALIGNED8 u8 gDebugThreadStack[0x400]

pFramebuffer

u16* pFramebuffer

sButtonSequenceIndex

s32 sButtonSequenceIndex

sCounter

s32 sCounter = 0

sCrashScreenButtonSequence

u16 sCrashScreenButtonSequence[]

Initial value:

= { L_TRIG, U_JPAD, L_JPAD,   D_JPAD,   R_JPAD,
                                     R_TRIG, L_TRIG, B_BUTTON, A_BUTTON, DRAW_CODE }