background image

Classification

Revision

Public

PA1

Document ID

Print date

18-2074

2018-04-06

4.10

Padding

The data padding functionality is used to keep a constant data rate from the digitizer. The padding is

active in the data collection modes

pulse metadata

and

raw pulse data with padding

.

The padding block will append zeros to the data to ensure that the total amount of data measured

over one padding frame is at least equal to the

minimum frame length

. Setting the minimum frame length

to zero disables the padding.

Note

The padding functionality is disabled by setting the minimum record length to zero.

The padding is applied to each

padding frame

after a certain offset. The padding offset is equal to

the detection window length in pulse metadata mode. The padding is configured using the API call

PDSetupCharacterization()

. How the padding frame is set up depends on the data collection mode,

see Table

5

.

For pulse metadata mode the padding data is appended to the data record, whereas for the raw pulse

data with padding mode a new record is generated with the padding data.

4.11

User Space Record

User space records are the records of data received by the user. A record consists of a data 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

the metadata mode, the record will consist of the data sampled by the ADC. In the metadata mode, the

record will consist of the pulse metadata packets.

The raw data records can either have a

fixed length

or a

variable length

. Fig.

6

illustrates the dif-

ferences between the two record types. The length of a metadata record will depend of the number of

pulses detected.

4.11.1

Fixed Length Record

A fixed length record is defined by the trigger event and the record length. The length of a fixed length

record is specified by the user, and is independent of the data collected. A fixed length record can be

triggered by any of the trigger sources.

4.11.2

Variable Length Record

The length of a variable length record will depend on the data. A variable length record is defined as the

data between the trigger event and reset event. If trailing or leading edge windows are used, these will

also be included in the record.

If two pulses have overlapping trailing and leading edge windows, they will be concatenated into one

single record. This is illustrated in Fig.

6

The variable length mode can only be used with the level

trigger.

ADQ14-FWPD – User Guide

www.teledyne-spdevices.com

Page 19 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: