Install Linux Host Dependencies¶
Documentation is available for these Linux distributions:
For distributions that are not based on rolling releases, some of the requirements and dependencies may not be met by your package manager. In that case please follow the additional instructions that are provided to find software from sources other than the package manager.
If you’re working behind a corporate firewall, you’ll likely
need to configure a proxy for accessing the internet, if you haven’t
done so already. While some tools use the environment variables
https_proxy to get their proxy settings, some
use their own configuration files, most notably
Update Your Operating System¶
Ensure your host system is up to date.
sudo apt-get update sudo apt-get upgrade
sudo dnf upgrade
sudo swupd update
sudo pacman -Syu
Install Requirements and Dependencies¶
Note that both Ninja and Make are installed with these instructions; you only need one.
sudo apt-get install --no-install-recommends git cmake ninja-build gperf \ ccache dfu-util device-tree-compiler wget \ python3-dev python3-pip python3-setuptools python3-tk python3-wheel xz-utils file libpython3.8-dev \ make gcc gcc-multilib g++-multilib libsdl2-dev
sudo dnf group install "Development Tools" "C Development Tools and Libraries" dnf install git cmake ninja-build gperf ccache dfu-util dtc wget \ python3-pip python3-tkinter xz file glibc-devel.i686 libstdc++-devel.i686 python38 \ SDL2-devel
sudo swupd bundle-add c-basic dev-utils dfu-util dtc \ os-core-dev python-basic python3-basic python3-tcl
The Clear Linux focus is on native performance and security and not cross-compilation. For that reason it uniquely exports by default to the environment of all users a list of compiler and linker flags. Zephyr’s CMake build system will either warn or fail because of these. To clear the C/C++ flags among these and fix the Zephyr build, run the following command as root then log out and back in:
echo 'unset CFLAGS CXXFLAGS' >> /etc/profile.d/unset_cflags.sh
Note this command unsets the C/C++ flags for all users on the
system. Each Linux distribution has a unique, relatively complex and
potentially evolving sequence of bash initialization files sourcing each
other and Clear Linux is no exception. If you need a more flexible
solution, start by looking at the logic in
sudo pacman -S git cmake ninja gperf ccache dfu-util dtc wget \ python-pip python-setuptools python-wheel tk xz file make
A recent CMake version is required. Check what
version you have by using
cmake --version. If you have an older version,
there are several ways of obtaining a more recent one:
On Ubuntu, you can follow the instructions for adding the kitware third-party apt repository to get an updated version of cmake using apt.
Download and install a packaged cmake from the CMake project site. (Note this won’t uninstall the previous version of cmake.)
cd ~ wget https://github.com/Kitware/CMake/releases/download/v3.15.3/cmake-3.15.3-Linux-x86_64.sh chmod +x cmake-3.15.3-Linux-x86_64.sh sudo ./cmake-3.15.3-Linux-x86_64.sh --skip-license --prefix=/usr/local hash -r
hash -rcommand may be necessary if the installation script put cmake into a new location on your PATH.
Download and install from the pre-built binaries provided by the CMake project itself in the CMake Downloads page. For example, to install version 3.13.1 in
mkdir $HOME/bin/cmake && cd $HOME/bin/cmake wget https://github.com/Kitware/CMake/releases/download/v3.13.1/cmake-3.13.1-Linux-x86_64.sh yes | sh cmake-3.13.1-Linux-x86_64.sh | cat echo "export PATH=$PWD/cmake-3.13.1-Linux-x86_64/bin:\$PATH" >> $HOME/.zephyrrc
pip3 install --user cmake
Note this won’t uninstall the previous version of cmake and will install the new cmake into your ~/.local/bin folder so you’ll need to add ~/.local/bin to your PATH. (See Python and pip for details.)
Check your distribution’s beta or unstable release package library for an update.
On Ubuntu you can also use snap to get the latest version available:
sudo snap install cmake
After updating cmake, verify that the newly installed cmake is found
You might also want to uninstall the CMake provided by your package manager to
avoid conflicts. (Use
whereis cmake to find other installed
DTC (Device Tree Compiler)¶
A recent DTC version is required. Check what
version you have by using
dtc --version. If you have an older version,
either install a more recent one by building from source, or use the one that is
bundled in the Zephyr SDK by installing it.
A modern Python 3 version is required. Check what
version you have by using
If you have an older version, you will need to install a more recent Python 3. You can build from source, or use a backport from your distribution’s package manager channels if one is available. Isolating this Python in a virtual environment is recommended to avoid interfering with your system Python.
Install the Zephyr Software Development Kit (SDK)¶
Use of the Zephyr SDK is optional, but recommended. Some of the dependencies installed above are only needed for installing the SDK.
Zephyr’s SDK contains all necessary tools to build Zephyr on all supported architectures. Additionally, it includes host tools such as custom QEMU binaries and a host compiler. The SDK supports the following target architectures:
Follow these steps to install the Zephyr SDK:
Download the latest SDK as a self-extracting installation binary:
(You can change 0.12.4 to another version if needed; the Zephyr Downloads page contains all available SDK releases.)
Run the installation binary, installing the SDK at
cd <sdk download directory> chmod +x zephyr-sdk-0.12.4-x86_64-linux-setup.run ./zephyr-sdk-0.12.4-x86_64-linux-setup.run -- -d ~/zephyr-sdk-0.12.4
You can pick another directory if you want. If this fails, make sure Zephyr’s dependencies were installed as described in Install Requirements and Dependencies.
If you ever want to uninstall the SDK, just remove the directory where you installed it.
It is recommended to install the Zephyr SDK at one of the following locations:
[-x.y.z] is optional text, and can be any text, for example
If you install the Zephyr SDK outside any of those locations, then it is
required to register the Zephyr SDK in the CMake package registry during
installation or set
ZEPHYR_SDK_INSTALL_DIR to point to the Zephyr
SDK installation folder.
ZEPHYR_SDK_INSTALL_DIR can also be used for pointing to a folder
containing multiple Zephyr SDKs, allowing for automatic toolchain selection,
this allow Zephyr to pick the right toolchain, while allowing multiple Zephyr SDKs to be grouped together at a custom location.
Building on Linux without the Zephyr SDK¶
The Zephyr SDK is provided for convenience and ease of use. It provides toolchains for all Zephyr target architectures, and does not require any extra flags when building applications or running tests. In addition to cross-compilers, the Zephyr SDK also provides prebuilt host tools. It is, however, possible to build without the SDK’s toolchain by using another toolchain as as described in the main Getting Started Guide document.
As already noted above, the SDK also includes prebuilt host tools. To use the
SDK’s prebuilt host tools with a toolchain from another source, you must set the
ZEPHYR_SDK_INSTALL_DIR environment variable to the Zephyr SDK
installation directory. To build without the Zephyr SDK’s prebuilt host tools,
ZEPHYR_SDK_INSTALL_DIR environment variable must be unset.
To make sure this variable is unset, run: