init_opa.c

/*
 * File:   init_opa.c
 * Author: M91406
 *
 * Created on May 19, 2020, 1:19 PM
 */


#include <xc.h>
#include <stdint.h>
#include <stdbool.h>

#include "init_opa.h"

/***********************************************************************************
 * @fn uint16_t sysOpAmp_Initialize(volatile uint16_t opaInstance, volatile bool disable_n_channel) 
 * @brief  Initializes the on-chip operational amplifier module
 * @return unsigned integer
 * @return 0=failure
 * @return 1=success
 * 
 * @details
 * The EPC9143 300W 16th brick power module reference designs uses one of the on-chip 
 * operational amplifiers as buffer op-amp for the current reference signal applied
 * to external high-side current sense shunt amplifier devices. This operational
 * amplifier is initialized here.
 * 
 **********************************************************************************/

volatile uint16_t sysOpAmp_Initialize(volatile uint16_t opaInstance, volatile bool disable_n_channel) 
{
    volatile uint16_t retval=1;
    volatile uint16_t idum=0;
    volatile struct P33C_OPA_MODULE_s* opa = p33c_OpaModule_GetHandle();

    // If instance is set = 0, op-amp will be skipped and op-amps will be turned off
    if(opaInstance > 0)
    {
        // Disables Op Amp N channel input stage
        if (disable_n_channel)
        {
            idum = (((uint16_t)disable_n_channel) << (opaInstance - 1));
            opa->AmpCon1H.value |= idum;
        }
        else
        {
            idum = (1 << (opaInstance - 1));
            opa->AmpCon1H.value &= (~idum);
        }
        
        // Enable op-amp instance
        idum = (0x0001 << (opaInstance - 1));
        opa->AmpCon1L.value |= idum;
    }
    
    return (retval);
}

/***********************************************************************************
 * @fn uint16_t sysOpAmp_ModuleEnable
 * @brief  Enables the on-chip operational amplifier module
 * @return unsigned integer
 * @return 0=failure
 * @return 1=success
 * 
 * @details
 * The on-chip operational amplifier module allows the configuration of multiple 
 * operational amplifier instances. The module itself provides an additional 
 * master enable bit to turn on/off the entire module.
 * 
 **********************************************************************************/

volatile uint16_t sysOpAmp_ModuleEnable(void)
{
    volatile struct P33C_OPA_MODULE_s* opa = p33c_OpaModule_GetHandle();
    opa->AmpCon1L.bits.AMPON = true; // Enable Op-Amp module
    return (opa->AmpCon1L.bits.AMPON);
}


/***********************************************************************************
 * @fn uint16_t sysOpAmp_ModuleReset
 * @brief  Resets the on-chip operational amplifier module
 * @return unsigned integer
 * @return 0=failure
 * @return 1=success
 * 
 * @details
 * The on-chip operational amplifier module allows the configuration of multiple 
 * operational amplifier instances. The module itself provides an additional 
 * master enable bit to turn on/off the entire module as well as to enable/disable 
 * the N-inputs of individual op-amps. This function resets the op-amp module 
 * to its default disabling the N-channel inputs of all op-amps, disables all
 * individual op-amps as well as turns of the op-amp module master switch.
 * 
 **********************************************************************************/

volatile uint16_t sysOpAmp_ModuleReset(void)
{
    volatile struct P33C_OPA_MODULE_s* opa = p33c_OpaModule_GetHandle();

    // Disable and reset op-amp module
    *opa = opaModuleDefault;    // Load configuration defaults
    opa->AmpCon1L.value = 0;    // Disable and reset Op-Amp module

    return (1-opa->AmpCon1L.bits.AMPON);
}
 // end of group op-amp-initialization

// end of file