ADC

Introduction

The MikroSDK.Driver.ADC library simplifies the process of reading analog voltage values from ADC pins.

It abstracts the low-level hardware details, providing a straightforward library functionalities to initialize ADC peripherals and read their values.

This documentation will guide you through setting up the environment, initializing the ADC driver, and performing analog readings.

Library Name

• MikroSDK.Driver.ADC

Library Files

• GitHub Repository:

  • Header file
  • Source file
  • Configuration (CMake) file

Prerequisites

• Library Manager:

  • Select Driver.ADC to add the library to your project using the Library Manager in NECTO Studio.

• Headers:

  • Include the Driver.ADC header in your source files to access the GPIO output functions.
  • This header pops up in the lower right part of NECTO Studio once you perform the previous task (while selecting Driver.ADC in Library Manager)
  • Alternatively, include the drv_analog_in.h header in your source files to access the GPIO output functions.

• CMakeLists:

  • You do not have to perform anything, configuration (CMake) file is already taken care of automatically while you performed the first task in this Prerequisites!
  • You can ensure that your CMakeLists.txt includes the necessary configurations to link against the MikroSDK.Driver.ADC library.

Code Examples

• How do I initialize the ADC driver using drv_analog_in.h?

/* Project name:
 *   How do I initialize the ADC driver?
 * Copyright:
 *   (c) MIKROE, 2024.
 * Description:
 *   This example demonstrates the functionality of ADC (Analog-to-Digital Converter)
 *   using mikroSDK. ADC shall be initialized, ADC value shall be read as well as
 *   actual voltage on ADC pin.
 * How to test this code example?
 *   - Run debug mode by pressing F9 on your keyboard;
 *   - Insert `read_data_buffer` and `read_data_buffer_voltage` variables in Debug Watch window;
 *   - Step Over (F8 on your keyboard) to read ADC values.
 * Library dependencies?
 *   - Make sure `Driver.ADC`, `Driver.GPIO.Port` and `Board` libraries are enabled in NECTO's
 *     Library Manager to ensure a successful build.
 */

// ------------------------------------------------------------------ INCLUDES
/**
 * Any initialization code needed for MCU to function properly.
 * Do not remove this line or clock might not be set correctly.
 */
#ifdef PREINIT_SUPPORTED
#include "preinit.h"
#endif

#include "drv_analog_in.h"  // Header for Analog input driver.
#include "board.h"          // Main board pin mapping.

// -------------------------------------------------------------------- MACROS
// Voltage reference value.
#define ADC_VREF_VALUE 3.3f // It can be changed in CODEGRIP Suite: POWER -> Outputs -> Voltage Reference -> Set Voltage.

// ------------------------------------------------------------------ VARIABLES
analog_in_t adc;            // Analog input driver context structure.
analog_in_config_t adc_cfg; // Analog input configuration structure.

uint16_t read_data_buffer;  // Analog input data buffer.
float read_data_buffer_voltage; // Analog input data buffer (voltage).

