summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorhathach <[email protected]>2025-11-15 19:46:14 +0700
committerhathach <[email protected]>2025-11-17 12:09:30 +0700
commit6b28a4478c9f8fa3993d593360eb5574bbdeda22 (patch)
tree5a3b2566184aa29c7e4d8d923392cdf689cbae45 /docs
parenta3a5a41be8e22f529a8941c107ec32d48faa6ff2 (diff)
make TUP_DCD_EDPT_ISO_ALLOC i.e dcd_edpt_iso_alloc()/dcd_edpt_iso_activate() as default driver implementation. dcd_edpt_close() is deprecated and will be removed from all driver in the future.
Diffstat (limited to 'docs')
-rw-r--r--docs/porting.rst10
1 files changed, 10 insertions, 0 deletions
diff --git a/docs/porting.rst b/docs/porting.rst
index c3076354c..9b60ec5a2 100644
--- a/docs/porting.rst
+++ b/docs/porting.rst
@@ -173,12 +173,22 @@ Also make sure to enable endpoint specific interrupts.
``dcd_edpt_close()``
""""""""""""""""""""
+.. warning::
+ This function is deprecated, ISO transfer should implement dcd_edpt_iso_alloc() and dcd_edpt_iso_activate() instead.
+
Close an endpoint. his function is used for implementing alternate settings.
After calling this, the device should not respond to any packets directed towards this endpoint. When called, this function must abort any transfers in progress through this endpoint, before returning.
Implementation is optional. Must be called from the USB task. Interrupts could be disabled or enabled during the call.
+``dcd_edpt_iso_alloc() / dcd_edpt_iso_activate()``
+""""""""""""""""""""""""""""""""""""""""""""""""""
+
+dcd_edpt_iso_alloc() is used to allocate largest buffer (for all alternative interfaces) for ISO endpoints when device is enumerated. This allows DCD to allocate necessary resources for ISO endpoints in the future.
+
+dcd_edpt_iso_activate() is used to activate or deactivate ISO endpoint when alternate setting is set with active max packet size.
+
``dcd_edpt_xfer()``
"""""""""""""""""""