United Electronic Industries DNx-AO-308-354 8 Channel 16-bit High Voltage User Manual

Introduction

This document outlines the feature set and use of the DNx-AO-308-354, an 8 channel, high voltage, analog output board.

The following sections are provided in this chapter:

• Organization of Manual (Section 1.1)
• AO-308-354 Board Overview (Section 1.2)
• Specification (Section 1.3)
• Device Architecture (Section 1.4)
• Indicators (Section 1.5)
• Wiring and Connections (pinout) (Section 1.6)

Organization of Manual

This AO-308-354 User Manual is organized as follows:

• Introduction
  Chapter 1 provides an overview of DNx-AO-308-354 Analog Output Board features, device architecture, connectivity, and logic.

• Programming with the High-Level API
  Chapter 2 provides an overview of the how to create a session, configure the session, and generate output on the DNx-AO-308-354 with the UEIDAQ High-level Framework API.

• Programming with the Low-Level API
  Chapter 3 is an overview of low-level API commands for configuring and using the DNx-AO-308-354.

• Appendix A – Accessories
  This appendix provides a list of accessories available for use with the DNx- AO-308-354 board.

NOTE: A glossary of terms used with the PowerDNA Cube/Rack and layers can be viewed and/or downloaded from www.ueidaq.com.

Manual Conventions
To help you get the most out of this manual and our products, please note that we use the following conventions:

 Tips are designed to highlight quick ways to get the job done or to reveal good ideas you might not discover on your own.

NOTE: Notes alert you to important information.

CAUTION! Caution advises you of precautions to take to avoid injury, data loss, and damage to your boards or a system crash.

Text formatted in bold typeface generally represents text that should be entered verbatim. For instance, it can represent a command, as in the following example: “You can instruct users how to run setup using a command such as setup.exe.”

Bold typeface will also represent field or button names, as in “Click Scan Network.”

Text formatted in fixed typeface generally represents source code or other text that should be entered verbatim into the source code, initialization, or other file.

Examples of Manual Conventions
Before plugging any I/O connector into the Cube or RACKtangle, be sure to remove power from all field wiring. Failure to do so may cause severe damage to the equipment.

Usage of Terms
 Throughout this manual, the term “Cube” refers to either a PowerDNA Cube product or to a PowerDNR RACKtangle rack mounted system, whichever is applicable. The term DNR is a specific reference to the RACKtangle, DNA to the PowerDNA I/O Cube, and DNx to refer to both

AO-308-354 Board Overview
The AO-308-354 is part of the AO-308 series of Analog Output boards:

• AO-308 16-bit, 8 channel, ±10 V Analog Output Board
• AO-308-350 16-bit, 8 channel, ±10 V, High Current Analog Output Board
• AO-308-352 16-bit, 8 channel, ±13.5V, Medium Voltage/Current Analog Output Board
• AO-308-353 16-bit, 8 channel, ±40 V, High Voltage Analog Output Board
• AO-308-354 16-bit, 8 channel, ±60 V, High Voltage Analog Output Board
• AO-308-020 16-bit, 8 channel, 0-20 mA, Current Analog Output Board
• AO-308-420 16-bit, 8 channel, 4-20 mA, Current Analog Output Board

This manual describes the AO-308-354 16-bit, 8-channel, ±60 V High Voltage Analog Output board only. The other products in the series are described in separate documents. The DNA-AO-308-354, DNR-AO-308-354, and DNF-AO-308-354 boards are compatible with the UEI Cube, RACKtangle, and FLATRACK chassis respectively. These board versions are electrically identical and only differ in mounting hardware. The DNA version is designed to stack in a cube chassis. The DNR/F versions are designed to plug into the backplane of a RACK chassis. For brevity we will refer to all form factors of the board simply as the AO-308-354 throughout the rest of the manual. Using an AO-308-354 instead of an AO-308 boosts voltage capability to ±60 V per channel for the four even- numbered channels only. The four odd-numbered channels provide ±10 V output per channel. The AO-308-354 uses a ±63 V source, supplied from an external supply. e.g., a UEI DNx-PC-914, or internally by the addition of a DNA-PC-914 Power Conversion board mounted in a UEI Cube chassis. When a DNA-AO-308-354 is ordered with a DNA-PC-914 power conversion board, it is factory-configured for internal power.

Specification

The technical specifications for the AO-308-354 High Voltage Analog Output board are listed in Table 1-1.

