Adding chapter describing shutter.

Modifying timing diagrams

Adding chapter describing shutter.
Modifying timing diagrams
f3188947 · David Cussans · 6465509f · f3188947 · f3188947 · f3188947
Commit f3188947 authored Apr 09, 2019 by David Cussans
7 changed files
--- a/Documentation/Images/aida-tlu-aida-with-trigger-timing_01.svg
+++ b/Documentation/Images/aida-tlu-aida-with-trigger-timing_01.svg
--- a/Documentation/Images/aida-tlu-eudet-trigger-busy_01.svg
+++ b/Documentation/Images/aida-tlu-eudet-trigger-busy_01.svg
--- a/Documentation/Images/aida-tlu-eudet-trigger-busy_trignumber_01.svg
+++ b/Documentation/Images/aida-tlu-eudet-trigger-busy_trignumber_01.svg
@@ -26,6 +26,7 @@
        <dc:format>image/svg+xml</dc:format>
        <dc:type
           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title></dc:title>
      </cc:Work>
    </rdf:RDF>
  </metadata>
@@ -42,11 +43,11 @@
     inkscape:window-height="730"
     id="namedview22479"
     showgrid="false"
-     inkscape:zoom="1.35"
-     inkscape:cx="450.37037"
-     inkscape:cy="-13.888889"
-     inkscape:window-x="0"
-     inkscape:window-y="0"
+     inkscape:zoom="0.82068417"
+     inkscape:cx="477.36957"
+     inkscape:cy="74.5"
+     inkscape:window-x="85"
+     inkscape:window-y="90"
     inkscape:window-maximized="0"
     inkscape:current-layer="svgcontent_0" />
  <style

--- a/Documentation/Images/aida-tlu-sitra-shutter-timing_02.svg
+++ b/Documentation/Images/aida-tlu-sitra-shutter-timing_02.svg
@@ -26,6 +26,7 @@
        <dc:format>image/svg+xml</dc:format>
        <dc:type
           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title></dc:title>
      </cc:Work>
    </rdf:RDF>
  </metadata>

--- a/Documentation/Main_TLU.pdf
+++ b/Documentation/Main_TLU.pdf
--- a/Documentation/Main_TLU.tex
+++ b/Documentation/Main_TLU.tex
@@ -191,6 +191,7 @@ Paolo Baesso - \monthname,   \the\year
 \include{ch_TLU_clock}
 \include{DUT_signals}
 \include{ch_TLU_triggerInputs}
+\include{ch_Shutter}
 \include{ch_EventBuffer}
 \include{ch_TLU_Functions}
 \include{ch_TLU_IPBusRegs}

--- a/Documentation/ch_Shutter.tex
+++ b/Documentation/ch_Shutter.tex
+\section{Shutter}\label{ch:shutter}
+
+An optional ``shutter'' can be enabled. When the shutter is ``closed'' triggers are vetoed and no triggers are sent. When the shutter is ``open'' triggers can be generated and sent to active DUTs.
+
+The shutter cycle can either be started by an external signal or synchronized by a counter clocked by the system clock.
+
+The external signal, if used, must be connected to one of the trigger inputs. An appropriate threshold should be set and the input used for synchronizing the shutter should not be used in the trigger mask.
+
+Figure \ref{fig:shutter_timing} illustrates the timing of the shutter. Behaviour of the shutter is controlled by the IPBus registers described in table \ref{tab:shutter_registers}.
+
+\begin{table}
+	\begin{tabular}{lp{\0.6\linewidth}}
+	Register Name & Function \\ \hline
+	ControlRW & Bit-0 controls if shutter pulses are active. 1 = active. Bit-1 selects external synchronization (bit-1 = 0) or internal sequence (bit-1 = 1) \\
+	ShutterSelectRW & Selects which input is used to trigger shutter sequence.range = 0-5)\\
+	InternalShutterPeriodRW & Internal sequence period (when using internal sequence). Units of clock cycles.\\
+	ShutterOnTimeRW & Time between start of sequence and shutter asserted( t1) \\
+	ShutterVetoOffTimeRW & time between start of sequence and veto being de-asserted (t2)\\
+	ShutterOffTimeRW &  Time between start of sequence and time at which shutter de-asserted and veto reasserted (t3) \\
+	
+	\end{tabular}
+	\caption{IPBus registers controlling behaviour of shutter.}
+	\label{tab:shutter_registers}
+\end{table}
+
+
+\begin{figure}
+  \centering
+  \includegraphics[width=.95\textwidth]{./Images/aida-tlu-sitra-shutter-timing_02.pdf}
+  \caption{Shutter Timing}
+  \label{fig:shutter_timing}
+\end{figure}