pspdebug.h

Go to the documentation of this file.

/*
 * PSP Software Development Kit - https://github.com/pspdev
 * -----------------------------------------------------------------------
 * 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>
 *
 */
#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);
 
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