10.1.3.1 set_iobank

This PDC command sets the input/output supply voltage (vcci) and the input reference voltage (vref) for the specified I/O bank.

All banks have a dedicated vref pin. Do not set any pin on these banks. There are two types of I/O banks:

  • General-Purpose IO (GPIO)
  • High-Speed IO (HSIO)

Setting the iobanks is recommended to ensure that banks are set as expected. If not set, following are the default bank settings:

  • The bank will not have any settings if there is no I/O placed on the bank.
  • The first I/O placed on the bank will be used to set the bank. Example: If we place an I/O with IOSTD LVCMOS25, the bank will be set to 2.5V.
  • If I/Os are not placed by the user, the tool sets the banks as needed and place the I/Os.

The following table lists the set_iobank standards. Each bank type supports a different set of I/O standards.

Table 10-5. set_iobank Standards
I/O TypesSupported I/O Standards
HSIOLVCMOS12, LVCMOS15, LVCMOS18, SSTL18I, SSTL18II, HSUL18I, HSUL18II, SSTL15I, SSTL15II, HSTL15I, HSTL15II, SSTL135I, SSTL135II, HSTL135I, HSTL135II, HSTL12I, HSTL12II, HSUL12I, SLVSE15, POD12I, POD12II, SLVS18, HCSL18, LVDS18, RSDS18, MINILVDS18, SUBLVDS18, PPDS18, SHIELD18, SHIELD15, SHIELD135, SHIELD12
GPIOLVTTL, LVCMOS33, PCI, LVCMOS12, LVCMOS15, LVCMOS18, LVCMOS25, SSTL25I, SSTL25II, SSTL18I, SSTL18II, HSUL18I, HSUL18II, SSTL15I, SSTL15II, HSTL15I, HSTL15II, SLVS33, SLVS25, HCSL33, HCSL25, MIPI25, MIPIE25, LVPECL33, LVPECLE33, LVDS18G, LVDS25, LVDS33, RSDS25, RSDS33, MINILVDS25, MINILVDS33, SUBLVDS25, SUBLVDS33, PPDS25, PPDS33, SLVSE15, MLVDSE25, BUSLVDSE25, LCMDS33, LCMDS25, SHIELD33, SHIELD25, SHIELD18, SHIELD15, SHIELD12

The following example provides the usages of the set_iobank command with the supported arguments described.

set_iobank -bank_name <bank_name>\ 
[-vcci <vcci_voltage>]\ 
[-vref <vref_voltage>]\ 
[-fixed <value>]\ 
[-update_iostd <value>]\ 
[-auto_calib <value>]\ 
[-auto_calib_ramp_time <value>]

Arguments

-bank_name
Specifies the name of the bank. I/O banks are numbered 0 through N (Bank 0, Bank 1, …, Bank N). The number of I/O banks varies with the device. See the data sheet for your device to determine how many banks it has.
-vcci <vcci_voltage>
Sets the input/output supply voltage. Enter one of the values in the following table.
Table 10-6. -vcci Values
Vcci VoltageCompatible Standards
3.3VLVTTL, LVCMOS33, PCI, LVDS33, LVPECL33, LVPECLE33, SLVS33, HCSL33, RSDS33, MINILVDS33, SUBLVDS33
2.5VLVCMOS25, SSTL25I, SSTL25II, PPDS25, SLVS25, HCSL25, MLVDSE25, MINILVDS25, RSDS25, SUBLVDS25, LVDS25, MLVDSE25, BUSLVDSE25
1.8VLVCMOS18, SSTL18I, SSTL18II, HSUL18I, HSUL18II, SLVS18, HCSL18, LVDS18, LVDS18G, RSDS18, MINILVDS18, SUBLVDS18, PPDS18
1.5VLVCMOS15, SSTL15I, SSTL15II, HSTL15I, HSTL15II, SLVSE15
1.35VHSTL135I, HSTL135II, SSTL135I, SSTL135II
1.2VLVCMOS12, HSUL12I, HSTL12I, POD12I, MIPI12
-vref <vref_voltage>
Sets the input reference voltage. Enter one of the values in the following table.
Table 10-7. -vref Values
Vref VoltageCompatible Standards
1.25VSSTL25I
1.0VSSTL18I, HSUL18I
0.75VPOD12I, HSTL15I, SSTL15I, HSUL12I, HSTL12I
0.67VSSTL135I, HSTL135I
-fixed <value>
Specifies whether the I/O technologies (vcci and vccr voltages) assigned to the bank are locked. Enter one of the values in the following table.
Table 10-8. -fixed Values
ValueDescription
TrueThe technologies are locked.
FalseThe technologies are not locked.
-update_iostd <value>
For I/Os placed on the bank, this command specifies whether placement is kept, and the host is changed to one that is compatible with this bank setting.
Table 10-9. -update_iostd Values
ValueDescription
TrueIf there are I/Os placed on the bank, you keep the placement and change the host to one that is compatible with this bank setting. Check the I/O attributes to see the one used by the tool.
FalseIf I/Os are placed and locked on the bank, the command fails. If they are placed I/Os, they are unplaced.
-auto_calib <value>

Specifies whether the I/O bank is auto-calibrated at power-up or not. Values are true or false. The default value is true.

Note: This argument is not supported for MPF300TS_ES, MPF300T_ES, and MPF300XT devices.
-auto_calib_ramp_time <value>

Specifies the I/O bank VDDI supply ramp time (in ms), if the I/O bank is auto-calibrated. Values are 1–50. The default value is 50.

Note: Not supported for MPF300TS_ES, MPF300T_ES, and MPF300XT devices.

Exceptions

Any pins assigned to the specified I/O bank that are incompatible with the default technology are unassigned.

Examples

The following example assigns 3.3V to the input/output supply voltage (vcci) for I/O bank 0.
set_iobank -bank_name bank0 -vcci 3.3