Table 1-1 DNx-AO-308-354 Technical Specifications

Number of channels| 8Channels 0, 2, 4, & 6 are ±60 VChannels 1, 3, 5 & 7 are ± 10 V
---|---
Resolution| 16 bits
Max Update Rate:@ 16-bit resolution| 50 kHz/chan (200 kHz max aggreagate)
Buffer Size| 1 K samples
Type of D/A| double-buffered
INL (no load)| ±1 LSB (0.003%)
DNL (no load)| ±1 LSB (0.003%)
Monotonicity Over Temperature| 16 bits
Gain Linearity Error| 0.002%
Gain Calibration Error| ±1.5 mV
Offset Calibration Error| ±1.5 mV
Offset Drift| 5 ppm/°C
Gain Drift| 5 ppm/°C
Output Voltage Range (even numbered channels)| ±60 V @ ±5 mA (with external power supply ≥ 63 VDC.Lower voltage power may be applied though the output range is only guaranteed within ±3V of the supplied power supply.)
Output Voltage Range (oddnumbered channels)| ±10 V @ ±5 mA
Output Coupling| DC
Output Impedance| 0.1 Ω max
Current Drive| ±5 mA/channel
Capacitive Loads| 500 pF
Settling Time| 10 μs to 16 bits
Slew Rate| 10 V/μs
Isolation| 350 Vrms
Power Consumption1| 3.8 W unloaded, 5W with max load
Physical Dimensions| 3.875” x 3.875” (98 mm x 98 mm)
Operating Temp. (tested)| -40 °C to +85 °C
Operating Humidity| 0 -95%, non-condensing
Vibration IEC 60068-2-6 IEC 60068-2-64| 5 g, 10-500 Hz, sinusoidal5 g (rms), 10-500Hz, broadband random
Shock IEC 60068-2-27| 100 g, 3 ms half sine, 18 shocks @ 6 orientations30 g, 11 ms half sine, 18 shocks @ 6 orientations
Altitude| 120,000 ft
MTBF| 480,000 hours

Device Architecture
The AO-308-354 High Voltage Analog Output board has eight individual analog output channels. The four even-numbered channels offer ±60 V output while the four odd-numbered channels offer ±10 V output. A simplified block diagram of the board is shown in Figure 1-1.

Indicators
A photo of the AO-308-354 board is shown in Figure 1-2. The front panel has two LED indicators:

• RDY: indicates that the layer is receiving power and operational.
• STS: can be set by the user using the low-level framework.

Wiring and Connections (pinout)
The pinout of the 37-pin connector for the AO-308-354 board is shown in Figure 1-3. A diagram for using the PC-914 for supplying external power to the AO-308-354 is shown in Figure 1-4.

Note: If powering externally, connect ±63V power supply to pins +VEXT (25) and -VEXT (6). Due to the higher power dissipation on this board (308-354) relative to other boards in the DNx-AO-308 series, only four channels offer the 60V range. These are designated as channels 0, 2, 4 and 6. Channels 1, 3, 5 and 7 offer +/- 10 V outputs.

Since the AO-308-354 High Voltage Analog Output board is designed with output buffers. Separate sense lines are not provided. To minimize error due to differences in lead resistance, be sure to use equal length signal and return lines.

Interconnecting a DNxAO-308-354 and a DNx-PC914
Using an AO-308-354 with a DNx-PC-914 as the ±63 V external power supply requires interconnections between the two boards as shown in Figure 1-4 below.

Figure 1-4. DNx-PC-914 and AO-308-354 Interconnection Diagram

Programming with the High-Level API

This chapter provides the following information about using the UeiDaq high- level Framework API to program the DNx-AO-308-354:

• About the High-level Framework (Section 2.1)
• Creating a Session (Section 2.2)
• Configuring the Resource String (Section 2.3)
• Configuring Channels for Output (Section 2.4)
• Configuring the Timing (Section 2.5)
• Writing Data (Section 2.6)
• Cleaning-up the Session (Section 2.7)

About the High-level Framework
The UeiDaq Framework is object oriented and its objects can be manipulated in the same manner from different development environments, such as Visual C++, Visual Basic, or LabVIEW. UeiDaq Framework is bundled with examples for supported programming languages. Examples are located under the UEI programs group in:

• Start » Programs » UEI » Framework » Examples The following sections focus on the C++ API, but the concept is the same no matter which programming language you use. Please refer to the “UeiDaq Framework User Manual” for more information on use of other programming languages.

