Debugger

Property Description
Access Variables Within Memory Map Only
debug_restrict_memory_access – Boolean
If enabled the debugger will only display variables located in the memory map.
Command Arguments
debug_command_arguments – String
The command arguments passed to the executable. This property will have macro expansion applied to it.
DABORT Handler Name
dabortHandler_name – String
The name of the dabort handler symbol. Used for backtracing out of exception handlers.
Debug Dependent Projects
debug_dependent_projects – Boolean
Debugger will debug dependent projects.
Debug Symbols File
external_debug_symbols_file_name – ProjFileName
The name of the debug symbols file. This property will have macro expansion applied to it. If it is not defined then the main load file is used.
Debug Symbols Load Address
external_debug_symbols_load_address – String
The (code) address to be added to the debug symbol (code) addresses.
Default debugIO implementation
arm_debugIO_Implementation – Enumeration
The default debugIO implementation.
Entry Point Symbol
debug_entry_point_symbol – String
Debugger will start execution at symbol if defined.
FIQ Handler Name
fiqHandler_name – String
The name of the fiq handler symbol. Used for backtracing out of exception handlers.
IRQ Handler Name
irqHandler_name – String
The name of the irq handler symbol. Used for backtracing out of exception handlers.
Ignore .debug_aranges Section
debug_ignore_debug_aranges – Boolean
The debugger will not use the .debug_aranges section.
Ignore .debug_frame Section
debug_ignore_debug_frame – Boolean
The debugger will not use the .debug_frame section.
Initial Breakpoint Is Set
debug_initial_breakpoint_set_option – Enumeration
Specify when the initial breakpoint should be set
Load Offset
debug_load_file_offset – String
The offset to add to the load address of the load file.This offset is added to any absolute relocations of symbols (whose address is less than Load Offset Symbol Limit) if the load file contains relocation sections.
Load Offset Symbol Limit
debug_load_file_limit – String
If set apply the Load Offset logic to only those symbols that have addresses less than the specified limit.
PABORT Handler Name
pabortHandler_name – String
The name of the pabort handler symbol. Used for backtracing out of exception handlers.
RTT Control Block Address
debug_RTTCB – String
The symbol or 0x prefixed address of the RTT control block.
RTT Enable
debug_enable_RTT – Boolean
If enabled the debugger will service RTT input/output in the debug terminal.
Register Definition File
debug_register_definition_file – ProjFileName
The name of the file containing register definitions.
Reserved Member Name
reservedMember_name – String
The struct reserved member name. Struct members that contain the (case insensitive) string will not be displayed.
Run To
debug_initial_breakpoint – String
An initial breakpoint to set if no other breakpoints exist
SWI Handler Name
swiHandler_name – String
The name of the swi handler symbol. Used for backtracing out of exception handlers.
Start Address
external_start_address – String
The address to start the externally built executable running from.
Start From Entry Point Symbol
debug_start_from_entry_point_symbol – Boolean
If yes the debugger will start execution from the entry point symbol.If no the debugger will start execution from the core specific location.
Starting Stack Pointer Value
debug_stack_pointer_start – String
The symbol or 0x prefixed value to set the stack pointer on start debugging.
Startup Completion Point
debug_startup_completion_point – String
Specifies the point in the program where startup is complete. Software breakpoints and debugIO will be enabled after this point has been reached.
Target Connection
debug_target_connection – Enumeration
Specifies the target to connect to for debugging actions.
Target Device
arm_target_device_name – String
The name of the device to connect to. The macro $(Target) is substituted with the Target Processor project property value.
Thread Maximum
debug_threads_max – IntegerRange
The maximum number of threads to display.
Threads Script File
debug_threads_script – ProjFileName
The threads script used by the debugger.
Type Interpretation File
debug_type_file – FileName
Specifies the type interpretation file to use.
UNDEF handler name
undefHandler_name – String
The name of the undef handler symbol. Used for backtracing out of exception handlers.
Working Directory
debug_working_directory – DirPath
The working directory for a debug session. This property will have macro expansion applied to it.

J-Link

