added new information for DABC/G04 caliration,mt

diff --git a/trb3/trb3qs_analysis.tex b/trb3/trb3qs_analysis.tex
index dc40b9eb3da7487f38ad718e1aff78c694f50c97..725ba7d2f0e49a11343963550c8a921abd12c496 100644 (file)
--- a/trb3/trb3qs_analysis.tex
+++ b/trb3/trb3qs_analysis.tex
@@ -4,26 +4,15 @@
 Now you can control your DAQ system and take data.
 To analyse the data different groups prepared software packages.
 All tools need root as a prerequisite the root package from CERN.
-To install do the following:
-
+To install root, follow the instructions at
 \begin{lstlisting}[label=,caption=Install ROOT]
-sudo mkdir /opt/root/
-sudo chown hadaq.users /opt/root/
-cd /opt/root
-wget ftp://root.cern.ch/root/root_v5.34.08.source.tar.gz
-tar -xvf root_v5.34.08.source.tar.gz
-cd root-v5-34-00-patches
-./configure linuxx8664gcc
-make -j8 
-\end{lstlisting}
+  https://root.cern/install/
+\end
+For the DABC/Go4 package the installation of root is included.
+
 Needs quite some time to compile.
 All the following tools need the root environment, so you have to set the
 environment variables with:
-\begin{lstlisting}
-cd /opt/root/root-v5-34-00-patches/
-. bin/thisroot.sh
-cd -
-\end{lstlisting}
 
 \subsection{Mainz Unpacker}
 
@@ -81,30 +70,16 @@ In the end the whole building process can be reduced to:
 cd ~/trbsoft/
 svn co https://subversion.gsi.de/dabc/trb3 trb3
 cd trb3
-make -j4
+make -j16
 cd ..
 \end{lstlisting}
-However make sure that you use the correct Root version (indicated in the requirements).
-For DABC (data readout) one need a configuration file:
-
-\begin{lstlisting}
-cd ~/trbsoft/trb3/dabc
-wget https://subversion.gsi.de/dabc/trunk/plugins/hadaq/app/EventBuilder.xml
-\end{lstlisting}
-This config file has to be edited.
-
-Then the specific analysis part has to be installed.
 
+Now you can enable the needed environment to run the tools:
 \begin{lstlisting}
-cd ~/trbsoft/trb3
-
-wget https://subversion.gsi.de/go4/app/stream/include/hadaq/
-wget https://subversion.gsi.de/go4/app/stream/framework/hadaq/
-wget https://subversion.gsi.de/go4/app/stream/applications/trb3tdc/first.C
-
+. ~/trbsoft/trb3/trb3login
 \end{lstlisting}
 
-Then continue as described in the Readme.txt.
+Now you can start the tools dabc and go4.
 
 \begin{warning} You will not see any event delivered by DABC, if your trigger
   rate is set too low, e.g. 100~Hz. First set your trigger rate to a higher
@@ -112,12 +87,69 @@ Then continue as described in the Readme.txt.
 \end{warning}
 
 
-\subsection{DABC documentation}
-
-A TRB3-related web-page for the DABC-software is here:
+\subsection{Go4 calibration run}
+To make usesful measurements, you first have to run a calibration of the TDC.
+For that you have to do the following steps:
+
+\begin{itemize}
+  
+\item run the TRB-DAQ with internal pulser as trigger (eg. 50kHz) sending data
+  to the dabc-eventbuild 
+\item turn on all channels, but take care that there is not in input signal
+  fed into the channels (needed for TDCv2, in the TDCv4 the external signals
+  can be blocked inside the FPGA)
+\item go to the CTS control web-page and switch to trigger-type ``0xd''
+  (``calibration trigger''). Now Calibration data for each channel is sent to
+  the dabc and processes by go4.
+\item take care that in first.C (the configuration file for the analysis tool)
+  the parameters are set correctly.
+  e.g.:
+  \begin{itemize}
+  \item
+    \begin{lstlisting}
+      hadaq::TrbProcessor::SetHUBRange(0x8000, 0x8fff);
+    \end{lstlisting}
+    to the correct range of TRB-Net-HUBs in the system, so that go4-analysis
+    can unpack the data.
+  \item \begin{lstlisting} 
+      hadaq::TrbProcessor::SetTDCRange(0x1000,0x1FFF);
+    \end{lstlisting}
+    to set the range TRBNet-Addresses of the TDCs to be unpacked
+  \end{itemize}
+\end{itemize}
+
+Then let go4-analysis acquire 100000 events (can also be changed in first.C)
+and then each channel of the TDC should be calibrated.
+This can be verified by opening the following histogram by clicking in the Go4
+GUI, where the explicit TrbNet-Hub-Numbers and TRB-Net-Addreses of TDCs
+(e.g. ``C001'' for the HUB and ``16F7'' for the TDC) will be different in your
+setup): 
 \begin{lstlisting}
-http://dabc.gsi.de/doc/dabc2/hadaq_trb3_package.html
+  Analysis -> Histograms -> TRB_C001 -> TDC_16F7 -> Ch02 ->
+  TDC_16F7_Ch02_RisingCalibr 
 \end{lstlisting}
+This plot should look like figure \ref{fig:tdccalibrationplot}.
+\begin{figure}[!ht]
+  \centering
+  \includegraphics[width=1.0\textwidth]{trb3qs_img/go4_rising_calibration_plot.png}
+  \caption{A plot of the TDC calibration values. This should be nearly a
+    straight line. If there are strong bumps, the calibration was not made
+    correctly.}
+  \label{fig:tdccalibrationplot}
+\end{figure}
+
+Now one can measure real input signals and for example two signals from a
+arbritrary waveform generator, with a fixed delay between the two channels.
+The plot can be seen in in figure \ref{fig:tdcexampletimediff}
+
+\begin{figure}[!ht]
+  \centering
+  \includegraphics[width=1.0\textwidth]{trb3qs_img/tdc_example_time_diff.png}
+  \caption{A plot of the measured time difference of two channels of one
+    FPGA-TDC with an input signal ~40ns delayed. The time precision is
+    measured to be 15ps. This is measured with a DiRICH-board.}
+  \label{fig:tdcexampletimediff}
+\end{figure}
 
 
 %\begin{figure}[!ht]