Class _adb: 10-bit analog to digital converter

This class is used by:

• ATmega48A/PA/88A/PA/168A/PA/328/P : adc0

Features

• 10-bit resolution, left or right adustement of the result
• 8 multiplexed single-ended input channels (6 available on PDIP packages)
• Temperature sensor input channel
• 0..Vcc input voltage range
• Internal 1,1 V bandgap, AVcc, or external voltage reference
• Single conversion mode, free-running, and 7 auto trigger sources
• 65-260 μs conversion time (3.8-15.4 ksps). A complete normal conversion takes 13 clock cycles, 13.5 in the auto-trigger mode, and 25 for the initial conversion.

Interrupts

• (adc0,irq): conversion completed

Actions

hwa( configure, ... ) configures the ADC.

hwa( configure, adc0,
 
     //  Clock source: the resulting clock frequency should be in
     //  the 50..200 kHz range for maximum resolution, and in all
     //  case lower than 1 MHz.
     //
     clock,     min                          // Nearest 50 kHz
              | max                          // Nearest 200 kHz
              | ioclk / 2**(1..7),           // IOCLK divided by 2,4,..,128
 
     //  How a conversion is started
     //
     trigger,   manual                       // Use hw(trigger,adc0)
              | auto                         // As soon as a conversion is completed
              | (acmp0,irq)                  // Other trigger sources
              | (int0,irq)                   //
              | (counter0,compare0,irq)      //
              | (counter0,overflow,irq)      //
              | (counter1,compare1,irq)      //
              | (counter1,overflow,irq)      //
              | (counter1,capture,irq),      //
 
     //  Voltage reference
     //
     vref,      (pin,avcc)                   // Voltage on AVCC pin
              | (pin,aref)                   // Voltage on AREF pin
              | bandgap_1100mV,              // Internal 1.1V bandgap
 
     //  Result alignment
     //
   [ align,     left                         //
              | right, ]                     // Default
 
     //  Input
     //
     input,     (pin,adc0..7)
              | gnd
              | bandgap_1100mV
              | temperature
);

Note

The ADC and the analog comparator share the same output of the analog multiplexer. The ADC is disabled after reset. Configuring the ADC automatically enables it. When the ADC is enabled, the analog comparator acmp0 can not use the analog multiplexer output. Use hw(disable,adc0) to disable the ADC and let acmp0 use the analog multiplexer output.

hw( enable, ... ) / hwa( enable, ... ) enables the ADC.

hw( enable, adc0 );

hwa( enable, adc0 );

hw( disable, ... ) / hwa( disable, ... ) disables the ADC.

hw( disable, adc0 );

hwa( disable, adc0 );

hw( trigger, ... ) / hwa( trigger, ... ) starts a conversion.

hw( trigger, adc0 );

hwa( trigger, adc0 );

hw( read, ... ) returns the result of the conversion.

uint16_t adc = hw( read, adc0 );

hw( read_atomic, ... ) returns the result of the conversion after having cleared the I bit of the status register and set it again as soon as possible.

uint16_t adc = hw( read_atomic, adc0 );

hw( stat, ... ) returns the status of the ADC, that contains a single 'busy' bit.

hw_stat_t(adc0)      st ;
st = hw(stat,adc0);
if ( !st.busy )              // No conversion pending?
  hw( trigger, adc0 );       //   Trigger one

You'll use the IRQ flag to test whether a conversion is completed:

hw( trigger, adc0 );
while ( !hw( read, (adc0,irq) ) ) {}
hw( clear, (adc0,irq) );
uint16_t result = hw( read, adc0 );

Registers

Hardware registers:

• admux: analog multiplexer and voltage reference
• sra: control/status register a
• srb: control/status register b
• adc: conversion result

Logical registers:

• refs: voltage reference
• mux: analog multiplexer
• en: enable
• sc: start conversion
• ate: auto trigger enable
• ps: clock prescaler
• bin: bipolar input mode
• lar: left-aligned result
• ts: trigger source
• ie: conversion done IRQ mask
• if: conversion done IRQ flag