tkds30xx.sub

泰克3000示波器波形采集程序CVI,环境LABWINDOWS CVI

 "If enabled, the instrument driver validates the parameter values that you "
 "pass to driver functions.  Range checking parameters is very useful for "
 "debugging.  After you validate your program, you can set this attribute to "
 "VI_FALSE to disable range checking and maximize performance.\n"
 "    The default value is VI_TRUE.   Use the "
 "tkds30xx_InitWithOptions function to override this value.\n"
 "    "

3 all "Query Instrument Status" TKDS30XX_ATTR_QUERY_INSTRUMENT_STATUS ViBoolean gs Boolean_values 
 "Specifies whether the instrument driver queries the instrument status "
 "after each operation.  Querying the instrument status is very useful for "
 "debugging.  After you validate your program, you can set this attribute to "
 "VI_FALSE to disable status checking and maximize performance\n"
 "    The instrument driver can choose to ignore status checking for "
 "particular attributes regardless of the setting of this attribute.\n"
 "    The default value is VI_TRUE.   Use the "
 "tkds30xx_InitWithOptions function to override this value.\n"
 "    "

3 all "Cache" TKDS30XX_ATTR_CACHE ViBoolean gs Boolean_values 
 "Specifies whether to cache the value of attributes.  When caching is "
 "enabled, the instrument driver keeps track of the current instrument "
 "settings and avoids sending redundant commands to the instrument.  Thus, "
 "you can significantly increase execution speed.\n"
 "    The instrument driver can choose always to cache or never to cache "
 "particular attributes regardless of the setting of this attribute.\n"
 "    The default value is VI_TRUE.   Use the "
 "tkds30xx_InitWithOptions function to override this value.\n"
 "    "

3 all "Simulate" TKDS30XX_ATTR_SIMULATE ViBoolean gs Boolean_values 
 "Specifies whether or not to simulate instrument driver I/O operations.  If "
 "simulation is enabled, instrument driver functions perform range checking "
 "and call Ivi_GetAttribute and Ivi_SetAttribute functions, but they do not "
 "perform instrument I/O.  For output parameters that represent instrument "
 "data, the instrument driver functions return calculated values.\n"
 "    The default value is VI_FALSE.   Use the "
 "tkds30xx_InitWithOptions function to override this value.\n"
 "    "

3 all "Record Value Coercions" TKDS30XX_ATTR_RECORD_COERCIONS ViBoolean gs Boolean_values 
 "Specifies whether the IVI engine keeps a list of the value coercions it "
 "makes for ViInt32 and ViReal64 attributes.  You call "
 "tkds30xx_GetNextCoercionRecord to extract and delete the oldest "
 "coercion record from the list.\n"
 "    The default value is VI_FALSE.   Use the "
 "tkds30xx_InitWithOptions function to override this value.\n"
 "    "

3 all "Interchange Check" TKDS30XX_ATTR_INTERCHANGE_CHECK ViBoolean gs Boolean_values 
 "Specifies whether to perform interchangeability checking and retrieve "
 "interchangeability warnings when you call "
 "tkds30xx_InitiateAcquisition, tkds30xx_ReadWaveform, tkds30xx_ReadMinMaxWaveform "
 "and tkds30xx_ReadWaveformMeasurement functions. \n\n"
 "The default value is VI_FALSE.\n\n"
 "Interchangeability warnings indicate that using your application with a "
 "different instrument might cause different behavior.  "
 "You call tkds30xx_GetNextInterchangeWarning to extract interchange warnings.  "
 "Call the tkds30xx_ClearInterchangeWarnings function to clear the list "
 "of interchangeability warnings without reading them.\n\n"
 "Interchangeability checking examines the attributes in a "
 "capability group only if you specify a value for at least one "
 "attribute within that group.  Interchangeability warnings can "
 "occur when an attribute affects the behavior of the instrument and you "
 "have not set that attribute, or the attribute has been invalidated since you set it.\n"
 "    "

