14.0 Analog Inputs [T-Series Datasheet] | LabJack
 
« Close

Datasheets and User Guides

App Notes

Software & Driver

 
Table of Contents

14.0 Analog Inputs [T-Series Datasheet]

Analog Inputs Overview

Basics: An analog input (commonly referred to as AIN or AI) uses an analog-to-digital converter (ADC) to convert a voltage level into a digital value.  LabJack T-series devices have multiple analog inputs.

Common Uses: For information on measuring various analog signals such as typical analog sensors, measuring small voltages, measuring current (4-20mA), and measuring resistance see the Analog Input (App Note). There are also application specific app notes for temperature sensors and thermocouples.

How to read AIN: See 3.0 Communication for communication basics. Also, LabJack Kipling's Dashboard tab shows live AIN values. 

Configuration: T-series AIN readings can be configured. See below for information on:

AIN Extended Features: T-series AIN Extended Features simplify operations such as:

  • Reading thermocouples and thermistors
  • Calculating RMS, RTD, average/max/min, average/threshold, and circuit element resistance

Extended Channels - T7 Only: The T7's Extended Channels range provides extra AIN channels.

AIN Summary By Device

T4

 
Analog Inputs: 4 high-voltage (AIN0-AIN3)
  8 low-voltage (AIN4-AIN11)
Voltage Ranges: ±10V or 0-2.5V (Appendix A-3 and Appendix A-3-2)
Resolution: 12-bit
Max Data Rate: 40 ksamples/second in stream mode (Appendix A-1)
Sampling Modes: Single-ended
 

T7

 
Analog Inputs: 14 (AIN0-AIN13)
Voltage Ranges: ±10V, ±1V, ±0.1V, and ±0.01V (Appendix A-3 and Appendix A-3-2)
ADC Resolution: T7 = 16-bit
  T7-Pro = 16-bit and 24-bit
Effective Resolution: T7 = 16-bit to 19-bit
  T7-Pro = 16-bit and 22-bit
  At Gain 1x. For more details see Appendix A-3-1.
Max Data Rate: 100 ksamples/second in stream mode (Appendix A-1)
Sampling Modes: Configurable as single-ended or differential
Extended Channels: The number of analog inputs can be extended to 84 with a Mux80 (AIN48-AIN127).
 

Available AIN Channels

Each T-series device exposes:

  • Some AINs on the screw terminals.
  • Additional AINs on a connector (either a DB15 or a DB37).

T4

 
Figure 14.0-1 T4 Dedicated Analog Inputs
T4 Analog Inputs AIN (0-11)
Figure 14.0-2 T4 Flexible I/O
T4 Flexible I/O (FIO4-7, EIO0-3)

The LabJack T4 has up to 12 built-in analog inputs, readable as AIN0-AIN11:

  • AIN0-AIN3 are dedicated ±10 volt inputs:
    • Available on screw terminals AIN0-AIN3.
    • Always ±10 volt analog inputs.
  • AIN4-AIN7 are flexible 0 to +2.5 volt inputs:
    • Available on screw terminals FIO4-FIO7.
    • Configurable to be digital inputs/outputs.  See "Flexible I/O" below.
  • AIN8-AIN11 are flexible 0 to +2.5 volt inputs:
    • Available on the DB15 connector.
    • Configurable to be digital inputs/outputs. See "Flexible I/O" below.

T4 AIN Channel Registers
Name Start Address Type Access

AIN#(0:11)             Returns the voltage of the specified analog input.

0 FLOAT32 R

AIN#(0:11)_BINARY             Returns the 24-bit binary representation of the specified analog input. If you prefer 16-bit representation, simply divide this by 256. This is for command-response only. Stream always returns binary and LJM applies cal constants, so the LJM config flag LJM_STREAM_AIN_BINARY is used to get binary values.

50000 UINT32 R

T7

 
Figure 14.0-3 T7 Analog Inputs
T7 Analog Inputs AIN (0-13)

The LabJack T7 has 14 built-in analog inputs, readable as AIN0-13:

  • AIN0-AIN3 are available on the screw terminals and on the DB37 connector. See "Duplicated Terminals" below.
  • AIN4-AIN13 are available only on the DB37 connector.

T7 AIN Channel Registers
Name Start Address Type Access

AIN#(0:13)             Returns the voltage of the specified analog input.

0 FLOAT32 R

AIN#(0:13)_BINARY             Returns the 24-bit binary representation of the specified analog input. If you prefer 16-bit representation, simply divide this by 256. This is for command-response only. Stream always returns binary and LJM applies cal constants, so the LJM config flag LJM_STREAM_AIN_BINARY is used to get binary values.

