debugforge.example.toml

# DebugForge Project Configuration
#
# Place this file as 'debugforge.toml' in your project root.
# All relative paths are resolved from the directory containing this file.
#
# Environment variables (T32_INSTALL_PATH, T32_NODE, T32_PORT, etc.)
# override these settings when set.

[trace32]
# TRACE32 installation directory (used for error hints and PYRCL wheel path)
install_path = "/opt/t32"

[connection]
# TRACE32 Remote API connection settings
node = "localhost"                         # TRACE32 host address
port = 20000                               # API port (must match your .t32 config)
protocol = "TCP"                           # TCP or UDP
auto_connect = false                       # Connect automatically when server starts

[project]
# Build artifact paths (used by AI agent for loading symbols/firmware)
elf = "output/build/firmware.elf"          # ELF file with debug symbols
map = "output/build/firmware.map"          # MAP file (optional)

[toolchain]
# Cross-compiler toolchain settings (used for disassembly and ELF analysis)
compiler_path = "/opt/hightec/toolchains/tricore/v4.9.3.0/bin"
objdump = "tricore-elf-objdump"            # Disassembly tool
readelf = "tricore-elf-readelf"            # ELF analysis tool
nm = "tricore-elf-nm"                      # Symbol table tool

[build]
# Build system configuration
command = "make -j8"                       # Build command
clean_command = "make clean"               # Clean command
working_dir = "."                          # Build working directory

[scripts]
# PRACTICE script paths (used by AI agent for common operations)
flash = "tools/Trace32/flash.cmm"          # Flash programming script
init = "tools/Trace32/startup.cmm"         # Target initialization / reset script
# Add your own scripts as needed:
# reset = "tools/Trace32/reset.cmm"
# test = "tools/Trace32/run_tests.cmm"

[debug]
# Debug knowledge base
skills_dir = ".debugforge/skills"          # Directory for debug skill files