feature(tusb): Added tusb_teardown()

[roma-jam]

Requirements

To change the USB device function or re-initialize the tinyusb stack there should be an option to teardown the lower layer (disable the phy and flush the registers).

The public API for init tinyusb stack for USB Device is tusb_init(void) for versions < v0.17, and tusb_rhport_init(rhport, *rh_init) for verisons >= 0.17.

Teardown feature should be implemented as a public API for Device and Host roles and provide the possibility to use the teardown call in both (legacy and new API way)

Description

The same mechanism for legacy call support is used as for tusb_init() (providing the rhport as TUD_OPT_RHPORT or TUH_OPT_RHPORT but not the function argument)

Limitations

• Using macros to handle the legacy support instead of function (refer to Note2: https://github.com/hathach/tinyusb/blob/7c7b30f0ae66a856ada3526cb947bd3a255567f8/src/tusb.h#L140)

Breaking change

No breaking changes

Testing:

Implemented in espressif/esp-usb#39

Checklist

• Pull Request name has appropriate format (for example: "fix(dcd_dwc2): Resolved address selection when several phy are present")
• Optional: README.md updated
• CI passing

Related issues

• Related to esp32s3, restarting cdc software serial doesn't work (IDFGH-12813) esp-idf#13788
• Upstream PR: feature(tusb): Added tusb_teardown() hathach/tinyusb#2904

[peter-marcisovsky]

Tried the changes on HW with the test app, works fine. Once this is merged, we can enable the rest of the device tests in CI which depend on the teardown.