1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
.. SPDX-License-Identifier: BSD-3-Clause
Copyright(c) 2019 Intel Corporation.
Enable DPDK on OpenWrt
======================
This document describes how to enable Data Plane Development Kit (DPDK) on
OpenWrt in both a virtual and physical x86 environment.
Introduction
------------
The OpenWrt project is a well-known source-based router OS which provides a
fully writable filesystem with package management.
Build OpenWrt
-------------
You can obtain OpenWrt image through https://downloads.openwrt.org/releases.
To fully customize your own OpenWrt, it is highly recommended to build it from
the source code. You can clone the OpenWrt source code as follows:
.. code-block:: console
git clone https://git.openwrt.org/openwrt/openwrt.git
OpenWrt configuration
~~~~~~~~~~~~~~~~~~~~~
* Select ``x86`` in ``Target System``
* Select ``x86_64`` in ``Subtarget``
* Select ``Build the OpenWrt SDK`` for cross-compilation environment
* Select ``Use glibc`` in ``Advanced configuration options (for developers)``
then ``ToolChain Options`` and ``C Library implementation``
Kernel configuration
~~~~~~~~~~~~~~~~~~~~
The following configurations should be enabled:
* ``CONFIG_VFIO_IOMMU_TYPE1=y``
* ``CONFIG_VFIO_VIRQFD=y``
* ``CONFIG_VFIO=y``
* ``CONFIG_VFIO_NOIOMMU=y``
* ``CONFIG_VFIO_PCI=y``
* ``CONFIG_VFIO_PCI_MMAP=y``
* ``CONFIG_HUGETLBFS=y``
* ``CONFIG_HUGETLB_PAGE=y``
* ``CONFIG_PROC_PAGE_MONITOR=y``
Build steps
~~~~~~~~~~~
For detailed OpenWrt build steps and prerequisites, please refer to the
`OpenWrt build guide
<https://openwrt.org/docs/guide-developer/build-system/use-buildsystem>`_.
After the build is completed, you can find the images and SDK in
``<OpenWrt Root>/bin/targets/x86/64-glibc/``.
DPDK Cross Compilation for OpenWrt
----------------------------------
Pre-requisites
~~~~~~~~~~~~~~
NUMA is required to run DPDK in x86.
.. note::
For compiling the NUMA lib, run ``libtool --version`` to ensure the libtool
version >= 2.2, otherwise the compilation will fail with errors.
.. code-block:: console
git clone https://github.com/numactl/numactl.git
cd numactl
git checkout v2.0.13 -b v2.0.13
./autogen.sh
autoconf -i
export PATH=<OpenWrt SDK>/glibc/openwrt-sdk-x86-64_gcc-8.3.0_glibc.Linux-x86_64/staging_dir/toolchain-x86_64_gcc-8.3.0_glibc/bin/:$PATH
./configure CC=x86_64-openwrt-linux-gnu-gcc --prefix=<OpenWrt SDK toolchain dir>
make install
The numa header files and lib file is generated in the include and lib folder
respectively under <OpenWrt SDK toolchain dir>.
Build DPDK
~~~~~~~~~~
To cross compile with meson build, you need to write a customized cross file
first.
.. code-block:: console
[binaries]
c = 'x86_64-openwrt-linux-gcc'
cpp = 'x86_64-openwrt-linux-cpp'
ar = 'x86_64-openwrt-linux-ar'
strip = 'x86_64-openwrt-linux-strip'
meson setup builddir --cross-file openwrt-cross
ninja -C builddir
Running DPDK application on OpenWrt
-----------------------------------
Virtual machine
~~~~~~~~~~~~~~~
* Extract the boot image
.. code-block:: console
gzip -d openwrt-x86-64-combined-ext4.img.gz
* Launch Qemu
.. code-block:: console
qemu-system-x86_64 \
-cpu host \
-smp 8 \
-enable-kvm \
-M q35 \
-m 2048M \
-object memory-backend-file,id=mem,size=2048M,mem-path=/tmp/hugepages,share=on \
-drive file=<Your OpenWrt images folder>/openwrt-x86-64-combined-ext4.img,id=d0,if=none,bus=0,unit=0 \
-device ide-hd,drive=d0,bus=ide.0 \
-net nic,vlan=0 \
-net nic,vlan=1 \
-net user,vlan=1 \
-display none \
Physical machine
~~~~~~~~~~~~~~~~
You can use the ``dd`` tool to write the OpenWrt image to the drive you
want to write the image on.
.. code-block:: console
dd if=openwrt-18.06.1-x86-64-combined-squashfs.img of=/dev/sdX
Where sdX is name of the drive. (You can find it though ``fdisk -l``)
Running DPDK
~~~~~~~~~~~~
More detailed info about how to run a DPDK application please refer to
``Running DPDK Applications`` section of :ref:`the DPDK documentation <linux_gsg>`.
.. note::
You need to install pre-built NUMA libraries (including soft link)
to /usr/lib64 in OpenWrt.
|
