Initial public release of the 2024A software.

managed_components/espressif__usb_host_msc/private_include/diskio_usb.h

@@ -0,0 +1,39 @@
+/*
+ * SPDX-FileCopyrightText: 2015-2021 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#pragma once
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @brief Mass storage disk initialization structure
+ */
+typedef struct {
+    uint32_t block_size;    /**< Block size */
+    uint32_t block_count;   /**< Block count */
+} usb_disk_t;
+
+/**
+ * @brief Register mass storage disk to fat file system
+ *
+ * @param[in] pdrv Number of free drive obtained from ff_diskio_get_drive() function
+ * @param[in] disk usb_disk_t structure
+ */
+void ff_diskio_register_msc(uint8_t pdrv, usb_disk_t *disk);
+
+/**
+ * @brief Obtains number of drive assigned to usb disk upon calling ff_diskio_register_msc()
+ *
+ * @param[in] disk usb_disk_t structure
+ * @return Drive number
+ */
+uint8_t ff_diskio_get_pdrv_disk(const usb_disk_t *disk);
+
+#ifdef __cplusplus
+}
+#endif //__cplusplus

managed_components/espressif__usb_host_msc/private_include/msc_common.h

@@ -0,0 +1,89 @@
+/*
+ * SPDX-FileCopyrightText: 2015-2024 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#pragma once
+
+#include <stdint.h>
+#include <sys/queue.h>
+#include "esp_err.h"
+#include "esp_check.h"
+#include "diskio_usb.h"
+#include "usb/usb_host.h"
+#include "usb/usb_types_stack.h"
+#include "freertos/semphr.h"
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif
+
+typedef enum {
+    MSC_EP_OUT,
+    MSC_EP_IN
+} msc_endpoint_t;
+
+typedef struct {
+    uint16_t bulk_in_mps;
+    uint8_t bulk_in_ep;
+    uint8_t bulk_out_ep;
+    uint8_t iface_num;
+} msc_config_t;
+
+typedef struct msc_host_device {
+    STAILQ_ENTRY(msc_host_device) tailq_entry;
+    SemaphoreHandle_t transfer_done;
+    usb_device_handle_t handle;
+    usb_transfer_t *xfer;
+    msc_config_t config;
+    usb_disk_t disk;
+} msc_device_t;
+
+/**
+ * @brief Trigger a BULK transfer to device
+ *
+ * Data buffer ownership is transferred to the MSC driver and the application cannot access it before the transfer finishes.
+ *
+ * @param[in]    device_handle MSC device handle
+ * @param[inout] data          Data buffer. Direction depends on 'ep'.
+ * @param[in]    size          Size of buffer in bytes
+ * @param[in]    ep            Direction of the transfer
+ * @return esp_err_t
+ */
+esp_err_t msc_bulk_transfer(msc_device_t *device_handle, uint8_t *data, size_t size, msc_endpoint_t ep);
+
+/**
+ * @brief Trigger a CTRL transfer to device
+ *
+ * The request and data must be filled by accessing private device_handle->xfer before calling this function
+ *
+ * @param[in] device_handle MSC device handle
+ * @param[in] len           Length of the transfer
+ * @return esp_err_t
+ */
+esp_err_t msc_control_transfer(msc_device_t *device_handle, size_t len);
+
+/**
+ * @brief Reset endpoint and clear feature
+ *
+ * @param[in] device   MSC device handle
+ * @param[in] endpoint Endpoint number
+ * @return esp_err_t
+ */
+esp_err_t clear_feature(msc_device_t *device, uint8_t endpoint);
+
+#define MSC_GOTO_ON_ERROR(exp) ESP_GOTO_ON_ERROR(exp, fail, TAG, "")
+
+#define MSC_GOTO_ON_FALSE(exp, err) ESP_GOTO_ON_FALSE( (exp), err, fail, TAG, "" )
+
+#define MSC_RETURN_ON_ERROR(exp) ESP_RETURN_ON_ERROR((exp), TAG, "")
+
+#define MSC_RETURN_ON_FALSE(exp, err) ESP_RETURN_ON_FALSE( (exp), (err), TAG, "")
+
+#define MSC_RETURN_ON_INVALID_ARG(exp) ESP_RETURN_ON_FALSE((exp) != NULL, ESP_ERR_INVALID_ARG, TAG, "")
+
+#ifdef __cplusplus
+}
+#endif