Update note

Signed-off-by: HiFiPhile <[email protected]>

3 files changed, 136 insertions, 132 deletions

diff --git a/README.rst b/README.rst
index ef19b0ccd..75f93f656 100644
--- a/README.rst
+++ b/README.rst
@@ -129,138 +129,138 @@ TinyUSB is completely thread-safe by pushing all Interrupt Service Request (ISR)
 Supported CPUs
 --------------
 
-+--------------+-----------------------------+--------+------+-----------+------------------------+-------------------+
-| Manufacturer | Family                      | Device | Host | Highspeed | Driver                 | Note              |
-+==============+=============================+========+======+===========+========================+===================+
-| Allwinner    | F1C100s/F1C200s             | ✔      |      | ✔         | sunxi                  | musb variant      |
-+--------------+-----------------------------+--------+------+-----------+------------------------+-------------------+
-| Analog       | MAX3421E                    |        | ✔    | ✖         | max3421                | via SPI           |
-|              +-----------------------------+--------+------+-----------+------------------------+-------------------+
-|              | MAX32 650, 666, 690,        | ✔      |      | ✔         | musb                   | 1-dir ep          |
-|              | MAX78002                    |        |      |           |                        |                   |
-+--------------+-----------------------------+--------+------+-----------+------------------------+-------------------+
-| Artery AT32  | F403a_407, F413             | ✔      |      |           | fsdev                  |                   |
-|              +-----------------------------+--------+------+-----------+------------------------+-------------------+
-|              | F415, F435_437, F423, F425  | ✔      | ✔    |           | dwc2                   |                   |
-|              +-----------------------------+--------+------+-----------+------------------------+-------------------+
-|              | F402_F405                   | ✔      | ✔    | ✔         | dwc2                   | F405 is HS        |
-+--------------+-----------------------------+--------+------+-----------+------------------------+-------------------+
-| Bridgetek    | FT90x                       | ✔      |      | ✔         | ft9xx                  | 1-dir ep          |
-+--------------+-----------------------------+--------+------+-----------+------------------------+-------------------+
-| Broadcom     | BCM2711, BCM2837            | ✔      |      | ✔         | dwc2                   |                   |
-+--------------+-----------------------------+--------+------+-----------+------------------------+-------------------+
-| Dialog       | DA1469x                     | ✔      | ✖    | ✖         | da146xx                |                   |
-+--------------+-----------------------------+--------+------+-----------+------------------------+-------------------+
-| Espressif    | S2, S3                      | ✔      | ✔    | ✖         | dwc2                   |                   |
-| ESP32        +-----------------------------+--------+------+-----------+------------------------+-------------------+
-|              | P4                          | ✔      | ✔    | ✔         | dwc2                   |                   |
-|              +-----------------------------+--------+------+-----------+------------------------+-------------------+
-|              | H4                          | ✔      | ✔    | ✖         | dwc2                   |                   |
-+--------------+-----------------------------+--------+------+-----------+------------------------+-------------------+
-| GigaDevice   | GD32VF103                   | ✔      |      | ✖         | dwc2                   |                   |
-+--------------+-----------------------------+--------+------+-----------+------------------------+-------------------+
-| Infineon     | XMC4500                     | ✔      | ✔    | ✖         | dwc2                   |                   |
-+--------------+-----+-----------------------+--------+------+-----------+------------------------+-------------------+
-| MicroChip    | SAM | D11, D21, L21, L22    | ✔      |      | ✖         | samd                   |                   |
-|              |     +-----------------------+--------+------+-----------+------------------------+-------------------+
-|              |     | D51, E5x              | ✔      |      | ✖         | samd                   |                   |
-|              |     +-----------------------+--------+------+-----------+------------------------+-------------------+
-|              |     | G55                   | ✔      |      | ✖         | samg                   | 1-dir ep          |
-|              |     +-----------------------+--------+------+-----------+------------------------+-------------------+
-|              |     | E70,S70,V70,V71       | ✔      |      | ✔         | samx7x                 | 1-dir ep          |
-|              +-----+-----------------------+--------+------+-----------+------------------------+-------------------+
-|              | PIC | 24                    | ✔      |      |           | pic                    | ci_fs variant     |
-|              |     +-----------------------+--------+------+-----------+------------------------+-------------------+
-|              |     | 32 mm, mk, mx         | ✔      |      |           | pic                    | ci_fs variant     |
-|              |     +-----------------------+--------+------+-----------+------------------------+-------------------+
-|              |     | dsPIC33               | ✔      |      |           | pic                    | ci_fs variant     |
-|              |     +-----------------------+--------+------+-----------+------------------------+-------------------+
-|              |     | 32mz                  | ✔      |      |           | pic32mz                | musb variant      |
-+--------------+-----+-----------------------+--------+------+-----------+------------------------+-------------------+
-| MindMotion   | mm32                        | ✔      |      | ✖         | mm32f327x_otg          | ci_fs variant     |
-+--------------+-----+-----------------------+--------+------+-----------+------------------------+-------------------+
-| NordicSemi   | nRF 52833, 52840, 5340      | ✔      | ✖    | ✖         | nrf5x                  | only ep8 is ISO   |
-+--------------+-----------------------------+--------+------+-----------+------------------------+-------------------+
-| Nuvoton      | NUC120                      | ✔      | ✖    | ✖         | nuc120                 |                   |
-|              +-----------------------------+--------+------+-----------+------------------------+-------------------+
-|              | NUC121/NUC125               | ✔      | ✖    | ✖         | nuc121                 |                   |
-|              +-----------------------------+--------+------+-----------+------------------------+-------------------+
-|              | NUC126                      | ✔      | ✖    | ✖         | nuc121                 |                   |
-|              +-----------------------------+--------+------+-----------+------------------------+-------------------+
-|              | NUC505                      | ✔      |      | ✔         | nuc505                 |                   |
-+--------------+---------+-------------------+--------+------+-----------+------------------------+-------------------+
-| NXP          | iMXRT   | RT 10xx, 11xx     | ✔      | ✔    | ✔         | ci_hs, ehci            |                   |
-|              +---------+-------------------+--------+------+-----------+------------------------+-------------------+
-|              | Kinetis | KL                | ✔      | ⚠    | ✖         | ci_fs, khci            |                   |
-|              |         +-------------------+--------+------+-----------+------------------------+-------------------+
-|              |         | K32L2             | ✔      |      | ✖         | khci                   | ci_fs variant     |
-|              +---------+-------------------+--------+------+-----------+------------------------+-------------------+
-|              | LPC     | 11u, 13, 15       | ✔      | ✖    | ✖         | lpc_ip3511             |                   |
-|              |         +-------------------+--------+------+-----------+------------------------+-------------------+
-|              |         | 17, 40            | ✔      | ⚠    | ✖         | lpc17_40, ohci         |                   |
-|              |         +-------------------+--------+------+-----------+------------------------+-------------------+
-|              |         | 18, 43            | ✔      | ✔    | ✔         | ci_hs, ehci            |                   |
-|              |         +-------------------+--------+------+-----------+------------------------+-------------------+
-|              |         | 51u               | ✔      | ✖    | ✖         | lpc_ip3511             |                   |
-|              |         +-------------------+--------+------+-----------+------------------------+-------------------+
-|              |         | 54, 55            | ✔      |      | ✔         | lpc_ip3511             |                   |
-|              +---------+-------------------+--------+------+-----------+------------------------+-------------------+
-|              | MCX     | N9                | ✔      |      | ✔         | ci_fs, ci_hs, ehci     |                   |
-|              |         +-------------------+--------+------+-----------+------------------------+-------------------+
-|              |         | A15               | ✔      |      |           | ci_fs                  |                   |
-+--------------+---------+-------------------+--------+------+-----------+------------------------+-------------------+
-| Raspberry Pi | RP2040, RP2350              | ✔      | ✔    | ✖         | rp2040, pio_usb        |                   |
-+--------------+-----+-----------------------+--------+------+-----------+------------------------+-------------------+
-| Renesas      | RX  | 63N, 65N, 72N         | ✔      | ✔    | ✖         | rusb2                  |                   |
-|              +-----+-----------------------+--------+------+-----------+------------------------+-------------------+
-|              | RA  | 4M1, 4M3, 6M1         | ✔      | ✔    | ✖         | rusb2                  |                   |
-|              |     +-----------------------+--------+------+-----------+------------------------+-------------------+
-|              |     | 6M5                   | ✔      | ✔    | ✔         | rusb2                  |                   |
-+--------------+-----+-----------------------+--------+------+-----------+------------------------+-------------------+
-| Silabs       | EFM32GG12                   | ✔      |      | ✖         | dwc2                   |                   |
-+--------------+-----------------------------+--------+------+-----------+------------------------+-------------------+
-| Sony         | CXD56                       | ✔      | ✖    | ✔         | cxd56                  |                   |
-+--------------+-----------------------------+--------+------+-----------+------------------------+-------------------+
-| ST STM32     | F0, F3, L0, L1, L5, WBx5    | ✔      | ✖    | ✖         | stm32_fsdev            |                   |
-|              +----+------------------------+--------+------+-----------+------------------------+-------------------+
-|              | F1 | 102, 103               | ✔      | ✖    | ✖         | stm32_fsdev            |                   |
-|              |    +------------------------+--------+------+-----------+------------------------+-------------------+
-|              |    | 105, 107               | ✔      | ✔    | ✖         | dwc2                   |                   |
-|              +----+------------------------+--------+------+-----------+------------------------+-------------------+
-|              | F2, F4, F7, H7, H7RS        | ✔      | ✔    | ✔         | dwc2                   |                   |
-|              +-----------------------------+--------+------+-----------+------------------------+-------------------+
-|              | C0, G0, H5                  | ✔      | ✔    | ✖         | stm32_fsdev            | Host tested on C0 |
-|              +-----------------------------+--------+------+-----------+------------------------+-------------------+
-|              | G4                          | ✔      | ✖    | ✖         | stm32_fsdev            |                   |
-|              +----+------------------------+--------+------+-----------+------------------------+-------------------+
-|              | L4 | 4x2, 4x3               | ✔      | ✖    | ✖         | stm32_fsdev            |                   |
-|              |    +------------------------+--------+------+-----------+------------------------+-------------------+
-|              |    | 4x5, 4x6, 4+           | ✔      | ✔    | ✖         | dwc2                   |                   |
-|              +----+------------------------+--------+------+-----------+------------------------+-------------------+
-|              | N6                          | ✔      | ✔    | ✔         | dwc2                   |                   |
-|              +----+------------------------+--------+------+-----------+------------------------+-------------------+
-|              | U0                          | ✔      | ✖    | ✖         | stm32_fsdev            |                   |
-|              +----+------------------------+--------+------+-----------+------------------------+-------------------+
-|              | U3                          | ✔      | ✔    | ✖         | stm32_fsdev            | Host tested on C0 |
-|              +----+------------------------+--------+------+-----------+------------------------+-------------------+
-|              | U5 | 535, 545               | ✔      | ✔    | ✖         | stm32_fsdev            | Host tested on C0 |
-|              |    +------------------------+--------+------+-----------+------------------------+-------------------+
-|              |    | 575, 585               | ✔      | ✔    | ✖         | dwc2                   |                   |
-|              |    +------------------------+--------+------+-----------+------------------------+-------------------+
-|              |    | 59x,5Ax,5Fx,5Gx        | ✔      | ✔    | ✔         | dwc2                   |                   |
-+--------------+----+------------------------+--------+------+-----------+------------------------+-------------------+
-| TI           | MSP430                      | ✔      | ✖    | ✖         | msp430x5xx             |                   |
-|              +-----------------------------+--------+------+-----------+------------------------+-------------------+
-|              | MSP432E4, TM4C123           | ✔      |      | ✖         | musb                   |                   |
-+--------------+-----------------------------+--------+------+-----------+------------------------+-------------------+
-| ValentyUSB   | eptri                       | ✔      | ✖    | ✖         | eptri                  |                   |
-+--------------+-----------------------------+--------+------+-----------+------------------------+-------------------+
-| WCH          | CH32F20x                    | ✔      |      | ✔         | ch32_usbhs             |                   |
-|              +-----------------------------+--------+------+-----------+------------------------+-------------------+
-|              | CH32V20x                    | ✔      |      | ✖         | stm32_fsdev/ch32_usbfs |                   |
-|              +-----------------------------+--------+------+-----------+------------------------+-------------------+
-|              | CH32V305, CH32V307          | ✔      |      | ✔         | ch32_usbfs/hs          |                   |
-+--------------+-----------------------------+--------+------+-----------+------------------------+-------------------+
++--------------+-----------------------------+--------+------+-----------+------------------------+------------------------+
+| Manufacturer | Family                      | Device | Host | Highspeed | Driver                 | Note                   |
++==============+=============================+========+======+===========+========================+========================+
+| Allwinner    | F1C100s/F1C200s             | ✔      |      | ✔         | sunxi                  | musb variant           |
++--------------+-----------------------------+--------+------+-----------+------------------------+------------------------+
+| Analog       | MAX3421E                    |        | ✔    | ✖         | max3421                | via SPI                |
+|              +-----------------------------+--------+------+-----------+------------------------+------------------------+
+|              | MAX32 650, 666, 690,        | ✔      |      | ✔         | musb                   | 1-dir ep               |
+|              | MAX78002                    |        |      |           |                        |                        |
++--------------+-----------------------------+--------+------+-----------+------------------------+------------------------+
+| Artery AT32  | F403a_407, F413             | ✔      |      |           | fsdev                  |                        |
+|              +-----------------------------+--------+------+-----------+------------------------+------------------------+
+|              | F415, F435_437, F423, F425  | ✔      | ✔    |           | dwc2                   |                        |
+|              +-----------------------------+--------+------+-----------+------------------------+------------------------+
+|              | F402_F405                   | ✔      | ✔    | ✔         | dwc2                   | F405 is HS             |
++--------------+-----------------------------+--------+------+-----------+------------------------+------------------------+
+| Bridgetek    | FT90x                       | ✔      |      | ✔         | ft9xx                  | 1-dir ep               |
++--------------+-----------------------------+--------+------+-----------+------------------------+------------------------+
+| Broadcom     | BCM2711, BCM2837            | ✔      |      | ✔         | dwc2                   |                        |
++--------------+-----------------------------+--------+------+-----------+------------------------+------------------------+
+| Dialog       | DA1469x                     | ✔      | ✖    | ✖         | da146xx                |                        |
++--------------+-----------------------------+--------+------+-----------+------------------------+------------------------+
+| Espressif    | S2, S3                      | ✔      | ✔    | ✖         | dwc2                   |                        |
+| ESP32        +-----------------------------+--------+------+-----------+------------------------+------------------------+
+|              | P4                          | ✔      | ✔    | ✔         | dwc2                   |                        |
+|              +-----------------------------+--------+------+-----------+------------------------+------------------------+
+|              | H4                          | ✔      | ✔    | ✖         | dwc2                   |                        |
++--------------+-----------------------------+--------+------+-----------+------------------------+------------------------+
+| GigaDevice   | GD32VF103                   | ✔      |      | ✖         | dwc2                   |                        |
++--------------+-----------------------------+--------+------+-----------+------------------------+------------------------+
+| Infineon     | XMC4500                     | ✔      | ✔    | ✖         | dwc2                   |                        |
++--------------+-----+-----------------------+--------+------+-----------+------------------------+------------------------+
+| MicroChip    | SAM | D11, D21, L21, L22    | ✔      |      | ✖         | samd                   |                        |
+|              |     +-----------------------+--------+------+-----------+------------------------+------------------------+
+|              |     | D51, E5x              | ✔      |      | ✖         | samd                   |                        |
+|              |     +-----------------------+--------+------+-----------+------------------------+------------------------+
+|              |     | G55                   | ✔      |      | ✖         | samg                   | 1-dir ep               |
+|              |     +-----------------------+--------+------+-----------+------------------------+------------------------+
+|              |     | E70,S70,V70,V71       | ✔      |      | ✔         | samx7x                 | 1-dir ep               |
+|              +-----+-----------------------+--------+------+-----------+------------------------+------------------------+
+|              | PIC | 24                    | ✔      |      |           | pic                    | ci_fs variant          |
+|              |     +-----------------------+--------+------+-----------+------------------------+------------------------+
+|              |     | 32 mm, mk, mx         | ✔      |      |           | pic                    | ci_fs variant          |
+|              |     +-----------------------+--------+------+-----------+------------------------+------------------------+
+|              |     | dsPIC33               | ✔      |      |           | pic                    | ci_fs variant          |
+|              |     +-----------------------+--------+------+-----------+------------------------+------------------------+
+|              |     | 32mz                  | ✔      |      |           | pic32mz                | musb variant           |
++--------------+-----+-----------------------+--------+------+-----------+------------------------+------------------------+
+| MindMotion   | mm32                        | ✔      |      | ✖         | mm32f327x_otg          | ci_fs variant          |
++--------------+-----+-----------------------+--------+------+-----------+------------------------+------------------------+
+| NordicSemi   | nRF 52833, 52840, 5340      | ✔      | ✖    | ✖         | nrf5x                  | only ep8 is IO         |
++--------------+-----------------------------+--------+------+-----------+------------------------+------------------------+
+| Nuvoton      | NUC120                      | ✔      | ✖    | ✖         | nuc120                 |                        |
+|              +-----------------------------+--------+------+-----------+------------------------+------------------------+
+|              | NUC121/NUC125               | ✔      | ✖    | ✖         | nuc121                 |                        |
+|              +-----------------------------+--------+------+-----------+------------------------+------------------------+
+|              | NUC126                      | ✔      | ✖    | ✖         | nuc121                 |                        |
+|              +-----------------------------+--------+------+-----------+------------------------+------------------------+
+|              | NUC505                      | ✔      |      | ✔         | nuc505                 |                        |
++--------------+---------+-------------------+--------+------+-----------+------------------------+------------------------+
+| NXP          | iMXRT   | RT 10xx, 11xx     | ✔      | ✔    | ✔         | ci_hs, ehci            |                        |
+|              +---------+-------------------+--------+------+-----------+------------------------+------------------------+
+|              | Kinetis | KL                | ✔      | ⚠    | ✖         | ci_fs, khci            |                        |
+|              |         +-------------------+--------+------+-----------+------------------------+------------------------+
+|              |         | K32L2             | ✔      |      | ✖         | khci                   | ci_fs variant          |
+|              +---------+-------------------+--------+------+-----------+------------------------+------------------------+
+|              | LPC     | 11u, 13, 15       | ✔      | ✖    | ✖         | lpc_ip3511             |                        |
+|              |         +-------------------+--------+------+-----------+------------------------+------------------------+
+|              |         | 17, 40            | ✔      | ⚠    | ✖         | lpc17_40, ohci         |                        |
+|              |         +-------------------+--------+------+-----------+------------------------+------------------------+
+|              |         | 18, 43            | ✔      | ✔    | ✔         | ci_hs, ehci            |                        |
+|              |         +-------------------+--------+------+-----------+------------------------+------------------------+
+|              |         | 51u               | ✔      | ✖    | ✖         | lpc_ip3511             |                        |
+|              |         +-------------------+--------+------+-----------+------------------------+------------------------+
+|              |         | 54, 55            | ✔      |      | ✔         | lpc_ip3511             |                        |
+|              +---------+-------------------+--------+------+-----------+------------------------+------------------------+
+|              | MCX     | N9                | ✔      |      | ✔         | ci_fs, ci_hs, ehci     |                        |
+|              |         +-------------------+--------+------+-----------+------------------------+------------------------+
+|              |         | A15               | ✔      |      |           | ci_fs                  |                        |
++--------------+---------+-------------------+--------+------+-----------+------------------------+------------------------+
+| Raspberry Pi | RP2040, RP2350              | ✔      | ✔    | ✖         | rp2040, pio_usb        |                        |
++--------------+-----+-----------------------+--------+------+-----------+------------------------+------------------------+
+| Renesas      | RX  | 63N, 65N, 72N         | ✔      | ✔    | ✖         | rusb2                  |                        |
+|              +-----+-----------------------+--------+------+-----------+------------------------+------------------------+
+|              | RA  | 4M1, 4M3, 6M1         | ✔      | ✔    | ✖         | rusb2                  |                        |
+|              |     +-----------------------+--------+------+-----------+------------------------+------------------------+
+|              |     | 6M5                   | ✔      | ✔    | ✔         | rusb2                  |                        |
++--------------+-----+-----------------------+--------+------+-----------+------------------------+------------------------+
+| Silabs       | EFM32GG12                   | ✔      |      | ✖         | dwc2                   |                        |
++--------------+-----------------------------+--------+------+-----------+------------------------+------------------------+
+| Sony         | CXD56                       | ✔      | ✖    | ✔         | cxd56                  |                        |
++--------------+-----------------------------+--------+------+-----------+------------------------+------------------------+
+| ST STM32     | F0, F3, L0, L1, L5, WBx5    | ✔      | ✖    | ✖         | stm32_fsdev            |                        |
+|              +----+------------------------+--------+------+-----------+------------------------+------------------------+
+|              | F1 | 102, 103               | ✔      | ✖    | ✖         | stm32_fsdev            |                        |
+|              |    +------------------------+--------+------+-----------+------------------------+------------------------+
+|              |    | 105, 107               | ✔      | ✔    | ✖         | dwc2                   |                        |
+|              +----+------------------------+--------+------+-----------+------------------------+------------------------+
+|              | F2, F4, F7, H7, H7RS        | ✔      | ✔    | ✔         | dwc2                   |                        |
+|              +-----------------------------+--------+------+-----------+------------------------+------------------------+
+|              | C0, G0, H5                  | ✔      | ✔    | ✖         | stm32_fsdev            | Host tested on C0, H5  |
+|              +-----------------------------+--------+------+-----------+------------------------+------------------------+
+|              | G4                          | ✔      | ✖    | ✖         | stm32_fsdev            |                        |
+|              +----+------------------------+--------+------+-----------+------------------------+------------------------+
+|              | L4 | 4x2, 4x3               | ✔      | ✖    | ✖         | stm32_fsdev            |                        |
+|              |    +------------------------+--------+------+-----------+------------------------+------------------------+
+|              |    | 4x5, 4x6, 4+           | ✔      | ✔    | ✖         | dwc2                   |                        |
+|              +----+------------------------+--------+------+-----------+------------------------+------------------------+
+|              | N6                          | ✔      | ✔    | ✔         | dwc2                   |                        |
+|              +----+------------------------+--------+------+-----------+------------------------+------------------------+
+|              | U0                          | ✔      | ✖    | ✖         | stm32_fsdev            |                        |
+|              +----+------------------------+--------+------+-----------+------------------------+------------------------+
+|              | U3                          | ✔      | ✔    | ✖         | stm32_fsdev            | Host tested on C0, H5  |
+|              +----+------------------------+--------+------+-----------+------------------------+------------------------+
+|              | U5 | 535, 545               | ✔      | ✔    | ✖         | stm32_fsdev            | Host tested on C0, H5  |
+|              |    +------------------------+--------+------+-----------+------------------------+------------------------+
+|              |    | 575, 585               | ✔      | ✔    | ✖         | dwc2                   |                        |
+|              |    +------------------------+--------+------+-----------+------------------------+------------------------+
+|              |    | 59x,5Ax,5Fx,5Gx        | ✔      | ✔    | ✔         | dwc2                   |                        |
++--------------+----+------------------------+--------+------+-----------+------------------------+------------------------+
+| TI           | MSP430                      | ✔      | ✖    | ✖         | msp430x5xx             |                        |
+|              +-----------------------------+--------+------+-----------+------------------------+------------------------+
+|              | MSP432E4, TM4C123           | ✔      |      | ✖         | musb                   |                        |
++--------------+-----------------------------+--------+------+-----------+------------------------+------------------------+
+| ValentyUSB   | eptri                       | ✔      | ✖    | ✖         | eptri                  |                        |
++--------------+-----------------------------+--------+------+-----------+------------------------+------------------------+
+| WCH          | CH32F20x                    | ✔      |      | ✔         | ch32_usbhs             |                        |
+|              +-----------------------------+--------+------+-----------+------------------------+------------------------+
+|              | CH32V20x                    | ✔      |      | ✖         | stm32_fsdev/ch32_usbfs |                        |
+|              +-----------------------------+--------+------+-----------+------------------------+------------------------+
+|              | CH32V305, CH32V307          | ✔      |      | ✔         | ch32_usbfs/hs          |                        |
++--------------+-----------------------------+--------+------+-----------+------------------------+------------------------+
 
 Table Legend
 ^^^^^^^^^^^^