50000 UINT32 R

In addition to the 14 built-in analog inputs, the T7 has special and extended channels.

    • AIN14 is internally connected to an internal temperature sensor.
    • AIN15 is internally connected to GND.  Useful for measuring noise or looking at offset error.
    • AIN16-AIN47 are optional extended channels that can be created with custom analog input muxing circuitry. See Section 14.2 Extended Channels for more information.
    • AIN48-AIN127 are extended channels that are available when using a Mux80.

T7 Extended AIN Channel Registers
Name Start Address Type Access

AIN#(48:127)             Returns the voltage of the specified analog input.

96 FLOAT32 R

AIN#(48:127)_BINARY             Returns the 24-bit binary representation of the specified analog input. If you prefer 16-bit representation, simply divide this by 256. This is for command-response only. Stream always returns binary and LJM applies cal constants, so the LJM config flag LJM_STREAM_AIN_BINARY is used to get binary values.

50096 UINT32 R

Example:

To read a voltage connected to AIN1, read AIN1 (address 2). The result will be in the form of a floating point number, like 8.82332V.

Resolution Index

A higher resolution index results in lower noise and higher effective resolution but increases sample times.

Resolution Index Registers
Name Start Address Type Access

AIN#(0:13)_RESOLUTION_INDEX             The resolution index for command-response and AIN-EF readings. A larger resolution index generally results in lower noise and longer sample times.

41500 UINT16 R/W

AIN_ALL_RESOLUTION_INDEX             The resolution index for command-response and AIN-EF readings. A larger resolution index generally results in lower noise and longer sample times. A write to this global parameter affects all AIN. A read will return the correct setting if all channels are set the same, but otherwise will return 0xFFFF.

43903 UINT16 R/W

STREAM_RESOLUTION_INDEX             The resolution index for stream readings. A larger resolution index generally results in lower noise and longer sample times.

4010 UINT32 R/W

Defaults:

Setting resolution index to 0 sets the default resolution index to:

  • 5 for command-response mode on a T4
  • 8 for command-response mode on a T7
  • 9 for command-response mode on a T7-Pro

Example:

To read AIN1 with resolution index 4:

    1. Set the AIN1 resolution index to 4 by writing 5 to AIN1_RESOLUTION_INDEX (address 41501)
    2. Read AIN1

Resolution index ranges:

  • T4 resolution index ranges from 0 to 5
  • T7 resolution index ranges from 0 to 8
  • T7-Pro resolution index ranges from 0 to 12
    • Settings 9-12 use the alternate high-resolution converter (24-bit sigma-delta)

Remarks:

AIN#(0:13)_RESOLUTION_INDEX and AIN_ALL_RESOLUTION_INDEX do not apply to stream mode, though they do apply to all command-response communications, including AIN EF.

For stream mode, use STREAM_RESOLUTION_INDEX to configure AIN resolution. See configuring AIN for stream for more information.

For typical noise levels and sample times at different combinations of resolution index and gain, see Appendix A-3-1 Noise and Resolution.

For general discussion on the meaning of resolution, see the Noise and Resolution App Note.

Flexible I/O - T4 Only

 

Flexible I/O are I/O ports that may be configured as analog inputs, or as digital inputs or outputs.

Flexible I/O Configuration
Name Start Address Type Access

DIO_INHIBIT             A single binary-encoded value where each bit determines whether _STATE, _DIRECTION or _ANALOG_ENABLE writes affect that bit of digital I/O.<br>0=Default=Affected,<br>1=Ignored.

2900 UINT32 R/W

DIO_ANALOG_ENABLE             Read or write the analog configuration of all digital I/O in a single binary-encoded value. 1=Analog mode and 0=Digital mode. When switching from analog to digital, the lines will be set to input. Writes are filtered by the value in DIO_INHIBIT.

2880 UINT32 R/W

AIN4-AIN11 are flexible I/O. To configure these channels as analog inputs:

  • Set the correct bit of DIO_INHIBIT to 0
  • Set the correct bit of DIO_ANALOG_ENABLE to 1

The bit to set of DIO_INHIBIT and of DIO_ANALOG_ENABLE is the same as the channel number. For example, to configure AIN4 (screw terminal FIO4) as an analog input:

  • Set bit 4 of DIO_INHIBIT to 0
  • Set bit 4 of DIO_ANALOG_ENABLE to 1

AIN0-AIN3 are dedicated analog inputs and cannot be configured as digital I/O.

Note that simply doing an analog read on AIN4-AIN11 automatically configures that line (FIO4-EIO3) as analog, so few people use the 2 registers mentioned above.  See "Flexible I/O Auto-Configuration" in Section 13.1 Flexible I/O.

