mirror of
https://gitlab.eurecom.fr/oai/openairinterface5g.git
synced 2026-07-13 04:30:28 +00:00
8107939f08
- all RAN code, CI code, configuration files, dockerfiles, in CSSL v1.0
- all deployment code (openshift, charts, ancillary files like shell
scripts), in MIT
- documentation in CC-BY-4.0
- exceptions might apply and are listed in NOTICE
- there is a new LICENSES folder with all licenses
- CONTRIBUTIONS.md has been updated accordingly
For automated changes based on OAI PL v1.1:
perl -i~ -0pe 's/\/\*.*Licensed to the OpenAirInterface.*openairinterface.org\n#?/\/*\n * SPDX-License-Identifier: LicenseRef-CSSL-1.0\n/s' **/*.{c,h,cpp}
perl -i~ -0pe 's/\/\*.*Licensed to the OpenAirInterface.*openairinterface.org\n#?/\/*\n * SPDX-License-Identifier: LicenseRef-CSSL-1.0\n/s' **/*.ts
perl -i~ -0pe 's/<!--.*Licensed to the OpenAirInterface.*openairinterface.org\n.*-->/<!-- SPDX-License-Identifier: LicenseRef-CSSL-1.0 -->/s' **/*.xml
The rest (cmake, files with missing license, cmake) manually.
103 lines
3.4 KiB
Markdown
103 lines
3.4 KiB
Markdown
<!-- SPDX-License-Identifier: CC-BY-4.0 -->
|
|
|
|
# OpenAirInterface Cross-Compiler User Guide
|
|
|
|
This document explains how to build OAI for ARM64
|
|
(using the instruction set aarch64).
|
|
|
|
[[_TOC_]]
|
|
|
|
## Environment
|
|
|
|
Tested on Ubuntu 22. Newer version of Ubuntu should work as well, please file a
|
|
bug report if not (Gitlab Issues page).
|
|
|
|
You should be able to compile OAI on the host (i.e., for x86). To do so,
|
|
install the dependencies, if not done already:
|
|
|
|
```shell
|
|
cmake_targets/build_oai -I
|
|
```
|
|
|
|
## Install ARM64 dependencies
|
|
|
|
Set up for install the package for ARM64.
|
|
|
|
```shell
|
|
sudo dpkg --add-architecture arm64
|
|
|
|
echo -e \
|
|
"deb [arch=arm64] http://ports.ubuntu.com/ jammy main restricted\n"\
|
|
"deb [arch=arm64] http://ports.ubuntu.com/ jammy-updates main restricted\n"\
|
|
"deb [arch=arm64] http://ports.ubuntu.com/ jammy universe\n"\
|
|
"deb [arch=arm64] http://ports.ubuntu.com/ jammy-updates universe\n"\
|
|
"deb [arch=arm64] http://ports.ubuntu.com/ jammy multiverse\n"\
|
|
"deb [arch=arm64] http://ports.ubuntu.com/ jammy-updates multiverse\n"\
|
|
"deb [arch=arm64] http://ports.ubuntu.com/ jammy-backports main restricted universe multiverse"\
|
|
| sudo tee /etc/apt/sources.list.d/arm-cross-compile-sources.list
|
|
|
|
sudo cp /etc/apt/sources.list "/etc/apt/sources.list.`date`.backup"
|
|
sudo sed -i -E "s/(deb)\ (http:.+)/\1\ [arch=amd64]\ \2/" /etc/apt/sources.list
|
|
|
|
sudo apt update
|
|
sudo apt install -y gcc-aarch64-linux-gnu \
|
|
g++-aarch64-linux-gnu
|
|
|
|
sudo apt-get install -y \
|
|
libc6-dev-i386 \
|
|
libreadline-dev:arm64 \
|
|
libgnutls28-dev:arm64 \
|
|
libconfig-dev:arm64 \
|
|
libsctp-dev:arm64 \
|
|
libssl-dev:arm64 \
|
|
libtool:arm64 \
|
|
zlib1g-dev:arm64
|
|
```
|
|
|
|
The above enables apt to download packages for arm64. It also installs
|
|
gcc cross-compilers for ARM64 in version 11. This version needs to match the
|
|
versions of gcc defined in the cmake cross-compilation file (`cross-arm.cmake`).
|
|
|
|
## Build for ARM64
|
|
|
|
### Build code generation tools for host
|
|
|
|
Use the x86 compiler to build the `ldpc_generators` and generate the header
|
|
file in the `ran_build/build` folder. They are necessary during a build for
|
|
code generation, and therefore need to be created for the x86 architecture.
|
|
|
|
```shell
|
|
rm -r ran_build
|
|
mkdir ran_build
|
|
mkdir ran_build/build
|
|
mkdir ran_build/build-cross
|
|
|
|
cd ran_build/build
|
|
cmake ../../..
|
|
make -j`nproc` ldpc_generators generate_T
|
|
```
|
|
|
|
### Build executables for ARM64
|
|
|
|
Switch to the `ran_build/build-cross` folder to build the target executables
|
|
for ARM. The `cross-arm.cmake` file defines some ARM-specific build tools
|
|
(e.g., compilers) that you might need to adapt. Further, it defines cmake
|
|
variables that define in this step where the host tools (such as LDPC
|
|
generators) are to be found. For the latter, the `NATIVE_DIR` option has to
|
|
be defined in order to tell cmake where the host tools have been built.
|
|
|
|
```shell
|
|
cd ../build-cross
|
|
cmake ../../.. -GNinja -DCMAKE_TOOLCHAIN_FILE=../../../cmake_targets/cross-arm.cmake -DNATIVE_DIR=../build
|
|
|
|
ninja dlsim ulsim ldpctest polartest smallblocktest nr_pbchsim nr_dlschsim nr_ulschsim nr_dlsim nr_ulsim nr_pucchsim nr_prachsim nr_srssim
|
|
ninja lte-softmodem nr-softmodem nr-cuup oairu lte-uesoftmodem nr-uesoftmodem
|
|
ninja params_libconfig coding rfsimulator
|
|
```
|
|
|
|
## Further information
|
|
|
|
You can do the above steps using docker, see dockerfiles
|
|
`docker/Dockerfile.base.ubuntu.cross-arm64` and
|
|
`docker/Dockerfile.build.ubuntu.cross-arm64` for more information.
|