Skip to content

Releases: carlesfernandez/docker-petalinux2

docker-petalinux2 v1.0

09 May 10:25
@carlesfernandez carlesfernandez
v1.0
This tag was signed with the committer’s verified signature. The key has expired.
carlesfernandez Carles Fernandez
GPG key ID: 4C583C52B0C3877D
Expired
Learn about vigilant mode.
4ff0293
This commit was signed with the committer’s verified signature. The key has expired.
carlesfernandez Carles Fernandez
GPG key ID: 4C583C52B0C3877D
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
docker-petalinux2 v1.0 Latest
Latest

docker-petalinux2

DOI

A somehow generic Xilinx PetaLinux & Vivado Docker image, using Ubuntu 18.04 as the base image.

PetaLinux version 2020.1 is the first version handled by this release. For former versions, please check docker-petalinux.

In order to use this tool, you need to install Docker in your machine. If you want to use the Vivado graphical interface, you will also need the ipconfig utility (on Debian/ubuntu: sudo apt-get install net-tools).

A Xilinx user ID is required to download the PetaLinux and Vivado installers.

Download the installers

Prepare the PetaLinux installer

The PetaLinux Installer is to be downloaded from the Xilinx's Embedded Design Tools website.

Place the downloaded petalinux-v<VERSION>-final-installer.run file (where <VERSION> can be 2020.1, 2020.2, ...) in the same folder as the Dockerfile.

Prepare the Vivado installer (optional)

Optionally, Vivado can be downloaded from the Xilinx's Vivado Design Tools website. Go there and choose the All OS installer Single-File Download (TAR/GZIP).

The file is called something like Xilinx_Unified_<VERSION>_XXXX_YYYY.tar.gz. Place it in the same folder as the Dockerfile. The building script will guess its exact name automatically.

If this file is present when building the image, the Docker image will be about 120 GB so make sure you have enough space in /var/lib/docker. Be aware that the building process can take some hours.

You can change your Docker disk utilization in the Docker GUI: select the Docker icon and then Preferences > Resources > Advanced, and then click "Apply & Restart".

For other versions than 2020.1, you might need to tune the Vivado installing configuration by modifying the install_config.txt file. Please do not change the Destination=/tools/Xilinx entry. This file can be generated by unzipping the installer somewhere else and running:

./xsetup -b ConfigGen

Then, copy the file generated at ~/.Xilinx/install_config.txt over the file in this repository. Just be sure to set Destination=/tools/Xilinx as the path where Xilinx software will be installed on the image.

If the Vivado installer file is not present in the folder when running the building script, the petalinux-only image will be about 11 GB and the building process will be much faster.

Build the image

Run:

./docker_build.sh <VERSION>

The default for <VERSION>, if not specified, is 2020.1.

Work with a PetaLinux project

A helper script petalin2.sh is provided that should be run inside a petalinux project directory. It basically is a shortcut to:

docker run -ti -v "$PWD":"$PWD" -w "$PWD" --rm -u petalinux petalinux:<latest version> $@

When run without arguments, a shell will spawn, with PetaLinux settings.sh already sourced, so you can directly execute petalinux-* commands.

user@host:/path/to/petalinux_project$ /path/to/petalin2.sh
petalinux2@host:/path/to/petalinux_project$ petalinux-build

Otherwise, the arguments will be executed as a command. Example:

user@host:/path/to/petalinux_project$ /path/to/petalin2.sh "petalinux-create -t project --template zynq --name myproject"

Using Vivado graphical interface

If the Vivado installer was present when building the Docker image, you can execute Vivado from the shell spawn when running petalin2.sh.

There are some steps on your side if you want to make use of Vivado's graphical interface before running the Docker container.

  • If your local machine is running Linux, adjust the permission of the X server host:

    $ sudo apt-get install x11-xserver-utils
$ xhost +local:root

  • If your local machine is running macOS:

    • Do this once:

    • Then, in the host machine:

      • Get your network IP with ipconfig getifaddr en1 for wireless, or ipconfig getifaddr en0 for ethernet.

      • Tell XQuartz to accept connections from that IP:

        $ xhost + 127.0.0.1 ; <- YOUR NETWORK IP HERE, OR REMOTE IP HOST

  • If you are accessing remotely the machine running the Docker container via ssh, you need to enable trusted X11 forwarding with the -Y flag:

    $ ssh user@host -Y

Now you can try it:

user@host:/path/to/petalinux_project$ /path/to/petalin2.sh
petalinux2@host:/path/to/petalinux_project# vivado

Enjoy!

Copyright and License

Copyright: © 2021 Carles Fernández-Prades, CTTC. All rights reserved.

The content of this repository is published under the MIT license.

Acknowledgements

This work was partially supported by the Spanish Ministry of Science, Innovation, and Universities through the Statistical Learning and Inference for Large Dimensional Communication Systems (ARISTIDES, RTI2018-099722-B-I00) project.

Assets 2
Loading