network.h

#pragma once
 
/************************************************************************************************
 * @file   network.h
 *
 * @brief  Header file for network layer Tx Rx UART implementation for firmware over the air (FOTA) updates
 *
 * @date   2025-03-12
 * @author Midnight Sun Team #24 - MSXVI
 ************************************************************************************************/
 
/* Standard library Headers */
#include <stdbool.h>
#include <stdint.h>
 
/* Inter-component Headers */
#include "stm32l4xx_hal_gpio.h"
 
/* Intra-component Headers */
#include "fota_error.h"
#include "network_buffer.h"
 
typedef enum { UART_PORT_1 = 0, UART_PORT_2, NUM_UART_PORTS } UartPort;
 
#define UART_MAX_BUFFER_LEN 256U
#define UART_TIMEOUT_MS 1U
 
typedef enum {
  UART_FLOW_CONTROL_NONE,   
  UART_FLOW_CONTROL_RTS,    
  UART_FLOW_CONTROL_CTS,    
  UART_FLOW_CONTROL_RTS_CTS 
} UartFlowControl;
 
typedef enum {
  GPIO_PORT_A = 0, 
  GPIO_PORT_B,     
  NUM_GPIO_PORTS   
} GpioPort;
 
typedef struct {
  GpioPort port;
  uint32_t pin;
} GpioAddress;
 
typedef struct {
  GpioAddress tx;               
  GpioAddress rx;               
  uint32_t baudrate;            
  UartFlowControl flow_control; 
} UartSettings;
 
FotaError network_init(UartPort uart, UartSettings *settings, NetworkBuffer *network_buffer);
 
FotaError network_read(UartPort uart, uint8_t *data, size_t len);
 
FotaError network_tx(UartPort uart, uint8_t *data, size_t len);
 
#define FOTA_UART_TIMEOUT_MS 10U
 
bool isTimeout(bool is_tx);