2 all "Instrument Information" 
 "Attributes that provide information about this instrument driver and the "
 "physical resource it is using.\n"
 "    "

3 all "Number of Channels" TKDS30XX_ATTR_CHANNEL_COUNT ViInt32 g 
 "Indicates the number of channels that the specific instrument driver "
 "supports.  \n"
 "    For each attribute for which the IVI_VAL_MULTI_CHANNEL flag attribute "
 "is set, the IVI engine maintains a separate cache value for each channel.\n"
 "    "

3 all "Specific Driver Prefix" TKDS30XX_ATTR_SPECIFIC_DRIVER_PREFIX ViString g 
 "The prefix for the specific instrument driver.  The name of each "
 "user-callable function in this driver starts with this prefix.\n"
 "    The prefix can be up to a maximum of eight characters.\n"
 "    "

3 all "Instrument Manufacturer" TKDS30XX_ATTR_INSTRUMENT_MANUFACTURER ViString g 
 "A string that contains the name of the instrument manufacturer.    "

3 all "Instrument model" TKDS30XX_ATTR_INSTRUMENT_MODEL ViString g 
 "A string that contains the model code of the connected instrument.     "

3 all "Instrument Firmware Revision" TKDS30XX_ATTR_INSTRUMENT_FIRMWARE_REVISION ViString g 
 "A string that contains the firmware revision of the connected instrument.  "
 "    "

2 all "Driver Information" 
 "Attributes for obtaining information about the instrument driver.\n"
 "    "

3 all "Specific Driver Prefix" TKDS30XX_ATTR_SPECIFIC_DRIVER_PREFIX ViString g 
 "The prefix for the instrument driver.  The name of each user-callable "
 "function in this driver starts with this prefix.\n"
 "    "

3 all "Specific Driver Revision" TKDS30XX_ATTR_SPECIFIC_DRIVER_REVISION ViString g 
 "A string that contains additional version information about this "
 "instrument driver.\n"
 "    "

3 all "Supported Instrument Models" TKDS30XX_ATTR_SUPPORTED_INSTRUMENT_MODELS ViString g 
 "Contains a model code of the instrument. For family drivers, this "
 "attribute contains a comma-separated list of supported instrument models.  "
 "   "

3 all "Specific Driver Vendor" TKDS30XX_ATTR_SPECIFIC_DRIVER_VENDOR ViString g 
 "The developer of this instrument driver.    "

3 all "Specific Driver Description" TKDS30XX_ATTR_SPECIFIC_DRIVER_DESCRIPTION ViString g 
 "Additional information about this instrument driver.    "

3 all "Specific Driver Class Specification Major Version" TKDS30XX_ATTR_SPECIFIC_DRIVER_CLASS_SPEC_MAJOR_VERSION ViInt32 g 
 "The major version of the class specification that this driver complies to. "
 "   "

3 all "Specific Driver Class Specification Minor Version" TKDS30XX_ATTR_SPECIFIC_DRIVER_CLASS_SPEC_MINOR_VERSION ViInt32 g 
 "The minor version of the class specification that this driver complies to. "
 "   "

2 all "Advanced Session Information" 
 "Attributes that the specific driver can use to perform instrument I/O.     "
 " "

3 all "Logical Name" TKDS30XX_ATTR_LOGICAL_NAME ViString g 
 "You may pass a logical name to the tkds30xx_init or "
 "tkds30xx_InitWithOptions functions.  The IVI configuration file "
 "must contain an entry for the logical name.  The logical name entry refers "
 "to a virtual instrument section in the configuration file.  The virtual "
 "instrument section specifies a physical device and initial user options.  "
 "This attribute indicates the logical name you specified when opening the "
 "current IVI session.\n"
 "    "

3 all "Resource Descriptor" TKDS30XX_ATTR_IO_RESOURCE_DESCRIPTOR ViString g 
 "Indicates the resource descriptor the driver uses to identify the physical "
 "device.\n"
 "If you initialized the driver with the logical name, this attribute "
 "contains the resource descriptor that corresponds to the entry in the IVI "
 "configuration.  \n"
 "If you initialized the instrument driver with the resource descriptor, "
 "this attribute contains that value.    "