int main(void)
{
    /* Do not remove this line or clock might not be set correctly. */
    #ifdef PREINIT_SUPPORTED
    preinit();
    #endif

    // Initialize ADC configuration structure to default values
    analog_in_configure_default(&adc_cfg);

    // Set the correct input pin here (analog pin on mikroBUS 1 slot is currently set)
    adc_cfg.input_pin = MIKROBUS_1_AN; // example: `PA0` or `MIKROBUS_4_AN` or `HAL_PIN_NC` (`Pin not connected` state)

    // Set the correct ADC resolution
    adc_cfg.resolution = ANALOG_IN_RESOLUTION_12_BIT;

    // Set the desired reference voltage
    adc_cfg.vref_value = ADC_VREF_VALUE;

    // Initialize the ADC
    if( ACQUIRE_FAIL == analog_in_open( &adc, &adc_cfg ) ) {
        // Error handling
    }

    // Configure ADC resolution
    if( ADC_ERROR == analog_in_set_resolution( &adc, adc_cfg.resolution ) ) {
        // Error handling
    }

    // Configure ADC voltage reference input source
    if( ADC_ERROR == analog_in_set_vref_input( &adc, ANALOG_IN_VREF_EXTERNAL ) ) {
        // Error handling
    }

    // Configure ADC voltage reference value
    if( ADC_ERROR == analog_in_set_vref_value( &adc, ADC_VREF_VALUE ) ) {
        // Error handling
    }

    // Finally, read the analog value (which depends on ADC resolution)
    if( ADC_ERROR == analog_in_read( &adc, &read_data_buffer ) ) {
        // Error handling
    }

    Delay_ms(500); // Delay for 500 milliseconds

    // You are able to read the actual voltage on the pin as well
    if( ADC_ERROR == analog_in_read_voltage( &adc, &read_data_buffer_voltage ) ) {
        // Error handling
    }

    // Close ADC driver context object
    if ( ADC_SUCCESS == analog_in_close( &adc ) ) // De-allocates hardware resources for the driver object
    {
        // No error
    } else {
        // Handle the error
    }

    return 0;
}

• How do I set a reference voltage value for the ADC?

/* Project name:
 *   How do I set a reference voltage value for the ADC?
 * Copyright:
 *   (c) MIKROE, 2024.
 * Description:
 *   This example demonstrates the configuration of a reference voltage
 *   value for the ADC (Analog-to-Digital Converter) using mikroSDK.
 *   ADC shall be initialized, reference voltage shall be set.
 * Library dependencies?
 *   - Make sure `Driver.ADC`, `Driver.GPIO.Port` and `Board` libraries are enabled in NECTO's
 *     Library Manager to ensure a successful build.
 */

// ------------------------------------------------------------------ INCLUDES
/**
 * Any initialization code needed for MCU to function properly.
 * Do not remove this line or clock might not be set correctly.
 */
#ifdef PREINIT_SUPPORTED
#include "preinit.h"
#endif

#include "drv_analog_in.h"  // Header for Analog input driver.
#include "board.h"          // Main board pin mapping.

// -------------------------------------------------------------------- MACROS
// Voltage reference value.
#define ADC_VREF_VALUE 3.3f // It can be changed in CODEGRIP Suite: POWER -> Outputs -> Voltage Reference -> Set Voltage.

// ------------------------------------------------------------------ VARIABLES
analog_in_t adc;            // Analog input driver context structure.
analog_in_config_t adc_cfg; // Analog input configuration structure.

int main(void)
{
    /* Do not remove this line or clock might not be set correctly. */
    #ifdef PREINIT_SUPPORTED
    preinit();
    #endif

    // Set the desired reference voltage
    adc_cfg.vref_value = ADC_VREF_VALUE;

    // Initialize the ADC
    if( ACQUIRE_FAIL == analog_in_open( &adc, &adc_cfg ) ) {
        // Error handling
    }

    // Configure ADC voltage reference value
    if( ADC_ERROR == analog_in_set_vref_value( &adc, ADC_VREF_VALUE ) ) {
        // Error handling
    }

    return 0;
}

• How do I read raw ADC values from the input pin?

/* Project name:
 *   How do I read raw ADC values from the input pin?
 * Copyright:
 *   (c) MIKROE, 2024.
 * Description:
 *   This example demonstrates reading raw ADC values from the input pin of an ADC
 *   (Analog-to-Digital Converter) using mikroSDK.
 *   ADC should be initialized and raw ADC value shall be read.
 * How to test this code example?
 *   - Run debug mode by pressing F9 on your keyboard;
 *   - Insert `read_data_buffer` variable in Debug Watch window;
 *   - Step Over (F8 on your keyboard) to read raw ADC value.
 * Library dependencies?
 *   - Make sure `Driver.ADC`, `Driver.GPIO.Port` and `Board` libraries are enabled in NECTO's
 *     Library Manager to ensure a successful build.
 */

// ------------------------------------------------------------------ INCLUDES
/**
 * Any initialization code needed for MCU to function properly.
 * Do not remove this line or clock might not be set correctly.
 */
