Analog I/O Wildcard User Guide

The Analog I/O Wildcard provides eight 12-bit digital to analog (DAC) outputs and eight 16-bit analog to digital (A/D) inputs. This tiny 2” by 2.5” module is a member of the Wildcard™ series that connects directly to Mosaic embedded controllers.

This document describes the capabilities of the Analog I/O Wildcard, tells how to configure the hardware, and presents an overview of the driver software. A glossary of the software functions and complete hardware schematics are also included.

The Analog I/O Wildcard comprises a Wildcard bus header, field header, digital logic circuitry, an octal 12-bit digital to analog converter (DAC), an octal 16-bit analog to digital converter (A/D), and a 4.096 volt reference. The 4.096 reference voltage varies less than 100 microvolts per degree Celsius change in temperature. Jumpers enable module address selection and reference voltage selection among 5V, 4.096V, the DAC reference voltages (1.024 or 2.048 V), or an external reference voltage. The Wildcard bus header interfaces to the host processor (Mosaic embedded controller), and the field header brings out the analog I/O signals for the reference, DAC, and A/D. Specifications are summarized in Table 1-1.

To connect the Analog I/O Wildcard to the Wildcard bus on the controller board, follow these simple steps:

With the power off, connect the female 24-pin side of the stacking go-through Wildcard bus header on the bottom of the Analog I/O Wildcard to Wildcard Port 0 or Wildcard Port 1 on the Wildcard bus on the controller board. The corner mounting holes on the module should line up with the standoffs on the controller board. The module ports are labeled on the silkscreen of the controller board. Note that the Analog I/O Wildcard headers are configured to allow direct stacking onto the Wildcard bus, even if other Wildcards are also installed. Do not use ribbon cables to connect the Analog I/O Wildcard to the Wildcard bus. Use of ribbon cables on the Analog I/O Wildcard's field header is fine.

Once you have connected the Analog I/O Wildcard to the Wildcard bus, you must set the address of the module using jumper shunts across J1 and J2.

The Wildcard Select Jumpers, labeled J1 and J2, select a 2-bit code that sets a unique address on the Wildcard port of the Mosaic controller. Each Wildcard port on the Mosaic controller accommodates up to 4 Wildcards. Wildcard Port 0 provides access to modules 0-3 while Wildcard Port 1 provides access to modules 4-7. Two Wildcards on the same port cannot have the same address (jumper settings). Table 1-2 shows the possible jumper settings and the corresponding addresses.

Table 1-2 Jumper Settings and Associated Addresses

The remaining jumpers on the Analog I/O Wildcard select the reference voltage for both the 12-bit DAC and the 16-bit A/D. These jumpers, referred to as the voltage reference selection jumpers, are labeled J3, J4, J5, and J6 and named DAC Ref, 4V Ref, 5V Ref, and Ref In/Out respectively.

In most applications the DAC uses its own internal reference, and the jumpers J3, J4, and J5 select one of 3 reference voltages for the A/D converter (the DAC reference output, the 4.096V onboard reference, or the 5V reference, respectively). If installed, jumper J6 connects the A/D reference to pin 4 (VREF_PIN) on the Field Header.

The default configuration of the reference voltage selection jumpers is J4 and J6 installed. This connects the temperature-stable 4.096 reference voltage to the A/D reference input pin providing a 0 to 4.096 input range for each channel of the A/D. The default configuration also connects the 4.096 reference voltage to the reference pin on the Field Header (pin 4) for external connections. Using the default configuration requires that you initialize the DAC to generate its own reference voltage internally by passing the INT_1V_DAC12 More… Close

C: INT_1V_DAC12
4th: INT_1V_DAC12 ( -- n )

A constant (= 0x04) that, when passed as a parameter to the Init_Analog_IO function, configures the 12-bit DAC to use its own internally generated 1.024 volt as its reference. With this option, the DAC output range is from 0 to 2.048 volts.

See also Init_Analog_IO.

The DAC reference jumper, labeled J3, and named “DAC Ref” on the silkscreen of the Analog I/O Wildcard, connects the DAC reference pin to the A/D reference input pin. The DAC reference voltage can be generated internally, or supplied externally by installing jumper J6. The DAC reference voltage is configured with the function Init_Analog_IO More… Close

C: void Init_Analog_IO ( int reference_option, int module_num )
4th: Init_Analog_IO ( reference_option\module_num -- )

