This is an old revision of the document!
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.
This pallet contains the following VIs and sub-palettes:
![]() | Example: Simple Sine Generator |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
This is a Polymorphic VI. Several different data types can be used to download data vectors 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. |
![]() | 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 |
![]() | 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 |
![]() | 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 |
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 |
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.
![]() | 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 |
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 |
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 |