add list

The add list command lists VHDL signals and variables and Verilog nets and registers in the List window, along with their associated values. User-defined buses may also be added for either language.

If no port mode is specified, add list will display all items in the selected region with names matching the item name specification.

Limitations: VHDL variables and Verilog memories can be listed using the variable's full name only (no wildcards).

Syntax

add list

[-allowconstants] [in] [inout] [internal]
[[<item_name> | {<item_name> <options>{sig1 sig2 sig3 ...}}] ...] ... [label <name>] [notrigger | trigger] [out] [ports] [<radix>] [recursive] [width <n>] [window <wname>]

Arguments

-allowconstants

For use with wildcard searches. Specifies that constants matching the wildcard search should be added to the List window. Optional. By default, constants are ignored because they do not change.

in

For use with wildcard searches. Specifies that the scope of the search is to include ports of mode IN if they match the item_name specification. Optional.

inout

For use with wildcard searches. Specifies that the scope of the search is to include ports of mode INOUT if they match the item_name specification. Optional.

internal

For use with wildcard searches. Specifies that the scope of the search is to include internal items (non-port items) if they match the item_name specification. VHDL variables are not selected. Optional.

<item_name>

Specifies the name of the item to be listed. Optional. Wildcard characters are allowed. Variables may be added if preceded by the process name. For example,

add list myproc/int1

{<item_name> <options>{sig1 sig2 sig3 ...}}

Creates a user-defined bus in place of <item_name>; `sigi' are signals to be concatenated within the user-defined bus. Optional. Specified items may be either scalars or various sized arrays as long as they have the same element enumeration type. The following option is available:

keep

The original specified items are not removed; otherwise they are removed.

label <name>

Specifies an alternative signal name to be displayed as a column heading in the listing. Optional. This alternative name is not valid in a force or examine command; however, it can optionally be used in a search command with the list option.

notrigger

Specifies that items are to be listed, but does not cause the List window to be updated when the item changes. Optional.

out

For use with wildcard searches. Specifies that the scope of the search is to include ports of mode OUT if they match the item_name specification. Optional.

ports

For use with wildcard searches. Specifies that the scope of the search is to include all ports. Optional. Has the same effect as specifying -in, -out, and -inout together.

<radix>

Specifies the radix for the items that follow in the command. Optional. Valid entries (or unique abbreviations) are:

binary
octal
decimal (or signed)
unsigned
hexadecimal
ascii
symbolic
default

If no radix is specified for an enumerated type, the default representation is used. You can change the default radix for the current simulation using the radix command. You can change the default radix permanently by editing the DefaultRadix variable in the modelsim.ini file.

If you specify a radix for an array of a VHDL enumerated type, ModelSim converts each signal value to 1, 0, Z, or X.

recursive

For use with wildcard searches. Specifies that the scope of the search is to descend recursively into subregions. Optional; if omitted, the search is limited to the selected region.

trigger

Specifies that items are to be listed and causes the List window to be updated when the items change. Optional. Default.

width <n>

Specifies the column width in characters. Optional.

window <wname>

Adds HDL items to the specified List window <wname> (e.g., list2). Optional. Used to specify a particular window when multiple instances of that window type exist. Selects an existing window; does not create a new window. Use the view command with the new option to create a new window.

Note: strobe, collapse, delta, nodelta are no longer part of the add list (formerly the list) command. Use the configure command instead. The command equivalents for the collapse, delta, and nodelta options are shown below; see the configure command for more detail.

.

5.0 or newer	4.6x
configure list delta collapse	list collapse
configure list delta all	list delta
configure list delta none	list nodelta

Examples

add list -r /*

Lists all items in the design.

add list *

Lists all items in the region.

add list -in *

Lists all input ports in the region.

add list a -label sig /top/lower/sig {array_sig(9 to 23)}

Displays a List window containing three columns headed a, sig, and array_sig(9 to 23).

add list clk -notrigger a b c d

Lists clk, a, b, c, and d only when clk changes.

config list -strobeperiod {100 ns} -strobestart {0 ns} -usestrobe 1
add list -notrigger clk a b c d

Lists clk, a, b, c, and d every 100 ns.

add list -hex {mybus {msb {opcode(8 downto 1)} data}}

Creates a user-defined bus named "mybus" consisting of three signals; the bus is displayed in hex.

add list vec1 -hex vec2 -dec vec3 vec4

Lists the item vec1 using symbolic values, lists vec2 in hexadecimal, and lists vec3 and vec4 in decimal.

See also

add wave, log, "Extended identifiers"

Model Technology Incorporated Voice: (503) 641-1340 Fax: (503)526-5410 www.model.com sales@model.com