2 all "Driver Capabilities" 
 "Attributes that provide information about the capabilities of this "
 "instrument driver.\n"
 "    "

3 all "Class Group Capabilities" TKDS30XX_ATTR_GROUP_CAPABILITIES ViString g 
 "A string that contains a comma-separated list of class-extention groups "
 "that this driver implements.\n"
 "    "
 
3 all "Driver Setup" TKDS30XX_ATTR_DRIVER_SETUP ViString  g
 "This attribute indicates the Driver Setup string that the user "
 "specified when initializing the driver.\n\n"
 "Some cases exist where the end-user must specify instrument driver "
 "options at initialization time.  An example of this is specifying "
 "a particular instrument model from among a family of instruments "
 "that the driver supports.  This is useful when using simulation.  "
 "The end-user can specify driver-specific options through "
 "the DriverSetup keyword in the optionsString parameter to the "
 "tkds30xx_InitWithOptions function, or through the IVI Configuration Utility.\n\n" 
 "If the user does not specify a Driver Setup string, this attribute returns an empty string.\n"
 "    "

1 all "Acquisition" 
 "Attributes configure various acquisition modes"

2 all "Acquisition Type" TKDS30XX_ATTR_ACQUISITION_TYPE ViInt32 gs attrAcquisitionTypeRangeTable 
 "Specifies how the oscilloscope acquires data and fills the waveform "
 "record.  When you set this attribute to TKDS30XX_VAL_ENVELOPE or "
 "TKDS30XX_VAL_PEAK_DETECT, the oscilloscope acquires minimum and maximum "
 "waveforms.  To retrieve the minimum and maximum waveforms, use the "
 "tkds30xx_ReadMinMaxWaveform and tkds30xx_FetchMinMaxWaveform functions.\n"

2 all "Initiate Continuous" TKDS30XX_ATTR_INITIATE_CONTINUOUS ViBoolean gs Boolean_values 
 "Specifies whether the oscilloscope continuously initiates waveform "
 "acquisition.  If you set this attribute to VI_TRUE, the oscilloscope "
 "immediately waits for another trigger after the previous waveform "
 "acquisition is complete.\n"
 "    "

2 all "Number Of Averages" TKDS30XX_ATTR_NUM_AVERAGES ViInt32 gs 
 "Specifies the number of waveforms the oscilloscope acquires and averages.  "
 "After the oscilloscope acquires this many waveforms, it returns to the "
 "idle state.  This attribute affects instrument behavior only when the "
 "TKDS30XX_ATTR_ACQUISITION_TYPE attribute is set to TKDS30XX_VAL_AVERAGE.\n"
 "        \n"
 "Valid Range: 2 to 512\n"
 "\n"
 "Resolution: power of two\n"

2 all "Number Of Envelopes" TKDS30XX_ATTR_NUM_ENVELOPES ViInt32 gs 
 "Specifies the number of waveforms the oscilloscope acquires and analyzes "
 "to create the minimum and maximum waveforms.  After each waveform "
 "acquisition, the oscilloscope keeps the minimum and maximum values it "
 "finds for each point in the waveform record.  After the oscilloscope "
 "acquires the waveforms, it returns to the idle state.  This attribute "
 "affects instrument behavior only when the TKDS30XX_ATTR_ACQUISITION_TYPE "
 "attribute is set to TKDS30XX_VAL_ENVELOPE.\n"
 "\n"
 "Valid Range: 2 to 512 or TKDS30XX_VAL_INFINITE (0) TKDS30XX_VAL_INFINITE "
 "specifies continuous enveloping.\n"
 "\n"
 "Resolution: power of two\n"

