The most recent version of this page is a draft.

This version (09 May 2012 17:08) was approved by Jason Coutermarsh.

This is an old revision of the document!

LabVIEW 7

After the DPG Software Suite is installed, all the VIs required to communicate with a DPG are placed in the Instrument Drivers section of the Instrument I/O Palette.

The List Devices VI The primary file type use in LabVIEW returns a list of all the attached DPGs. All other DPG VIs will need this reference in order to communicate with the desired DPG.

Before a specific DPG can play data, it needs to be configured. This configuration determines the electrical characteristics of the physical interface between the DPG and the DUT. The List Available Configurations returns a list of all the configurations that the referenced DPG supports. The Configure Device can then be used to select which configuration to use.

After configuring, various parameters can be set via the Set Setup VI. The current setup can be read with the Get Setup VI.

To download the data vector into the DPG, use the Download Vectors VI. This is a polymorphic VI; it will display several different input data types. This VI will re-format various types of data into a data-type that the referenced DPG can use. Once the data is loaded, the Play, Pause, and Stop VIs can be used to control the data playback.

DPG Palette

This pallet contains the following VIs and sub-palettes:

List Devices

Utility Sub-Palette

	Get Setup
	Measure Data Clock Frequency
	Set Setup

Examples Sub-Palette

Example: Simple Sine Generator

Data Sub-Palette

	Download Vectors
	Play
	Pause
	Stop

Configure Sub-Palette

	Get Current Configuration
	List Available Configurations
	Configure Device

VI Reference

List Devices

This VI returns an array of Hardware References. Each of these references is the software representation of an actual DPG connected to your computer. All other VIs will take this reference as an input.

	error in (no error)
	Hardware Interface Reference Array out Contains an array of Hardware Interface References. Each item of the array represents one physical DPG Data Pattern Generator currently connected to this PC. Use this when one or more DPGs are connected. The order in which the devices appear in the array is non-deterministic. Adding or removing DPGs from your PC may alter the order. Do not rely on the order being the same from one execution to the next.
	First Hardware Interface Reference out Contains the first item in the above array. Using this output eliminates a small amount of external wiring in cases where only one DPG Data Pattern Generator will ever be connected to the PC.
	error out

Get Current Configuration

This VI retrieves the name of the configuration currently loaded into the DPG.

	Hardware Interface Reference A reference to the specific DPG you are using. These references can be obtained from the List Devices VI.
	error in (no error)
	Hardware Interface Reference out Contains the same information as the reference which is input at the Hardware Interface Reference port. This port allows for control over the order of execution, as this VI will not pass on its reference until it has completed all its tasks.
	Current Configuration The name of the configuration currently loaded into the DPG. Only valid when a standard configuration (not a custom configuration) was loaded into the DPG.
	Is Configured True when the DPG has a configuration loaded into it. False indicates the DPG has not yet been configured after a power-cycle.
	error out

List Available Configurations

This VI returns a list of all the standard configurations that the referenced DPG supports.

	Hardware Interface Reference A reference to the specific DPG you are using. These references can be obtained from the List Devices VI.
	error in (no error)
	Hardware Interface Reference out Contains the same information as the reference which is input at the Hardware Interface Reference port. This port allows for control over the order of execution, as this VI will not pass on its reference until it has completed all its tasks.
	Available Configurations An array of the names of all standard configurations available on the referenced DPG. This list may expand as new configurations are added to the DPG.
	error out

Configure Device

This VI configures the DPG for the type of interface your DUT expects.

	Hardware Interface Reference A reference to the specific DPG you are using. These references can be obtained from the List Devices VI.
	Configuration Name The name of the configuration you'd like to use. A list of all available configurations for the DPG you are connected to can be obtained from the List Available Configurations VI. A custom configuration file can be provided via the Custom Configuration Path input. Either the Configuration Name or Custom Configuration Path must be supplied.
	Custom Configuration Path A custom configuration file can be provided to allow for features not available in the standard configurations. If you have been provided a custom configuration file by Analog Devices, wire its path here. Either the Configuration Name or Custom Configuration path must be supplied.
	error in (no error)
	Hardware Interface Reference out Contains the same information as the reference which is input at the Hardware Interface Reference port. This port allows for control over the order of execution, as this VI will not pass on its reference until it has completed all its tasks.
	error out

Synchronization Mode

