test suite reviews and discussions
 help / color / mirror / Atom feed
* [dts] [PATCH V1] doc/dts_gsg: add support_igb_uio
@ 2020-12-23  7:49 Haiyang Zhao
  2020-12-24  3:00 ` Tu, Lijuan
  0 siblings, 1 reply; 2+ messages in thread
From: Haiyang Zhao @ 2020-12-23  7:49 UTC (permalink / raw)
  To: lijuan.tu, dts; +Cc: Haiyang Zhao

this doc is to guide user to enable testing DPDK with igb_uio.

Signed-off-by: Haiyang Zhao <haiyangx.zhao@intel.com>
---
 doc/dts_gsg/index.rst           |   1 +
 doc/dts_gsg/support_igb_uio.rst | 102 ++++++++++++++++++++++++++++++++
 2 files changed, 103 insertions(+)
 create mode 100644 doc/dts_gsg/support_igb_uio.rst

diff --git a/doc/dts_gsg/index.rst b/doc/dts_gsg/index.rst
index 16da30e3..0c84f466 100644
--- a/doc/dts_gsg/index.rst
+++ b/doc/dts_gsg/index.rst
@@ -48,3 +48,4 @@ Getting Started Guide
     trex
     trex_known_issue
     usage_of_create_eal_and_start_testpmd
+    support_igb_uio
diff --git a/doc/dts_gsg/support_igb_uio.rst b/doc/dts_gsg/support_igb_uio.rst
new file mode 100644
index 00000000..ca48a8f9
--- /dev/null
+++ b/doc/dts_gsg/support_igb_uio.rst
@@ -0,0 +1,102 @@
+Test DPDK based on igb_uio
+==========================
+
+The kernel module igb_uio is moved to the dpdk-kmods repository in the
+/linux/igb_uio/ directory snice DPDK 20.11 (commit: 56bb5841fd06).
+The most easy way to test DPDK in DTS based on igb_uio is to add igb_uio
+source code back to dpdk.
+
+
+Get Source Code
+---------------
+
+Get DPDK::
+
+   git clone git://dpdk.org/dpdk
+   git clone http://dpdk.org/git/dpdk
+
+Get igb_uio::
+
+   git clone http://dpdk.org/git/dpdk-kmods
+   git clone git://dpdk.org/dpdk-kmods
+
+Integrate igb_uio into DPDK
+---------------------------
+
+Assume you have cloned the dpdk and dpdk-kmods source code
+in ./dpdk and ./dpdk-kmods.
+
+#. Copy dpdk-kmods/linux/igb_uio/ to dpdk/kernel/linux/::
+
+    [root@dts linux]# cp -r ./dpdk-kmods/linux/igb_uio /root/dpdk/kernel/linux/
+    [root@dts linux]# ls ./dpdk/kernel/linux/
+    igb_uio  kni  meson.build
+
+#. enable igb_uio build in meson:
+
+*   add igb_uio in dpdk/kernel/linux/meson.build subdirs as below::
+
+     subdirs = ['kni', 'igb_uio']
+
+.. note::
+
+    igb_uio will be added into compile list when it is added in subdirs.
+
+
+*   create a file of meson.build in dpdk/kernel/linux/igb_uio/ as below::
+
+     # SPDX-License-Identifier: BSD-3-Clause
+     # Copyright(c) 2017 Intel Corporation
+
+     mkfile = custom_target('igb_uio_makefile',
+             output: 'Makefile',
+             command: ['touch', '@OUTPUT@'])
+
+     custom_target('igb_uio',
+             input: ['igb_uio.c', 'Kbuild'],
+             output: 'igb_uio.ko',
+             command: ['make', '-C', kernel_dir + '/build',
+                     'M=' + meson.current_build_dir(),
+                     'src=' + meson.current_source_dir(),
+                     'EXTRA_CFLAGS=-I' + meson.current_source_dir() +
+                             '/../../../lib/librte_eal/include',
+                     'modules'],
+             depends: mkfile,
+             install: true,
+             install_dir: kernel_dir + '/extra/dpdk',
+             build_by_default: get_option('enable_kmods'))
+
+.. note::
+
+    DPDK is using meson build, create meson.build so that igb_uio can be built.
+
+DTS configuration
+-----------------
+
+#. Pack the dpdk into dpdk.tar.gz and copy into dts/dep::
+
+    tar -zcvf dpdk.tar.gz dpdk
+    cp dpdk.tar.gz ~/dts/dep
+
+
+#. config drivername=igb_uio in execution.cfg::
+
+    [Execution1]
+    crbs=127.0.0.1
+    drivername=igb_uio
+    build_type=meson
+    test_suites=
+        checksum_offload,
+    targets=
+        x86_64-native-linuxapp-gcc
+    parameters=nic_type=cfg:func=true
+
+#. configure dts with other requirements (not mentioned here) and now start dts::
+
+   ./dts
+
+.. note ..
+
+    dts parameter "-s" means skip setup, it won't unpack dep/dpdk.tar.gz
+    to the default directory `/root/dpdk`, but use dpdk already there.
+    so copy the integrated dpdk to `/root/dpdk` if with `-s`
\ No newline at end of file
-- 
2.17.1


^ permalink raw reply	[flat|nested] 2+ messages in thread

* Re: [dts] [PATCH V1] doc/dts_gsg: add support_igb_uio
  2020-12-23  7:49 [dts] [PATCH V1] doc/dts_gsg: add support_igb_uio Haiyang Zhao
@ 2020-12-24  3:00 ` Tu, Lijuan
  0 siblings, 0 replies; 2+ messages in thread
From: Tu, Lijuan @ 2020-12-24  3:00 UTC (permalink / raw)
  To: Zhao, HaiyangX, dts; +Cc: Zhao, HaiyangX

> this doc is to guide user to enable testing DPDK with igb_uio.
> 
> Signed-off-by: Haiyang Zhao <haiyangx.zhao@intel.com>

Applied, thanks

^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2020-12-24  3:00 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-12-23  7:49 [dts] [PATCH V1] doc/dts_gsg: add support_igb_uio Haiyang Zhao
2020-12-24  3:00 ` Tu, Lijuan

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).