« Close

Datasheets and User Guides

Software & Driver


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    

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    

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    

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    

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