Microchip Technology TB3209 User manual

TB3209
Getting Started with ADC
Introduction
Author: Victor Berzan, Microchip Technology Inc.
The Analog-to-Digital Converter (ADC) peripheral converts an analog voltage to a numerical value. This
peripheral is included in many AVR® microcontrollers (MCUs). A 10-bit single-ended ADC peripheral is
available on most of the tinyAVR® and megaAVR® MCUs.
This technical brief describes how the Analog-to-Digital Converter module works on megaAVR® 0-series
microcontrollers. It covers the following use cases:
•ADC Single Conversion:
Initialize the ADC, start conversion, wait until the conversion is done, read ADC result.
•ADC Free Running:
Initialize the ADC, enable Free Running mode, start conversion, wait until the conversion is done and
read the ADC result in an infinite loop.
•ADC Sample Accumulator:
Initialize the ADC, enable accumulation of 64 samples, start conversion, wait until the conversion is
done and read ADC result in a loop.
•ADC Window Comparator:
Initialize the ADC, set the conversion window comparator low threshold, enable the conversion
Window mode, enable the Free Running mode, start the conversion, wait until the conversion is done
and read the ADC result in an infinite loop, and light-up an LED if the ADC result is below the set
threshold.
•ADC Event Triggered:
Initialize the ADC, initialize the Real Time Counter (RTC), configure the Event System (EVSYS) to
trigger an ADC conversion on RTC overflow, toggle an LED after each ADC conversion.
Note: The code examples were developed on ATmega4809 Xplained Pro (ATMEGA4809-XPRO).
© 2018 Microchip Technology Inc. DS90003209A-page 1

Table of Contents
Introduction......................................................................................................................1
1. Relevant Devices.......................................................................................................3
1.1. tinyAVR® 0-series......................................................................................................................... 3
1.2. tinyAVR® 1-series......................................................................................................................... 3
1.3. megaAVR® 0-series......................................................................................................................4
2. Overview....................................................................................................................5
3. ADC Single Conversion.............................................................................................6
4. ADC Free Running.................................................................................................. 10
5. ADC Sample Accumulator....................................................................................... 11
6. ADC Window Comparator....................................................................................... 13
7. ADC Event Triggered...............................................................................................15
8. References.............................................................................................................. 16
9. Appendix..................................................................................................................17
The Microchip Web Site................................................................................................ 24
Customer Change Notification Service..........................................................................24
Customer Support......................................................................................................... 24
Microchip Devices Code Protection Feature................................................................. 24
Legal Notice...................................................................................................................25
Trademarks................................................................................................................... 25
Quality Management System Certified by DNV.............................................................26
Worldwide Sales and Service........................................................................................27
TB3209
© 2018 Microchip Technology Inc. DS90003209A-page 2

1. Relevant Devices
This chapter lists the relevant devices for this document.
1.1 tinyAVR® 0-series
The figure below shows the tinyAVR® 0-series, laying out pin count variants and memory sizes:
• Vertical migration is possible without code modification, as these devices are fully pin- and feature
compatible.
• Horizontal migration to the left reduces the pin count and therefore, the available features.
Figure 1-1. tinyAVR® 0-series Overview
8 14 20 24
Pins
Flash
ATtiny1607
ATtiny807
ATtiny1606
ATtiny806
ATtiny1604
ATtiny804
ATtiny402
ATtiny202
ATtiny404
ATtiny204
ATtiny406
32 KB
16 KB
8 KB
4 KB
2 KB
devices ATtiny~~
ATtiny~~
Legend:
common data sheet
Devices with different Flash memory size typically also have different SRAM and EEPROM.
1.2 tinyAVR® 1-series
The figure below shows the tinyAVR® 1-series devices, laying out pin count variants and memory sizes:
• Vertical migration upwards is possible without code modification, as these devices are pin compatible
and provide the same or more features. Downward migration may require code modification due to
fewer available instances of some peripherals.
• Horizontal migration to the left reduces the pin count and therefore, the available features.
TB3209
Relevant Devices
© 2018 Microchip Technology Inc. DS90003209A-page 3

