usb: Allow partial packet writes, add error checking and documentation

[piotrfila]

Changes:

• usb_start_tx -> ep_writev, now returns number of bytes written
• usb_start_rx -> ep_readv and ep_listen: This makes it easier to make interrupt-safe drivers
• More error checking when constructing descriptors
• First attempt at documenting the usb driver comptime interface
• The drivers now assume ACKs are handled automatically. This is the case for the rp2xxx usb controller but I have no idea if other controllers also handle it that way.
• New driver for rp2xxxx family that supports rebooting and logs through picotool
• HID driver implementation

[github-actions]

🔍 Lint Results

Found 1 issue on changed lines in 1 file:

• core/src/core/usb/drivers/cdc.zig: 1 issue

ℹ️ Additional issues on unchanged lines

The following 14 issue(s) exist but are not on lines changed in this PR:

core/src/core/usb.zig:357: TODO style comments need to have a linked microzig issue on the same line.
core/src/core/usb.zig:359: TODO style comments need to have a linked microzig issue on the same line.
core/src/core/usb.zig:429: TODO style comments need to have a linked microzig issue on the same line.
core/src/core/usb/drivers/cdc.zig:217: TODO style comments need to have a linked microzig issue on the same line.
core/src/core/usb/drivers/hid.zig:93: TODO style comments need to have a linked microzig issue on the same line.
core/src/core/usb/drivers/hid.zig:103: TODO style comments need to have a linked microzig issue on the same line.
core/src/core/usb/drivers/hid.zig:116: TODO style comments need to have a linked microzig issue on the same line.
core/src/core/usb/types.zig:149: Suggestion: Rename `U16Le` to `U16_Le`, it _should_ be more in line with our [style guidelines](https://microzig.tech/docs/contributing/). This automation is not perfect so take it with a grain of salt.
examples/raspberrypi/rp2xxx/src/custom_clock_config.zig:11: TODO style comments need to have a linked microzig issue on the same line.
examples/raspberrypi/rp2xxx/src/usb_cdc.zig:14: Suggestion: Rename `UsbSerial` to `USB_Serial`, it _should_ be more in line with our [style guidelines](https://microzig.tech/docs/contributing/). This automation is not perfect so take it with a grain of salt.
port/raspberrypi/rp2xxx/src/hal/clocks/common.zig:11: TODO style comments need to have a linked microzig issue on the same line.
port/raspberrypi/rp2xxx/src/hal/clocks/common.zig:64: TODO style comments need to have a linked microzig issue on the same line.
port/raspberrypi/rp2xxx/src/hal/clocks/common.zig:183: TODO style comments need to have a linked microzig issue on the same line.
port/raspberrypi/rp2xxx/src/hal/clocks/common.zig:223: TODO style comments need to have a linked microzig issue on the same line.

Updating with new lint results

[github-actions]

🔍 Lint Results

ℹ️ Additional issues on unchanged lines

The following 14 issue(s) exist but are not on lines changed in this PR:

core/src/core/usb.zig:358: TODO style comments need to have a linked microzig issue on the same line.
core/src/core/usb.zig:360: TODO style comments need to have a linked microzig issue on the same line.
core/src/core/usb.zig:430: TODO style comments need to have a linked microzig issue on the same line.
core/src/core/usb/drivers/cdc.zig:216: TODO style comments need to have a linked microzig issue on the same line.
core/src/core/usb/drivers/hid.zig:93: TODO style comments need to have a linked microzig issue on the same line.
core/src/core/usb/drivers/hid.zig:103: TODO style comments need to have a linked microzig issue on the same line.
core/src/core/usb/drivers/hid.zig:116: TODO style comments need to have a linked microzig issue on the same line.
core/src/core/usb/types.zig:149: Suggestion: Rename `U16Le` to `U16_Le`, it _should_ be more in line with our [style guidelines](https://microzig.tech/docs/contributing/). This automation is not perfect so take it with a grain of salt.
examples/raspberrypi/rp2xxx/src/custom_clock_config.zig:11: TODO style comments need to have a linked microzig issue on the same line.
examples/raspberrypi/rp2xxx/src/usb_cdc.zig:14: Suggestion: Rename `UsbSerial` to `USB_Serial`, it _should_ be more in line with our [style guidelines](https://microzig.tech/docs/contributing/). This automation is not perfect so take it with a grain of salt.
port/raspberrypi/rp2xxx/src/hal/clocks/common.zig:11: TODO style comments need to have a linked microzig issue on the same line.
port/raspberrypi/rp2xxx/src/hal/clocks/common.zig:64: TODO style comments need to have a linked microzig issue on the same line.
port/raspberrypi/rp2xxx/src/hal/clocks/common.zig:183: TODO style comments need to have a linked microzig issue on the same line.
port/raspberrypi/rp2xxx/src/hal/clocks/common.zig:223: TODO style comments need to have a linked microzig issue on the same line.

[github-actions]

🔍 Lint Results

ℹ️ Additional issues on unchanged lines

The following 6 issue(s) exist but are not on lines changed in this PR:

core/src/core/usb/descriptor/hid.zig:17: Suggestion: Rename `Hid` to `HID`, it _should_ be more in line with our [style guidelines](https://microzig.tech/docs/contributing/). This automation is not perfect so take it with a grain of salt.
examples/raspberrypi/rp2xxx/src/custom_clock_config.zig:11: TODO style comments need to have a linked microzig issue on the same line.
port/raspberrypi/rp2xxx/src/hal/clocks/common.zig:11: TODO style comments need to have a linked microzig issue on the same line.
port/raspberrypi/rp2xxx/src/hal/clocks/common.zig:64: TODO style comments need to have a linked microzig issue on the same line.
port/raspberrypi/rp2xxx/src/hal/clocks/common.zig:183: TODO style comments need to have a linked microzig issue on the same line.
port/raspberrypi/rp2xxx/src/hal/clocks/common.zig:223: TODO style comments need to have a linked microzig issue on the same line.

[github-actions]

🔍 Lint Results

Found 6 issues on changed lines in 1 file:

• core/src/core/usb/types.zig: 6 issues

ℹ️ Additional issues on unchanged lines

The following 8 issue(s) exist but are not on lines changed in this PR:

core/src/core/usb/descriptor/hid.zig:17: Suggestion: Rename `Hid` to `HID`, it _should_ be more in line with our [style guidelines](https://microzig.tech/docs/contributing/). This automation is not perfect so take it with a grain of salt.
examples/raspberrypi/rp2xxx/src/custom_clock_config.zig:11: TODO style comments need to have a linked microzig issue on the same line.
examples/raspberrypi/rp2xxx/src/usb_hid.zig:83: TODO style comments need to have a linked microzig issue on the same line.
examples/raspberrypi/rp2xxx/src/usb_hid.zig:14: Suggestion: Rename `HidDriver` to `HID_Driver`, it _should_ be more in line with our [style guidelines](https://microzig.tech/docs/contributing/). This automation is not perfect so take it with a grain of salt.
port/raspberrypi/rp2xxx/src/hal/clocks/common.zig:11: TODO style comments need to have a linked microzig issue on the same line.
port/raspberrypi/rp2xxx/src/hal/clocks/common.zig:64: TODO style comments need to have a linked microzig issue on the same line.
port/raspberrypi/rp2xxx/src/hal/clocks/common.zig:183: TODO style comments need to have a linked microzig issue on the same line.
port/raspberrypi/rp2xxx/src/hal/clocks/common.zig:223: TODO style comments need to have a linked microzig issue on the same line.

Updating with new lint results

[github-actions]

🔍 Lint Results

Found 1 issue on changed lines in 1 file:

• core/src/core/usb.zig: 1 issue

All lint issues have been resolved

[github-actions]

🔍 Lint Results

Found 3 issues on changed lines in 3 files:

• port/stmicro/stm32/src/hals/STM32F303/rcc.zig: 1 issue
• port/wch/ch32v/src/cpus/main.zig: 1 issue
• port/wch/ch32v/src/hals/dma.zig: 1 issue

⚠️ Could not attach inline comments due to an error.

All lint issues have been resolved

[Grazfather]

Looks really good so far. Still have to review half of the files