packet_manager.h

#pragma once
 
/************************************************************************************************
 * @file   packet_manager.h
 *
 * @brief  Packet manager class for firmware over the air (FOTA) updates
 *
 * @date   2025-03-16
 * @author Midnight Sun Team #24 - MSXVI
 ************************************************************************************************/
 
/* Standard library Headers */
#include <stdbool.h>
#include <stdint.h>
 
/* Inter-component Headers */
 
/* Intra-component Headers */
#include "fota_datagram.h"
#include "fota_encryption.h"
#include "fota_error.h"
#include "fota_packet.h"
#include "network.h"
#include "network_buffer.h"
 
#define FOTA_MAX_ACTIVE_DATAGRAMS 2U
 
typedef void (*FotaDatagramCompleteCb)(FotaDatagram *datagram);
 
typedef enum {
  PKT_STATE_WAITING_SOF,   
  PKT_STATE_READING_PACKET 
} PacketReceiverState;
 
typedef struct {
  /* Network buffer for raw data */
  NetworkBuffer network_buffer;
 
  /* Packet reception */
  PacketReceiverState rx_state;
  uint16_t bytes_received;
  uint8_t rx_packet_buffer[sizeof(FotaPacket)];
  uint8_t tx_packet_buffer[sizeof(FotaPacket)];
  FotaPacket current_packet;
 
  /* Datagram handling */
  FotaDatagram active_datagrams[FOTA_MAX_ACTIVE_DATAGRAMS];
  bool datagram_active[FOTA_MAX_ACTIVE_DATAGRAMS];
 
  /* Callback for completed datagrams */
  FotaDatagramCompleteCb datagram_complete_callback;
} PacketManager;
 
FotaError packet_manager_init(PacketManager *manager, UartPort uart, UartSettings *uart_settings, FotaDatagramCompleteCb callback);
 
FotaError packet_manager_process(PacketManager *manager);
 
FotaError packet_manager_send_datagram(PacketManager *manager, FotaDatagram *datagram, FotaError (*send_func)(int8_t *data, uint32_t length));
 
FotaError packet_manager_create_datagram(PacketManager *manager, FotaDatagramType type, uint8_t *data, uint32_t length, FotaDatagram **datagram);
 
FotaError packet_manager_get_datagram(PacketManager *manager, uint32_t datagram_id, FotaDatagram **datagram);
 
FotaError packet_manager_free_datagram(PacketManager *manager, uint32_t datagram_id);