Merge pull request #3653 from hathach/ch32_warning

add device specific issues

5 files changed, 194 insertions, 138 deletions

diff --git a/README.rst b/README.rst
index ea33a2a53..67149a4f2 100644
--- a/README.rst
+++ b/README.rst
@@ -174,144 +174,143 @@ 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                  | 512 USB RAM        |
-|              +-----------------------------+--------+------+-----------+------------------------+--------------------+
-|              | F415, F435_437, F423,       | ✔      | ✔    |           | dwc2                   |                    |
-|              | F425, F45x                  |        |      |           |                        |                    |
-|              +-----------------------------+--------+------+-----------+------------------------+--------------------+
-|              | F402_F405                   | ✔      | ✔    | ✔         | dwc2                   | F405 is HS         |
-+--------------+-----------------------------+--------+------+-----------+------------------------+--------------------+
-| Bridgetek    | FT90x                       | ✔      |      | ✔         | ft9xx                  | 1-dir ep           |
-+--------------+-----------------------------+--------+------+-----------+------------------------+--------------------+
-| Broadcom     | BCM2711, BCM2837            | ✔      |      | ✔         | dwc2                   |                    |
-+--------------+-----------------------------+--------+------+-----------+------------------------+--------------------+
-| Dialog       | DA1469x                     | ✔      | ✖    | ✖         | da146xx                |                    |
-+--------------+-----------------------------+--------+------+-----------+------------------------+--------------------+
-| Espressif    | S2, S3, H4                  | ✔      | ✔    | ✖         | dwc2                   |                    |
-| ESP32        +-----------------------------+--------+------+-----------+------------------------+--------------------+
-|              | P4                          | ✔      | ✔    | ✔         | dwc2                   |                    |
-|              +-----------------------------+--------+------+-----------+------------------------+--------------------+
-|              | S31                         | ✔      | ✔    | ✔         | dwc2                   |                    |
-+--------------+-----------------------------+--------+------+-----------+------------------------+--------------------+
-| GigaDevice   | GD32VF103                   | ✔      |      | ✖         | dwc2                   |                    |
-+--------------+-----------------------------+--------+------+-----------+------------------------+--------------------+
-| HPMicro      | HPM6750                     | ✔      | ✔    | ✔         | ci_hs, ehci            |                    |
-+--------------+-----------------------------+--------+------+-----------+------------------------+--------------------+
-| 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   | nRF52, nRF53                | ✔      | ✖    | ✖         | nrf5x                  | only ep8 is ISO    |
-|              +-----------------------------+--------+------+-----------+------------------------+--------------------+
-|              | nRF54                       | ✔      | ✖    | ✔         | dwc2                   |                    |
-+--------------+-----------------------------+--------+------+-----------+------------------------+--------------------+
-| Nuvoton      | NUC120                      | ✔      | ✖    | ✖         | nuc120                 |                    |
-|              +-----------------------------+--------+------+-----------+------------------------+--------------------+
-|              | NUC121/NUC125, 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                | ⚠      | ⚠    | ✔         | lpc_ip3511, lpc_ip3516 | NRND, read errata  |
-|              |         +-------------------+--------+------+-----------+------------------------+--------------------+
-|              |         | 55                | ✔      | ✔    | ✔         | lpc_ip3511, lpc_ip3516 |                    |
-|              +---------+-------------------+--------+------+-----------+------------------------+--------------------+
-|              | MCX     | N9                | ✔      |      | ✔         | ci_fs, ci_hs, ehci     |                    |
-|              |         +-------------------+--------+------+-----------+------------------------+--------------------+
-|              |         | A15               | ✔      |      |           | ci_fs                  |                    |
-|              +---------+-------------------+--------+------+-----------+------------------------+--------------------+
-|              | RW61x                       | ✔      | ✔    | ✔         | ci_hs, ehci            |                    |
-+--------------+-----------------------------+--------+------+-----------+------------------------+--------------------+
-| 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            | 512 USB RAM        |
-|              |    +------------------------+--------+------+-----------+------------------------+--------------------+
-|              |    | 105, 107               | ✔      | ✔    | ✖         | dwc2                   |                    |
-|              +----+------------------------+--------+------+-----------+------------------------+--------------------+
-|              | F2, F4, F7, H7, H7RS        | ✔      | ✔    | ✔         | dwc2                   |                    |
-|              +-----------------------------+--------+------+-----------+------------------------+--------------------+
-|              | C0, G0, H5, U3              | ✔      | ✔    | ✖         | stm32_fsdev            | 2KB USB RAM        |
-|              +-----------------------------+--------+------+-----------+------------------------+--------------------+
-|              | G4                          | ✔      | ✖    | ✖         | stm32_fsdev            | 1KB USB RAM        |
-|              +----+------------------------+--------+------+-----------+------------------------+--------------------+
-|              | L4 | 4x2, 4x3               | ✔      | ✖    | ✖         | stm32_fsdev            | 1KB USB RAM        |
-|              |    +------------------------+--------+------+-----------+------------------------+--------------------+
-|              |    | 4x5, 4x6, 4+           | ✔      | ✔    | ✖         | dwc2                   |                    |
-|              +----+------------------------+--------+------+-----------+------------------------+--------------------+
-|              | N6                          | ✔      | ✔    | ✔         | dwc2                   |                    |
-|              +-----------------------------+--------+------+-----------+------------------------+--------------------+
-|              | U0                          | ✔      | ✖    | ✖         | stm32_fsdev            | 1KB USB RAM        |
-|              +----+------------------------+--------+------+-----------+------------------------+--------------------+
-|              | U5 | 535, 545               | ✔      | ✔    | ✖         | stm32_fsdev            | 2KB USB RAM        |
-|              |    +------------------------+--------+------+-----------+------------------------+--------------------+
-|              |    | 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                  | 512 USB RAM                                                                             |
+|              +-----------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+|              | F415, F435_437, F423,       | ✔      | ✔    |           | dwc2                   |                                                                                         |
+|              | F425, F45x                  |        |      |           |                        |                                                                                         |
+|              +-----------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+|              | F402_F405                   | ✔      | ✔    | ✔         | dwc2                   | F405 is HS                                                                              |
++--------------+-----------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+| Bridgetek    | FT90x                       | ✔      |      | ✔         | ft9xx                  | 1-dir ep                                                                                |
++--------------+-----------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+| Broadcom     | BCM2711, BCM2837            | ✔      |      | ✔         | dwc2                   |                                                                                         |
++--------------+-----------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+| Dialog       | DA1469x                     | ✔      | ✖    | ✖         | da146xx                |                                                                                         |
++--------------+-----------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+| Espressif    | S2, S3, H4                  | ✔      | ✔    | ✖         | dwc2                   |                                                                                         |
+| ESP32        +-----------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+|              | P4                          | ✔      | ✔    | ✔         | dwc2                   |                                                                                         |
+|              +-----------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+|              | S31                         | ✔      | ✔    | ✔         | dwc2                   |                                                                                         |
++--------------+-----------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+| GigaDevice   | GD32VF103                   | ✔      |      | ✖         | dwc2                   |                                                                                         |
++--------------+-----------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+| HPMicro      | HPM6750                     | ✔      | ✔    | ✔         | ci_hs, ehci            |                                                                                         |
++--------------+-----------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+| 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   | nRF52, nRF53                | ✔      | ✖    | ✖         | nrf5x                  | only ep8 is ISO                                                                         |
+|              +-----------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+|              | nRF54                       | ✔      | ✖    | ✔         | dwc2                   |                                                                                         |
++--------------+-----------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+| Nuvoton      | NUC120                      | ✔      | ✖    | ✖         | nuc120                 |                                                                                         |
+|              +-----------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+|              | NUC121/NUC125, 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                | ⚠      | ⚠    | ✔         | lpc_ip3511, lpc_ip3516 | `NRND, see device issues <docs/reference/device_issues.rst#nxp-lpc54600>`_                    |
+|              |         +-------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+|              |         | 55                | ✔      | ✔    | ✔         | lpc_ip3511, lpc_ip3516 |                                                                                         |
+|              +---------+-------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+|              | MCX     | N9                | ✔      |      | ✔         | ci_fs, ci_hs, ehci     |                                                                                         |
+|              |         +-------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+|              |         | A15               | ✔      |      |           | ci_fs                  |                                                                                         |
+|              +---------+-------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+|              | RW61x                       | ✔      | ✔    | ✔         | ci_hs, ehci            |                                                                                         |
++--------------+-----------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+| 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            | 512 USB RAM                                                                             |
+|              |    +------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+|              |    | 105, 107               | ✔      | ✔    | ✖         | dwc2                   |                                                                                         |
+|              +----+------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+|              | F2, F4, F7, H7, H7RS        | ✔      | ✔    | ✔         | dwc2                   |                                                                                         |
+|              +-----------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+|              | C0, G0, H5, U3              | ✔      | ✔    | ✖         | stm32_fsdev            | 2KB USB RAM                                                                             |
+|              +-----------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+|              | G4                          | ✔      | ✖    | ✖         | stm32_fsdev            | 1KB USB RAM                                                                             |
+|              +----+------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+|              | L4 | 4x2, 4x3               | ✔      | ✖    | ✖         | stm32_fsdev            | 1KB USB RAM                                                                             |
+|              |    +------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+|              |    | 4x5, 4x6, 4+           | ✔      | ✔    | ✖         | dwc2                   |                                                                                         |
+|              +----+------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+|              | N6                          | ✔      | ✔    | ✔         | dwc2                   |                                                                                         |
+|              +-----------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+|              | U0                          | ✔      | ✖    | ✖         | stm32_fsdev            | 1KB USB RAM                                                                             |
+|              +----+------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+|              | U5 | 535, 545               | ✔      | ✔    | ✖         | stm32_fsdev            | 2KB USB RAM                                                                             |
+|              |    +------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+|              |    | 575, 585               | ✔      | ✔    | ✖         | dwc2                   |                                                                                         |
+|              |    +------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+|              |    | 59x,5Ax,5Fx,5Gx        | ✔      | ✔    | ✔         | dwc2                   |                                                                                         |
++--------------+----+------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+| TI           | MSP430                      | ✔      | ✖    | ✖         | msp430x5xx             |                                                                                         |
+|              +-----------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+|              | MSP432E4, TM4C123           | ✔      |      | ✖         | musb                   |                                                                                         |
++--------------+-----------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+| ValentyUSB   | eptri                       | ✔      | ✖    | ✖         | eptri                  |                                                                                         |
++--------------+-----------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+| WCH          | CH32F20x                    | ⚠      |      | ✔         | ch32_usbhs             | `ISO data loss <docs/reference/device_issues.rst#wch-ch32f20x-ch32v20x-ch32v30x>`_      |
+|              +-----------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+|              | CH32V20x                    | ⚠      |      | ✖         | stm32_fsdev/ch32_usbfs | `ISO data loss <docs/reference/device_issues.rst#wch-ch32f20x-ch32v20x-ch32v30x>`_      |
+|              +-----------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
+|              | CH32V305, CH32V307          | ⚠      |      | ✔         | ch32_usbfs/hs          | `ISO data loss <docs/reference/device_issues.rst#wch-ch32f20x-ch32v20x-ch32v30x>`_      |
++--------------+-----------------------------+--------+------+-----------+------------------------+-----------------------------------------------------------------------------------------+
 
 Table Legend
 ^^^^^^^^^^^^
