initial commit

2026-10-11 21:48:59 +08:00
commit b44ce7bd77
@@ -0,0 +1,71 @@
+# 0.10.0
+
+*May 28, 2021*
+
+- Rework tu_fifo_t with separated mutex for read and write, better support DMA with read/write buffer info. And constant address mode
+- Improve audio_test example and add audio_4_channel_mic example
+- Add new dfu example
+- Remove pico-sdk from submodule
+
+## Device Controller Driver (DCD)
+
+- Add new DCD port for Silabs EFM32GG12 with board Thunderboard Kit (SLTB009A)
+- Add new DCD port Renesas RX63N, board GR-CITRUS
+- Add new (optional) endpoint API dcd_edpt_xfer_fifo
+- Fix build with nRF5340
+- Fix build with lpc15 and lpc54
+- Fix build with lpc177x_8x
+- STM32 Synopsys: greatly improve Isochronous transfer with `edpt_xfer_fifo()` API
+- Support LPC55 port1 highspeed
+- Add support for Espressif esp32s3
+- nRF: fix race condition that could cause drop packet of Bulk OUT transfer
+
+## USB Device Driver (USBD)
+
+- Add new (optional) endpoint ADPI `usbd_edpt_xfer_fifo()`
+
+## Device Class Driver
+
+### CDC
+
+- [Breaking] `tud_cdc_peek()`, `tud_vendor_peek()` no longer support random offset and dropped position parameter.
+
+### DFU
+
+- Add new DFU 1.1 class driver (WIP)
+
+### HID
+
+- Fix keyboard report descriptor template
+- Add more hid keys constant from 0x6B to 0xA4
+- [Breaking] rename API
+
+  - `HID_PROTOCOL_NONE/KEYBOARD/MOUSE` to `HID_ITF_PROTOCOL_NONE/KEYBOARD/MOUSE`
+  - `tud_hid_boot_mode()` to `tud_hid_get_protocol()`
+  - `tud_hid_boot_mode_cb()` to `tud_hid_set_protocol_cb()`
+
+### MIDI
+
+- Fix MIDI buffer overflow issue
+- [Breaking] rename API
+
+  - Rename `tud_midi_read()` to `tud_midi_stream_read()`
+  - Rename `tud_midi_write()` to `tud_midi_stream_write()`
+  - Rename `tud_midi_receive()` to `tud_midi_packet_read()`
+  - Rename `tud_midi_send()` to `tud_midi_packet_write()`
+
+## Host Controller Driver (HCD)
+
+- No noticeable changes
+
+## USB Host Driver (USBH)
+
+- No noticeable changes
+
+## Host Class Driver
+
+- HID: Rework host hid driver, basically everything changes
+
+## Contributors
+
+Thanks to everyone who contributed to this release: @alisitsyn, @corvus-ossifragus, @hathach, @jgressmann, @joeycastillo, @kapacuk, @kasjer, @kkitayam, @ned-pcs, @noodlefighter, @ogatatsu, @PanRe, @perigoso, @pigrew, @sjanc, @xmos-jmccarthy.
@@ -0,0 +1,17 @@
+# 0.10.1
+
+*June 2, 2021*
+
+- rework rp2040 examples and CMake build, allow better integration with pico-sdk
+
+## Host Controller Driver (HCD)
+
+- Fix rp2040 host driver: incorrect PID with low speed device with max packet size of 8 bytes
+- Improve hub driver
+- Remove obsolete `hcd_pipe_queue_xfer()`/`hcd_pipe_xfer()`
+- Use `hcd_frame_number()` instead of micro frame
+- Fix OHCI endpoint address and `xferred_bytes` in xfer complete event
+
+## Contributors
+
+Thanks to everyone who contributed to this release: @hathach, @kilograham.
@@ -0,0 +1,90 @@
+# 0.11.0
+
+*August 30, 2021*
+
+- Add host/hid_controller example: only worked/tested with Sony PS4 DualShock controller
+- Add device/hid_boot_interface example
+- Add support for Renesas CCRX toolchain for RX mcu
+
+## Device Controller Driver (DCD)
+
+- Add new DCD port for SAMx7x (E70, S70, V70, V71)
+- Add new mcu K32L2Bxx
+- Add new mcu GD32VF103
+- Add new mcu STM32l151
+- Add new mcu SAML21
+- Add new mcu RX65n RX72n
+- Fix NUC120/121/126 USBRAM can only be accessed in byte manner. Also improve set_address & disable sof
+- Add Suspend/Resume handling for Renesas RX family.
+- Fix DA1469x no VBUS startup
+
+### Synopsys
+
+- Fix Synopsys set address bug which could cause re-enumeration failed
+- Fix `dcd_synopsys` driver integer overflow in HS mode (issue #968)
+
+### nRF5x
+
+- Add nRF5x suspend, resume and remote wakeup
+- Fix nRF5x race condition with `TASKS_EP0RCVOUT`
+
+### RP2040
+
+- Add RP2040 suspend & resume support
+- Implement double buffer for both host and device (#891). However device EPOUT is still single buffered due to technical issue with short packet
+
+## Device Stack
+
+### USBD
+
+- Better support big endian mcu
+- Add `tuh_inited()` and `tud_inited()`, will separate `tusb_init/inited()` to `tud/tuh_init/inited()`
+- Add `dcd_attr.h` for defining common controller attribute such as max endpoints
+
+### Bluetooth
+
+- Fix stridx error in descriptor template
+
+### DFU
+
+- Enhance DFU implementation to support multiple alternate interface and better support `bwPollTimeout`
+- Rename `CFG_TUD_DFU_MODE` to simply `CFG_TUD_DFU`
+
+### HID
+
+- Fix newline usage keyboard (ENTER 0x28)
+- Better support Hid Get/Set report
+- Change max gamepad support from 16 to 32 buttons
+
+### MIDI
+
+- Fix midi available
+- Fix midi data
+- Fix an issue when calling midi API when not enumerated yet
+
+### UAC2
+
+- Fix bug and enhance of UAC2
+
+### Vendor
+
+- Fix vendor fifo deadlock in certain case
+- Add `tud_vendor_n_read_flush()`
+
+## Host Controller Driver (HCD)
+
+### RP2040
+
+- Implement double buffered to fix E4 errata and boost performance
+- Lots of rp2040 update and enhancement
+
+## Host Stack
+
+- Major update and rework most of host stack, still needs more improvement
+- Lots of improvement and update in parsing configuration and control
+- Rework and major update to HID driver. Will default to enable boot interface if available
+- Separate `CFG_TUH_DEVICE_MAX` and `CFG_TUH_HUB` for better management and reduce SRAM usage
+
+## Contributors
+
+Thanks to everyone who contributed to this release: @a-h, @BennyEvans, @ctag-fh-kiel, @DuMaM, @hathach, @HiFiPhile, @KarlK90, @kasjer, @kilograham, @kkitayam, @majbthrd, @mmosca, @mws-rmain, @ned-pcs, @nxf58843, @perigoso, @sabas1080, @salkinium, @tringis, @Wini-Buh, @xcguang, @xmos-jmccarthy, @zhangslice.
@@ -0,0 +1,31 @@
+# 0.12.0
+
+*October 19, 2021*
+
+- add `CFG_TUSB_OS_INC_PATH` for os include path
+
+## Device Controller Driver (DCD)
+
+- Getting device stack to pass USB Compliance Verification test (chapter9, HID, MSC). Ports are tested:
+  nRF, SAMD 21/51, rp2040, stm32f4, Renesas RX, iMXRT, ESP32-S2/3, Kinetic KL25/32, DA146xx
+- Added `dcd_edpt_close_all()` for switching configuration
+- [Transdimension] Support `dcd_edpt_xfer_fifo()` with auto wrap over if fifo buffer is 4K aligned and size is multiple of 4K.
+- [DA146xx] Improve vbus, reset, suspend, resume detection, and remote wakeup.
+
+## Device Stack
+
+- Add new network driver Network Control Model (CDC-NCM), update `net_lwip_webserver` to work with NCM (need re-configure example)
+- Add new USB Video Class UVC 1.5 driver and video_capture example (work in progress)
+- Fix potential buffer overflow for HID, bluetooth drivers
+
+## Host Controller Driver (HCD)
+
+No notable changes
+
+## Host Stack
+
+No notable changes
+
+## Contributors
+
+Thanks to everyone who contributed to this release: @Daft-Freak, @dshadoff, @hansfbaier, @hathach, @HiFiPhile, @kamtom480, @kasjer, @kkitayam, @majbthrd, @szymonh, @unlimitedcodeworks.
@@ -0,0 +1,42 @@
+# 0.13.0
+
+*February 23, 2022*
+
+- [tu_fifo] Fix locked mutex when full, and return type in `peek_n()`
+
+## Controller Driver (DCD & HCD)
+
+- [DWC2] Generalize synopsys dwc2 with synopsys/dwc2 which support both FS and HS phy (UTMI and ULPI) for various MCUs.
+
+  - Broadcom 28/27xx on raspberrypi SBC
+  - Silicon Labs EFM32
+  - Espressif ESP32 Sx
+  - GigaDevice GD32
+  - ST STM32
+  - Infineon XMC
+- [KL25] Add new HCD for NXP KL25
+- [MUSB] Add new DCD and HCD for Mentor musb with TI MSP432E4
+- [F1C100s] Add new DCD for Allwinner F1C100s family
+- [PIC32MZ] Add new DCD for PIC32MZ
+- [nRF] Fix/Enhance various race condition with: EASY DMA, request HFXO, EPOUT
+- [ChipIdea] rename Transdimension to more popular ChipIdea Highspeed,
+- [RP2040] various update/fix for hcd/dcd
+- [FT9XX] new DCD port for Bridgetek FT90x and FT93x devices
+- [DA1469X] Fix resume
+- [OHCI] Fix device array out of bound
+
+Note: legacy drivers such as st/synopsys, nxp/transdimension are still present in this release but won't receive more update and could be removed in the future.
+
+## Device Stack
+
+- [Audio] Support disabling feedback format correction (16.16 <-> 10.14 format)
+- [MSC] Add `tud_msc_request_sense_cb()` callback, change most default sense error to medium not present (0x02, 0x3A, 0x00)
+- [Video] Fix video_capture example fails enumeration when 8FPS
+
+## Host Stack
+
+No notable changes
+
+## Contributors
+
+Thanks to everyone who contributed to this release: @alisitsyn, @brtchip-gdm, @cr1901, @EmergReanimator, @hathach, @HiFiPhile, @JayToltTech, @jgressmann, @kasjer, @kkitayam, @leptun, @liamfraser, @majbthrd, @mkj, @mysterywolf, @NexusXe, @nxf58843, @perigoso, @rppicomidi, @Ryzee119, @scoudreau, @sharpie7, @suda-morris, @t123yh, @tannewt, @vmilea, @ZenithalHourlyRate.
@@ -0,0 +1,85 @@
+# 0.14.0
+
+*August 23, 2022*
+
+- Improve compiler support for CCRX and IAR
+- Add timeout to `osal_queue_receive()`
+- Add `tud_task_ext(timeout, in_isr)` as generic version of `tud_task()`. Same as `tuh_task_ext()`, `tuh_task()`
+- Enable more warnings `-Wnull-dereference -Wuninitialized -Wunused -Wredundant-decls -Wconversion`
+
+## Add new examples
+
+- `host/bare_api` to demonstrate generic (app-level) enumeration and endpoint transfer
+- `dual/host_hid_to_device_cdc` to run both device and host stack concurrently, get HID report from host and print out to device CDC. This example only work with multiple-controller MCUs and rp2040 with the help of pio-usb as added controller.
+
+## Controller Driver (DCD & HCD)
+
+- Enhance rhports management to better support dual roles
+
+  - `CFG_TUD_ENABLED`/`CFG_TUH_ENABLED`, `CFG_TUD_MAX_SPEED`/`CFG_TUH_MAX_SPEED` can be used to replace `CFG_TUSB_RHPORT0_MODE`/`CFG_TUSB_RHPORT1_MODE`
+  - `tud_init(rhport)`, `tuh_init(rhport)` can be used to init stack on specified roothub port (controller) instead of `tusb_init(void)`
+- Add dcd/hcd port specific defines `TUP_` (stand for tinyusb port-specific)
+
+### dwc2
+
+- Update to support stm32 h72x, h73x with only 1 otg controller
+- Fix overwrite with grstctl when disable endpoint
+
+### EHCI
+
+- Fix an issue with EHCI driver
+
+### msp430
+
+- Fix for possible bug in msp430-elf-gcc 9.3.0
+
+### nrf5x
+
+- Fix DMA access race condition using atomic function
+
+### pic32
+
+- Fix PIC32 sanity
+
+### rp2040
+
+- Add PICO-PIO-USB as controller (device/host) support for rp2040
+- Use shared IRQ handlers, so user can also hook the USB IRQ
+- Fix resumed signal not reported to device stack
+
+### stm32fsdev
+
+- Add support for stm32wb55
+
+## Device Stack
+
+- [Audio] Add support for feedback endpoint computation
+
+  - New API `tud_audio_feedback_params_cb()`, `tud_audio_feedback_interval_isr()`.
+  - Supported computation method are: frequency with fixed/float or power of 2. Feedback with fifo count is not yet supported.
+  - Fix nitfs (should be 3) in `TUD_AUDIO_HEADSET_STEREO_DESCRIPTOR`
+  - Fix typo in `audiod_rx_done_cb()`
+
+- [DFU] Fix coexistence with other interfaces BTH, RNDIS
+- [MSC] Fix inquiry response additional length field
+- [Vendor] Improve write performance
+
+## Host Stack
+
+- Add new API `tuh_configure(rhport, cfg_id, cfg_param)` for dynamic port specific behavior configuration
+- [HID] Open OUT endpoint if available
+- [Hub] hub clear port and device interrupts
+
+### [USBH] Major improvement
+
+- Rework usbh control transfer with complete callback. New API `tuh_control_xfer()` though still only carry 1 usbh (no queueing) at a time.
+- Add generic endpoint transfer with `tuh_edpt_open()`, `tuh_edpt_xfer()`. Require `CFG_TUH_API_EDPT_XFER=1`
+- Support app-level enumeration with new APIs
+
+  - `tuh_descriptor_get()`, `tuh_descriptor_get_device()`, `tuh_descriptor_get_configuration()`, `tuh_descriptor_get_hid_report()`
+  - `tuh_descriptor_get_string()`, `tuh_descriptor_get_manufacturer_string()`, `tuh_descriptor_get_product_string()`, `tuh_descriptor_get_serial_string()`
+  - Also add `_sync()` as sync/blocking version for above APIs
+
+## Contributors
+
+Thanks to everyone who contributed to this release: @alexandre-perrin, @ccrome, @cr1901, @Daft-Freak, @Firefishy, @hathach, @iabdalkader, @Iktek, @kasjer, @kilograham, @liamfraser, @M3gaFr3ak, @maddyaby, @majbthrd, @mingpepe, @Nikitarc, @perigoso, @phryniszak, @pigrew, @Qianhao2579, @robert-hh, @Ryzee119, @sjanc, @sknebel, @tannewt, @tfx2001, @Wini-Buh, @yoyopod.
@@ -0,0 +1,88 @@
+# 0.15.0
+
+*February 10, 2023*
+
+- Add codespell to detect typo
+- Add support for fuzzing and badge for oss-fuzz
+- [osal]
+  - Allow the use of non-static allocation for FreeRTOS
+  - Fix FreeRTOS wrong task switch in some cases
+- Fix tu_fifo memory overflown when repeatedly write to overwritable fifo (accumulated more than 2 depths)
+- Better support for IAR (ARM) with ci build check for stm32 mcus.
+- Fix Windows build for some mingw gnu make situations
+
+## Controller Driver (DCD & HCD)
+
+- Add new port support (WIP) for WCH CH32V307 USB Highspeed
+- Add new port support (WIP) for PIC32MM/MX & PIC24
+
+### nRF
+
+- Fix endpoint internal state when closed
+- Fix reception of large ISO packets
+
+### rp2040
+
+- [dcd] Implement workaround for Errata 15. This enable SOF when bulk-in endpoint is in use and reduce its bandwidth to only 80%
+- [hcd] Fix shared irq slots filling up when `hcd_init()` is called multiple times
+- [hcd] Support host bulk endpoint using hw "interrupt" endpoint. Note speed limit is 64KB/s
+
+### samd
+
+- [dcd] Add support for ISO endpoint
+
+### dwc2
+
+- [dcd] Add support for stm32u5xx
+
+### esp32sx
+
+- Fix Isochronous transfers only transmitted on even frame
+
+### lpc_ip3511
+
+- [dcd] Add isochronous support and fix endpoint accidental write
+
+### ft90x
+
+- Improve and enhance support for FT9xx MCU, tested with more examples
+
+## Device Stack
+
+### Video
+
+- Add support for MJPEG
+- Fix probe on macOS
+
+### MIDI
+
+- Support port name strings
+- fix MS Header wTotalLength computation
+
+### HID
+
+- Add FIDO descriptor template
+- change length in `tud_hid_report_complete_cb()` from `uint8_t` to `uint16_t`
+
+### CDC
+
+- Fix autoflush for FIFO < MPS
+- Fix tx fifo memory overflown when DTR is not set and `tud_cdc_write()` is called repeatedly with large enough data
+
+### USBTMC
+
+- Fix packet size with highspeed
+
+## Host Stack
+
+- Retry a few times with transfers in enumeration since device can be unstable when starting up
+- [MSC] Rework host mass storage API. Add new `host/msc_file_explorer` example
+
+### CDC
+
+- Add support for host cdc
+- Fix host cdc with device without IAD e.g Arduino Due
+
+## Contributors
+
+Thanks to everyone who contributed to this release: @battlesnake, @benishor, @brtchip-gdm, @DRNadler, @gregdavill, @hadess, @hathach, @hfegran, @HiFiPhile, @jbruneaux31, @jmark1m, @kasjer, @kaysievers, @kilograham, @kkitayam, @kripton, @Lan-Hekary, @LynnL4, @maddyaby, @mingpepe, @nathaniel-brough, @P33M, @pete-pjb, @ReimuNotMoe, @rppicomidi, @scoudreau, @Skyler84, @Staacks, @tore-espressif, @tswan-quasi, @tyustli.
@@ -0,0 +1,148 @@
+# 0.16.0
+
+*November 24, 2023*
+
+- New controller driver: MAX3421e (usb host shield), rusb2 (Renesas USB2.0), ChipIdea fullspeed
+- New MCUs: MCXn9, nRF5340, STM32: G0, G4, L5, U575, U5A5, RA6m5, CH32F20x
+- Add initial TypeC PowerDelivery support with STM32G4
+- Remove submodules and use python script to manage repo dependencies #1947
+- Add CMake support for most families and boards, move build file from tools/ to examples/build_system
+- Add ETM trace support with JTrace for nrf52840, nrf5340, mcb1857, stm32h743eval, ra6m5
+- [osal] Make it possible to override the `osal_task_delay()` in osal_none
+- Add CDC+UAC2 composite device example
+- Enhance Hardware-in-the-loop (HIL) testing with more boards: rp2040, stm32l412nucleo, stm32f746disco, lpcxpresso43s67
+
+## Controller Driver (DCD & HCD)
+
+- Add new ISO endpoint API: `dcd_edpt_iso_alloc()` and `dcd_edpt_iso_activate()`
+- Remove legacy driver st/synopsys
+
+### EHCI
+
+- [iMXRT] Add dache clean/invalidate when memory is in cacheable memory
+- Fix portsc write issue which cause problem with enumeration
+- Fix an issue when doing port reset write to portsc
+- Fix port change detect is not recognized when power on with attached device
+- Fix xfer failed with disconnected device as stalled
+- Fix error on EHCI causes xfer error in non-queued qhd which cause memory fault
+- Un-roll recursive hub removal with usbh queue
+- Fix issue when removing queue head
+- Implement `hcd_edpt_abort_xfer()`
+- use standard USB complete interrupt instead of custom chipidea async/period interrupt to be more compatible with other ehci implementation
+- refactor usb complete & error isr processing, merge, update. Fix EHCI QHD reuses QTD on wrong endpoint
+- Improve bus reset, fix `send_setup()` not carried out if halted previously
+- Fix clear qhd halted bit if not caused by STALL protocol to allow for next transfer
+
+### ChipIdea Highspeed
+
+- Fix control transfer issue when previous status and new setup complete in the same isr frame
+- [imxrt] Add dcache support for cache region
+
+### ChipIdea Fullspeed
+
+- Generalize ChipIdea Fullspeed driver for mcxn9 (port 0), kinetis
+
+### nrf
+
+- Fix DMA race condition with ISO OUT transfer #1946
+- Add support for nRF5340 with pca10095 board
+
+### Renesas rusb2
+
+- Generalize rusb2 driver for ra, rx mcus
+- rework both dcd and hcd for better multiple ports support
+- Add support for board with HS USB port: ra6m5 port1
+
+### rp2040
+
+- [dcd] Make writes to SIE_CTRL aware of concurrent access
+- [hcd] add `hcd_frame_number()`, `hcd_edpt_abort_xfer()` for pio-usb host
+
+### stm32 fsdev
+
+- Add STM32L5 support
+- Implement `dcd_edpt_iso_alloc()` and `dcd_edpt_iso_activate()`
+
+### OHCI
+
+- Allows configurable root hub ports, handles SMM mode (Ref OHCI spec 5.1.1.3.3) and Bios mode (Ref OHCI spec 5.1.1.3.4)
+- Fix FrameIntervalToggle must be toggled after we write the FrameInterval (Ref OHCI Spec 7.3.1)
+- Wait PowerOnToPowerGoodTime after we enable power of the RH ports (Ref OHCI Spec 7.4.1)
+- Generate port interrupts for devices already connected during init.
+- Fix issue when removing queue head
+- Disable MIE during IRQ processing and clear HccaDoneHead on completion as per OCHI Spec Page 80
+
+## Device Stack
+
+- Add optional hooks `tud_event_hook_cb()`
+
+### Audio (UAC2)
+
+- Fix feedback EP buffer alignment.
+- Fix encoding, update example
+- Improve IN transfer
+
+### Bluetooth
+
+- Add historical EP compatibility for Bluetooth HCI
+
+### CDC
+
+- Fix line_coding alignment
+- Fix typo in cdc line coding enum
+
+### MIDI
+
+- Fix `stream_write()` always writes system messages to cable 0
+- Fix incorrect NOTE_ON, NOTE_OFF definitions
+
+### USBTMC
+
+- Fix tmc488 bit order
+
+### Vendor
+
+- fix `read()`/`write()` race condition
+
+### Video (UVC)
+
+- Add the capability for video class to handle a bulk endpoint in the streaming interface.
+
+## Host Stack
+
+### USBH
+
+- Add new APIs: `tuh_interface_set()`, `tuh_task_event_ready()`, `tuh_edpt_abort_xfer()`, `tuh_rhport_reset_bus()`, `tuh_rhport_is_active()`
+- Fix issue when device generate multiple attach/detach/attach when plugging in
+- Prefer application callback over built-in driver on transfer complete event
+- Correct `hcd_edpt_clear_stall()` API signature
+- Separate bus reset delay and contact debouncing delay in enumeration
+- Support `usbh_app_driver_get_cb()` for application drivers
+- Fix usbh enumeration removal race condition
+- Add optional hooks `tuh_event_hook_cb()`
+
+### CDC
+
+- Breaking: change `tuh_cdc_itf_get_info()` to use tuh_itf_info_t instead of tuh_cdc_info_t
+- Fix cdc host enumeration issue when device does not support line request
+- Add support for vendor usb2uart serial: ftdi, cp210x, ch9102f
+- Improve sync control API e.g  `tuh_cdc_set_control_line_state()`, `tuh_cdc_set_line_coding()`
+
+### HID
+
+- Add new APIs `tuh_hid_send_report()`, `tuh_hid_itf_get_info()`, `tuh_hid_receive_ready()`, `tuh_hid_send_ready()`, `tuh_hid_set_default_protocol()`
+- Change meaning of CFG_TUH_HID to total number of HID interfaces supported. Previously `CFG_TUH_HID` is max number of interfaces per device which is rather limited and consume more resources than needed.
+
+### HUB
+
+- Fix handling of empty "status change" interrupt
+- Fix issue with hub status_change is not aligned
+
+### MSC
+
+- Fix bug in `tuh_msc_ready()`
+- Fix host msc get maxlun not using aligned section memory
+
+## Contributors
+
+Thanks to everyone who contributed to this release: @0xCCF4, @abakosh, @ahooper, @antoniovazquezblanco, @bavison, @bencowperthwaite, @bpaddock, @branalba, @ccrome, @dauc, @dhalbert, @DRNadler, @dsugisawa-mixi, @epatstarkey, @eustas, @facchinm, @gabChouin, @georgeboc, @hathach, @HiFiPhile, @howard0su, @HubertD, @ipopov, @jbtheou, @jefftrull, @jfedor2, @jferreir, @jfm92, @jncronin, @JustAnother1, @kasjer, @kholia, @kilograham, @kkitayam, @koendv, @Krasutski, @kripton, @maidnl, @MattMills, @mikee47, @mndza, @nathaniel-brough, @NullMember, @perigoso, @projectgus, @raiden00pl, @ReimuNotMoe, @Rocky04, @rppicomidi, @Ryzee119, @sinitax, @sjanc, @slark-yuxj, @slc-tl, @Tails86, @tannewt, @tswan-quasi, @tyustli, @Yveaux.
@@ -0,0 +1,166 @@
+# 0.17.0
+
+*September 13, 2024*
+
+## General
+
+- Improved CI: build both cmake and make. Make use of CircleCI for part of build process to speed up CI
+- Add CodeQL Workflow for Code Security Analysis
+- Add Clang compiler support
+- Add default implementation for weak callbacks functions for better Keil compatibility
+- Upgrade hardware-in-the-loop (HIL) testing with more boards and examples: including dual stack example
+
+## Controller Driver (DCD & HCD)
+
+### Chipidea
+
+- Support MCXA
+
+### DWC2
+
+- Fix tickless issue with stm32f7: disable ULPI clock during sleep when using internal phy
+- Fix SOF interrupt handling
+- Fix fifo level half/empty issue
+- Add DWC2 Test Mode support.
+- for esp32 force disconnect/connect using USB_WRAP otg pad override
+
+### FSDEV
+
+- Rewrite and Generalize driver to support non-stm32 mcu such as wch
+- Simplify PMA, HW FIFO access and bit manipulation for different access scheme 1x16, 2x16 and 32 bit
+- Add support for ch32 usbd e.g ch32v203
+- Add support for STM32G4 and STM32U5 microcontrollers.
+- Fix h5 (32-bit) errata 2.15.1: Buffer description table update completes after CTR interrupt triggers
+- ISO EP buffer allocation improvements, implement `dcd_edpt_close_all()`
+
+- Fix ch32v203 race condition and stability issue with
+
+  - fix ch32v203 seems to unconditionally accept ZLP on EP0 OUT.
+  - fix v203 race condition between rx bufsize and RX_STAT which cause PMAOVR, occurs with WRITE10
+  - correctly handle setup prepare at `dcd_edpt0_status_complete()`, which fixes the race condition with windows where we could miss setup packet (setup bit set, but count = 0)
+
+### MAX3421E
+
+- Add support for rp2040, esp32 (c3, c6, h2, etc..)
+- Add `hcd_deinit()` for max3421
+- Retry NAK handling next frame to reduce CPU and SPI bus usage
+- add `cpuctl` and `pinctl` to `tuh_configure()` option for max3421
+- Implement hcd abort transfer for Max3421
+- Properly Handle NAK Response in MAX3421E driver: correctly switch and skip writing to 2 FIFOs when NAK received. Otherwise, the driver may hang in certain conditions.
+
+### MSP430
+
+- support non-bus-powered
+
+### MUSB
+
+- Add support for Analoog devices: max32650, max32666, max32690, max3278002
+
+### nRF
+
+- Fix `dcd_edpt_open()` for iso endpoint
+- Handle ISOOUT CRC errors
+- Add compile support with old nordic sdk
+- Fix a few race conditions
+
+### OHCI
+
+- Allow more than 16 devices
+
+### RP2040
+
+- Correctly abort control transfer when new setup arrived. Due to RP2040-E2 only able to fix B2 or later
+- Implement hcd abort transfer for rp2040
+- Add support for rp2350
+
+### RUSB2
+
+- Support ra2a1 pipe number scheme
+
+### WCH CH32
+
+- Added support for USB OTG/FS and FSDev Driver. Update CH32V307 to allow manual select FS or HS driver.
+- Fixed various bugs in CH32v307 usbhs driver: endpoint handling and data transfer management.
+
+## Device Stack
+
+- Add `tud_deinit()` and `class driver deinit()` to deinitialize TinyUSB device stack.
+- Add support for generic SOF callback.
+- Add set address recovery time 2ms per USB spec.
+
+### Audio
+
+- Add audio_test_freertos & audio_4_channel_mic_freertos
+- Improved support for Audio Class 2.0 (UAC2) with various bug fixes.
+- Add feedback by fifo counting.
+
+### Bluetooth HCI
+
+- Issue ZLP on ACL IN ep when transfer is multiple of endpoint max packet size
+
+### CDC
+
+- Add `tud_cdc_configure_fifo()` to make RX/TX buffer persistent (not clear when disconnected)
+- Add missing capability bit for CDC ACM serial break support
+- Enhanced CDC class with better handling of large data transmissions.
+- Add missing capability bit for CDC ACM serial break support
+
+### HID
+
+- Added missing key codes for keypad
+- Added HID Lighting and Illumination functionality
+- Fixed issues in the HID class for more reliable device enumeration.
+- Support HID Mouse with absolute positioning
+- Use separate buffer for control SET_REPORT, fix conflict with interrupt endpoint out
+
+### MSC
+
+- Added support for SCSI_CMD_PREVENT_ALLOW_MEDIUM_REMOVAL
+
+### Net
+
+- Rewrite of NCM device driver to improve throughput
+- removed obsolete `tud_network_link_state_cb()`
+
+### USBTMC
+
+- Added notification support
+
+### Vendor
+
+- Migrate to new endpoint stream API, support non-buffered TX/RX
+- Add ZLP for `write()` when needed
+
+### Video
+
+- Enhance UVC descriptors and example
+- Video Added support for USB Video Class (UVC) with MJPEG.
+- Fix multiple interfaces, add an example of 2ch video capture.
+- Fix race for `tud_video_n_streaming()` check
+
+## Host Stack
+
+- Added `tuh_deinit()` to de-initialize TinyUSB host stack.
+- Added support for new USB mass storage class APIs.
+- Improved error handling and retry mechanisms for unstable devices.
+
+### CDC Serial
+
+- Add support for ch34x
+- Allow to overwrite `CFG_TUH_CDC_FTDI/CP210X/CH32X_VID_PID_LIST`
+- Enhanced stability of CDC-ACM devices during enumeration.
+
+### HID
+
+- Add `tuh_hid_receive_abort()`
+- Add `tuh_hid_get_report()`
+
+### Hub
+
+- Prevent status request to invalid ep_num
+- Fix double status xfer
+- unroll hub removal
+
+## Contributors
+
+Thanks to everyone who contributed to this release: @acscd, @andrewleech, @angmolin, @antoniovazquezblanco, @arntsonl, @b4yuan, @battlesnake, @BrentK-ADI, @camilaodsouza, @cdesjardins, @ChrisDeadman, @clhenry, @cumhuronat, @donatieng, @dp111, @dragonlock2, @duckylotl, @eightycc, @emb4fun, @Erlkoenig90, @feaser, @gschorcht, @hathach, @HiFiPhile, @hinxx, @hjalleboii, @ikskuh, @IngHK, @jerpa77, @jotonedev, @kaidegit, @kasjer, @kaspernyhus, @kilograham, @kkitayam, @Krasutski, @LarssonOliver, @leptun, @liamfraser, @lijunru-hub, @lurch, @Lurcy38, @maflcko, @mamiral, @MatiMcFly, @Okarss, @pigrew, @ra1nb0w, @Rbb666, @rgrr, @Rocky04, @rsolorzanomsft, @Ryzee119, @shuffle2, @slark-yuxj, @tannewt, @thierer, @tinic, @tlyu, @tobozo, @tommie, @trejan, @tyustli, @wjklimek1, @XelaRellum, @Xelus22, @xudongzheng, @YixingShen, @zx96.
@@ -0,0 +1,57 @@
+# 0.18.0
+
+*December 25, 2024*
+
+## General
+
+- New MCUs:
+  - Add esp32p4 OTG highspeed support
+  - Add stm32 u0, c0, h7rs
+- Better support dcache, make sure all usb-transferred buffer are cache line aligned and occupy full cache line
+- Build ARM IAR with CircleCI
+- Improve HIL with `dual/host_info_to_device_cdc` optional for pico/pico2, enable dwc2 dma test
+
+## API Changes
+
+- Change signature of `tusb_init(rhport, tusb_rhport_init_t*)`, `tusb_init(void)` is now deprecated but still available for backward compatibility
+- Add new `tusb_int_handler(rhport, in_isr)`
+- Add time-related APIs: `tusb_time_millis_api()` and `tusb_time_delay_ms_api()` for non-RTOS, required for some ports/configuration
+
+### New configuration macros
+
+- `CFG_TUD/TUH_MEM_DCACHE_ENABLE` enable data cache sync for endpoint buffer
+- `CFG_TUD/TUH_MEM_DCACHE_LINE_SIZE` set cache line size
+- `CFG_TUD/TUH_DWC2_SLAVE_ENABLE` enable dwc2 slave mode
+- `CFG_TUD/TUH_DWC2_DMA_ENABLE` enable dwc2 dma mode
+
+## Controller Driver (DCD & HCD)
+
+### DWC2
+
+- Add DMA support for both device and host controller
+- Add host driver support including: full/high speed, control/bulk/interrupt (CBI) transfer, split CBI i.e FS/LS attached via highspeed hub, hub support
+
+### RP2
+
+- implement `dcd_edpt_iso_alloc()` and `dcd_edpt_iso_activate()` for isochronous endpoint
+
+### iMXRT1170
+
+- support M4 core
+
+## Device Stack
+
+- Vendor Fix  class reset
+- NCM fix recursions in `tud_network_recv_renew()`
+- Audio fix align issue of `_audiod_fct.alt_setting`
+- UVC support format frame based
+- Change `dcd_dcache_()` return type from void to bool
+- HID add Usage Table for Physical Input Device Page (0x0F)
+
+## Host Stack
+
+- Fix an duplicated attach issue which cause USBH Defer Attach until current enumeration complete message
+
+## Contributors
+
+Thanks to everyone who contributed to this release: @bollenn, @chintal, @DavidEGrayson, @GuavTek, @hathach, @HiFiPhile, @lijunru-hub, @Maerdl, @pschatzmann, @rgrr, @roma-jam, @shdeb, @shuffle2, @subsonicpulse, @tannewt, @UweBonnes, @YixingShen.
@@ -0,0 +1,216 @@
+# 0.19.0
+
+*October 6, 2025*
+
+## General
+
+### New MCUs and Boards
+
+- Add ESP32-H4, ESP32-C5, ESP32-C61 support
+- Add STM32U0, STM32WBA, STM32N6
+- Add AT32F405, AT32F403A, AT32F415, AT32F423 support
+- Add CH32V305 support and CH32V20x USB host support
+- Add MCXA156 SDK 2.16 support and FRDM-MCXA156 board
+
+## API Changes
+
+### Core APIs
+
+- Add weak callbacks with new syntax for better compiler compatibility
+- Add `tusb_deinit()` to cleanup stack
+- Add time functions: `tusb_time_millis_api()` and `tusb_time_delay_ms_api()`
+- Add `osal_critical` APIs for critical section handling
+- Introduce `xfer_isr()` callback for ISO transfer optimization in device classes
+
+### Device APIs
+
+- CDC: Add notification support `tud_cdc_configure()`, `tud_cdc_n_notify_uart_state()`,
+  `tud_cdc_n_notify_conn_speed_change()`, `tud_cdc_notify_complete_cb()`
+- MSC: Add `tud_msc_inquiry2_cb()` with bufsize parameter, update `tud_msc_async_io_done()`
+  with `in_isr` parameter
+- Audio: Add `tud_audio_n_mounted()` and various FIFO access functions
+- MTP: Add `tud_mtp_mounted()`, `tud_mtp_data_send()`, `tud_mtp_data_receive()`,
+  `tud_mtp_response_send()`, `tud_mtp_event_send()`
+
+### Host APIs
+
+- Core: Add `tuh_edpt_close()`, `tuh_address_set()`, `tuh_descriptor_get_device_local()`,
+  `tuh_descriptor_get_string_langid()`, `tuh_connected()`, `tuh_bus_info_get()`
+- Add enumeration callbacks: `tuh_enum_descriptor_device_cb()`,
+  `tuh_enum_descriptor_configuration_cb()`
+- CDC: Add `tuh_cdc_get_control_line_state_local()`, `tuh_cdc_get/set_dtr/rts()`,
+  `tuh_cdc_connect/disconnect()` and sync versions of all control APIs
+- MIDI: Add `tuh_midi_itf_get_info()`, `tuh_midi_packet_read_n()`,
+  `tuh_midi_packet_write_n()`, `tuh_midi_read_available()`, `tuh_midi_write_flush()`,
+  `tuh_midi_descriptor_cb()`
+
+## Controller Driver (DCD & HCD)
+
+### DWC2
+
+- Support DWC2 v4.30a with improved reset procedure
+- Fix core reset: wait for AHB idle before reset
+- Add STM32 DWC2 data cache support with proper alignment
+- Host improvements:
+  - Fix disconnect detection and SOF flag handling
+  - Fix HFIR timing off-by-one error
+  - Retry IN token immediately for bInterval=1
+  - Proper attach debouncing (200ms)
+  - Fix all retry intervals
+  - Resume OUT transfer when PING ACKed
+- Fix enumeration racing conditions
+- Refactor bitfields for better code generation
+
+### FSDEV (STM32)
+
+- Fix AT32 compile issues after single-buffered endpoint changes
+- Add configurable single-buffered isochronous endpoints
+- Fix STM32H7 recurrent suspend ISR
+- Fix STM32L4 GPIOD clock enable for variants without GPIOD
+- Fix STM32 PHYC PLL stability wait
+- Improve PMA size handling for STM32U0
+
+### EHCI
+
+- Fix removed QHD getting reused
+- Fix NXP USBPHY disconnection detection
+
+### Chipidea/NXP
+
+- Fix race condition with spinlock
+- Improve iMXRT support: fix build, disable BOARD_ConfigMPU, fix attach debouncing on port1 highspeed
+- Fix iMXRT1064 and add to HIL test pool
+
+### MAX3421E
+
+- Use spinlock for thread safety instead of atomic flag
+- Implement `hcd_edpt_close()`
+
+### RP2040
+
+- Fix audio ISO transfer: reset state before notifying stack
+- Fix CMake RTOS cache variable
+- Abort transfer if active in `iso_activate()`
+
+### SAMD
+
+- Add host controller driver support
+
+## Device Stack
+
+### USBD Core
+
+- Introduce `xfer_isr()` callback for interrupt-time transfer handling
+- Add `usbd_edpt_xfer_fifo()` stub
+- Revert endpoint busy/claim status if `xfer_isr()` defers to `xfer_cb()`
+
+### Audio
+
+- Major simplification of UAC driver and alt settings management
+- Move ISO transfers into `xfer_isr()` for better performance
+- Remove FIFO mutex (single producer/consumer optimization)
+- Add implicit feedback support for data IN endpoints
+- Fix alignment issues
+- Update buffer macros with cache line size alignment
+
+### CDC
+
+- Add notification support: `CFG_TUD_CDC_NOTIFY`, `tud_cdc_n_notify_conn_speed_change()`, `tud_cdc_notify_complete_cb()`
+- Reduce default bInterval from 16ms to 1ms for better responsiveness
+- Rename `tud_cdc_configure_fifo()` to `tud_cdc_configure()` and add `tx_overwritable_if_not_connected` option
+- Fix web serial robustness with major overhaul and logic cleanup
+
+### HID
+
+- Add Usage Page and Table for Power Devices (0x84 - 0x85)
+- Fix HID descriptor parser variable size and 4-byte item handling
+- Add consumer page configurations
+
+### MIDI
+
+- Fix MIDI interface descriptor handling after audio streaming interface
+- Skip RX data with all zeroes
+
+### MSC
+
+- Add async I/O support for MSC using `tud_msc_async_io_done()`
+- Add `tud_msc_inquiry2_cb()` with bufsize for full inquiry response
+
+### MTP
+
+- Add new Media Transfer Protocol (MTP) device class driver
+- Support MTP operations: GetDeviceInfo, SendObjectInfo, SendObject
+- Add MTP event support with `tud_mtp_event_send()`
+- Implement filesystem example with callbacks
+- Add hardware-in-the-loop testing support
+
+### NCM
+
+- Add USB NCM link state control support
+- Fix DHCP offer/ACK destination
+
+### USBTMC
+
+- Add vendor-specific message support
+
+### Vendor
+
+- Fix vendor device reset and open issues
+- Fix descriptor parsing for `CFG_TUD_VENDOR > 1`
+- Fix vendor FIFO argument calculation
+
+## Host Stack
+
+### USBH Core
+
+- Major enumeration improvements:
+  - Fix enumeration racing conditions
+  - Add proper attach debouncing with hub/rootport handling (200ms delay)
+  - Reduce `ENUM_DEBOUNCING_DELAY_MS` to 200ms
+  - Always get language ID, manufacturer, product, and serial strings during enumeration
+  - Always get first 2 bytes of string descriptor to determine length (prevents buffer overflow)
+  - Support devices with multiple configurations
+- Add `tuh_enum_descriptor_device_cb()` and `tuh_enum_descriptor_configuration_cb()` callbacks
+- Add `tuh_descriptor_get_string_langid()` API
+- Hub improvements:
+  - Check status before getting first device descriptor
+  - Properly handle port status and change detection
+  - Queue status endpoint for detach/remove events
+  - Fix hub status change endpoint handling
+- Fix endpoint management:
+  - `hcd_edpt_open()` returns false if endpoint already opened
+  - Add `hcd_edpt_close()` implementation
+  - Abort pending transfers on close
+- Add roothub debouncing flag to ignore attach/remove during debouncing
+- Move address setting and bus info management to separate structures
+- Force removed devices in same bus info before setting address
+
+### CDC Serial Host
+
+- Major refactor to generalize CDC serial drivers (FTDI, CP210x, CH34x, PL2303, ACM)
+- Add explicit `sync()` API with `TU_API_SYNC()` returning `tusb_xfer_result_t`
+- Rename `tuh_cdc_get_local_line_coding()` to `tuh_cdc_get_line_coding_local()`
+- Add `tuh_cdc_get_control_line_state_local()`
+- Implement `tuh_cdc_get/set_dtr/rts()` as inline functions
+
+### MIDI Host
+
+- Major API changes:
+  - Rename `tuh_midi_stream_flush()` to `tuh_midi_write_flush()`
+  - Add `tuh_midi_packet_read_n()` and `tuh_midi_packet_write_n()`
+  - Add `CFG_TUH_MIDI_STREAM_API` to opt out of stream API
+  - Change API to use index instead of device address (supports multiple MIDI per device)
+- Rename `tuh_midi_get_num_rx/tx_cables()` to `tuh_midi_get_rx/tx_cable_count()`
+- Add `tuh_midi_descriptor_cb()` and `tuh_midi_itf_get_info()`
+
+### MSC Host
+
+- Continue async I/O improvements
+
+### HID Host
+
+- Fix version string to actually show version
+
+## Contributors
+
+Thanks to everyone who contributed to this release: @andrewleech, @armusin, @atoktoto, @byteit101, @ceedriic, @ChrisDeadman, @Cynventria, @dauc, @Dazza0, @deshipu, @Dolphindalt, @ehughes, @elipsitz, @fenugrec, @hathach, @HiFiPhile, @ho-ho-ho, @igi540, @IngHK, @Isoheptane, @james-advatek, @JannisKonradBecker, @jay94ks, @joelpmichael, @karlp, @kasjer, @ludoux, @majbthrd, @martijnvdwoude, @maximevince, @Milek7, @ning3270455369, @ohmdelta, @peppapighs, @pschatzmann, @PwnVerse, @raldone01, @ReimuNotMoe, @rhgndf, @roundby, @rppicomidi, @s09289728096, @salkinium, @tannewt, @terjr, @tore-espressif, @verylowfreq, @YixingShen, @ZakDanger.
@@ -0,0 +1,88 @@
+# 0.20.0
+
+*November 19, 2025*
+
+## General
+
+### New MCUs and Boards
+
+- Add STM32U3 device support (adjusted from STM32U0)
+- Add nRF54H20 support with initial board configuration
+- Rename board names: pca10056→nrf52840dk, pca10059→nrf52840dongle, pca10095→nrf5340dk
+- Improve CMake: Move startup and linker files from board target to executable. Enhance target warning flags and fix various build warnings
+
+### Code Quality and Static Analysis
+
+- Add PVS-Studio static analysis to CI
+- Add SonarQube scan support
+- Add IAR C-Stat analysis capability
+- Add `.clang-format` for consistent code formatting
+- Fix numerous alerts and warnings found by static analysis tools
+
+### Documentation
+
+- Improve Getting Started documentation structure and flow
+- Add naming conventions and buffer handling documentation
+
+## Controller Driver (DCD & HCD)
+
+### DWC2
+
+- Fix incorrect handling of Zero-Length Packets (ZLP) in the DWC2 driver when receiving data (OUT transfers)
+- Improve EP0 multi-packet logic
+- Support EP0 with max packet size = 8
+- For IN endpoint, write initial packet directly to FIFO and only use TXFE interrupt for subsequent packets
+- Fix ISO with bInterval > 2 using incomplete IN interrupt handling.
+- Fix compile issues when enabling both host and device
+- Clear pending suspend interrupt after USB reset (enum end)
+- Improve host closing endpoint and channel handling when device is unplugged
+
+### FSDEV (STM32)
+
+- Fix AT32 USB interrupt remapping in `dcd_int_enable()`
+
+### OHCI
+
+- Add initial LPC55 OHCI support
+- Improve data cache support
+
+## Device Stack
+
+### USBD Core
+
+- Support configurable EP0 buffer size CFG_TUD_ENDPOINT0_BUFSIZE
+- Make dcd_edpt_iso_alloc/activate as default API for ISO endpoint
+
+### Audio
+
+- Add UAC1 support
+- Implement RX FIFO threshold adjustment with `tud_audio_get/set_ep_in_fifo_threshold()`
+
+### CDC
+
+- Migrate to endpoint stream API
+
+### HID
+
+- Fix HID stylus descriptor
+
+### MIDI
+
+- Migrate to endpoint stream API
+- Add `tud_midi_n_packet_write_n()` and `tud_midi_n_packet_read_n()`
+
+### MTP
+
+- Fix incorrect MTP xact_len calculation
+
+### Video
+
+- Add bufferless operation callback for dynamic frame generation with tud_video_prepare_payload_cb()
+
+## Host Stack
+
+No changes
+
+## Contributors
+
+Thanks to everyone who contributed to this release: @adam-embedded, @ArcaneNibble, @c1570, @embedded-ideas, @gabChouin, @hathach, @HiFiPhile, @karlp, @ldube, @peppapighs, @poornadharshan13-rgb, @RigoLigoRLC, @tangpipi, @ToonVanEyck, @tswan22.
@@ -0,0 +1,182 @@
+# 0.21.0
+
+*June 29, 2026*
+
+## General
+
+### New MCUs and Boards
+
+- Add HPMicro HPM6xxx support with HPM6750EVK2 board
+- Add NXP RW61x (RW612, ChipIdea high-speed) support
+- Add Artery AT32F45x series support
+- Add STM32C5 series support
+- Add Espressif ESP32-S31 (high-speed) support
+- Add WCH CH582/CH583 (USBFS) support
+- Add CH32V103 USB device support (combined-control USBFS) with CH32V103C8T6 Bluepill board
+- Add FreeRTOS support for RP2040/RP2350
+- New boards: nRF54LM20-DK, WeAct STM32H743, EK-TM4C1294XL, STM32H747-DISCO, NUCLEO-H533RE
+- Migrate i.MX RT to the new `mcux-devices-rt` SDK package
+
+### Code Quality and Build
+
+- Major refactor of dedicated hardware-FIFO (HWFIFO) handling: omit per-endpoint RAM buffers on ports with a dedicated hardware FIFO, add stride-aware FIFO access, and store raw bytes in `tusb_fifo`
+- Reduce code size via control/descriptor and stream refactors, and remove `snprintf` usage
+- Remove IAR toolchain support from the Make build; add IAR warning flags and resolve warnings in CMake
+- Fix Zephyr build with nrfx v4, C++/`-Werror=extra` builds, and various `-Wconversion` warnings
+- Update FatFS to R0.16
+- Fix the fuzzing harness
+- Various BSP fixes (STM32H5 UID read with ICACHE, STM32F411 Black Pill HSE, RT1011 data cache, Teensy)
+
+### Documentation
+
+- Add a README for every example and `build-doc` tooling
+- Add Sponsors section and `FUNDING` configuration
+- Various README/doc fixes (FTDI host, STM32C071 Nucleo URL, Supported CPUs table)
+
+## API Changes
+
+- Add `is_isr` parameter to `dcd_edpt_xfer`, `dcd_edpt_xfer_fifo`, `usbd_edpt_xfer` and `usbd_edpt_xfer_fifo`
+- Remove the no-FIFO mode from the endpoint stream API
+- Add `tud_vendor_write_clear()` to forcefully clear the TX buffer
+- Add `tud_midi_n_demux_stream_read()` cable-aware MIDI stream read
+- Add `CFG_TUH_HID_SET_PROTOCOL_ON_ENUM` host HID option
+- Add `CFG_TUSB_DEBUG_BREAKPOINT` hook for `TU_BREAKPOINT`
+- Add ThreadX OSAL support
+- `tud_task_ext()` / `tuh_task_ext()` now limit the number of events processed per call
+- Replace `CFG_TUD_NET_ENDPOINT_SIZE` with the descriptor-based endpoint size
+
+## Device Stack
+
+### USBD Core
+
+- Refactor and validate device descriptor handling; move control transfer handling into `usbd.c`
+- Use the EP0 buffer directly when large enough; clamp EP0 OUT data copy to the control buffer
+- Fix stream write logic/racing without FIFO; fix zero `wLength` control request
+- Fix ISO OUT endpoint failure on alt-setting MPS change
+
+### Audio
+
+- Fix `audiod_open` with MIDI interfaces
+- Fix big-endian bitfield guards for audio structs and endian-safe `wValue`/`wIndex` extraction in UAC2 examples
+
+### CDC
+
+- Remove `tud_cdc_configure`
+- Fix CDC echo test issue on i.MX RT and fast MCUs
+
+### HID
+
+- Bound item size to remaining length in the report-descriptor parser
+- Remove host enumeration assumption; add `CFG_TUH_HID_SET_PROTOCOL_ON_ENUM`
+
+### MIDI
+
+- Add USB-MIDI 2.0 device and host class drivers
+- Add cable-aware stream read `tud_midi_n_demux_stream_read()`
+- Fix MIDI host issue
+
+### MSC
+
+- Skip the command stage if the OUT endpoint is stalled
+- Cap `tud_msc_scsi_cb` buffer size to the endpoint buffer size
+
+### MTP
+
+- Fix transfer completion detection for exact-length packets; queue ZLP when needed
+- Fix premature phase change after a short OUT transfer; fixes in `add_string`
+
+### Network (NCM)
+
+- Fix NCM state on restart
+- Support `SetEthernetPacketFilter` and `SetNtbInputSize` requests
+- Add a weak callback for the initial link state
+
+### Video (UVC)
+
+- Fix VC interface parsing when `bNumEndpoints` != 0
+- Assert the `usbd_edpt_iso_activate()` result
+
+### DFU
+
+- Fix the DFU functional descriptor version (1.0.1 → 1.1.0)
+
+### Printer
+
+- Add the USB Printer device class driver
+
+### Vendor
+
+- Omit the endpoint buffer for ports with a dedicated hardware FIFO
+
+## Host Stack
+
+- Fully asynchronous host code: remove blocking delays from `tuh_task_ext()`, respect its `timeout_ms`, and avoid stalling one device while another enumerates
+- Add an async control-transfer FIFO so queued control transfers are dispatched instead of dropped
+- Hub enumeration reliability improvements; add MTT hub support
+- Support full-speed host with a high-speed PHY (DWC2)
+- Fix FTDI host multi-channel loop
+- CDC host: use a local control buffer; fix `cdch_open` typo
+- Big-endian host support for SETUP packet handling
+- Use `TUSB_ROLE_HOST` in host stack initialization
+
+## Controller Driver (DCD & HCD)
+
+### DWC2
+
+- Add `dcd_configure` for FIFO config and DWC2 deinit support
+- Support full-speed host operation on a high-speed PHY
+- Vbus sensing enhancement; do not modify FS PHY registers on HS PHY (ESP32-P4)
+- Fix HCD TX FIFO full check, ISO IN endpoint disabled after incomplete transfer, and EP0 status completion before SETUP
+- Submit SETUP on SETUP_DONE and handle v3.10a spurious RX_COMPLETE (STM32L476)
+- HCD: correct HFIR for low-speed devices via internal FS PHY; fix split-IN NAK storm and UART starvation (STM32F723)
+
+### FSDEV (STM32 / CH32)
+
+- Add FSDEV host (HCD) driver
+- Refactor FSDEV; share the PMA errata delay helper between DCD/HCD with overridable timing
+- Fix single-buffered isochronous endpoint cases, STM32U0 data stride, and PMA pointer advance on ring-buffer wrap
+- Fix CH32V20x enumeration by enabling the D+ pull-up; work around CH32 EP0 premature OUT ACK
+- Do not enable the unused USB wakeup EXTI IRQ (F1/F3/G4/L1)
+
+### MUSB
+
+- Enhance driver: double packet, EP0 refactor, fix DATAEND race with EP0
+- Fix ZLP IN transfer, RXRDY clearing, and defer EP0 SETUP during the DATA_IN/STATUS race
+
+### RP2040 / RP2350
+
+- Refactor RP2 driver
+- HCD rework: EPX for non-interrupt endpoints and ping-pong double buffering
+- Fix RP2350 hard fault in unaligned memcpy to USB DPRAM
+- Host: fix OUT-data control transfers sending DATA0 instead of DATA1
+
+### CH32 USBFS / USBHS (WCH)
+
+- Fix dropped bulk OUT packets by re-arming the EP_RX_CTRL state (usbfs)
+- Fix endpoint stall length index and clear-stall response (usbhs)
+- Fix CH32V103 hard fault
+
+### RUSB2 / SAMx7x
+
+- Fix RUSB2 FIFO write
+- Refresh `dcd_samx7x`
+
+### New host controllers
+
+- Add NXP IP3516 HCD (EHCI-like)
+- Add MTT (multi-TT) hub support
+
+### nRF5x
+
+- Request HFCLK in `USB_EVT_READY` to fix the post-SoftDevice deadlock
+
+## Testing
+
+- Expand Hardware-in-the-Loop (HIL) coverage (MTP, audio, throughput; nanoch32v203, ch32v103, stm32u083nucleo, tm4c123x) and post pass/fail/skip HIL reports as PR comments
+- Add MemBrowse code-size CI integration and size-difference reporting
+- Add automated Claude Code PR review and bug-fix CI workflows
+- Add `hil`, `code-size`, `pvs`, `usbmon` and `build-doc` developer skills
+
+## Contributors
+
+Thanks to everyone who contributed to this release: @Alex-Schaefer, @alt-0191, @andrewleech, @armusin, @bdolgov, @BrentK-ADI, @ceedriic, @chenzhihong007, @dangfan, @DavidKorczynski, @dinsfire64, @dxbjavid, @embedded-ideas, @felhub, @gab-k, @gabChouin, @HakanL, @hathach, @HiFiPhile, @igi540, @IntegraSources, @kira-live, @LeZerb, @michael-membrowse, @michaelajax, @mickabrig7, @Milek7, @morse-cedricvandenbergh, @nminaylov, @non-bin, @Phozer, @remiberthoz, @renjieah, @rhgndf, @RobertDaleSmith, @roma-jam, @sauloverissimo, @sgrunza-at-BadgerMeter, @sidcha, @StefanOroel, @Tails86, @thamul, @tore-espressif, @UMRnInside, @ValentiWorkLearning, @verylowfreq, @wjklimek1, @YixingShen, @zhiqiang-ch, @zjzhang-cn.
@@ -0,0 +1,13 @@
+# 0.5.0
+
+*July 11, 2019*
+
+First release, device stack works great, host stack works but still need improvement.
+
+- Special thanks to @adafruit team, especially @tannewt to help out immensely to rework device stack: simplify osal & control transfer, adding SAMD21/SAMD51 ports, writing porting docs, adding MIDI class support etc...
+- Thanks to @cr1901 for adding STM32F4 port.
+- Thanks to @PTS93 and @todbot for HID raw API
+
+## Contributors
+
+Thanks to everyone who contributed to this release: @cr1901, @gpshead, @hathach, @mithro, @tannewt, @timonsku, @zardam.
@@ -0,0 +1,63 @@
+# 0.6.0
+
+*March 30, 2020*
+
+Added **CONTRIBUTORS.md** to give proper credit for contributors to the stack. Special thanks to [Nathan Conrad](https://github.com/pigrew) , [Peter Lawrence](https://github.com/majbthrd) , [William D. Jones](https://github.com/cr1901) and [Sean Cross](https://github.com/xobs) and others for spending their precious time to add lots of features and ports for this release.
+
+## Added
+
+### MCU
+
+- Added support for Microchip SAMG55
+- Added support for Nordic nRF52833
+- Added support for Nuvoton: NUC120, NUC121/NUC125, NUC126, NUC505
+- Added support for NXP LPC: 51Uxx, 54xxx, 55xx
+- Added support for NXP iMXRT: RT1011, RT1015, RT1021, RT1052, RT1062, RT1064
+- Added support for Sony CXD56 (Spresense)
+- Added support for STM32: L0, F0, F1, F2, F3, F4, F7, H7
+- Added support for TI MSP430
+- Added support for ValentyUSB's eptri
+
+### Class Driver
+
+- Added DFU Runtime class driver
+- Added Network class driver with RNDIS, CDC-ECM, CDC-EEM (work in progress)
+- Added USBTMC class driver
+- Added WebUSB class driver using vendor-specific class
+- Added multiple instances support for CDC and MIDI
+- Added a handful of unit test with Ceedling.
+- Added LOG support for debugging with CFG_TUSB_DEBUG
+- Added `tud_descriptor_bos_cb()` for BOS descriptor (required for USB 2.1)
+- Added `dcd_edpt0_status_complete()` as optional API for DCD
+
+### Examples
+
+Following examples are added:
+
+- `board_test`
+- `cdc_dual_ports`
+- `dfu_rt`
+- `hid_composite`
+- `net_lwip_webserver`
+- `usbtmc`
+- `webusb_serial`
+
+## Changed
+
+- Changed `tud_descriptor_string_cb()` to have additional Language ID argument
+- Merged `hal_nrf5x.c` into `dcd_nrf5x.c`
+- Merged `dcd_samd21.c` and `dcd_samd51.c` into `dcd_samd.c`
+- Generalized `dcd_stm32f4.c` to `dcd_synopsys.c`
+- Changed `cdc_msc_hid` to `cdc_msc` (drop hid) due to limited endpoints number of some MCUs
+- Improved DCD SAMD stability, fix missing setup packet occasionally
+- Improved `usbd/usbd_control` with proper handling of zero-length packet (ZLP)
+- Improved STM32 DCD FSDev
+- Improved STM32 DCD Synopsys
+- Migrated CI from Travis to Github Action
+- Updated nrfx submodule to 2.1.0
+- Fixed mynewt osal queue definition
+- Fixed `cdc_msc_freertos` example build for all MCUs
+
+## Contributors
+
+Thanks to everyone who contributed to this release: @an-dr, @arturo182, @chang196700, @cr1901, @hathach, @jepler, @jeremyherbert, @kamtom480, @kasjer, @ladyada, @majbthrd, @mateusz-holenko, @noebrun, @nxf58843, @pigrew, @samveen, @smunaut, @tannewt, @xobs.
@@ -0,0 +1,136 @@
+# 0.7.0
+
+*November 7, 2020*
+
+## Device Controller Driver
+
+- Added new support for Espressif ESP32-S2
+- Added new support for Dialog DA1469x
+- Enhance STM32 Synopsys
+- Support bus events disconnection/suspend/resume/wakeup
+- Improve transfer performance with optimizing xfer and fifo size
+- Support Highspeed port (OTG_HS) with both internal and external PHY
+- Support multiple usb ports with rhport=1 is highspeed on selected MCUs e.g H743, F23. It is possible to have OTG_HS to run on Fullspeed PHY (e.g lacking external PHY)
+- Add ISO transfer, fix odd/even frame
+- Fix FIFO flush during stall
+- Implement `dcd_edpt_close()` API
+- Support F105, F107
+
+### Enhance STM32 fsdev
+
+- Improve dcd fifo allocation
+- Fix ISTR race condition
+- Support remap USB IRQ on supported MCUs
+- Implement `dcd_edpt_close()` API
+
+### Enhance NUC 505
+
+- enhance set configure behavior
+
+### Enhance SAMD
+
+- Fix race condition with setup packet
+- Add SAMD11 option `OPT_MCU_SAMD11`
+- Add SAME5x option `OPT_MCU_SAME5X`
+
+### SAMG
+
+- Fix SAMG control data toggle and stall race condition
+
+### Enhance nRF
+
+- Fix hanged when `tud_task()` is called within critical section (disabled interrupt)
+- Fix disconnect bus event not submitted
+- Implement ISO transfer and `dcd_edpt_close()`
+
+## USB Device
+
+### USBD
+
+- Add new class driver for **Bluetooth HCI** class driver with example can be found in [mynewt-tinyusb-example](https://github.com/hathach/mynewt-tinyusb-example) since it needs mynewt OS to run with.
+- Fix USBD endpoint usage racing condition with `usbd_edpt_claim()`/`usbd_edpt_release()`
+- Added `tud_task_event_ready()` and `osal_queue_empty()`. This API is needed to check before enter low power mode with WFI/WFE
+- Rename USB IRQ Handler to `dcd_int_handler()`. Application must define IRQ handler in which it calls this API.
+- Add `dcd_connect()` and `dcd_disconnect()` to enable/disable internal pullup on D+/D- on supported MCUs.
+- Add `usbd_edpt_open()`
+- Remove `dcd_set_config()`
+- Add `OPT_OS_CUMSTOM` as hook for application to overwrite and/or add their own OS implementation
+- Support SET_INTERFACE, GET_INTERFACE request
+- Add Logging for debug with optional uart/rtt/swo printf retarget or `CFG_TUSB_DEBUG_PRINTF` hook
+- Add IAR compiler support
+- Support multiple configuration descriptors. `TUD_CONFIG_DESCRIPTOR()` template has extra config_num as 1st argument
+- Improve USB Highspeed support with actual link speed detection with `dcd_event_bus_reset()`
+- Enhance class driver management
+  - `usbd_driver_open()` add max length argument, and return length of interface (0 for not supported). Return value is used for finding appropriate driver
+  - Add application implemented class driver via `usbd_app_driver_get_cb()`
+  - IAD is handled to assign driver id
+- Added `tud_descriptor_device_qualifier_cb()` callback
+- Optimize `tu_fifo` bulk write/read transfer
+- Forward non-std control request to class driver
+- Let application handle Microsoft OS 1.0 Descriptors (the 0xEE index string)
+- Fix OSAL FreeRTOS yield from ISR
+- Rename some configure macro to make it clear that those are used directly for endpoint transfer
+  - `CFG_TUD_HID_BUFSIZE` to `CFG_TUD_HID_EP_BUFSIZE`
+  - `CFG_TUD_CDC_EPSIZE` to `CFG_TUD_CDC_EP_BUFSIZE`
+  - `CFG_TUD_MSC_BUFSIZE` to `CFG_TUD_MSC_EP_BUFSIZE`
+  - `CFG_TUD_MIDI_EPSIZE` to `CFG_TUD_MIDI_EP_BUFSIZE`
+
+### USBNET
+
+- Remove ACM-EEM due to lack of support from host
+
+### USBTMC
+
+- Fix descriptors when INT EP is disabled
+
+### CDC
+
+- Send zero length packet for end of data when needed
+- Add `tud_cdc_tx_complete_cb()` callback
+- Change `tud_cdc_n_write_flush()` return number of bytes forced to transfer, and flush when writing enough data to fifo
+
+### MIDI
+
+- Add packet interface
+- Add multiple jack descriptors
+- Fix MIDI driver for sysex
+
+### DFU Runtime
+
+- fix response to SET_INTERFACE and DFU_GETSTATUS request
+
+### HID
+
+- Fix gamepad template descriptor
+- Add multiple HID interface API
+- Add extra comma to HID_REPORT_ID
+
+## USB Host
+
+- Rework USB host stack (still work in progress)
+   - Fix compile error with pipehandle
+   - Rework usbh control and enumeration as non-blocking
+
+- Improve Hub, MSC, HID host driver
+
+## Examples
+
+- Add new `hid_composite_freertos`
+- Add new `dynamic_configuration` to demonstrate how to switch configuration descriptors
+- Add new `hid_multiple_interface`
+- Enhance `net_lwip_webserver` example
+  - Add multiple configuration: RNDIS for Windows, CDC-ECM for macOS (Linux will work with both)
+  - Update lwip to STABLE-2_1_2_RELEASE for `net_lwip_webserver`
+- Added new Audio example: `audio_test` `uac2_headsest`
+
+## New Boards
+
+- Espressif ESP32-S2: saola_1, kaluga_1
+- STM32: F746 Nucleo, H743 Eval, H743 Nucleo, F723 discovery, stlink v3 mini, STM32L4r5 Nucleo
+- Dialog DA1469x dk pro and dk usb
+- Microchip: Great Scoot Gadgets' LUNA, samd11_xplained, D5035-01, atsamd21 xplained pro
+- nRF: ItsyBitsy nRF52840
+
+## Contributors
+
+Thanks to everyone who contributed to this release: @chang196700, @CraigHutchinson, @czeslawmakarski, @duempel, @gh2o, @hathach, @HiFiPhile, @j4cbo, @jepler, @jgressmann, @k0d, @kasjer, @kaysievers, @ktemkin, @majbthrd, @me-no-dev, @mzero, @PanRe, @pigrew, @salkinium, @UweBonnes, @xobs, @zlittell.
@@ -0,0 +1,84 @@
+# 0.8.0
+
+*February 5, 2021*
+
+## Device Controller Driver
+
+- Added new device support for Raspberry Pi RP2040
+- Added new device support for NXP Kinetis KL25ZXX
+- Use `dcd_event_bus_reset()` with link speed to replace bus_signal
+
+### ESP32-S2
+
+- Add bus suspend and wakeup support
+
+### SAMD21
+
+- Fix (workaround) samd21 setup_packet overflow by USB DMA
+
+### STM32 Synopsys
+
+- Rework USB FIFO allocation scheme and allow RX FIFO size reduction
+
+### Sony CXD56
+
+- Update Spresense SDK to 2.0.2
+- Fix dcd issues with setup packets
+- Correct EP number for cdc_msc example
+
+## USB Device
+
+### USBD
+
+- Rework usbd control transfer to have additional stage parameter for setup, data, status
+- Fix `tusb_init()` return true instead of `TUSB_ERROR_NONE`
+- Added new API `tud_connected()` that return true after device got out of bus reset and received the very first setup packet
+
+### CDC
+
+- Allow to transmit data, even if the host does not support control line states i.e set DTR
+
+### HID
+
+- change default `CFG_TUD_HID_EP_BUFSIZE` from 16 to 64
+
+### MIDI
+
+- Fix midi sysex sending bug
+
+### MSC
+
+- Invoke only scsi complete callback after status transaction is complete.
+- Fix `scsi_mode_sense6_t` padding, which cause IAR compiler internal error.
+
+### USBTMC
+
+- Change interrupt endpoint example size to 8 instead of 2 for better compatibility with mcu
+
+### Example
+
+- Support make from windows `cmd.exe`
+- Add HID Consumer Control (media keys) to `hid_composite` & `hid_composite_freertos` examples
+
+## USB Host
+
+No noticeable changes to host stack
+
+## New Boards
+
+- NXP/Freescale Freedom FRDM-KL25Z
+- Feather Double M33 express
+- Raspberry Pi Pico
+- Adafruit Feather RP2040
+- Adafruit Itsy Bitsy RP2040
+- Adafruit QT RP2040
+- Adfruit Feather ESP32-S2
+- Adafruit Magtag 29" Eink
+- Adafruit Metro ESP32-S2
+- Adafruit PyBadge
+- Adafruit PyPortal
+- Great Scott Gadgets' LUNA D11 & D21
+
+## Contributors
+
+Thanks to everyone who contributed to this release: @aslampr07, @charkster, @dobairoland, @duempel, @gsteiert, @hathach, @HiFiPhile, @kamtom480, @kkitayam, @ktemkin, @majbthrd, @PanRe, @prplz.
@@ -0,0 +1,108 @@
+# 0.9.0
+
+*March 12, 2021*
+
+## Device Controller Driver (DCD)
+
+### RP2040
+
+- Fix endpoint buffer reallocation overrun problem
+- Fix osal_pico queue overflow in initialization
+- Fix Isochronous endpoint buffer size in transfer
+- Optimize hardware endpoint struct to reduce RAM usage
+- Fix enum workaround forever check for SE0 when pull up is disabled
+
+### Sony CXD56
+
+- Pass the correct speed on Spresense
+- Fix setup processed flag
+
+### NXP Transdimention
+
+- Update dcd_init() to reset controller to device mode
+
+## USB Device Driver (USBD)
+
+- Fix issue with status zlp (`tud_control_status()`) is returned by class driver with SET/CLEAR_FEATURE for endpoint.
+- Correct endpoint size check for fullspeed bulk, can be 8, 16, 32, 64
+- Ack SET_INTERFACE even if it is not implemented by class driver.
+
+## Device Class Driver
+
+### DFU Runtime
+
+- rename `dfu_rt()` to `dfu_runtime()` for easy reading
+
+### CDC
+
+- Add `tud_cdc_send_break_cb()` to support break request
+- Improve CDC receive, minor behavior changes: when `tud_cdc_rx_wanted_cb()` is invoked wanted_char may not be the last byte in the fifo
+
+### HID
+
+- [Breaking] Add itf argument to hid API to support multiple instances, follow API has signature changes
+
+  - `tud_hid_descriptor_report_cb()`
+  - `tud_hid_get_report_cb()`
+  - `tud_hid_set_report_cb()`
+  - `tud_hid_boot_mode_cb()`
+  - `tud_hid_set_idle_cb()`
+
+- Add report complete callback `tud_hid_report_complete_cb()` API
+- Add DPad/Hat support for HID Gamepad
+
+  - `TUD_HID_REPORT_DESC_GAMEPAD()` now support 16 buttons, 2 joysticks, 1 hat/dpad
+  - Add `hid_gamepad_report_t` along with `GAMEPAD_BUTTON_` and `GAMEPAD_HAT_` enum
+  - Add Gamepad to `hid_composite` / `hid_composite_freertos` example
+
+### MIDI
+
+- Fix dropping MIDI sysex message when fifo is full
+- Fix typo in `tud_midi_write24()`, make example less ambiguous for cable and channel
+- Fix incorrect endpoint descriptor length, MIDI v1 use Audio v1 which has 9-byte endpoint descriptor (instead of 7)
+
+## Host Controller Driver (HCD)
+
+- Add rhport to `hcd_init()`
+- Improve EHCI/OHCI driver abstraction
+
+  - Move echi/ohci files to portable/
+  - Rename `hcd_lpc18_43` to `hcd_transdimension`
+  - Sub hcd API with `hcd_ehci_init()`, `hcd_ehci_register_addr()`
+
+- Update NXP transdimension `hcd_init()` to reset controller to host mode
+
+  - Ported hcd to rt10xx
+
+## USB Host Driver (USBH)
+
+- No noticeable changes to usbh
+
+## Host Class Driver
+
+### MSC
+
+- Rename `tuh_msc_scsi_inquiry()` to `tuh_msc_inquiry()`
+- Rename `tuh_msc_mounted_cb()`/`tuh_msc_unmounted_cb()` to `tuh_msc_mount_cb()`/`tuh_msc_unmount_cb()` to match device stack naming
+- Change `tuh_msc_is_busy()` to `tuh_msc_ready()`
+- Add read10 and write10 function: `tuh_msc_read10()`, `tuh_msc_write10()`
+- Read_Capacity is invoked as part of enumeration process
+- Add `tuh_msc_get_block_count()`, `tuh_msc_get_block_size()`
+- Add `CFG_TUH_MSC_MAXLUN` (default to 4) to hold lun capacities
+
+## Others
+
+- Add basic support for rt-thread OS
+- Change zero bitfield length to more explicit padding
+- Build example now fetch required submodules on the fly while running `make` without prior submodule init for mcu drivers
+- Update pico-sdk to v1.1.0
+
+### New Boards
+
+- Microchip SAM E54 Xplained Pro
+- LPCXpresso 55s28
+- LPCXpresso 18s37
+
+## Contributors
+
+Thanks to everyone who contributed to this release: @amitv87, @duddie, @hathach, @HiFiPhile, @homeodor, @ipopov, @jgressmann, @kamtom480, @liamfraser, @lurch, @majbthrd, @ndinsmore, @tfx2001, @xmos-jmccarthy.
@@ -0,0 +1,27 @@
+*********
+Changelog
+*********
+
+Release notes for each TinyUSB version, newest first.
+
+.. toctree::
+   :maxdepth: 1
+
+   0.21.0
+   0.20.0
+   0.19.0
+   0.18.0
+   0.17.0
+   0.16.0
+   0.15.0
+   0.14.0
+   0.13.0
+   0.12.0
+   0.11.0
+   0.10.1
+   0.10.0
+   0.9.0
+   0.8.0
+   0.7.0
+   0.6.0
+   0.5.0