2 all "Horizontal Minimum Number Of Points" TKDS30XX_ATTR_HORZ_MIN_NUM_PTS ViInt32 gs 
 "Specifies the minimum number of points you require in the waveform record "
 "for each channel.  This instrument driver uses the value you specify to "
 "configure the record length that the oscilloscope uses for waveform "
 "acquisition.  Use the TKDS30XX_ATTR_HORZ_RECORD_LENGTH attribute to obtain "
 "the actual record length."

2 all "Horizontal Record Length" TKDS30XX_ATTR_HORZ_RECORD_LENGTH ViInt32 g 
 "Returns the actual number of points the oscilloscope acquires for each "
 "channel.  The value is equal to or greater than the minimum number of "
 "points you specify with the TKDS30XX_ATTR_HORZ_MIN_NUM_PTS attribute.  "
 "Allocate a ViReal64 array of this size or greater to pass as the Waveform "
 "Array parameter of the tkds30xx_ReadWaveform and tkds30xx_FetchWaveform "
 "functions."

2 all "Horizontal Time Per Record" TKDS30XX_ATTR_HORZ_TIME_PER_RECORD ViReal64 gs 
 "This attribute specifies the time in seconds that corresponds to the "
 "record length.\n"
 "\n"
 "Units:  Seconds\n"
 "\n"
 "Valid Range depends on instrument model:\n"
 " TDS 3012 (3014): 40.0 ns to 100.0 s\n"
 " TDS 3032 (3034): 20.0 ns to 100.0 s\n"
 " TDS 3052 (3054): 10.0 ns to 100.0 s\n"
 "\n"
 "Default Value: 4.0e-3 s\n"
 "\n"
 "Resolution: All values are coerced in a 1_2_4 sequence.\n"

2 all "Acquisition Start Time" TKDS30XX_ATTR_ACQUISITION_START_TIME ViReal64 gs 
 "Specifies the length of time from the trigger event to the first point in "
 "the waveform record. If the value is positive, the first point in the "
 "wavefrom record occurs after the trigger event. If the value is negative, "
 "the first point in the waveform record occurs before the trigger event.  "
 "The units are seconds. \n"
 "    "

2 all "Horizontal Sample Rate" TKDS30XX_ATTR_HORZ_SAMPLE_RATE ViReal64 g 
 "Returns the effective digitizing rate using the current configuration.  "
 "The units are samples per second. This is instrument model dependend "
 "attribute.\n"

2 all "Sample Mode" TKDS30XX_ATTR_SAMPLE_MODE ViInt32 g 
 "Returns the sample mode the oscilloscope is currently using.\n"
 "\n"
 "  "

1 all "Channel" 
 "Channel-based attributes that you use to configure the channel subsystem.\n"
 "  "

2 all "Channel Enabled" TKDS30XX_ATTR_CHANNEL_ENABLED ViBoolean gs Boolean_values 
 "This channel-based attribute applies to all channels CH1, CH2, (CH3, CH4), "
 "MATH, REF1-REF4."

2 all "Probe Attenuation" TKDS30XX_ATTR_PROBE_ATTENUATION ViReal64 gs attrProbeAttenuationRangeTable 
 "This channel-based attribute applies only to input channels CH1, CH2, "
 "(CH3, CH4).\n"
 "    It specifies the scaling factor by which the probe you attach to the "
 "channel attenuates the input.  For example, when you use a 10:1 probe, set "
 "this attribute to 10.0.\n"
 "    This driver reserves negative values to control the oscilloscope's "
 "automatic probe sense capability.  Setting this attribute to "
 "TKDS30XX_VAL_PROBE_SENSE_ON configures the oscilloscope to sense the "
 "attenuation of the probe automatically.  After you enable the automatic "
 "probe sense, subsequent queries of this attribute return the value "
 "TKDS30XX_VAL_PROBE_SENSE_ON.  Use the TKDS30XX_ATTR_PROBE_SENSE_VALUE "
 "attribute to obtain the actual probe attenuation.\n"
 "    If you set the oscilloscope to sense the probe attenuation "
 "automatically, the probe attenuation value can change at any time.  When "
 "the oscilloscope detects a new probe attenuation value, other settings in "
 "the oscilloscope might also change.  The driver has no way of knowing when "
 "these changes occur.  Therefore, when you enable the automatic probe sense "
 "capability, this driver disables caching for attributes that depend on the "
 "probe attenuation.  These attributes include TKDS30XX_ATTR_VERTICAL_RANGE, "
 "TKDS30XX_ATTR_VERTICAL_OFFSET, and all the attributes that configure "
 "trigger levels.  To maximize performance, set this attribute to a manual "
 "probe attenuation setting.\n"
 "    If the oscilloscope is set to sense the probe attenuation "
 "automatically, setting this attribute to a positive value disables the "
 "automatic probe sense and configures the oscilloscope to use the manual "
 "probe attenuation you specify.\n"
 "    If you use a manual probe attenuation, you must set this attribute to "
 "reflect the new probe attenuation each time you attach a different probe."

