timing-docker

Purpose

TL;DR: This is a Docker container image which is used for building bel_projects.

If you can't compile or synthesize bel_projects (because your distribution has dropped Python2 support or uses a recent GCC version, ...) this will help you out. Even Etherbone and Saftlib can be compiled without problems.

Prerequisites

• Valid Quartus license
• Quartus installation on your host (18.1 recommended)
• Docker environment

Quartus License

Here comes the tricky part:

1. Use the Makefile target to copy your license into the container:

$ make copy_license LICENSE_FILE=/home/user/___path_to_your_license_file___/license.dat
$ OPTIONAL: make build

2. Give your container the right MAC address (used by your Quartus license):

$ make create_mac MAC_ADDR=___your_mac_address___ # format: 01:23:45:67:89:ab
$ OPTIONAL: make build

3. Start the container:

$ make QUARTUS_DIR=/opt/quartus/___path_to_your_quartus_directory___/ # on your host ***

*** Expected structure in your Quartus directory (example):

ls -la /opt/quartus
total 40
drwxrwxr-x. 10 root quartus 4096 Nov 23  2018 ./
drwxrwxr-x.  4 root quartus 4096 Jul  8  2019 ../
drwxrwxr-x. 12 root quartus 4096 Nov 23  2018 hld/
drwxrwxr-x.  9 root quartus 4096 Nov 23  2018 hls/
drwxr-xr-x.  3 root quartus 4096 Nov 23  2018 ip/
drwxr-xr-x.  7 root quartus 4096 Nov 23  2018 licenses/
drwxrwxr-x.  2 root quartus 4096 Nov 23  2018 logs/
drwxrwxr-x.  7 root quartus 4096 Nov 23  2018 nios2eds/
drwxrwxr-x. 16 root quartus 4096 Nov 23  2018 quartus/
drwxrwxr-x.  2 root quartus 4096 Nov 23  2018 uninstall/

4. Test if everything works:

$ cd workspace # inside you container
$ OPTIONAL: ./start.sh # inside your container ***
$ OPTIONAL: cd bel_projects # inside your container
$ OTTIONAL: make exploder5 # inside your container

*** This will build Etherbone/Saftlib/tools and handle the GIT flow.

Docker

You need a working Docker installation. Check the official Docker docs:

• CentOS: https://docs.docker.com/engine/install/centos/
• Debian: https://docs.docker.com/engine/install/debian/
• Fedora: https://docs.docker.com/engine/install/fedora/
• Ubuntu: https://docs.docker.com/engine/install/ubuntu/

Important Docker Commands

$ sudo systemctl enable docker
$ sudo systemctl status docker
$ sudo systemctl start docker
$ sudo systemctl stop docker

Common Problems

Where can I get my builds?

Just work inside the workspace directory, this will be mounted.

Quartus or make target crashes (core dumped)

Solution:

$ LD_PRELOAD=/lib/x86_64-linux-gnu/libudev.so.1 quartus
$ LD_PRELOAD=/lib/x86_64-linux-gnu/libudev.so.1 make exploder5