/**
*   @copyright       © 2026 Microchip Technology Inc.
    Microchip Technology Inc. and its subsidiaries. You may use this
    software and any derivatives exclusively with Microchip products.

    THIS SOFTWARE IS SUPPLIED BY MICROCHIP "AS IS". NO WARRANTIES, WHETHER
    EXPRESS, IMPLIED OR STATUTORY, APPLY TO THIS SOFTWARE, INCLUDING ANY IMPLIED
    WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR A
    PARTICULAR PURPOSE, OR ITS INTERACTION WITH MICROCHIP PRODUCTS, COMBINATION
    WITH ANY OTHER PRODUCTS, OR USE IN ANY APPLICATION.

    IN NO EVENT WILL MICROCHIP BE LIABLE FOR ANY INDIRECT, SPECIAL, PUNITIVE,
    INCIDENTAL OR CONSEQUENTIAL LOSS, DAMAGE, COST OR EXPENSE OF ANY KIND
    WHATSOEVER RELATED TO THE SOFTWARE, HOWEVER CAUSED, EVEN IF MICROCHIP HAS
    BEEN ADVISED OF THE POSSIBILITY OR THE DAMAGES ARE FORESEEABLE. TO THE
    FULLEST EXTENT ALLOWED BY LAW, MICROCHIP'S TOTAL LIABILITY ON ALL CLAIMS IN
    ANY WAY RELATED TO THIS SOFTWARE WILL NOT EXCEED THE AMOUNT OF FEES, IF ANY,
    THAT YOU HAVE PAID DIRECTLY TO MICROCHIP FOR THIS SOFTWARE.

    MICROCHIP PROVIDES THIS SOFTWARE CONDITIONALLY UPON YOUR ACCEPTANCE OF THESE
    TERMS. 
*
*************************************************************************/

/**
 *  @file       diag_utility_adc.h
 *  @version   	1.0
 *  @brief  	This file has the definitions and declarations to be used by all 
 *              the Diagnostic modules, which may need to use ADC
 * 
 *************************************************************************/

/**
 * @defgroup functions Functions
 * @defgroup macros Macros
 * @defgroup enums Enums
*/

#ifndef DIAG_UTILITY_ADC_H
#define DIAG_UTILITY_ADC_H

#include <stdbool.h>
#include <stdint.h>
#include "diag_adc.h"

/**
 @ingroup functions
 @brief ** DIAG_UTIL_ADC_RedundantInputsPractice **\n
 Implements the function which returns comparison of results from two
 ADC channels
 @param adcFirstChannelNumber - First Channel Number
 @param adcSecondChannelNumber - Second Channel Number
 @param tolerance - Maximum allowable difference (deviation) between the ADC results of two channels
 @return @ref DIAG_PASS \n
 @return @ref DIAG_FAIL \n
 @return @ref DIAG_INVALID_PARAM \n
*/
/*LDRA_EXCLUDE 63 D : <justification start> Function definition is present in corresponding source file, violation ignored <justification end> */
uint32_t DIAG_UTIL_ADC_RedundantInputsPractice(DIAG_ADC_CHANNELS adcFirstChannelNumber,
        DIAG_ADC_CHANNELS adcSecondChannelNumber, uint32_t tolerance);

#endif /* DIAG_UTILITY_ADC_H */
