feat(multi-touch): Add track ID API to esp_lcd_touch

Author: PetrESP

components/lcd_touch/esp_lcd_touch/esp_lcd_touch.c

@@ -1,5 +1,5 @@
 /*
- * SPDX-FileCopyrightText: 2015-2023 Espressif Systems (Shanghai) CO LTD
+ * SPDX-FileCopyrightText: 2015-2025 Espressif Systems (Shanghai) CO LTD
  *
  * SPDX-License-Identifier: Apache-2.0
  */
@@ -106,6 +106,20 @@ bool esp_lcd_touch_get_coordinates(esp_lcd_touch_handle_t tp, uint16_t *x, uint1
     return touched;
 }
 
+esp_err_t esp_lcd_touch_get_track_id(esp_lcd_touch_handle_t tp, uint8_t *track_id, uint8_t point_num)
+{
+    assert(tp != NULL);
+    assert(track_id != NULL);
+    assert(point_num > 0);
+    assert(tp->get_track_id != NULL);
+
+    if (tp->get_track_id) {
+        return tp->get_track_id(tp, track_id, point_num);
+    } else {
+        return ESP_ERR_NOT_SUPPORTED;
+    }
+}
+
 #if (CONFIG_ESP_LCD_TOUCH_MAX_BUTTONS > 0)
 esp_err_t esp_lcd_touch_get_button_state(esp_lcd_touch_handle_t tp, uint8_t n, uint8_t *state)
 {

components/lcd_touch/esp_lcd_touch/idf_component.yml

@@ -1,4 +1,4 @@
-version: "1.1.2"
+version: "1.1.3"
 description: ESP LCD Touch - main component for using touch screen controllers
 url: https://github.com/espressif/esp-bsp/tree/master/components/lcd_touch/esp_lcd_touch
 dependencies:

components/lcd_touch/esp_lcd_touch/include/esp_lcd_touch.h

@@ -1,5 +1,5 @@
 /*
- * SPDX-FileCopyrightText: 2022-2024 Espressif Systems (Shanghai) CO LTD
+ * SPDX-FileCopyrightText: 2022-2025 Espressif Systems (Shanghai) CO LTD
  *
  * SPDX-License-Identifier: Apache-2.0
  */
@@ -72,6 +72,7 @@ typedef struct {
     uint8_t points; /*!< Count of touch points saved */
 
     struct {
+        uint8_t track_id;
         uint16_t x; /*!< X coordinate */
         uint16_t y; /*!< Y coordinate */
         uint16_t strength; /*!< Strength */
@@ -145,6 +146,18 @@ struct esp_lcd_touch_s {
      */
     bool (*get_xy)(esp_lcd_touch_handle_t tp, uint16_t *x, uint16_t *y, uint16_t *strength, uint8_t *point_num, uint8_t max_point_num);
 
+    /**
+     * @brief Get track ids of touch points
+     *
+     * @param tp: Touch handler
+     * @param track_id: Array of track ids
+     * @param point_num: Count of touched points to return
+     *
+     * @return
+     *      - ESP_OK on success, otherwise returns ESP_ERR_xxx
+     */
+    esp_err_t (*get_track_id)(esp_lcd_touch_handle_t tp, uint8_t *track_id, uint8_t point_num);
+
 
 #if (CONFIG_ESP_LCD_TOUCH_MAX_BUTTONS > 0)
     /**
@@ -287,6 +300,18 @@ esp_err_t esp_lcd_touch_read_data(esp_lcd_touch_handle_t tp);
 bool esp_lcd_touch_get_coordinates(esp_lcd_touch_handle_t tp, uint16_t *x, uint16_t *y, uint16_t *strength, uint8_t *point_num, uint8_t max_point_num);
 
 
+/**
+ * @brief Get track ids of touch points
+ *
+ * @param tp: Touch handler
+ * @param track_id: Array of track ids
+ * @param point_num: Count of touched points to return
+ *
+ * @return
+ *      - ESP_OK on success, otherwise returns ESP_ERR_xxx
+ */
+esp_err_t esp_lcd_touch_get_track_id(esp_lcd_touch_handle_t tp, uint8_t *track_id, uint8_t point_num);
+
 #if (CONFIG_ESP_LCD_TOUCH_MAX_BUTTONS > 0)
 /**
  * @brief Get button state