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