Figure 1-2. tinyAVR® 1-series Overview
48 KB
32 KB
16 KB
8 KB
4 KB
2 KB
8 14 20 24 Pins
Flash
ATtiny816 ATtiny817ATtiny814
ATtiny417
ATtiny1616 ATtiny1617
ATtiny414 ATtiny416
ATtiny412
ATtiny214
ATtiny212
ATtiny1614
ATtiny3216 ATtiny3217
devices
ATtiny~~
ATtiny~~
Legend:
common data sheet
Devices with different Flash memory size typically also have different SRAM and EEPROM.
1.3 megaAVR® 0-series
The figure below shows the megaAVR 0-series devices, laying out pin count variants and memory sizes:
• Vertical migration is possible without code modification, as these devices are fully pin and feature
compatible.
• Horizontal migration to the left reduces the pin count and, therefore, the available features.
Figure 1-3. megaAVR® 0-series Overview
48 KB
32 KB
16 KB
8 KB
28/32 48
Pins
Flash
ATmega3208
ATmega4808
ATmega3209
ATmega4809
ATmega808
ATmega1608 ATmega1609
ATmega809
Devices with different Flash memory size typically also have different SRAM and EEPROM.
TB3209
Relevant Devices
© 2018 Microchip Technology Inc. DS90003209A-page 4

2. Overview
The Analog-to-Digital Converter (ADC) peripheral produces 10-bit results. The ADC input can either be
internal (e.g. a voltage reference), or external through the analog input pins. The ADC is connected to an
analog multiplexer, which allows selection of multiple single-ended voltage inputs. The single-ended
voltage inputs refer to 0V (GND).
The ADC supports sampling in bursts where a configurable number of conversion results are
accumulated into a single ADC result (Sample Accumulation). The ADC input signal is fed through a
sample-and-hold circuit that ensures the input voltage to the ADC is held at a constant level during
sampling.
Selectable voltage references from the internal Voltage Reference (VREF) peripheral, VDD supply voltage,
or external VREF pin (VREFA).
A window compare feature is available for monitoring the input signal and can be configured to only
trigger an interrupt on user-defined thresholds for under, over, inside, or outside a window, with minimum
software intervention required.
Figure 2-1. ADC Block Diagram
ADC
.
.
.
AIN0
AIN1
AINn
DACREF0
RES
"accumulate"
Temp.Sense
Internal reference
VREFA
AVDD
MUXPOS
Control logic
>
<
WINLT
WINHT
"convert"
"enable"
WCOMP
(Int. Req)
RESRDY
(Int. Req)
VREF
ACC
The analog input channel is selected by writing to the MUXPOS bits in the MUXPOS register
(ADCn.MUXPOS). Any of the ADC input pins, GND, internal Voltage Reference (VREF), or temperature
sensor, can be selected as single-ended input to the ADC. The ADC is enabled by writing a ‘1’ to the
ADC ENABLE bit in the Control A register (ADCn.CTRLA). Voltage reference and input channel
selections will not go into effect before the ADC is enabled. The ADC does not consume power when the
ENABLE bit in ADCn.CTRLA is zero.
The ADC generates a 10-bit result that can be read from the Result register (ADCn.RES). The result is
presented right adjusted. The result for a 10-bit conversion is given as:
 =
1023 × 

where VIN is the voltage on the selected input pin and VREF is the selected voltage reference.
TB3209
Overview
© 2018 Microchip Technology Inc. DS90003209A-page 5

3. ADC Single Conversion
The simplest mode of using the ADC is to make a single conversion. The ADC input pin needs to have
the digital input buffer and the pull-up resistor disabled, in order to have the highest possible input
impedance. Pin PD6/AIN6 is used for ADC input in this example.
Figure 3-1. ADC0.MUXPOS Selection
b
ADC0.MUXPOS = ADC_MUXPOS_AIN6_gc;
The ADC Clock Prescaler can be used to divide the clock frequency. In this particular example, the clock
is divided by 4. The ADC can use VDD, external reference or internal reference for its positive reference.
The internal reference is used in this example.
TB3209
ADC Single Conversion
© 2018 Microchip Technology Inc. DS90003209A-page 6

