Intel® Quartus® Prime Pro Edition User Guide: Scripting

ID 683432
Date 12/13/2021
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

3.1.13.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.

Did you find the information on this page useful?