background image

Classification

Revision

Public

PA1

Document ID

Print date

18-2074

2018-04-06

Detection 
window

Data

Padding
allowed

Record 1

Record 0

Record length

Record length

Trigger level

Record 1

Record 0

Trailing edge window

Trigger level

Reset level

Trigger event inside TEW,
record is extended

Trailing edge window

Variable length mode

Fixed length mode

Figure 6: Data collection mode 0 (raw pulse data).

Example

If the reduction factor is set to 5, every 5th record will be transferred to the host.

4.12.3

Pulse Metadata

In the pulse metadata mode, only the pulse metadata is transferred to the host. The individual metadata

fields are described in Section

4.8

and Fig.

7

presents how the mode acts on a stream of pulse data

with a detection window. The detection window trigger will generate a record which is populated with

metadata packets. If no pulses are detected during a detection window an empty metadata data packet

will be transferred to the host.

Table

6

describes the layout of the metadata packets. The byte column refers to the position in the

returned array. One record can consist of one or several metadata packets. The size of each metadata

packet is 8 bytes. Packets used for padding have all fields equal to zero and should be discarded.

Table

7

describes the format of the returned data for each record in pulse characterization mode.

Note

Invalid packets are identified by all fields being equal to zero.

The pulse metadata mode will pad the record with zero-filled metadata packets if the total amount of data

during one detection window is less than the specified the minimum frame length.

Table 6: The metadata packet structure.

Field

Byte

Size

Format

Pulse peak timestamp

3:0

4 bytes

32-bits unsigned integer

Pulse peak value

5:4

2 bytes

16-bits signed integer

Pulse width

7:6

2 bytes

16-bits unsigned integer

ADQ14-FWPD – User Guide

www.teledyne-spdevices.com

Page 21 of 28

Summary of Contents for ADQ14

Page 1: ...ADQ14 FWPD User Guide Author s Teledyne SP Devices Document ID 18 2074 Classification Public Revision PA1 Print date 2018 04 06...

Page 2: ...ws 10 4 3 2 Baseline Tracking 12 4 4 Trigger Features 12 4 4 1 Timestamp Reset 12 4 4 2 Trigger Blocking 13 4 4 3 Synchronization Signals 14 4 5 Coincidence 14 4 6 Detection Window 15 4 7 Data Multipl...

Page 3: ...Example 22 5 1 C Example 24 5 1 1 Python Scripts 24 5 2 Disk Streaming Example 24 5 3 Pulse Characterization GUI 25 6 Troubleshooting 25 6 1 Managing License Files 25 6 1 1 Reading the DNA 25 6 1 2 U...

Page 4: ...erface DBS Digital baseline stabilization FWPD Pulse detection firmware for ADQ14 GSPS 109 samples per second GUI Graphical user interface Horizontal parameters Used to describe parameters and setting...

Page 5: ...m bin value 1 048 575 1 See Section 4 8 1 2 See Section 4 8 3 2 2 Overview Fig 1 presents a block diagram outlining the main features of the data path The diagram is drawn for a four channel device bu...

Page 6: ...s a trigger condition and a specification of the horizontal parameters Trigger The trigger condition may be selected from one of the three global trigger sources external trigger internal trigger or s...

Page 7: ...ection 4 12 allows the user to reduce the output data rate further by choosing to only output the pulse metadata Histogram The pulse peak value and width are forwarded to two independent histograms wh...

Page 8: ...re quired tor successfully interface with the digitizer The installation procedure for Microsoft Windows and Linux is described in the following sections 3 1 1 Installing the SDK Windows For Microsof...

Page 9: ...ns it is advantageous if the baseline of the signal is locked to a specific value This is the purpose of the Digital Baseline Stabilizer DBS The signal processing block is placed directly after the AD...

Page 10: ...Equations 1 and 2 present the relations for positive and negative pulses respectively Positive pulses Reset level Trigger level Reset hysteresis Trigger arm level Trigger level Trigger arm hysteresis...

Page 11: ...s should be set at least in the same range as the noise to be effective as shown in Fig 2e For completeness the conditions to generate a trigger or reset event are stated in 3 and 4 for positive and n...

Page 12: ...s determined from the reset level and the reset arm hysteresis The level is used to arm the mechanism generating reset events d Badly configured arm levels may yield false events from the incorrectly...

Page 13: ...indow has been acquired 4 4 Trigger Features This section describes features relating to the external trigger interface blocking triggers generating synchronization signals to external equipment and r...

Page 14: ...nd DisarmTriggerBlocking The blocking function can be config ured in four modes Once Mode index 0 Once the trigger blocking engine is armed this mode inhibits the creation of records until the first e...

Page 15: ...The frame synchronization feature introduces an additional signal synchronized to the internal trigger which may be output on the synchronization connector SYNC This signal acts as a frame for the fre...

Page 16: ...channel B is 0b0101 and 600 samples The masks for channels C and D are the default values 0b0100 and 0b1000 and the window lengths are both 800 samples This configuration will only detect a pulse on c...

Page 17: ...r to output a single data stream on multiple channels and may be used to e g verify that the pulse metadata corresponds to the raw pulse data Each channel of the data multiplexer can be configured to...

Page 18: ...samples If the peak value is reached at multiple samples the timestamp value will report the last one Note The timestamp value will wrap after 232 1 samples 4 8 4 Overflow The pulse characterization...

Page 19: ...ting bin number would be 1000 from 5 Since this is less than 0 the underflow bin would be incremented by one TheAPI calls used to interface with the histograms are listed below Please refer to theADQA...

Page 20: ...part and a header part The header includes information about e g the length and the trigger timestamp The contents of the user space records will depend on the data collection mode In all modes but th...

Page 21: ...ord trigger Padding offset 0 N A trigger_mode N A 1 padding_trigger_mode1 padding_trigger_mode detection_window_length 2 N A trigger_mode N A 3 padding_trigger_mode1 trigger_mode detection_window_leng...

Page 22: ...es are detected during a detection window an empty metadata data packet will be transferred to the host Table 6 describes the layout of the metadata packets The byte column refers to the position in t...

Page 23: ...the two different modes The padding record timestamp and record number is undefined and should not be used Example If the minimum frame length is set to 1024 samples and only 800 samples of data are...

Page 24: ...Classification Revision Public PA1 Document ID Print date 18 2074 2018 04 06 Figure 7 Data collection mode 2 pulse metadata ADQ14 FWPD User Guide www teledyne spdevices com Page 23 of 28...

Page 25: ...sted at the top The example is verbose by design and is intended as reference for deigning custom applications The example will configure the device acquire all the data save the data to file if instr...

Page 26: ...e Tele dyne SP Devices support may be petitioned for the application source code at support teledyne spdevices com 6 Troubleshooting This section aims to provide some guidance when troubleshooting une...

Page 27: ...ulting output text 6 1 2 Updating the Digitizer License Provided a valid license file license lic the command adqlicenseutil w license lic transfers the license to the digitizer References 1 Teledyne...

Page 28: ...cument ID Print date 18 2074 2018 04 06 a Data collection mode 3 with detection window b Data collection mode 4 without detection window Figure 8 Raw pulse data with padding ADQ14 FWPD User Guide www...

Page 29: ...ikringen 6 SE 583 30 Link ping Sweden Phone 46 0 13 645 0600 Fax 46 0 13 991 3044 Email info teledyne spdevices com Copyright 2018 Teledyne Signal Processing Devices Sweden AB All rights reserved incl...

Reviews: