Analog-to-digital Converter (ADC)

See Quickstart guide for SAM ADC driver. More...

Topics
	Legacy ADC group alias

Macros
#define	ADC_WPMR_WPKEY_PASSWD   ADC_WPMR_WPKEY(0x414443u)

Functions
void	adc_check (Adc *p_adc, const uint32_t ul_mck)
	Check ADC configurations.
void	adc_configure_power_save (Adc *p_adc, const uint8_t uc_sleep, const uint8_t uc_fwup)
	Configures ADC power saving mode.
void	adc_configure_sequence (Adc *p_adc, const enum adc_channel_num_t ch_list[], uint8_t uc_num)
	Configure conversion sequence.
void	adc_configure_timing (Adc *p_adc, const uint8_t uc_tracking, const enum adc_settling_time_t settling, const uint8_t uc_transfer)
	Configure ADC timing.
void	adc_configure_trigger (Adc *p_adc, const enum adc_trigger_t trigger, uint8_t uc_freerun)
	Configure conversion trigger and free run mode.
void	adc_disable_all_channel (Adc *p_adc)
	Disable all ADC channel.
void	adc_disable_anch (Adc *p_adc)
	Disable analog change.
void	adc_disable_channel (Adc *p_adc, const enum adc_channel_num_t adc_ch)
	Disable the specified ADC channel.
void	adc_disable_channel_differential_input (Adc *p_adc, const enum adc_channel_num_t channel)
	Disable differential input for the specified channel.
void	adc_disable_channel_input_offset (Adc *p_adc, const enum adc_channel_num_t channel)
	Disable analog signal offset for the specified channel.
void	adc_disable_interrupt (Adc *p_adc, const uint32_t ul_source)
	Disable ADC interrupts.
void	adc_disable_tag (Adc *p_adc)
	Disable TAG option.
void	adc_disable_ts (Adc *p_adc)
	Turn off temperature sensor.
void	adc_enable_all_channel (Adc *p_adc)
	Enable all ADC channels.
void	adc_enable_anch (Adc *p_adc)
	Enable analog change.
void	adc_enable_channel (Adc *p_adc, const enum adc_channel_num_t adc_ch)
	Enable the specified ADC channel.
void	adc_enable_channel_differential_input (Adc *p_adc, const enum adc_channel_num_t channel)
	Enable differential input for the specified channel.
void	adc_enable_channel_input_offset (Adc *p_adc, const enum adc_channel_num_t channel)
	Enable analog signal offset for the specified channel.
void	adc_enable_interrupt (Adc *p_adc, const uint32_t ul_source)
	Enable ADC interrupts.
void	adc_enable_tag (Adc *p_adc)
	Enable TAG option so that the number of the last converted channel can be indicated.
void	adc_enable_ts (Adc *p_adc)
	Turn on temperature sensor.
uint32_t	adc_get_actual_adc_clock (const Adc *p_adc, const uint32_t ul_mck)
	Return the actual ADC clock.
uint32_t	adc_get_channel_status (const Adc *p_adc, const enum adc_channel_num_t adc_ch)
	Read the ADC channel status.
uint32_t	adc_get_channel_value (const Adc *p_adc, const enum adc_channel_num_t adc_ch)
	Read the ADC result data of the specified channel.
uint32_t	adc_get_comparison_mode (const Adc *p_adc)
	Get comparison mode.
uint32_t	adc_get_interrupt_mask (const Adc *p_adc)
	Read ADC interrupt mask.
uint32_t	adc_get_latest_value (const Adc *p_adc)
	Read the last ADC result data.
uint32_t	adc_get_overrun_status (const Adc *p_adc)
	Get ADC interrupt and overrun error status.
Pdc *	adc_get_pdc_base (const Adc *p_adc)
	Get PDC registers base address.
uint32_t	adc_get_status (const Adc *p_adc)
	Get ADC interrupt and overrun error status.
enum adc_channel_num_t	adc_get_tag (const Adc *p_adc)
	Indicate the last converted channel.
uint32_t	adc_get_writeprotect_status (const Adc *p_adc)
	Indicate write protect status.
uint32_t	adc_init (Adc *p_adc, const uint32_t ul_mck, const uint32_t ul_adc_clock, const enum adc_startup_time startup)
	Initialize the given ADC with the specified ADC clock and startup time.
void	adc_reset (Adc *p_adc)
	Reset ADC.
void	adc_set_bias_current (Adc *p_adc, const uint8_t uc_ibctl)
	Adapt performance versus power consumption.
void	adc_set_calibmode (Adc *p_adc)
	Set ADC auto calibration mode.
void	adc_set_channel_input_gain (Adc *p_adc, const enum adc_channel_num_t channel, const enum adc_gainvalue_t gain)
	Configure input gain for the specified channel.
void	adc_set_comparison_channel (Adc *p_adc, const enum adc_channel_num_t channel)
	Configure comparison selected channel.
void	adc_set_comparison_mode (Adc *p_adc, const uint8_t uc_mode)
	Configure comparison mode.
void	adc_set_comparison_window (Adc *p_adc, const uint16_t us_low_threshold, const uint16_t us_high_threshold)
	Configure ADC compare window.
void	adc_set_resolution (Adc *p_adc, const enum adc_resolution_t resolution)
	Configure the conversion resolution.
void	adc_set_writeprotect (Adc *p_adc, const uint32_t ul_enable)
	Enable or disable write protection of ADC registers.
void	adc_start (Adc *p_adc)
	Start analog-to-digital conversion.
void	adc_start_sequencer (Adc *p_adc)
	Enable conversion sequencer.
void	adc_stop_sequencer (Adc *p_adc)
	Disable conversion sequencer.
static uint32_t	calcul_startup (const uint32_t ul_startup)
	calcul_startup

Detailed Description

See Quickstart guide for SAM ADC driver.

Driver for the Analog-to-digital Converter. This driver provides access to the main features of the ADC controller.

Macro Definition Documentation

ADC_WPMR_WPKEY_PASSWD

#define ADC_WPMR_WPKEY_PASSWD   ADC_WPMR_WPKEY(0x414443u)

Definition at line 756 of file adc.c.

Referenced by adc_set_writeprotect().

Function Documentation

adc_check()

void adc_check	(	Adc *	p_adc,
		const uint32_t	ul_mck )

Check ADC configurations.

Parameters

p_adc	Pointer to an ADC instance.
ul_mck	Main clock of the device (in Hz).

Definition at line 838 of file adc.c.

{
    uint32_t ul_adcfreq;
    uint32_t ul_prescal;
    uint32_t ul_startup;
 
    /* ADCClock = MCK / ( (PRESCAL+1) * 2 ) */
    ul_prescal = ((p_adc->ADC_MR & ADC_MR_PRESCAL_Msk) >>
            ADC_MR_PRESCAL_Pos);
    ul_adcfreq = ul_mck / ((ul_prescal + 1) * 2);
    printf("ADC clock frequency = %d Hz\r\n", (int)ul_adcfreq);
 
    if (ul_adcfreq < ADC_FREQ_MIN) {
        printf("adc frequency too low (out of specification: %d Hz)\r\n",
            (int)ADC_FREQ_MIN);
    }
    if (ul_adcfreq > ADC_FREQ_MAX) {
        printf("adc frequency too high (out of specification: %d Hz)\r\n",
            (int)ADC_FREQ_MAX);
    }
 
    ul_startup = ((p_adc->ADC_MR & ADC_MR_STARTUP_Msk) >>
            ADC_MR_STARTUP_Pos);
    if (!(p_adc->ADC_MR & ADC_MR_SLEEP_SLEEP)) {
        /* 40ms */
        if (ADC_STARTUP_NORM * ul_adcfreq / 1000000 >
                calcul_startup(ul_startup)) {
            printf("Startup time too small: %d, programmed: %d\r\n",
                    (int)(ADC_STARTUP_NORM * ul_adcfreq /
                            1000000),
                    (int)calcul_startup(ul_startup));
        }
    } else {
        if (p_adc->ADC_MR & ADC_MR_FREERUN_ON) {
            puts("FreeRun forbidden in sleep mode\r");
        }
#if !SAM4C && !SAM4CP && !SAM4CM
        if (!(p_adc->ADC_MR & ADC_MR_FWUP_ON)) {
            /* Sleep 40ms */
            if (ADC_STARTUP_NORM * ul_adcfreq / 1000000 >
                    calcul_startup(ul_startup)) {
                printf("Startup time too small: %d, programmed: %d\r\n",
                    (int)(ADC_STARTUP_NORM * ul_adcfreq / 1000000),
                    (int)(calcul_startup(ul_startup)));
            }
        } else {
            if (p_adc->ADC_MR & ADC_MR_FWUP_ON) {
                /* Fast Wake Up Sleep Mode: 12ms */
                if (ADC_STARTUP_FAST * ul_adcfreq / 1000000 >
                        calcul_startup(ul_startup)) {
                    printf("Startup time too small: %d, programmed: %d\r\n",
                        (int)(ADC_STARTUP_NORM * ul_adcfreq / 1000000),
                        (int)(calcul_startup(ul_startup)));
                }
            }
        }
#endif
    }
}