Creating a Session
The Session object controls all operations on your PowerDNx device. Therefore, the first task is to create a session object:

// create a session object for input
CUeiSession session;

Configuring the Resource String
UeiDaq Framework uses resource strings to select which device, subsystem and channels to use within a session. The resource string syntax is similar to a web URL:

For PowerDNA and RACKtangle, the device class is pdna.
For example, the following resource string selects analog output lines 0,1,2,3 on device 1 at IP address 192.168.100.2: “pdna://192.168.100.2/Dev1/Ao0:3” as a range, or “pdna://192.168.100.2/Dev1/Ao0,1,2,3”. as a list

Configuring Channels for Output
The AO-308-354 can be configured for analog output:

// Configure channels 0,1 with an output range of ±60V
session.CreateAOChannel(“pdna://192.168.100.2/Dev0/ao0:1”,
-60.0, 60.0);

Configuring the Timing
You can configure the AO-308-354 series boards to run either in simple mode (point by point) or buffered mode (ACB mode). In simple mode, the delay between samples is determined by software on the host computer. In buffered mode, the delay between samples is determined by the AO-308-354 on-board clock. The following example shows how to configure simple mode. Please refer to the “UeiDaq Framework User Manual” to learn how to use the other timing modes.

// configure timing of input for point-by-point (simple mode)
session.ConfigureTimingForSimpleIO();

Writing Data
Writing data to the AO-308-354 board is done with a writer object. You can create a writer object that writes raw data straight to the D/A converter. You can also create a writer object that writes data scaled to volts. Framework automatically performs a conversion to binary code before sending the data to the D/A converter. The following example code shows how to create a scaled writer object and write the data.

// create a writer and link it to the session’s stream
CueiAnalogScaledWriter writer(session.GetDataStream());
// the buffer must be big enough to contain one value per channel
double data[2] = {0.0, 0.0};
// write one scan, where the buffer will contain one value per channel
writer.WriteSingleScan(data);

Or you can create a writer object that writes raw data straight to the DAC.

// create a writer and link it to the session’s stream
CueiAnalogRawWriter writer(session.GetDataStream());
// the buffer must be big enough to contain one value per channel

// create a writer and link it to the session’s stream
uInt16 data[2] = {0x1234, 0x5678};
// write one scan, where the buffer will contain one value per channel
writer.WriteSingleScan(data);

All the AO-308-354-xxx analog output layers are programmed the same way.

Cleaning-up the Session
The session object will clean itself up when it goes out of scope or when it is destroyed. To reuse the object with a different set of channels or parameters, you can manually clean up the session as follows:

// clean up the session
session.CleanUp();

Programming with the Low-Level API

This chapter provides the following information about programming the DNx- AO-308-354 Analog Output Board using the low-level API. All AO-308-xxx layers are programmed the same way.

• About the Low-level API (Section 3.1)
• Low-level Functions (Section 3.2)
• Low-level Programming Techniques (Section 3.3)
• Data Output Modes (Section 3.4)
• Programming the AO-308-xxx (Immediate Mode) (Section 3.5)
• Configuration Settings (Section 3.6)
• Data Representation (Section 3.7)

About the Low-level API
The low-level API provides direct access to the DAQBIOS protocol structure and registers in C. The low-level API is intended for speed optimization, when programming unconventional functionality, or when programming for Linux or real-time operating systems. When programming in Windows OS, however, we recommend that you use the UeiDaq High-level Framework API (see Chapter 2). The Framework extends the low-level API with additional functionality that makes programming easier and faster.

For additional information regarding low-level programming, refer to the “PowerDNA API Reference Manual” located in the following directories:

• On Linux systems:

  /docs

• On Windows systems:
  C:\Program Files (x86)\UEI\PowerDNA\Documentation

Low-level Functions
Table 3-1 provides a summary of AO-308-xxx specific functions. All low-level functions are described in detail in the “PowerDNA API Reference Manual”.

Table 3-1 Summary of Low-level API Functions for DNx-AO-308-xxx

memory.
DqAdv3xxEnableWForm| Configures, enables, pause/resumes, or disables waveform output.

Low-level Programming Techniques
Application developers are encouraged to explore the existing source code examples when first programming the AO-308-xxx. Example code provided with the installation is self-documented and serves as a good starting point. Code examples are located in the following directories:

