diff options
Diffstat (limited to 'docs/changelog/0.19.0.md')
| -rw-r--r-- | docs/changelog/0.19.0.md | 216 |
1 files changed, 216 insertions, 0 deletions
diff --git a/docs/changelog/0.19.0.md b/docs/changelog/0.19.0.md new file mode 100644 index 000000000..d3e73db22 --- /dev/null +++ b/docs/changelog/0.19.0.md @@ -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. |