References ADC_FREQ_MAX, ADC_FREQ_MIN, Adc::ADC_MR, ADC_MR_FREERUN_ON, ADC_MR_FWUP_ON, ADC_MR_PRESCAL_Msk, ADC_MR_PRESCAL_Pos, ADC_MR_SLEEP_SLEEP, ADC_MR_STARTUP_Msk, ADC_MR_STARTUP_Pos, ADC_STARTUP_FAST, ADC_STARTUP_NORM, and calcul_startup().

adc_configure_power_save()

void adc_configure_power_save	(	Adc *	p_adc,
		const uint8_t	uc_sleep,
		const uint8_t	uc_fwup )

Configures ADC power saving mode.

Parameters

p_adc	Pointer to an ADC instance.
uc_sleep	ADC_MR_SLEEP_NORMAL keeps the ADC Core and reference voltage circuitry ON between conversions. ADC_MR_SLEEP_SLEEP keeps the ADC Core and reference voltage circuitry OFF between conversions.
uc_fwup	ADC_MR_FWUP_OFF configures sleep mode as uc_sleep setting, ADC_MR_FWUP_ON keeps voltage reference ON and ADC Core OFF between conversions.

Definition at line 198 of file adc.c.

{
    p_adc->ADC_MR |= (((uc_sleep << 5) & ADC_MR_SLEEP) |
            ((uc_fwup << 6) & ADC_MR_FWUP));
}

References Adc::ADC_MR, ADC_MR_FWUP, and ADC_MR_SLEEP.

adc_configure_sequence()

void adc_configure_sequence	(	Adc *	p_adc,
		const enum adc_channel_num_t	ch_list[],
		uint8_t	uc_num )

Configure conversion sequence.

Parameters

p_adc	Pointer to an ADC instance.
ch_list	Channel sequence list.
uc_num	Number of channels in the list.

Definition at line 228 of file adc.c.

{
    uint8_t uc_counter;
    volatile uint32_t *adc_seqr = &p_adc->ADC_SEQR1;
 
    if (uc_num <= 8) {
        for (uc_counter = 0; uc_counter < uc_num; uc_counter++) {
            adc_seqr[0] |=
                    ch_list[uc_counter] << (4 * uc_counter);
        }
    } else {
        for (uc_counter = 0; uc_counter < 8; uc_counter++) {
            adc_seqr[0] |=
                    ch_list[uc_counter] << (4 * uc_counter);
        }
        for (uc_counter = 0; uc_counter < uc_num - 8; uc_counter++) {
            adc_seqr[1] |=
                    ch_list[8 + uc_counter] << (4 * uc_counter);
        }
    }
}

References Adc::ADC_SEQR1.

adc_configure_timing()

void adc_configure_timing	(	Adc *	p_adc,
		const uint8_t	uc_tracking,
		const enum adc_settling_time_t	settling,
		const uint8_t	uc_transfer )

Configure ADC timing.

Parameters

p_adc	Pointer to an ADC instance.
uc_tracking	ADC tracking time = uc_tracking / ADC clock.
settling	Analog settling time = (settling + 1) / ADC clock.
uc_transfer	Data transfer time = (uc_transfer * 2 + 3) / ADC clock.

Definition at line 261 of file adc.c.

{
    p_adc->ADC_MR |= ADC_MR_TRANSFER(uc_transfer)
            | settling | ADC_MR_TRACKTIM(uc_tracking);
}

References Adc::ADC_MR, ADC_MR_TRACKTIM, and ADC_MR_TRANSFER.

adc_configure_trigger()

void adc_configure_trigger	(	Adc *	p_adc,
		const enum adc_trigger_t	trigger,
		uint8_t	uc_freerun )

Configure conversion trigger and free run mode.

Parameters

p_adc	Pointer to an ADC instance.
trigger	Conversion trigger.
uc_freerun	ADC_MR_FREERUN_ON enables freerun mode, ADC_MR_FREERUN_OFF disables freerun mode.

Definition at line 168 of file adc.c.

{
    p_adc->ADC_MR |= trigger | ((uc_freerun << 7) & ADC_MR_FREERUN);
}

References Adc::ADC_MR, and ADC_MR_FREERUN.

adc_disable_all_channel()

void adc_disable_all_channel

