From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from foss.arm.com (foss.arm.com [217.140.101.70]) by dpdk.org (Postfix) with ESMTP id A23A72BAC for ; Mon, 28 May 2018 08:54:03 +0200 (CEST) Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.72.51.249]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id DDA4F15AD; Sun, 27 May 2018 23:54:02 -0700 (PDT) Received: from net-debian.shanghai.arm.com (unknown [10.169.36.53]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPA id 6DE193F25D; Sun, 27 May 2018 23:54:02 -0700 (PDT) From: Gavin Hu To: dev@dpdk.org Cc: gavin.hu@arm.com Date: Mon, 28 May 2018 02:53:48 -0400 Message-Id: <1527490428-15540-2-git-send-email-gavin.hu@arm.com> X-Mailer: git-send-email 2.1.4 In-Reply-To: <1527490428-15540-1-git-send-email-gavin.hu@arm.com> References: <1527133127-29407-1-git-send-email-gavin.hu@arm.com> <1527490428-15540-1-git-send-email-gavin.hu@arm.com> Subject: [dpdk-dev] [PATCH v2 2/2] doc: add a guide doc for cross compiling from x86 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 28 May 2018 06:54:04 -0000 This is guild for cross compiling for ARM64 from X86 hosts. Signed-off-by: Gavin Hu Reviewed-by: Steve Capper Reviewed-by: Honnappa Nagarahalli Reviewed-by: Marko Kovacevic Reviewed-by: Jerin Jacob Reviewed-by: Thomas Monjalon Reviewed-by: Bruce Richardson --- doc/guides/howto/index.rst | 1 + .../linux_gsg/cross_build_dpdk_for_arm64.rst | 70 ++++++++++++++++++++++ doc/guides/linux_gsg/index.rst | 1 + 3 files changed, 72 insertions(+) create mode 100644 doc/guides/linux_gsg/cross_build_dpdk_for_arm64.rst diff --git a/doc/guides/howto/index.rst b/doc/guides/howto/index.rst index e13a090..35ac151 100644 --- a/doc/guides/howto/index.rst +++ b/doc/guides/howto/index.rst @@ -8,6 +8,7 @@ HowTo Guides :maxdepth: 2 :numbered: + cross_compile_sdk_for_arm64 lm_bond_virtio_sriov lm_virtio_vhost_user flow_bifurcation diff --git a/doc/guides/linux_gsg/cross_build_dpdk_for_arm64.rst b/doc/guides/linux_gsg/cross_build_dpdk_for_arm64.rst new file mode 100644 index 0000000..2abf2e8 --- /dev/null +++ b/doc/guides/linux_gsg/cross_build_dpdk_for_arm64.rst @@ -0,0 +1,70 @@ +How to cross compile DPDK for ARM64 +----------------------------------- + +NOTE: Whilst it is recommended to natively build DPDK on ARM64 (just +like with x86), it is also possible to cross-build DPDK for ARM64. An +ARM64 cross compile GNU toolchain is used for this, which currently requires +the NUMA libraries to be integrated. Following are the steps to follow. + +1. Obtain the cross tool chain +------------------------------ +The latest cross compile tool chain can be downloaded from: +https://releases.linaro.org/components/toolchain/binaries/latest/aarch64-linux-gnu/ +Following is the step to get the version 7.2.1, latest so far. +$ wget https://releases.linaro.org/components/toolchain/binaries/latest/ +aarch64-linux-gnu/gcc-linaro-7.2.1-2017.11-x86_64_aarch64-linux-gnu.tar.xz + +2. Unzip and add into the PATH +------------------------------ +$ tar -xvf gcc-linaro-7.2.1-2017.11-x86_64_aarch64-linux-gnu.tar.xz +$ export PATH=$PATH:/gcc-linaro-7.2.1-2017.11-x86_64_aarch64-linux-gnu/bin +Note: For the host requirements and other info, refer to the release note section: +https://releases.linaro.org/components/toolchain/binaries/latest/ + +3. Getting the prerequisite library +----------------------------------- +-- NUMA (Note: Required by most modern machines, not needed for non-NUMA ones) +--Prerequisite: for compiling NUMA, make sure the installed libtool version >= 2.2 +(run libtool --version to check), otherwise the compilation will fail with errors. +$ git clone https://github.com/numactl/numactl.git +$ cd numactl +$ git checkout v2.0.11 -b v2.0.11 +$ ./autogen.sh +$ autoconf -i +$ ./configure --host=x86_64 CC=aarch64-linux-gnu-gcc prefix= +$ make install +You will get numa*.h files under /include and libnuma.a under /lib. + +4. Augument the cross gcc toolchain with the NUMA header and lib +---------------------------------------------------------------- +Note: This way is optional, the alternative way is to use extra CFLAGS and LDFLAGS, depicted in Step 6)* +Copy the NUMA header files to the cross compiler's include directory: +$ cp /include/numa*.h /gcc-linaro-7.2.1-2017.11-x86_64_aarch64-linux-gnu/bin/../aarch64-linux-gnu/libc/usr/include/ +Copy the NUMA lib to the cross compiler's lib directory: +$ cp /lib/libnuma.a /gcc-linaro-7.2.1-2017.11-x86_64_aarch64-linux-gnu/lib/gcc/aarch64-linux-gnu/7.2.1/ + +5. Configuring the DPDK Build +----------------------------- +To configure a build, follow the build-sdk-quick.txt file to select one of the target configurations,like +arm64-dpaa2-linuxapp-gcc and arm64-thunderx-linuxapp-gcc for optimized build specific to target. + +$ make config T=arm64-armv8a-linuxapp-gcc + +6. Cross Compiling DPDK +----------------------- +To cross-compile DPDK for ARM64 target machine, without compiling the kernel modules, use the following +command: +$ make -j CROSS=aarch64-linux-gnu- CONFIG_RTE_KNI_KMOD=n CONFIG_RTE_EAL_IGB_UIO=n + +To cross-compile DPDK for ARM64, including the kernel modules, the kernel source tree is required. +Set RTE_KERNEL_SRC_ROOTDIR to the kernel source tree folder and use the following command: +$ make -j CROSS=aarch64-linux-gnu- RTE_KERNELDIR= CROSS_COMPILE=aarch64-linux-gnu- + +Note: +1. If the target machine is non-NUMA, add the following to the command: +CONFIG_RTE_LIBRTE_VHOST_NUMA=n CONFIG_RTE_EAL_NUMA_AWARE_HUGEPAGES=n +2. If Step 4 is skipped and the toolchain was not augumented with the NUMA headers and library. +Add EXTRA CFLAGS and LDFLAGS for the NUMA header and library. RTE_DEVEL_BUILD has to be disabled, otherwise +the numa.h file will get a lot of Werror=cast-qual, Werror=strict-prototypes and Werror=old-style-definition +compiling errors. +EXTRA_CFLAGS="-I/opt/cccc/include" EXTRA_LDFLAGS="-L/lib -lnuma" RTE_DEVEL_BUILD=n diff --git a/doc/guides/linux_gsg/index.rst b/doc/guides/linux_gsg/index.rst index 2a7bdfe..c5b1695 100644 --- a/doc/guides/linux_gsg/index.rst +++ b/doc/guides/linux_gsg/index.rst @@ -13,6 +13,7 @@ Getting Started Guide for Linux intro sys_reqs build_dpdk + cross_build_dpdk_for_arm64 linux_drivers build_sample_apps enable_func -- 2.1.4