You've already forked HackerSM64
mirror of
https://github.com/HackerN64/HackerSM64.git
synced 2026-01-21 10:35:32 -08:00
0e048762d5
* Replace debug libultra builds with their ido counterparts This is necessary because GameCube controllers apparently rely on the IDO build, also the release build is IDO anyway * Remove fallthrough warnings from usb/debug.c * remove need for debug libultra with unf and use lib define in ld Co-authored-by: thecozies <collinpferguson@gmail.com>
159 lines
5.4 KiB
C
159 lines
5.4 KiB
C
#ifndef UNFL_DEBUG_H
|
|
#define UNFL_DEBUG_H
|
|
|
|
/*********************************
|
|
Settings macros
|
|
*********************************/
|
|
|
|
// Settings
|
|
#define DEBUG_MODE 1 // Enable/Disable debug mode
|
|
#define DEBUG_INIT_MSG 1 // Print a message when debug mode has initialized
|
|
#define USE_FAULTTHREAD 1 // Create a fault detection thread (libultra only)
|
|
// #define OVERWRITE_OSPRINT 1 // Replaces osSyncPrintf calls with debug_printf (defined in makefile - libultra_rom does not have osSyncPrintf)
|
|
#define MAX_COMMANDS 25 // The max amount of user defined commands possible
|
|
|
|
// Fault thread definitions (libultra only)
|
|
#define FAULT_THREAD_ID 13
|
|
#define FAULT_THREAD_PRI 125
|
|
#define FAULT_THREAD_STACK 0x2000
|
|
|
|
// USB thread definitions (libultra only)
|
|
#define USB_THREAD_ID 14
|
|
#define USB_THREAD_PRI 126
|
|
#define USB_THREAD_STACK 0x2000
|
|
|
|
|
|
/*********************************
|
|
Debug Functions
|
|
*********************************/
|
|
|
|
#if DEBUG_MODE
|
|
|
|
/*==============================
|
|
debug_initialize
|
|
Initializes the debug and USB library.
|
|
==============================*/
|
|
|
|
extern void debug_initialize();
|
|
|
|
|
|
/*==============================
|
|
debug_printf
|
|
Prints a formatted message to the developer's command prompt.
|
|
Supports up to 256 characters.
|
|
@param A string to print
|
|
@param variadic arguments to print as well
|
|
==============================*/
|
|
|
|
extern void debug_printf(const char* message, ...);
|
|
#if OVERWRITE_OSPRINT == 0
|
|
#define osSyncPrintf debug_printf
|
|
#endif
|
|
|
|
/*==============================
|
|
debug_dumpbinary
|
|
Dumps a binary file through USB
|
|
@param The file to dump
|
|
@param The size of the file
|
|
==============================*/
|
|
|
|
extern void debug_dumpbinary(void* file, int size);
|
|
|
|
|
|
/*==============================
|
|
debug_screenshot
|
|
Sends the currently displayed framebuffer through USB.
|
|
DOES NOT PAUSE DRAWING THREAD! Using outside the drawing
|
|
thread may lead to a screenshot with visible tearing
|
|
==============================*/
|
|
|
|
extern void debug_screenshot();
|
|
|
|
|
|
/*==============================
|
|
debug_assert
|
|
Halts the program if the expression fails.
|
|
@param The expression to test
|
|
==============================*/
|
|
|
|
#define debug_assert(expr) (expr) ? ((void)0) : _debug_assert(#expr, __FILE__, __LINE__)
|
|
|
|
|
|
/*==============================
|
|
debug_pollcommands
|
|
Check the USB for incoming commands.
|
|
==============================*/
|
|
|
|
extern void debug_pollcommands();
|
|
|
|
|
|
/*==============================
|
|
debug_addcommand
|
|
Adds a command for the USB to read.
|
|
@param The command name
|
|
@param The command description
|
|
@param The function pointer to execute
|
|
==============================*/
|
|
|
|
extern void debug_addcommand(char* command, char* description, char*(*execute)());
|
|
|
|
|
|
/*==============================
|
|
debug_parsecommand
|
|
Stores the next part of the incoming command into the provided buffer.
|
|
Make sure the buffer can fit the amount of data from debug_sizecommand!
|
|
If you pass NULL, it skips this command.
|
|
@param The buffer to store the data in
|
|
==============================*/
|
|
|
|
extern void debug_parsecommand(void* buffer);
|
|
|
|
|
|
/*==============================
|
|
debug_sizecommand
|
|
Returns the size of the data from this part of the command.
|
|
@return The size of the data in bytes, or 0
|
|
==============================*/
|
|
|
|
extern int debug_sizecommand();
|
|
|
|
|
|
/*==============================
|
|
debug_printcommands
|
|
Prints a list of commands to the developer's command prompt.
|
|
==============================*/
|
|
|
|
extern void debug_printcommands();
|
|
|
|
|
|
// Ignore this, use the macro instead
|
|
extern void _debug_assert(const char* expression, const char* file, int line);
|
|
|
|
// Include usb.h automatically
|
|
#include "usb.h"
|
|
|
|
#else
|
|
|
|
// Overwrite library functions with useless macros if debug mode is disabled
|
|
#define debug_initialize()
|
|
#define debug_printf(__VA_ARGS__)
|
|
#define debug_screenshot(a, b, c)
|
|
#define debug_assert(a)
|
|
#define debug_pollcommands()
|
|
#define debug_addcommand(a, b, c)
|
|
#define debug_parsecommand() NULL
|
|
#define debug_sizecommand() 0
|
|
#define debug_printcommands()
|
|
#define usb_initialize() 0
|
|
#define usb_getcart() 0
|
|
#define usb_write(a, b, c)
|
|
#define usb_poll() 0
|
|
#define usb_read(a, b)
|
|
#define usb_skip(a)
|
|
#define usb_rewind(a)
|
|
#define usb_purge()
|
|
|
|
#endif
|
|
|
|
#endif
|