diff --git a/src/device/usbd.h b/src/device/usbd.h
index c446638c3..3cf195452 100644
--- a/src/device/usbd.h
+++ b/src/device/usbd.h
@@ -38,6 +38,7 @@ extern "C" {
 //--------------------------------------------------------------------+
 
 // New API to replace tud_init() to init device stack on specific roothub port
+// Must be called in the same task/context as tud_task() if RTOS is used
 bool tud_rhport_init(uint8_t rhport, const tusb_rhport_init_t* rh_init);
 
 // Init device stack on roothub port
@@ -53,6 +54,7 @@ TU_ATTR_ALWAYS_INLINE static inline bool tud_init (uint8_t rhport) {
 }
 
 // Deinit device stack on roothub port
+// Must be called in the same task/context as tud_task() if RTOS is used
 bool tud_deinit(uint8_t rhport);
 
 // Check if device stack is already initialized
diff --git a/src/host/usbh.h b/src/host/usbh.h
index 697c911ff..d86efbcb2 100644
--- a/src/host/usbh.h
+++ b/src/host/usbh.h
@@ -150,6 +150,7 @@ void tuh_event_hook_cb(uint8_t rhport, uint32_t eventid, bool in_isr);
 bool tuh_configure(uint8_t rhport, uint32_t cfg_id, const void* cfg_param);
 
 // New API to replace tuh_init() to init host stack on specific roothub port
+// Must be called in the same task/context as tuh_task() if RTOS is used
 bool tuh_rhport_init(uint8_t rhport, const tusb_rhport_init_t* rh_init);
 
 // Init host stack
@@ -165,6 +166,7 @@ TU_ATTR_ALWAYS_INLINE static inline bool tuh_init(uint8_t rhport) {
 }
 
 // Deinit host stack on rhport
+// Must be called in the same task/context as tuh_task() if RTOS is used
 bool tuh_deinit(uint8_t rhport);
 
 // Check if host stack is already initialized with any roothub ports