User manual

Parameter String Returned
Type
Description
"OverloadStatus chan"
ViInt32
Returns 1 if chan is in overload, 0 otherwise.
chan takes on the same values as 'channel' in
AcqrsD1_configTrigSource.
"OverloadStatus ALL"
ViInt32 Returns 1 if any of the signal or external trigger inputs is in
overload, 0 otherwise.
Use the "OverloadStatus chan " string to determine which
channel is in overload.
"PosInCrate"
ViInt32 Physical slot number (position) in cPCI crate
"SSRTimeStamp"
ViReal64 Current value of time stamp for Analyzers in SSR mode.
"TbSegmentPad"
ViInt32 Returns the additional array space (in samples) per segment
needed for the image read of
AcqrsD1_readData. It
concerns the current data available, as opposed to any
future acquisition with different conditions.
"Temperature m"
ViInt32 Temperature in degrees Centigrade (
o
C)
"TrigLevelRange chan"
ViReal64
Trigger Level Range on channel chan
“VersionUserDriver”
ViChar[ ] String containing the full driver version.
Discussion
For the case "TrigLevelRange chan" the result is to be interpreted as
± (returned value), which is in % of the vertical Full Scale of the channel, or in mV for an external trigger
source. The value of chan takes is the same as the values of 'channel' in
AcqrsD1_configTrigSource.
For the case "Temperature m", m is the module number in a MultiInstrument and runs from 0 to (nbr of
modules –1) following the channel order. It may be omitted on single digitizers or for the master of a
MultiInstrument
For the case "Options" the available options are returned in a ‘,’ separated string. The options include the
memory size if additional memory has been installed in the form "MnM" for digitizers where n is the
number of megabytes available or "PnMB" for AP235/AP240 and "AnM" for AP100/AP101/AP200/AP201.
Other possible options include "NoASBus", "BtBkup", "FreqCntr", "SSR", "Avg", and "StrtOnTrig". The
infoValue should point to a string of at least 32 characters.
The case of "LOGDEVHDRBLOCKmDEVnS string" is one in which several possible values of m, n, and
string are allowed. The single digit number m refers to the FPGA block in the module. For the moment this
must always have the value 1. The single digit number n refers to the FPGA device in the block. It can have
values in the range 1,2,3,4 depending on the module. Among the interesting values of string are the
following case-sensitive strings: "name", "version", "versionTxt", "compDate", "model".
The case of "SSRTimeStamp" should only be used when data is readable. In other words, it should only be
used between the moment at which the processing is done and the moment when AcqrsD1_processData is
called to enable the subsequent bank switch.
Examples
double trigLevelRange;
AcqrsD1_getInstrumentInfo(ID, "TrigLevelRange -1", &trigLevelRange);
The acceptable trigger levels are in the range [-trigLevelRange, +trigLevelRange] mV (external trigger!).
For modules supporting switch on overload protection:
long overLoad;
AcqrsD1_getInstrumentInfo(ID, "OverLoadStatus ALL", &overLoad);
if (overLoad)
DO SOMETHING
In order to find out which channel(s) caused the overload, you have to loop over "OverLoadStatus -1",
"OverLoadStatus 1", "OverLoadStatus 2",...
Programmer’s Reference Manual Page 126 of 210