From 4735ecc19f1334159c069921369a96a16ccba0b5 Mon Sep 17 00:00:00 2001
From: Nico Schottelius <nico@nico-notebook.schottelius.org>
Date: Sun, 4 Aug 2019 11:37:06 +0200
Subject: [PATCH] ++notes

---
 doc/appendix.tex | 58 +++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 57 insertions(+), 1 deletion(-)

diff --git a/doc/appendix.tex b/doc/appendix.tex
index 83358c3..8b7b6b3 100644
--- a/doc/appendix.tex
+++ b/doc/appendix.tex
@@ -1,4 +1,60 @@
-\chapter{\label{appendixA}Test descriptions}
+\chapter{\label{appendixminus1}Resources and code repositories}
+The following sections describe how to acquire the resources
+to reproduce the test results.
+
+\section{\label{chapterminus1:thesis}Master Thesis}
+The master thesis including all self developed source code is
+available by git via
+
+\begin{verbatim}
+git clone git@gitlab.ethz.ch:nicosc/master-thesis.git
+\end{verbatim}
+
+It can be browsed online on \url{https://gitlab.ethz.ch/nicosc/master-thesis}.
+% ----------------------------------------------------------------------
+\section{\label{chapterminus1:thesis}Xilinx Toolchain}
+A prerequisite for building the NetFGPA source code is the
+installation of
+\begin{itemize}
+\item \verb=Xilinx_SDNet_2018.2_1005_9=
+\item \verb=Xilinx_Vivado_SDK_2018.2_0614_1954=
+\end{itemize}
+
+Both tools need to be installed to /opt/Xilinx/, as paths are
+hardcoded in various places.
+
+% ----------------------------------------------------------------------
+\section{\label{chapterminus1:thesis}NetFGPA}
+To be able to compile P4 source code to the NetFPGA the collection of
+scripts, Makefiles and sample code of P4-NetFGPA is required.
+
+The repository \url{git@github.com:NetFPGA/P4-NetFPGA-live.git} needs
+to be cloned to ``projects'' subdirectory as ``P4-NetPFGA''
+of the user that wants to
+compile the source code. Access to the repository is granted after
+applying for access as described on
+\url{https://github.com/NetFPGA/P4-NetFPGA-public/wiki}.
+After that the variable \verb=P4_PROJECT_NAME= in
+\url{~/projects/P4-NetFPGA/tools/settings.sh} needs to be modified to
+read \verb|export P4_PROJECT_NAME=minip4| instead of
+\verb|export P4_PROJECT_NAME=switch_calc|.
+
+Sample code for installation:
+
+\begin{verbatim}
+  mkdir -p ~/projects
+  git clone git@github.com:NetFPGA/P4-NetFPGA-live.git P4-NetFPGA
+  sed -i 's/\(P4_PROJECT_NAME=\).*/\1minip4/' ~/projects/P4-NetFPGA/tools/settings.sh
+\end{verbatim}
+
+% ----------------------------------------------------------------------
+\chapter{\label{appendix0}BMV2 environment and tests}
+\section{\label{chapter0:bmv2-diff}Diff based checksumming}
+
+\begin{verbatim}
+\end{verbatim}
+
+\chapter{\label{appendixA}NetFPGA environment and tests}
 \section{\label{chapterA:netpfga-setup}NetFPGA Setup}
 Description of installation, commit of netpfga-live