Trackball Pointer Mode & driver rewrite (#453)

Devices/lilygo-tdeck/Source/Trackball/Trackball.h

@@ -5,16 +5,25 @@
 
 namespace trackball {
 
+/**
+ * @brief Trackball operating mode
+ */
+enum class Mode {
+    Encoder,  // Navigation via enc_diff (scroll wheel behavior)
+    Pointer   // Mouse cursor via point.x/y
+};
+
 /**
  * @brief Trackball configuration structure
  */
 struct TrackballConfig {
-    gpio_num_t pinRight;      // Right direction GPIO
-    gpio_num_t pinUp;         // Up direction GPIO
-    gpio_num_t pinLeft;       // Left direction GPIO
-    gpio_num_t pinDown;       // Down direction GPIO
-    gpio_num_t pinClick;      // Click/select button GPIO
-    uint8_t movementStep;     // Pixels to move per trackball event (default: 10)
+    gpio_num_t pinRight;          // Right direction GPIO
+    gpio_num_t pinUp;             // Up direction GPIO
+    gpio_num_t pinLeft;           // Left direction GPIO
+    gpio_num_t pinDown;           // Down direction GPIO
+    gpio_num_t pinClick;          // Click/select button GPIO
+    uint8_t encoderSensitivity = 1;   // Encoder mode: steps per tick
+    uint8_t pointerSensitivity = 10;   // Pointer mode: pixels per tick
 };
 
 /**
@@ -30,10 +39,16 @@ lv_indev_t* init(const TrackballConfig& config);
 void deinit();
 
 /**
- * @brief Set movement step size
- * @param step Encoder steps per trackball event
+ * @brief Set encoder mode sensitivity
+ * @param sensitivity Steps per trackball tick (1-10, default: 1)
  */
-void setMovementStep(uint8_t step);
+void setEncoderSensitivity(uint8_t sensitivity);
+
+/**
+ * @brief Set pointer mode sensitivity
+ * @param sensitivity Pixels per trackball tick (1-10, default: 10)
+ */
+void setPointerSensitivity(uint8_t sensitivity);
 
 /**
  * @brief Enable or disable trackball input processing
@@ -41,4 +56,16 @@ void setMovementStep(uint8_t step);
  */
 void setEnabled(bool enabled);
 
+/**
+ * @brief Set trackball operating mode
+ * @param mode Encoder or Pointer mode
+ */
+void setMode(Mode mode);
+
+/**
+ * @brief Get current trackball operating mode
+ * @return Current mode
+ */
+Mode getMode();
+
 }