# avr128da48-using-12-bit-adc

**Repository Path**: microchip-pic-avr-examples/avr128da48-using-12-bit-adc

## Basic Information

- **Project Name**: avr128da48-using-12-bit-adc
- **Description**: Using 12-bit ADC on AVR-DA
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-06-17
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div id="readme" class="Box-body readme blob js-code-block-container">
 <article class="markdown-body entry-content p-3 p-md-6" itemprop="This needs to locked down and 'never' changed"><p><a href="https://www.microchip.com" rel="nofollow"><img src="images/Microchip.png" alt="MCHP" width="300";"></a></p>

# Using 12-bit ADC for Conversions, Accumulation, and Triggering Events

This repository contains examples of bare metal source code for DAC as described in "Using 12-bit ADC for Conversions, Accumulation, and Triggering Events" document from Microchip.
The repository contains an Atmel Studio Solution with multiple projects inside.

Use Cases:
<a name="UseCases" id="UseCases"></a>
1. <a href="#Differential">ADC Differential Conversion</a>
2. <a href="#EventTriggered">ADC Event Triggered</a>
3. <a href="#FreeRunning">ADC Free Running</a>
4. <a href="#SampleAcc">ADC Sample Accumulator</a>
5. <a href="#SingleConv">ADC Single Conversion</a>
6. <a href="#Temperature">ADC Temperature Measurement</a>
7. <a href="#Window">ADC Window Comparator</a>

