/**************************************************************************
*
* Copyright (c) 2019-2025 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    CommBuffers.h
*
* @author  (last)      Sean Nash
* @date    (last)      02-Dec-2021
*
* @author  (original)  Dara Navaei
* @date    (original)  05-Nov-2019
*
***************************************************************************/

#ifndef __COMM_BUFFERS_H__
#define __COMM_BUFFERS_H__

#include "DGCommon.h"

/**
 *  @defgroup CommBuffers CommBuffers
 *  @brief Communication buffers service module. Provides communication buffers functionality
 *  including support functions for adding and clearing communication buffer.
 *
 *  @addtogroup CommBuffers
 *  @{
 */

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

/// List of comm buffers.
typedef enum Comm_Buffers
{
    COMM_BUFFER_NOT_USED = 0,                                   ///< Unused buffer - CAN message boxes start at 1
    COMM_BUFFER_IN_CAN_HD_ALARM,                                ///< Receiving buffer for HD alarm via CAN
    COMM_BUFFER_OUT_CAN_DG_ALARM,                               ///< Transmitting buffer for DG alarm via CAN
    COMM_BUFFER_IN_CAN_UI_ALARM,                                ///< Receiving buffer for UI alarm via CAN
    COMM_BUFFER_IN_CAN_HD_2_DG,                                 ///< Receiving buffer for HD to DG communication via CAN
    COMM_BUFFER_OUT_CAN_DG_2_HD,                                ///< Transmitting buffer for DG to HD communication via CAN
    COMM_BUFFER_IN_CAN_HD_BROADCAST,                            ///< Receiving buffer for HD broadcast communication via CAN
    COMM_BUFFER_OUT_CAN_DG_2_UI,                                ///< Transmitting buffer for DG to UI communication via CAN
    COMM_BUFFER_OUT_CAN_DG_BROADCAST,                           ///< Transmitting buffer for DG broadcast communication via CAN
    COMM_BUFFER_IN_CAN_UI_2_DG,                                 ///< Receiving buffer for UI to DG communication via CAN
    COMM_BUFFER_IN_CAN_UI_BROADCAST,                            ///< Receiving buffer for UI broadcast communication via CAN
    COMM_BUFFER_IN_CAN_PC,                                      ///< Receiving buffer for PC communication via CAN
    COMM_BUFFER_OUT_CAN_PC,                                     ///< Transmitting buffer for PC communication via CAN
    COMM_BUFFER_LAST_CAN_BUFFER = COMM_BUFFER_OUT_CAN_PC,       ///< Last CAN communication buffer
    NUM_OF_COMM_BUFFERS                                         ///< The number of communication buffers
} COMM_BUFFER_T;

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

void initCommBuffers( void );
void clearBuffer( COMM_BUFFER_T buffer );
BOOL addToCommBuffer( COMM_BUFFER_T buffer, U08 *data, U32 len );
U32 getFromCommBuffer( COMM_BUFFER_T buffer, U08 *data, U32 len );
U32 peekFromCommBuffer( COMM_BUFFER_T buffer, U08 *data, U32 len );
U32 numberOfBytesInCommBuffer( COMM_BUFFER_T buffer );

/**@}*/

#endif