Lab Setup

Prerequisite Skills

In this class you are expected to be familiar with the Linux command line, Git and Github. If you haven’t used these tools before, here are links to a few tutorials:

Environment

The assignments assume you are running an Ubuntu 20.04 Linux Operating System. You may be able to complete some assignments on other Linux variants; however, for the assignments that use the Xilinx Vivado tools, you will need a supported operating system (Ubuntu 18 LTS may work as well).

You will need a Linux OS environment set up to complete the assignments. A few options:

  • VMWare Workstation is available for free to BYU students through CAEDM. It’s very easy to set up your own Ubuntu virtual machine.
  • You can run Ubuntu from a USB drive or external hard drive.
  • You install a full Ubuntu image (including Xilinx tools) in Windows using WSL2.
  • You can set up a computer with Linux, or even dual-boot Linux and Windows/MacOS (dual-boot is a bit more complicated than these other options).
  • Alternatively, I have a server available that you can ssh into. You will have to be connected to the CAEDM VPN to use this, so if you choose this option, make sure you have a good internet connection. If you want to go this route, please email me your desired username and I will create a login for you.

Note: The Xilinx Vitis tool that we will be using requires about 80-90GB of disk space. So whatever option you choose, make sure you give yourself plenty of room.

Tools

Some notes on software tools we will be using.

  • I recommend you use VS Code for code editing.
  • I recommend that you set up SSH keys with Github to avoid having to enter your password when pushing your code up.
  • We will be using Xilinx’s Vitis 2020.2 tool, but not starting until Lab 4.
  • The earlier labs will only use open-source software available via apt. Make sure you have sudo permissions on your Linux machine so that you can install the necessary packages (ie. you can’t complete the class labs using the CAEDM servers).

Class Repository

  1. You must use this invitation link to set up a Github classroom repo for the class: https://classroom.github.com/a/B3CVEv7k

  2. This will create a blank repository for you. On the github website for your repo, click the Import Code button (shown below), and import from https://github.com/byu-cpe/ecen625_student. Screen shot of how to import code
  3. Clone your repository to your local machine.

Getting Code Updates

If for some reason, I need to fix a problem with the starter code, you will need a way of pulling those changes down onto your computer. The easiest approach is to create another remote for your git repo. By default, you will have one remote, origin, which will point to your GitHub repo. Add another one using the following command:

  git remote add template [URL OF LAB TEMPLATE REPO]

If you ever need to pull down changes I made (I will let you know when this is the case), you can do the following:

git fetch template
git merge template/master

Submitting Code

Lab submissions will be done by creating a tag in your Git repository. You can do this like so:

git tag lab1_submission
git push origin lab1_submission

If, after you create this tag, you want to change it (ie, re-submit your code), you can re-run the above commands and include the –force option, ie:

git tag --force lab1_submission
git push --force origin lab1_submission