#ifdef PREINIT_SUPPORTED
#include "preinit.h"
#endif

#include "drv_analog_in.h"  // Header for Analog input driver.
#include "board.h"          // Main board pin mapping.

// -------------------------------------------------------------------- MACROS
// Voltage reference value.
#define ADC_VREF_VALUE 3.3f // It can be changed in CODEGRIP Suite: POWER -> Outputs -> Voltage Reference -> Set Voltage.

// ------------------------------------------------------------------ VARIABLES
analog_in_t adc;            // Analog input driver context structure.
analog_in_config_t adc_cfg; // Analog input configuration structure.

uint16_t read_data_buffer;  // Analog input data buffer.

int main(void)
{
    /* Do not remove this line or clock might not be set correctly. */
    #ifdef PREINIT_SUPPORTED
    preinit();
    #endif

    // Initialize ADC configuration structure to default values
    analog_in_configure_default(&adc_cfg);

    // Set the correct input pin here (analog pin on mikroBUS 1 slot is currently set)
    adc_cfg.input_pin = MIKROBUS_1_AN; // example: `PA0` or `MIKROBUS_4_AN` or `HAL_PIN_NC` (`Pin not connected` state)

    // Set the correct ADC resolution
    adc_cfg.resolution = ANALOG_IN_RESOLUTION_12_BIT;

    // Set the desired reference voltage
    adc_cfg.vref_value = ADC_VREF_VALUE;

    // Initialize the ADC
    if( ACQUIRE_FAIL == analog_in_open( &adc, &adc_cfg ) ) {
        // Error handling
    }

    // Configure ADC resolution
    if( ADC_ERROR == analog_in_set_resolution( &adc, adc_cfg.resolution ) ) {
        // Error handling
    }

    // Configure ADC voltage reference input source
    if( ADC_ERROR == analog_in_set_vref_input( &adc, ANALOG_IN_VREF_EXTERNAL ) ) {
        // Error handling
    }

    // Configure ADC voltage reference value
    if( ADC_ERROR == analog_in_set_vref_value( &adc, ADC_VREF_VALUE ) ) {
        // Error handling
    }

    // Finally, read the raw ADC value (which depends on ADC resolution)
    if( ADC_ERROR == analog_in_read( &adc, &read_data_buffer ) ) {
        // Error handling
    }

    return 0;
}

• How do I read a converted voltage from the ADC input pin?

/* Project name:
 *   How do I read a converted voltage from the ADC input pin?
 * Copyright:
 *   (c) MIKROE, 2024.
 * Description:
 *   This example demonstrates reading converted ADC voltage
 *   from the ADC input pin of an ADC (Analog-to-Digital Converter)
 *   using mikroSDK. ADC should be initialized and raw ADC
 *   value shall be read.
 * How to test this code example?
 *   - Run debug mode by pressing F9 on your keyboard;
 *   - Insert `read_data_buffer_voltage` variable in Debug Watch window;
 *   - Step Over (F8 on your keyboard) to read ADC voltage.
 * Library dependencies?
 *   - Make sure `Driver.ADC`, `Driver.GPIO.Port` and `Board` libraries are enabled in NECTO's
 *     Library Manager to ensure a successful build.
 */

// ------------------------------------------------------------------ INCLUDES
/**
 * Any initialization code needed for MCU to function properly.
 * Do not remove this line or clock might not be set correctly.
 */
#ifdef PREINIT_SUPPORTED
#include "preinit.h"
#endif

#include "drv_analog_in.h"  // Header for Analog input driver.
#include "board.h"          // Main board pin mapping.

// -------------------------------------------------------------------- MACROS
// Voltage reference value.
#define ADC_VREF_VALUE 3.3f // It can be changed in CODEGRIP Suite: POWER -> Outputs -> Voltage Reference -> Set Voltage.

// ------------------------------------------------------------------ VARIABLES
analog_in_t adc;            // Analog input driver context structure.
analog_in_config_t adc_cfg; // Analog input configuration structure.

