/tegra-demo-distro

Reference/demonstration distro for meta-tegra

Primary LanguageCMIT LicenseMIT

tegra-demo-distro

Reference/demo distribution for NVIDIA Jetson platforms using Yocto Project tools and the meta-tegra BSP layer.

Build status

Metadata layers are brought in as git submodules:

Layer Repo Branch Description
poky master OE-Core from poky repo at yoctoproject.org
meta-tegra master L4T BSP layer - L4T R35.3.1/JetPack 5.1.1
meta-tegra-community master OE4T layer with additions from the community
meta-openembedded master OpenEmbedded layers
meta-virtualization master Virtualization layer for docker support

Prerequisites

See the Yocto Project Quick Build documentation for information on setting up your build host.

For burning SDcards (for Jetson Xavier NX developer kits), the bmap-tools package is recommended.

Setting up

  1. Clone this repository:

     $ git clone https://github.com/OE4T/tegra-demo-distro.git
    
  2. Switch to the appropriate branch, using the wiki page for guidance.

  3. Initialize the git submodules:

     $ cd tegra-demo-distro
     $ git submodule update --init
    
  4. Source the setup-env script to create a build directory, specifying the MACHINE you want to configure as the default for your builds. For example, to set up a build directory called build that is set up for the Jetson Xavier NX developer kit and the default tegrademo distro:

     $ . ./setup-env --machine jetson-xavier-nx-devkit
    

    You can get a complete list of available options, MACHINE names, and DISTRO names with

     $ . ./setup-env --help
    
  5. Optional: Install pre-commit hook for commit autosigning using $ ./scripts-setup/setup-git-hooks

Distributions

Use the --distro option with setup-env to specify a distribution for your build, or customize the DISTRO setting in your $BUILDDIR/conf/local.conf to reference one of the supported distributions.

Currently supported distributions are listed below:

Distribution name Description
tegrademo Default distro used to demonstrate/test meta-tegra features

Images

The tegrademo distro includes the following image recipes, which are dervied from the core-image-XXX recipes in OE-Core but configured for Jetson platforms. They include some additional test tools and demo applications.

Recipe name Description
demo-image-base Basic image with no graphics
demo-image-egl Base with DRM/EGL graphics, no window manager
demo-image-sato X11 image with Sato UI
demo-image-weston Wayland with Weston compositor
demo-image-full Sato image plus nvidia-docker, openCV, multimedia API samples

Contributing

Please see the contributor wiki page at this link. Contributions are welcome!