Debug Options - Debug Options - 2026.1 English - UG1702

Vitis Reference Guide (UG1702)

Document ID
UG1702
Release Date
2026-06-23
Version
2026.1 English

The syn.debug commands enable debugging in the HLS component and specify where to write debugging output.

syn.debug.enable
Enable debug file generation. If you do not enable it, HLS can still optimize the component during compilation, but the component cannot be debugged.
syn.debug.enable=1
Tip: This option relates to the v++ -c -g option. You must manually enable this option in the HLS component when debugging at the Application level.
syn.debug.directory
Specifies the location of to write the output of HLS debugging. If you do not specify it, the location sets to hls/.debug.
syn.debug.directory=../../debug