fota_dfu.h

#pragma once
 
/************************************************************************************************
 * @file  fota_dfu.h
 *
 * @brief  FOTA Device Firmware Update
 *
 * @date   2025-07-08
 * @author Midnight Sun Team #24 - MSXVI
 ************************************************************************************************/
 
/* Standard library Headers */
#include <stdint.h>
 
/* Inter-component Headers */
 
/* Intra-component Headers */
#include "fota_datagram.h"
#include "fota_datagram_payloads.h"
#include "fota_error.h"
#include "packet_manager.h"
 
typedef enum {
  FOTA_DFU_UNINITIALIZED, 
  FOTA_DFU_IDLE,          
  FOTA_DFU_RECEIVING,     
  FOTA_DFU_COMPLETE,      
  FOTA_DFU_JUMP           
} FotaDFUState;
 
typedef struct {
  bool is_initialized;                       
  uintptr_t staging_base_addr;               
  uintptr_t app_start_addr;                  
  uintptr_t current_write_addr;              
  uint32_t bytes_written;                    
  uint32_t binary_size;                      
  uint32_t expected_crc32;                   
  uint16_t expected_datagram_id;             
  uint8_t version_major;                     
  uint8_t version_minor;                     
  char firmware_id[FOTA_FIRMWARE_ID_LENGTH]; 
  FotaDFUState state;                        
  PacketManager *packet_manager;             
} FotaDFUContext;
 
FotaError fota_dfu_init(PacketManager *packet_manager, uintptr_t staging_base, uintptr_t app_start_addr);
 
FotaError fota_dfu_process(FotaDatagram *datagram);