feat(usb): add STM32C5 HAL v2 USB device support

[cumin777]

Summary

This PR adds STM32C5 HAL v2 USB device support to the shared USBDevice library.

This PR implements the following features:

• HAL v2 USB device low-level adapter for STM32C5
• CDC endpoint and PMA configuration for the C5 USB DRD FS peripheral
• CDC transmit handling compatible with HAL v2 endpoint fields
• Optional CDC line-coding callback for board-specific actions such as 1200-bps touch
• HAL-level USB re-enumeration using HAL_PCD_DeviceDisconnect() and the matching HAL_PCD_Start() attach path

Motivation

The Seeed XIAO STM32C5 uses the STM32C5 HAL v2 USB device peripheral. The shared USBDevice library currently has no HAL v2 low-level adapter, so the board cannot provide USB CDC through the normal Arduino core path.

This change is intentionally separated from the XIAO board definition so the common USB implementation can be reviewed independently. The initial split first used a direct PA_12 GPIO detach in usbd_if.c; after checking the STM32C5 HAL, this was replaced with the HAL PCD device-connect API. The common re-enumeration helper no longer contains a C5-specific pin reference.

Validation

USB CDC enumeration, serial communication and sustained CDC transfers were validated on Seeed XIAO STM32C5. The C5 CDC PMA endpoints are configured as non-overlapping single-buffer areas.

Code formatting

• Ensure AStyle check is passed thanks CI

Closing issues

N/A

[cumin777]

Follow-up: after checking the STM32C5 HAL source, I replaced the temporary direct PA_12 GPIO detach with HAL_PCD_DeviceDisconnect() after PCD initialization. HAL_PCD_Start() performs the matching attach when USB is ready. The common usbd_if.c no longer contains a C5-specific pin reference.

[cumin777]

Follow-up split PRs are now open for the remaining shared pieces: #3060 contains the HAL v2 UART helper compatibility fix, and #3061 contains the generic UF2 upload recipe. The UF2 recipe invokes the uf2upload executable from Arduino_Tools #122; end-to-end C5 1200-bps upload requires both #3061 and this USB PR (#3059), while #3060 is independent of USB and Tools.

[fpistm]

Hi @cumin777
I try to test this PR but by default it does not build when USB is enabled.

I've fixed the build issue but could not get USB working yet.

[cumin777]

@fpistm Apologies — the revision you tested (50a4eea) was missing follow-up fixes that existed only on our local integration branch and had not been synced to this PR. They are pushed now:

• dbddc54 — fix(usb): route HAL v2 re-enumeration through PCD adapter
• registers src/usbd_confv2.c in libraries/USBDevice/CMakeLists.txt
• disables the legacy re-enumeration path in usbd_if.c for HAL v2 builds (&& !defined(USE_HALV2_DRIVER)); re-enumeration now goes through HAL_PCD_DeviceDisconnect()/Connect() on the PCD handle.
• 35f2774 — fix(usb): defer HAL v2 reconnect until device start: USBD_reenumerate() only reconnects when the peripheral was already active; the initial attach is done by HAL_PCD_Start() at device start.
• 157cb05 — style(usb): 2-space preprocessor indent to satisfy the astyle check

I tested on the xiao-stm32c5, and the USB CDC enumeration and log output were all normal.

If you encounter any other issues, please let me know and I will follow up to fix them.Thanks. :)