input.h

// input.h — Button and joystick polling interface.
//
// Four directional inputs on PORTD (PD2, PD4, PD5, PD6), internal
// pull-ups enabled, active-low. NOTE: that's direction-only -- there's no
// separate confirm/back/select line in the spec. See the TODO in menu.c;
// this is flagged as an open design question, not silently worked around.

#ifndef INPUT_H
#define INPUT_H

#include <stdint.h>
#include <stdbool.h>

typedef enum {
    BUTTON_UP = 0,
    BUTTON_DOWN,
    BUTTON_LEFT,
    BUTTON_RIGHT,
    BUTTON_START,
    BUTTON_SELECT,
    BUTTON_HOME,
    BUTTON_COUNT
} ButtonId;

void inputInit(void);

// Call once per main loop iteration with the current systemGetTimeMs().
// Runs edge-triggered, time-based debouncing for all four buttons.
void inputUpdate(uint32_t nowMs);

bool inputIsHeld(ButtonId btn);
bool inputWasPressed(ButtonId btn);  // debounced press edge this frame
bool inputWasReleased(ButtonId btn); // debounced release edge this frame
bool inputIsRepeated(ButtonId btn);  // triggers on press, then repeats while held

// Returns the raw ADC 10-bit value (0-1023). Midpoint is ~512.
uint16_t inputGetJoystickX(void);
uint16_t inputGetJoystickY(void);

#endif // INPUT_H