float read_data_buffer_voltage; // Analog input data buffer (voltage).

int main(void)
{
    /* Do not remove this line or clock might not be set correctly. */
    #ifdef PREINIT_SUPPORTED
    preinit();
    #endif

    // Initialize ADC configuration structure to default values
    analog_in_configure_default(&adc_cfg);

    // Set the correct input pin here (analog pin on mikroBUS 1 slot is currently set)
    adc_cfg.input_pin = MIKROBUS_1_AN; // example: `PA0` or `MIKROBUS_4_AN` or `HAL_PIN_NC` (`Pin not connected` state)

    // Set the correct ADC resolution
    adc_cfg.resolution = ANALOG_IN_RESOLUTION_12_BIT;

    // Set the desired reference voltage
    adc_cfg.vref_value = ADC_VREF_VALUE;

    // Initialize the ADC
    if( ACQUIRE_FAIL == analog_in_open( &adc, &adc_cfg ) ) {
        // Error handling
    }

    // Configure ADC resolution
    if( ADC_ERROR == analog_in_set_resolution( &adc, adc_cfg.resolution ) ) {
        // Error handling
    }

    // Configure ADC voltage reference input source
    if( ADC_ERROR == analog_in_set_vref_input( &adc, ANALOG_IN_VREF_EXTERNAL ) ) {
        // Error handling
    }

    // Configure ADC voltage reference value
    if( ADC_ERROR == analog_in_set_vref_value( &adc, ADC_VREF_VALUE ) ) {
        // Error handling
    }

    // Finally, you are able to read the actual voltage on the pin
    if( ADC_ERROR == analog_in_read_voltage( &adc, &read_data_buffer_voltage ) ) {
        // Error handling
    }

    return 0;
}

• How do I close the ADC driver?

/* Project name:
 *   How do I close the ADC driver?
 * Copyright:
 *   (c) MIKROE, 2024.
 * Description:
 *   This example demonstrates the functionality of ADC (Analog-to-Digital Converter)
 *   using mikroSDK. ADC shall be initialized, ADC value shall be read as well as
 *   actual voltage on ADC pin, and finally closing the ADC driver shall be called.
 * How to test this code example?
 *   - Toggle breakpoint on the line where `analog_in_close` functionality is called;
 *   - Run debug mode by pressing F9 on your keyboard;
 *   - Continue debug (F6 on your keyboard) to get to the line;
 *   - Insert `adc` analog input driver context structure in Debug Watch window;
 *   - Step Over (F8 on your keyboard) to see the de-allocation in action.
 * Library dependencies?
 *   - Make sure `Driver.ADC`, `Driver.GPIO.Port` and `Board` libraries are enabled in NECTO's
 *     Library Manager to ensure a successful build.
 */

// ------------------------------------------------------------------ INCLUDES
/**
 * Any initialization code needed for MCU to function properly.
 * Do not remove this line or clock might not be set correctly.
 */
#ifdef PREINIT_SUPPORTED
#include "preinit.h"
#endif

#include "drv_analog_in.h"  // Header for Analog input driver.
#include "board.h"          // Main board pin mapping.

// -------------------------------------------------------------------- MACROS
// Voltage reference value.
#define ADC_VREF_VALUE 3.3f // It can be changed in CODEGRIP Suite: POWER -> Outputs -> Voltage Reference -> Set Voltage.

// ------------------------------------------------------------------ VARIABLES
analog_in_t adc;            // Analog input driver context structure.
analog_in_config_t adc_cfg; // Analog input configuration structure.

uint16_t read_data_buffer;  // Analog input data buffer.
float read_data_buffer_voltage; // Analog input data buffer (voltage).

