T-Echo-Card support (#10267)

# Conflicts:
#	src/graphics/draw/UIRenderer.cpp

variants/nrf52840/t-echo-card/variant.h

@@ -0,0 +1,202 @@
+// Variant definition for LilyGo T-Echo-Card (nRF52840)
+
+#ifndef _VARIANT_T_ECHO_CARD_
+#define _VARIANT_T_ECHO_CARD_
+
+/** Master clock frequency */
+#define VARIANT_MCK (64000000ul)
+
+#define USE_LFXO // Board uses 32kHz crystal for LF
+
+/*----------------------------------------------------------------------------
+ *        Headers
+ *----------------------------------------------------------------------------*/
+
+#include "WVariant.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif // __cplusplus
+
+// Number of pins defined in PinDescription array
+#define PINS_COUNT (48)
+#define NUM_DIGITAL_PINS (48)
+#define NUM_ANALOG_INPUTS (1)
+#define NUM_ANALOG_OUTPUTS (0)
+
+// LEDs - board only exposes 3x WS2812 addressable LEDs. No plain GPIO LEDs.
+// Intentionally do not define PIN_LED1 on this variant, so nRF52 platform
+// code does not auto-enable a nonexistent GPIO power/status LED.
+#define LED_STATE_ON 1
+
+// Three independent WS2812 data lines (one LED per line, not a daisy chain).
+// Each is driven as a 1-pixel NeoPixel by StatusLEDModule / ExternalNotification,
+// assigns LED_POWER (red) and LED_NOTIFICATION (green).
+#define WS2812_DATA_1 (32 + 7)  // P1.7  - charge/heartbeat (red)
+#define WS2812_DATA_2 (32 + 12) // P1.12 - external notification (green)
+#define WS2812_DATA_3 (0 + 28)  // P0.28 - BLE pairing (blue)
+
+// Wire each WS2812 to a status role. Colour defaults are scaled to 25%
+// brightness (0x40) — the bare-die WS2812s on this board are very bright at
+// full intensity in a close-range enclosure.
+#define NEOPIXEL_STATUS_POWER_PIN WS2812_DATA_1
+#define NEOPIXEL_STATUS_NOTIFICATION_PIN WS2812_DATA_2
+#define NEOPIXEL_STATUS_PAIRING_PIN WS2812_DATA_3
+#define NEOPIXEL_STATUS_POWER_COLOR 0x400000        // red   @ 25%
+#define NEOPIXEL_STATUS_NOTIFICATION_COLOR 0x004000 // green @ 25%
+#define NEOPIXEL_STATUS_PAIRING_COLOR 0x000040      // blue  @ 25%
+
+// The charger IC does not blink on its own; let StatusLEDModule do the
+// software blink while charging
+// If left defined: hardware would be expected to handle the charging pulse.
+// #define POWER_LED_HARDWARE_BLINKS_WHILE_CHARGING
+
+// Buttons
+#define PIN_BUTTON1 (32 + 10) // KEY_1: P1.10
+
+#define BUTTON_CLICK_MS 400
+
+// Analog pins
+#define PIN_A0 (0 + 2) // Battery ADC (BATTERY_ADC_DATA)
+
+#define BATTERY_PIN PIN_A0
+
+static const uint8_t A0 = PIN_A0;
+
+#define ADC_RESOLUTION 14
+
+// BATTERY_MEASUREMENT_CONTROL - enable divider for battery reading
+#define ADC_CTRL (0 + 31)
+#define ADC_CTRL_ENABLED HIGH
+
+// NFC placeholders, not used
+#define PIN_NFC1 (9)
+#define PIN_NFC2 (10)
+
+// Wire Interfaces (IIC_1 on the vendor header)
+#define WIRE_INTERFACES_COUNT 1
+
+#define PIN_WIRE_SDA (32 + 4) // IIC_1_SDA: P1.4
+#define PIN_WIRE_SCL (32 + 2) // IIC_1_SCL: P1.2
+
+// External serial flash ZD25WQ32CEIGR
+// QSPI Pins
+#define PIN_QSPI_SCK (0 + 4)
+#define PIN_QSPI_CS (0 + 12)
+#define PIN_QSPI_IO0 (0 + 6)  // MOSI if using two bit interface
+#define PIN_QSPI_IO1 (0 + 8)  // MISO if using two bit interface
+#define PIN_QSPI_IO2 (32 + 9) // WP
+#define PIN_QSPI_IO3 (0 + 26) // HOLD
+
+// On-board QSPI Flash
+#define EXTERNAL_FLASH_DEVICES ZD25WQ32CEIGR
+#define EXTERNAL_FLASH_USE_QSPI
+
+// Lora S62F (SX1262)
+#define USE_SX1262
+#define SX126X_CS (0 + 11)
+#define SX126X_DIO1 (32 + 8)
+#define SX126X_DIO2 (0 + 5)
+#define SX126X_BUSY (0 + 14)
+#define SX126X_RESET (0 + 7)
+#define SX126X_RXEN (32 + 1) // SX1262_RF_VC2
+#define SX126X_TXEN (0 + 27) // SX1262_RF_VC1
+#define SX126X_DIO3_TCXO_VOLTAGE 1.8
+
+// ───────────────────────────────────────────────────────────────────────────
+// OLED display: SSD1315 on I2C @ 0x3C (IIC_1). SSD1315 is register-compatible
+// with SSD1306, so USE_SSD1306 initializes the controller correctly.
+//
+// Viewport: the physical panel is 72×40, mapped into the SSD1315's 128×64
+// GDDRAM at columns 28..99, pages 3..7 (rows 24..63). The firmware handles
+// this by:
+//   * asking the library for GEOMETRY_72_40, which sets the framebuffer to
+//     72×40 and emits the right SETMULTIPLEX (39) / SETCOMPINS at init;
+//   * relying on SSD1306Wire's built-in horizontal auto-centering
+//     ((128 - width) / 2 = 28), so no horizontal shim is needed;
+//   * calling SSD1306Wire::setYOffset(3) in Screen.cpp when
+//     OLED_Y_OFFSET_PAGES is defined — this shifts every PAGEADDR write by
+//     three pages (24 rows) so data lands on the visible rows.
+// ───────────────────────────────────────────────────────────────────────────
+#define HAS_SCREEN 1
+#define USE_SSD1306
+#define OLED_GEOMETRY_OVERRIDE GEOMETRY_72_40
+#define OLED_Y_OFFSET_PAGES 3
+#define OLED_TINY
+
+// Controls power 3V3 for all peripherals (GPS + LoRa + Sensor)
+#define PIN_POWER_EN (0 + 30) // RT9080_EN
+
+// SPI1 is unused (no external SPI display). Keep declarations for the core.
+#define PIN_SPI1_MISO (-1)
+#define PIN_SPI1_MOSI (-1)
+#define PIN_SPI1_SCK (-1)
+
+// GPS pins
+#define GPS_L76K
+#define GPS_BAUDRATE 9600
+#define HAS_GPS 1
+
+#define PIN_GPS_EN (32 + 15) // GPS_EN: P1.15 - GPS power enable
+#define GPS_EN_ACTIVE 1
+#define PIN_GPS_STANDBY (0 + 25) // GPS_WAKE_UP: P0.25 - wakeup pin
+#define PIN_GPS_PPS (0 + 23)     // GPS_1PPS: P0.23
+#define GPS_RX_PIN (0 + 19)      // MCU RX ← GPS's TX (vendor GPS_UART_TX / P0.19)
+#define GPS_TX_PIN (0 + 21)      // MCU TX → GPS's RX (vendor GPS_UART_RX / P0.21)
+#define PIN_GPS_RESET (0 + 29)   // GPS_RF_EN: GPS RF enable / reset
+
+#define GPS_THREAD_INTERVAL 50
+
+#define PIN_SERIAL1_RX GPS_RX_PIN
+#define PIN_SERIAL1_TX GPS_TX_PIN
+
+// SPI Interfaces (LoRa on SPI0)
+#define SPI_INTERFACES_COUNT 2
+
+// For LORA, SPI 0
+#define PIN_SPI_MISO (0 + 17)
+#define PIN_SPI_MOSI (0 + 15)
+#define PIN_SPI_SCK (0 + 13)
+
+// Battery
+// The battery sense is hooked to PIN_A0 (P0.2) via a divider controlled by ADC_CTRL.
+#define BATTERY_SENSE_RESOLUTION_BITS 12
+#define BATTERY_SENSE_RESOLUTION 4096.0
+#undef AREF_VOLTAGE
+#define AREF_VOLTAGE 3.0
+#define VBAT_AR_INTERNAL AR_INTERNAL_3_0
+#define ADC_MULTIPLIER (2.0F)
+
+// Buzzer (PWM output, passive piezo)
+#define PIN_BUZZER (32 + 6) // BUZZER_DATA: P1.6
+
+// ───────────────────────────────────────────────────────────────────────────
+// I²S speaker (MAX98357 Class-D amp). Stereo I²S data path.
+// Not supported on nrf52. These defines exist for out-of-tree code only.
+// ───────────────────────────────────────────────────────────────────────────
+#define SPEAKER_EN (32 + 11)     // P1.11 - amp main enable
+#define SPEAKER_EN_2 (0 + 3)     // P0.3  - secondary enable (vendor firmware toggles both)
+#define SPEAKER_BCLK (0 + 16)    // P0.16 - I2S bit clock
+#define SPEAKER_DATA (0 + 20)    // P0.20 - I2S data (SDOUT)
+#define SPEAKER_WS_LRCK (0 + 22) // P0.22 - I2S word select / LRCK
+
+// ───────────────────────────────────────────────────────────────────────────
+// PDM microphone (ST MP34DT05).
+// TODO to enable a mic path:
+// Use Adafruit nRF52 core's built-in PDM.h wrapper (Arduino-compatible
+// API exists on nRF52840). Clock on MIC_SCLK, data on MIC_DATA.
+// ───────────────────────────────────────────────────────────────────────────
+#define MIC_SCLK (32 + 3) // P1.3 - PDM clock (MIC_SCLK on vendor header)
+#define MIC_DATA (32 + 5) // P1.5 - PDM data (MIC_DATA on vendor header)
+
+#define SERIAL_PRINT_PORT 0
+
+#ifdef __cplusplus
+}
+#endif
+
+/*----------------------------------------------------------------------------
+ *        Arduino objects - C++ only
+ *----------------------------------------------------------------------------*/
+
+#endif