(

Adc *

p_adc

)

Disable all ADC channel.

Parameters

p_adc

Pointer to an ADC instance.

Definition at line 382 of file adc.c.

{
#if SAM3S || SAM4S || SAM3N || SAM3XA
    p_adc->ADC_CHDR = 0xFFFF;
#elif SAM3U || SAM4C || SAM4CP || SAM4CM
    p_adc->ADC_CHDR = 0xFF;
#endif
}

References Adc::ADC_CHDR.

adc_disable_anch()

void adc_disable_anch

(

Adc *

p_adc

)

Disable analog change.

Note

DIFF0, GAIN0 and OFF0 are used for all channels.

Parameters

p_adc

Pointer to an ADC instance.

Definition at line 311 of file adc.c.

{
    p_adc->ADC_MR &= ~ADC_MR_ANACH;
}

References Adc::ADC_MR, and ADC_MR_ANACH.

adc_disable_channel()

void adc_disable_channel	(	Adc *	p_adc,
		const enum adc_channel_num_t	adc_ch )

Disable the specified ADC channel.

Parameters

p_adc	Pointer to an ADC instance.
adc_ch	ADC channel number.

Definition at line 372 of file adc.c.

{
    p_adc->ADC_CHDR = 1 << adc_ch;
}

References Adc::ADC_CHDR.

adc_disable_channel_differential_input()

void adc_disable_channel_differential_input	(	Adc *	p_adc,
		const enum adc_channel_num_t	channel )

Disable differential input for the specified channel.

Parameters

p_adc	Pointer to an ADC instance.
channel	ADC channel number.

Definition at line 568 of file adc.c.

{
    uint32_t ul_temp;
    ul_temp = p_adc->ADC_COR;
    p_adc->ADC_COR &= 0xfffeffffu << channel;
    p_adc->ADC_COR |= ul_temp;
}

References Adc::ADC_COR.

adc_disable_channel_input_offset()

void adc_disable_channel_input_offset	(	Adc *	p_adc,
		const enum adc_channel_num_t	channel )

Disable analog signal offset for the specified channel.

Parameters

p_adc	Pointer to an ADC instance.
channel	ADC channel number.

Definition at line 593 of file adc.c.

{
    uint32_t ul_temp;
    ul_temp = p_adc->ADC_COR;
    p_adc->ADC_COR &= (0xfffffffeu << channel);
    p_adc->ADC_COR |= ul_temp;
}

References Adc::ADC_COR.

adc_disable_interrupt()

void adc_disable_interrupt	(	Adc *	p_adc,
		const uint32_t	ul_source )

Disable ADC interrupts.

Parameters

p_adc	Pointer to an ADC instance.
ul_source	Interrupts to be disabled.

Definition at line 663 of file adc.c.

{
    p_adc->ADC_IDR = ul_source;
}

References Adc::ADC_IDR.

adc_disable_tag()

void adc_disable_tag

(

Adc *

p_adc

)

Disable TAG option.

Parameters

p_adc

Pointer to an ADC instance.

Definition at line 453 of file adc.c.

{
    p_adc->ADC_EMR &= ~ADC_EMR_TAG;
}

References Adc::ADC_EMR, and ADC_EMR_TAG.

adc_disable_ts()

void adc_disable_ts

(

Adc *

p_adc

)

Turn off temperature sensor.

Parameters

p_adc

Pointer to an ADC instance.

Definition at line 748 of file adc.c.

{
    p_adc->ADC_ACR &= ~ADC_ACR_TSON;
}

References Adc::ADC_ACR, and ADC_ACR_TSON.

adc_enable_all_channel()

void adc_enable_all_channel

(

Adc *

p_adc

)

Enable all ADC channels.

Parameters

p_adc

Pointer to an ADC instance.

Definition at line 357 of file adc.c.

{
#if SAM3S || SAM4S || SAM3N || SAM3XA
    p_adc->ADC_CHER = 0xFFFF;
#elif SAM3U || SAM4C || SAM4CP || SAM4CM
    p_adc->ADC_CHER = 0xFF;
#endif
}

References Adc::ADC_CHER.

adc_enable_anch()

void adc_enable_anch

(

Adc *

p_adc

)

Enable analog change.

Note

It allows different analog settings for each channel.

Parameters

p_adc

Pointer to an ADC instance.

Definition at line 299 of file adc.c.

{
    p_adc->ADC_MR |= ADC_MR_ANACH;
}

References Adc::ADC_MR, and ADC_MR_ANACH.

adc_enable_channel()