## Related Documentation
More details and code examples on the AVR128DA48 can be found at the following links:
- [TB3245 - Using 12-Bit ADC for Conversions, Accumulation, and Triggering Events](http://www.microchip.com/wwwappnotes/appnotes.aspx?appnote=en1001530)
- [AVR128DA48 Product Page](https://www.microchip.com/wwwproducts/en/AVR128DA48)
- [AVR128DA48 Code Examples on GitHub](https://github.com/microchip-pic-avr-examples?q=avr128da48)
- [AVR128DA48 Project Examples in START](https://start.atmel.com/#examples/AVR128DA48CuriosityNano)

## Software Used
- Atmel Studio 7.0.2397 or newer [(microchip.com/mplab/avr-support/atmel-studio-7)](https://www.microchip.com/mplab/avr-support/atmel-studio-7)
- AVR-Dx 1.0.18 or newer Device Pack [(packs.download.microchip.com/)](https://packs.download.microchip.com/)


## Hardware Used
- AVR128DA48 Curiosity Nano [(DM164151)](https://www.microchip.com/Developmenttools/ProductDetails/DM164151)
- Curiosity Nano Base for Click Boards [(AC164162)](https://www.microchip.com/Developmenttools/ProductDetails/AC164162)
- POT click board [(MIKROE-3402)](https://www.mikroe.com/pot-click) or POT 2 click board [(MIKROE-3325)](https://www.mikroe.com/pot-2-click)

## Setup

The AVR128DA48 Curiosity Nano Development Board is used as test platform, inserted into the Curiosity Nano Base.
<br><img src="images/AVR128DA48_CNANO_instructions.PNG" width="500">

Two setups will be used for the use cases described in this document:

<a name="ConfigA" id="ConfigA"> </a>
  - **The Hardware Configuration A** uses a POT click, inserted in mikroBUS slot 1, connects AN1 to the PD3(AIN3) pin of AVR® DA microcontroller.
<br><img src="images/HardwareAs.jpg" width="500">

<br>The following configurations must be made for Hardware Configuration A:

|Pin           | Configuration      |
| :----------: | :----------------: |
|PD3 (AIN3)    | Analog Input       |
|PC6 (LED0)    | Digital Output     |

<a name="ConfigB" id="ConfigB"> </a>
  - **The Hardware Configuration B** uses two POT clicks, inserted in mikroBUS slot 1 and slot 2. Slot 1
connects AN1 to the PD3 (AIN3) and slot 2 connects AN2 to PD4 (AIN4) pin of the AVR® DA microcontroller.
<br><img src="images/HardwareBs.JPG" width="500">

<br>The following configurations must be made for Hardware Configuration B:

|Pin           | Configuration      |
| :----------: | :----------------: |
|PD3 (AIN3)    | Analog Input       |
|PD4 (AIN4)    | Analog Input       |
|PC6 (LED0)    | Digital Output     |

## Operation

<a name="Differential" id="Differential"> </a>
### ADC Differential Conversion
This example will initialize the ADC, configure two pins for reading the differential voltage, start the conversion and read the ADC result in an infinite loop.

**The Hardware <a href="#ConfigB">Configuration B</a> will be used for this example**
1. Connect the board to the PC.
2. Open the *AVRDA_ADC_Examples.atsln* solution in Atmel Studio
3. Set *ADC_Differential_Conversion* project as StartUp project:
<br><img src="images/ADC_Diffential_Step3.png" width="500">
4. Build the *ADC_Differential_Conversion* project: right click on *ADC_Differential_Conversion* and select Build
<br><img src="images/ADC_Diffential_Step4.png" width="500">
5. Select the AVR128DA48 Curiosity Nano on-board debugger in the *Tool* section of the *AVR-Dx_Bootloader* project settings:
<br><img src="images/ADC_Diffential_Step5.png" width="500">
   - Right click on the project and click *Properties*;
   - Click *Tool* tab on the left panel, select the corresponding debugger and save the configuration (Ctrl + S)
6. Select Debug → Start Debugging and Break (Alt+F5)
<br><img src="images/ADC_Diffential_Step6.png" width="500">
   - Add a brake point on `adcVal` in the main function
7. Result: Rotating the Potentiometers on the POT click boards (while pressing F5 key), the adcVal result will vary from a positive to a negative value:
<br><img src="images/ADC_Diffential_Step7.gif" width="500">


<a name="EventTriggered" id="EventTriggered"> </a>
### ADC Event Triggered
This example will initialize the ADC and Real-Time Counter (RTC), configure the Event System (EVSYS) to trigger an
ADC conversion on the RTC overflow; an LED is toggled on after each ADC conversion.

**The Hardware <a href="#ConfigA">Configuration A</a> will be used for this example**
1. Connect the board to the PC.
2. Open the *AVRDA_ADC_Examples.atsln* solution in Atmel Studio
3. Set *ADC_Event_Triggered* project as StartUp project
4. Right click on *ADC_Event_Triggered* and select Build
5. Select the AVR128DA48 Curiosity Nano on-board debugger in the *Tool* section of the *AVR-Dx_Bootloader* project settings:
   - Right click on the project and click *Properties*;
   - Click *Tool* tab on the left panel, select the corresponding debugger and save the configuration (Ctrl + S)
6. Result: The LED0 will toggle with a frequency of `RTC_PERIOD`, that can be modified
<br><img src="images/ADC_Event_Step6.GIF" width="500">

<a name="FreeRunning" id="FreeRunning"> </a>
### ADC Free Running
This example will Initialize the ADC, enable Free Running mode, start the conversion and read the ADC result in an infinite loop.

**The Hardware <a href="#ConfigA">Configuration A</a> will be used for this example**
1. Connect the board to the PC.
2. Open the *AVRDA_ADC_Examples.atsln* solution in Atmel Studio
3. Set *ADC_Free_Running* project as StartUp project
4. Right click on *ADC_Free_Running* and select Build
5. Select the AVR128DA48 Curiosity Nano on-board debugger in the *Tool* section of the *AVR-Dx_Bootloader* project settings:
   - Right click on the project and click *Properties*;
   - Click *Tool* tab on the left panel, select the corresponding debugger and save the configuration (Ctrl + S)
6. Select Debug → Start Debugging and Break (Alt+F5)
   - Add a brake point on `adcVal` in the main function
7. Result: Rotating the Potentiometer on the POT click board (while pressing F5 key ), the adcVal result will vary:
<br><img src="images/ADC_FreeRun_Step7.gif" width="500">

<a name="SampleAcc" id="SampleAcc"> </a>
### ADC Sample Accumulator
This example will Initialize the ADC, enable accumulation of 64 samples, start the conversion and read the ADC result in a loop.

**The Hardware <a href="#ConfigA">Configuration A</a> will be used for this example**
1. Connect the board to the PC.
2. Open the *AVRDA_ADC_Examples.atsln* solution in Atmel Studio
3. Set *ADC_Sample_Accumulator* project as StartUp project
4. Right click on *ADC_Sample_Accumulator* and select Build
5. Select the AVR128DA48 Curiosity Nano on-board debugger in the *Tool* section of the *AVR-Dx_Bootloader* project settings:
   - Right click on the project and click *Properties*;
   - Click *Tool* tab on the left panel, select the corresponding debugger and save the configuration (Ctrl + S)
6. Select Debug → Start Debugging and Break (Alt+F5)
   - Add a brake point on `adcVal` in the main function
7. Result: Rotating the Potentiometer on the POT click board (while pressing F5 key), the adcVal result will vary:
<br><img src="images/ADC_SampleAcc_Step7.gif" width="500">

<a name="SingleConv" id="SingleConv"> </a>
### ADC Single Conversion
This example will initialize the ADC, start the conversion and wait until it is completed, and read ADC result in a loop.

**The Hardware <a href="#ConfigA">Configuration A</a> will be used for this example**
1. Connect the board to the PC.
2. Open the *AVRDA_ADC_Examples.atsln* solution in Atmel Studio
3. Set *ADC_Single_Conversion* project as StartUp project
4. Right click on *ADC_Single_Conversion* and select Build
5. Select the AVR128DA48 Curiosity Nano on-board debugger in the *Tool* section of the *AVR-Dx_Bootloader* project settings:
   - Right click on the project and click *Properties*;
   - Click *Tool* tab on the left panel, select the corresponding debugger and save the configuration (Ctrl + S)
6. Select Debug → Start Debugging and Break (Alt+F5)
   - Add a brake point on `adcVal` in the main function
7. Result: Rotating the Potentiometer on the POT click board (while pressing F5 key), the adcVal result will vary:
<br><img src="images/ADC_Single_Step7.gif" width="500">

<a name="Temperature" id="Temperature"> </a>
### ADC Temperature Measurement
This example will initialize the ADC, select the temperature sensor as input and acquire the data by running a 12-bit, right adjusted, single-ended conversion.

**The Hardware <a href="#ConfigA">Configuration A</a> will be used for this example**
1. Connect the board to the PC.
2. Open the *AVRDA_ADC_Examples.atsln* solution in Atmel Studio
3. Set *ADC_Temperature_Measurement* project as StartUp project
4. Right click on *ADC_Temperature_Measurement* and select Build
5. Select the AVR128DA48 Curiosity Nano on-board debugger in the *Tool* section of the *AVR-Dx_Bootloader* project settings:
   - Right click on the project and click *Properties*;
   - Click *Tool* tab on the left panel, select the corresponding debugger and save the configuration (Ctrl + S)
6. Select Debug → Start Debugging and Break (Alt+F5)
   - Add a brake point on `temp_C` in the main function
7. Result: Pressing the F5 key, the `temp_C` Value will show the ambient temperature in Celsius (25°C):
<br><img src="images/ADC_Temp_Step7.png" width="500">

<a name="Window" id="Window"> </a>
### ADC Window Comparator
This example will set the conversion window comparator low threshold, enable the conversion Window mode,
enable the Free Running mode, start the conversion and wait until it is completed, read the ADC result in an
infinite loop, an LED is toggled on if the ADC result is below the set threshold.

**The Hardware <a href="#ConfigA">Configuration A</a> will be used for this example**
1. Connect the board to the PC.
2. Open the *AVRDA_ADC_Examples.atsln* solution in Atmel Studio
3. Set *ADC_Window_Comparator* project as StartUp project
4. Right click on *ADC_Window_Comparator* and select Build
5. Select the AVR128DA48 Curiosity Nano on-board debugger in the *Tool* section of the *AVR-Dx_Bootloader* project settings:
   - Right click on the project and click *Properties*;
   - Click *Tool* tab on the left panel, select the corresponding debugger and save the configuration (Ctrl + S)
6. Result: Rotating the Potentiometer on the POT click board will modify the adcVal untill LED0 will turn off:
<br><img src="images/ADC_Window_Step6.GIF" width="500">

## Summary
The [*TB3245 - Using 12-Bit ADC for Conversions, Accumulation, and Triggering Events](http://www.microchip.com/wwwappnotes/appnotes.aspx?appnote=en1001530) document provides <a href="#UseCases">seven use cases</a> for using the 12-bit ADC of The AVR® DA family of microcontrollers.