Functions
static uint32_t	ADC12_GetInstance (ADC_Type *base)
	Get instance number for ADC12 module.

static status_t	ADC12_GetCalibrationStatus (ADC_Type *base)
	Check calibration failed status.

void	ADC12_Init (ADC_Type base, const adc12_config_t config)
	Initialize the ADC12 module.

void	ADC12_Deinit (ADC_Type *base)
	De-initialize the ADC12 module.

void	ADC12_GetDefaultConfig (adc12_config_t *config)
	Gets an available pre-defined settings for converter's configuration.

void	ADC12_SetChannelConfig (ADC_Type base, uint32_t channelGroup, const adc12_channel_config_t config)
	Configure the conversion channel.

uint32_t	ADC12_GetChannelStatusFlags (ADC_Type *base, uint32_t channelGroup)
	Get the status flags of channel.

status_t	ADC12_DoAutoCalibration (ADC_Type *base)
	Automate the hardware calibration.

void	ADC12_SetHardwareCompareConfig (ADC_Type base, const adc12_hardware_compare_config_t config)
	Configure the hardware compare mode.

void	ADC12_SetHardwareAverage (ADC_Type *base, adc12_hardware_average_mode_t mode)
	Set the hardware average mode.

uint32_t	ADC12_GetStatusFlags (ADC_Type *base)
	Get the status flags of the converter.

Variables
static ADC_Type *const	s_adc12Bases [] = ADC_BASE_PTRS
	Pointers to ADC12 bases for each instance.

static const clock_ip_name_t	s_adc12Clocks [] = ADC12_CLOCKS
	Pointers to ADC12 clocks for each instance.

Function Documentation

◆ ADC12_GetCalibrationStatus()

static status_t ADC12_GetCalibrationStatus ( ADC_Type * base )

static

Check calibration failed status.

Check if the calibration is failed by comparing the calibration result value with its limit range.

Each calibration result value's limit range is: Symbol Min Typ Max
OFS -48 -8 22 CLP9 -12 4 20 CLPX -16 0 16 CLPS 30 72 120 CLP0 CLPS-14 CLPS CLPS+14 CLP1 Typ1-16 Typ1=CLP0+CLP0 Typ1+16 CLP2 Typ2-20 Typ2=CLP1+CLP1-26 Typ2+20 CLP3 Typ3-36 Typ3=CLP2+CLP2 Typ3+36
To get the accurate calibration value, following conditions should be met. 1). Enable hardware average and set average number to 32. 2). No parallel calibration of ADCs because they will disturb each other. 2). For VREFH pin on PCB, use 3 bypass capacitance in the range: 1uF, 100nF and 1nF and place them as close as possible to the VREFH pin.
Parameters

base ADC12 peripheral base address.

Return values

kStatus_Success Calibration is done successfully.

kStatus_Fail Calibration is failed.

Definition at line 92 of file fsl_adc12.c.

{
    /* Get raw calibration result. OFS, CLP9, CLPX are signed number. The highest position bit is the signal bit.
    Other calibration value registers are unsigned number. */
    int32_t OFS = (int32_t)((base->OFS & ADC_OFS_OFS_MASK) >> ADC_OFS_OFS_SHIFT);
    int32_t CLP9 = (int32_t)((base->CLP9 & ADC_CLP9_CLP9_MASK) >> ADC_CLP9_CLP9_SHIFT);
    int32_t CLPX = (int32_t)((base->CLPX & ADC_CLPX_CLPX_MASK) >> ADC_CLPX_CLPX_SHIFT);
    uint32_t CLPS = ((base->CLPS & ADC_CLPS_CLPS_MASK) >> ADC_CLPS_CLPS_SHIFT);
    uint32_t CLP0 = ((base->CLP0 & ADC_CLP0_CLP0_MASK) >> ADC_CLP0_CLP0_SHIFT);
    uint32_t CLP1 = ((base->CLP1 & ADC_CLP1_CLP1_MASK) >> ADC_CLP1_CLP1_SHIFT);
    uint32_t CLP2 = ((base->CLP2 & ADC_CLP2_CLP2_MASK) >> ADC_CLP2_CLP2_SHIFT);
    uint32_t CLP3 = ((base->CLP3 & ADC_CLP3_CLP3_MASK) >> ADC_CLP3_CLP3_SHIFT);
    uint32_t Typ1 = (CLP0 + CLP0);
    uint32_t Typ2 = (CLP1 + CLP1 - 26U);
    uint32_t Typ3 = (CLP2 + CLP2);
    status_t error = kStatus_Success;
 
    /* Transform raw calibration result to unified type int32_t when the conversion result value is signed number. */
    OFS = ADC12_TRANSFORM_CALIBRATION_RESULT(OFS, 16);
    CLP9 = ADC12_TRANSFORM_CALIBRATION_RESULT(CLP9, 7);
    CLPX = ADC12_TRANSFORM_CALIBRATION_RESULT(CLPX, 7);
 
    /* Check the calibration result value with its limit range. */
 
    if ((OFS < -48) || (OFS > 22) || (CLP9 < -12) || (CLP9 > 20) || (CLPX < -16) || (CLPX > 16) || (CLPS < 30U) ||
        (CLPS > 120U) || (CLP0 < (CLPS - 14U)) || (CLP0 > (CLPS + 14U)) || (CLP1 < (Typ1 - 16U)) ||
        (CLP1 > (Typ1 + 16U)) || (CLP2 < (Typ2 - 20U)) || (CLP2 > (Typ2 + 20U)) || (CLP3 < (Typ3 - 36U)) ||
        (CLP3 > (Typ3 + 36U)))
    {
        error = kStatus_Fail;
    }
 
    return error;
}

Referenced by ADC12_GetStatusFlags().

Here is the caller graph for this function:

◆ ADC12_GetInstance()

static uint32_t ADC12_GetInstance ( ADC_Type * base )

static

Get instance number for ADC12 module.

Parameters

base	ADC12 peripheral base address

Definition at line 74 of file fsl_adc12.c.

{
    uint32_t instance;
 
    /* Find the instance index from base address mappings. */
    for (instance = 0; instance < ARRAY_SIZE(s_adc12Bases); instance++)
    {
        if (s_adc12Bases[instance] == base)
        {
            break;
        }
    }
 
    assert(instance < ARRAY_SIZE(s_adc12Bases));
 
    return instance;
}