global_enums.h

#pragma once
 
/************************************************************************************************
 * @file   global_enums.h
 *
 * @brief  Header file for global enums which are exported between projects with CAN
 *
 * @date   2025-01-12
 * @author Midnight Sun Team #24 - MSXVI
 ************************************************************************************************/
 
/* Standard library Headers */
#include <stdint.h>
 
/* Inter-component Headers */
 
/* Intra-component Headers */
 
/************************************************************************************************
 * Shared Global definitions
 ************************************************************************************************/
 
typedef enum {
  VEHICLE_DRIVE_STATE_INVALID = 0, 
  VEHICLE_DRIVE_STATE_NEUTRAL = 1, 
  VEHICLE_DRIVE_STATE_DRIVE = 2,   
  VEHICLE_DRIVE_STATE_REVERSE = 3, 
  /* Extra drive state types used only by motor */
 
  VEHICLE_DRIVE_STATE_CRUISE = 4, 
  VEHICLE_DRIVE_STATE_BRAKE = 5,  
  VEHICLE_DRIVE_STATE_REGEN = 6,  
  VEHICLE_DRIVE_NUM_STATES,
} VehicleDriveState;
 
static const char *vehicle_drive_state_strings[VEHICLE_DRIVE_NUM_STATES] = {
  [VEHICLE_DRIVE_STATE_INVALID] = "INVALID", [VEHICLE_DRIVE_STATE_NEUTRAL] = "NEUTRAL", [VEHICLE_DRIVE_STATE_DRIVE] = "DRIVE", [VEHICLE_DRIVE_STATE_REVERSE] = "REVERSE",
  [VEHICLE_DRIVE_STATE_CRUISE] = "CRUISE",   [VEHICLE_DRIVE_STATE_BRAKE] = "BRAKE",     [VEHICLE_DRIVE_STATE_REGEN] = "REGEN",
};
 
#define VEHICLE_DRIVE_STATE_TO_STR(s) (((s) < VEHICLE_DRIVE_NUM_STATES) ? vehicle_drive_state_strings[(s)] : "UNKNOWN")
 
typedef enum {
  VEHICLE_POWER_STATE_IDLE,   
  VEHICLE_POWER_STATE_DRIVE,  
  VEHICLE_POWER_STATE_CHARGE, 
  VEHICLE_POWER_STATE_FAULT   
} VehiclePowerStates;
 
#define GLOBAL_SIGNAL_LIGHTS_BLINK_PERIOD_MS 400U
#define GLOBAL_BPS_LIGHTS_BLINK_PERIOD_MS 200U
 
/************************************************************************************************
 * Rear Controller Global Definitions
 ************************************************************************************************/
 
typedef enum {
  BPS_FAULT_OVERVOLTAGE,           
  BPS_FAULT_UNBALANCE,             
  BPS_FAULT_OVERTEMP_AMBIENT,      
  BPS_FAULT_COMMS_LOSS_AFE,        
  BPS_FAULT_COMMS_LOSS_CURR_SENSE, 
  BPS_FAULT_OVERTEMP_CELL,         
  BPS_FAULT_OVERCURRENT,           
  BPS_FAULT_UNDERVOLTAGE,          
  BPS_FAULT_KILLSWITCH,            
  BPS_FAULT_RELAY_CLOSE_FAILED,    
  BPS_FAULT_DISCONNECTED,          
  NUM_BPS_FAULTS
} BpsFault;
 
#define BPS_FAULT_OVERVOLTAGE_MASK (1U << BPS_FAULT_OVERVOLTAGE)
#define BPS_FAULT_UNBALANCE_MASK (1U << BPS_FAULT_UNBALANCE)
#define BPS_FAULT_OVERTEMP_AMBIENT_MASK (1U << BPS_FAULT_OVERTEMP_AMBIENT)
#define BPS_FAULT_COMMS_LOSS_AFE_MASK (1U << BPS_FAULT_COMMS_LOSS_AFE)
#define BPS_FAULT_COMMS_LOSS_CURR_SENSE_MASK (1U << BPS_FAULT_COMMS_LOSS_CURR_SENSE)
#define BPS_FAULT_OVERTEMP_CELL_MASK (1U << BPS_FAULT_OVERTEMP_CELL)
#define BPS_FAULT_OVERCURRENT_MASK (1U << BPS_FAULT_OVERCURRENT)
#define BPS_FAULT_UNDERVOLTAGE_MASK (1U << BPS_FAULT_UNDERVOLTAGE)
#define BPS_FAULT_KILLSWITCH_MASK (1U << BPS_FAULT_KILLSWITCH)
#define BPS_FAULT_RELAY_CLOSE_FAILED_MASK (1U << BPS_FAULT_RELAY_CLOSE_FAILED)
#define BPS_FAULT_DISCONNECTED_MASK (1U << BPS_FAULT_DISCONNECTED)
 
#define BPS_FAULT_HIGH_PRIORITY_MASK (1U << 15U)
#define BPS_FAULT_LOW_PRIORITY_MASK (1U << 14U)
 
/************************************************************************************************
 * Steering Global Definitions
 ************************************************************************************************/
 
typedef enum {
  STEERING_LIGHTS_OFF_STATE = 0,    
  STEERING_LIGHTS_LEFT_STATE = 1,   
  STEERING_LIGHTS_RIGHT_STATE = 2,  
  STEERING_LIGHTS_HAZARD_STATE = 3, 
  STEERING_LIGHTS_NUM_STATES,       
} SteeringLightState;
 
static const char *steering_light_state_strings[STEERING_LIGHTS_NUM_STATES] = { "OFF", "LEFT", "RIGHT", "HAZARD" };
 
#define STEERING_LIGHT_STATE_TO_STR(s) (((s) < STEERING_LIGHTS_NUM_STATES) ? steering_light_state_strings[(s)] : "UNKNOWN")
 
typedef enum {
  BPS_LIGHT_ON_STATE,   
  BPS_LIGHT_OFF_STATE,  
  NUM_BPS_LIGHT_STATES, 
} BpsLightState;
 
typedef enum {
  STEERING_CRUISE_CONTROL_DECREASE_BIT = 0, 
  STEERING_CRUISE_CONTROL_INCREASE_BIT,     
  STEERING_CRUISE_CONTROL_TOGGLE_BIT,       
} SteeringCruiseControl;
 
#define STEERING_CC_INCREASE_MASK (1U << EE_STEERING_CC_INCREASE_BIT)
#define STEERING_CC_DECREASE_MASK (1U << EE_STEERING_CC_DECREASE_BIT)
#define STEERING_CC_TOGGLE_MASK (1U << EE_STEERING_CC_TOGGLE_BIT)
 
/************************************************************************************************
 * Power Distribution Global Definitions
 ************************************************************************************************/
 
typedef enum {
  EE_POWER_OFF_STATE,       
  EE_POWER_PRECHARGE_STATE, 
  EE_POWER_DRIVE_STATE,     
  EE_POWER_FAULT_STATE      
} PDPowerState;