/* IBM_PROLOG_BEGIN_TAG                                                   */
/* This is an automatically generated prolog.                             */
/*                                                                        */
/* $Source: src/usr/diag/prdf/plat/mem/prdfMemScrubUtils.H $              */
/*                                                                        */
/* OpenPOWER HostBoot Project                                             */
/*                                                                        */
/* Contributors Listed Below - COPYRIGHT 2016                             */
/* [+] International Business Machines Corp.                              */
/*                                                                        */
/*                                                                        */
/* Licensed under the Apache License, Version 2.0 (the "License");        */
/* you may not use this file except in compliance with the License.       */
/* You may obtain a copy of the License at                                */
/*                                                                        */
/*     http://www.apache.org/licenses/LICENSE-2.0                         */
/*                                                                        */
/* Unless required by applicable law or agreed to in writing, software    */
/* distributed under the License is distributed on an "AS IS" BASIS,      */
/* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or        */
/* implied. See the License for the specific language governing           */
/* permissions and limitations under the License.                         */
/*                                                                        */
/* IBM_PROLOG_END_TAG                                                     */

/** @file  prdfMemScrubUtils.H
 *  @brief Define the functionality necessary to start initial background scrub
 */

#ifndef __prdfMemScrubUtils_H
#define __prdfMemScrubUtils_H

#include <iipconst.h>
#include <iipServiceDataCollector.h>
#include <iipSystem.h>

namespace PRDF
{

/**
 * @brief  Clears the command complete and WAT workaround attentions.
 * @param  i_chip MBA, MCA, or MCBIST.
 * @return Non-SUCCESS on SCOM failures, SUCCESS otherwise.
 */
template<TARGETING::TYPE T>
uint32_t clearCmdCompleteAttn( ExtensibleChip * i_chip );

/**
 * @brief  Clears the maintenance ECC counters.
 * @param  i_chip MBA, MCA, or MCBIST.
 * @return Non-SUCCESS on SCOM failures, SUCCESS otherwise.
 */
template<TARGETING::TYPE T>
uint32_t clearEccCounters( ExtensibleChip * i_chip );

/**
 * @brief  Clears the maintenance ECC FIRs.
 * @param  i_chip MBA, MCA, or MCBIST.
 * @return Non-SUCCESS on SCOM failures, SUCCESS otherwise.
 */
template<TARGETING::TYPE T>
uint32_t clearEccFirs( ExtensibleChip * i_chip );

/**
 * @brief  Wrapper function that calls clearEccCounters(), clearEccFirs() and
 *         clearCmdCompleteAttn().
 * @param  i_chip MBA, MCA, or MCBIST.
 * @return Non-SUCCESS on SCOM failures, SUCCESS otherwise.
 */
template<TARGETING::TYPE T>
uint32_t prepareNextCmd( ExtensibleChip * i_chip )
{
    #define PRDF_FUNC "[prepareNextCmd] "

    uint32_t o_rc = SUCCESS;

    do
    {
        o_rc = clearEccCounters<T>( i_chip );
        if ( SUCCESS != o_rc )
        {
            PRDF_ERR( PRDF_FUNC "clearEccCounters<T>(0x%08x) failed",
                      i_chip->getHuid() );
            break;
        }

        o_rc = clearEccFirs<T>( i_chip );
        if ( SUCCESS != o_rc )
        {
            PRDF_ERR( PRDF_FUNC "clearEccFirs<T>(0x%08x) failed",
                      i_chip->getHuid() );
            break;
        }

        o_rc = clearCmdCompleteAttn<T>( i_chip );
        if ( SUCCESS != o_rc )
        {
            PRDF_ERR( PRDF_FUNC "clearCmdCompleteAttn<T>(0x%08x) failed",
                      i_chip->getHuid() );
            break;
        }

    } while (0);

    return o_rc;

    #undef PRDF_FUNC
}

/** @brief Contains all supported ECC attentions. Each enum is used in a mask,
 *         so the value of each enum must be unique and disjoint. */
enum MaintEccAttns
{
    MAINT_NO_ERROR      = 0,    ///< No ECC errors found

    // Common Nimbus and Centaur
    MAINT_MPE           = 0x8000, ///< Chip mark placed
    MAINT_SCE           = 0x4000, ///< CE on symbol mark
    MAINT_MCE           = 0x2000, ///< CE on chip mark
    MAINT_UE            = 0x1000, ///< UE
    MAINT_HARD_NCE_ETE  = 0x0800, ///< Hard NCE threshold exceeed
    MAINT_SOFT_NCE_ETE  = 0x0400, ///< Soft NCE threshold exceeed
    MAINT_INT_NCE_ETE   = 0x0200, ///< Intermittent NCE threshold exceeed
    MAINT_RCE_ETE       = 0x0100, ///< Retry CE threshold exceeed

    // Nimbus only
    MAINT_IUE           = 0x0080, ///< Intermittent UE
    MAINT_IMPE          = 0x0040, ///< Intermittent chip mark
};

/**
 * @brief  Checks for all currently active maintenance attentions.
 * @param  i_chip     MBA or MCA.
 * @param  o_eccAttns Mask of all currently active maintenance attentions. See
 *                    enum MaintEccAttns for values.
 * @return Non-SUCCESS on SCOM failures, SUCCESS otherwise.
 */
template<TARGETING::TYPE T>
uint32_t checkEccFirs( ExtensibleChip * i_chip, uint32_t & o_eccAttns );

} //end namespace PRDF

#endif // __prdfMemScrubUtils_H