Classification
Revision
Public
PA6
Document Number
Date
17-1957
2018-06-07
<Path to installation directory>/Matlab
to MATLAB’s internal path variable.
Important
MATLAB must be given knowledge of where the MEX file is located. This can be accomplished by
manually adding the path to the Teledyne SP Devices MATLAB directory or by using the helper script
get_adq_installer_path.m
6
Troubleshooting
This section aims to provide some guidance when troubleshooting unexpected behavior. It is recom-
mended that the user application is written in a robust manner, able to capture and report error co-
des from failed ADQAPI function calls. In the event of a function call failure, reading the ADQAPI
trace log for additional information is a useful first step. Trace logging must be activated by calling
ADQControlUnit_EnableErrorTrace()
with the
trace_level
argument set to 3.
If the error message is difficult to interpret, the Teledyne SP Devices support can be reached via e-
mail at
. Please include information about your use case such as the
WFA settings as well as the specification for both the trigger and data signals. Make sure to include a
trace log file from a run where the error appears.
6.1
Managing License Files
ADQ7-FWATD requires a valid license to be able to operate properly. An unsuccessful license vali-
dation will result a trace log error message and failure of the ADQAPI functions
ATDStartWFA()
and
ATDSetupWFA()
. The digitizer licenses are managed with the ADQLicenseUtil tool, included in the SDK.
Please direct all license related questions at
.
6.1.1
Reading the DNA
Licenses are locked to each individual digitizer by means of the
DNA
, a unique 128-bit number. Perfor-
ming field updates to the digitizer licenses may require the DNA and digitizer serial number to be read out
and forwarded to Teledyne SP Devices. This task can be accomplished by opening a command prompt
or terminal window with access to the ADQLicenseUtil application and running
$ adqlicenseutil d
Make a note of the digitizer serial number and DNA in the resulting 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.
ADQ7-FWATD User Guide
www.teledyne-spdevices.com
Page 21 of 26
