create_property - 2024.2 English

Vivado Design Suite Tcl Command Reference Guide (UG835)

Document ID
UG835
Release Date
2024-11-13
Version
2024.2 English

Create property for class of objects(s)

Syntax

create_property [‑description <arg>] [‑type <arg>] [‑enum_values <args>]
    [‑default_value <arg>] [‑file_types <args>] [‑display_text <arg>]
    [‑quiet] [‑verbose] <name> <class>

Returns

The property that was created if success, "" if failure.

Usage

Name Description
[-description] Description of property
[-type] Type of property to create; valid values are: string, int, long, double, bool, enum, file Default: string
[-enum_values] Enumeration values
[-default_value] Default value of type string
[-file_types] File type extensions (without the dot)
[-display_text] Text to display when selecting the file in file browser
[-quiet] Ignore command errors
[-verbose] Suspend message limits during command execution
<name> Name of property to create
<class> Object type to create property for; valid values are: design, net, cell, pin, port, pblock, interface, fileset

Description

Creates a new property of the <type> specified with the user-defined <name> for the specified <class> of objects. The property that is created can be assigned to an object of the specified class with the set_property command, but is not automatically associated with all objects of that class.

The report_property -all command will not report the newly created property for an object of the specified class until the property has been assigned to that object.

Arguments

-description <arg> - (Optional) Provide a description of the property being created. The description will be returned by the Vivado™ Design Suite help system when the property is queried.

-type <arg> - (Optional) The type of property to create. There allowed property types include:

  • string - Allows the new property to be defined with string values. This is the default value when -type is not specified.
  • int - Allows the new property to be defined with short four-byte signed integer values with a range of -2,147,483,648 to 2,147,483,647. If a floating point value is specified for an int property type, the Vivado tool will return an error.
  • long - Specifies signed 64-bit integers with value range of -9,223,372,036,854,775,808 to 9,223,372,036,854,775,807. If a floating point value is specified for an long property type, the tool will return an error.
  • double - Allows the new property value to be defined with a floating point number.
  • bool - Allows the new property to be defined as a boolean with a true (1, or yes) or false (0, or no) value.
  • enum - An enumerated data type, with the valid enumerated values specified by the -enum_values option.
  • string_list - A Tcl list of string values.
  • int_list - A Tcl list of integer values.
  • double_list - A Tcl list of floating point values.

-enum_values <args> - (Optional) A list of enumerated values that the property can have. The list must be enclosed in braces, {}, with values separated by spaces. This option can only be used with -type enum.

-default_value <args> - (Optional) The default value to assign to the property. This option can be used for string, int, bool, and enum type properties.

-quiet - (Optional) Execute the command quietly, returning no messages from the command. The command also returns TCL_OK regardless of any errors encountered during execution.
Note: Any errors encountered on the command-line, while launching the command, will be returned. Only errors occurring inside the command will be trapped.
-verbose - (Optional) Temporarily override any message limits and return all messages from this command.
Note: Message limits can be defined with the set_msg_config command.

<name> - (Required) The name of the property to be defined. The name is case sensitive.

<class> - (Required) The class of object to assign the new property to. All objects of the specified class will be assigned the newly defined property. Valid classes are: design, net, cell, pin, port, Pblock, interface, and fileset.

Examples

The following example defines a property called PURPOSE for cell objects:

create_property PURPOSE cell
Note: Because the -type was not specified, the value will default to strings.

The following example creates a pin property called COUNT which holds an Integer value:

create_property -type int COUNT pin