2023.1 OFS Release for Intel Agilex SoC Attach Reference Shell (ofs-2023.1)

OFS 2023.1

Summary: OFS 2023.1 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.1.9
• BMC MAX10 Build Version: 1.1.9
• Quartus^® Prime Pro Version: 23.1
• Quartus Prime Pro License File: None
• Quartus Prime Pro Patch: None
• 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: 0x5010302EB2F77CE
• PR Interface Id: bf2a9e1a-b05d-5130-b47c-776055c0d67e
• OFS F2000x FIM Github Branch: https://github.com/OFS/ofs-f2000x-pl/tree/release/ofs-2023.1
• OFS F2000x FIM Github Tag: https://github.com/OFS/ofs-f2000x-pl/releases/tag/ofs-2023.1-1
• OFS FIM_COMMON Github Branch: https://github.com/OFS/ofs-fim-common/tree/release/ofs-2023.1
• OFS FIM_COMMON Github Tag: https://github.com/OFS/ofs-fim-common/releases/tag/ofs-2023.1-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 SDK Branch: https://github.com/OFS/opae-sim/tree/release/2.5.0
• OPAE SDK Tag: https://github.com/OFS/opae-sim/releases/tag/2.5.0-2

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.1 OFS Release targeting Intel Agilex devices.

ID	Known Issues	Workaround	Status
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.	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.	Fixed in a future version of OFS FIM for Intel Agilex devices.
14017669281	The version of cable hotplug IP in this release supports the VSR (very short route) recipes only.	None	Support for the LR (long range) recipes will be available in a future release of the OFS for Intel Agilex devices.
14019349213	he_random_long_test and mmio_stress_test generate mmio_timeout_errors.	None	Fixed in a future version of OFS.
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.
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	None	Fixed in a future version 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.