PACKAGE_PIN - PACKAGE_PIN - 2025.2 English - UG912

Vivado Design Suite Properties Reference Guide (UG912)

Document ID
UG912
Release Date
2025-11-20
Version
2025.2 English

Description

The PACKAGE_PIN object represents the physical pin on the AMD device package that is associate with a specific input or output of the design. The assignment of I/O ports to a package_pin is the subject of the Vivado Design Suite User Guide: I/O and Clock Planning (UG899).

The PACKAGE_PIN object can be assigned to PORT objects through the PACKAGE_PIN property.

Related Objects

Figure 1. PACKAGE_PIN Objects

PACKAGE_PIN objects are associated with PORT objects in the design netlist, and with SITE, BEL or IO_BANK objects on the target device. In addition, PACKAGE_PIN objects are associated with PKGPIN_BYTEGROUP and PKGPIN_NIBBLE objects. The PACKAGE_PINs can be queried through the use of the following Tcl command:

get_package_pins

Or, through associated objects with:

get_package_pins -of [get_ports]

You can also get the port, site, slr, io_bank, io_standard, pkgpin_bytegroup, phkgpin_nibble associated with a specified package_pin:

get_port -of [get_package_pins AG17]
Tip: In this case, the ports can also be found by looking at the PACKAGE_PIN property: get_ports -filter {PACKAGE_PIN==AG17}.

Properties

The properties found on package_pin objects are as follows, with example values:

Property	Type	Read-only	Visible	Value
BANK	string	true	true	44
BUFIO_2_REGION	string	true	true	BL
CLASS	string	true	true	package_pin
DIFF_PAIR_PIN	string	true	true	AE21
IS_BONDED	bool	true	true	1
IS_DIFFERENTIAL	bool	true	true	1
IS_GENERAL_PURPOSE	bool	true	true	1
IS_GLOBAL_CLK	bool	true	true	0
IS_LOW_CAP	bool	true	true	0
IS_MASTER	bool	true	true	1
IS_VREF	bool	true	true	0
IS_VRN	bool	true	true	0
IS_VRP	bool	true	true	0
MAX_DELAY	int	true	true	72405
MIN_DELAY	int	true	true	71685
NAME	string	true	true	AD21
PIN_FUNC	enum	true	true	IO_L1P_T0L_N0_DBC_44
PIN_FUNC_COUNT	int	true	true	1

The properties of package_pin objects can be listed with the following command:

report_property -all [lindex [get_package_pins] 0]