void adc_enable_channel	(	Adc *	p_adc,
		const enum adc_channel_num_t	adc_ch )

Enable the specified ADC channel.

Parameters

p_adc	Pointer to an ADC instance.
adc_ch	ADC channel number.

Definition at line 347 of file adc.c.

{
    p_adc->ADC_CHER = 1 << adc_ch;
}

References Adc::ADC_CHER.

adc_enable_channel_differential_input()

void adc_enable_channel_differential_input	(	Adc *	p_adc,
		const enum adc_channel_num_t	channel )

Enable differential input for the specified channel.

Parameters

p_adc	Pointer to an ADC instance.
channel	ADC channel number.

Definition at line 557 of file adc.c.

{
    p_adc->ADC_COR |= 0x01u << (16 + channel);
}

References Adc::ADC_COR.

adc_enable_channel_input_offset()

void adc_enable_channel_input_offset	(	Adc *	p_adc,
		const enum adc_channel_num_t	channel )

Enable analog signal offset for the specified channel.

Parameters

p_adc	Pointer to an ADC instance.
channel	ADC channel number.

Definition at line 582 of file adc.c.

{
    p_adc->ADC_COR |= 0x01u << channel;
}

References Adc::ADC_COR.

adc_enable_interrupt()

void adc_enable_interrupt	(	Adc *	p_adc,
		const uint32_t	ul_source )

Enable ADC interrupts.

Parameters

p_adc	Pointer to an ADC instance.
ul_source	Interrupts to be enabled.

Definition at line 652 of file adc.c.

{
    p_adc->ADC_IER = ul_source;
}

References Adc::ADC_IER.

adc_enable_tag()

void adc_enable_tag

(

Adc *

p_adc

)

Enable TAG option so that the number of the last converted channel can be indicated.

Parameters

p_adc

Pointer to an ADC instance.

Definition at line 443 of file adc.c.

{
    p_adc->ADC_EMR |= ADC_EMR_TAG;
}

References Adc::ADC_EMR, and ADC_EMR_TAG.

adc_enable_ts()

void adc_enable_ts

(

Adc *

p_adc

)

Turn on temperature sensor.

Parameters

p_adc

Pointer to an ADC instance.

Definition at line 738 of file adc.c.

{
    p_adc->ADC_ACR |= ADC_ACR_TSON;
}

References Adc::ADC_ACR, and ADC_ACR_TSON.

adc_get_actual_adc_clock()

uint32_t adc_get_actual_adc_clock	(	const Adc *	p_adc,
		const uint32_t	ul_mck )

Return the actual ADC clock.

Parameters

p_adc	Pointer to an ADC instance.
ul_mck	Main clock of the device (in Hz).

Returns

The actual ADC clock (in Hz).

Definition at line 635 of file adc.c.

{
    uint32_t ul_adcfreq;
    uint32_t ul_prescal;
 
    /* ADCClock = MCK / ( (PRESCAL+1) * 2 ) */
    ul_prescal = ((p_adc->ADC_MR & ADC_MR_PRESCAL_Msk) >> ADC_MR_PRESCAL_Pos);
    ul_adcfreq = ul_mck / ((ul_prescal + 1) * 2);
    return ul_adcfreq;
}

References Adc::ADC_MR, ADC_MR_PRESCAL_Msk, and ADC_MR_PRESCAL_Pos.

adc_get_channel_status()

uint32_t adc_get_channel_status	(	const Adc *	p_adc,
		const enum adc_channel_num_t	adc_ch )

Read the ADC channel status.

Parameters

p_adc	Pointer to an ADC instance.
adc_ch	ADC channel number.

Return values

1	if channel is enabled.
0	if channel is disabled.

Definition at line 400 of file adc.c.

{
    return p_adc->ADC_CHSR & (1 << adc_ch);
}

References Adc::ADC_CHSR.

adc_get_channel_value()

uint32_t adc_get_channel_value	(	const Adc *	p_adc,
		const enum adc_channel_num_t	adc_ch )

Read the ADC result data of the specified channel.

Parameters

p_adc	Pointer to an ADC instance.
adc_ch	ADC channel number.

Returns

ADC value of the specified channel.

Definition at line 413 of file adc.c.

{
    uint32_t ul_data = 0;
 
    if (15 >= adc_ch) {
        ul_data = *(p_adc->ADC_CDR + adc_ch);
    }
 
    return ul_data;
}

References Adc::ADC_CDR.

adc_get_comparison_mode()

uint32_t adc_get_comparison_mode

(

const Adc *

p_adc

)

