/**************************************************************************
*
* Copyright (c) 2024-2024 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    AlarmAudio.h
*
* @author  (last)      Sean
* @date    (last)      30-Jul-2024
*
* @author  (original)  Sean
* @date    (original)  30-Jul-2024
*
***************************************************************************/

#ifndef __ALARM_AUDIO_H__
#define __ALARM_AUDIO_H__

#include "TDCommon.h"

/**
 *  @defgroup AlarmAudio AlarmAudio
 *  @brief The Alarm Audio unit controls the audio for the alarm system.
 *  Provides functions for requesting alarm audio patterns and testing the
 *  alarm audio.
 *
 *  @addtogroup AlarmAudio
 *  @{
 */

// ********** public definitions **********

#define MAX_ALARM_VOLUME_LEVEL                          5           ///< Maximum alarm audio level.
#define MAX_ALARM_VOLUME_ATTENUATION                    4           ///< Maximum alarm audio attenuation.
#define MIN_ALARM_VOLUME_ATTENUATION                    0           ///< Minimum alarm audio attenuation.

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

void initAlarmAudio( void );
void execAlarmAudio( void );

void setAlarmAudio( void );
void setAlarmAudioVolume( U32 volumeLevel );

U32 getAlarmAudioVolume( void );

F32 getAlarmAudioPrimaryHighGainCurrent( void );
F32 getAlarmAudioPrimaryLowGainCurrent( void );
F32 getAlarmAudioBackupCurrent( void );

SELF_TEST_STATUS_T execAlarmAudioSelfTest( void );
void resetAlarmAudioPOSTState( void );

BOOL testSetAlarmAudioVolumeLevelOverride( U32 volume );
BOOL testResetAlarmAudioVolumeLevelOverride( void );
BOOL testSetPrimaryAlarmAudioCurrentHGOverride( F32 mA );
BOOL testResetPrimaryAlarmAudioCurrentHGOverride( void );
BOOL testSetPrimaryAlarmAudioCurrentLGOverride( F32 mA );
BOOL testResetPrimaryAlarmAudioCurrentLGOverride( void );
BOOL testSetBackupAlarmAudioCurrentOverride( F32 mA );
BOOL testResetBackupAlarmAudioCurrentOverride( void );

/**@}*/

#endif