2023.2 OFS Release for Intel Agilex 7 SoC Attach Reference Shell (ofs-2023.2)
OFS 2023.2
Summary: OFS 2023.2 Release for Intel® Agilex FPGA SoC Attach shell targeting Intel® Infrastructure Processing Unit (Intel® IPU) Platform F2000X-PL
- Board: Intel® Infrastructure Processing Unit (Intel® IPU) Platform F2000X-PL
- BMC MAX10 NIOS FW Version: 1.2.4 (c10_adp_bmc_rsu_unsigned_1.2.4.bin binary attached in assets below)
- BMC MAX10 Build Version: 1.2.4 (c10_adp_bmc_rsu_unsigned_1.2.4.bin binary attached in assets below)
- Quartus® Prime Pro Version: 23.2
- Quartus Prime Pro License File: None
- Quartus Prime Pro Patch: 0.19 patch (Ethernet Subsystem) (see .run file attached in assets below)
- OS Tested: Ubuntu 22.04, meta-intel-ese Reference Distro 1.0-ESE (kirkstone)
- OPAE Version: 2.5.0 (soc)
- Kernel Version: 5.15.92-dfl-66b0076c2c-lts (soc)
- Bitstream Id: 0x50103023AA581FA
- PR Interface Id: 38133a61-079e-52e2-b5c6-15c0f24d9f93
- OFS F2000x FIM Github Branch: https://github.com/OFS/ofs-f2000x-pl/tree/release/ofs-2023.2
- OFS F2000x FIM Github Tag: https://github.com/OFS/ofs-f2000x-pl/releases/tag/ofs-2023.2-1
- OFS FIM_COMMON Github Branch: https://github.com/OFS/ofs-fim-common/tree/release/ofs-2023.2
- OFS FIM_COMMON Github Tag: https://github.com/OFS/ofs-fim-common/releases/tag/ofs-2023.2-1
OPAE SDK: OPAE Wiki and OPAE Installation Guide
- OPAE SDK Branch: https://github.com/OFS/opae-sdk/tree/release/2.5.0
- OPAE SDK Tag: https://github.com/OFS/opae-sdk/releases/tag/2.5.0-3
OPAE SIM:
- OPAE SIM Branch: https://github.com/OFS/opae-sim/tree/release/2.8.0
- OPAE SIM Tag: https://github.com/OFS/opae-sim/releases/tag/2.8.0-1
Driver:
- Kernel Driver Branch: https://github.com/OFS/linux-dfl/tree/ofs-2023.1-5.15-1
- Kernel Driver Tag: https://github.com/OFS/linux-dfl/releases/tag/ofs-2023.1-5.15-1
This page provides up-to-date information about the Open FPGA Stack (OFS) for Intel® Agilex® SoC Attach devices. The summary of OFS framework features are shown below. To find out more about the targeted platform, please refer to the Intel® Infrastructure Processing Unit (Intel® IPU) Platform F2000X-PL .
Intel OFS for Intel Agilex PCIe Attach Reference Design Features
Key Feature | Description |
---|---|
PCIe | P-tile PCIe* Gen4x16 to the Host P-tile PCIe* Gen4x16 to the SoC (IceLake-D) |
Virtualization | Host: 2 physical functions SoC: 1 physical function and 3 Virtual functions |
Memory | Four Fabric DDR4 banks, x40 (optional ECC, be configured as x32 and ECC x8 ), 1200 MHz, 4GB |
Ethernet | 2x4x25GbE |
Configuration and Board Manageability | * FPGA Management Engine that provides general control of common FPGA tasks (ex. error reporting, partial reconfiguration) * Platform Controller Management Interface (PMCI) Module for Board Management Controller |
Partial Reconfiguration | Supported |
Software Support | * Linux DFL drivers targeting OFS FIMs * OPAE Software Development Kit * OPAE Tools |
Open Programmable Acceleration Engine Software (OPAE) | * OPAE Software Development Kit provides support for the following OPAE user space tools: * afu packager * bitstreaminfo * fpgainfo * fpgasupdate * host_exerciser * hssiloopback * hssistats * hssimac * mmlink * opae.io * opaevfio * pacsign * packager * pci_device * regmap * debugfs * rsu * userclock * vabtool |
The OFS hardware framework also provides:
- Support for unit test simulation (using Synopsys® VCS® or Siemens® Questa™ simulators)
- UVM support with Synopsys® VCS®
- Host exercisers that allow you to test interfaces on the FPGA
The OFS software framework provides:
- FPGA platform Linux® drivers that are being upstreamed to linux.org
- A programmable software development kit and userspace tools for managing the FPGA
Important: If you would like to begin evaluating the default shell that can be built from this repository, please scroll down to the "assets" accordion button below which contains the FPGA binary/POF/SOF along with the applicable Linux driver and Open Programmable Acceleration Engine (OPAE) software development kit (SDK) packages.
Known Issues
This table describes the known issues for the 2023.2 OFS Release targeting Intel Agilex 7 SoC Attach devices.
ID | Known Issues | Workaround | Status |
---|---|---|---|
22018273793 | When sending greater than 1400 byte packets upstream to the PCIe subsystem, you should disable the protocol checker in the src/top/top.sv file to prevent packet stalls. | None | Fixed in a future version of OFS. |
- | All hssi tests used in unit simulation and UVM take a longer than expected time to complete. | None | Fixed in future release of OFS. |
Important Notes
The following section provides important information about this release:
ID | Important Notes |
---|---|
- | When using the PF/VF configuration tool to reconfigure the PF/VF mux, you must keep at least one physical function and one virtual function on PF0. The tool does not support less than one PF and one VF on PF0. All other PFs and VFs can be removed if desired. |
15012246661 | When enabling cable hotplug IP and ANLT, the E-tile recipe resulting from the ANLT initialization flow is over-written by the hotplug initialization flow. If you require a custom ANLT recipe, then you cannot use hotplug at this time. You can disable hotplug by writing 1 to index-0 of HSSI Hotplug Debug Control Register (offset 0x600B4) followed by a port level reset or analog reset. |
15012406417 | If using the Intel FPGA SmartNIC N6001-PL Platform (SKU2) for evaluation of the OFS release, ensure DIP Switch SW1.4 on the board is set to convey the correct board type or the OPAE commands could display invalid temperature values for an Intel NIC E810 (SKU1) which is not populated on the SKU2 board. For Intel FPGA SmartNIC N6001-PL Platform (SKU2), SW1.4 must be off (pointing towards the PCIe goldfinger). Note that a BMC reset is required if you must flip the switch to the correct setting. |
Resolved Issues
This table describes prior known issues resolved in the 2023.2 OFS Release targeting Intel Agilex 7 SoC Attach devices.
ID | Resolved Issues |
---|---|
14017669281 | The version of cable hotplug IP in this release supports the VSR (very short route) recipes only. |
14019349213 | he_random_long_test and mmio_stress_test generate mmio_timeout_errors. |
14019381876 | The ofs-f2000x reference design does not have the Ethernet link and status LED logic enabled to work with the Intel® Infrastructure Processing Unit (Intel® IPU) Platform F2000X-PL |