Single-ended or Differential - T7 Only

 

Single-ended AIN readings are read with ground (GND) as a reference point. Differential readings use a second AIN as a reference point. For more, see the Differential Readings App Note.

Negative Channel Registers
Name Start Address Type Access

AIN#(0:13)_NEGATIVE_CH             Specifies the negative channel to be used for each positive channel. 199=Default=> Single-Ended.

41000 UINT16 R/W

AIN_ALL_NEGATIVE_CH             A write to this global parameter affects all AIN. Writing 1 will set all AINs to differential. Writing 199 will set all AINs to single-ended. A read will return 1 if all AINs are set to differential and 199 if all AINs are set to single-ended. If AIN configurations are not consistent 0xFFFF will be returned.

43902 UINT16 R/W

The AIN#(0:13)_NEGATIVE_CH and AIN_ALL_NEGATIVE_CH parameters configure whether the AIN performs differential vs. single-ended readings (not to be confused with bipolar and unipolar—the T7 is always bipolar).

When reading differential AINs, the positive AIN's configurations are used and the negative AIN's configurations are ignored. For example: when reading AIN0 with AIN0_NEGATIVE_CH is set to 1, the T7 will measure AIN0-AIN1 using the settings for AIN0 (such as AIN0_RESOLUTION_INDEX).

Example:

To take a differential reading on AIN2, set AIN3 as its negative channel (AIN2-AIN3):

    1. Write 3 to AIN2_NEGATIVE_CH (address 41002)
    2. Read AIN2

To read AIN2 single-ended again (AIN2-GND):

    1. Write 199 to AIN2_NEGATIVE_CH (address 41002)
    2. Read AIN2

User software or the Register Matrix in Kipling can be used to configure any analog input as differential, or the Analog Inputs tab in Kipling can be used to quickly set AIN0/2/4/6/8/10/12 to differential.

Testing:

Use 2 jumper wires to securely connect each analog inputs to VS or GND.  Using the default +/-10V range the readings should be as follows:

AINpos(VS) and AINneg(GND)  =>  5 volts
AINpos(GND) and AINneg(VS)  =>  -5 volts
AINpos(VS) and AINneg(VS)  =>  0 volts

Built-in AIN:

For AIN0 through AIN13, differential channels are adjacent even/odd pairs such that the positive channel is even and the negative channel is greater than the positive channel by 1. Odd channels, such as AIN3_NEGATIVE_CH (address 41003), should not be written to because only an even channel can have an associated negative channel.

Temperature and Ground:

AIN14 is the internal temperature sensor and AIN15 is GND. Neither can be read differentially.

Extended AIN:

For AIN16 and greater, the rules for pairing differential channels is different. See 14.2 Extended Channels or the Mux80 datasheet for more.

Range / Gain - T7 Only

 

T7 Internal Amplifier: The analog inputs are connected to a high-impedance instrumentation amplifier, as shown in Figure 4.2-2. This in-amp does the following:

  • Buffers the signal for the internal ADCs
  • Allows for single-ended or differential conversions
  • Provides gains of x1, x10, x100, and x1000 (corresponding to ranges of ±10V, ±1V, ±0.1V, and ±0.01V, respectively).

Range Registers
Name Start Address Type Access

AIN#(0:13)_RANGE             The range/span of each analog input. Write the highest expected input voltage.

40000 FLOAT32 R/W

AIN_ALL_RANGE             A write to this global parameter affects all AIN. A read will return the correct setting if all channels are set the same, but otherwise will return -9999.

43900 FLOAT32 R/W

Example:

If the voltage source connected to AIN1 has a known range of 0 to 0.7V, the appropriate range for AIN1 is the ±1V range. To read AIN1 with the ±1V range:

    1. Write 1.0 to AIN1_RANGE (address 40002)
    2. Read AIN1

