add some dcd api

common/usb_dc.h

@@ -209,7 +209,7 @@ int usbd_ep_read(const uint8_t ep, uint8_t *data, uint32_t max_data_len, uint32_
 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.
+ * @brief Read data from the specified endpoint with async mode.Actually,this function is used for these endpoint transferring with dma mode.
  *
  * @param[in]  ep           Endpoint address corresponding to the one
  *                          listed in the device configuration table
@@ -220,6 +220,33 @@ int usbd_ep_write_async(const uint8_t ep, const uint8_t *data, uint32_t data_len
  */
 int usbd_ep_read_async(const uint8_t ep, uint8_t *data, uint32_t data_len);
 
+/**
+ * @brief Get actual read len when ep transfers completely by usbd_ep_read_async.
+ *
+ * @param[in]  ep           Endpoint address corresponding to the one
+ *                          listed in the device configuration table
+ * @return Actual read len.
+ */
+uint32_t usbd_ep_get_read_len(const uint8_t ep);
+
+/**
+ * @brief Check if in ep transfers done.
+ *
+ * @param[in]  ep           Endpoint address corresponding to the one
+ *                          listed in the device configuration table
+ * @return true means transfer completely.Otherwise not.
+ */
+bool usbd_ep_is_complete(const uint8_t ep);
+
+/**
+ * @brief Get endpoint max packet size.
+ *
+ * @param[in]  ep           Endpoint address corresponding to the one
+ *                          listed in the device configuration table
+ * @return endpoint max packet size.
+ */
+uint16_t usbd_ep_get_mps(const uint8_t ep);
+
 /**
  * @}
  */

docs/source/api/api_port.rst

@@ -145,6 +145,70 @@ usbd_ep_read
 - **ret_bytes** 实际接收的长度
 - **return** 返回 0 表示正确，其他表示错误
 
+usbd_ep_write_async
+""""""""""""""""""""""""""""""""""""
+
+``usbd_ep_write_async`` 向某个端点发送数据， 该函数为异步传输。 **此函数对用户开放**。
+
+.. code-block:: C
+
+    int usbd_ep_write_async(const uint8_t ep, const uint8_t *data, uint32_t data_len);
+
+- **ep** in 端点地址
+- **data** 要发送的数据缓冲区
+- **data_len** 发送长度，需要小于等于端点最大包长
+- **return** 返回 0 表示正确，其他表示错误
+
+usbd_ep_read_async
+""""""""""""""""""""""""""""""""""""
+
+``usbd_ep_read_async`` 启动某个端点接收，该函数配合 dma 使用，当 dma 完成时，会进入注册的 out 中断。如果硬件没有该功能，则无法使用。 **此函数对用户开放**。
+
+.. code-block:: C
+
+    int usbd_ep_read_async(const uint8_t ep, uint8_t *data, uint32_t max_data_len);
+
+- **ep** out 端点地址
+- **data** 要接收的数据缓冲区
+- **data_len** 接收长度，需要小于等于端点最大包长，推荐直接设置成最大包长。 **如果长度为 0 表示准备接收 0 包**
+- **return** 返回 0 表示正确，其他表示错误
+
+usbd_ep_get_read_len
+""""""""""""""""""""""""""""""""""""
+
+``usbd_ep_get_read_len`` 获取实际接收长度，此函数搭配 ``usbd_ep_read_async`` 使用。 **此函数对用户开放**。
+
+.. code-block:: C
+
+    uint32_t usbd_ep_get_read_len(const uint8_t ep);
+
+- **ep** out 端点地址
+- **return** 实际接收长度
+
+usbd_ep_is_complete
+""""""""""""""""""""""""""""""""""""
+
+``usbd_ep_is_complete`` 查询端点发送是否完成，搭配 ``usbd_ep_write_async`` 使用。 **此函数对用户开放**。
+
+.. code-block:: C
+
+    bool usbd_ep_is_complete(const uint8_t ep);
+
+- **ep** in 端点地址
+- **return** 返回 true 表示传输完成
+
+usbd_ep_get_mps
+""""""""""""""""""""""""""""""""""""
+
+``usbd_ep_get_mps`` 查询端点最大数据包长。 **此函数对用户开放**。
+
+.. code-block:: C
+
+    uint16_t usbd_ep_get_mps(const uint8_t ep);
+
+- **ep** 端点地址
+- **return** 返回端点最大数据包长
+
 host controller(hcd)
 ------------------------