diff --git a/drivers/include/periph/usbdev.h b/drivers/include/periph/usbdev.h index 79bc348d63..1845b5e69a 100644 --- a/drivers/include/periph/usbdev.h +++ b/drivers/include/periph/usbdev.h @@ -188,6 +188,10 @@ typedef enum { /** * @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. */ USBDEV_EVENT_TR_FAIL, diff --git a/sys/include/usb/usbus.h b/sys/include/usb/usbus.h index b4e43f0e3e..7f2551deb4 100644 --- a/sys/include/usb/usbus.h +++ b/sys/include/usb/usbus.h @@ -121,7 +121,15 @@ extern "C" { #define USBUS_HANDLER_FLAG_SOF (0x0002) /**< Report SOF events */ #define USBUS_HANDLER_FLAG_SUSPEND (0x0004) /**< Report suspend events */ #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 */ /** @} */