Figure 3-2. ADC0.CTRLC Voltage Reference Selection
b
b
ADC0.CTRLC |= ADC_PRESC_DIV4_gc;
ADC0.CTRLC |= ADC_REFSEL_INTREF_gc;
The ADC resolution is set by the RESSEL bit in the ADC0.CTRLA register. The ADC is enabled by
setting the ENABLE bit in the ADC0.CTRLA register.
TB3209
ADC Single Conversion
© 2018 Microchip Technology Inc. DS90003209A-page 7

Figure 3-3. ADC0.CTRLA Resolution Selection
b
b
ADC0.CTRLA |= ADC_RESSEL_10BIT_gc;
ADC0.CTRLA |= ADC_ENABLE_bm;
The ADC conversion is started by setting the STCONV bit in the ADC0.COMMAND register.
Figure 3-4. ADC0.COMMAND - Start conversion
b
ADC0.COMMAND = ADC_STCONV_bm;
When the conversion is done, the RESRDY bit in the ADC0.INTFLAGS gets set by the hardware. The
user must wait for that bit to get set before reading the ADC result.
TB3209
ADC Single Conversion
© 2018 Microchip Technology Inc. DS90003209A-page 8

Figure 3-5. ADC0.INTFLAGS - hardware-set RESRDY bit
b
while (!(ADC0.INTFLAGS & ADC_RESRDY_bm))
{
;
}
The user must clear the RESRDY bit by writing ‘1’ to it before starting another conversion.
ADC0.INTFLAGS = ADC_RESRDY_bm;
The conversion result can be read from the ADC0.RES register.
adcVal = ADC0.RES;
Tip: The full code example is also available in the Appendix section.
TB3209
ADC Single Conversion
© 2018 Microchip Technology Inc. DS90003209A-page 9

4. ADC Free Running
When configuring the ADC in Free Running mode, the next conversion starts immediately after the
previous one completes. To activate this mode, the FREERUN bit in the ADC0.CTRLA must be set in
addition to the normal ADC initialization.
Figure 4-1. ADC0.CTRLA - set FREERUN bit
b
ADC0.CTRLA |= ADC_FREERUN_bm;
The ADC conversion is started by setting the STCONV bit in the ADC0.COMMAND register:
ADC0.COMMAND = ADC_STCONV_bm;
Then the ADC results can be read in a while loop:
while(1)
{
if (ADC0_conersionDone())
{
adcVal = ADC0_read();
}
}
Tip: The full code example is also available in the Appendix section.
TB3209
ADC Free Running
© 2018 Microchip Technology Inc. DS90003209A-page 10

5. ADC Sample Accumulator
In Sample Accumulator mode the ADC can add up to 64 samples in an accumulator register, thus filtering
the signal and reducing the noise. It is useful when reading analog sensor data where a smooth signal is
required. By using a hardware accumulator instead of adding those readings in software, it reduces the
CPU load. To activate this mode, the Sample Accumulation Number in the ADC0.CTRLB register must be
set in addition to the normal ADC initialization.
Figure 5-1. ADC0.CTRLB - set SAMPNUM bit
b
ADC0.CTRLB = ADC_SAMPNUM_ACC64_gc;
The ADC conversion is started by setting the STCONV bit in the ADC0.COMMAND register.
ADC0.COMMAND = ADC_STCONV_bm;
The samples will be added up in the ADC0.RES register. The ADC_RESRDY flag is set after the number
of samples specified in ADC0.CTRLB is acquired.
while (!(ADC0.INTFLAGS & ADC_RESRDY_bm))
{
;
}
The user can read that value and divide it by the number of samples, in order to get an average value.
adcVal = ADC0.RES;
adcVal = adcVal >> ADC_SHIFT_DIV64;
The user must clear the RESRDY bit by writing ‘1’ to it before starting another conversion.
ADC0.INTFLAGS = ADC_RESRDY_bm;
TB3209
ADC Sample Accumulator
© 2018 Microchip Technology Inc. DS90003209A-page 11