Get comparison mode.

Parameters

p_adc

Pointer to an ADC instance.

Return values

Compare

mode value.

Definition at line 513 of file adc.c.

{
    return p_adc->ADC_EMR & ADC_EMR_CMPMODE_Msk;
}

References Adc::ADC_EMR, and ADC_EMR_CMPMODE_Msk.

adc_get_interrupt_mask()

uint32_t adc_get_interrupt_mask

(

const Adc *

p_adc

)

Read ADC interrupt mask.

Parameters

p_adc

Pointer to an ADC instance.

Returns

The interrupt mask value.

Definition at line 713 of file adc.c.

{
    return p_adc->ADC_IMR;
}

References Adc::ADC_IMR.

adc_get_latest_value()

uint32_t adc_get_latest_value

(

const Adc *

p_adc

)

Read the last ADC result data.

Parameters

p_adc

Pointer to an ADC instance.

Returns

ADC latest value.

Definition at line 431 of file adc.c.

{
    return p_adc->ADC_LCDR;
}

References Adc::ADC_LCDR.

adc_get_overrun_status()

uint32_t adc_get_overrun_status

(

const Adc *

p_adc

)

Get ADC interrupt and overrun error status.

Parameters

p_adc

Pointer to an ADC instance.

Returns

ADC status structure.

Definition at line 688 of file adc.c.

{
    return p_adc->ADC_OVER;
}

References Adc::ADC_OVER.

adc_get_pdc_base()

Pdc * adc_get_pdc_base

(

const Adc *

p_adc

)

Get PDC registers base address.

Parameters

p_adc

Pointer to an ADC instance.

Returns

ADC PDC register base address.

Definition at line 906 of file adc.c.

{
    UNUSED(p_adc);
    return PDC_ADC;
}

References PDC_ADC.

adc_get_status()

uint32_t adc_get_status

(

const Adc *

p_adc

)

Get ADC interrupt and overrun error status.

Parameters

p_adc

Pointer to an ADC instance.

Returns

ADC status structure.

Definition at line 676 of file adc.c.

{
    return p_adc->ADC_ISR;
}

References Adc::ADC_ISR.

adc_get_tag()

enum adc_channel_num_t adc_get_tag

(

const Adc *

p_adc

)

Indicate the last converted channel.

Note

If TAG option is NOT enabled before, an incorrect channel number is returned.

Parameters

p_adc

Pointer to an ADC instance.

Returns

The last converted channel number.

Definition at line 468 of file adc.c.

{
    return (enum adc_channel_num_t)
            ((p_adc->ADC_LCDR & ADC_LCDR_CHNB_Msk) >> ADC_LCDR_CHNB_Pos);
}

References Adc::ADC_LCDR, ADC_LCDR_CHNB_Msk, and ADC_LCDR_CHNB_Pos.

adc_get_writeprotect_status()

uint32_t adc_get_writeprotect_status

(

const Adc *

p_adc

)

Indicate write protect status.

Parameters

p_adc

Pointer to an ADC instance.

Returns

0 if no write protect violation occurred, or 16-bit write protect violation source.

Definition at line 777 of file adc.c.

{
    uint32_t reg_value;
 
    reg_value = p_adc->ADC_WPSR;
    if (reg_value & ADC_WPSR_WPVS) {
        return (reg_value & ADC_WPSR_WPVSRC_Msk) >> ADC_WPSR_WPVSRC_Pos;
    } else {
        return 0;
    }
}

References Adc::ADC_WPSR, ADC_WPSR_WPVS, ADC_WPSR_WPVSRC_Msk, and ADC_WPSR_WPVSRC_Pos.

adc_init()

uint32_t adc_init	(	Adc *	p_adc,
		const uint32_t	ul_mck,
		const uint32_t	ul_adc_clock,
		const enum adc_startup_time	startup )

Initialize the given ADC with the specified ADC clock and startup time.

Parameters

p_adc	Pointer to an ADC instance.
ul_mck	Main clock of the device (value in Hz).
ul_adc_clock	Analog-to-Digital conversion clock (value in Hz).
startup	ADC start up time. Please refer to the product datasheet for details.

Returns

0 on success.

Definition at line 70 of file adc.c.

