Add DMA manager for optimized bitmap transfers and update related functions

Author: rzeldent

boards

@@ -0,0 +1,141 @@
+#ifndef ESP32_SMARTDISPLAY_DMA_H
+#define ESP32_SMARTDISPLAY_DMA_H
+
+#include <esp_err.h>
+#include <esp_lcd_panel_ops.h>
+#include <freertos/FreeRTOS.h>
+#include <freertos/queue.h>
+#include <freertos/semphr.h>
+#include <freertos/task.h>
+#include <lvgl.h>
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif
+
+// DMA transfer configuration (default values, can be overridden via build flags)
+#ifndef SMARTDISPLAY_DMA_BUFFER_SIZE
+#define SMARTDISPLAY_DMA_BUFFER_SIZE (32 * 1024) // 32KB DMA buffer
+#endif
+
+#ifndef SMARTDISPLAY_DMA_QUEUE_SIZE
+#define SMARTDISPLAY_DMA_QUEUE_SIZE 8 // Number of pending transfers
+#endif
+
+#ifndef SMARTDISPLAY_DMA_CHUNK_THRESHOLD
+#define SMARTDISPLAY_DMA_CHUNK_THRESHOLD (4 * 1024) // Use DMA for transfers > 4KB
+#endif
+
+#ifndef SMARTDISPLAY_DMA_TIMEOUT_MS
+#define SMARTDISPLAY_DMA_TIMEOUT_MS 1000 // DMA operation timeout
+#endif
+
+    // DMA transfer states
+    typedef enum
+    {
+        SMARTDISPLAY_DMA_STATE_IDLE = 0,
+        SMARTDISPLAY_DMA_STATE_BUSY,
+        SMARTDISPLAY_DMA_STATE_ERROR
+    } smartdisplay_dma_state_t;
+
+    // DMA transfer completion callback
+    typedef void (*smartdisplay_dma_callback_t)(bool success, void *user_data);
+
+    // DMA transfer descriptor
+    typedef struct
+    {
+        const void *src_data;                 // Source data pointer
+        size_t data_len;                      // Data length in bytes
+        int x_start, y_start;                 // Display coordinates
+        int x_end, y_end;                     // Display coordinates
+        smartdisplay_dma_callback_t callback; // Completion callback
+        void *user_data;                      // User data for callback
+        bool high_priority;                   // High priority transfer
+    } smartdisplay_dma_transfer_t;
+
+    // DMA manager structure
+    typedef struct
+    {
+        QueueHandle_t transfer_queue;        // Queue for pending transfers
+        SemaphoreHandle_t state_mutex;       // Mutex for state protection
+        TaskHandle_t worker_task;            // DMA worker task handle
+        smartdisplay_dma_state_t state;      // Current DMA state
+        void *dma_buffer;                    // DMA-capable buffer
+        size_t dma_buffer_size;              // DMA buffer size
+        esp_lcd_panel_handle_t panel_handle; // LCD panel handle
+        uint32_t active_transfers;           // Number of active transfers
+        uint32_t completed_transfers;        // Total completed transfers
+        uint32_t failed_transfers;           // Total failed transfers
+    } smartdisplay_dma_manager_t;
+
+    /**
+     * @brief Initialize DMA manager for display transfers
+     *
+     * @param panel_handle LCD panel handle
+     * @return esp_err_t ESP_OK on success
+     */
+    esp_err_t smartdisplay_dma_init(esp_lcd_panel_handle_t panel_handle);
+
+    /**
+     * @brief Deinitialize DMA manager
+     *
+     * @return esp_err_t ESP_OK on success
+     */
+    esp_err_t smartdisplay_dma_deinit();
+
+    /**
+     * @brief Queue a bitmap transfer with DMA optimization
+     *
+     * @param x_start Start X coordinate
+     * @param y_start Start Y coordinate
+     * @param x_end End X coordinate
+     * @param y_end End Y coordinate
+     * @param color_data Pixel data to transfer
+     * @param callback Completion callback (optional)
+     * @param user_data User data for callback (optional)
+     * @param high_priority High priority transfer flag
+     * @return esp_err_t ESP_OK on success
+     */
+    esp_err_t smartdisplay_dma_draw_bitmap(int x_start, int y_start, int x_end, int y_end, const void *color_data, smartdisplay_dma_callback_t callback, void *user_data, bool high_priority);
+
+    /**
+     * @brief Check if DMA transfer is recommended for given size
+     *
+     * @param data_len Data length in bytes
+     * @return true if DMA should be used
+     */
+    bool smartdisplay_dma_should_use_dma(size_t data_len);
+
+    /**
+     * @brief Wait for all pending DMA transfers to complete
+     *
+     * @param timeout_ms Timeout in milliseconds
+     * @return esp_err_t ESP_OK on success, ESP_ERR_TIMEOUT on timeout
+     */
+    esp_err_t smartdisplay_dma_wait_all_done(uint32_t timeout_ms);
+
+    /**
+     * @brief Get DMA manager statistics
+     *
+     * @param active_transfers Number of active transfers
+     * @param completed_transfers Total completed transfers
+     * @param failed_transfers Total failed transfers
+     * @return esp_err_t ESP_OK on success
+     */
+    esp_err_t smartdisplay_dma_get_stats(uint32_t *active_transfers, uint32_t *completed_transfers, uint32_t *failed_transfers);
+
+    /**
+     * @brief Flush LVGL display with DMA optimization
+     *
+     * @param display LVGL display handle
+     * @param area Display area to flush
+     * @param px_map Pixel data
+     */
+    void smartdisplay_dma_lvgl_flush(lv_display_t *display, const lv_area_t *area, uint8_t *px_map);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // ESP32_SMARTDISPLAY_DMA_H

include/esp32_smartdisplay_dma.h

@@ -37,7 +37,7 @@
 #default_envs = esp32-8048S050C
 #default_envs = esp32-8048S050N
 #default_envs = esp32-8048S050R 
-#default_envs = esp32-8048S070C
+default_envs = esp32-8048S070C
 #default_envs = esp32-8048S070N
 #default_envs = esp32-8048S070R
 #default_envs = esp32-8048S550C

platformio.ini

@@ -199,6 +199,18 @@ void smartdisplay_init()
   // Setup TFT display
   display = lvgl_lcd_init();
 
+  // Initialize DMA manager for optimized bitmap transfers
+  esp_err_t dma_init_result = smartdisplay_dma_init((esp_lcd_panel_handle_t)display->user_data);
+  if (dma_init_result != ESP_OK)
+  {
+    log_w("Failed to initialize DMA manager: %s", esp_err_to_name(dma_init_result));
+    log_i("Continuing with standard bitmap transfers");
+  }
+  else
+  {
+    log_i("DMA manager initialized for optimized transfers");
+  }
+
 #ifndef DISPLAY_SOFTWARE_ROTATION
   // Register callback for hardware rotation
   lv_display_add_event_cb(display, lvgl_display_resolution_changed_callback, LV_EVENT_RESOLUTION_CHANGED, NULL);