int main(void)
{
    /* Do not remove this line or clock might not be set correctly. */
    #ifdef PREINIT_SUPPORTED
    preinit();
    #endif

    // Initialize ADC configuration structure to default values
    analog_in_configure_default(&adc_cfg);

    // Set the correct input pin here (analog pin on mikroBUS 1 slot is currently set)
    adc_cfg.input_pin = MIKROBUS_1_AN; // example: `PA0` or `MIKROBUS_4_AN` or `HAL_PIN_NC` (`Pin not connected` state)

    // Set the correct ADC resolution
    adc_cfg.resolution = ANALOG_IN_RESOLUTION_12_BIT;

    // Set the desired reference voltage
    adc_cfg.vref_value = ADC_VREF_VALUE;

    // Initialize the ADC
    if( ACQUIRE_FAIL == analog_in_open( &adc, &adc_cfg ) ) {
        // Error handling
    }

    // Configure ADC resolution
    if( ADC_ERROR == analog_in_set_resolution( &adc, adc_cfg.resolution ) ) {
        // Error handling
    }

    // Configure ADC voltage reference input source
    if( ADC_ERROR == analog_in_set_vref_input( &adc, ANALOG_IN_VREF_EXTERNAL ) ) {
        // Error handling
    }

    // Configure ADC voltage reference value
    if( ADC_ERROR == analog_in_set_vref_value( &adc, ADC_VREF_VALUE ) ) {
        // Error handling
    }

    // Finally, read the analog value (which depends on ADC resolution)
    if( ADC_ERROR == analog_in_read( &adc, &read_data_buffer ) ) {
        // Error handling
    }

    Delay_ms(500); // Delay for 500 milliseconds

    // You are able to read the actual voltage on the pin as well
    if( ADC_ERROR == analog_in_read_voltage( &adc, &read_data_buffer_voltage ) ) {
        // Error handling
    }

    // Close ADC driver context object
    if ( ADC_SUCCESS == analog_in_close( &adc ) ) // De-allocates hardware resources for the driver object
    {
        // No error
    } else {
        // Handle the error
    }

    return 0;
}

• How do I reconfigure the ADC driver after it has been initialized?

/* Project name:
 *   How do I reconfigure the ADC driver after it has been initialized?
 * Copyright:
 *   (c) MIKROE, 2024.
 * Description:
 *   This example demonstrates the functionality of ADC (Analog-to-Digital Converter)
 *   using mikroSDK.
 *   ADC shall be initialized, ADC value shall be read as well as actual voltage
 *   on ADC pin, closing the ADC driver shall be called followed by
 *   ADC reconfiguration (ADC resolution had been changed) and finally another
 *   opening of the ADC object shall be called.
 * How to test this code example?
 *   - Toggle breakpoint on the line where `analog_in_close` functionality is called;
 *   - Run debug mode by pressing F9 on your keyboard;
 *   - Continue debug (F6 on your keyboard) to get to the line;
 *   - Insert `adc` analog input driver context structure in Debug Watch window;
 *   - Step Over (F8 on your keyboard) to see the de-allocation and allocation in action.
 * Library dependencies?
 *   - Make sure `Driver.ADC`, `Driver.GPIO.Port` and `Board` libraries are enabled in NECTO's
 *     Library Manager to ensure a successful build.
 */

// ------------------------------------------------------------------ INCLUDES
/**
 * Any initialization code needed for MCU to function properly.
 * Do not remove this line or clock might not be set correctly.
 */
#ifdef PREINIT_SUPPORTED
#include "preinit.h"
#endif

#include "drv_analog_in.h"  // Header for Analog input driver.
#include "board.h"          // Main board pin mapping.

// -------------------------------------------------------------------- MACROS
// Voltage reference value.
#define ADC_VREF_VALUE 3.3f // It can be changed in CODEGRIP Suite: POWER -> Outputs -> Voltage Reference -> Set Voltage.

// ------------------------------------------------------------------ VARIABLES
analog_in_t adc;            // Analog input driver context structure.
analog_in_config_t adc_cfg; // Analog input configuration structure.

uint16_t read_data_buffer;  // Analog input data buffer.
float read_data_buffer_voltage; // Analog input data buffer (voltage).