This VI reads and writes the Synchronization Mode settings. These settings are only used when a DPG is used in a multi-board environment. To read the current value, do not wire anything to the New Mode input.

	Hardware Interface Reference A reference to the specific DPG you are using. These references can be obtained from the List Devices VI.
	New Mode The new mode to set the board to. This can be set to “No Change” to keep the current mode.
	error in (no error
	Hardware Interface Reference out Contains the same information as the reference which is input at the Hardware Interface Reference port. This port allows for control over the order of execution, as this VI will not pass on its reference until it has completed all its tasks.
	Current Mode Returns the current Synchronization Mode of the referenced DPG.
	error out

Get Setup

This VI returns the current setup of the DPG. Setup includes information such as the Play Mode, Play Count, and Starting Address. It is only valid after a configuration has been loaded into the DPG.

	Hardware Interface Reference A reference to the specific DPG you are using. These references can be obtained from the List Devices VI.
	error in (no error)
	Hardware Interface Reference out Contains the same information as the reference which is input at the Hardware Interface Reference port. This port allows for control over the order of execution, as this VI will not pass on its reference until it has completed all its tasks.
	Play Mode In Loop mode, the data vector is continuously transmitted after the Play command is received by the DPG. In Count mode, the DPG will only loop a set number of times before stopping. The number of cycles is set by the Play Count value.
	Play Count When in Count Play Mode, this value determines how many times the data vector will be played before stopping. In Loop Play mode, this value has no effect.
	Start Address This value sets the starting address for the data playback. This determines at what point in the vector the DPG will begin playing at.
	error out

Set Setup

This VI changes various parameters on the DPG. This command is only valid after a configuration has been loaded into the DPG.

	Hardware Interface Reference A reference to the specific DPG you are using. These references can be obtained from the List Devices VI.
	Play Mode In Loop mode, the data vector is continuously transmitted after the Play command is received by the DPG. In Count mode, the DPG will only loop a set number of times before stopping. The number of cycles is set by the Play Count value.
	Start Address This value sets the starting address for the data playback. This determines at what point in the vector the DPG will begin playing at.
	error in (no error)
	Hardware Interface Reference out Contains the same information as the reference which is input at the Hardware Interface Reference port. This port allows for control over the order of execution, as this VI will not pass on its reference until it has completed all its tasks.
	error out

Download Vectors

This is a Polymorphic VI. Several different data types can be used to download data vectors into the DPG.

Unlike DPGDownloader, these VI's do not know what evaluation board is connected. Therefore, the data vector must be properly formatted for any particular evaluation board before it is sent down to the DPG.

One Vector of type I32

	Hardware Interface Reference A reference to the specific DPG you are using. These references can be obtained from the List Devices VI.
	Vector The data vector to be sent
	error in (no error)
	Hardware Interface Reference out Contains the same information as the reference which is input at the Hardware Interface Reference port. This port allows for control over the order of execution, as this VI will not pass on its reference until it has completed all its tasks.
	error out

Two Vectors of type I16

	Hardware Interface Reference A reference to the specific DPG you are using. These references can be obtained from the List Devices VI.
	I Vector The data vector to be sent to the I channel
	Q Vector The data vector to be sent to the Q channel
	error in (no error)
	Hardware Interface Reference out Contains the same information as the reference which is input at the Hardware Interface Reference port. This port allows for control over the order of execution, as this VI will not pass on its reference until it has completed all its tasks.
	error out

Two Vectors of type Double

	Hardware Interface Reference A reference to the specific DPG you are using. These references can be obtained from the List Devices VI.
	I Vector The data vector to be sent to the I channel. It will be internally converted to an integer of the appropriate width. No scaling will be performed.
	Q Vector The data vector to be sent to the Q channel. It will be internally converted to an integer of the appropriate width. No scaling will be performed.
	error in (no error)
	Hardware Interface Reference out Contains the same information as the reference which is input at the Hardware Interface Reference port. This port allows for control over the order of execution, as this VI will not pass on its reference until it has completed all its tasks.
	error out

Measure Data Clock Frequency

This VI returns the frequency (in Hz) of the Data Clock provided to the DPG by the evaluation board. If this value is 0, no data clock was detected.

	Hardware Interface Reference A reference to the specific DPG you are using. These references can be obtained from the List Devices VI.
	error in (no error)
	Hardware Interface Reference out Contains the same information as the reference which is input at the Hardware Interface Reference port. This port allows for control over the order of execution, as this VI will not pass on its reference until it has completed all its tasks.
	Measured Frequency (Hz) Returns the measured frequency of the Data Clock provided by the DUT.
	error out

Play

Starts playback of the data vector. If the DPG is currently stopped, or has not been started since being configured, playback will begin at Start Address. If the DPG is currently paused, playback will begin at the point that it was paused at.

Note: The Play VI will check for the presence of a Data Clock before starting playback. If a data clock isn't detected, an error will be thrown.

	Hardware Interface Reference A reference to the specific DPG you are using. These references can be obtained from the List Devices VI.
	error in (no error)
	Hardware Interface Reference out Contains the same information as the reference which is input at the Hardware Interface Reference port. This port allows for control over the order of execution, as this VI will not pass on its reference until it has completed all its tasks.
	error out

Pause

Pauses the playback of the data vector. When the next Play command is issued, playback will resume from the position at which it was paused.

	Hardware Interface Reference A reference to the specific DPG you are using. These references can be obtained from the List Devices VI.
	error in (no error)
	Hardware Interface Reference out Contains the same information as the reference which is input at the Hardware Interface Reference port. This port allows for control over the order of execution, as this VI will not pass on its reference until it has completed all its tasks.
	error out

Stop

Stops the data vector playback. Unlike the Pause command, the DPG will not remember where it was stopped at. The next Play command that is issued will start playback from Start Address.

	Hardware Interface Reference A reference to the specific DPG you are using. These references can be obtained from the List Devices VI.
	error in (no error)
	Hardware Interface Reference out Contains the same information as the reference which is input at the Hardware Interface Reference port. This port allows for control over the order of execution, as this VI will not pass on its reference until it has completed all its tasks.
	error out

Wiki

Analog Devices Wiki

Table of Contents

LabVIEW 7