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.
Flash Software Breakpoints
arm_target_read_only_software_breakpoints – Enumeration
Specifies how software breakpoints set in read-only (Flash) memory are handled. Options are Disabled (no software breakpoints used), Permanent (software breakpoints are set permanently on download), and Dynamic (software breakpoints are set and cleared as required).
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
Leave Target Running
debug_leave_target_running – Boolean
Debugger will leave the target running on debug stop.
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.
RAM Software Breakpoints
arm_target_read_write_software_breakpoints – Enumeration
Specifies software breakpoints set in read-write memory are handled. Options are Disabled (no software breakpoints used), Permanent (software breakpoints are set permanently on download), and Dynamic (software breakpoints are set and cleared as required).
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.
Register Definition File Type
debug_register_definition_file_type – Enumeration
The type 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.
SWI Handler Name
swiHandler_name – String
The name of the swi handler symbol. Used for backtracing out of exception handlers.
Set Initial Breakpoint At
debug_initial_breakpoint – String
An initial breakpoint to set if no other breakpoints exist
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 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.

JTAG Chain

Property Description
JTAG Data Bits After
arm_linker_jtag_pad_post_dr – IntegerRange
Specifies the number of bits to pad the JTAG data register after the target.
JTAG Data Bits Before
arm_linker_jtag_pad_pre_dr – IntegerRange
Specifies the number of bits to pad the JTAG data register before the target.
JTAG Instruction Bits After
arm_linker_jtag_pad_post_ir – IntegerRange
Specifies the number of bits to pad the JTAG instruction register with the BYPASS instruction after the target.
JTAG Instruction Bits Before
arm_linker_jtag_pad_pre_ir – IntegerRange
Specifies the number of bits to pad the JTAG instruction register with the BYPASS instruction before the target.

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 ROM|RAM;START;SIZE for example ROM;0x0;0x10000;RAM;0x20000000;0x1000
Memory Simulation Parameter Macros
arm_simulator_memory_simulation_parameter_macros – StringList
Macros to apply to the parameter passed to the memory simulation on creation.
Run Target Loader
arm_simulator_run_target_loader – Boolean
Run the target loader.
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 Control

Property Description
ARM Debug Interface
arm_target_debug_interface_type – Enumeration
Specifies the type of debug interface the target has. The options are:
  • Default - Select debug interface based on CPU core type
  • ARM7TDI - ARM7TDMI/ARM7TDMI-S/ARM720T
  • ARM9TDI - ARM920T/ARM946E-S/ARM966E-S/ARM968E-S/ARM926EJ-S
  • ARM11 - ARM1136J-S/ARM1136JF-S/ARM1176JZ-S/ARM1176JZF-S
  • XScale - PXA25x
  • XScale7BitIR - PXA27x
  • ADIv5 - Cortex-A/Cortex-M/Cortex-R
  • Feroceon - Marvell ARM9E
Connect With Reset
arm_target_connect_with_reset – Boolean
Hold the target in hardware reset on connect and stops the target. This requires the nSRST signal to be connected and the target debug hardware to work when in reset.
Coprocessor Instruction Execution Address
arm_target_coprocessor_execute_address – String
Specifies the address of read/write memory that the debugger can use to execute coprocessor instructions.
Debug Handler File Path
arm_target_debug_handler_file_path – ProjFileName
The file path to the debug handler to use, this entry should be blank if no debug handler is required. This property will have macro expansion applied to it.
Debug Handler Load Address
arm_target_debug_handler_load_address – String
The address to load the debug handler.
Do Not Use bkpt Instruction
arm_target_do_not_use_bkpt – Boolean
Specifies that the bkpt instructions should not be used when setting software breakpoints on ARM architectures that support the instruction.
Monitor Mode Debug
arm_target_monitor_mode_debug – Boolean
Specifies whether the debug handler is a monitor mode debug handler.
Monitor Mode Memory
arm_target_monitor_mode_memory – Boolean
Specifies whether to use monitor mode memory accesses.
Processor Stop Timeout
arm_target_processor_stop_timeout – IntegerRange
The timeout period for stopping the processor in milliseconds.
Restrict Memory Accesses
arm_target_restrict_memory_accesses – Boolean
Specifies whether memory accesses should be restricted to known memory segments and their associated access attributes.
Stop CPU Using DBGRQ
arm_target_stop_cpu_using_dbgrq – Boolean
Specifies whether the CPU should be stopped by asserting DBGRQ rather than by using breakpoints.
Target Interface Clock Speed
arm_target_interface_speed – IntegerRange
The maximum JTAG/SWD clock frequency in Hz.
Target Interface Type
arm_target_interface_type – Enumeration
Specifies the type of interface the target has. The options are:
  • Default - Select target interface type based on CPU core type and SWO usage
  • JTAG - Use JTAG interface
  • SWD - Use SWD interface