Initializes the software drivers for the 12-bit DAC and the 16-bit A/D, sets the reference voltage of the DAC to the specified option on the specified module, and sets all 8 DAC channels to 0 volts. The reference option is selected using one of the following constants: INT_2V_DAC12, INT_1V_DAC12, and EXT_DAC12. The eight valid module numbers are 0 to 7. See also INT_2V_DAC12, INT_1V_DAC12, and EXT_DAC12.

Table 1-3 DAC reference voltage configuration options with jumper J3 installed

The 4.096 Reference Jumper, labeled J4, and named “4V Ref” on the silkscreen of the Analog I/O Wildcard, connects the onboard 4.096 voltage reference to the reference input pin on the A/D. This configures the input range of the A/D as 0 to 4.096 volts. With this option, the DAC must be configured to generate its own reference voltage (using the INT_1V_DAC12 More… Close

C: INT_1V_DAC12
4th: INT_1V_DAC12 ( -- n )

A constant (= 0x04) that, when passed as a parameter to the Init_Analog_IO function, configures the 12-bit DAC to use its own internally generated 1.024 volt as its reference. With this option, the DAC output range is from 0 to 2.048 volts.

See also Init_Analog_IO.

The 5.0 Reference Jumper, labeled J5, and named “5V Ref” on the silkscreen of the Analog I/O Wildcard, connects the onboard 5 volt analog supply to the reference input pin on the A/D. This configures the input range of the A/D as 0 to 5.0 volts. With this option, the DAC must be configured to generate its own reference voltage (using the INT_1V_DAC12 More… Close

C: INT_1V_DAC12
4th: INT_1V_DAC12 ( -- n )

A constant (= 0x04) that, when passed as a parameter to the Init_Analog_IO function, configures the 12-bit DAC to use its own internally generated 1.024 volt as its reference. With this option, the DAC output range is from 0 to 2.048 volts.

See also Init_Analog_IO.

The Reference In/Out Jumper, labeled J6, connects the reference input pin of the A/D to the reference pin on the Field Header (pin 4). Install this jumper if the reference voltage is desired on the Field Header or an external reference voltage is required to drive the A/D or the DAC.

Table 1-4 shows the valid jumper configurations for selecting the reference voltage. Jumper configurations that are not shown in the table may damage the Analog I/O Wildcard!

Table 1-4 Valid Voltage Reference Jumper Configurations

For detailed information regarding the converter's accuracy please consult the datasheet for the ADS8344. In brief, the accuracy and effective resolution of a conversion depends on a number of factors including the converters intrinsic noise and the source impedance.

The converter exhibits approximately 20 μVrms of effective input noise. When using a reference voltage range of 5 volts, the size of a least significant bit (lsb) is 76 μV, so this input noise corresponds to an error at about the 18 bit level (one quarter of the converter's lsb), and so does not compromise the performance of the converter. However, if the reference used is only 0.5 V, then the noise corresponds to appx. 3 lsb.

Components and transducers with high output impedances connected to the analog inputs will introduce errors in the analog to digital converter. Table 1-5 shows the maximum source resistance at various sampling rates. Larger source resistances may cause conversion errors of more than one least significant bit (LSB).

Ideally the converter would be driven by a signal with low source resistance. However, a finite source resistance, combined with an A/D input impedance comprising a 25 pF capacitor and ±1 µA leakage current, can compromise the converter's response via three mechanisms.

1. The first and greatest source of error is input leakage current. The ADS8344's ±1 µA leakage current is specified as “typical” over its operating temperature range of -40 to +80°C. Like many other NMOS parts, the leakage current increases exponentially with temperature, with the “typical” value being merely a room temperature value. The actual leakage current may increase ten-fold at the upper temperature limit of +85°C. The leakage current flowing through the source impedance creates a small input offset voltage. With a 4.096 V reference one lsb corresponds to 62.5 microvolts. Thus, 1 µA leakage current into a source impedance of 63 ohms may cause a one lsb error. Any greater source resistance would cause a correspondingly greater error; e.g., a 1KΩ source resistance could produce as much as a ±16 count error.
2. The second source of error results from the requirement that the input capacitance of the converter must fully charge through the source resistance during an acquisition time of 2.25 μsec. To fully charge, the RC time constant should be much smaller than 2.25 μsec. This is usually easily attained. Allowing 16*LN(2) or eleven time constants for a large input change to charge with 16-bit precision produces the requirement that 11*RC<2.25μsec, or R < 2.25μsec / (11*25 pF), or R < 8 KΩ.
3. The third source of error results from the average input capacitance current flowing through the source resistance. The capacitance must charge repeatedly at the sample rate, producing an average current through the source impedance, and resulting in an average voltage drop across it. For < one lsb error we need fRC<2^-16 or R<2^-16/fC. At a sample rate of 1Ksps, R<610 ohms.

Combining these effects, we see that for a one lsb error the maximum source impedance should be less than 57 ohms at a sample rate of 1 Ksps, and less than 40 ohms at 5 Ksps. If the device is operated at an elevated temperature the input leakage current may increase causing much greater errors. Consequently, our recommendation is to drive the inputs from the output of an op-amp.

Table 1-5 Maximum Source Resistance at Various Sampling Rates

The analog inputs and outputs are brought out to a 24-pin dual row header on the Analog I/O Wildcard as shown in Table 1-6.

Table 1-6 Analog I/O Wildcard Field Header

To connect your transducer signals or control inputs to the Field Bus (H3 on the Analog I/O Wildcard) use a ribbon cable or the Screw Terminal Module that brings out the signals to screw terminal blocks. Shielding the connecting wires is highly recommended for optimal performance.

A package of pre-coded device driver functions is provided to make it easy to use the Analog I/O Wildcard. This code is available as a pre-compiled “kernel extension” library to C and Forth programmers.

The Analog I/O Wildcard driver code makes it easy to initialize the A/D and DAC, acquire 16-bit samples from the A/D, and write 12-bit values to the DAC. The following sections describe the functions that initialize the A/D and DAC, read from the A/D inputs, and write to the DAC outputs.

Most of the functions accept as input parameters the channel number and the Analog I/O Wildcard Number (0 through 7). Be sure the module number passed to the software functions correspond to the hardware jumper settings as described in Table 1-2 above.

Use Init_Analog_IO More… Close

C: void Init_Analog_IO ( int reference_option, int module_num )
4th: Init_Analog_IO ( reference_option\module_num -- )

Initializes the software drivers for the 12-bit DAC and the 16-bit A/D, sets the reference voltage of the DAC to the specified option on the specified module, and sets all 8 DAC channels to 0 volts. The reference option is selected using one of the following constants: INT_2V_DAC12, INT_1V_DAC12, and EXT_DAC12. The eight valid module numbers are 0 to 7. See also INT_2V_DAC12, INT_1V_DAC12, and EXT_DAC12.

The Analog I/O Wildcard has eight 12-bit DAC outputs. Each DAC accepts a number between 0 and 4095 that we'll designate as N, and outputs a voltage given by Equation 1-1.

Vout = 2 * Vref * (N/4096) Eqn. 1-1

There are three different options for Vref:

1. The DAC's internally generated 2.048 volts, selected by passing the constant INT_2V_DAC12 to Init_Analog_IO. This is the default option and provides an output range for each DAC channel of 0 to 4.096 volts.

2. The DAC's internally generated 1.024 volts, selected by passing the constant INT_1V_DAC12 to Init_Analog_IO. This provides an output range for each DAC channel of 0 to 2.048 volts.

3. An externally generated voltage applied to the reference pin (pin 4) of the Field Header with jumpers J3 and J6 installed, selected by passing the constant EXT_DAC12 More… Close

C: EXT_DAC12
4th: EXT_DAC12 ( -- n )

A constant (= 0x00) that, when passed as a parameter to the Init_Analog_IO function, configures the 12-bit DAC to use the voltage on the reference pin of the Analog I/O Field Header, pin 4 as its reference if jumper J6 is installed.

See also Init_Analog_IO.

The constants that are associated with the DAC output channels are DAC12_CH0 More… Close

C: DAC12_CH0
4th: DAC12_CH0 ( -- n )

A constant (= 0x00) that, when passed as a parameter to the To_DAC12 function, configures the 12-bit DAC to output a voltage on Channel 0, pin 24, of the Analog I/O Field Header.

See also To_DAC12.

Listing 1-1 C Code Listing for outputing 2.000 volts to Channel 0 on Module 0.

#include <mosaic/allqed.h>
#ifdef __GNUC__
#include <waim.h>
#else
#include "library.h"
#include "library.c"
#endif
#define ANALOG_MODULE0 0	                   // define current module
void main ( void )
{ 
  Init_Analog_IO(INT_2V_DAC12,ANALOG_MODULE0); // init DAC to use 2.048 int ref
  To_DAC12( 2000, DAC12_CH0, ANALOG_MODULE0);  // output 2.000 volts to ch 0
}

Listing 1-2 Forth Code Listing for outputing 2.048 volts to Channel 0 on Module 0

DECIMAL                                    \ set base to decimal
0 CONSTANT ANALOG_MODULE0                  \ define current module
INT_2V_DAC12 ANALOG_MODULE0 Init_Analog_IO \ init DAC to use 2.048 internal ref
2000 DAC12_CH0 ANALOG_MODULE0 To_DAC12     \ output 2.000 volts to channel 0

Another useful function, named To_All_DACs More… Close

C: void To_All_DACs ( int value, int module_num )
4th: To_All_DACs ( value\module_num -- )

Writes the specified 12-bit value simultaneously to all channels of the 12-bit DAC on the specified module. To_All_DACs uses the functions Delay_Update_DAC12 and Update_DAC12 to output all voltages to all channels at the same time. The eight valid module numbers are 0 to 7. The 12-bit value is clamped to the range of 0 to 4095 but no error checking is performed on the module number. Init_Analog_IO must be called before this routine initialize the reference voltage of the DAC.

See also Init_Analog_IO, Delay_Update_DAC12, and Update_DAC12.

Listing 1-3 C Code Listing for using Delay_Update_DAC12 More… Close

C: void Delay_Update_DAC12 ( int module_num )
4th: Delay_Update_DAC12 ( module_num -- )

#include <mosaic/allqed.h>
#ifdef __GNUC__
#include <waim.h>
#else
#include "library.h"
#include "library.c"
#endif
#define ANALOG_MODULE0 0	                   // define current module 
void main ( void )
{ 
  Init_Analog_IO(INT_2V_DAC12,ANALOG_MODULE0); // init DAC to use 2.048 int ref
  Delay_Update_DAC12( ANALOG_MODULE0 );        // delay DAC update
  To_DAC12( 0500, DAC12_CH0, ANALOG_MODULE0);  // output 0.5 volts to ch 0
  To_DAC12( 1000, DAC12_CH1, ANALOG_MODULE0);  // output 1.0 volts to ch 1
  To_DAC12( 1500, DAC12_CH2, ANALOG_MODULE0);  // output 1.5 volts to ch 2
  To_DAC12( 2000, DAC12_CH3, ANALOG_MODULE0);  // output 2.0 volts to ch 3
  To_DAC12( 2500, DAC12_CH4, ANALOG_MODULE0);  // output 2.5 volts to ch 4
  To_DAC12( 3000, DAC12_CH5, ANALOG_MODULE0);  // output 3.0 volts to ch 5
  To_DAC12( 3500, DAC12_CH6, ANALOG_MODULE0);  // output 3.5 volts to ch 6
  To_DAC12( 4000, DAC12_CH7, ANALOG_MODULE0);  // output 4.0 volts to ch 7
  Update_DAC12( ANALOG_MODULE0 );             // simultaneously update all dacs
}

Listing 1-4 Forth Code Listing for using Delay_Update_DAC12 and Update_DAC12.

DECIMAL                                      \ set base to decimal
0 CONSTANT ANALOG_MODULE0                    \ define current module
: STAIR_STEP ( -- )
  INT_2V_DAC12 ANALOG_MODULE0 Init_Analog_IO \ init DAC to use 2.048 int ref
  ANALOG_MODULE0 Delay_Update_DAC12          \ delay DAC update
  0500 DAC12_CH0 ANALOG_MODULE0 To_DAC12     \ output 0.5 volts to channel 0
  1000 DAC12_CH1 ANALOG_MODULE0 To_DAC12     \ output 1.0 volts to channel 1
  1500 DAC12_CH2 ANALOG_MODULE0 To_DAC12     \ output 1.5 volts to channel 2
  2000 DAC12_CH3 ANALOG_MODULE0 To_DAC12     \ output 2.0 volts to channel 3
  2500 DAC12_CH4 ANALOG_MODULE0 To_DAC12     \ output 2.5 volts to channel 4
  3000 DAC12_CH5 ANALOG_MODULE0 To_DAC12     \ output 3.0 volts to channel 5
  3500 DAC12_CH6 ANALOG_MODULE0 To_DAC12     \ output 3.5 volts to channel 6
  4000 DAC12_CH7 ANALOG_MODULE0 To_DAC12     \ output 4.0 volts to channel 7
  ANALOG_MODULE0 Update_DAC12                \ simultaneously update all dacs
;

The eight input lines of the Analog I/O Wildcard can be configured as either eight 16-bit unipolar single-ended input channels or four 16-bit unipolar-differential input channels. In single-ended configuration, the convertor can digitize only positive ground-referenced voltages. Each differential channel pair can also only convert a positive differential voltage, but the channel pair can be reconfigured to swap the polarity of the inputs so that a negative difference voltage can also be read. Consequently the four differential inputs can each be reconfigured so that there are a total of eight differential input combinations.

The A/D converts the positive voltage difference between a greater, “positive” input (+IN) and a lesser, “negative” input (–IN ) into a digital number in the range 0 to 65536, with 0 corresponding to +IN = –IN and 65535 corresponding to +IN – –IN = Vref. If the voltage on the –IN pin is greater than that of the +IN pin, the conversion result is zero.

In single-ended mode the –IN input is connected to ground and eight input channels of +IN are provided for reading positive voltages referenced to ground. In differential mode, the +IN and –IN are assigned to different input channels, and the positive voltage difference, +IN minus –IN, is converted. The –IN input must be kept within the range –0.2 V to +1.25 V, and should not be greater than the +IN input. The +IN input must be kept within the range –0.2 V to +5.2 V and produces meaningful results for values from the –IN input value up to the –IN input value plus the reference voltage. Because both the +IN and –IN input voltage ranged extend well below ground (to –0.2V), voltage differences near or slightly below ground can be read. Further, the +IN can range up to 5.2V.

The sixteen different input options are itemized in Table 1-7.

Table 1-7 Analog Input Connection Options

To read a voltage from channel 2 (pin 12 on the Field Header) on module 1 with a single-ended conversion, use the function AD16_Sample as shown in the example code Listings 1-5 and 1-6.

Listing 1-5 C Code Listing for reading A/D Channel 2 on Module 1.

#include <mosaic/allqed.h>
#ifdef __GNUC__
#include <waim.h>
#else
#include "library.h"
#include "library.c"
#endif
#define ANALOG_MODULE0 0	                   // define current module 
void main ( void )
{ 
  uint ad16_result; 
  Init_Analog_IO(INT_2V_DAC12,ANALOG_MODULE0); // init DAC to use 2.048 int ref
  ad16_result = AD16_Sample( AD16_CH2, ANALOG_MODULE0 ); // read ch 2 on mod 1
  printf("AD Result = %u\n",ad16_result);      // print out A/D counts
}

Listing 1-6 Forth Code Listing for reading A/D Channel 2 on Module 1.

DECIMAL                                    \ set base to decimal
0 CONSTANT ANALOG_MODULE0                  \ define current module
INT_2V_DAC12 ANALOG_MODULE0 Init_Analog_IO \ init DAC to use 2.048 internal ref
AD16_CH2 ANALOG_MODULE0 AD16_Sample        \ read sample from ch 2 on mod 1
U.                                         \ print out A/D counts

To convert the 16-bit result returned from AD16_Sample into a voltage, use Equation 1-2.

Vref in Equation 1-2 is the reference voltage selected using the voltage reference selection jumpers which were described in the section entitled “Selecting The Reference Voltage”. With the default voltage reference selection jumper configuration (jumpers J4 and J6 installed), Vref is 4.096 volts.

The function AD16_Multiple rapidly obtains a specified number of samples from an A/D channel and stores the results as sequential 2-byte values in memory starting at the specified extended address. If the specified extended address is in common RAM, the fastest sampling frequency is approximately 17 kHz (corresponding to 57.5 microseconds per sample). If the specified extended address is in paged memory, the fastest sampling frequency is approximately 12 kHz (corresponding to 82.5 microseconds per sample). The timing parameter specifies the timing of the samples, with 0 representing the fastest sampling rate, and 65,535 representing the slowest sampling rate. See the glossary entry for more information.

Instructions for PDQ

Instructions for QED/Q-line

COLD

COLD

The C demo is located in your installation directory. It is also provided here for reference.

Instructions for PDQ

#include <mosaic/allqed.h>
//__GNUC__ is true for Mosaic PDQ IDE
 
#ifdef __GNUC__
#include <waim.h>
#else
#include "library.h"
#include "library.c"
#endif

Instructions for QED/Q-line

#include "library.c"

#include "library.h"

The Forth demo is located in your installation directory. It is also provided here for reference.

Instructions for PDQ

MosaicPDQ\forth\demos\Analog_IO_Wildcard\aimdemo_loader.4TH

aim_demo

Instructions for QED/Q-line

WHICH.MAP 0=
IFTRUE 4 PAGE.TO.RAM  \ if in standard.map...
       5 PAGE.TO.RAM
       6 PAGE.TO.RAM  
      DOWNLOAD.MAP
ENDIFTRUE

4 PAGE.TO.FLASH
5 PAGE.TO.FLASH
6 PAGE.TO.FLASH 
STANDARD.MAP
SAVE

See Analog I/O Glossary

Analog I/O Wildcard schematic page 1 a a pdf

Analog I/O Wildcard schematic page 2 a a pdf

See also →

• Analog I/O C Demo
• Analog I/O Forth Demo
• Analog I/O Glossary