/**************************************************************************
*
* Copyright (c) 2026-2027 Diality Inc. - All Rights Reserved.
*
* THIS CODE MAY NOT BE COPIED OR REPRODUCED IN ANY FORM, IN PART OR IN
* WHOLE, WITHOUT THE EXPLICIT PERMISSION OF THE COPYRIGHT OWNER.
*
* @file    NVMgmtDD.h
*
* @author  (original)  Arpita Srivastava
* @date    (original)  31-Mar-2026
*
***************************************************************************/

#ifndef _NV_MGMT_DD_H_
#define _NV_MGMT_DD_H_

#include "AlarmDefs.h"
#include "NVRecordsDD.h"

/**
 *  @defgroup NVMgmtDD NVMgmtDD
 *  @brief This module provides the top-level NV data management interface used
 *  by other system modules.
 *  It initializes and executes NV operations, manages POST self-test,
 *  handles power-off conditions, and provides APIs to access NV records.
 *  It also integrates lower-level NV messaging and record handling modules.
 *
 *  @addtogroup NVMgmtDD
 *  @{
 */

// ********** public function prototypes **********

void initNVMgmtDD( void );
void signalPowerOffWarning( void );
void execNVM( void );
void resetNVMPOSTState( void );

BOOL isNewCalibrationRecordAvailable( void );
BOOL getNVRecord2Driver( NV_DATA_T nvData, U08* bufferAddress, U32 bufferLength,
                         U08 numOfSnsrs2Check, ALARM_ID_T nvAlarm );

// Wrapper functions to other NVM files
void execNVMProcessRecord( void );
SELF_TEST_STATUS_T execNVMSelfTest( void );
/**@}*/

#endif /* _NV_MGMT_DD_H_ */