Tip: The full code example is also available in the Appendix section.
TB3209
ADC Sample Accumulator
© 2018 Microchip Technology Inc. DS90003209A-page 12

6. ADC Window Comparator
In Window Comparator mode, the device can detect if the ADC result is below or above a specific
threshold value. This is useful when monitoring a signal that is required to be maintained in a specific
range, or for signaling low battery/overcharge, etc. The Window Comparator can be used in both Free
Running mode and Single Conversion mode. In this example the Window Comparator is used in Free
Running mode, because a monitored signal requires continuous sampling, and the Free Running mode
reduces the CPU load by not requiring manual start for each conversion.
For this example, a low threshold is set in the ADC0.WINLT register.
Figure 6-1. ADC-WINLT - set Low Threshold
b
b
ADC0.WINLT = WINDOW_CMP_LOW_TH_EXAMPLE;
The Conversion Window mode is set in the ADC0.CTRLE register:
Figure 6-2. ADC0.CTRLE - set Window Comparator mode
b
ADC0.CTRLE = ADC_WINCM_BELOW_gc;
TB3209
ADC Window Comparator
© 2018 Microchip Technology Inc. DS90003209A-page 13

If the ADC result is below the set threshold value, the WCOMP bit in the ADC0.INTFLAGS register is set
by the hardware.
Figure 6-3. ADC0.INTFLAGS - hardware-set WCOMP bit
b
The user must clear that bit by writing ‘1’ to it.
ADC0.INTFLAGS = ADC_WCMP_bm;
Tip: The full code example is also available in the Appendix section.
TB3209
ADC Window Comparator
© 2018 Microchip Technology Inc. DS90003209A-page 14

7. ADC Event Triggered
An ADC conversion can be triggered by an event. This is enabled by writing a ‘1’ to the Start Event Input
bit (STARTEI) in the Event Control register (ADCn.EVCTRL).
Figure 7-1. ADC0.EVTRL - enable STARTEI bit
b
ADC0.EVCTRL |= ADC_STARTEI_bm;
Any incoming event routed to the ADC through the Event System (EVSYS) will trigger an ADC
conversion. The event trigger input is edge sensitive. When an event occurs, STCONV in
ADCn.COMMAND is set. STCONV will be cleared when the conversion is complete.
For example, to start the ADC conversion on RTC overflow, the following settings must be made:
1. The RTC overflow event must be linked to channel 0 of the Event System
2. The Event User ADC0 must be configured to take its input from channel 0
3. The STARTEI bit in the EVCTRL register of the ADC must be set to enable the ADC conversion to
be triggered by events
EVSYS.CHANNEL0 = EVSYS_GENERATOR_RTC_OVF_gc; /* Real Time Counter overflow */
EVSYS.USERADC0 = EVSYS_CHANNEL_CHANNEL0_gc; /* Connect user to event channel 0 */
ADC0.EVCTRL |= ADC_STARTEI_bm; /* Enable event triggered conversion */
Tip: The full code example is also available in the Appendix section.
TB3209
ADC Event Triggered
© 2018 Microchip Technology Inc. DS90003209A-page 15

8. References
More information about the ADC operation modes can be found in the following Application Note:
1. megaAVR® 0-series Manual (DS40002015)
2. AN2573 - ADC Basics with tinyAVR® 0- and 1-series, and megaAVR® 0-series (DS00002573)
TB3209
References
© 2018 Microchip Technology Inc. DS90003209A-page 16