The range registers (AIN#(0:13)_RANGE and AIN_ALL_RANGE) control the gain of the T7's internal instrumentation amplifier. The in-amp supports gains of x1, x10, x100, and x1000.

    • A range of 10 sets gain=x1 so that the analog input range is ±10 volts. This is the default range.
  • A range of 1 sets gain=x10 so that the analog input range is ±1 volts.
  • A range of 0.1 sets gain=x100 so that the analog input range is ±0.1 volts.
  • A range of 0.01 sets gain=x1000 so that the analog input range is ±0.01 volts.

Values written to RANGE are rounded up (except for values greater than 10.0, which are rounded down). For example, writing 0.5 to AIN_ALL_RANGE will set the analog input range to ±1 volts.

The T7 knows what the internal gain is set to and adjusts the return values to give the voltage at the input terminals, so if you connect a 0.8 volt signal to the input terminals, it will be amplified to 8.0 volts before being digitized, but the reading you get back will be 0.8 volts.

Settling

The settling registers set the time from a step change in the input signal to when the signal is sampled by the ADC, as measured in microseconds. A step change in this case is caused when the internal multiplexers change from one channel to another. In general, more settling time is required as gain and resolution are increased.

The value 0 sets automatic settling, which is recommended for most applications. This "auto" settling ensures that the device meets specifications at any gain and resolution for source impedance up to at least 1000 ohms.

Settling Registers
Name Start Address Type Access

AIN#(0:13)_SETTLING_US             Settling time for command-response and AIN-EF readings.

42000 FLOAT32 R/W

AIN_ALL_SETTLING_US             Settling time for command-response and AIN-EF readings. A write to this global parameter affects all AIN. A read will return the correct setting if all channels are set the same, but otherwise will return -9999. Max is 50,000 us.

43904 FLOAT32 R/W

STREAM_SETTLING_US             Time in microseconds to allow signals to settle after switching the mux. Does not apply to the 1st channel in the scan list, as that settling is controlled by scan rate (the time from the last channel until the start of the next scan). Default=0. When set to less than 1, automatic settling will be used. The automatic settling behavior varies by device.

4008 FLOAT32 R/W

Example:

To read AIN3 with a manual settling time of 500 µs:

    1. Write 500 to AIN3_SETTLING_US (address 42006)
    2. Read AIN3

Remarks:

AIN#(0:13)_SETTLING_US and AIN_ALL_SETTLING_US do not apply to stream mode, though they do apply to all command-response communications, including AIN EF.

For stream mode, use STREAM_SETTLING_US to configure AIN settling. See configuring AIN for stream for more information.

The timings in Appendix A are measured with "auto" settling.

See the Analog Input Settling Time (App Note) for more details.

Other Considerations

Streaming AIN: See 3.2 Stream Mode for streaming analog inputs. Some stream configurations override the normal AIN configurations:

  • Use STREAM_SETTLING_US instead of AIN_SETTLING_US.
  • Use STREAM_RESOLUTION_INDEX instead of AIN_RESOLUTION_INDEX.

Command-Response while Streaming: Command-response can be done while a stream is active, but streaming needs exclusive control of the analog input system, so analog inputs (including the internal temperature sensor) cannot be read via command-response while a stream is active.

Floating Inputs: The analog inputs are not artificially pulled to 0.0 volts, as that would reduce the input impedance, so readings obtained from floating channels will generally not be 0.0 volts. The readings from floating channels depend on adjacent channels and sample rate and have little meaning. See the floating input application note.

Connections: For information regarding typical analog input connections, please see the Analog Input App Note.

Address Step Size:

Addresses of the FLOAT32 type increment in steps of 2 because FLOAT32 uses two sets of 16-bits. FLOAT32 registers include AIN#, AIN#_RANGE, and AIN#_SETTLING_US.

Addresses of the UINT16 type increment in steps of 1 because UNIT16 uses only one set of 16-bits. UINT16 registers include AIN#_NEGATIVE_CH and AIN#_RESOLUTION_INDEX.

T7 Only: Duplicated Terminals (AIN0-AIN3):

 

AIN0-AIN3 appear on the built-in screw-terminals and also on the DB37 connector. Users should only connect to one or the other, not both at the same time.

To prevent damage due to accidental short circuit, both connection paths have their own series resistor. All AIN lines have a 2.2k series resistor, and in the case of AIN0-AIN3 the duplicated connections each have their own series resistor, so if you measure the resistance between the duplicate terminals you will see about 4.4k.

Calibration:

For command-response communication, analog input calibration is automatically applied by firmware and the AIN# registers return calibrated voltages. The AIN#_BINARY registers will return binary values from the converter.

For stream communication, the AIN# registers return raw binary values and calibration is automatically performed by LJM. For applications not using LJM, see the low-level Modbus streaming example.

Analog Input Channels Reference

Table 14.0-1 Analog Input Channel Overview

  Built-in Analog Inputs Extended Channels
AIN 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 AIN (48-127)
T4 AIN (0-3)
High-Voltage ±10V		 AIN (4-11)
Low-Voltage 0-2.5V		 N/A N/A
T7 AIN (0-13)
High-Voltage ±10V Options: SE/Diff, Gains (1000x, 100x, 10x, 1)		 Special
Channels		 AIN (48-127)
Mux80

Copyright © 2001-2099 LabJack Corporation. All rights reserved. 

Privacy Policy