Summary of C-SPY command line options

Skip to main content

IAR Embedded Workbench for RISC-V 3.40

Summary of C-SPY command line options

In this section:

General cspybat options

`‑‑application_args`	Passes command line arguments to the debugged application.
`‑‑attach_to_running_target`	Makes the debugger attach to a running application at its current location, without resetting the target system.
`‑‑backend`	Marks the beginning of the parameters to be sent to the C-SPY driver (mandatory).
`‑‑code_coverage_file`	Enables the generation of code coverage information and places it in a specified file.
`‑‑cycles`	Specifies the maximum number of cycles to run.
`‑‑debug_file`	Specifies an alternative debug file.
`‑‑device_macro`	Specifies a C-SPY device macro file.
`‑‑download_only`	Downloads a code image without starting a debug session afterwards.
`-f`	Extends the command line.
`‑‑flash_loader`	Specifies a flash loader specification XML file.
`‑‑leave_target_running`	Makes the debugger leave the application running on the target hardware after the debug session is closed.
`‑‑macro`	Specifies a macro file to be used.
`‑‑macro_param`	Assigns a value to a C-SPY macro parameter.
`‑‑plugin`	Specifies a plugin file to be used.
`‑‑silent`	Omits the sign-on message.
`‑‑sockets`	Makes the debugger use sockets instead of pipes for its internal communication.
`‑‑suppress_entrypoint_warning`	Disables the warning when the ELF entry point is at address `0x0`.
`‑‑timeout`	Limits the maximum allowed execution time.

Options available for all C-SPY drivers

`‑‑core`	Specifies the core to be used.
`-p`	Specifies the device description file to be used.

Options available for the simulator driver

`‑‑disable_interrupts`	Disables the interrupt simulation.
`‑‑disable_misalignment_exception`	Allows accesses to misaligned data.
`‑‑function_profiling`	Analyzes your source code to find where the most time is spent during execution.
`‑‑mapu`	Activates memory access checking.
`‑‑multicore_nr_of_cores`	Specifies the number of cores on the device for multicore debugging.

Options available for all hardware debugger drivers

`‑‑drv_communication`	Specifies the communication link to be used.
`‑‑drv_communication_log`	Creates a log file.
`‑‑drv_default_breakpoint`	Sets the type of breakpoint resource to be used when setting breakpoints.
`‑‑drv_exclude_from_verify`	Excludes memory ranges from being verified.
`‑‑drv_reset_to_cpu_start`	Omits setting the `PC` when resetting the application.
`‑‑drv_restore_breakpoints`	Restores automatically any breakpoints that were destroyed during system startup.
`‑‑drv_vector_table_base`	Specifies the location of the Cortex-M reset vector and the initial stack pointer value.

Options available for the C-SPY I-jet driver

`‑‑drv_catch_exceptions`	Makes the application stop for certain exceptions.
`‑‑drv_interface`	Selects the communication interface.
`‑‑drv_interface_speed`	Specifies the JTAG interface speed.
`‑‑drv_suppress_download`	Suppresses download of the executable image. For reference information, see Download, specifically the option Suppress download.
`‑‑drv_system_bus_access`	Enables Live Watch and Live Memory reads for devices that support system bus access.
`‑‑drv_verify_download`	Verifies the target program. For reference information, see Download, specifically the option Verify download.
`‑‑jet_board_cfg`	Specifies a probe configuration file.
`‑‑jet_board_did`	Selects which CPU to debug on a multicore system.
`‑‑jet_ir_length`	Specifies the number of IR bits preceding the core to connect to.
`‑‑jet_itc_output`	Sends text to the `stdout` and `stderr` streams by way of trace output, for SiFive devices with an ITC.
`‑‑jet_power_from_probe`	Specifies the power supply from the I-jet or I-jet Trace probe.
`‑‑jet_script_file`	Specifies the reset script file.
`‑‑jet_sigprobe_opt`	Sets the main trace mode for the debug probe.
`‑‑jet_standard_reset`	Selects the reset strategy to be used when C-SPY starts.
`‑‑jet_startup_connection_timeout`	Prolongs the time that the C-SPY driver tries to connect to the target board.
`‑‑jet_tap_position`	Selects a specific device in the JTAG scan chain.
`‑‑reset_style`	Specifies the reset strategies that will be available when debugging.

Options available for the C-SPY GDB Server driver

‑‑gdbserv_exec_command

Sends a command string to the GDB Server.

Options available for the C-SPY third-party drivers

For information about any options specific to the third-party driver you are using, see its documentation.