Debugger

Property Description
Alternative LDR Disassembly
debug_alternative_ldr_dis – Boolean
Show alternative disassembly of ldr*/vldr instructions
CPU Register File
debug_cpu_registers_file – ProjFileName
The name of the file containing CPU register definitions.
Command Arguments
debug_command_arguments – String
The command arguments passed to the executable. This property will have macro expansion applied to it.
Debug Additional Configurations
debug_additional_configurations – StringList
The debugger will load and debug the specified additional configurations.
Debug Additional Projects
debug_dependent_projects – StringList
The debugger will load (if not already loaded by Load Additional Projects) and debug the specified additional projects.
Debug Project Name
debug_project_name – String
The name of the project used by the debugger when debugging multiple projects
Debug Symbols File[0]
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 File[1]
external_debug_symbols_file_name1 – 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 File[2]
external_debug_symbols_file_name2 – 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 File[3]
external_debug_symbols_file_name3 – 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[0]
external_debug_symbols_load_address – String
The (code) address to be added to the debug symbol (code) addresses.
Debug Symbols Load Address[1]
external_debug_symbols_load_address1 – String
The (code) address to be added to the debug symbol (code) addresses.
Debug Symbols Load Address[2]
external_debug_symbols_load_address2 – String
The (code) address to be added to the debug symbol (code) addresses.
Debug Symbols Load Address[3]
external_debug_symbols_load_address3 – String
The (code) address to be added to the debug symbol (code) addresses.
Debug Terminal Log File
debug_terminal_log_file – Unknown
A file to write the output from the debug terminal to.
Default debugIO implementation
arm_debugIO_Implementation – Enumeration
The default debugIO implementation used by the debugger if symbols are unavailable.
Display DCC data
arm_display_DCC – Boolean
The debugger will display data that is written to the DCC when debugIO is not used.
Entry Point Symbol
debug_entry_point_symbol – String
Debugger will start execution at symbol if defined.
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).
HTML Watch File
debug_html_watch – ProjFileName
The file used by the debugger's HTML Watch window.
Has Hypervisor Mode
arm_has_hypervisor_mode – Boolean
Show hypervisor mode registers
Has Monitor Mode
arm_has_monitor_mode – Boolean
Show monitor mode registers
Has Vector Catch
arm_has_vector_catch – Boolean
Vector catching is supported
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
debug_initial_breakpoint – String
The initial breakpoint to set
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 Additional Projects
debug_load_additional_projects – StringList
The debugger will load the outputs of the specified additional projects.
Memory Upload Page Size
debug_memory_upload_page_size – Integer
The aligned page size the debugger uses when uploading address ranges.
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.
Restrict Memory Access
debug_restrict_memory_access – Boolean
If enabled the debugger will only display variables and backtrace in the address ranges of the memory map or the sections in the elf file.
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 – Enumeration
If Yes the debugger will start execution from the entry point symbol. If No the debugger will start execution from the target specific location. If Don't the debugger will not start execution.
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 – StringList
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.
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 Address Limit
debug_load_file_offset_limit – String
Restrict the Load ELF Offset.The Load ELF Offset will not be added to addresses greater than or equal to this address.
Load ELF Offset
debug_load_file_offset – String
The offset to add to the load addresses of the ELF programs.This offset is added to any absolute relocations of symbols (whose address is less than Load ELF Offset Limit) if the load file contains relocation sections.
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) program sections or names of memory segments not to load.

Simulator

Property Description
Max Instructions
arm_simulator_max_instructions – String
Maximum number of instructions to execute before simulator is stopped.
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. If not specified then the default memory simulation will be used.
Memory Simulation Parameter
arm_simulator_memory_simulation_parameter – String
Parameter passed to the memory simulation. This property will have macro expansion applied to it.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 or a list of [name] 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. If null then the macro MemorySegments is set to the value of the address ranges specified by the project.
Stop On Branch .
arm_simulator_stop_on_branch_dot – Boolean
Stop when the simulator executes a b . instruction.
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
  • ADIv6 - SoC-600
Check Load Sections Fit Target Description
target_check_load_sections_fit – Boolean
Specifies whether load sections in the program match the memory segments described in the memory map.
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.
Connect With Stop
arm_target_connect_with_stop – Boolean
Stops the target after connect.
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.
Identify Target
arm_target_identify – Boolean
Identify the target on connect.
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 Loader Configurations
arm_target_loader_applicable_loaders – StringList
The set of target loader configurations that are applicable
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
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 Configurations
arm_target_loader_default_loader – StringList
The target loader configuration(s) to use
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 Parameter
arm_target_loader_parameter – String
The parameter to pass to the loader on startup.
Loader RAM Size
arm_target_flash_loader_load_size – String
The size of the RAM region used by the loader. This is required for FLM and STLDR loader types.
Loader RAM Start
arm_target_flash_loader_load_offset – String
The start of the RAM region used by the loader. This is required for FLM and STLDR loader types.
Loader Timeout
arm_target_loader_operation_timeout – IntegerRange
The timeout period for loader operations in milliseconds.
Loader Type
arm_target_loader_type – Enumeration
The type of loader to use.
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.
Load Begin Script
target_load_begin_script – JavaScript
The script that is executed when the debugger begins a load.
Load End Script
target_load_end_script – JavaScript
The script that is executed when the debugger ends a load.
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