2 all "Probe Sense Value" TKDS30XX_ATTR_PROBE_SENSE_VALUE ViReal64 g 
 "This channel-based attribute is valid only for input channels CH1, CH2, "
 "(CH3, CH4).  It returns the probe attenuation value the oscilloscope "
 "automatically senses.\n"

2 all "Vertical Range" TKDS30XX_ATTR_VERTICAL_RANGE ViReal64 gs 
 "This channel-based attribute is valid only for input channels CH1, CH2, "
 "(CH3, CH4).  It specifies the absolute value of the input range the "
 "oscilloscope can acquire for the channel.  The units are volts.  For "
 "example, to acquire a sine wave that spans between 0.0 and 10.0 volts, you "
 "set this attribute to 10.0 volts.\n"
 "\n"
 "Valid Range:  The probe attenuation determines the valid range for this "
 "attribute  as follows:\n"
 " \n"
 "(80.0e-3 * Probe_Attenuation) to  (80.0 * Probe_Attenuation) volts \n"
 "\n"
 "Resolution: This attribute is coerced to a 1-2-5 step.\n"

2 all "Vertical Offset" TKDS30XX_ATTR_VERTICAL_OFFSET ViReal64 gs 
 "This channel-based attribute is valid only for the input channels CH1, "
 "CH2, (CH3, CH4). It specifies the location of the center of the range that "
 "you specify with the TKDS30XX_ATTR_VERTICAL_RANGE attribute.  Express the "
 "value in volts relative to ground.  For example, to acquire a sine wave "
 "that spans between 0.0 and 10.0 volts, set this attribute to 5.0 volts.\n"
 "    \n"
 "Range and Resolution:\n"
 "\n"
 "Vertical_Scale = (Vertical_Range / 10.0) / Probe_Attenuation\n"
 "\n"
 "When (1e-3 <= Vertical_Scale <= 9.95e-3): \n"
 "  Valid Range = -0.1 to 0.1\n"
 "  Resolution = 1.0e-5\n"
 "\n"
 "When (9.95e-3 <= Vertical_Scale <= 99.5e-3): \n"
 "  Valid Range = -1.0 to 1.0\n"
 "  Resolution = 1.0e-4\n"
 "\n"
 "When (99.5e-3 <= Vertical_Scale <= 995.0e-3): \n"
 "  Valid Range = -10.0 to 10.0\n"
 "  Resolution = 1.0e-3\n"
 "\n"
 "When (995.0e-3 <= Vertical_Scale <= 10.0): \n"
 "  Valid Range = -100.0 to 100.0\n"
 "  Resolution = 1.0e-2\n"

2 all "Vertical Coupling" TKDS30XX_ATTR_VERTICAL_COUPLING ViInt32 gs attrVerticalCouplingRangeTable 
 "This channel-based attribute is valid only for the input channels CH1, "
 "CH2, (CH3, CH4).\n"
 "    It specifies how the oscilloscope couples the input signal for the "
 "channel.\n"
 "    "

