Intel® Quartus® Prime Pro Edition User Guide: Scripting
A newer version of this document is available. Customers should click here to go to the newest version.
Visible to Intel only — GUID: reference_TCL_tcl_pkg_insystem_memory_edit_ver_1_0_cmd_save_content_from_memory_to_file
Ixiasoft
Visible to Intel only — GUID: reference_TCL_tcl_pkg_insystem_memory_edit_ver_1_0_cmd_save_content_from_memory_to_file
Ixiasoft
4.1.15.5. save_content_from_memory_to_file (::quartus::insystem_memory_edit)
The following table displays information for the save_content_from_memory_to_file Tcl command:
Tcl Package and Version | Belongs to ::quartus::insystem_memory_edit |
||
Syntax | save_content_from_memory_to_file [-h | -help] [-long_help] -instance_index <instance index> -mem_file_path <path> -mem_file_type <type> [-timeout <timeout> ] | ||
Arguments | -h | -help | Short help | |
-long_help | Long help with examples and possible return values | ||
-instance_index <instance index> | Index of the editable memory instance to read | ||
-mem_file_path <path> | Path to the memory file in which to save the memory content | ||
-mem_file_type <type> | Type of the memory file such as "mif" or "hex" | ||
-timeout <timeout> | amount of time in milliseconds allocated before read times out. Defaults to 10 seconds | ||
Description | Retrieves the entire memory contents from the specified editable memory instance starting from address 0 and saves it into the specified memory file. |
||
Example Usage | # Initiate a editing sequence begin_memory_edit -hardware_name "USB-Blaster \[USB-0\]" -device_name "@1: EP1S25/_HARDCOPY_FPGA_PROTOTYPE (0x020030DD)" # Write memory content using the hex memory file update_content_to_memory_from_file -instance_index 0 -mem_file_path "image_8x1024.hex" -mem_file_type hex # Read memory content and save back to a hex memory file save_content_from_memory_to_file -instance_index 0 -mem_file_path "exported_image_8x1024.hex" -mem_file_type hex # Write memory content using the mif memory file update_content_to_memory_from_file -instance_index 0 -mem_file_path "exported_image_8x1024.mif" -mem_file_type mif # Read memory content and save back to a mif memory file save_content_from_memory_to_file -instance_index 0 -mem_file_path "image_8x1024.mif" -mem_file_type mif -timeout 30000 # End the editing sequence end_memory_edit |
||
Return Value | Code Name | Code | String Return |
TCL_OK | 0 | INFO: Operation successful | |
TCL_ERROR | 1 | ERROR: A memory edit sequence has not been started. | |
TCL_ERROR | 1 | ERROR: The specified memory file cannot be written to. | |
TCL_ERROR | 1 | ERROR: The specified file type is either invalid or unsupported by this command. | |
TCL_ERROR | 1 | ERROR: The specified editable memory instance index is invalid. | |
TCL_ERROR | 1 | ERROR: JTAG communication error is detected. It can be caused by the hardware failure or poor signal integrity in the JTAG chain. | |
TCL_ERROR | 1 | ERROR: The device is locked by another application. |