Difference between revisions of "Modules/debug/Settings"

From MSX Game Library

< Modules‎ | debug

Line 1: Line 1:
Library configuration (<tt>msxgl_config.h</tt>):
+
Library configuration (<tt>msxgl_config.h</tt>) for debug device:
 
<syntaxhighlight lang="c">
 
<syntaxhighlight lang="c">
 
// Debugger options
 
// Debugger options
Line 7: Line 7:
 
// - DEBUG_OPENMSX_P .............. Debug features for openMSX using PVM script (tools/script/openMSX/debugger_pvm.tcl)
 
// - DEBUG_OPENMSX_P .............. Debug features for openMSX using PVM script (tools/script/openMSX/debugger_pvm.tcl)
 
#define DEBUG_TOOL DEBUG_DISABLE
 
#define DEBUG_TOOL DEBUG_DISABLE
 +
</syntaxhighlight>
 +
 +
When <tt>DEBUG_TOOL</tt> is set to <tt>DEBUG_OPENMSX_P</tt>, you also need to setup additionnal emulator command line in your project configuration (<tt>project_config.js</tt>):
 +
<syntaxhighlight lang="js">
 +
//-- Emulator extra parameters to be add to command-line (string). Emulator sotfware specific
 +
EmulExtraParam= `-script ${ToolsDir}script/openMSX/debugger_pvm.tcl`;
 +
</syntaxhighlight>
  
 +
Library configuration (<tt>msxgl_config.h</tt>) for profile device:
 +
<syntaxhighlight lang="c">
 
// Profiler options
 
// Profiler options
 
// - PROFILE_DISABLE .............. No profile tool
 
// - PROFILE_DISABLE .............. No profile tool
Line 16: Line 25:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
When <tt>DEBUG_TOOL</tt> is set to <tt>DEBUG_OPENMSX_P</tt>, you also need to setup additionnal emulator command line in your project configuration (<tt>project_config.js</tt>):
+
When <tt>PROFILE_TOOL</tt> is set to <tt>PROFILE_OPENMSX_G</tt> (Grauw), you also need to setup additionnal emulator command line in your project configuration (<tt>project_config.js</tt>):
<syntaxhighlight lang="js">
 
//-- Emulator extra parameters to be add to command-line (string). Emulator sotfware specific
 
EmulExtraParam= `-script ${ToolsDir}script/openMSX/debugger_pvm.tcl`;
 
</syntaxhighlight>
 
 
 
When <tt>DEBUG_TOOL</tt> is set to <tt>DEBUG_OPENMSX_G</tt>, you also need to setup additionnal emulator command line in your project configuration (<tt>project_config.js</tt>):
 
 
<syntaxhighlight lang="js">
 
<syntaxhighlight lang="js">
 
//-- Emulator extra parameters to be add to command-line (string). Emulator sotfware specific
 
//-- Emulator extra parameters to be add to command-line (string). Emulator sotfware specific
Line 28: Line 31:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
When <tt>DEBUG_TOOL</tt> is set to <tt>DEBUG_OPENMSX_S</tt>, you also need to setup additionnal emulator command line in your project configuration (<tt>project_config.js</tt>):
+
When <tt>PROFILE_TOOL</tt> is set to <tt>PROFILE_OPENMSX_S</tt> (Sallute), you also need to setup additionnal emulator command line in your project configuration (<tt>project_config.js</tt>):
 
<syntaxhighlight lang="js">
 
<syntaxhighlight lang="js">
 
//-- Emulator extra parameters to be add to command-line (string). Emulator sotfware specific
 
//-- Emulator extra parameters to be add to command-line (string). Emulator sotfware specific
EmulExtraParam= `-script ${ToolsDir}script/openMSX/profiler_salute.tcl`;
+
EmulExtraParam= `-script ${ToolsDir}script/openMSX/profiler_salute.tcl -command "profile::section_scope_bp frame 0xFD9F; profile_osd ms;"`;
 
</syntaxhighlight>
 
</syntaxhighlight>

Revision as of 00:13, 19 September 2024

Library configuration (msxgl_config.h) for debug device:

// Debugger options
// - DEBUG_DISABLE ................ No debug tool
// - DEBUG_EMULICIOUS ............. Debug features for Emulicious
// - DEBUG_OPENMSX ................ Debug features for openMSX using 'debugdevice' extension
// - DEBUG_OPENMSX_P .............. Debug features for openMSX using PVM script (tools/script/openMSX/debugger_pvm.tcl)
#define DEBUG_TOOL					DEBUG_DISABLE

When DEBUG_TOOL is set to DEBUG_OPENMSX_P, you also need to setup additionnal emulator command line in your project configuration (project_config.js):

//-- Emulator extra parameters to be add to command-line (string). Emulator sotfware specific
EmulExtraParam= `-script ${ToolsDir}script/openMSX/debugger_pvm.tcl`;

Library configuration (msxgl_config.h) for profile device:

// Profiler options
// - PROFILE_DISABLE .............. No profile tool
// - PROFILE_OPENMSX_G ............ Profiler features for openMSX using Grauw script (tools/script/openMSX/profiler_grauw.tcl)
// - PROFILE_OPENMSX_S ............ Profiler features for openMSX using Salutte script (tools/script/openMSX/profiler_salutte.tcl)
#define PROFILE_TOOL				PROFILE_DISABLE
#define PROFILE_LEVEL				10

When PROFILE_TOOL is set to PROFILE_OPENMSX_G (Grauw), you also need to setup additionnal emulator command line in your project configuration (project_config.js):

//-- Emulator extra parameters to be add to command-line (string). Emulator sotfware specific
EmulExtraParam= `-script ${ToolsDir}script/openMSX/profiler_grauw.tcl`;

When PROFILE_TOOL is set to PROFILE_OPENMSX_S (Sallute), you also need to setup additionnal emulator command line in your project configuration (project_config.js):

//-- Emulator extra parameters to be add to command-line (string). Emulator sotfware specific
EmulExtraParam= `-script ${ToolsDir}script/openMSX/profiler_salute.tcl -command "profile::section_scope_bp frame 0xFD9F; profile_osd ms;"`;