Wiki source code of Trigger Howto

Version 19.1 by sndueste on 2020/01/23 09:29
Hide last authors
sendels 1.1 1
2
sndueste 6.1 3 {{toc/}}
sendels 1.1 4
sndueste 10.1 5 = Introduction (user panel)
6 =
sendels 1.1 7
sndueste 19.1 8 The MTCA based triggers have a jitter in the few ps range, the delay can be shifted in 9 ns steps, One can choose between 10 Hz triggers, Triggers connected to the (fast) FEL shutters,  frequencies locked to the pulses (e.g. 1MHz) and the actual bunch patterns. A detailed description can be found in [[x2Timer manual>>attach:x2Timer.pdf]] ([[Design Paper>>url:http://ttfinfo2.desy.de/doocs/Timing/CDRv2.2short.pdf||shape="rect"]]).
sendels 1.1 9
sndueste 19.1 10 In short:
sendels 1.1 11
sndueste 19.1 12 * the triggers are for low impedance (~~50 Ohm )
13 * signal level is + 5V - otherwise 0V (in the expert panel one can also invert the signal - base line is +5 V and trigger 0V)
14 * The trigger are send to the MTCA several ms before the first FEL pulse (3.1 ms for the "standard" trigger, 23 ms for the "early" trigger).
15 * The timer card can delay the trigger in 9 ns  steps for more than 100 ms (an option to shift the trigger in 1 ns steps is available in the expert panel)
16 * The shown delay in µs is in respect to the //first// FEL pulse. negative delay: trigger comes before FEL, positive : trigger comes after the FEL.
17 * The desired delay has to be entered in the "delay to be set" field and as second step pressing the "set delay" sends the delay value to the timer card. Then the trigger delay will be changed and the "actual delay" will be updated.
18 * The trigger can be set to only provide a trigger signal if the FEL Fast shutter is open. One has to choose which FEL shutter to use.
19 * The trigger  width can be adjusted from 9 ns to several ms in 9 ns steps
20 * The timer card can in addition to the 10 Hz triggers also provide frequencies which are linked to the FEL repetition rate and the actual burst pattern of the FEL. For details how to set these modes see below
21 * At the beamlines the triggers are provided with a  BNC patch panel
sendels 1.1 22
sndueste 19.1 23 The main control can be done with a simplified user panel which can handle the timing in respect to the FEL pulses (and not in respect to some arbitrary event time)
24
25
sendels 1.1 26 \\
27
sndueste 19.1 28 \\
29
30 \\
31
32 \\
33
34 \\
35
36 \\
37
sndueste 10.1 38 = Different trigger events (starting points) =
sendels 1.1 39
sndueste 6.1 40 one can configure each channel for an individual trigger event
sendels 1.1 41
42 **FLASH1**
43
sendels 2.1 44 (% class="wrapped" %)
sendels 1.1 45 |(((
46 trigger No
47 )))|(((
48 function
49 )))
50 |(((
51 16
52 )))|(((
53 the MCA trigger 3.11 ms before the Flash1 pulses (same as A6 but more stable)
54 )))
55 |(((
56 166
57 )))|(((
58 A6 event. still possible to use but less precise than 16
59 )))
60 |(((
61 162
62 )))|(((
63 A2 event as earliest ( 24 ms before the FEL)
64 )))
65 |(((
66 224
67 )))|(((
68 E0 event of the BL fast shutter ( 19 ms before the FEL)
69 )))
70 |(((
71 225
72 )))|(((
73 E1 event of the PG fast shutter ( 19 ms before the FEL)
74 )))
75 |(((
76 21
77 )))|(((
78 Trig16 + first bunch of FLASH1 - this trigger is shifted when FL1 starts later than "700"
79 )))
80
81 \\
82
83 \\
84
85 **FLASH2**
86
sendels 2.1 87 (% class="wrapped" %)
sendels 1.1 88 |(((
89 trigger No
90 )))|(((
91 function
92 )))
93 |(((
94 22
95 )))|(((
96 Trig116 + first bunch of FLASH2 - this trigger is shifted when FL2 starts at a different start time
97 )))
98 |(((
99 181
100 )))|(((
sndueste 6.1 101 shifts with the start time of FLASH2 as event 22 but comes 22 ms ! before the FEL
sendels 1.1 102 )))
103
sndueste 5.1 104 from this trigger as starting point one can shift the timing in 9 ns steps first and finally in 0.9 ns steps for fine adjustment.
sendels 1.1 105
sndueste 6.1 106 \\
sendels 1.1 107
sndueste 19.1 108 \\
109
sndueste 6.1 110 = Expert panels =
sendels 1.1 111
112 \\
113
sndueste 6.1 114 [[image:attach:image2019-9-17_13-10-56.png||height="250"]] [[image:attach:image2019-9-17_13-8-46.png||height="400"]]
115
sndueste 7.1 116 With the **"Expert overview"** one gets the overview over all channels available on the timing card and can configure the card. This is useful to look what channels are using clock settings or burst mode settings that one wants to change ... and using the other tabs one can set parameters for clocks and bursts (see below)
sndueste 6.1 117
118 \\
119
sndueste 7.1 120 For each trigger channel there is in addition an **"Expert panel"** to set the properties of THIS channel
sndueste 6.1 121
122 [[image:attach:image2019-9-17_13-14-52.png||height="250"]] [[image:attach:image2019-9-17_13-15-38.png||width="550"]]
123
124 \\
125
126 \\
127
sndueste 10.1 128 = Set a constant frequency to a channel =
129
130 =
sndueste 6.1 131 [[image:attach:image2019-9-17_13-18-9.png||height="250"]][[image:attach:image2019-9-17_13-18-37.png||height="149"]] =
132
133 \\
134
sndueste 7.1 135 The timer card provides the option to generate  frequencies that are synched to the FEL reprate on the ps level. One can set 3 Clocks by deviding the reference frequency of 54.2 MHz by n.** Please check (using the Expert overview ) before changing a frequency of it is used for some other channel !!**
sndueste 6.1 136
137 Since our main FEL frequency is 100.31 MHz the dividers are not straight forward:
138
sndueste 10.1 139 [[image:attach:image2019-9-17_14-22-29.png||width="450" align="right"]]
140
141 \\
142
sndueste 7.1 143 (% class="wrapped" %)
sndueste 6.1 144 |=(((
145 Clock frequency
146 )))|=(((
sndueste 7.1 147 Divider to be set
sndueste 6.1 148 )))
149 |(((
150 "1 MHz" (1000.31 kHz)
151 )))|(((
152 53
153 )))
154 |(((
sndueste 7.1 155 "500 kHz" (501.5 kHz)
sndueste 6.1 156 )))|(((
sndueste 7.1 157 107
sndueste 6.1 158 )))
159 |(((
sndueste 7.1 160 "250 kHz" (250.8 kHz)
sndueste 6.1 161 )))|(((
sndueste 7.1 162 215
sndueste 6.1 163 )))
sndueste 7.1 164 |(% colspan="1" %)(((
165 "200 kHz" (200.6 kHz)
166 )))|(% colspan="1" %)(((
167 269
168 )))
169 |(% colspan="1" %)(((
170 "100 kHz" (100.3 kHz)
171 )))|(% colspan="1" %)(((
172 539
173 )))
sndueste 6.1 174
sndueste 10.1 175 \\
176
sndueste 15.1 177 == General FLASH frequencies: ==
178
sndueste 10.1 179 \\
180
sndueste 16.1 181 (% class="relative-table wrapped" style="width: 19.422%;" %)
sndueste 17.1 182 |(% class="highlight-grey" title="Hintergrundfarbe : Grau" data-highlight-colour="grey" %)(((
sndueste 18.1 183 (% style="color: rgb(0,0,0);" title="" %)**Name          
184 **
sndueste 17.1 185 )))|(% class="highlight-grey" title="Hintergrundfarbe : Grau" data-highlight-colour="grey" %)(((
sndueste 18.1 186 (% style="color: rgb(0,0,0);" title="" %)**Frequency                
187 **
sndueste 17.1 188 )))|(% class="highlight-grey" title="Hintergrundfarbe : Grau" data-highlight-colour="grey" %)(((
189 (% style="color: rgb(0,0,0);" title="" %)**Divider**
sndueste 15.1 190 )))
191 |(((
192 1.3 GHz
193 )))|(((
194 1300.000000 MHz
195 )))|(((
sndueste 10.1 196 \\
sndueste 15.1 197 )))
198 |(((
199 108 MHz
200 )))|(((
201 108.333333 MHz
202 )))|(((
203 12
204 )))
205 |(((
206 9 MHz
207 )))|(((
208 9.02777777 MHz
209 )))|(((
210 144
211 )))
212 |(((
213 4.5 MHz
214 )))|(((
215 4.513888 MHz
216 )))|(((
217 288
218 )))
219 |(((
220 1 MHz
221 )))|(((
222 1.003086 MHz
223 )))|(((
224 1296
225 )))
sndueste 10.1 226
227 \\
228
sndueste 7.1 229 Once a clock is configured with the right frequency one can choose in the "expert panel" of the according channel the "FPGA clock" in the "input source select"  chooser.
230
sndueste 10.1 231 One has to set the delay to values less than the repetition rate ... (so for 1 MHz between 0 and 990 µs)  and the trigger width also less than the rep rate ...
sndueste 8.1 232
sndueste 15.1 233 This results in a continuous train of pulses with the set trigger width.
sndueste 8.1 234
sndueste 10.1 235 = Creating an (own) burst trigger =
236
237 One can use now a SECOND trigger channel which is set to a regular 10 Hz trigger  and gate the clock output to create a burst with defined start point and length,
238
sndueste 11.1 239 For the example we use the FRONT.TRG2 (BL3 Trg5) as gate pulse which defines the length of the burst (set with the trigger width) and the (rough) starting point of the burst. This trigger is only used as gate and the physical trigger output is NOT used.
sndueste 10.1 240
sndueste 11.1 241 The  second channel (here FRONT.TRG3 (BL3 Trg6) which is set to the clock frequency defines the reprate (by the FPGA clock setting) , the exact starting point of the first trigger ( by the delay ) and the width of the  MHz/kHz triggers (width).
sndueste 10.1 242
sndueste 11.1 243 **To get from the clock to the burst trigger** one has to:
sndueste 10.1 244
sndueste 11.1 245 * set the  "2nd source select" to the gate trigger ( here FRONT.TRG2) - this defines a second source to considder for the trigger output.
246 * and the "output source select" to "AND 2nd Ch."  this finally only sends a trigger if on both inputs (clock and gate) we have a high signal.
247
sndueste 10.1 248 \\
249
sndueste 11.1 250 [[image:attach:image2019-9-17_14-35-5.png||height="250"]] [[image:attach:image2019-9-17_14-34-38.png||width="400"]]
251
sndueste 10.1 252 \\
253
254 \\
255
sndueste 11.1 256 = Real bunch trigger  - get a trigger for each FEL pulse =
257
sndueste 10.1 258 \\
259
sndueste 11.1 260 Sometimes it is convenient to get a trigger pulse for each pulse in the FEL. thus if the FEL number of bunches or reprate are changed, the trigger adapts accordingly.
sendels 1.1 261
sndueste 11.1 262 For this one has to select the source of interest in the expert overview panel (tab: "Bunch pattern") ... well for us this is FLASH1 (FL1D) or FLASH2 (FL2D)
sendels 1.1 263
sndueste 11.1 264 There are 6 different bunch pattern "channels" one can configure. Typically only 2 are needed ... And in each one there are 6 selectors to choose sources . We only need one - it does not matter in which one is used.
sendels 1.1 265
sndueste 12.1 266 [[~[~[image:attach:image2019-9-17_14-51-28.png~|~|height="250"~]~]>>attach:image2019-9-17_14-51-28.png]][[image:attach:image2019-9-17_14-47-15.png||thumbnail="true" height="199"]]
sndueste 8.1 267
268 \\
269
sndueste 11.1 270 In the expert panel one can now choose the configured "Bunch Pattern" as "Input source select"
sndueste 10.1 271
sndueste 11.1 272 **NOTE: To shift the burst in time one can no longer use the delay of the individual channel BUT the delay in the "Bunch pattern" tab in the expert overview! This now shifts all bursts ... so you better know what you are doing. typically the burst is already shifted to the actual FEL timing ... Shifting the timing should be discussed with the beamline scientist / local contact ...**
273
sndueste 10.1 274 \\
275
sndueste 13.1 276 [[image:attach:image2019-9-17_15-4-47.png||height="250"]][[image:attach:image2019-9-17_14-52-40.png||height="250"]]
sndueste 11.1 277
sndueste 10.1 278 \\
279
280 \\
281
282 \\
283
284 \\
285
286 \\
287
288 \\
289
290 \\
291
292 \\