• On Linux systems: <PowerDNA-x.y.z>/src/DAQLib_Samples
• On Windows: C:\Program Files (x86)\UEI\PowerDNA\SDK\Examples

Example code for data acquisition modes have the name of the mode and the name of the I/O boards being programmed embedded in the sample name. For example, SampleVMap3xx contains example code for running the an AO-308-xxx using VMap data acquisition mode. Note that immediate mode examples are named Sample<I/O board name>, (i.e., Sample30x).

Data Output Modes
The AO-308-xxx I/O board can be programmed using the following modes. You can only use one mode at a time and cannot, for example, run one channel in immediate mode and the other in waveform mode. API functions that implement data acquisition modes and additional mode descriptions are provided in the PowerDNA API Reference Manual.

Immediate (Point-byPoint) Mode
This is the easiest way to program the AO-308-xxx but also the least efficient. Immediate mode writes a single data point per channel to the layer at a nondeterministic pace. The maximum point-by-point rate is 100 Hz. Use the API function DqAdv3xxWrite() to update the AO-308-xxx outputswith a DC voltage. The outputs will update on the next clock tick. When DqAdv3xxWrite() is called for the first time, the firmware terminatesany ongoing operation on the device. Then, the firmware parses the channel list and writes the passed values one by one. This function cannot be called when the layer is involved in any streaming or data mapping operations. Every write to the channel takes approximately 3.3 µs. Thus, execution time for this function depends on the number of channels in the channel list. AO-308-xxx runs its outputs at 1 kHz by default and you can change the update rate with DqCmdSetClock(). The example code Sample30x demonstrates immediate mode on AO-308-xxx.

Waveform Regeneration
This mode continuously generates a waveform uploaded in the AO-308-xxx’s FIFO. The example code Sample3xx_Waveform demonstrates this mode.

DMAP Mode
Data Map (DMAP) mode is recommended to efficiently read and update one value per channel at a time. DMap is designed for closed-loop (control) applications and may include channels across multiple I/O layers. It guarantees that all I/O layers configured in the same DMAP are synchronized (all input samples are read at the same time and all output values are updated at the same time). The example code SampleRTDMap3xx demonstrates RTDMAP mode.

VMAP Mode
Variable Data Map (VMAP) mode reads and updates a variable number of data points per channel at a time. VMap is designed for closed-loop (control) applications and may include channels across multiple I/O layers. It guarantees that all I/O layers configured in the same VMAP are synchronized (all input samples are read at the same time and all output values are updated at the same time). The example code SampleVMap3xx demonstrates VMAP mode.

ACB Mode
Advanced Circular Buffer (ACB) mode continuously uploads and generates an arbitrary waveform to the AO-308-xxx outputs. It uses an event-based software architecture to notify the user when it is time to upload a new block of data. This is the only mode that can update the AO-308-xxx outputs at maximum speed. ACB mode is not available on UEIPAC products. The example code SampleACB30x demonstrates ACB mode.

Programming the AO-308-xxx (Immediate Mode)
The following sections provide an overview of how to set up and use your AO-308-xxx in Immediate Mode using the low-level API. For best results, use this overview in conjunction with actual sample code, (i.e., Sample30x). This overview does not address typical initialization or error handling. Refer to Section 3.3 for sample code location.

Setting up Channel Configuration
Users initialize a list of AO-308-xxx channels to enable and output samples to. You can enable channels sequentially or in whichever order you choose

// CHANNELS is a max of 8.
uint32 cl[CHANNELS];
// Order channels sequentially in the channel list.
for (i = 0; i < CHANNELS; i++){
cl[i] = i;
}

Writing Output Data
In Immediate mode, use the DqAdv3xxWrite() API to write raw or floating point samples to each of the enabled channels (in the order of the channel list):