diff --git a/docs/conf.py b/docs/conf.py
index 9e9784fb7..86ddcf672 100755
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -53,6 +53,25 @@ def preprocess_readme():
     tgt = Path(__file__).parent.parent / "README_processed.rst"
     if src.exists():
         content = src.read_text(encoding='utf-8')
+        # if the matching is inside a table, keep the table cell width by adding the same number of spaces in the end of the line
+        # match pattern: | ... `... <docs/...>`_ ... |
+        # change into:   | ... `... <...>`_ ...      |
+        def _rewrite_table_line(line):
+            if not (line.startswith('|') and line.rstrip().endswith('|')):
+                return line
+
+            rewritten = re.sub(r"<docs/([^>]+)>", r"<\1>", line)
+            delta = len(line) - len(rewritten) - 1  # -1 for rst->html
+
+            if delta > 0:
+                last_pipe = rewritten.rfind('|')
+                if last_pipe >= 0:
+                    rewritten = rewritten[:last_pipe] + (' ' * delta) + rewritten[last_pipe:]
+
+            return rewritten
+
+        content = ''.join(_rewrite_table_line(line) for line in content.splitlines(keepends=True))
+
         content = re.sub(r"docs/", r"", content)
         content = re.sub(r"\.rst\b", r".html", content)
         if not content.endswith("\n"):
