14.1 AIN Extended Features [T-Series Datasheet]
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, Configuring & Reading a Thermocouple.
Subsections
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 | Performs Stream Internally? |
|---|---|---|---|
0: | None (disabled) | All T-series | - |
1: | All T-series | - | |
3: | All T-series | Yes | |
4: | All T-series | - | |
5: | All T-series | Yes | |
10: | RMS Flex | All T-series | Yes |
11: | RMS Auto | All T-series | Yes |
20: | Thermocouple type E | T7/T8 | - |
21: | Thermocouple type J | T7/T8 | - |
22: | Thermocouple type K | T7/T8 | - |
23: | Thermocouple type R | T7/T8 | - |
24: | Thermocouple type T | T7/T8 | - |
25: | Thermocouple type S | T7/T8 | - |
27: | Thermocouple type N | T7/T8 | - |
28: | Thermocouple type B | T7/T8 | - |
30: | Thermocouple type C | T7/T8 | - |
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:
Set the EF_INDEX to select an extended feature
Configure the extended feature using the EF_CONFIG registers
Configure normal AIN configurations through the normal AIN registers. For AIN-EF modes that perform stream internally, configure AIN for stream.
Read from READ_A to perform the extended feature operation
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.
Set the AIN#_EF_INDEX to select an extended feature
Write to AIN#(0:14)_EF_INDEX or AIN_ALL_EF_INDEX to select the AIN extended feature.
Configure the extended feature using the AIN#_EF_CONFIG registers
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.
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.
AIN-EF modes that perform stream internally may need to configure AIN for stream.
Read from AIN#_EF_READ_A to perform the extended feature operation
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.
Read additional results B, C, and D
Reading from result registers other than AIN#_EF_READ_A will read the saved values and will not initiate a new reading.