numam-dpdk/doc/guides/linux_gsg
Michal Mazurek f22e705ebf eal/riscv: support RISC-V architecture
Add all necessary elements for DPDK to compile and run EAL on SiFive
Freedom U740 SoC which is based on SiFive U74-MC (ISA: rv64imafdc)
core complex.

This includes:

- EAL library implementation for rv64imafdc ISA.
- meson build structure for 'riscv' architecture. RTE_ARCH_RISCV define
  is added for architecture identification.
- xmm_t structure operation stubs as there is no vector support in the
  U74 core.

Compilation was tested on Ubuntu and Arch Linux using riscv64 toolchain.
Clang compilation currently not supported due to issues with missing
relocation relaxation.

Two rte_rdtsc() schemes are provided: stable low-resolution using rdtime
(default) and unstable high-resolution using rdcycle. User can override
the scheme by defining RTE_RISCV_RDTSC_USE_HPM=1 during compile time of
both DPDK and the application. The reasoning for this is as follows.
The RISC-V ISA mandates that clock read by rdtime has to be of constant
period and synchronized between all hardware threads within 1 tick
(chapter 10.1 in version 20191213 of RISC-V spec).
However this clock may not be of high-enough frequency for dataplane
uses. I.e. on HiFive Unmatched (FU740) it is 1MHz.
There is a high-resolution alternative in form of rdcycle which is
clocked at the core clock frequency. The drawbacks are that it may be
disabled during sleep (WFI), its frequency might change due to DVFS and
it is core-local and therefore cannot be used as a wall-clock. It can
however be used for micro-benchmarking user applications, similarly to
Aarch64's PMCCNTR PMU counter.

The platform is currently marked as linux-only because rte_cycles
implementation uses the timebase-frequency device-tree node read through
the proc file system. Such approach was chosen because Linux kernel
depends on the presence of this device-tree node.

The i40e PMD driver is disabled on RISC-V as the rv64gc ISA has no vector
operations.

The compilation of following modules has been disabled by this commit
and will be re-enabled in later commits as fixes are introduced:
net/ixgbe, net/memif, net/tap, example/l3fwd.

Sponsored-by: Frank Zhao <frank.zhao@starfivetech.com>
Sponsored-by: Sam Grove <sam.grove@sifive.com>
Signed-off-by: Michal Mazurek <maz@semihalf.com>
Signed-off-by: Stanislaw Kardach <kda@semihalf.com>
2022-06-08 11:26:20 +02:00
..
build_dpdk.rst doc: expand list of directories in Linux guide 2022-03-15 19:37:25 +01:00
build_sample_apps.rst fix PMD wording 2021-11-26 11:28:34 +01:00
cross_build_dpdk_for_arm64.rst doc: add arm64 cross file example 2022-03-16 20:23:30 +01:00
cross_build_dpdk_for_riscv.rst eal/riscv: support RISC-V architecture 2022-06-08 11:26:20 +02:00
eal_args.include.rst doc: fix default mempool option in guides 2021-10-25 17:12:52 +02:00
enable_func.rst doc: replace characters for (R) symbol in Linux guide 2022-03-16 18:39:20 +01:00
index.rst eal/riscv: support RISC-V architecture 2022-06-08 11:26:20 +02:00
intro.rst doc: add hyperlinks to driver guides in Linux guide 2022-03-16 18:56:27 +01:00
linux_drivers.rst doc: change informational warnings to notes in Linux guide 2022-03-16 18:39:35 +01:00
linux_eal_parameters.rst eal: extend --huge-unlink for hugepage file reuse 2022-02-08 21:32:53 +01:00
nic_perf_intel_platform.rst doc: add SPDX license tag header to Intel performance guide 2020-11-26 16:13:42 +01:00
sys_reqs.rst doc: replace characters for (R) symbol in Linux guide 2022-03-16 18:39:20 +01:00