uint16 data[CHANNELS];
double fdata[CHANNELS];
// Set up and write output data.
while(!stop){
for (i=0; i<CHANNELS; i++){
data[i]=0; // Value isn’t used, not sending raw data
fdata[i]=nextSampleToOutput(); // see specification for output range
DqAdv3xxWrite(hd, DEVN, CHANNELS, cl, 0, data, fdata);
UeiPalSleep(500); // Controls data output rate
}

Configuration Settings
Configuration settings are passed in DqCmdSetCfg() and DqAcbInitOps() functions. Not all configuration bits apply to AO-308-xxx series layers. Some important definitions:

• DQ_LN_ENABLE enables all operations with the layer.
• DQ_LN_CVCKSRC0 selects the internal channel list clock (CL) source as a timebase. AO-308 supports CV clock.
• DQ_LN_ACTIVE is needed to switch on “STS” LED on the CPU layer.

For example, for streaming operations with hardware clocking you can select the following flags:

DQ_LN_ENABLE | DQ_LN_CVCKSRC0 | DQ_LN_STREAMING |
DQ_LN_IRQEN | DQ_LN_ACTIVE

The AO-308-xxx also has a range of layer-specific settings, as follows:

// continuous output with FIFO. Mode reserved for future use.

define DQ_AO3xx_MODEFIFO (1L << 19)

// waveform mode – continuous. Mode reserved for future use.

define DQ_AO3xx_MODECONT (2L << 19)

// waveform mode – regenerate. Mode reserved for future use.

define DQ_AO3xx_MODECYCLE (3L << 19)

// waveform mode – hardware. Mode reserved for future use.

define DQ_AO3xx_MODEWFGEN (4L << 19)

You can select either the CL or CV clock as a timebase. Because of the parallel
architecture of the AO-308-xxx layer, either clock triggers all converters.
Aggregate rate = Per-channel rate * Number of channels
Note that acquisition rate cannot be selected on per-channel basis

Data Representation
The DNx-AO-308-xxx Series has a 16-bit straight binary data representation. For each layer in the series, the supported range and selected values are listed in Table 3-2.

Table 3-2 DNx-AO-308-xxx Data Representation

Layer| Range| 0x0| 0x8000| 0xFFFF| Span| Offset
---|---|---|---|---|---|---
AO-308, -350| ±10 V| -10 V| 0| +10 V| 20 V| 0
-352| ±13.5 V| -13.5 V| 0| +13.5 V| 27 V| 0
-353| ±40 V| -40 V| 0| +40 V| 80 V| 0
-354| ±60 V| -60 V| 0| +60 V| 120 V| 0
-020| 0-20 mA| 0 mA| 10 mA| 20m A| 20 mA| 0
-420| 4-20 mA| 4 mA| 12 mA| 20 mA| 16 mA| 4 mA

To convert voltage into an A/D representation, use the following formula:
Raw = (Volt+Offset)/(Span/0xFFFF),
where Volt is the desired level in volts.
To convert current into A/D representation, use the following formula:
Raw = (mA+Offset)/(Span/0xFFFF),
where mA is the desired level in milliamps.

Appendix A

A. Accessories
The following cables and STP boards are available for the AO-308-354 layer.

DNA-CBL-37
This is a 37-conductor flat ribbon cable with 37-pin male D-sub connectors on both ends. The length is 3ft and the weight is 3.4 ounces or 98 grams.

DNA-CBL-37S
This is a 37-conductor round shielded cable with 37-pin male D-sub connectors on both ends. It is made with round, heavy-shielded cable and is 3 ft (90 cm) long and weighs 10 ounces (283 grams). It is also available in 10 ft and 20 ft lengths.

DNA-STP-37
The DNA-STP-37 provides easy screw terminal connections for all DNx series I/O boards which utilize the 37-pin connector scheme. The DNA-STP-37 is connected to the I/O board via either a DNA-CBL-37 or DNA-CBL-37S cable. The dimensions of the STP-37 board are 4.2w x 2.8d x1.0h inches (10.7 x 7.1 x 2.54 cm) with standoffs. The weight of the STP-37 board is 2.4 ounces (68 grams).

UEI-STP-AO-200
The UEI-STP-AO-200 is a unity gain, high current output buffer board for use with DNA-AO-308 and PD2/PDXI series analog output boards. It offers a gain of 1±0.2% and drives up to 250 mA at ±10 volts. It requires a user-supplied ±13 to ±15 V power supply with current capability to support the output current specified. Users who do not want to supply bipolar power should order the UEI- STP-AO-200D unit, which includes a DC/DC converter and requires a +9 V to +36 V power supply. If the total power consumption of the layer exceeds 4.5 W, a rear mount cooling fan such as the DNA-FAN5 (for 3-layer Cube) or DNA-FAN8 (for 5-layer Cube) should be added to the DNA Cube.

References

• United Electronic Industries (UEI) – DAQ, Test, HIL
• Terms of Use

Read User Manual Online (PDF format)

Download This Manual (PDF format)

Download this manual  >>