9. Appendix
Example 9-1. ADC Single Conversion Code Example
/* RTC Period */
#define RTC_PERIOD (511)
#include <avr/io.h>
#include <avr/interrupt.h>
uint16_t adcVal;
void ADC0_init(void);
uint16_t ADC0_read(void);
void ADC0_init(void)
{
/* Disable digital input buffer */
PORTD.PIN6CTRL &= ~PORT_ISC_gm;
PORTD.PIN6CTRL |= PORT_ISC_INPUT_DISABLE_gc;
/* Disable pull-up resistor */
PORTD.PIN6CTRL &= ~PORT_PULLUPEN_bm;
ADC0.CTRLC = ADC_PRESC_DIV4_gc /* CLK_PER divided by 4 */
| ADC_REFSEL_INTREF_gc; /* Internal reference */
ADC0.CTRLA = ADC_ENABLE_bm /* ADC Enable: enabled */
| ADC_RESSEL_10BIT_gc; /* 10-bit mode */
/* Select ADC channel */
ADC0.MUXPOS = ADC_MUXPOS_AIN6_gc;
}
uint16_t ADC0_read(void)
{
/* Start ADC conversion */
ADC0.COMMAND = ADC_STCONV_bm;
/* Wait until ADC conversion done */
while ( !(ADC0.INTFLAGS & ADC_RESRDY_bm) )
{
;
}
/* Clear the interrupt flag by writing 1: */
ADC0.INTFLAGS = ADC_RESRDY_bm;
return ADC0.RES;
}
int main(void)
{
ADC0_init();
adcVal = ADC0_read();
while (1)
{
;
}
}
Example 9-2. ADC Free Running Code Example
#include <avr/io.h>
#include <stdbool.h>
uint16_t adcVal;
TB3209
Appendix
© 2018 Microchip Technology Inc. DS90003209A-page 17

void ADC0_init(void);
uint16_t ADC0_read(void);
void ADC0_start(void);
bool ADC0_conersionDone(void);
void ADC0_init(void)
{
/* Disable digital input buffer */
PORTD.PIN6CTRL &= ~PORT_ISC_gm;
PORTD.PIN6CTRL |= PORT_ISC_INPUT_DISABLE_gc;
/* Disable pull-up resistor */
PORTD.PIN6CTRL &= ~PORT_PULLUPEN_bm;
ADC0.CTRLC = ADC_PRESC_DIV4_gc /* CLK_PER divided by 4 */
| ADC_REFSEL_INTREF_gc; /* Internal reference */
ADC0.CTRLA = ADC_ENABLE_bm /* ADC Enable: enabled */
| ADC_RESSEL_10BIT_gc; /* 10-bit mode */
/* Select ADC channel */
ADC0.MUXPOS = ADC_MUXPOS_AIN6_gc;
/* Enable FreeRun mode */
ADC0.CTRLA |= ADC_FREERUN_bm;
}
uint16_t ADC0_read(void)
{
/* Clear the interrupt flag by writing 1: */
ADC0.INTFLAGS = ADC_RESRDY_bm;
return ADC0.RES;
}
void ADC0_start(void)
{
/* Start conversion */
ADC0.COMMAND = ADC_STCONV_bm;
}
bool ADC0_conersionDone(void)
{
return (ADC0.INTFLAGS & ADC_RESRDY_bm);
}
int main(void)
{
ADC0_init();
ADC0_start();
while(1)
{
if (ADC0_conersionDone())
{
adcVal = ADC0_read();
/* In FreeRun mode, the next conversion starts automatically */
}
}
}
Example 9-3. ADC Sample Accumulator Code Example
#define ADC_SHIFT_DIV64 (6)
#include <avr/io.h>
uint16_t adcVal;
void ADC0_init(void);
uint16_t ADC0_read(void);
TB3209
Appendix
© 2018 Microchip Technology Inc. DS90003209A-page 18

