feat: project scaffolding with PlatformIO config and boot skeleton

Co-authored-by: Cursor <cursoragent@cursor.com>

src/config.h

@@ -0,0 +1,84 @@
+#pragma once
+
+// --- Pin Definitions ---
+// Buttons
+#define PIN_BTN_TOP       1   // G1 - Random photo
+#define PIN_BTN_UP        9   // G9 - Next photo
+#define PIN_BTN_DOWN      10  // G10 - Play/Pause
+
+// RGB LEDs (NeoPixel)
+#define PIN_RGB_LED       21
+#define NUM_RGB_LEDS      2
+
+// Audio (permanently disabled)
+#define PIN_AUDIO_PWR_EN  45
+#define PIN_SPK_EN        46
+
+// E-Paper SPI
+#define PIN_EPD_CLK       15
+#define PIN_EPD_MOSI      13
+#define PIN_EPD_CS        44
+#define PIN_EPD_DC        43
+#define PIN_EPD_BUSY      11
+#define PIN_EPD_RST       12
+
+// I2C System Bus (M5PM1, SHT40, RTC)
+#define PIN_SYS_SDA       3
+#define PIN_SYS_SCL       2
+
+// --- Display ---
+#define DISPLAY_WIDTH     600
+#define DISPLAY_HEIGHT    400
+#define DISPLAY_COLORS    6
+
+// --- Defaults ---
+#define DEFAULT_INTERVAL_MIN    5
+#define DEFAULT_CYCLE_MODE      0   // 0=random
+#define DEFAULT_IMG_QUALITY     0   // 0=preview
+#define DEFAULT_META_FLAGS      0x00
+#define DEFAULT_META_POS        0   // 0=bottom
+#define DEFAULT_LED_BRIGHTNESS  50
+#define DEFAULT_IMMICH_URL      "https://photos.example.com"
+
+// --- Timing ---
+#define BUTTON_DEBOUNCE_MS      50
+#define COMBO_HOLD_MS           3000
+#define FACTORY_RESET_HOLD_MS   5000
+#define BATTERY_CHECK_INTERVAL_MS 60000
+#define LED_PULSE_DURATION_MS   100
+#define QUEUE_RESYNC_HOURS      24
+#define WIFI_CONNECT_TIMEOUT_MS 15000
+#define WIFI_MAX_RETRIES        3
+
+// --- Battery Thresholds ---
+#define BATTERY_LOW_PCT         25
+#define BATTERY_CRITICAL_PCT    10
+#define BATTERY_SHUTDOWN_PCT    5
+#define BATTERY_WARN_INTERVAL_MS  300000  // 5 min
+#define BATTERY_CRIT_INTERVAL_MS  120000  // 2 min
+
+// --- Portrait Pairing ---
+#define PORTRAIT_LOOKAHEAD      5
+#define PORTRAIT_GAP_PX         8
+#define PORTRAIT_WIDTH          267  // (DISPLAY_HEIGHT * 2) / 3
+
+// --- Dither Palette (Spectra 6) ---
+// Initial values — calibrate on real hardware
+#define PALETTE_BLACK_R   0
+#define PALETTE_BLACK_G   0
+#define PALETTE_BLACK_B   0
+#define PALETTE_WHITE_R   255
+#define PALETTE_WHITE_G   255
+#define PALETTE_WHITE_B   255
+#define PALETTE_RED_R     200
+#define PALETTE_RED_G     30
+#define PALETTE_RED_B     30
+#define PALETTE_GREEN_R   30
+#define PALETTE_GREEN_G   160
+#define PALETTE_GREEN_B   30
+#define PALETTE_BLUE_R    30
+#define PALETTE_BLUE_G    30
+#define PALETTE_BLUE_B    200
+#define PALETTE_YELLOW_R  220
+#define PALETTE_YELLOW_G  200
+#define PALETTE_YELLOW_B  30

src/main.cpp

@@ -0,0 +1,26 @@
+#include <Arduino.h>
+#include <M5Unified.h>
+#include "config.h"
+
+void setup() {
+    auto cfg = M5.config();
+    M5.begin(cfg);
+
+    Serial.begin(115200);
+    Serial.println("[main] Immich Frame booting...");
+
+    // Disable audio permanently
+    pinMode(PIN_AUDIO_PWR_EN, OUTPUT);
+    digitalWrite(PIN_AUDIO_PWR_EN, LOW);
+    pinMode(PIN_SPK_EN, OUTPUT);
+    digitalWrite(PIN_SPK_EN, LOW);
+
+    Serial.printf("[main] Free heap: %d, PSRAM: %d\n",
+                  ESP.getFreeHeap(), ESP.getFreePsram());
+    Serial.println("[main] Boot complete (skeleton)");
+}
+
+void loop() {
+    M5.update();
+    delay(1000);
+}