bootloader_can_datagram.h

#pragma once
 
/************************************************************************************************
 * @file   bootloader_can_datagram.h
 *
 * @brief  Header file for the CAN datagram in the bootloader
 *
 * @date   2025-01-08
 * @author Midnight Sun Team #24 - MSXVI
 ************************************************************************************************/
 
/* Standard library Headers */
#include <stdbool.h>
#include <stdint.h>
 
/* Inter-component Headers */
 
/* Intra-component Headers */
#include "bootloader_can.h"
#include "bootloader_error.h"
 
#define ACK 0U
 
#define NACK 1U
 
#define DGRAM_MAX_MSG_SIZE 8
 
typedef enum {
  BOOTLOADER_CAN_SEQUENCING_ID = 30,       
  BOOTLOADER_CAN_FLASH_ID,                 
  BOOTLOADER_CAN_JUMP_APPLICATION_ID,      
  BOOTLOADER_CAN_ACK_ID,                   
  BOOTLOADER_CAN_START_ID,                 
  BOOTLOADER_CAN_JUMP_BOOTLOADER ,         
  BOOTLOADER_CAN_PING_METADATA_ID,         
  BOOTLOADER_CAN_PING_DATA_ID,             
} BootloaderCanID;
 
typedef struct {
  uint8_t datagram_type_id; 
  union {
    struct {
      uint16_t node_ids; 
      uint32_t data_len; 
    } start;
 
    struct {
      uint16_t sequence_num; 
      uint32_t crc32;        
    } sequencing;
 
    struct {
      uint8_t *data; 
    } data;
 
    struct {
      uint16_t node_ids; 
    } jump_app;
 
    struct {
      uint8_t ack_status;        
      uint16_t bootloader_error; 
    } ack;
 
    struct {
      uint16_t node_ids;
      uint16_t req : 4 , data_len : 12;
      uint32_t crc32;
    } ping;
  } payload;
} BootloaderDatagram;
 
BootloaderDatagram deserialize_datagram(Boot_CanMessage *msg, uint16_t *target_nodes);
 
void send_ack_datagram(bool ack, BootloaderError error);