board_driver.h

#ifndef BOARD_DRIVER_H
#define BOARD_DRIVER_H

#include <Adafruit_NeoPixel.h>

// ---------------------------
// Hardware Configuration
// ---------------------------

// if ESP32 use pin D8, otherwise 17
#if defined(ESP32)
    #define LED_PIN D8
#else
    #define LED_PIN     17       // Pin for NeoPixels
#endif

#define NUM_ROWS    8
#define NUM_COLS    8
#define LED_COUNT   (NUM_ROWS * NUM_COLS)
#define BRIGHTNESS  255  // LED brightness: 0-255 (0=off, 255=max). Current: 255 (100% max brightness)

// Shift Register (74HC594) Pins
#define SER_PIN     2   // Serial data input (74HC594 pin 14)
#define SRCLK_PIN   3   // Shift register clock (pin 11)
#define RCLK_PIN    4   // Latch clock (pin 12)

// Column Input Pins (D6..D13)
#define COL_PINS {6, 7, 8, 9, 10, 11, 12, 13}

// ---------------------------
// Board Driver Class
// ---------------------------
class BoardDriver {
private:
    Adafruit_NeoPixel strip;
    int colPins[NUM_COLS];
    byte rowPatterns[8];
    bool sensorState[8][8];
    bool sensorPrev[8][8];
    
    void loadShiftRegister(byte data);
    int getPixelIndex(int row, int col);

public:
    BoardDriver();
    void begin();
    void readSensors();
    bool getSensorState(int row, int col);
    bool getSensorPrev(int row, int col);
    void updateSensorPrev();
    
    // LED Control
    void clearAllLEDs();
    void setSquareLED(int row, int col, uint32_t color);
    void setSquareLED(int row, int col, uint8_t r, uint8_t g, uint8_t b, uint8_t w = 0);
    void showLEDs();
    
    // Animation Functions
    void fireworkAnimation();
    void captureAnimation();
    void promotionAnimation(int col);
    void blinkSquare(int row, int col, int times = 3);
    void highlightSquare(int row, int col, uint32_t color);
    
    // Setup Functions
    bool checkInitialBoard(const char initialBoard[8][8]);
    void updateSetupDisplay(const char initialBoard[8][8]);
    void printBoardState(const char initialBoard[8][8]);
};

#endif // BOARD_DRIVER_H