Property Description
Additional J-Link Options
JLinkExecuteCommand – StringList
Specify additional J-Link options to allow enabling or disabling advanced features and fine tuning.
For more information see J-Link Command Strings
Enable Adaptive Clocking
adaptive – Enumeration
Adaptive clocking is enabled.
Exclude Flash Cache Range
JLinkExcludeFlashCacheRange – String
Address range to exclude from flash cache.
This can be specified by either 'start_address-end_address' or 'address,size'.
For example: 0x08000000,0x10000.
Host Connection
Connection – Enumeration
Defines how to connect the host to the J-Link:
  • "USB": Connect to J-Link via USB
  • "USB S/N": Connect to J-Link with specified serial number via USB e.g. USB 174300001
  • "IP S/N": Connect to J-Link with specified serial number via IP e.g. IP 174300001
  • "IP n.n.n.n": Connect to J-Link with specified IP address e.g. IP 192.168.20.20
JTAG Instruction Register Size Before Target
arm_linker_jtag_pad_post_ir – IntegerRange
Specifies the number of bits in the instruction register before the target (as seen from TDI), which is the number of bits to pad the JTAG instruction register with the BYPASS instruction after the target instruction.
JTAG Number Of Devices Before Target
arm_linker_jtag_pad_post_dr – IntegerRange
Specifies the number of devices before the target (as seen from TDI), which is the number of bits to pad the JTAG data register.
Log File
JLinkLogFileName – FileName
The file to output the J-Link log to.
Script File
JLinkScriptFileName – FileName
The file path of the optional J-Link script file to use.
Show Log Messages In Output Window
showLog – Enumeration
Display the J-Link log messages to the output window.
Speed
speed – IntegerRange
The required JTAG/SWD clock frequency in kHz (0 to auto-detect best possible).
Supply Power
supplyPower – Enumeration
The J-Link supplies power to the target.
Target Interface Type
arm_target_interface_type – Enumeration
Specifies the type of interface the target has. The options are:
  • JTAG - Use JTAG interface
  • SWD - Use SWD interface

Loader

Property Description
Additional Load File Address[0]
debug_additional_load_file_address – String
The address to load the additional load file.
Additional Load File Address[1]
debug_additional_load_file_address1 – String
The address to load the additional load file.
Additional Load File Address[2]
debug_additional_load_file_address2 – String
The address to load the additional load file.
Additional Load File Address[3]
debug_additional_load_file_address3 – String
The address to load the additional load file.
Additional Load File Type[0]
debug_additional_load_file_type – Enumeration
The file type of the additional load file. The options are Detect, elf, bin, ihex, hex, tihex, srec.
Additional Load File Type[1]
debug_additional_load_file_type1 – Enumeration
The file type of the additional load file. The options are Detect, elf, bin, ihex, hex, tihex, srec.
Additional Load File Type[2]
debug_additional_load_file_type2 – Enumeration
The file type of the additional load file. The options are Detect, elf, bin, ihex, hex, tihex, srec.
Additional Load File Type[3]
debug_additional_load_file_type3 – Enumeration
The file type of the additional load file. The options are Detect, elf, bin, ihex, hex, tihex, srec.
Additional Load File[0]
debug_additional_load_file – ProjFileName
Additional file to load on debug load. This property will have macro expansion applied to it.
Additional Load File[1]
debug_additional_load_file1 – ProjFileName
Additional file to load on debug load. This property will have macro expansion applied to it.
Additional Load File[2]
debug_additional_load_file2 – ProjFileName
Additional file to load on debug load. This property will have macro expansion applied to it.
Additional Load File[3]
debug_additional_load_file3 – ProjFileName
Additional file to load on debug load. This property will have macro expansion applied to it.
Load ELF Sections
debug_load_sections – Enumeration
The debugger will load ELF sections rather than ELF programs.
Load File
external_build_file_name – ProjFileName
The name of the main load file. This property will have macro expansion applied to it. If it is not defined then the output filepath of the linker command is used.
Load File Address
external_load_address – String
The address to download the main load file to.
Load File Type
external_load_file_type – Enumeration
The file type of the main load file. The options are Detect, elf, bin, ihex, hex, tihex, srec.
No Load Sections
target_loader_no_load_sections – StringList
Names of (loadable) sections not to load.

Simulator

