button.h

#pragma once
 
/************************************************************************************************
 * @file    button.h
 *
 * @brief   Header file for managing an individual GPIO-connected button with debounce and edge callbacks.
 *
 * @date    2025-07-28
 * @author  Midnight Sun Team #24 - MSXVI
 ************************************************************************************************/
 
/* Standard library Headers */
#include <stdbool.h>
 
/* Inter-component Headers */
#include "gpio.h"
#include "status.h"
 
/* Intra-component Headers */
 
typedef enum {
  BUTTON_IDLE,   
  BUTTON_PRESSED 
} ButtonState;
 
typedef struct Button Button;
 
typedef struct {
  void (*rising_edge_cb)(Button *button);  
  void (*falling_edge_cb)(Button *button); 
} ButtonCallbacks;
 
typedef struct {
  GpioAddress gpio;          
  bool active_low;           
  uint8_t debounce_ms;       
  ButtonCallbacks callbacks; 
} ButtonConfig;
 
typedef struct Button {
  ButtonConfig *config; 
  uint8_t last_raw;     
  uint8_t counter;      
  ButtonState state;    
} Button;
 
StatusCode button_init(Button *button, ButtonConfig *config);
 
StatusCode button_update(Button *button);