Intel® Quartus® Prime Pro Edition User Guide: Scripting

ID 683432
Date 9/26/2022
Public

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

Document Table of Contents

4.1.16.6. update_content_to_memory_from_file (::quartus::insystem_memory_edit)

The following table displays information for the update_content_to_memory_from_file Tcl command:

Tcl Package and Version

Belongs to ::quartus::insystem_memory_edit

Syntax update_content_to_memory_from_file [-h | -help] [-long_help] -instance_index <instance index> -mem_file_path <path> -mem_file_type <file 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 modify
-mem_file_path <path> Path to the memory file to load the memory content
-mem_file_type <file type> Type of the memory file such as "mif" or "hex"
-timeout <timeout> amount of time in milliseconds allocated before write times out. Defaults to 10 seconds
Description
		Writes the data stored in the memory file into the
specified memory instance starting from address 0.
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 -timeout 30000

# 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 

# 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 read because the content is corrupt or the configuration does not match the memory to be updated.
TCL_ERROR 1 ERROR: The specified memory file cannot be opened.
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.