diff --git a/docs/reference/device_issues.rst b/docs/reference/device_issues.rst
new file mode 100644
index 000000000..ae9cd55f1
--- /dev/null
+++ b/docs/reference/device_issues.rst
@@ -0,0 +1,35 @@
+Device specific known issues and workarounds
+===============================================
+This page lists known issues and workarounds for specific devices.
+
+NXP LPC54600
+----------------
+**Severity: High**
+
+**Not recommended for USB device applications (except high-speed host controller)**
+
+Reference: `LPC54600 Errata Sheet`_
+
+.. _LPC54600 Errata Sheet: https://www.nxp.com/docs/en/errata/ES_LPC546XX.pdf
+
+The LPC54600 series have a very buggy USB controller, with 17 issues listed in the errata which is more than half of the total issues.
+
+Most severe issues are:
+
+- USB.2: In USB high-speed device mode, the NBytes field is not correct after BULK IN transfer
+- USB.5: In USB full-speed host mode, linked list on done queue is broken.
+- USB.15: USB high-speed device in endpoint TX data corruption
+
+WCH CH32F20x/CH32V20x/CH32V30x
+---------------------------------
+**Severity: Medium**
+
+**Not recommended for USB audio applications**
+
+Reference: `CH32V30X Reference Manual`_ USBFS/USBHS controller chapter
+
+.. _CH32V30X Reference Manual: https://www.wch-ic.com/downloads/CH32FV2x_V3xRM_PDF.html
+
+Data corruption may occur on isochronous endpoints. Due to the lacking of FIFO for interrupt status registers, later completed transfer will overwrite `INT_ST` and `RX_LEN` register if previous transfer processing is not completed.
+
+Other types of transfers are not affected.
diff --git a/docs/reference/index.rst b/docs/reference/index.rst
index 148e8a63b..c66ce618f 100644
--- a/docs/reference/index.rst
+++ b/docs/reference/index.rst
@@ -13,4 +13,5 @@ Complete reference documentation for TinyUSB APIs, configuration, and supported
    boards
    dependencies
    concurrency
+   device_issues
    glossary
diff --git a/docs/troubleshooting.rst b/docs/troubleshooting.rst
index bb9f15166..613c7fcef 100644
--- a/docs/troubleshooting.rst
+++ b/docs/troubleshooting.rst
@@ -76,6 +76,8 @@ Invalid board name in build command.
 Runtime Issues
 ==============
 
+Check :doc:`reference/device_issues` for known hardware-specific issues that may affect USB functionality on your device.
+
 Device Mode Problems
 --------------------