{
    uint32_t ul_prescal;
 
    /*  Reset the controller. */
    p_adc->ADC_CR = ADC_CR_SWRST;
 
    /* Reset Mode Register. */
    p_adc->ADC_MR = 0;
 
    /* Reset PDC transfer. */
    p_adc->ADC_PTCR = (ADC_PTCR_RXTDIS | ADC_PTCR_TXTDIS);
    p_adc->ADC_RCR = 0;
    p_adc->ADC_RNCR = 0;
 
    ul_prescal = ul_mck / (2 * ul_adc_clock) - 1;
    p_adc->ADC_MR |= ADC_MR_PRESCAL(ul_prescal) | startup;
    return 0;
}

References Adc::ADC_CR, ADC_CR_SWRST, Adc::ADC_MR, ADC_MR_PRESCAL, Adc::ADC_PTCR, ADC_PTCR_RXTDIS, ADC_PTCR_TXTDIS, Adc::ADC_RCR, and Adc::ADC_RNCR.

adc_reset()

void adc_reset

(

Adc *

p_adc

)

Reset ADC.

Parameters

p_adc

Pointer to an ADC instance.

Definition at line 336 of file adc.c.

{
    p_adc->ADC_CR = ADC_CR_SWRST;
}

References Adc::ADC_CR, and ADC_CR_SWRST.

adc_set_bias_current()

void adc_set_bias_current	(	Adc *	p_adc,
		const uint8_t	uc_ibctl )

Adapt performance versus power consumption.

Note

Please refer to ADC Characteristics in the product datasheet for more details.

Parameters

p_adc	Pointer to an ADC instance.
uc_ibctl	ADC Bias current control.

Definition at line 728 of file adc.c.

{
    p_adc->ADC_ACR |= ADC_ACR_IBCTL(uc_ibctl);
}

References Adc::ADC_ACR, and ADC_ACR_IBCTL.

adc_set_calibmode()

void adc_set_calibmode

(

Adc *

p_adc

)

Set ADC auto calibration mode.

Parameters

p_adc

Pointer to an ADC instance.

Definition at line 621 of file adc.c.

{
    p_adc->ADC_CR |= ADC_CR_AUTOCAL;
}

References Adc::ADC_CR, and ADC_CR_AUTOCAL.

adc_set_channel_input_gain()

void adc_set_channel_input_gain	(	Adc *	p_adc,
		const enum adc_channel_num_t	channel,
		const enum adc_gainvalue_t	gain )

Configure input gain for the specified channel.

Parameters

p_adc	Pointer to an ADC instance.
channel	ADC channel number.
gain	Gain value for the input.

Definition at line 608 of file adc.c.

{
    p_adc->ADC_CGR |= (0x03u << (2 * channel)) & (gain << (2 * channel));
}

References Adc::ADC_CGR.

adc_set_comparison_channel()

void adc_set_comparison_channel	(	Adc *	p_adc,
		const enum adc_channel_num_t	channel )

Configure comparison selected channel.

Parameters

p_adc	Pointer to an ADC instance.
channel	ADC channel number.

Definition at line 538 of file adc.c.

{
    if (channel < 16) {
        p_adc->ADC_EMR &= (uint32_t) ~ (ADC_EMR_CMPALL);
        p_adc->ADC_EMR &= (uint32_t) ~ (ADC_EMR_CMPSEL_Msk);
        p_adc->ADC_EMR |= (channel << ADC_EMR_CMPSEL_Pos);
    } else {
        p_adc->ADC_EMR |= ADC_EMR_CMPALL;
    }
}

References Adc::ADC_EMR, ADC_EMR_CMPALL, ADC_EMR_CMPSEL_Msk, and ADC_EMR_CMPSEL_Pos.

adc_set_comparison_mode()

void adc_set_comparison_mode	(	Adc *	p_adc,
		const uint8_t	uc_mode )

Configure comparison mode.

Parameters

p_adc	Pointer to an ADC instance.
uc_mode	ADC comparison mode.

Definition at line 500 of file adc.c.

{
    p_adc->ADC_EMR &= (uint32_t) ~ (ADC_EMR_CMPMODE_Msk);
    p_adc->ADC_EMR |= (uc_mode & ADC_EMR_CMPMODE_Msk);
}

References Adc::ADC_EMR, and ADC_EMR_CMPMODE_Msk.

adc_set_comparison_window()

void adc_set_comparison_window	(	Adc *	p_adc,
		const uint16_t	us_low_threshold,
		const uint16_t	us_high_threshold )

Configure ADC compare window.

Parameters

p_adc	Pointer to an ADC instance.
us_low_threshold	Low threshold of compare window.
us_high_threshold	High threshold of compare window.

Definition at line 525 of file adc.c.

{
    p_adc->ADC_CWR = ADC_CWR_LOWTHRES(us_low_threshold) |
            ADC_CWR_HIGHTHRES(us_high_threshold);
}