void ADC0_init(void)
{
/* Disable digital input buffer */
PORTD.PIN6CTRL &= ~PORT_ISC_gm;
PORTD.PIN6CTRL |= PORT_ISC_INPUT_DISABLE_gc;
/* Disable pull-up resistor */
PORTD.PIN6CTRL &= ~PORT_PULLUPEN_bm;
ADC0.CTRLC = ADC_PRESC_DIV4_gc /* CLK_PER divided by 4 */
| ADC_REFSEL_INTREF_gc; /* Internal reference */
ADC0.CTRLA = ADC_ENABLE_bm /* ADC Enable: enabled */
| ADC_RESSEL_10BIT_gc; /* 10-bit mode */
/* Select ADC channel */
ADC0.MUXPOS = ADC_MUXPOS_AIN6_gc;
/* Set the accumulator mode to accumulate 64 samples */
ADC0.CTRLB = ADC_SAMPNUM_ACC64_gc;
}
uint16_t ADC0_read(void)
{
/* Start ADC conversion */
ADC0.COMMAND = ADC_STCONV_bm;
/* Wait until ADC conversion done */
while ( !(ADC0.INTFLAGS & ADC_RESRDY_bm) )
{
;
}
/* Clear the interrupt flag by writing 1: */
ADC0.INTFLAGS = ADC_RESRDY_bm;
return ADC0.RES;
}
int main(void)
{
ADC0_init();
while (1)
{
adcVal = ADC0_read();
/* divide by 64 */
adcVal = adcVal >> ADC_SHIFT_DIV64;
}
}
Example 9-4. ADC Window Comparator Code Example
#define WINDOW_CMP_LOW_TH_EXAMPLE (0x100)
#include <avr/io.h>
#include <stdbool.h>
uint16_t adcVal;
void ADC0_init(void);
uint16_t ADC0_read(void);
void ADC0_start(void);
bool ADC0_conersionDone(void);
bool ADC0_resultBelowTreshold(void);
void ADC0_clearWindowCmpIntFlag(void);
void LED0_init(void);
void LED0_on(void);
void LED0_off(void);
void ADC0_init(void)
{
TB3209
Appendix
© 2018 Microchip Technology Inc. DS90003209A-page 19

/* Disable digital input buffer */
PORTD.PIN6CTRL &= ~PORT_ISC_gm;
PORTD.PIN6CTRL |= PORT_ISC_INPUT_DISABLE_gc;
/* Disable pull-up resistor */
PORTD.PIN6CTRL &= ~PORT_PULLUPEN_bm;
ADC0.CTRLC = ADC_PRESC_DIV4_gc /* CLK_PER divided by 4 */
| ADC_REFSEL_INTREF_gc; /* Internal reference */
ADC0.CTRLA = ADC_ENABLE_bm /* ADC Enable: enabled */
| ADC_RESSEL_10BIT_gc; /* 10-bit mode */
/* Select ADC channel */
ADC0.MUXPOS = ADC_MUXPOS_AIN6_gc;
/* Set conversion window comparator low threshold */
ADC0.WINLT = WINDOW_CMP_LOW_TH_EXAMPLE;
/* Set conversion window mode */
ADC0.CTRLE = ADC_WINCM_BELOW_gc;
/* Enable FreeRun mode */
ADC0.CTRLA |= ADC_FREERUN_bm;
}
uint16_t ADC0_read(void)
{
/* Clear the interrupt flag by writing 1: */
ADC0.INTFLAGS = ADC_RESRDY_bm;
return ADC0.RES;
}
void ADC0_start(void)
{
/* Start conversion */
ADC0.COMMAND = ADC_STCONV_bm;
}
bool ADC0_conersionDone(void)
{
return (ADC0.INTFLAGS & ADC_RESRDY_bm);
}
bool ADC0_resultBelowTreshold(void)
{
return (ADC0.INTFLAGS & ADC_WCMP_bm);
}
void ADC0_clearWindowCmpIntFlag(void)
{
/* Clear the interrupt flag by writing 1: */
ADC0.INTFLAGS = ADC_WCMP_bm;
}
void LED0_init(void)
{
/* Make High (OFF) */
PORTB.OUT |= PIN5_bm;
/* Make output */
PORTB.DIR |= PIN5_bm;
}
void LED0_on(void)
{
/* Make Low (ON) */
PORTB.OUT &= ~PIN5_bm;
}
void LED0_off(void)
{
/* Make High (OFF) */
PORTB.OUT |= PIN5_bm;
}
TB3209
Appendix
© 2018 Microchip Technology Inc. DS90003209A-page 20