We suggest that you use a remote server hosted by the CRNCH Rogues Gallery. This option will be available until the end of the conference
Please use the form to submit your Github ID to reserve a slot to use for the duration of the tutorial.
Login to rg-hub.crnch.gatech.edu/jupyter using your Github account.
| Note: Participants do not need a password to log in. They have to agree / authorize to join the "gt-crnch-rg" GitHub team to get access, and their GitHub username and password is used for authentication.
Then, click "Start My Server".
Once there, open the terminal application and follow below steps
$ whoami
crunchjupyter
$ pwd
/tmp
Everything you create (clones, builds, edits) must live in a directory on the server, not inside the container: the container's own writable space is only 64 MB.
$ git clone --branch v3.0 --recursive --depth 1 https://github.com/vortexgpgpu/vortex.git
$ git clone --depth 1 https://github.com/vortexgpgpu/vortex_tutorials.git
$ mkdir work
The command
- uses the pre-built apptainer image and
- mounts your Vortex clone, the tutorial repository, a work directory and the shared toolchain onto the apptainer
$ apptainer shell --cleanenv --writable-tmpfs \
--bind ./vortex:/home/vortex \
--bind ./vortex_tutorials:/home/vortex_tutorials \
--bind ./work:/home/work \
--bind /netscratch/tutorials/micro-tutorial-2026/vortex-tools-v3.0:/home/tools \
/netscratch/tutorials/micro-tutorial-2026/vortex_micro26.sif
Apptainer> export TUTORIAL=/home/vortex_tutorials
Apptainer> cd /home/vortex
Apptainer> mkdir build32 && cd build32
Apptainer> ../configure --xlen=32 --tooldir=$TOOLDIR
Apptainer> make -s -j4
Apptainer> echo $TOOLDIR
/home/tools
Apptainer> ls $TOOLDIR
chipstar gem5 libc32 libc64 libcrt32 libcrt64 llvm-vortex mesa-vortex pocl riscv32-gnu-toolchain riscv64-gnu-toolchain sta sv2v verilator yosys
$TOOLDIR is already set to the toolchain mount (/home/tools). The toolchain is installed and the system packages are in the image, so the ./ci/toolchain_install.sh and ./ci/install_dependencies.sh steps of the exercise setup are not needed. Use -j; without it the build takes much longer.
SIMX
Apptainer> ./ci/blackbox.sh --cores=2 --app=vecadd --driver=simx
RTLSIM
Apptainer> ./ci/blackbox.sh --cores=2 --app=vecadd --driver=rtlsim
XRTSIM
Apptainer> ./ci/blackbox.sh --cores=2 --app=vecadd --driver=xrt
Follow the exercises in the tutorial repository