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.3. get_editable_mem_instances (::quartus::insystem_memory_edit)

The following table displays information for the get_editable_mem_instances Tcl command:

Tcl Package and Version

Belongs to ::quartus::insystem_memory_edit

Syntax get_editable_mem_instances [-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
Retrieve a list of editable memory, ROM, or
lpm_constant instances.

A list is returned, each element of which shows the
configuration of each instance.  This element is an
another list that specifies the configuration in the
following order: <instance index> <depth> <width>
<read/write mode> <instance type> <instance name>. The
<read/write mode> can be either "RW" or "W"; <instance
type> can be either "ROM/RAM" or "CONSTANT". An
example showing a list of two instances of different
types is shown below:

{0 1024 8 RW ROM/RAM mem0} {1 1 32 RW CONSTANT con0}

The hardware and device name can be obtained with the
get_hardware_names and get_device_names commands from
the jtag package.

It is recommended that you call this command before
the TCL command, begin_memory_edit.  Within a memory
edit sequence, this command can be applied only to the
same device, on which the memory edit sequence has
started.
Example Usage
# List information of all editable memories
puts "Information on all editable memories:"
puts "index,depth,width,mode,type,name"
foreach instance [get_editable_mem_instances -hardware_name "USB-Blaster \[USB-0\]" -device_name "@1: EP1S25/_HARDCOPY_FPGA_PROTOTYPE (0x020030DD)"] {
	puts "[lindex $instance 0],[lindex $instance 1],[lindex $instance 2],[lindex $instance 3],[lindex $instance 4],[lindex $instance 5]"
}
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: The specified hardware is not found.
TCL_ERROR 1 ERROR: The TCL command get_editable_mem_instances is called within a memory edit sequence for a different device. End the memory edit first.
TCL_ERROR 1 ERROR: An internal TCL interpreter error occurred.