joystick.h

 
#pragma once
 
#include <Arduino.h>
 
#define JOYSTICK_DEADZONE 150       
#define JOYSTICK_RESOLUTION_BITS 12 
#define JOYSTICK_SAMPLES 5          
#define BUTTON_DEBOUNCE_MS 50       
class Joystick
{
private:
    uint8_t _pin_x;           
    uint8_t _pin_y;           
    uint8_t _pin_z;           
    int _deadzone;            
    int _center_x, _center_y; 
 
    // Button state for Z-axis
    bool _last_btn_state;              
    unsigned long _last_debounce_time; 
 
    int _read_raw(uint8_t pin) const;
 
    int _process_axis(int raw_val, int center) const;
 
    int _map_speed(int val, int min_out, int max_out) const;
 
public:
    Joystick(uint8_t pin_x, uint8_t pin_y, uint8_t pin_z, int deadzone = JOYSTICK_DEADZONE)
        : _pin_x(pin_x), _pin_y(pin_y), _pin_z(pin_z), _deadzone(deadzone), _center_x(0), _center_y(0),
          _last_btn_state(HIGH), _last_debounce_time(0){};
 
    void begin();
    int get_x() const { return _process_axis(this->_read_raw(this->_pin_x), this->_center_x); }
 
    int get_y() const { return _process_axis(this->_read_raw(this->_pin_y), this->_center_y); }
 
    bool is_active() const;
    bool is_z_pressed();
 
    bool is_z_held() const { return digitalRead(this->_pin_z) == LOW; }
    int get_speed_x(int min_out = -255, int max_out = 255) { return this->_map_speed(get_x(), min_out, max_out); }
 
    int get_speed_y(int min_out = -255, int max_out = 255) { return this->_map_speed(get_y(), min_out, max_out); }
};