int main(void)
{
    /* Do not remove this line or clock might not be set correctly. */
    #ifdef PREINIT_SUPPORTED
    preinit();
    #endif

    // Initialize ADC configuration structure to default values
    analog_in_configure_default(&adc_cfg);

    // Set the correct input pin here (analog pin on mikroBUS 1 slot is currently set)
    adc_cfg.input_pin = MIKROBUS_1_AN; // example: `PA0` or `MIKROBUS_4_AN` or `HAL_PIN_NC` (`Pin not connected` state)

    // Set the correct ADC resolution
    adc_cfg.resolution = ANALOG_IN_RESOLUTION_12_BIT;

    // Set the desired reference voltage
    adc_cfg.vref_value = ADC_VREF_VALUE;

    // Initialize the ADC
    if( ACQUIRE_FAIL == analog_in_open( &adc, &adc_cfg ) ) {
        // Error handling
    }

    // Configure ADC resolution
    if( ADC_ERROR == analog_in_set_resolution( &adc, adc_cfg.resolution ) ) {
        // Error handling
    }

    // Configure ADC voltage reference input source
    if( ADC_ERROR == analog_in_set_vref_input( &adc, ANALOG_IN_VREF_EXTERNAL ) ) {
        // Error handling
    }

    // Configure ADC voltage reference value
    if( ADC_ERROR == analog_in_set_vref_value( &adc, ADC_VREF_VALUE ) ) {
        // Error handling
    }

    // Finally, read the analog value (which depends on ADC resolution)
    if( ADC_ERROR == analog_in_read( &adc, &read_data_buffer ) ) {
        // Error handling
    }

    Delay_ms(500); // Delay for 500 milliseconds

    // You are able to read the actual voltage on the pin as well
    if( ADC_ERROR == analog_in_read_voltage( &adc, &read_data_buffer_voltage ) ) {
        // Error handling
    }

    // Close ADC driver context object
    if ( ADC_SUCCESS == analog_in_close( &adc ) ) // De-allocates hardware resources for the driver object
    {
        // No error
    } else {
        // Handle the error
    }

    // Reconfigure some of the ADC parameters (ADC resolution for example)
    adc_cfg.resolution = ANALOG_IN_RESOLUTION_10_BIT;

    // Now perform `analog_in_open` to allocate newly configured hardware resources
    if( ACQUIRE_FAIL == analog_in_open( &adc, &adc_cfg ) ) {
        // Error handling
    }

    return 0;
}

• How do I configure the ADC to use a specific input pin?

/* Project name:
 *   How do I configure the ADC to use a specific input pin?
 * Copyright:
 *   (c) MIKROE, 2024.
 * Description:
 *   This example demonstrates the functionality of ADC (Analog-to-Digital Converter)
 *   using mikroSDK.
 *   ADC specific input pin shall be configured and ADC shall be initialized.
 * Library dependencies?
 *   - Make sure `Driver.ADC`, `Driver.GPIO.Port` and `Board` libraries are enabled in NECTO's
 *     Library Manager to ensure a successful build.
 */

// ------------------------------------------------------------------ INCLUDES
/**
 * Any initialization code needed for MCU to function properly.
 * Do not remove this line or clock might not be set correctly.
 */
#ifdef PREINIT_SUPPORTED
#include "preinit.h"
#endif

#include "drv_analog_in.h"  // Header for Analog input driver.
#include "board.h"          // Main board pin mapping.

// ------------------------------------------------------------------ VARIABLES
analog_in_t adc;            // Analog input driver context structure.
analog_in_config_t adc_cfg; // Analog input configuration structure.

int main(void)
{
    /* Do not remove this line or clock might not be set correctly. */
    #ifdef PREINIT_SUPPORTED
    preinit();
    #endif

    // Initialize ADC configuration structure to default values
    analog_in_configure_default(&adc_cfg);

    // Set the specific input pin here (analog pin on mikroBUS 1 slot is currently set)
    adc_cfg.input_pin = MIKROBUS_1_AN; // example: `PA0` or `MIKROBUS_4_AN` or `HAL_PIN_NC` (`Pin not connected` state)

    // Initialize the ADC
    if( ACQUIRE_FAIL == analog_in_open( &adc, &adc_cfg ) ) {
        // Error handling
    }

    return 0;
}

