steering.h

#pragma once
 
/************************************************************************************************
 * @file   steering.h
 *
 * @brief  Header file for steering
 *
 * @date   2025-07-09
 * @author Midnight Sun Team #24 - MSXVI
 ************************************************************************************************/
 
/* Standard library Headers */
#include <stdbool.h>
#include <stdint.h>
 
/* Inter-component Headers */
#include "global_enums.h"
 
/* Intra-component Headers */
#include "status.h"
 
/* Forward declarations */
struct ButtonManager;
struct ButtonLEDManager;
 
#define STEERING_BUTTON_DEBOUNCE_PERIOD_MS 5U
 
#define STEERING_CRUISE_MAX_SPEED_KMH 1000U  // 80
 
#define STEERING_CRUISE_MIN_SPEED_KMH 0U  // 40
 
typedef enum {
  STEERING_BUTTON_HAZARDS,
  STEERING_BUTTON_DRIVE,
  STEERING_BUTTON_NEUTRAL,
  STEERING_BUTTON_REVERSE,
 
  STEERING_BUTTON_REGEN,
 
  STEERING_BUTTON_LEFT_LIGHT,
  STEERING_BUTTON_RIGHT_LIGHT,
 
  STEERING_BUTTON_HORN,
 
  STEERING_BUTTON_CRUISE_CONTROL_UP,
  STEERING_BUTTON_CRUISE_CONTROL_DOWN,
 
  NUM_STEERING_BUTTONS,
} SteeringButtons;
 
typedef struct {
  uint16_t cruise_min_speed_kmh; 
  uint16_t cruise_max_speed_kmh; 
} SteeringConfig;
 
typedef struct {
  uint8_t pedal_percentage; 
  int16_t motor_heatsink_temp; 
  int16_t motor_temp;          
  int16_t vehicle_velocity; 
  int16_t motor_velocity;   
  BpsFault bps_fault;    
  float state_of_charge; 
  int16_t dcdc_voltage; 
  int16_t dcdc_current; 
  int16_t aux_voltage;  
  int16_t aux_current;  
  uint16_t pack_voltage; 
  uint16_t pack_current; 
  VehicleDriveState drive_state;
  uint8_t brake_enabled;
  uint8_t regen_enabled;
  uint8_t precharge_complete;
} DisplayData;
 
typedef struct {
  bool horn_enabled;           
  bool cruise_control_enabled; 
  uint16_t cruise_control_target_speed_kmh; 
  uint8_t drive_state;                      
  uint8_t light_signal;                     
  struct ButtonManager *button_manager;        
  struct ButtonLEDManager *button_led_manager; 
  DisplayData display_data;                    
  float estimated_km_remaining; 
  SteeringConfig *config; 
} SteeringStorage;
 
StatusCode steering_init(SteeringStorage *storage, SteeringConfig *config);