Use Debug Handler
arm_target_use_debug_handler – Enumeration
Specifies whether to use a debug handler.

Target Loader

Property Description
Applicable Loaders
arm_target_loader_applicable_loaders – StringList
The set of target loaders that are applicable to the configuration
Can Erase All
arm_target_loader_can_erase_all – Boolean
Loader can erase all of memory
Can Erase Range
arm_target_loader_can_erase_range – Boolean
Loader can erase a range of memory
Can Lock All
arm_target_loader_can_lock_all – Boolean
Loader can lock all of memory
Can Lock Range
arm_target_loader_can_lock_range – Boolean
Loader can lock a range of memory
Can Only Download After Erase
arm_target_loader_can_only_download_after_erase – Boolean
Loader can only download after erase
Can Only Verify With Download
arm_target_loader_can_only_verify_with_download – Boolean
Loader can only verify with download
Can Peek
arm_target_loader_can_peek – Boolean
Loader can peek memory
Can UnLock All
arm_target_loader_can_unlock_all – Boolean
Loader can unlock all of memory
Can UnLock Range
arm_target_loader_can_unlock_range – Boolean
Loader can unlock a range of memory
Default Loader
arm_target_loader_default_loader – String
The default target loader to use for the configuration
Erase All
target_loader_erase_all – Enumeration
If set to Yes, all of the FLASH memory on the target will be erased prior to downloading the application. If set to No, only the areas of FLASH containing the program being downloaded will be erased. If set to Default the behaviour is target specific.
Erase All Timeout
arm_target_loader_erase_all_timeout – IntegerRange
The timeout period for an erase all operation in milliseconds.
First Loader Program Section
arm_target_loader_first_program_section – String
The loader's first program section. This parameter is only required if the program being downloaded overwrites the loader.
Last Loader Program Section
arm_target_loader_last_program_section – String
The loader's last program section. This parameter is only required if the program being downloaded overwrites the loader.
Loader File Path
arm_target_flash_loader_file_path – ProjFileName
The file path to the loader, this entry should be blank if no loader program is required. This property will have macro expansion applied to it.
Loader Load Offset
arm_target_flash_loader_load_offset – String
The offset to load the loader at. This is applicable for loaders built with Emit Relocations.
Loader Parameter
arm_target_loader_parameter – String
The parameter to pass to the loader on startup.
Loader Timeout
arm_target_loader_operation_timeout – IntegerRange
The timeout period for loader operations in milliseconds.
Reset After Download
arm_target_loader_reset_after_download – Boolean
Specifies whether the target should be reset after a program has been downloaded by a loader.

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.
Debug Interface Reset Script
target_debug_interface_reset_script – JavaScript
The script that is executed to reset the debug interface. If not specified the default debug interface reset will be carried out instead.
Disconnect Script
target_disconnect_script – JavaScript
The script that is executed when the target is disconnected from.
Get Part Name Script
target_get_partname_script – JavaScript
The script that returns the part name of the connected target.
Loader Reset Script
target_loader_reset_script – JavaScript
The script that is executed when the target is reset prior to downloading a loader program. If not specified "Reset Script" will be used instead.
Match Part Name Script
target_match_partname_script – JavaScript
The script that matches the part name of the connected target prior to start debugging. The macro $(TARGET) is substituted with the Target project property group value.
Reset Script
target_reset_script – JavaScript
The script that is executed when the target is reset.
Run Script
target_go_script – JavaScript
The script that is executed when the target is run.
Stop Script
target_stop_script – JavaScript
The script that is executed when the target is stopped.
TAP Reset Script
target_TAP_reset_script – String
The script that is executed when the TAP is reset.
Target Extras Script
target_extras_script – JavaScript
The script that is executed to supply extra menu entries in the targets window context menu.
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
ETM Global Timestamping Enable
arm_target_etm_global_timestamping_enable – Boolean
Enable the ETM global timestamping if supported.
ETM TraceID
arm_target_etm_trace_id – IntegerRange
Specifies the traceID of the ETM - zero disables usage.
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 TraceID
arm_target_itm_trace_id – IntegerRange
Specifies the traceID of the ITM - zero disables usage.
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 in bytes.
SWO Baud Rate
arm_target_trace_SWO_speed – IntegerRange
Specifies the baud rate of the SWO - zero selects auto detection.
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