Add support of user_data in read_cb (Fixes #604) (IEC-413) (#607)

Add support of user_data in read_cb (Fixes #604)

Added in reference to write callback. Is backward compatible.

Tested with file read using FileIO in esp32s3.

* Bump component version to 1.1.4 and update changelogs

* Update esp_delta_ota/src/esp_delta_ota.c

Author: erwinschrodinger1

esp_delta_ota/CHANGELOG.md

@@ -1,3 +1,8 @@
+## 1.1.4
+
+### Enhancements:
+- Added support to pass user data to read callback with new callback function: `src_read_cb_with_user_ctx_t`
+
 ## 1.1.3
 
 ### Bugfixes:

esp_delta_ota/idf_component.yml

@@ -1,4 +1,4 @@
-version: "1.1.3"
+version: "1.1.4"
 description: "ESP Delta OTA Library"
 url: https://github.com/espressif/idf-extra-components/tree/master/esp_delta_ota
 dependencies:

esp_delta_ota/include/esp_delta_ota.h

@@ -23,14 +23,18 @@ typedef void *esp_delta_ota_handle_t;
 
 // Callback for reading the source data
 typedef esp_err_t (*src_read_cb_t)(uint8_t *buf_p, size_t size, int src_offset);
+typedef esp_err_t (*src_read_cb_with_user_ctx_t)(uint8_t *buf_p, size_t size, int src_offset, void *user_data);
 
 // Callback for working on the data generated by applying patch on the source data
 typedef esp_err_t (*merged_stream_write_cb_t)(const uint8_t *buf_p, size_t size);
 typedef esp_err_t (*merged_stream_write_cb_with_user_ctx_t)(const uint8_t *buf_p, size_t size, void *user_data);
 
 typedef struct esp_delta_ota_cfg {
     void *user_data;              /*!< User Data */
-    src_read_cb_t read_cb;        /*!< Read Callback */
+    union {
+        src_read_cb_t read_cb;        /*!< Read Callback */
+        src_read_cb_with_user_ctx_t read_cb_with_user_data; /*!< Read Callback with user data */
+    };
     union {
         merged_stream_write_cb_with_user_ctx_t write_cb_with_user_data;     /*!< Write Callback with user data */
         merged_stream_write_cb_t write_cb DEPRECATED_ATTRIBUTE;             /*!< Write Callback */

esp_delta_ota/src/esp_delta_ota.c

@@ -19,7 +19,10 @@ static const char *TAG = "esp_delta_ota";
 
 typedef struct esp_delta_ota_ctx {
     void *user_data;
-    src_read_cb_t read_cb;
+    union {
+        src_read_cb_t read_cb;        /*!< Read Callback */
+        src_read_cb_with_user_ctx_t read_cb_with_user_data; /*!< Read Callback with user data */
+    };
     union {
         merged_stream_write_cb_with_user_ctx_t write_cb_with_user_data;
         merged_stream_write_cb_t write_cb;
@@ -57,11 +60,21 @@ static int esp_delta_ota_read_cb(void *arg_p, uint8_t *buf_p, size_t size)
         return -ESP_ERR_INVALID_ARG;
     }
     esp_delta_ota_ctx *handle = (esp_delta_ota_ctx *)arg_p;
-    esp_err_t err = handle->read_cb(buf_p, size, handle->src_offset);
-    if (err != ESP_OK) {
-        ESP_LOGE(TAG, "Error in read_cb(): %s", esp_err_to_name(err));
-        return ESP_FAIL;
+    esp_err_t err = ESP_OK;
+    if (!handle->user_data) {
+        err = handle->read_cb(buf_p, size, handle->src_offset);
+        if (err != ESP_OK) {
+            ESP_LOGE(TAG, "Error in read_cb(): %s", esp_err_to_name(err));
+            return ESP_FAIL;
+        }
+    } else {
+        err = handle->read_cb_with_user_data(buf_p, size, handle->src_offset, handle->user_data);
+        if (err != ESP_OK) {
+            ESP_LOGE(TAG, "Error in read_cb_with_user_data(): %s", esp_err_to_name(err));
+            return ESP_FAIL;
+        }
     }
+
     handle->src_offset += size;
     return ESP_OK;
 }