Summary of C-SPY command line options

Skip to main content

IAR Embedded Workbench for RX 5.20

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.
`‑‑download_only`	Downloads a code image without starting a debug session afterwards.
`-f`	Extends the command line.
`‑‑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.
`‑‑rtc_enable`	Enables C-RUN runtime error checking in `cspybat`.
`‑‑rtc_output`	Specifies to `cspybat` a file for the C-RUN message output.
`‑‑rtc_raw_to_txt`	Makes `cspybat` act as a runtime checking message filter by reading a file as input.
`‑‑rtc_rules`	Specifies a file for the C-RUN rules to `cspybat`.
`‑‑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.
`-d`	Specifies the C-SPY driver to be used.
`--double`	Specifies the size of the type `double`.
`--endian`	Specifies the byte order for data.
`--fpu`	Specifies how the code was compiled with regards to handling floating-point operations.
`--int`	Specifies the size of the type `int`.
`-p`	Specifies the device description file to be used.

Options available for the simulator driver

`‑‑disable_interrupts`	Disables the interrupt simulation.
`‑‑function_profiling`	Analyzes your source code to find where the most time is spent during execution.
`‑‑mapu`	Activates memory access checking.
`‑‑tfu`	Enables C-SPY support for the TFU that is available for some devices based on the RXv3 architecture.
`--tfu_version`	Specifies the TFU version to use when the `--tfu` option has been specified.

Options available for all C-SPY hardware debugger drivers

`‑‑cspybat_inifile`	Specifies a saved hardware settings file.
`--diag_warning`	Treats specified debugger messages as warnings.
`--drv_communication`	Identifies which emulator you are using.
`--drv_mode`	Controls the behavior of the debugger when code is downloaded.
`‑‑log_file`	Creates a log file.
`--set_pc_to_entry_symbol`	Makes the debugger start executing from the entry symbol found in the output ELF file.
`‑‑suppress_download`	Suppresses download of the executable image.
`‑‑verify_download`	Verifies the executable image.

Options available for the E1/E20 and E2/E2 Lite/EZ-CUBE2 drivers

--flash_only_changed_blocks

Downloads just the flash memory blocks that have been changed.

Options available for the J-Link driver

`--device_select`	Selects a specific device in the JTAG scan chain.
`--ir_length`	Sets the number of IR bits before the device to be debugged.