2 all "Max Input Frequency" TKDS30XX_ATTR_MAX_INPUT_FREQUENCY ViReal64 gs 
 "This channel-based attribute specifies the maximum input frequency of the "
 "channel.  Express this value as the frequency at which the input circuitry "
 "attenuates the input signal by 3 dB.  The units for this attribute are "
 "hertz.\n"
 "\n"
 "Units:  Hertz\n"
 "\n"
 "Valid Values depends on instrument model:\n"
 " TDS 3012 (3014): 20e6, 100e6\n"
 " TDS 3032 (3034): 20e6, 150e6, 300e6\n"
 " TDS 3052 (3054): 20e6, 150e6, 500e6\n"
 "\n"
 "Default value: 20e6\n"
 "\n"
 "Resolution: All values are coerced to Valid Values.\n"

2 all "Input Impedance" TKDS30XX_ATTR_INPUT_IMPEDANCE ViReal64 gs attrChannelImpedanceRangeTable 
 "This channel-based attribute is valid only for the input channels CH1, "
 "CH2, (CH3, CH4).  It specifies the input impedance for the channel.  The "
 "units are ohms.\n"
 "    "

1 all "Triggering" 
 "Attributes that control how the oscilloscope triggers.  When you call "
 "tkds30xx_ReadWaveform, tkds30xx_ReadWaveformMeasurement, "
 "tkds30xx_ReadMinMaxWaveform, or tkds30xx_InitiateAcquisition, the "
 "oscilloscope waits for a trigger.  You specify the type of trigger for "
 "which the oscilloscope waits with the TKDS30XX_ATTR_TRIGGER_TYPE "
 "attribute.  You specify the source the oscilloscope monitors for the "
 "trigger with the TKDS30XX_ATTR_TRIGGER_SOURCE attribute.  After the "
 "oscilloscope receives the trigger, the oscilloscope waits the length of "
 "time you specify with the TKDS30XX_ATTR_ACQUISITION_START_TIME attribute.  "
 "The event that occurs when the trigger delay elapses is the Reference "
 "Event.  \n"
 "If the oscilloscope requires multiple waveform acquisitions to build a "
 "complete waveform, it waits for the length of time you specify with the "
 "TKDS30XX_ATTR_TRIGGER_HOLDOFF attribute to elapse since the previous "
 "trigger.  The oscilloscope then waits for the next trigger.  Once the "
 "oscilloscope acquires a complete waveform, it returns to the idle state.\n"
 "    "

2 all "Trigger Type" TKDS30XX_ATTR_TRIGGER_TYPE ViInt32 gs attrTriggerTypeRangeTable 
 "This attribute specifies the trigger type."

2 all "Trigger Source" TKDS30XX_ATTR_TRIGGER_SOURCE ViString gs 
 "Specifies the source the oscilloscope monitors for a trigger.  Set this "
 "attribute to a channel name or to one of the values below.\n"
 "    \n"
 "Valid Channel Names: \n"
 "For four channel models:\n"
 "- TKDS30XX_VAL_CH_1 ("
 "\"CH1\") - Channel 1\n"
 "- TKDS30XX_VAL_CH_2 ("
 "\"CH2\") - Channel 2\n"
 "- TKDS30XX_VAL_CH_3 ("
 "\"CH3\") - Channel 3\n"
 "- TKDS30XX_VAL_CH_4 ("
 "\"CH4\") - Channel 4\n"
 "\n"
 "For two channel models:\n"
 "- TKDS30XX_VAL_CH_1 ("
 "\"CH1\") - Channel 1\n"
 "- TKDS30XX_VAL_CH_2 ("
 "\"CH2\") - Channel 2\n"
 "- TKDS30XX_VAL_EXTERNAL ("
 "\"EXT\") or TKDS30XX_VAL_EXTERNAL_10 ("
 "\"EXT10\")\n"
 "\n"

2 all "Trigger Level" TKDS30XX_ATTR_TRIGGER_LEVEL ViReal64 gs 
 "Specifies the voltage threshold for the trigger subsystem.  The units are "
 "volts.  This attribute affects instrument behavior only when you set the "
 "T