bootloader.h

#pragma once
 
/************************************************************************************************
 * @file   bootloader.h
 *
 * @brief  Header file for bootloader
 *
 * @date   2025-01-08
 * @author Midnight Sun Team #24 - MSXVI
 ************************************************************************************************/
 
/* Standard library Headers */
#include <stdint.h>
 
/* Inter-component Headers */
 
/* Intra-component Headers */
#include "bootloader_can.h"
#include "bootloader_error.h"
#include "bootloader_flash.h"
 
extern uint32_t _flash_start;
extern uint32_t _flash_size;
extern uint32_t _flash_page_size;
extern uint32_t _application_start;
extern uint32_t _application_size;
extern uint32_t _bootloader_start;
extern uint32_t _bootloader_size;
extern uint32_t _sram_start;
extern uint32_t _sram_size;
 
#define FLASH_START_ADDRESS_LINKERSCRIPT ((uint32_t)&_flash_start)
 
#define FLASH_SIZE_LINKERSCRIPT ((size_t)&_flash_size)
 
#define FLASH_PAGE_SIZE_LINKERSCRIPT ((size_t)&_flash_page_size)
 
#define APPLICATION_START_ADDRESS ((uint32_t) & _application_start)
 
#define APPLICATION_SIZE ((size_t) & _application_size)
 
#define BOOTLOADER_START_ADDRESS ((uint32_t) & _bootloader_start)
 
#define BOOTLOADER_SIZE ((size_t) & _bootloader_size)
 
#define SRAM_START_ADDRESS ((uint32_t) & _sram_start)
 
#define SRAM_SIZE ((size_t) & _sram_size)
 
typedef enum {
  BOOTLOADER_UNINITIALIZED = 0, 
  BOOTLOADER_IDLE,              
  BOOTLOADER_START,             
  BOOTLOADER_WAIT_SEQUENCING,   
  BOOTLOADER_DATA_RECEIVE,      
  BOOTLOADER_JUMP_APP,          
  BOOTLOADER_FAULT,             
  BOOTLOADER_PING               
} BootloaderStates;
 
typedef enum {
  BOOTLOADER_PING_NODES = 0,
  BOOTLOADER_PING_BRANCH,
  BOOTLOADER_PING_PROJECT,
} BootloaderPingStates;
 
typedef struct {
  uintptr_t application_start;       
  uintptr_t current_write_address;   
  uint32_t bytes_written;            
  uint32_t data_size;                
  uint32_t packet_crc32;             
  uint16_t expected_sequence_number; 
  uint16_t buffer_index;             
  BootloaderPingStates ping_type;    
  uint8_t ping_data_len;             
  BootloaderStates state;   
  BootloaderError error;    
  uint16_t target_nodes;    
  bool first_byte_received; 
  bool first_ping_received; 
} BootloaderStateData;
 
BootloaderError bootloader_init(void);
 
BootloaderError bootloader_run(Boot_CanMessage *msg);
 
BootloaderError bootloader_jump_app(void);