Intel® Quartus® Prime Pro Edition User Guide: Scripting

ID 683432
Date 6/20/2022
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.17.1. begin_memory_edit (::quartus::insystem_memory_edit)

The following table displays information for the begin_memory_edit Tcl command:

Tcl Package and Version

Belongs to ::quartus::insystem_memory_edit

Syntax begin_memory_edit [-h | -help] [-long_help] -device_name <device name> -hardware_name <hardware name>
Arguments -h | -help Short help
-long_help Long help with examples and possible return values
-device_name <device name> Name of the device that holds the editable memory instances
-hardware_name <hardware name> Name of the hardware that connects to the JTAG chain
Description
Start the memory editing sequence. The editing
sequence should be terminated with end_memory_edit.
The sequence does not have to be terminated unless the
device configuration is changed or a different device
is edited.

The hardware and device name can be obtained with the
get_hardware_names and get_device_names commands from
the jtag package.
Example Usage
# Instance 0 is configured as {0 1024 8 RW ROM/RAM mem0}

# 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 binary string
write_content_to_memory -instance_index 0 -start_address 575 -word_count 2 -content "0000001011011100" 

# Read back memory content in binary string written 
puts [read_content_from_memory -instance_index 0 -start_address 575 -word_count 2 ]

# Write memory content using hexadecimal string
write_content_to_memory -instance_index 0 -start_address 575 -word_count 2 -content "E2F1" -content_in_hex

# Read back memory content in hexadecimal string written 
puts [read_content_from_memory -instance_index 0 -start_address 575 -word_count 2 -content_in_hex]

# End the editing sequence
end_memory_edit
Return Value Code Name Code String Return
TCL_OK 0 INFO: Operation successful
TCL_ERROR 1 ERROR: The specified device is not found.
TCL_ERROR 1 ERROR: A memory edit sequence has been started. End it first before starting a another one.
TCL_ERROR 1 ERROR: The specified hardware is not found.