From 8cade9435faf09930a415d2f4f84a04a99866d50 Mon Sep 17 00:00:00 2001
From: Nico Schottelius <nico@nico-notebook.schottelius.org>
Date: Fri, 10 May 2019 23:28:17 +0200
Subject: [PATCH] ++netpfga notes

---
 netpfga-doc-and-log/README.md | 51 ++++++++++++++++++++++++++++++++++-
 netpfga-doc-and-log/bashinit  | 15 +++++++++++
 2 files changed, 65 insertions(+), 1 deletion(-)
 create mode 100644 netpfga-doc-and-log/bashinit

diff --git a/netpfga-doc-and-log/README.md b/netpfga-doc-and-log/README.md
index 5f5b32f..b16bb57 100644
--- a/netpfga-doc-and-log/README.md
+++ b/netpfga-doc-and-log/README.md
@@ -52,7 +52,10 @@ Don't continue until you do see the debug messages above.
   forever)
 * Unpack the file, run xsetup, put stuff below /opt/Xilinx
 
-### Install NetPFGA support
+### Get the NetPFGA repo
+
+This is a private repo, you will need to ask permission for it
+[Nico: add the URL to the form in here].
 
 ```
 mkdir -p ~/projects
@@ -63,3 +66,49 @@ git clone git@github.com:NetFPGA/P4-NetFPGA-live.git
 Do NOT trust manuals to checkout a specific version, especially not
 v1.2.0, it is broken with vivado 2018.3. Also, DO NOT trust this
 manual, it might already be outdated at the time reading.
+
+### Configure your PATHs
+
+You do want to use the tools and you do want to have some settings
+files to help you running the compiler. Create a shell script
+*similar* to the following (adapt paths to your need):
+
+```
+#### SDNet ####
+. /opt/xilinx/SDNet/2018.2/settings64.sh
+export PATH=$PATH:/opt/xilinx/SDNet/2018.2/bin
+
+##### Vivado #####
+. /opt/Xilinx/Vivado/2018.3/settings64.sh
+export PATH=$PATH:/opt/Xilinx/Vivado/2018.3/bin
+
+#### P4-NetFPGA #####
+. ~/projects/P4-NetFPGA/tools/settings.sh
+
+
+# set DISPLAY env variable so that xsct works properly from cmdline
+if [ -z "$DISPLAY" ]; then
+    export DISPLAY=dummy
+fi
+
+```
+
+### Compile the NetPFGA drivers
+
+
+```
+cd $SUME_FOLDER/lib/hw/xilinx/cores/tcam_v1_1_0/ && make update && make
+cd $SUME_FOLDER/lib/hw/xilinx/cores/cam_v1_1_0/ && make update && make
+cd $SUME_SDNET/sw/sume && make
+cd $SUME_FOLDER && make
+
+```
+
+## Known / encountered BUGS
+
+### Failing to compile tcam
+
+### Failing to compile tcam
+
+
+### Failing to compile cam
diff --git a/netpfga-doc-and-log/bashinit b/netpfga-doc-and-log/bashinit
new file mode 100644
index 0000000..e3af8d2
--- /dev/null
+++ b/netpfga-doc-and-log/bashinit
@@ -0,0 +1,15 @@
+##### Vivado #####
+. /opt/Xilinx/Vivado/2018.3/settings64.sh
+
+#### P4-NetFPGA #####
+. ~/projects/P4-NetFPGA/tools/settings.sh
+
+#### SDNet ####
+export PATH=$PATH:/opt/xilinx/SDNet/2018.2/bin
+export PATH=$PATH:/opt/Xilinx/Vivado/2018.3/bin
+. /opt/xilinx/SDNet/2018.2/settings64.sh
+
+# set DISPLAY env variable so that xsct works properly from cmdline
+if [ -z "$DISPLAY" ]; then
+    export DISPLAY=dummy
+fi