Property Description
Memory Simulation File
arm_simulator_memory_simulation_filename – ProjFileName
Specifies the dll that simulates the memory system. This property will have macro expansion applied to it.
Memory Simulation Parameter
arm_simulator_memory_simulation_parameter – String
Parameter passed to the memory simulation.The format of this is specific to the memory simulation. The default memory simulation takes a list of RX|RWX 'hex start address', 'hex size in bytes', 'default hex word value' for example RX 00000000, 10000000, FFFFFFFF;RWX 10000000, 10000000, CDCDCDCD
Memory Simulation Parameter Macros
arm_simulator_memory_simulation_parameter_macros – StringList
Macros to apply to the parameter passed to the memory simulation on creation.
Stop On Memory Error
arm_simulator_stop_on_read_write – Enumeration
Specifies the simulator behaviour when a memory error occurs.
Trace Buffer Size
arm_simulator_num_trace_entries – Integer
The number of trace entries to store.

Target Script

Property Description
Attach Script
target_attach_script – JavaScript
The script that is executed when the target is attached to.
Connect Script
target_connect_script – JavaScript
The script that is executed when the target is connected to.
Debug Begin Script
target_debug_begin_script – JavaScript
The script that is executed when the debugger begins a debug session.
Debug End Script
target_debug_end_script – JavaScript
The script that is executed when the debugger ends a debug session.
Disconnect Script
target_disconnect_script – JavaScript
The script that is executed when the target is disconnected from.
Reset Script
target_reset_script – JavaScript
The script that is executed when the target is reset.
Target Script File
target_script_file – FileName
The target script file, the contents of this file are prepended to script project properties before they are executed.

Target Trace

Property Description
ITM Stimulus Port To Display
arm_target_itm_stimulus_port_display – IntegerRange
Specifies the ITM Stimulus port to display in the debug terminal -1 disables this
ITM Stimulus Ports Enable
arm_target_itm_stimulus_port_enable – IntegerHex
Specifies the ITM Stimulus ports to enable.
ITM Stimulus Ports Privilege
arm_target_itm_stimulus_port_privilege – IntegerHex
Specifies the ITM Stimulus ports to enable.
ITM Timestamping
arm_target_itm_timestamping_enable – Enumeration
Specifies ITM timestamping. The options are:
  • Disable - disable timestamping
  • Local - use the local timestamp clock
  • Global - use the global timestamp clock
ITM/DWT Data Trace PC
arm_target_dwt_data_trace_PC – Boolean
Specifies whether to trace the PC on data trace.
ITM/DWT PC Sampling
arm_target_dwt_PC_sampling_enable – Enumeration
Specifies the DWT PC sampling rate.
ITM/DWT Trace Exceptions
arm_target_dwt_trace_exceptions – Boolean
Specifies whether to trace exception entry and return.
MTB RAM Address
arm_target_mtb_ram_address – IntegerHex
Specifies the MTB RAM Address - note that this must be aligned to the MTB RAM size.
MTB RAM Size
arm_target_mtb_ram_size – Enumeration
Specifies the MTB RAM Size
SWO Baud Rate
arm_target_trace_SWO_speed – IntegerRange
The baud rate of the SWO.
Trace Clock Speed
arm_target_trace_clock_speed – IntegerRange
The speed of the trace clock. This is usually the same as the CPU clock and is used to program the prescaler for the SWO
Trace Initialize Script
target_trace_initialize_script – JavaScript
The script that is executed to initialize the target trace hardware. When executed this script has the macro $(TraceInterfaceType) expanded with value of the Trace Interface Type property, typically it is EnableTrace("$(TraceInterfaceType)").
Trace Interface Type
arm_target_trace_interface_type – Enumeration
Specifies the type of trace interface the target has. The options are:
  • SWO - Use asynchronous SWO trace interface.
  • TracePort - Use synchronous parallel trace interface.
  • ETB - Use on-chip embedded trace buffer.
  • MTB - Use on-chip MTB - Cortex-M0+ only.
  • PC Sampling - sample the PC.
  • None
Trace Port Size
arm_target_trace_port_size – Enumeration
Specifies the trace port size the target has. The options are:
  • 1-bit
  • 2-bit
  • 4-bit
  • 8-bit
  • 16-bit
  • 24-bit
  • 32-bit