Initial commit: Base Project for Kode Dot (ESP32-S3)

2026-04-03 13:21:23 +02:00
commit a3d9840a92
30 changed files with 59419 additions and 0 deletions
@@ -0,0 +1,78 @@
+#pragma once
+
+#include <Arduino.h>
+#include <Arduino_GFX_Library.h>
+#include <lvgl.h>
+#include <kodedot/pin_config.h>
+#include <bb_captouch.h>
+
+/**
+ * @brief High-level manager that initializes and wires up the display, LVGL, and touch input.
+ *
+ * Responsibilities:
+ * - Bring up the panel using Arduino_GFX
+ * - Allocate LVGL draw buffers (prefer PSRAM, fallback to SRAM)
+ * - Register LVGL display and input drivers
+ * - Provide simple helpers for brightness and touch reading
+ */
+class DisplayManager {
+private:
+    // Hardware interfaces
+    Arduino_DataBus *bus;
+    Arduino_CO5300 *gfx;
+    BBCapTouch bbct;
+    
+    // LVGL draw buffer and driver handles
+    lv_disp_draw_buf_t draw_buf;
+    lv_color_t *buf;
+    lv_color_t *buf2;
+    lv_disp_drv_t disp_drv;
+    
+    // Static callbacks required by LVGL
+    static void disp_flush_callback(lv_disp_drv_t *disp, const lv_area_t *area, lv_color_t *color_p);
+    static void touchpad_read_callback(lv_indev_drv_t *indev_drv, lv_indev_data_t *data);
+    
+    // Singleton-like back-reference used by static callbacks
+    static DisplayManager* instance;
+
+public:
+    DisplayManager();
+    ~DisplayManager();
+    
+    /**
+     * @brief Fully initialize display, LVGL, and touch.
+     * @return true on success, false otherwise
+     */
+    bool init();
+    
+    /**
+     * @brief Get the underlying Arduino_GFX panel instance.
+     */
+    Arduino_CO5300* getGfx() { return gfx; }
+    
+    /**
+     * @brief Get the touch controller instance.
+     */
+    BBCapTouch* getTouch() { return &bbct; }
+    
+    /**
+     * @brief Pump LVGL timers and tick. Call frequently in loop().
+     */
+    void update();
+    
+    /**
+     * @brief Set backlight brightness.
+     * @param brightness Range 0-255
+     */
+    void setBrightness(uint8_t brightness);
+    
+    /**
+     * @brief Read current touch coordinates.
+     * @param x Output X coordinate
+     * @param y Output Y coordinate
+     * @return true if there is an active touch
+     */
+    bool getTouchCoordinates(int16_t &x, int16_t &y);
+};
+
+
@@ -0,0 +1,88 @@
+#pragma once
+/* ---------- Buttons ---------- */
+#define BUTTON_TOP            0   // GPIO_NUM_0
+// Bottom button is provided by the IO expander
+#define BUTTON_BOTTOM         EXPANDER_BUTTON_BOTTOM
+
+/* ---------- NeoPixel LED ---------- */
+#define LED_STRIP_PIN         4
+#define LED_STRIP_NUM_LEDS    1
+#define LED_STRIP_RMT_RES_HZ  10000000  // 10 MHz
+
+/* ---------- LCD Panel ---------- */
+#define LCD_WIDTH             410
+#define LCD_HEIGHT            502
+#define LCD_SPI_HOST          SPI3_HOST
+#define LCD_PIXEL_CLK_HZ      40000000    // 40 MHz
+#define LCD_CMD_BITS          8
+#define LCD_PARAM_BITS        8
+#define LCD_COLOR_SPACE       ESP_LCD_COLOR_SPACE_RGB
+#define LCD_BITS_PER_PIXEL    16
+#define LCD_DRAW_BUFF_DOUBLE  1
+// Use full-height buffer (PSRAM available)
+#define LCD_DRAW_BUFF_HEIGHT  LCD_HEIGHT
+
+// LCD pins (QSPI)
+#define LCD_SCLK              17
+#define LCD_SDIO0             15
+#define LCD_SDIO1             14
+#define LCD_SDIO2             16
+#define LCD_SDIO3             10
+#define LCD_RST                8
+#define LCD_CS                 9
+#define LCD_EN               -1  // no dedicated enable pin
+
+/* ---------- Touch / IO Expander ---------- */
+#define TOUCH_I2C_NUM         0
+#define TOUCH_I2C_SCL         47
+#define TOUCH_I2C_SDA         48
+#define TOUCH_INT            -1
+#define TOUCH_RST            -1
+
+#define IOEXP_I2C_NUM         TOUCH_I2C_NUM
+#define IOEXP_I2C_SCL         TOUCH_I2C_SCL
+#define IOEXP_I2C_SDA         TOUCH_I2C_SDA
+#define IOEXP_I2C_ADDR        0x20   // TCA9555 address 000
+#define IOEXP_INT_PIN         18
+
+/* ---------- SD-Card (SDMMC) ---------- */
+// Host and frequency
+#define SD_SDMMC_HOST         SDMMC_HOST_SLOT_1
+#define SD_MAX_FREQ_KHZ       50000
+// SDMMC pins (1-bit width)
+#define SD_PIN_CMD            5
+#define SD_PIN_CLK            6
+#define SD_PIN_D0             7
+// Card detect via IO expander
+#define SD_DETECT_PIN         EXPANDER_SD_CD
+// Mount parameters
+#define SD_MOUNT_POINT        "/sdcard"
+#define SD_MAX_FILES          5
+#define SD_FORMAT_IF_FAIL     0
+
+/* ---------- Sensors ---------- */
+#define MAX17048_I2C_ADDRESS  0x36
+#define BQ25896_I2C_ADDRESS   0x6A
+
+/* ---------- IO Expander pin map ---------- */
+// These defines require including <TCA9555.h> in the source file that uses them
+#define EXPANDER_MAG_INT        0x00  // P00 - Magnetometer interrupt
+#define EXPANDER_RTC_INTB       0x01  // P01 - RTC INTB
+#define EXPANDER_RTC_INTA       0x02  // P02 - RTC INTA
+#define EXPANDER_SPK_SHUTDOWN   0x03  // P03 - Speaker shutdown
+#define EXPANDER_PWR_PHRL       0x04  // P04 - Power PHRL
+#define EXPANDER_FG_ALRT        0x05  // P05 - Fuel gauge alert
+#define EXPANDER_PAD_TOP        0x06  // P06 - D-pad TOP (external pull-up)
+#define EXPANDER_PAD_LEFT       0x07  // P07 - D-pad LEFT (external pull-up)
+#define EXPANDER_PAD_BOTTOM     8     // P10 - D-pad BOTTOM (external pull-up)
+#define EXPANDER_BUTTON_BOTTOM  9     // P11 - Bottom button (external pull-up)
+#define EXPANDER_PWR_INT        10    // P12 - Power INT
+#define EXPANDER_PAD_RIGHT      11    // P13 - D-pad RIGHT (external pull-up)
+#define EXPANDER_SD_CD          14    // P16 - SD card detect
+
+/* ---------- NeoPixel convenience ---------- */
+#define NEO_PIXEL_PIN    LED_STRIP_PIN
+#define NEO_PIXEL_COUNT  LED_STRIP_NUM_LEDS
+// Type: NEO_GRB + NEO_KHZ800 (define in the source using Adafruit_NeoPixel)
+
+