From 05c1e3021ba2c8b894cb62660958353052cb030b Mon Sep 17 00:00:00 2001
From: hadaq <hadaq>
Date: Fri, 14 Dec 2012 14:42:14 +0000
Subject: [PATCH] System startup script included, event builder configuration
 updated, cts startup updated

---
 trb3/trb3qs_configuration.tex | 22 ++++++++-----
 trb3/trb3qs_daqstartup.tex    | 59 ++++++++++++++++++++++++++++++++++-
 trb3/trb3qs_software.tex      |  8 ++---
 3 files changed, 76 insertions(+), 13 deletions(-)

diff --git a/trb3/trb3qs_configuration.tex b/trb3/trb3qs_configuration.tex
index c662d0f..ae433fe 100644
--- a/trb3/trb3qs_configuration.tex
+++ b/trb3/trb3qs_configuration.tex
@@ -228,15 +228,21 @@ As the last you should rerun merging of the addresses and serials.
 You must configure your TRB3 which is the IP address of the Event Builder. This
 you can set in proper registers of the central FPGA of
 the TRB3. For this in the file \verb+~/trb3user/configure_trb3.sh+ (see Listing
-\ref{lst:trb3user}) find line starting with \verb+#mac address of the EB+, in
-register \verb+0x8100+ write lower four bytes of the MAC and \verb+0x8101+ two
-upper bytes, for example for MAC \verb+00:11:22:33:44:55:66+ configuration look
-following
+\ref{lst:trb3user}) find line starting with \verb+# Event Builder host configuration+,
+in register \verb+0x8100+ write lower four bytes of the MAC, in \verb+0x8101+ two
+upper bytes, in register \verb+0x8102+ put IP address of the EB and in \verb+0x8103+
+the port number.
 \begin{lstlisting}[label=,caption=Settings Event Builder address for TRB3]
-#mac address of the EB
-#ebhost 00:11:22:33:44:55
-trbcmd w 0x8000 0x8100 0x22334455  # lower bytes
-trbcmd w 0x8000 0x8101 0x0011      # upper bytes
+# Event Builder host configuration
+# registers 0x8100 and 0x8101 - MAC address
+# host MAC: 00:11:22:33:44:55
+trbcmd w 0x8000 0x8100 0x22334455
+trbcmd w 0x8000 0x8101 0x0011   #upper byte
+# registers 0x8102 and 0x8103 - ip address and port
+# 192.168.1.1 in hex is c0.a8.01.01
+trbcmd w 0x8000 0x8102 0xc0a80101
+# port, default if 5000 -> c350 in hex
+trbcmd w 0x8000 0x8103 0xc350
 \end{lstlisting}
 
 \subsection{CTS monitor configuration}
diff --git a/trb3/trb3qs_daqstartup.tex b/trb3/trb3qs_daqstartup.tex
index ee897bc..9087b3e 100644
--- a/trb3/trb3qs_daqstartup.tex
+++ b/trb3/trb3qs_daqstartup.tex
@@ -5,7 +5,9 @@
 We have to start CTS server
 \begin{lstlisting}[label=,caption=Starting CTS server]
 $ cd ~/trbsoft/trb3/cts
-$ ./cts_gui
+$ ./cts_gui # this will run in window mode
+# to start in text mode (no extra xterm window) run with additional arguments
+$ ./cts_gui 1 1 # this will run in text mode
 \end{lstlisting}
 
 \subsection{Event builder}
@@ -44,3 +46,58 @@ $ daq_netmem -m 1 -i UDP:0.0.0.0:50000 -q 32 -d 1 -S test
 \end{lstlisting}
 where value for parameter \verb+-S+ should be the same like for
 \verb+daq_evtbuild+.
+
+\subsection{Starting TRB3}
+
+Startap of the whole TRB3 boards system can be encoles in startup script
+shown of Listing \ref{start-system} (it is also available in user scripts,
+see Section \ref{sec:userscripts}).
+
+First the script updates all TRB3 with proper addresses, next the basic
+configuration of the TRB3 (event builder) is set. After this user can edit
+script to adjust other settings like TDC window, trigger settings, pulser
+frequency.
+
+\begin{lstlisting}[label=start_system,caption=start\_system.sh script]
+#!/bin/bash
+
+# updating addressess for all TRBs
+~/trbsoft/trb3/merge_serial_address.pl  \
+        ~/trb3/base/serials_trb3.db     \
+        ~/trb3/base/addresses_trb3.db   \
+        > /dev/null
+
+# base configuring of EB and GbE
+~/trb3user/configure_trb3.sh # central hub configuration to send data via GbE
+
+
+# Additional settings - Examples
+# ==============================
+
+# TDC
+# ------------------------------
+# setup tdcs on TRB3
+#trbcmd w 0xfe45 0xc0 0x00000001 ## logic analyser control register
+#trbcmd w 0xfe45 0xc1 0x000f0005 ## trigger window enable & trigger window width
+#trbcmd w 0xfe45 0xc2 0xffffffff ## channel 01-31 enable
+#trbcmd w 0xfe45 0xc3 0xffffffff ## channel 32-63 enable
+
+
+# CTS
+# ------------------------------
+#trbcmd loadbit 0x003 0xA0C1 0x0000000F 0x00000004
+#trbcmd setbit 0x0003 0xA0C2 0x01000000
+
+#trbcmd w 0x0003 0xA0f1 0x20    #Events per EB
+#trbcmd w 0x0003 0xA0f0 0x0001  #15 - 0 EB enable , 
+                                #31 - 16 downscale of RPC/TOF TDC trailers and headers
+
+# pulser to 5 Hz
+#trbcmd w 0x3 0xa0e3 0x1ffffff
+
+# PT1 on
+#trbcmd w 0x0003 0xa0c3 0x10000000
+#trbcmd w 0x0003 0xa0c4 0x0
+#trbcmd w 0x0003 0xa0c5 0x3ff
+#trbcmd w 0x0003 0xa0c7 0x800
+\end{lstlisting}
\ No newline at end of file
diff --git a/trb3/trb3qs_software.tex b/trb3/trb3qs_software.tex
index 3f28106..da31064 100644
--- a/trb3/trb3qs_software.tex
+++ b/trb3/trb3qs_software.tex
@@ -18,7 +18,6 @@ $ cvs -d :ext:hadaq@lxi001.gsi.de:/misc/hadesprojects/daq/cvsroot co trb3/README
 \end{lstlisting}
 % $ cvs -d :ext:hadaq@lxi001.gsi.de:/misc/hadesprojects/daq/cvsroot co hadaq
 
-
 \begin{lstlisting}[label=,caption=Preparation of TRB3 tools]
 $ cd ~/trbsoft/trbnettools
 $ cat HOWTO_COMPILE.TXT # now you can see all posible ways to compile software
@@ -58,10 +57,11 @@ If you get error
 edit file \verb+evtbuild.c+, comment out \verb+#define RFIO+ and repeat last
 command (the \verb+for+ loop).
 
+\subsection{User scripts}\label{sec:userscripts}
 
-On the it is recommended to create init script for preparing environment. User
-can create his own or use already prepared user scripts. To get them he must run
-following
+On the end it is recommended to create init script for preparing environment.
+User can create his own or use already prepared user scripts. To get them he
+must run following
 
 \begin{lstlisting}[label=lst:trb3user,caption=User scripts preparation]
 $ cd ~
-- 
2.43.0