Functions | |
void | AUXADCDisable (void) |
Disables the ADC. More... | |
void | AUXADCEnableAsync (uint32_t refSource, uint32_t trigger) |
Enables the ADC for asynchronous operation. More... | |
void | AUXADCEnableSync (uint32_t refSource, uint32_t sampleTime, uint32_t trigger) |
Enables the ADC for synchronous operation. More... | |
void | AUXADCDisableInputScaling (void) |
Disables scaling of the ADC input. More... | |
void | AUXADCFlushFifo (void) |
Flushes the ADC FIFO. More... | |
static void | AUXADCGenManualTrigger (void) |
Generates a single manual ADC trigger. More... | |
static uint32_t | AUXADCGetFifoStatus (void) |
Returns flags indicating the status of the ADC FIFO. More... | |
uint32_t | AUXADCReadFifo (void) |
Waits for and returns the first sample in the ADC FIFO. More... | |
uint32_t | AUXADCPopFifo (void) |
Returns the first sample in the ADC FIFO, without waiting. More... | |
static void | AUXADCSelectInput (uint32_t input) |
Selects internal or external input for the ADC. More... | |
int32_t | AUXADCGetAdjustmentGain (uint32_t refSource) |
Returns the gain value used when adjusting for ADC gain/offset. More... | |
int32_t | AUXADCGetAdjustmentOffset (uint32_t refSource) |
Returns the offset value used when adjusting for ADC gain/offset. More... | |
int32_t | AUXADCValueToMicrovolts (int32_t fixedRefVoltage, int32_t adcValue) |
Converts an "adjusted" ADC value to microvolts. More... | |
int32_t | AUXADCMicrovoltsToValue (int32_t fixedRefVoltage, int32_t microvolts) |
Converts a number of microvolts to corresponding "adjusted" ADC value. More... | |
int32_t | AUXADCAdjustValueForGainAndOffset (int32_t adcValue, int32_t gain, int32_t offset) |
Performs ADC value gain and offset adjustment. More... | |
int32_t | AUXADCUnadjustValueForGainAndOffset (int32_t adcValue, int32_t gain, int32_t offset) |
Performs the inverse of the ADC value gain and offset adjustment. More... | |
int32_t AUXADCAdjustValueForGainAndOffset | ( | int32_t | adcValue, |
int32_t | gain, | ||
int32_t | offset | ||
) |
Performs ADC value gain and offset adjustment.
This function takes a measured ADC value compensates for the internal gain and offset in the ADC.
adcValue | 12-bit ADC unadjusted value |
gain | Gain adjustment value provided by AUXADCGetAdjustmentGain() |
offset | Offset adjustment value provided by AUXADCGetAdjustmentOffset() |
void AUXADCDisable | ( | void | ) |
Disables the ADC.
This function must be called:
void AUXADCDisableInputScaling | ( | void | ) |
Disables scaling of the ADC input.
By default, the ADC operates internally on a version of the input signal that has been scaled down by a factor 1408 / 4095
. This function disables that scaling, allowing for a trade-off between dynamic range and and resolution.
void AUXADCEnableAsync | ( | uint32_t | refSource, |
uint32_t | trigger | ||
) |
Enables the ADC for asynchronous operation.
In asynchronous operation, the ADC samples continuously between conversions.
The ADC trigger starts the conversion. Note that the first conversion may be invalid if the sampling period is too short.
ADC input scaling is enabled by default after device reset, and is also re- enabled by AUXADCDisable(). To disable input scaling, call AUXADCDisableInputScaling() before calling AUXADCEnableAsync().
refSource | ADC reference source:
|
trigger | ADC conversion trigger: |
void AUXADCEnableSync | ( | uint32_t | refSource, |
uint32_t | sampleTime, | ||
uint32_t | trigger | ||
) |
Enables the ADC for synchronous operation.
In synchronous operation, the ADC is idle between a conversion and subsequent samplings.
The ADC trigger starts sampling with specified duration, followed by the conversion. Note that the first conversion may be invalid if the initial sampling period is too short.
ADC input scaling is enabled by default after device reset, and is also re- enabled by AUXADCDisable(). To disable input scaling, call AUXADCDisableInputScaling() before calling AUXADCEnableSync().
refSource | ADC reference source:
|
sampleTime | ADC sampling time:
|
trigger | ADC conversion trigger: |
void AUXADCFlushFifo | ( | void | ) |
Flushes the ADC FIFO.
This empties the FIFO and clears the underflow/overflow flags.
Note: This function must only be called while the ADC is enabled.
|
inlinestatic |
Generates a single manual ADC trigger.
For synchronous mode, the trigger starts sampling followed by conversion. For asynchronous mode, the trigger starts conversion.
int32_t AUXADCGetAdjustmentGain | ( | uint32_t | refSource | ) |
Returns the gain value used when adjusting for ADC gain/offset.
The function returns the gain value to be used with AUXADCAdjustValueForGainAndOffset() or AUXADCUnadjustValueForGainAndOffset(). The gain value is found during chip manufacturing and is stored in the factory configuration, FCFG1.
refSource | ADC reference source:
|
int32_t AUXADCGetAdjustmentOffset | ( | uint32_t | refSource | ) |
Returns the offset value used when adjusting for ADC gain/offset.
The function returns the offset value to be used with AUXADCAdjustValueForGainAndOffset() or AUXADCUnadjustValueForGainAndOffset(). The offset value is found during chip manufacturing and is stored in the factory configuration, FCFG1.
refSource | ADC reference source:
|
|
inlinestatic |
Returns flags indicating the status of the ADC FIFO.
The flags indicate FIFO empty, full and almost full, and whether overflow/underflow has occurred.
int32_t AUXADCMicrovoltsToValue | ( | int32_t | fixedRefVoltage, |
int32_t | microvolts | ||
) |
Converts a number of microvolts to corresponding "adjusted" ADC value.
This function can only be used when measuring with fixed ADC reference (AUXADC_REF_FIXED). The specified reference voltage accounts for whether the sampled ADC input is scaled down before conversion or not.
fixedRefVoltage | Fixed reference voltage, in microvolts
|
microvolts | The number of microvolts |
uint32_t AUXADCPopFifo | ( | void | ) |
Returns the first sample in the ADC FIFO, without waiting.
This function does not wait, and must only be called when there is at least one sample in the ADC FIFO. Otherwise the call will generate FIFO underflow (AUXADC_FIFO_UNDERFLOW_M).
uint32_t AUXADCReadFifo | ( | void | ) |
Waits for and returns the first sample in the ADC FIFO.
This function waits until there is at least one sample in the ADC FIFO. It then pops and returns the first sample from the FIFO.
|
inlinestatic |
Selects internal or external input for the ADC.
Note that calling this function also selects the same input for AUX_COMPB.
input | Internal/external input selection: |
int32_t AUXADCUnadjustValueForGainAndOffset | ( | int32_t | adcValue, |
int32_t | gain, | ||
int32_t | offset | ||
) |
Performs the inverse of the ADC value gain and offset adjustment.
This function finds the expected measured ADC value, without gain and offset compensation, for a given "ideal" ADC value. The function can for example be used to find ADC value thresholds to be used in Sensor Controller task configurations.
adcValue | 12-bit ADC adjusted value |
gain | Gain adjustment value provided by AUXADCGetAdjustmentGain() |
offset | Offset adjustment value provided by AUXADCGetAdjustmentOffset() |
int32_t AUXADCValueToMicrovolts | ( | int32_t | fixedRefVoltage, |
int32_t | adcValue | ||
) |
Converts an "adjusted" ADC value to microvolts.
This function can only be used when measuring with fixed ADC reference (AUXADC_REF_FIXED). The specified reference voltage accounts for whether the sampled ADC input is scaled down before conversion or not.
fixedRefVoltage | Fixed reference voltage, in microvolts
|
adcValue | The ADC value |
#define AUXADC_FIFO_ALMOST_FULL_M (AUX_ANAIF_ADCFIFOSTAT_ALMOST_FULL_M) |
#define AUXADC_FIFO_EMPTY_M (AUX_ANAIF_ADCFIFOSTAT_EMPTY_M) |
#define AUXADC_FIFO_FULL_M (AUX_ANAIF_ADCFIFOSTAT_FULL_M) |
#define AUXADC_FIFO_OVERFLOW_M (AUX_ANAIF_ADCFIFOSTAT_OVERFLOW_M) |
#define AUXADC_FIFO_UNDERFLOW_M (AUX_ANAIF_ADCFIFOSTAT_UNDERFLOW_M) |
#define AUXADC_FIXED_REF_VOLTAGE_NORMAL 4300000 |
#define AUXADC_FIXED_REF_VOLTAGE_UNSCALED 1478500 |
#define AUXADC_REF_FIXED (0 << ADI_4_AUX_ADCREF0_SRC_S) |
Referenced by AUXADCGetAdjustmentGain(), and AUXADCGetAdjustmentOffset().
#define AUXADC_REF_VDDS_REL (1 << ADI_4_AUX_ADCREF0_SRC_S) |
#define AUXADC_SAMPLE_TIME_10P6_US 5 |
#define AUXADC_SAMPLE_TIME_10P9_MS 15 |
#define AUXADC_SAMPLE_TIME_170_US 9 |
#define AUXADC_SAMPLE_TIME_1P37_MS 12 |
#define AUXADC_SAMPLE_TIME_21P3_US 6 |
Referenced by AUXADCEnableSync().
#define AUXADC_SAMPLE_TIME_2P73_MS 13 |
#define AUXADC_SAMPLE_TIME_2P7_US 3 |
#define AUXADC_SAMPLE_TIME_341_US 10 |
#define AUXADC_SAMPLE_TIME_42P6_US 7 |
#define AUXADC_SAMPLE_TIME_5P3_US 4 |
#define AUXADC_SAMPLE_TIME_5P46_MS 14 |
#define AUXADC_SAMPLE_TIME_682_US 11 |
#define AUXADC_SAMPLE_TIME_85P3_US 8 |
#define AUXADC_TRIGGER_GPT0A (EVENT_AUXSEL0_EV_GPT0A) |
#define AUXADC_TRIGGER_GPT0B (EVENT_AUXSEL0_EV_GPT0B) |
#define AUXADC_TRIGGER_GPT1A (EVENT_AUXSEL0_EV_GPT1A) |
#define AUXADC_TRIGGER_GPT1B (EVENT_AUXSEL0_EV_GPT1B) |
#define AUXADC_TRIGGER_GPT2A (EVENT_AUXSEL0_EV_GPT2A) |
#define AUXADC_TRIGGER_GPT2B (EVENT_AUXSEL0_EV_GPT2B) |
#define AUXADC_TRIGGER_GPT3A (EVENT_AUXSEL0_EV_GPT3A) |
#define AUXADC_TRIGGER_GPT3B (EVENT_AUXSEL0_EV_GPT3B) |
#define AUXADC_TRIGGER_MANUAL (EVENT_AUXSEL0_EV_NONE) |
Referenced by AUXADCEnableAsync(), and AUXADCEnableSync().