Intel Agilex® 7 Hard Processor System Remote System Update User Guide

ID 683184
Date 6/09/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

7.1.13. Building the Root File System

A root file system is required to boot Linux*. There are a lot of ways to build a root file system, depending on your specific needs. This section shows how to build a small root file system using Yocto.

  1. Various packages may be needed by the build system. On a Ubuntu 18.04 machine the following command was used to install the required packages:
    sudo apt-get install gawk wget git-core diffstat unzip texinfo \
         gcc-multilib build-essential chrpath socat cpio python python3 \
         python3-pip python3-pexpect xz-utils debianutils iputils-ping \
         python3-git python3-jinja2 libegl1-mesa libsdl1.2-dev pylint3 xterm
  2. Run the following commands to build the root file system:
    cd $TOP_FOLDER
    rm -rf yocto && mkdir yocto && cd yocto
    git clone -b honister git://git.yoctoproject.org/poky.git
    git clone -b honister git://git.yoctoproject.org/meta-intel-fpga.git
    source poky/oe-init-build-env ./build
    echo 'MACHINE = "agilex"' >> conf/local.conf
    echo 'BBLAYERS += " ${TOPDIR}/../meta-intel-fpga "' >> conf/bblayers.conf
    echo 'IMAGE_FSTYPES = "tar.gz"' >> conf/local.conf
    bitbake core-image-minimal

    After the build completes, which can take a few hours depending on your host system processing power and Internet connection speed, the following root file system archive is created: $TOP_FOLDER/yocto/build/tmp/deploy/images/agilex/core-image-minimal-agilex.tar.gz

    For more information about building Linux*, including building the rootfs using Yocto, refer to the Rocketboards Getting Started web page.