fota_datagram.h

#pragma once
 
/************************************************************************************************
 * @file    fota_datagram.h
 *
 * @brief   Fota Datagram Header File
 *
 * @date    2025-04-30
 * @author  Midnight Sun Team #24 - MSXVI
 ************************************************************************************************/
 
/* Standard library Headers */
#include <stdbool.h>
#include <stdint.h>
 
/* Inter-component Headers */
 
/* Intra-component Headers */
#include "fota_packet.h"
 
#define FOTA_MAX_DATAGRAM_SIZE (8U * 256U)
 
#define FOTA_MAX_PACKETS_PER_DATAGRAM ((FOTA_MAX_DATAGRAM_SIZE / FOTA_PACKET_PAYLOAD_SIZE) + 1U)
 
typedef enum {
  FOTA_DATAGRAM_TYPE_FIRMWARE_METADATA, 
  FOTA_DATAGRAM_TYPE_FIRMWARE_CHUNK,    
  FOTA_DATAGRAM_TYPE_UPDATE_REQUEST,    
  FOTA_DATAGRAM_TYPE_UPDATE_RESPONSE,   
  FOTA_DATAGRAM_TYPE_VERIFICATION       
} FotaDatagramType;
 
typedef struct {
  FotaDatagramType type; 
  uint32_t datagram_id;  
  uint32_t total_length; 
  uint16_t num_packets;  
  uint32_t crc32;        
} FotaDatagramHeader;
 
typedef struct {
  FotaDatagramHeader header;                           
  uint8_t data[FOTA_MAX_DATAGRAM_SIZE];                
  bool packet_received[FOTA_MAX_PACKETS_PER_DATAGRAM]; 
  uint16_t packets_received;                           
  bool is_complete;                                    
} FotaDatagram;
 
FotaError fota_datagram_init(FotaDatagram *datagram, FotaDatagramType type, uint32_t datagram_id, uint8_t *data, uint32_t length);
 
FotaError fota_datagram_to_packets(FotaDatagram *datagram, FotaPacket *packets, uint16_t *num_packets, uint16_t max_packets);
 
FotaError fota_datagram_process_packet(FotaDatagram *datagram, FotaPacket *packet);
 
bool fota_datagram_is_complete(FotaDatagram *datagram);
 
FotaError fota_datagram_verify(FotaDatagram *datagram);