Configuration Parameters
This technical reference covers both the FrontPanel Subsystem and LEDs Vivado IP cores. The IP Cores’ configuration parameters are used when generating the IP Cores’ output products. The IP Cores’ parameters are validated to ensure they conform to the requirements specified in tables 3.1, 3.2, and 3.3.
Setting Parameters Through TCL:
The parameters can be set through TCL using the following command structure:
set_property -dict [list CONFIG.<Param Name> {<value>} <Additional Param/value pairs>] [get_ips <IP Instance>]
Code language: HTML, XML (xml)
For example:
set_property -dict [list CONFIG.BOARD {XEM8320-AU25P} CONFIG.WI.COUNT {1} CONFIG.WI.ADDR_0 {0x08}] [get_ips frontpanel_example]
Code language: CSS (css)
Dual Host Interface Configuration Parameters:
Currently, the XEM8350 is the only device to support a secondary Host Interface. Devices supporting the secondary Host Interface provide additional parameters by prepending an “S” field onto their counterparts laid out in Table 3.1. These parameters have identical functionality and the same validation/conformity rules as their counterparts. For brevity, these parameters are removed from Table 3.1:
S.<type>.COUNT
S.<type>.ADDR_<31-0>
S.RB.EN
Additionally, S.EN
is used to enable the secondary host interface and is listed in Table 3.1.
Reference Tables
The parameters are categorized into the Types defined below:
Type | Function |
---|---|
User | Intended for user configuration |
GUI | Intended to be used in the GUI discovery workflow. Not relevant beyond the discovery stage when utilizing TCL configuration |
Internal | Do not manually set |
FrontPanel Subsystem IP Core Parameters
Param Name | Description | Range | Type | Supported Boards | Notes |
---|---|---|---|---|---|
BOARD | Selects target board | Table 3.3 | User | All | Table 3.3 |
DNA.EN | DNA port enablement | false/true | User | All | |
WI.COUNT | Number of WireIn Endpoints | [0, 32] | User | All | (1) |
WO.COUNT | Number of WireOut Endpoints | [0, 32] | User | All | (1) |
TI.COUNT | Number of TriggerIn Endpoints | [0, 32] | User | All | (1) |
TO.COUNT | Number of TriggerOut Endpoints | [0, 32] | User | All | (1) |
PI.COUNT | Number of PipeIn Endpoints | [0, 32] | User | All | (1)(2) |
BTPI.COUNT | Number of Block Throttled PipeIn Endpoints | [0, 32] | User | All | (1)(2) |
PO.COUNT | Number of WireIn Endpoints | [0, 32] | User | All | (1)(3) |
BTPO.COUNT | Number of Block Throttled PipeOut Endpoints | [0, 32] | User | All | (1)(3) |
RB.EN | Register Bridge enablement | false/true | User | All | |
WI.ADDR_<31-0> | 32 Address Bins for Endpoint | [0x00, 0x1f] | User | All | (4)(5) |
WO. ADDR_<31-0> | 32 Address Bins for Endpoint | [0x20, 0x3f] | User | All | (4)(5) |
TI. ADDR_<31-0> | 32 Address Bins for Endpoint | [0x40, 0x5f] | User | All | (4)(5) |
TO. ADDR_<31-0> | 32 Address Bins for Endpoint | [0x60, 0x7f] | User | All | (4)(5) |
PI.ADDR_<31-0> | 32 Address Bins for Endpoint | [0x80, 0x9f] | User | All | (4)(5) |
BTPI.ADDR_<31-0> | 32 Address Bins for Endpoint | [0x80, 0x9f] | User | All | (4)(5) |
PO.ADDR_<31-0> | 32 Address Bins for Endpoint | [0xa0, 0xbf] | User | All | (4)(5) |
BTPO. ADDR_<31-0> | 32 Address Bins for Endpoint | [0xa0, 0xbf] | User | All | (4)(5) |
BITSTREAM.FLASH | Flash configuration enablement | false/true | User | XEM8320-AU25P, XEM8310-AU25P, XEM8305-AU15P-2E, XEM8305-AU15P-1E, XEM8370-KU11P, XEM8350-KU060, XEM8350-KU060-3E, XEM8350-KU115 | (6) |
S.EN | Secondary Host Interface enablement | false/true | User | XEM8350-KU060, XEM8350-KU060-3E, XEM8350-KU115 | |
EXDES.FLOW | Example Design workflow category | Not Relevant | GUI | All | (7) |
EXDES. SELECTION | Choice from available Example Designs | Not Relevant | GUI | All | (7) |
GUI.APPLY_PRESET | Trigger param used in applying presets within the GUI | [1, ∞) | GUI | All | (7) |
DNA.WIDTH | DNA width variable used in internal generation. Automatically set based on BOARD param | 7 Series – 57 UltraScale – 96 | Internal | All | (9) |
Notes:
- The included address bins start at
<type>.ADDR_0
through to the<type>.COUNT
specified, i.e., a<type>.COUNT
of 3 will generate endpoints for the addresses in bins<type>.ADDR_0
through<type>.ADDR_2
. - PI & BTPI Endpoint types share the same address space. Their summed COUNTs cannot exceed 32, i.e.
PI.COUNT
+BTPI.COUNT
≤ 32. - PO & BTPO Endpoint types share the same address space. Their summed COUNTs cannot exceed 32, i.e.
PO.COUNT
+BTPO.COUNT
≤ 32. - Addresses must be in HEX format, i.e.,
0x04
. - No two Endpoint address bins can have the same address.
- Only supported on boards with FPGA Flash.
- Not intended outside of the GUI flow.
- Does NOT provide utility in applying board interface constraints as seen in Xilinx provided IP Cores. IP Core automatically applies board constraints through other means.
- Internal Parameter is automatically configured appropriately based on User parameter types.
LEDs IP Core Parameters
Param Name | Description | Range | Type | Supported Boards | Notes |
---|---|---|---|---|---|
BOARD | Selects target board | Table 3.3 | User | All | Table 3.3 |
IOSTANDARD | Selects IOSTANDARD constraint to apply to LEDs | LVCMOS12, LVCMOS15, LVCMOS18 | User | XEM8320-AU25P, XEM8350-KU060, XEM8350-KU060-3E, XEM8350-KU115 | (1) |
WIDTH | Number of onboard LEDs | Variable | Internal | All | |
DRIVERTYPE | Determines which LED driver logic to generate | standard, inverted, tristate | Internal | All |
Notes:
- Used for boards whose LEDs are connected to a variable bank voltage controlled by VIO.
Allowed Entries for BOARD Parameter
For the selected BOARD parameter, the IP Core will check the project’s currently configured FPGA part. If it does not match the associated FPGA part displayed in the table below, referred to as the “Enforced FPGA Part,” the IP Core will restrict generation until the issue is resolved.
Allowed Entries for BOARD Parameter | enforced FPGA Part |
---|---|
XEM8320-AU25P | xcau25p-ffvb676-2-e |
XEM8310-AU25P | xcau25p-ffvb676-2-e |
XEM8305-AU15P-2E | xcau15p-ffvb676-2-e |
XEM8305-AU15P-1E | xcau15p-ffvb676-1-e |
XEM8370-KU11P | xcku11p-ffva1156-1-e |
XEM8350-KU060 | xcku060-ffva1517-1-c |
XEM8350-KU060-3E | xcku060-ffva1517-3-e |
XEM8350-KU115 | xcku115-flva1517-1-c |
XEM7310MT-A75 | xc7a75tfgg484-1 |
XEM7310MT-A200 | xc7a200tfbg484-1 |
XEM7320-A75 | xc7a75tfgg484-1 |
XEM7320-A200 | xc7a200tfbg484-1 |
XEM7305-S50 | xc7s50csga324-1 |
XEM7310-A75 | xc7a75tfgg484-1 |
XEM7310-A200 | xc7a200tfbg484-1 |
XEM7360-K160T | xc7k160tffg676-1 |
XEM7360-K160T-3E | xc7k160tffg676-3 |
XEM7360-K410T | xc7k410tffg676-1 |
XEM7360-K410T-3E | xc7k410tffg676-3 |
XEM7350-K70T | xc7k70tfbg676-1 |
XEM7350-K160T | xc7k160tffg676-1 |
XEM7350-K410T | xc7k410tffg676-1 |
XEM7350-K410T-3E | xc7k410tffg676-3 |