doc(t2): Update T2 related documentation

Update the T2 card build instructions to use the latest DPDK patch,
AMD-T2-SDFEC_25-03-1.patch. The required DPDK version for builds with T2
offload enabled is now 22.11 or 22.11.3, replacing the previous patch
and version requirements.
Signed-off-by: default avatarJaroslava Fiedlerova <jaroslava.fiedlerova@openairinterface.org>
parent 31ffb21a
...@@ -12,22 +12,22 @@ For details on the implementation, please consult the [developer notes](../opena ...@@ -12,22 +12,22 @@ For details on the implementation, please consult the [developer notes](../opena
## Requirements ## Requirements
In principle, any lookaside LDPC accelerator supporting the O-RAN AAL/DPDK BBDEV should work. In principle, any lookaside LDPC accelerator supporting the O-RAN AAL/DPDK BBDEV should work.
However, the current implementation has only been validated for the Xilinx T2, Intel ACC100, and Intel ACC200 (VRB1). However, the current implementation has only been validated for the AMD T2 Telco Accelerator Card, Intel ACC100, and Intel ACC200 (VRB1).
Therefore, your mileage may vary when using other BBDEV devices as there may be some hardware-specific changes required -- contributions are welcome! Therefore, your mileage may vary when using other BBDEV devices as there may be some hardware-specific changes required -- contributions are welcome!
### DPDK Version Requirements ### DPDK Version Requirements
The following DPDK versions are supported: The following DPDK versions are supported:
- For the Xilinx T2 card, DPDK20.11+ is supported. - For the AMD T2 Telco Accelerator Card, DPDK20.11+ is supported.
- As for the Intel ACC100/ACC200, only DPDK22.11+ is supported. - As for the Intel ACC100/ACC200, only DPDK22.11+ is supported.
### Tested Devices/ DPDK versions ### Tested Devices/ DPDK versions
#### Xilinx T2 #### AMD T2 Telco Accelerator Card
- DPDK20.11.9*. - DPDK22.11
- DPDK22.11.7*. - DPDK22.11.3
> Note: FPGA bitstream image and the corresponding patch file (e.g., `ACCL_BBDEV_DPDK20.11.3_ldpc_3.1.918.patch` for DPDK20.11) from Accelercomm required. > Note: FPGA bitstream image and the corresponding patch file (e.g., `AMD-T2-SDFEC_25-03-1.patch` for DPDK22.11) required.
#### Intel ACC100 #### Intel ACC100
...@@ -44,39 +44,35 @@ The following DPDK versions are supported: ...@@ -44,39 +44,35 @@ The following DPDK versions are supported:
## System Setup ## System Setup
### DPDK installation ### DPDK installation
> Important: > [!IMPORTANT]
> - If you are using the Xilinx T2 card, you will need to apply the vendor-supplied patches before compiling DPDK. > - If you are using the AMD T2 Telco Accelerator Card, you will need to apply the vendor-supplied patches before compiling DPDK.
> - If you are using the Intel ACC100, you will need to [patch](https://github.com/DPDK/dpdk/commit/fdde63a1dfc129d0a510a831aa98253b36a2a1cd) the ACC100's driver if you are using DPDK22.11 or DPDK23.11. > - If you are using the Intel ACC100, you will need to [patch](https://github.com/DPDK/dpdk/commit/fdde63a1dfc129d0a510a831aa98253b36a2a1cd) the ACC100's driver if you are using DPDK22.11 or DPDK23.11.
Refer to the guide [here](./ORAN_FHI7.2_Tutorial.md?ref_type=heads#dpdk-data-plane-development-kit) to install, and then validate your DPDK installation. Refer to the [guide](./ORAN_FHI7.2_Tutorial.md?ref_type=heads#dpdk-data-plane-development-kit) to install, and then validate your DPDK installation. Ensure that you follow the DPDK version requirements for your specific device.
<details open> <details open>
<summary> Notes on DPDK patching/installation for Xilinx T2. </summary> <summary> Notes on DPDK patching/installation for AMD T2 Telco Accelerator Card. </summary>
*Note: The following instructions apply to `ACCL_BBDEV_DPDK20.11.3_ldpc_3.1.918.patch`, compatible with DPDK 20.11.9. For older patches (e.g., `ACL_BBDEV_DPDK20.11.3_BL_1006_build_1105_dev_branch_MCT_optimisations_1106_physical_std.patch`), refer to the T2 documentation in `2023.w48`.*
```bash > **Note**:
# Get DPDK source code > The following instructions apply to `AMD-T2-SDFEC_25-03-1.patch`, compatible with DPDK22.11 and DPDK.22.11.3.
git clone https://github.com/DPDK/dpdk-stable.git ~/dpdk-stable > For older patches:
cd ~/dpdk-stable > - `ACCL_BBDEV_DPDK20.11.3_ldpc_3.1.918.patch`, refer to the T2 documentation in [2026.w28](https://github.com/duranta-project/openairinterface5g/releases/tag/2026.w28).
git checkout v20.11.9 > - `ACL_BBDEV_DPDK20.11.3_BL_1006_build_1105_dev_branch_MCT_optimisations_1106_physical_std.patch`, refer to the T2 documentation in [2023.w48](https://github.com/duranta-project/openairinterface5g/releases/tag/2023.w48).
git apply ~/ACL_BBDEV_DPDK20.11.3_ldpc_3.1.918.patch
```
Replace `~/ACL_BBDEV_DPDK20.11.3_ldpc_3.1.918.patch` by patch file provided by
Accelercomm.
If you would like to install DPDK to a custom directory, here is an example.
```bash ```bash
cd ~/dpdk-stable # Get DPDK source code for DPDK22.11.3
# meson setup build wget http://fast.dpdk.org/rel/dpdk-22.11.3.tar.xz
meson setup --prefix=/opt/dpdk-t2 build # for installation with non-default installation prefix tar xvf dpdk-22.11.3.tar.xz && cd dpdk-stable-22.11.3
cd build git apply ~/AMD-T2-SDFEC_25-03-1.patch
ninja # Install DPDK
meson setup build
# Use "meson setup --prefix=/opt/dpdk-t2 build" for installation into non-default installation path
ninja -C build
sudo ninja install sudo ninja install
sudo ldconfig sudo ldconfig
``` ```
</details> </details>
### System configuration ### System configuration
...@@ -121,13 +117,13 @@ Lastly, we bind our accelerator with the `vfio-pci` driver. ...@@ -121,13 +117,13 @@ Lastly, we bind our accelerator with the `vfio-pci` driver.
# sudo dpdk-devbind.py --bind=vfio-pci 0000:f7:00.0 # sudo dpdk-devbind.py --bind=vfio-pci 0000:f7:00.0
``` ```
> Note: For the Xilinx T2, we can use this device directly. > Note: For the AMD T2 Telco Accelerator Card, we can use this device directly.
If you use an Intel vRAN accelerator, read on. If you use an Intel vRAN accelerator, read on.
#### Additional Steps for Intel vRAN Accelerators #### Additional Steps for Intel vRAN Accelerators
> IMPORTANT NOTE: > [!IMPORTANT]
> - Currently, we only support using the Virtual Functions (VFs) of the Intel vRAN accelerators, but not the Physical Function (PF). > - Currently, we only support using the Virtual Functions (VFs) of the Intel vRAN accelerators, but not the Physical Function (PF).
> - One key advantage of using VFs is that this allows us to share the accelerator with other DU instances on the same machine, which is common in practice. > - One key advantage of using VFs is that this allows us to share the accelerator with other DU instances on the same machine, which is common in practice.
If you are using an Intel vRAN accelerator, you will need to use the [pf_bb_config](https://github.com/intel/pf-bb-config) tool to configure the accelerator beforehand. If you are using an Intel vRAN accelerator, you will need to use the [pf_bb_config](https://github.com/intel/pf-bb-config) tool to configure the accelerator beforehand.
...@@ -226,9 +222,10 @@ Ensure that the CPU cores specified in `nrLDPC_coding_aal.dpdk_core_list` are av ...@@ -226,9 +222,10 @@ Ensure that the CPU cores specified in `nrLDPC_coding_aal.dpdk_core_list` are av
- `nrLDPC_coding_aal.num_harq_codeblock` - optional parameter, size of the HARQ buffer in terms of the number of 32kB blocks, by default set to *512* (maximum for the T2; as for the ACCs, this can be further increased). - `nrLDPC_coding_aal.num_harq_codeblock` - optional parameter, size of the HARQ buffer in terms of the number of 32kB blocks, by default set to *512* (maximum for the T2; as for the ACCs, this can be further increased).
- `nrLDPC_coding_aal.is_t2` - optional parameter, set this to 1 when using the Xilinx T2 card. - `nrLDPC_coding_aal.is_t2` - optional parameter, set this to 1 when using the AMD T2 Telco Accelerator Card.
> Note: These parameters can also be provided in a configuration file.
**Note:** These parameters can also be provided in a configuration file.
Example for the ACC200: Example for the ACC200:
``` ```
nrLDPC_coding_aal : { nrLDPC_coding_aal : {
...@@ -278,6 +275,8 @@ When running the gNB **with FHI 7.2**, it is not necessary to provide the `--nrL ...@@ -278,6 +275,8 @@ When running the gNB **with FHI 7.2**, it is not necessary to provide the `--nrL
since the core list specified for FHI 7.2 will be used for DPDK. since the core list specified for FHI 7.2 will be used for DPDK.
If it is provided, the AAL core list wil be ignored. If it is provided, the AAL core list wil be ignored.
> Note: Ensure that the xRAN library is built using the same DPDK version as the accelerator poll-mode driver.
Example command: Example command:
```bash ```bash
cd ~/openairinterface5g cd ~/openairinterface5g
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment