« Close

Datasheets and User Guides

Software & Driver

 
Table of Contents

14.1 AIN Extended Features [T-Series Datasheet]

AIN Extended Features Overview

Analog Extended Features (AIN-EF) simplify some common analog input applications. Each AIN-EF feature:

  • collects one or more input samples
  • performs math on the collected samples

AIN-EF is only supported in command-response mode and not in stream mode.

Kipling Walkthrough: Kipling's Register Matrix can be used to perform AIN-EF features. For example:

Available AIN Extended Features

For any given AIN channel, one AIN-EF feature may be selected. AIN-EF indices:

Index  AIN-EF Name Supported Devices
0: None (disabled) All T-series
1: Offset and Slope All T-series
3: Max, Min, Avg All T-series
4: Resistance All T-series
5: Average and Threshold All T-series
10: RMS Flex All T-series
11: RMS Auto All T-series
20: Thermocouple type E T7 only
21: Thermocouple type J T7 only
22: Thermocouple type K T7 only
23: Thermocouple type R T7 only
24: Thermocouple type T T7 only
25: Thermocouple type S T7 only
30: Thermocouple type C T7 only
40: RTD PT100 All T-series
41: RTD PT500 All T-series
42: RTD PT1000 All T-series
50: Thermistor using Steinhart-Hart equation All T-series
51: Thermistor using Beta equation All T-series

AIN-EF Usage

To use any AIN-EF:

  1. Set the EF_INDEX to select an extended feature
  2. Configure the extended feature using the EF_CONFIG registers
  3. Configure normal AIN configurations through the normal AIN registers
  4. Read from READ_A to perform the extended feature operation
  5. Read additional results from B, C, and D

For a quick example of setting up an AIN-EF in thermocouple mode, see Configuring & Reading a Thermocouple.

1. Set the AIN#_EF_INDEX to select an extended feature

Name Start Address Type Access
AIN#(0:13)_EF_INDEX 9000 UINT32 R/W
AIN_ALL_EF_INDEX 43906 UINT32 R/W
AIN#(0:13)_EF_INDEX
- Starting Address: 9000
Specify the desired extended feature for this analog input with the index value. List of index values: 0=None(disabled); 1=Offset and Slope; 3=Max/Min/Avg; 4=Resistance; 5=Average and Threshold; 10=RMS Flex; 11=FlexRMS; 20=Thermocouple type E; 21=Thermocouple type J; 22=Thermocouple type K; 23=Thermocouple type R; 24=Thermocouple type T; 25=Thermocouple type S; 30=Thermocouple type C; 40=RTD model PT100; 41=RTD model PT500; 42=RTD model PT1000.
  • Data type: UINT32  (type index = 1)
  • Readable and writable
  • Default value: 0
  • This register uses system RAM. The maximum RAM is 64KB. For more information, see 4.4 RAM
  • T7:
  • T4:
    • The T4 does not support thermocouple modes.
Expanded Names Addresses
AIN0_EF_INDEX, AIN1_EF_INDEX, AIN2_EF_INDEX, AIN3_EF_INDEX, AIN4_EF_INDEX, AIN5_EF_INDEX, AIN6_EF_INDEX, AIN7_EF_INDEX, AIN8_EF_INDEX, AIN9_EF_INDEX, AIN10_EF_INDEX, AIN11_EF_INDEX, AIN12_EF_INDEX, AIN13_EF_INDEX Show All 9000, 9002, 9004, 9006, 9008, 9010, 9012, 9014, 9016, 9018, 9020, 9022, 9024, 9026 Show All
AIN_ALL_EF_INDEX
- Address: 43906
Write 0 to deactivate AIN_EF on all AINs. No other values may be written to this register. Reads will return the AIN_EF index if all 128 AINs are set to the same value. If values are not the same returns 0xFFFF (65535).
  • Data type: UINT32  (type index = 1)
  • Readable and writable
  • Default value: 0
  • T7:
  • T4:
    • The T4 does not support thermocouple modes.

Write to AIN#(0:14)_EF_INDEX or AIN_ALL_EF_INDEX to select the AIN extended feature. 

2. Configure the extended feature using the AIN#_EF_CONFIG registers

Name Start Address Type Access
AIN#(0:13)_EF_CONFIG_A 9300 UINT32 R/W
AIN#(0:13)_EF_CONFIG_B 9600 UINT32 R/W
AIN#(0:13)_EF_CONFIG_C 9900 UINT32 R/W
AIN#(0:13)_EF_CONFIG_D 10200 FLOAT32 R/W
AIN#(0:13)_EF_CONFIG_E 10500 FLOAT32 R/W
AIN#(0:13)_EF_CONFIG_F 10800 FLOAT32 R/W
AIN#(0:13)_EF_CONFIG_G 11100 FLOAT32 R/W
AIN#(0:13)_EF_CONFIG_A
- Starting Address: 9300
Function dependent on selected feature index.
  • Data type: UINT32  (type index = 1)
  • Readable and writable
  • Default value: 0
  • T7:
Expanded Names Addresses
AIN0_EF_CONFIG_A, AIN1_EF_CONFIG_A, AIN2_EF_CONFIG_A, AIN3_EF_CONFIG_A, AIN4_EF_CONFIG_A, AIN5_EF_CONFIG_A, AIN6_EF_CONFIG_A, AIN7_EF_CONFIG_A, AIN8_EF_CONFIG_A, AIN9_EF_CONFIG_A, AIN10_EF_CONFIG_A, AIN11_EF_CONFIG_A, AIN12_EF_CONFIG_A, AIN13_EF_CONFIG_A Show All 9300, 9302, 9304, 9306, 9308, 9310, 9312, 9314, 9316, 9318, 9320, 9322, 9324, 9326 Show All
AIN#(0:13)_EF_CONFIG_B
- Starting Address: 9600
Function dependent on selected feature index.
  • Data type: UINT32  (type index = 1)
  • Readable and writable
  • Default value: 0
  • T7:
Expanded Names Addresses
AIN0_EF_CONFIG_B, AIN1_EF_CONFIG_B, AIN2_EF_CONFIG_B, AIN3_EF_CONFIG_B, AIN4_EF_CONFIG_B, AIN5_EF_CONFIG_B, AIN6_EF_CONFIG_B, AIN7_EF_CONFIG_B, AIN8_EF_CONFIG_B, AIN9_EF_CONFIG_B, AIN10_EF_CONFIG_B, AIN11_EF_CONFIG_B, AIN12_EF_CONFIG_B, AIN13_EF_CONFIG_B Show All 9600, 9602, 9604, 9606, 9608, 9610, 9612, 9614, 9616, 9618, 9620, 9622, 9624, 9626 Show All
AIN#(0:13)_EF_CONFIG_C
- Starting Address: 9900
Function dependent on selected feature index.
  • Data type: UINT32  (type index = 1)
  • Readable and writable
  • Default value: 0
  • T7:
Expanded Names Addresses
AIN0_EF_CONFIG_C, AIN1_EF_CONFIG_C, AIN2_EF_CONFIG_C, AIN3_EF_CONFIG_C, AIN4_EF_CONFIG_C, AIN5_EF_CONFIG_C, AIN6_EF_CONFIG_C, AIN7_EF_CONFIG_C, AIN8_EF_CONFIG_C, AIN9_EF_CONFIG_C, AIN10_EF_CONFIG_C, AIN11_EF_CONFIG_C, AIN12_EF_CONFIG_C, AIN13_EF_CONFIG_C Show All 9900, 9902, 9904, 9906, 9908, 9910, 9912, 9914, 9916, 9918, 9920, 9922, 9924, 9926 Show All
AIN#(0:13)_EF_CONFIG_D
- Starting Address: 10200
Function dependent on selected feature index.
  • Data type: FLOAT32  (type index = 3)
  • Readable and writable
  • Default value: 0
  • T7:
Expanded Names Addresses
AIN0_EF_CONFIG_D, AIN1_EF_CONFIG_D, AIN2_EF_CONFIG_D, AIN3_EF_CONFIG_D, AIN4_EF_CONFIG_D, AIN5_EF_CONFIG_D, AIN6_EF_CONFIG_D, AIN7_EF_CONFIG_D, AIN8_EF_CONFIG_D, AIN9_EF_CONFIG_D, AIN10_EF_CONFIG_D, AIN11_EF_CONFIG_D, AIN12_EF_CONFIG_D, AIN13_EF_CONFIG_D Show All 10200, 10202, 10204, 10206, 10208, 10210, 10212, 10214, 10216, 10218, 10220, 10222, 10224, 10226 Show All
AIN#(0:13)_EF_CONFIG_E
- Starting Address: 10500
Function dependent on selected feature index.
  • Data type: FLOAT32  (type index = 3)
  • Readable and writable
  • Default value: 0
  • T7:
Expanded Names Addresses
AIN0_EF_CONFIG_E, AIN1_EF_CONFIG_E, AIN2_EF_CONFIG_E, AIN3_EF_CONFIG_E, AIN4_EF_CONFIG_E, AIN5_EF_CONFIG_E, AIN6_EF_CONFIG_E, AIN7_EF_CONFIG_E, AIN8_EF_CONFIG_E, AIN9_EF_CONFIG_E, AIN10_EF_CONFIG_E, AIN11_EF_CONFIG_E, AIN12_EF_CONFIG_E, AIN13_EF_CONFIG_E Show All 10500, 10502, 10504, 10506, 10508, 10510, 10512, 10514, 10516, 10518, 10520, 10522, 10524, 10526 Show All
AIN#(0:13)_EF_CONFIG_F
- Starting Address: 10800
Function dependent on selected feature index.
  • Data type: FLOAT32  (type index = 3)
  • Readable and writable
  • Default value: 0
  • T7:
Expanded Names Addresses
AIN0_EF_CONFIG_F, AIN1_EF_CONFIG_F, AIN2_EF_CONFIG_F, AIN3_EF_CONFIG_F, AIN4_EF_CONFIG_F, AIN5_EF_CONFIG_F, AIN6_EF_CONFIG_F, AIN7_EF_CONFIG_F, AIN8_EF_CONFIG_F, AIN9_EF_CONFIG_F, AIN10_EF_CONFIG_F, AIN11_EF_CONFIG_F, AIN12_EF_CONFIG_F, AIN13_EF_CONFIG_F Show All 10800, 10802, 10804, 10806, 10808, 10810, 10812, 10814, 10816, 10818, 10820, 10822, 10824, 10826 Show All
AIN#(0:13)_EF_CONFIG_G
- Starting Address: 11100
Function dependent on selected feature index.
  • Data type: FLOAT32  (type index = 3)
  • Readable and writable
  • Default value: 0
  • T7:
Expanded Names Addresses
AIN0_EF_CONFIG_G, AIN1_EF_CONFIG_G, AIN2_EF_CONFIG_G, AIN3_EF_CONFIG_G, AIN4_EF_CONFIG_G, AIN5_EF_CONFIG_G, AIN6_EF_CONFIG_G, AIN7_EF_CONFIG_G, AIN8_EF_CONFIG_G, AIN9_EF_CONFIG_G, AIN10_EF_CONFIG_G, AIN11_EF_CONFIG_G, AIN12_EF_CONFIG_G, AIN13_EF_CONFIG_G Show All 11100, 11102, 11104, 11106, 11108, 11110, 11112, 11114, 11116, 11118, 11120, 11122, 11124, 11126 Show All

Each AIN-EF index requires different configuration parameters, so the meaning of the AIN#_EF_CONFIG registers depend on which AIN#_EF_INDEX is set.

3. Configure normal AIN configurations through the normal AIN registers

Analog input range, resolution, settling, and negative channel settings are configured through the normal AIN registers.

4. Read from AIN#_EF_READ_A to perform the extended feature operation

Name Start Address Type Access
AIN#(0:13)_EF_READ_A 7000 FLOAT32 R
AIN#(0:13)_EF_READ_A
- Starting Address: 7000
Function dependent on selected feature index.
  • Data type: FLOAT32  (type index = 3)
  • Read-only
  • Default value: 0
  • This register uses system RAM. The maximum RAM is 64KB. For more information, see 4.4 RAM
  • T7:
Expanded Names Addresses
AIN0_EF_READ_A, AIN1_EF_READ_A, AIN2_EF_READ_A, AIN3_EF_READ_A, AIN4_EF_READ_A, AIN5_EF_READ_A, AIN6_EF_READ_A, AIN7_EF_READ_A, AIN8_EF_READ_A, AIN9_EF_READ_A, AIN10_EF_READ_A, AIN11_EF_READ_A, AIN12_EF_READ_A, AIN13_EF_READ_A Show All 7000, 7002, 7004, 7006, 7008, 7010, 7012, 7014, 7016, 7018, 7020, 7022, 7024, 7026 Show All

Only reading AIN#_EF_READ_A will trigger the selected AIN-EF operation. The AIN#_EF_READ_A result is returned. Additional results are saved for later retrieval.

If the AIN-EF index uses stream-burst, reading AIN#_EF_READ_A will block for the length of time it takes to collect the necessary samples.

5. Read additional results B, C, and D

Name Start Address Type Access
AIN#(0:13)_EF_READ_B 7300 FLOAT32 R/W
AIN#(0:13)_EF_READ_C 7600 FLOAT32 R/W
AIN#(0:13)_EF_READ_D 7900 FLOAT32 R
AIN#(0:13)_EF_READ_B
- Starting Address: 7300
Function dependent on selected feature index.
  • Data type: FLOAT32  (type index = 3)
  • Readable and writable
  • Default value: 0
  • T7:
Expanded Names Addresses
AIN0_EF_READ_B, AIN1_EF_READ_B, AIN2_EF_READ_B, AIN3_EF_READ_B, AIN4_EF_READ_B, AIN5_EF_READ_B, AIN6_EF_READ_B, AIN7_EF_READ_B, AIN8_EF_READ_B, AIN9_EF_READ_B, AIN10_EF_READ_B, AIN11_EF_READ_B, AIN12_EF_READ_B, AIN13_EF_READ_B Show All 7300, 7302, 7304, 7306, 7308, 7310, 7312, 7314, 7316, 7318, 7320, 7322, 7324, 7326 Show All
AIN#(0:13)_EF_READ_C
- Starting Address: 7600
Function dependent on selected feature index.
  • Data type: FLOAT32  (type index = 3)
  • Readable and writable
  • Default value: 0
  • T7:
Expanded Names Addresses
AIN0_EF_READ_C, AIN1_EF_READ_C, AIN2_EF_READ_C, AIN3_EF_READ_C, AIN4_EF_READ_C, AIN5_EF_READ_C, AIN6_EF_READ_C, AIN7_EF_READ_C, AIN8_EF_READ_C, AIN9_EF_READ_C, AIN10_EF_READ_C, AIN11_EF_READ_C, AIN12_EF_READ_C, AIN13_EF_READ_C Show All 7600, 7602, 7604, 7606, 7608, 7610, 7612, 7614, 7616, 7618, 7620, 7622, 7624, 7626 Show All
AIN#(0:13)_EF_READ_D
- Starting Address: 7900
Function dependent on selected feature index.
  • Data type: FLOAT32  (type index = 3)
  • Read-only
  • Default value: 0
  • T7:
Expanded Names Addresses
AIN0_EF_READ_D, AIN1_EF_READ_D, AIN2_EF_READ_D, AIN3_EF_READ_D, AIN4_EF_READ_D, AIN5_EF_READ_D, AIN6_EF_READ_D, AIN7_EF_READ_D, AIN8_EF_READ_D, AIN9_EF_READ_D, AIN10_EF_READ_D, AIN11_EF_READ_D, AIN12_EF_READ_D, AIN13_EF_READ_D Show All 7900, 7902, 7904, 7906, 7908, 7910, 7912, 7914, 7916, 7918, 7920, 7922, 7924, 7926 Show All

Reading from result registers other than AIN#_EF_READ_A will read the saved values and will not initiate a new reading.

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

Privacy Policy