From 404c8c1fe47d31666fce679d46f78488f57172fb Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marcin=20S=C5=82owi=C5=84ski?= Date: Fri, 10 Jan 2025 17:38:48 +0100 Subject: [PATCH] Small fixes in docs. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This commit introduce some fixes in docs after cross-build on Ubuntu 24.04. Additionaly Python venv directory was added into .gitignore file. ONE-DCO-1.0-Signed-off-by: Marcin Słowiński --- .gitignore | 3 + docs/howto/how-to-build-runtime.md | 65 +++++++++++++++---- .../how-to-cross-build-runtime-for-arm.md | 18 +++-- 3 files changed, 71 insertions(+), 15 deletions(-) diff --git a/.gitignore b/.gitignore index 44c15ba07fd..33287e8e361 100644 --- a/.gitignore +++ b/.gitignore @@ -24,3 +24,6 @@ # Makefile /Makefile + +# Python virtualenv +/.venv diff --git a/docs/howto/how-to-build-runtime.md b/docs/howto/how-to-build-runtime.md index e9681872cf3..5638860514e 100644 --- a/docs/howto/how-to-build-runtime.md +++ b/docs/howto/how-to-build-runtime.md @@ -36,40 +36,83 @@ scons \ software-properties-common \ unzip \ wget +``` + +## Get ONE source code + +Getting code is as simple as + +``` +$ git clone https://github.com/Samsung/ONE.git one +$ cd one +``` -$ pip3 install yapf==0.40.2 numpy +## Install python packages + +Python package `numpy` is needed for build. It's recommended to always install python packages in virtualenv. +To do this, at first you need to install python venv package: + +``` +$ sudo apt-get install python3-venv +``` +Next, create virtualenv in `.venv` directory (make sure that you are in ONE directory): +``` +$ python3 -m venv .venv +``` + +and activate it (please keep in mind that you will have to activate it always before build) + +``` +$ source .venv/bin/activate +``` + +Next, just in case upgrade pip package: + +``` +(.venv)$ pip install -U pip +``` + +and finally install `numpy`: + +``` +(.venv)$ pip install numpy +``` + +Additionally, package `yapf` is needed in specific version: + +``` +(.venv)$ pip install yapf==0.40.2 ``` ## Build from source code, for Ubuntu -In a typical linux development environment, including Ubuntu, you can build the runtime with a simple command like this: +In a typical linux development environment, including Ubuntu, you can build the runtime with a simple command like this (make sure that you are in ONE directory): ``` -$ git clone https://github.com/Samsung/ONE.git one -$ cd one -$ ./nnfw configure -$ ./nnfw build -$ ./nnfw install +$ source .venv/bin/activate +(.venv)$ ./nnfw configure +(.venv)$ ./nnfw build +(.venv)$ ./nnfw install ``` For easy build process, we provides `Makefile.template` makefile. ``` -$ make -f Makefile.template +(.venv)$ make -f Makefile.template ``` To release build the runtime, add the environment variable `BUILD_TYPE=release` to the build command as follows. ``` -$ export BUILD_TYPE=release -$ make -f Makefile.template +(.venv)$ export BUILD_TYPE=release +(.venv)$ make -f Makefile.template ``` Or you can simply do something like this: ``` -$ BUILD_TYPE=release make -f Makefile.template +(.venv)$ BUILD_TYPE=release make -f Makefile.template ``` The build method described here is a `native build` in which the build environment and execution environment are same. So, this command creates a runtime binary targeting the current build architecture, probably x86_64, as the execution environment. You can find the build output in the ./Product folder as follows: diff --git a/docs/howto/how-to-cross-build-runtime-for-arm.md b/docs/howto/how-to-cross-build-runtime-for-arm.md index df1436b7b11..4e517941001 100644 --- a/docs/howto/how-to-cross-build-runtime-for-arm.md +++ b/docs/howto/how-to-cross-build-runtime-for-arm.md @@ -25,7 +25,7 @@ RootFS will be prepared at `tools/cross/rootfs/arm` or `tools/cross/rootfs/aarch ***\* CAUTION: The OS version of rootfs must match the OS version of execution target device. On the other hand, you need to match the Ubuntu version of the development PC with the Ubuntu version of rootfs to be used for cross-build. Otherwise, unexpected build errors may occur.*** -If you are using Ubuntu 20.04 LTS, select `focal`, if you are using Ubuntu 22.04 LTS, select `jammy`. You can check your Ubuntu code name in the following way. +If you are using Ubuntu 20.04 LTS, select `focal`, if you are using Ubuntu 22.04 LTS, select `jammy`, for Ubuntu 24.04 LTS, select `noble`. You can check your Ubuntu code name in the following way. ``` $ cat /etc/lsb-release @@ -81,7 +81,7 @@ If you select specific version, update symbolic link for build toolchain. Otherwise, you should set your custom cmake crossbuild toolchain. You can find cmake toolchain files in `infra/nnfw/cmake/buildtool/cross/`. ``` -$ update-alternatives --install /usr/bin/arm-linux-gnueabihf-gcc arm-linux-gnueabihf-gcc /usr/bin/arm-linux-gnueabihf-gcc-10 80 \ +$ sudo update-alternatives --install /usr/bin/arm-linux-gnueabihf-gcc arm-linux-gnueabihf-gcc /usr/bin/arm-linux-gnueabihf-gcc-10 80 \ --slave /usr/bin/arm-linux-gnueabihf-g++ arm-linux-gnueabihf-g++ /usr/bin/arm-linux-gnueabihf-g++-10 \ --slave /usr/bin/arm-linux-gnueabihf-gcov arm-linux-gnueabihf-gcov /usr/bin/arm-linux-gnueabihf-gcov-10 ``` @@ -104,17 +104,27 @@ ACL source will be automatically installed in `externals/ARMCOMPUTE` when you bu You can check ACL source information in `infra/cmake/packages/ARMComputeSourceConfig.cmake` +## Install numpy + +Python package `numpy` is needed for build. Please use [this guide](how-to-build-runtime.md##install-python-packages) to install it. + ## Cross build for ARM by using Makefile.template Give `TARGET_ARCH` variable to set the target architecture. If you used `ROOTFS_DIR` to prepare in alternative folder, you should also give this to makefile. +Remember to activate venv if you didn't activate it already: + +``` +$ source /.venv/bin/activate +``` + ``` -$ CROSS_BUILD=1 TARGET_ARCH=armv7l make -f Makefile.template +(.venv)$ CROSS_BUILD=1 TARGET_ARCH=armv7l make -f Makefile.template # If ROOTFS_DIR is in alternative folder -$ ROOTFS_DIR=/path/to/your/rootfs/arm \ +(.venv)$ ROOTFS_DIR=/path/to/your/rootfs/arm \ CROSS_BUILD=1 TARGET_ARCH=armv7l make ```