riot-ci/RIOT
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Merge pull request #17046 from bergzand/pr/usb/deprecate_fail_report

Browse Source 
usbdev/USBUS: deprecate transfer failure reporting report
This commit is contained in:
benpicco 2021-10-25 16:27:01 +02:00 committed by GitHub
commit 2aab2b83bc
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 13 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
drivers/include/periph/usbdev.h
View File

@ -188,6 +188,10 @@ typedef enum {
/** /**
* @brief Transaction fail event. * @brief Transaction fail event.
* *
* @deprecated This event is deprecated as only a limited number of devices
* implement and doesn't offer value for upper layer code. This
* event will be removed after the 2022.07 release.
*
* An endpoint should emit this event after a nack reply to the host. * An endpoint should emit this event after a nack reply to the host.
*/ */
USBDEV_EVENT_TR_FAIL, USBDEV_EVENT_TR_FAIL,

10
sys/include/usb/usbus.h
View File

@ -121,7 +121,15 @@ extern "C" {
#define USBUS_HANDLER_FLAG_SOF (0x0002) /**< Report SOF events */ #define USBUS_HANDLER_FLAG_SOF (0x0002) /**< Report SOF events */
#define USBUS_HANDLER_FLAG_SUSPEND (0x0004) /**< Report suspend events */ #define USBUS_HANDLER_FLAG_SUSPEND (0x0004) /**< Report suspend events */
#define USBUS_HANDLER_FLAG_RESUME (0x0008) /**< Report resume from suspend */ #define USBUS_HANDLER_FLAG_RESUME (0x0008) /**< Report resume from suspend */
#define USBUS_HANDLER_FLAG_TR_FAIL (0x0010) /**< Report transfer fail */
/**
* @brief Report transfer fail
*
* @deprecated This event is deprecated as only a limited number of low level
* devices report this and it doesn't offer value for upper layer
* code. This flag will be removed after the 2022.07 release
*/
#define USBUS_HANDLER_FLAG_TR_FAIL (0x0010)
#define USBUS_HANDLER_FLAG_TR_STALL (0x0020) /**< Report transfer stall complete */ #define USBUS_HANDLER_FLAG_TR_STALL (0x0020) /**< Report transfer stall complete */
/** @} */ /** @} */