From e71fb773ed68ed6e9c0a51f529f1adf5a799521e Mon Sep 17 00:00:00 2001
From: sakumisu <1203593632@qq.com>
Date: Fri, 8 Apr 2022 14:26:44 +0800
Subject: [PATCH] add aynsc transfer function

---
 common/usb_dc.h | 37 +++++++++++++++++++++++++++++++------
 1 file changed, 31 insertions(+), 6 deletions(-)

diff --git a/common/usb_dc.h b/common/usb_dc.h
index 5ac748bb..20cabb55 100644
--- a/common/usb_dc.h
+++ b/common/usb_dc.h
@@ -97,15 +97,15 @@ int usb_dc_detach(void);
  */
 int usbd_set_address(const uint8_t addr);
 
-/*
- * @brief configure and enable endpoint
+/**
+ * @brief configure and enable endpoint.
  *
- * This function sets endpoint configuration according to one specified in USB
+ * This function sets endpoint configuration according to one specified in USB.
  * endpoint descriptor and then enables it for data transfers.
  *
- * @param [in]  ep_desc Endpoint descriptor byte array
+ * @param [in]  ep_desc Endpoint descriptor byte array.
  *
- * @return true if successfully configured and enabled
+ * @return true if successfully configured and enabled.
  */
 int usbd_ep_open(const struct usbd_endpoint_cfg *ep_cfg);
 
@@ -155,7 +155,7 @@ int usbd_ep_clear_stall(const uint8_t ep);
 int usbd_ep_is_stalled(const uint8_t ep, uint8_t *stalled);
 
 /**
- * @brief Write data to the specified endpoint
+ * @brief Write data to the specified endpoint with poll mode.
  *
  * This function is called to write data to the specified endpoint. The
  * supplied usbd_endpoint_callback function will be called when data is transmitted
@@ -195,6 +195,31 @@ int usbd_ep_write(const uint8_t ep, const uint8_t *data, uint32_t data_len, uint
  */
 int usbd_ep_read(const uint8_t ep, uint8_t *data, uint32_t max_data_len, uint32_t *read_bytes);
 
+/**
+ * @brief Write data to the specified endpoint with async mode.
+ *
+ * @param[in]  ep        Endpoint address corresponding to the one
+ *                       listed in the device configuration table
+ * @param[in]  data      Pointer to data to write
+ * @param[in]  data_len  Length of the data requested to write. This may
+ *                       be zero for a zero length status packet.
+ *
+ * @return 0 on success, negative errno code on fail.
+ */
+int usbd_ep_write_async(const uint8_t ep, const uint8_t *data, uint32_t data_len);
+
+/**
+ * @brief Read data from the specified endpoint with async mode.
+ *
+ * @param[in]  ep           Endpoint address corresponding to the one
+ *                          listed in the device configuration table
+ * @param[in]  data         Pointer to data buffer to write to
+ * @param[in]  data_len     Max length of data to read
+ *
+ * @return 0 on success, negative errno code on fail.
+ */
+int usbd_ep_read_async(const uint8_t ep, uint8_t *data, uint32_t data_len);
+
 /**
  * @}
  */