• How can I check if the ADC driver is properly initialized?

/* Project name:
 *   How can I check if the ADC driver is properly initialized?
 * Copyright:
 *   (c) MIKROE, 2024.
 * Description:
 *   This example demonstrates the functionality of ADC (Analog-to-Digital Converter)
 *   using mikroSDK.
 *   ADC specific input pin shall be configured and ADC shall be initialized.
 * How to test this code example?
 *   - Run debug mode by pressing F9 on your keyboard;
 *   - Continue debug (F6 on your keyboard);
 *   - Monitor the `Application Output` in the lower part of the NECTO's environment
 *     to check proper initialization of an ADC driver.
 * Library dependencies?
 *   - Make sure `Driver.ADC`, `Log`, `Driver.GPIO.Port` and `Board` libraries are enabled in NECTO's
 *     Library Manager to ensure a successful build.
 */

// ------------------------------------------------------------------ INCLUDES
/**
 * Any initialization code needed for MCU to function properly.
 * Do not remove this line or clock might not be set correctly.
 */
#ifdef PREINIT_SUPPORTED
#include "preinit.h"
#endif

#include "drv_analog_in.h"  // Header for Analog input driver.
#include "board.h"          // Main board pin mapping.
#include "log.h"            // Header for Logger driver.

// -------------------------------------------------------------------- MACROS
// Voltage reference value.
#define ADC_VREF_VALUE 3.3f // It can be changed in CODEGRIP Suite: POWER -> Outputs -> Voltage Reference -> Set Voltage.

// ------------------------------------------------------------------ VARIABLES
analog_in_t adc;            // Analog input driver context structure.
analog_in_config_t adc_cfg; // Analog input configuration structure.

static log_t logger;        // Logger driver object.

uint16_t read_data_buffer;  // Analog input data buffer.
float read_data_buffer_voltage; // Analog input data buffer (voltage).

int main(void)
{
    /* Do not remove this line or clock might not be set correctly. */
    #ifdef PREINIT_SUPPORTED
    preinit();
    #endif

    log_cfg_t log_cfg;              // Logger configuration structure instance.
    log_init( &logger, &log_cfg );  // Initialize Logger.
    log_printf( &logger, "Logger initialized.\n" );

    // Initialize ADC configuration structure to default values
    analog_in_configure_default(&adc_cfg);
    log_printf( &logger, "Configured default ADC settings.\n" );

    // Set the correct input pin here (analog pin on mikroBUS 1 slot is currently set)
    adc_cfg.input_pin = MIKROBUS_1_AN; // example: `PA0` or `MIKROBUS_4_AN` or `HAL_PIN_NC` (`Pin not connected` state)
    log_printf( &logger, "Selected `MIKROBUS_1_AN` as an ADC pin.\n" );

    // Set the correct ADC resolution
    adc_cfg.resolution = ANALOG_IN_RESOLUTION_12_BIT;
    log_printf( &logger, "Selected 12-bit ADC resolution.\n" );

    // Set the desired reference voltage
    adc_cfg.vref_value = ADC_VREF_VALUE;
    log_printf( &logger, "Selected 3.3 volts as a reference voltage.\n" );

    // Initialize the ADC
    if ( ADC_ERROR == analog_in_open( &adc, &adc_cfg ) ) {
        log_printf( &logger, "ADC open failed.\n" );
    } else {
        log_printf( &logger, "ADC open successful.\n" );
    }

    return 0;
}

• How do I reset the ADC to its default configuration?

analog_in_configure_default(&adc_cfg);

• How do I check if the ADC input pin is set?

if (adc_cfg.input_pin != HAL_PIN_NC) {
    // Input pin is set
} else {
    // Input pin is NOT set
}

---