pspdebug.h

Go to the documentation of this file.

/*
 * PSP Software Development Kit - http://www.pspdev.org
 * -----------------------------------------------------------------------
 * Licensed under the BSD license, see LICENSE in PSPSDK root for details.
 *
 *  pspdebug.h - Prototypes for the pspDebug library
 *
 * Copyright (c) 2005 Marcus R. Brown <mrbrown@ocgnet.org>
 * Copyright (c) 2005 James Forshaw <tyranid@gmail.com>
 * Copyright (c) 2005 John Kelley <ps2dev@kelley.ca>
 *
 * $Id: pspdebug.h 2487 2009-11-01 17:02:17Z jim $
 */
#ifndef __DEBUG_H__
#define __DEBUG_H__

#include <psptypes.h>
#include <pspmoduleinfo.h>

#ifdef __cplusplus
extern "C" {
#endif


void pspDebugScreenInit(void);

void pspDebugScreenInitEx(void *vram_base, int mode, int setup);

void pspDebugScreenPrintf(const char *fmt, ...) __attribute__((format(printf,1,2)));

void pspDebugScreenKprintf(const char *format, ...) __attribute__((format(printf,1,2)));

void pspDebugScreenEnableBackColor(int enable);

void pspDebugScreenSetBackColor(u32 color);

void pspDebugScreenSetTextColor(u32 color);

void pspDebugScreenSetColorMode(int mode);

void pspDebugScreenPutChar(int x, int y, u32 color, u8 ch);

void pspDebugScreenSetXY(int x, int y);

void pspDebugScreenSetOffset(int offset);

void pspDebugScreenSetBase(u32* base);

void pspDebugScreenSetMaxX(unsigned int maxx);

void pspDebugScreenSetMaxY(unsigned int maxy);

int pspDebugScreenGetX(void);

int pspDebugScreenGetY(void);

void pspDebugScreenClear(void);

int pspDebugScreenPrintData(const char *buff, int size);

int pspDebugScreenPuts(const char *str);

int pspDebugGetStackTrace(unsigned int* results, int max);

void pspDebugScreenClearLineEnable(void);

void pspDebugScreenClearLineDisable(void);

typedef struct _PspDebugRegBlock
{
        u32 frame[6];
        u32 r[32];
        u32 status;
        u32 lo;
        u32 hi;
        u32 badvaddr;
        u32 cause;
        u32 epc;
        float fpr[32];
        u32 fsr;
        u32 fir;
        u32 frame_ptr;
        u32 unused;
        /* Unused on PSP */
        u32 index;
        u32 random;
        u32 entrylo0;
        u32 entrylo1;
        u32 context;
        u32 pagemask;
        u32 wired;
        u32 cop0_7;
        u32 cop0_8;
        u32 cop0_9;
        u32 entryhi;
        u32 cop0_11;
        u32 cop0_12;
        u32 cop0_13;
        u32 cop0_14;
        /* PRId should still be okay */
        u32 prid;
        u32 padding[100];
} PspDebugRegBlock;

typedef void (*PspDebugErrorHandler)(PspDebugRegBlock *regs);

int pspDebugInstallErrorHandler(PspDebugErrorHandler handler);

void pspDebugDumpException(PspDebugRegBlock *regs);

typedef int (*PspDebugKprintfHandler)(const char *format, u32 *args);

int pspDebugInstallKprintfHandler(PspDebugKprintfHandler handler);

typedef struct _PspDebugStackTrace
{
        u32 call_addr;
        u32 func_addr;
} PspDebugStackTrace;

int pspDebugGetStackTrace2(PspDebugRegBlock *regs, PspDebugStackTrace *trace, int max);

typedef struct _PspDebugProfilerRegs
{
        volatile u32 enable;
        volatile u32 systemck;
        volatile u32 cpuck;
        volatile u32 internal;
        volatile u32 memory;
        volatile u32 copz;
        volatile u32 vfpu;
        volatile u32 sleep;
        volatile u32 bus_access;
        volatile u32 uncached_load;
        volatile u32 uncached_store;
        volatile u32 cached_load;
        volatile u32 cached_store;
        volatile u32 i_miss;
        volatile u32 d_miss;
        volatile u32 d_writeback;
        volatile u32 cop0_inst;
        volatile u32 fpu_inst;
        volatile u32 vfpu_inst;
        volatile u32 local_bus;
} PspDebugProfilerRegs;

void pspDebugProfilerEnable(void);

void pspDebugProfilerDisable(void);

void pspDebugProfilerClear(void);

void pspDebugProfilerGetRegs(PspDebugProfilerRegs *regs);

void pspDebugProfilerPrint(void);

typedef int (*PspDebugPrintHandler)(const char *data, int len);

typedef int (*PspDebugInputHandler)(char *data, int len);

int pspDebugInstallStdinHandler(PspDebugInputHandler handler);

int pspDebugInstallStdoutHandler(PspDebugPrintHandler handler);

int pspDebugInstallStderrHandler(PspDebugPrintHandler handler);

void pspDebugSioPutchar(int ch);

int pspDebugSioGetchar(void);

void pspDebugSioPuts(const char *str);

int pspDebugSioPutData(const char *data, int len);

int pspDebugSioPutText(const char *data, int len);

void pspDebugSioInit(void);

void pspDebugSioSetBaud(int baud);

void pspDebugEnablePutchar(void);

void pspDebugSioInstallKprintf(void);

void pspDebugGdbStubInit(void);

void pspDebugBreakpoint(void);

void pspDebugSioEnableKprintf(void);

void pspDebugSioDisableKprintf(void);

#ifdef __cplusplus
}
#endif

#endif