References Adc::ADC_CWR, ADC_CWR_HIGHTHRES, and ADC_CWR_LOWTHRES.

adc_set_resolution()

void adc_set_resolution	(	Adc *	p_adc,
		const enum adc_resolution_t	resolution )

Configure the conversion resolution.

Parameters

p_adc	Pointer to an ADC instance.
resolution	ADC resolution.

Definition at line 134 of file adc.c.

{
#if SAM4C || SAM4CP || SAM4CM
    p_adc->ADC_EMR &= ~ADC_EMR_OSR_Msk;
    switch (resolution) {
    case ADC_8_BITS:
        p_adc->ADC_MR |= ADC_MR_LOWRES;
        break;
    case ADC_10_BITS:
        p_adc->ADC_MR &= ~ADC_MR_LOWRES;
        break;
    case ADC_11_BITS:
    case ADC_12_BITS:
        p_adc->ADC_MR &= ~ADC_MR_LOWRES;
        p_adc->ADC_EMR |= resolution;
        break;
    }
#else
    p_adc->ADC_MR &= ~ADC_MR_LOWRES;
    p_adc->ADC_MR |= resolution;
#endif
}

References ADC_10_BITS, ADC_12_BITS, Adc::ADC_EMR, Adc::ADC_MR, and ADC_MR_LOWRES.

adc_set_writeprotect()

void adc_set_writeprotect	(	Adc *	p_adc,
		const uint32_t	ul_enable )

Enable or disable write protection of ADC registers.

Parameters

p_adc	Pointer to an ADC instance.
ul_enable	1 to enable, 0 to disable.

Definition at line 764 of file adc.c.

{
    p_adc->ADC_WPMR = ADC_WPMR_WPKEY_PASSWD | (ul_enable & ADC_WPMR_WPEN);
}

References Adc::ADC_WPMR, ADC_WPMR_WPEN, and ADC_WPMR_WPKEY_PASSWD.

adc_start()

void adc_start

(

Adc *

p_adc

)

Start analog-to-digital conversion.

Note

If one of the hardware event is selected as ADC trigger, this function can NOT start analog to digital conversion.

Parameters

p_adc

Pointer to an ADC instance.

Definition at line 326 of file adc.c.

{
    p_adc->ADC_CR = ADC_CR_START;
}

References Adc::ADC_CR, and ADC_CR_START.

adc_start_sequencer()

void adc_start_sequencer

(

Adc *

p_adc

)

Enable conversion sequencer.

Parameters

p_adc

Pointer to an ADC instance.

Definition at line 479 of file adc.c.

{
    p_adc->ADC_MR |= ADC_MR_USEQ;
}

References Adc::ADC_MR, and ADC_MR_USEQ.

adc_stop_sequencer()

void adc_stop_sequencer

(

Adc *

p_adc

)

Disable conversion sequencer.

Parameters

p_adc

Pointer to an ADC instance.

Definition at line 489 of file adc.c.

{
    p_adc->ADC_MR &= ~ADC_MR_USEQ;
}

References Adc::ADC_MR, and ADC_MR_USEQ.

calcul_startup()

uint32_t calcul_startup ( const uint32_t ul_startup )

static

calcul_startup

Definition at line 792 of file adc.c.

{
    uint32_t ul_startup_value = 0;
 
    if (ul_startup == 0)
        ul_startup_value = 0;
    else if (ul_startup == 1)
        ul_startup_value = 8;
    else if (ul_startup == 2)
        ul_startup_value = 16;
    else if (ul_startup == 3)
        ul_startup_value = 24;
    else if (ul_startup == 4)
        ul_startup_value = 64;
    else if (ul_startup == 5)
        ul_startup_value = 80;
    else if (ul_startup == 6)
        ul_startup_value = 96;
    else if (ul_startup == 7)
        ul_startup_value = 112;
    else if (ul_startup == 8)
        ul_startup_value = 512;
    else if (ul_startup == 9)
        ul_startup_value = 576;
    else if (ul_startup == 10)
        ul_startup_value = 640;
    else if (ul_startup == 11)
        ul_startup_value = 704;
    else if (ul_startup == 12)
        ul_startup_value = 768;
    else if (ul_startup == 13)
        ul_startup_value = 832;
    else if (ul_startup == 14)
        ul_startup_value = 896;
    else if (ul_startup == 15)
        ul_startup_value = 960;
 
    return ul_startup_value;
}

Referenced by adc_check().