Index: firmware/App/Services/CommBuffers.h =================================================================== diff -u -rf2652e85c8676d0356fea2690cfd9cac716ca795 -r5acce83ec629eff9621c0193fae57b7b63ad8de8 --- firmware/App/Services/CommBuffers.h (.../CommBuffers.h) (revision f2652e85c8676d0356fea2690cfd9cac716ca795) +++ firmware/App/Services/CommBuffers.h (.../CommBuffers.h) (revision 5acce83ec629eff9621c0193fae57b7b63ad8de8) @@ -1,25 +1,49 @@ -/* - * CommBuffers.h - * - * Created on: Aug 2, 2024 - * Author: fw - */ +/************************************************************************** +* +* Copyright (c) 2024-2026 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) Dara Navaei +* @date (last) 07-Feb-2026 +* +* @author (original) Dara Navaei +* @date (original) 04-Aug-2024 +* +***************************************************************************/ #ifndef __COMMBUFFERS_H__ #define __COMMBUFFERS_H__ #include "BLCommon.h" +/** + * @defgroup CommBuffers CommBuffers + * @brief The communication buffers unit provides buffering services for + * incoming and outgoing CAN data. A separate buffer is provided for each + * CAN ID (channel) so that frame order is maintained for a given channel. + * + * @addtogroup CommBuffers + * @{ + */ + +// ********** public definitions ********** + +// ********** public function prototypes ********** + void initCommBuffers( void ); -void handleCANMsgInterrupt( SW_UPDATE_CAN_MAIL_BOXES_T MailBox ); +BOOL addToCommBuffer( SW_UPDATE_CAN_MAIL_BOX_T mailBox, U08* data, U32 len ); -void getSWUpdateBufferStatus( SW_UPDATE_BUFFER_STATUS_T* status ); +BOOL getCommBuffer( SW_UPDATE_CAN_MAIL_BOX_T mailBox, U08* data, U32 len ); -void getSWUpdateBuffer( U08* data ); +BOOL isMessageComplete( SW_UPDATE_CAN_MAIL_BOX_T mailBox ); -void sendAckNackStatusFromFirmware( ACK_NACK_STATUS_T status, BOOL cmd ); +void clearCommBuffer( SW_UPDATE_CAN_MAIL_BOX_T mailBox ); -void clearSWUpdateBuffer( BOOL cmd ); +/**@}*/ #endif