docs: convert changelog release notes from RST to Markdown (#3746)

* docs: convert changelog release notes from RST to Markdown
This commit is contained in:
Ha Thach
2026-06-30 22:27:27 +07:00
committed by GitHub
parent 188b998929
commit dae3f9a366
25 changed files with 842 additions and 1061 deletions

View File

@ -19,7 +19,7 @@ Gotchas: `gen_doc` needs `pandas`+`tabulate` (not in requirements) → `pip inst
## 2. Changelog — `docs/changelog/` (the hard part)
New file `docs/changelog/X.Y.Z.rst`, listed **first** in `docs/changelog/index.rst`. Get the PR set by **commit reachability, not merge date** (a date query wrongly pulls in the prior release's changelog PR at the boundary):
New file `docs/changelog/X.Y.Z.md`, listed **first** in `docs/changelog/index.rst`. Get the PR set by **commit reachability, not merge date** (a date query wrongly pulls in the prior release's changelog PR at the boundary):
```bash
PREV=0.20.0
@ -33,10 +33,10 @@ xargs -P8 -I{} gh pr view {} --json number,title,labels \
```
`--first-parent` skips dev-merges; the two `sed`s catch merge-button + squash. A PR merged into a *feature branch* folds into its parent (won't appear alone) — reflect its final state in the parent's bullet.
**Curate** into the prior file's exact RST style:
- Title = version (`======` underline), then italic date (ask if unknown). Add to top of `index.rst`.
- Section order: **General** (New MCUs and Boards / Code Quality and Build / Documentation) → **API Changes****Device Stack** (per class) → **Host Stack****Controller Driver (DCD & HCD)** (per driver) → **Testing****Contributors**. Each class/driver group is a ``^^^`` sub-heading, not a bullet.
- Double-backticks for symbols; group related PRs into one bullet (don't dump). `Port *`/driver labels help bucket DCD/HCD.
**Curate** into the prior file's exact Markdown (MyST) style:
- Title = version (`# X.Y.Z`), then italic date (ask if unknown). Add to top of `index.rst`.
- Section order: **General** (New MCUs and Boards / Code Quality and Build / Documentation) → **API Changes****Device Stack** (per class) → **Host Stack****Controller Driver (DCD & HCD)** (per driver) → **Testing****Contributors**. Sections are `##`; each class/driver group is a `###` sub-heading, not a bullet.
- Single backticks for symbols; group related PRs into one bullet (don't dump). `Port *`/driver labels help bucket DCD/HCD.
- **Contributors**: unique non-bot PR authors, alphabetical (the only contributor credit — no separate page):
```bash
xargs -P8 -I{} gh pr view {} --json author --jq '.author.login' < /tmp/prs.txt \
@ -46,7 +46,7 @@ xargs -P8 -I{} gh pr view {} --json number,title,labels \
## 3. Validate (leave unstaged)
```bash
pre-commit run --files docs/changelog/X.Y.Z.rst docs/changelog/index.rst \
pre-commit run --files docs/changelog/X.Y.Z.md docs/changelog/index.rst \
docs/reference/boards.rst docs/reference/dependencies.rst \
library.json repository.yml sonar-project.properties src/tusb_option.h tools/make_release.py
python3 tools/build_doc.py -c # docs build clean (see build-doc skill)

View File

@ -1,15 +1,13 @@
0.10.0
======
# 0.10.0
*2021-05-28*
*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)
------------------------------
## 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
@ -17,67 +15,57 @@ Device Controller Driver (DCD)
- 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
- 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)
------------------------
## USB Device Driver (USBD)
- Add new (optional) endpoint ADPI ``usbd_edpt_xfer_fifo()``
- Add new (optional) endpoint ADPI `usbd_edpt_xfer_fifo()`
Device Class Driver
-------------------
## Device Class Driver
CDC
^^^
### CDC
- [Breaking] ``tud_cdc_peek()``, ``tud_vendor_peek()`` no longer support random offset and dropped position parameter.
- [Breaking] `tud_cdc_peek()`, `tud_vendor_peek()` no longer support random offset and dropped position parameter.
DFU
^^^
### DFU
- Add new DFU 1.1 class driver (WIP)
HID
^^^
### 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()``
- `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
^^^^
### 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()``
- 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)
----------------------------
## Host Controller Driver (HCD)
- No noticeable changes
USB Host Driver (USBH)
----------------------
## USB Host Driver (USBH)
- No noticeable changes
Host Class Driver
-----------------
## Host Class Driver
- HID: Rework host hid driver, basically everything changes
Contributors
------------
## 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.

17
docs/changelog/0.10.1.md Normal file
View File

@ -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.

View File

@ -1,20 +0,0 @@
0.10.1
======
*2021-06-03*
- 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.

View File

@ -1,14 +1,12 @@
0.11.0
======
# 0.11.0
*2021-08-29*
*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)
------------------------------
## Device Controller Driver (DCD)
- Add new DCD port for SAMx7x (E70, S70, V70, V71)
- Add new mcu K32L2Bxx
@ -20,88 +18,73 @@ Device Controller Driver (DCD)
- Add Suspend/Resume handling for Renesas RX family.
- Fix DA1469x no VBUS startup
Synopsys
^^^^^^^^
### Synopsys
- Fix Synopsys set address bug which could cause re-enumeration failed
- Fix ``dcd_synopsys`` driver integer overflow in HS mode (issue #968)
- Fix `dcd_synopsys` driver integer overflow in HS mode (issue #968)
nRF5x
^^^^^
### nRF5x
- Add nRF5x suspend, resume and remote wakeup
- Fix nRF5x race condition with ``TASKS_EP0RCVOUT``
- Fix nRF5x race condition with `TASKS_EP0RCVOUT`
RP2040
^^^^^^
### 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
------------
## Device Stack
USBD
^^^^
### 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
- 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
^^^^^^^^^
### Bluetooth
- Fix stridx error in descriptor template
DFU
^^^
### DFU
- Enhance DFU implementation to support multiple alternate interface and better support ``bwPollTimeout``
- Rename ``CFG_TUD_DFU_MODE`` to simply ``CFG_TUD_DFU``
- Enhance DFU implementation to support multiple alternate interface and better support `bwPollTimeout`
- Rename `CFG_TUD_DFU_MODE` to simply `CFG_TUD_DFU`
HID
^^^
### HID
- Fix newline usage keyboard (ENTER 0x28)
- Better support Hid Get/Set report
- Change max gamepad support from 16 to 32 buttons
MIDI
^^^^
### MIDI
- Fix midi available
- Fix midi data
- Fix an issue when calling midi API when not enumerated yet
UAC2
^^^^
### UAC2
- Fix bug and enhance of UAC2
Vendor
^^^^^^
### Vendor
- Fix vendor fifo deadlock in certain case
- Add ``tud_vendor_n_read_flush()``
- Add `tud_vendor_n_read_flush()`
Host Controller Driver (HCD)
----------------------------
## Host Controller Driver (HCD)
RP2040
^^^^^^
### RP2040
- Implement double buffered to fix E4 errata and boost performance
- Lots of rp2040 update and enhancement
Host Stack
----------
## 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
- Separate `CFG_TUH_DEVICE_MAX` and `CFG_TUH_HUB` for better management and reduce SRAM usage
Contributors
------------
## 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.

View File

@ -1,35 +1,31 @@
0.12.0
======
# 0.12.0
- add ``CFG_TUSB_OS_INC_PATH`` for os include path
*October 19, 2021*
Device Controller Driver (DCD)
------------------------------
- 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.
- 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
------------
## 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 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)
----------------------------
## Host Controller Driver (HCD)
No notable changes
Host Stack
----------
## Host Stack
No notable changes
Contributors
------------
## Contributors
Thanks to everyone who contributed to this release: @Daft-Freak, @dshadoff, @hansfbaier, @hathach, @HiFiPhile, @kamtom480, @kasjer, @kkitayam, @majbthrd, @szymonh, @unlimitedcodeworks.

View File

@ -1,10 +1,10 @@
0.13.0
======
# 0.13.0
- [tu_fifo] Fix locked mutex when full, and return type in ``peek_n()``
*February 23, 2022*
Controller Driver (DCD & HCD)
-----------------------------
- [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.
@ -27,19 +27,16 @@ Controller Driver (DCD & HCD)
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
------------
## 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)
- [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
----------
## Host Stack
No notable changes
Contributors
------------
## 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.

85
docs/changelog/0.14.0.md Normal file
View File

@ -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.

View File

@ -1,79 +0,0 @@
0.14.0
======
- 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(rphort)``, ``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.

View File

@ -1,86 +1,88 @@
0.15.0
======
# 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
- [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)
-----------------------------
## Controller Driver (DCD & HCD)
- Add new port support (WIP) for WCH CH32V307 USB Highspeed
- Add new port support (WIP) for PIC32MM/MX & PIC24
nRF
^^^
### nRF
- Fix endpoint internal state when closed
- Fix reception of large ISO packets
rp2040
^^^^^^
### 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] 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
### samd
Device Stack
------------
- [dcd] Add support for ISO endpoint
Video
^^^^^
### 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
^^^^
### MIDI
- Support port name strings
- fix MS Header wTotalLength computation
HID
^^^
### HID
- Add FIDO descriptor template
- change length in ``tud_hid_report_complete_cb()`` from ``uint8_t`` to ``uint16_t``
- change length in `tud_hid_report_complete_cb()` from `uint8_t` to `uint16_t`
CDC
^^^
### 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
- 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
### USBTMC
Host Stack
----------
- 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
- [MSC] Rework host mass storage API. Add new `host/msc_file_explorer` example
CDC
^^^
### CDC
- Add support for host cdc
- Fix host cdc with device without IAD e.g Arduino Due
Contributors
------------
## 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.

View File

@ -1,5 +1,6 @@
0.16.0
======
# 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
@ -7,18 +8,16 @@
- 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
- [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)
-----------------------------
## Controller Driver (DCD & HCD)
- Add new ISO endpoint API: ``dcd_edpt_iso_alloc()`` and ``dcd_edpt_iso_activate()``
- Add new ISO endpoint API: `dcd_edpt_iso_alloc()` and `dcd_edpt_iso_activate()`
- Remove legacy driver st/synopsys
EHCI
^^^^
### EHCI
- [iMXRT] Add dache clean/invalidate when memory is in cacheable memory
- Fix portsc write issue which cause problem with enumeration
@ -28,50 +27,43 @@ EHCI
- 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()``
- 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
- 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
^^^^^^^^^^^^^^^^^^
### 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
^^^^^^^^^^^^^^^^^^
### ChipIdea Fullspeed
- Generalize ChipIdea Fullspeed driver for mcxn9 (port 0), kinetis
nrf
^^^
### nrf
- Fix DMA race condition with ISO OUT transfer #1946
- Add support for nRF5340 with pca10095 board
Renesas rusb2
^^^^^^^^^^^^^
### 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
^^^^^^
### rp2040
- [dcd] Make writes to SIE_CTRL aware of concurrent access
- [hcd] add ``hcd_frame_number()``, ``hcd_edpt_abort_xfer()`` for pio-usb host
- [hcd] add `hcd_frame_number()`, `hcd_edpt_abort_xfer()` for pio-usb host
stm32 fsdev
^^^^^^^^^^^
### stm32 fsdev
- Add STM32L5 support
- Implement ``dcd_edpt_iso_alloc()`` and ``dcd_edpt_iso_activate()``
- Implement `dcd_edpt_iso_alloc()` and `dcd_edpt_iso_activate()`
OHCI
^^^^
### 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)
@ -80,86 +72,77 @@ OHCI
- Fix issue when removing queue head
- Disable MIE during IRQ processing and clear HccaDoneHead on completion as per OCHI Spec Page 80
Device Stack
------------
## Device Stack
- Add optional hooks ``tud_event_hook_cb()``
- Add optional hooks `tud_event_hook_cb()`
Audio (UAC2)
^^^^^^^^^^^^
### Audio (UAC2)
- Fix feedback EP buffer alignment.
- Fix encoding, update example
- Improve IN transfer
Bluetooth
^^^^^^^^^
### Bluetooth
- Add historical EP compatibility for Bluetooth HCI
CDC
^^^
### CDC
- Fix line_coding alignment
- Fix typo in cdc line coding enum
MIDI
^^^^
### MIDI
- Fix ``stream_write()`` always writes system messages to cable 0
- Fix `stream_write()` always writes system messages to cable 0
- Fix incorrect NOTE_ON, NOTE_OFF definitions
- USBTMC: Fix tmc488 bit order
### USBTMC
- Vendor: fix ``read()``/``write()`` race condition
- Fix tmc488 bit order
Video (UVC)
^^^^^^^^^^^
### 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
----------
## Host Stack
USBH
^^^^
### USBH
- Add new APIs: ``tuh_interface_set()``, ``tuh_task_event_ready()``, ``tuh_edpt_abort_xfer()``, ``tuh_rhport_reset_bus()``, ``tuh_rhport_is_active()``
- 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
- 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
- Support `usbh_app_driver_get_cb()` for application drivers
- Fix usbh enumeration removal race condition
- Add optional hooks ``tuh_event_hook_cb()``
- Add optional hooks `tuh_event_hook_cb()`
CDC
^^^
### CDC
- Breaking: change ``tuh_cdc_itf_get_info()`` to use tuh_itf_info_t instead of tuh_cdc_info_t
- 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()``
- Improve sync control API e.g `tuh_cdc_set_control_line_state()`, `tuh_cdc_set_line_coding()`
HID
^^^
### 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.
- 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
^^^
### HUB
- Fix handling of empty "status change" interrupt
- Fix issue with hub status_change is not aligned
MSC
^^^
### MSC
- Fix bug in ``tuh_msc_ready()``
- Fix bug in `tuh_msc_ready()`
- Fix host msc get maxlun not using aligned section memory
Contributors
------------
## 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.

View File

@ -1,8 +1,8 @@
0.17.0
======
# 0.17.0
General
-------
*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
@ -10,16 +10,13 @@ General
- 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)
-----------------------------
## Controller Driver (DCD & HCD)
Chipidea
^^^^^^^^
### Chipidea
- Support MCXA
DWC2
^^^^
### DWC2
- Fix tickless issue with stm32f7: disable ULPI clock during sleep when using internal phy
- Fix SOF interrupt handling
@ -27,99 +24,88 @@ DWC2
- Add DWC2 Test Mode support.
- for esp32 force disconnect/connect using USB_WRAP otg pad override
FSDEV
^^^^^
### 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()``
- 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)
- 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
^^^^^^^^
### MAX3421E
- Add support for rp2040, esp32 (c3, c6, h2, etc..)
- Add ``hcd_deinit()`` for max3421
- 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
- 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
### MSP430
MUSB
^^^^
- support non-bus-powered
### MUSB
- Add support for Analoog devices: max32650, max32666, max32690, max3278002
nRF
^^^
### nRF
- Fix ``dcd_edpt_open()`` for iso endpoint
- Fix `dcd_edpt_open()` for iso endpoint
- Handle ISOOUT CRC errors
- Add compile support with old nordic sdk
- Fix a few race conditions
OHCI
^^^^
### OHCI
- Allow more than 16 devices
RP2040
^^^^^^
### 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
^^^^^
### RUSB2
- Support ra2a1 pipe number scheme
WCH CH32
^^^^^^^^
### 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
------------
## Device Stack
- Add ``tud_deinit()`` and ``class driver deinit()`` to deinitialize TinyUSB 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
^^^^^
### 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
^^^^^^^^^^^^^
### Bluetooth HCI
- Issue ZLP on ACL IN ep when transfer is multiple of endpoint max packet size
CDC
^^^
### CDC
- Add ``tud_cdc_configure_fifo()`` to make RX/TX buffer persistent (not clear when disconnected)
- 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
^^^
### HID
- Added missing key codes for keypad
- Added HID Lighting and Illumination functionality
@ -127,58 +113,54 @@ HID
- 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
### MSC
Net
^^^
- 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()``
- removed obsolete `tud_network_link_state_cb()`
- USBTMC Added notification support
### USBTMC
Vendor
^^^^^^
- Added notification support
### Vendor
- Migrate to new endpoint stream API, support non-buffered TX/RX
- Add ZLP for ``write()`` when needed
- Add ZLP for `write()` when needed
Video
^^^^^
### 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
- Fix race for `tud_video_n_streaming()` check
Host Stack
----------
## Host Stack
- Added ``tuh_deinit()`` to de-initialize TinyUSB 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
^^^^^^^^^^
### CDC Serial
- Add support for ch34x
- Allow to overwrite ``CFG_TUH_CDC_FTDI/CP210X/CH32X_VID_PID_LIST``
- Allow to overwrite `CFG_TUH_CDC_FTDI/CP210X/CH32X_VID_PID_LIST`
- Enhanced stability of CDC-ACM devices during enumeration.
HID
^^^
### HID
- Add ``tuh_hid_receive_abort()``
- Add ``tuh_hid_get_report()``
- Add `tuh_hid_receive_abort()`
- Add `tuh_hid_get_report()`
Hub
^^^
### Hub
- Prevent status request to invalid ep_num
- Fix double status xfer
- unroll hub removal
Contributors
------------
## 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.

57
docs/changelog/0.18.0.md Normal file
View File

@ -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.

View File

@ -1,62 +0,0 @@
0.18.0
======
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.

View File

@ -1,11 +1,10 @@
0.19.0
======
# 0.19.0
General
-------
*October 6, 2025*
New MCUs and Boards
^^^^^^^^^^^^^^^^^^^
## General
### New MCUs and Boards
- Add ESP32-H4, ESP32-C5, ESP32-C61 support
- Add STM32U0, STM32WBA, STM32N6
@ -13,47 +12,41 @@ New MCUs and Boards
- Add CH32V305 support and CH32V20x USB host support
- Add MCXA156 SDK 2.16 support and FRDM-MCXA156 board
API Changes
-----------
## API Changes
Core APIs
^^^^^^^^^
### 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
- 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
^^^^^^^^^^^
### 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()``
- 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
^^^^^^^^^
### 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()``
- 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)
-----------------------------
## Controller Driver (DCD & HCD)
DWC2
^^^^
### DWC2
- Support DWC2 v4.30a with improved reset procedure
- Fix core reset: wait for AHB idle before reset
@ -68,8 +61,7 @@ DWC2
- Fix enumeration racing conditions
- Refactor bitfields for better code generation
FSDEV (STM32)
^^^^^^^^^^^^^
### FSDEV (STM32)
- Fix AT32 compile issues after single-buffered endpoint changes
- Add configurable single-buffered isochronous endpoints
@ -78,170 +70,147 @@ FSDEV (STM32)
- Fix STM32 PHYC PLL stability wait
- Improve PMA size handling for STM32U0
EHCI
^^^^
### EHCI
- Fix removed QHD getting reused
- Fix NXP USBPHY disconnection detection
Chipidea/NXP
^^^^^^^^^^^^
### 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
^^^^^^^^
### MAX3421E
- Use spinlock for thread safety instead of atomic flag
- Implement ``hcd_edpt_close()``
- Implement `hcd_edpt_close()`
RP2040
^^^^^^
### RP2040
- Fix audio ISO transfer: reset state before notifying stack
- Fix CMake RTOS cache variable
- Abort transfer if active in ``iso_activate()``
- Abort transfer if active in `iso_activate()`
SAMD
^^^^
### SAMD
- Add host controller driver support
Device Stack
------------
## Device Stack
USBD Core
^^^^^^^^^
### 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()``
- 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
^^^^^
### Audio
- Major simplification of UAC driver and alt settings management
- Move ISO transfers into ``xfer_isr()`` for better performance
- 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
^^^
### CDC
- Add notification support: ``CFG_TUD_CDC_NOTIFY``, ``tud_cdc_n_notify_conn_speed_change()``, ``tud_cdc_notify_complete_cb()``
- 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
- 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
^^^
### 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
^^^^
### MIDI
- Fix MIDI interface descriptor handling after audio streaming interface
- Skip RX data with all zeroes
MSC
^^^
### 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
- 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
^^^
### 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()``
- Add MTP event support with `tud_mtp_event_send()`
- Implement filesystem example with callbacks
- Add hardware-in-the-loop testing support
NCM
^^^
### NCM
- Add USB NCM link state control support
- Fix DHCP offer/ACK destination
USBTMC
^^^^^^
### USBTMC
- Add vendor-specific message support
Vendor
^^^^^^
### Vendor
- Fix vendor device reset and open issues
- Fix descriptor parsing for ``CFG_TUD_VENDOR > 1``
- Fix descriptor parsing for `CFG_TUD_VENDOR > 1`
- Fix vendor FIFO argument calculation
Host Stack
----------
## Host Stack
USBH Core
^^^^^^^^^
### 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
- 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
- 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
- `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
^^^^^^^^^^^^^^^
### 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
- 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
^^^^^^^^^
### 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
- 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()``
- 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
^^^^^^^^
### MSC Host
- Continue async I/O improvements
HID Host
^^^^^^^^
### HID Host
- Fix version string to actually show version
Contributors
------------
## 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.

View File

@ -1,39 +1,32 @@
0.20.0
======
# 0.20.0
*November 19, 2025*
General
-------
## General
New MCUs and Boards
^^^^^^^^^^^^^^^^^^^
### 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
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
### 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
- Add `.clang-format` for consistent code formatting
- Fix numerous alerts and warnings found by static analysis tools
Documentation
^^^^^^^^^^^^^
### Documentation
- Improve Getting Started documentation structure and flow
- Add naming conventions and buffer handling documentation
Controller Driver (DCD & HCD)
-----------------------------
## Controller Driver (DCD & HCD)
DWC2
^^^^
### DWC2
- Fix incorrect handling of Zero-Length Packets (ZLP) in the DWC2 driver when receiving data (OUT transfers)
- Improve EP0 multi-packet logic
@ -44,64 +37,52 @@ DWC2
- Clear pending suspend interrupt after USB reset (enum end)
- Improve host closing endpoint and channel handling when device is unplugged
FSDEV (STM32)
^^^^^^^^^^^^^
### FSDEV (STM32)
- Fix AT32 USB interrupt remapping in ``dcd_int_enable()``
- Fix AT32 USB interrupt remapping in `dcd_int_enable()`
OHCI
^^^^
### OHCI
- Add initial LPC55 OHCI support
- Improve data cache support
Device Stack
------------
## Device Stack
USBD Core
^^^^^^^^^
### USBD Core
- Support configurable EP0 buffer size CFG_TUD_ENDPOINT0_BUFSIZE
- Make dcd_edpt_iso_alloc/activate as default API for ISO endpoint
Audio
^^^^^
### Audio
- Add UAC1 support
- Implement RX FIFO threshold adjustment with ``tud_audio_get/set_ep_in_fifo_threshold()``
- Implement RX FIFO threshold adjustment with `tud_audio_get/set_ep_in_fifo_threshold()`
CDC
^^^
### CDC
- Migrate to endpoint stream API
HID
^^^
### HID
- Fix HID stylus descriptor
MIDI
^^^^
### MIDI
- Migrate to endpoint stream API
- Add ``tud_midi_n_packet_write_n()`` and ``tud_midi_n_packet_read_n()``
- Add `tud_midi_n_packet_write_n()` and `tud_midi_n_packet_read_n()`
MTP
^^^
### MTP
- Fix incorrect MTP xact_len calculation
Video
^^^^^
### Video
- Add bufferless operation callback for dynamic frame generation with tud_video_prepare_payload_cb()
Host Stack
----------
## Host Stack
No changes
Contributors
------------
## 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.

View File

@ -1,13 +1,10 @@
0.21.0
======
# 0.21.0
*June 29, 2026*
General
-------
## General
New MCUs and Boards
^^^^^^^^^^^^^^^^^^^
### New MCUs and Boards
- Add HPMicro HPM6xxx support with HPM6750EVK2 board
- Add NXP RW61x (RW612, ChipIdea high-speed) support
@ -18,142 +15,122 @@ New MCUs and Boards
- 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
- Migrate i.MX RT to the new `mcux-devices-rt` SDK package
Code Quality and Build
^^^^^^^^^^^^^^^^^^^^^^
### 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
- 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
- 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
^^^^^^^^^^^^^
### Documentation
- Add a README for every example and ``build-doc`` tooling
- Add Sponsors section and ``FUNDING`` configuration
- 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
-----------
## API Changes
- Add ``is_isr`` parameter to ``dcd_edpt_xfer``, ``dcd_edpt_xfer_fifo``, ``usbd_edpt_xfer`` and ``usbd_edpt_xfer_fifo``
- 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 `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
- `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
------------
## Device Stack
USBD Core
^^^^^^^^^
### USBD Core
- Refactor and validate device descriptor handling; move control transfer handling into ``usbd.c``
- 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 stream write logic/racing without FIFO; fix zero `wLength` control request
- Fix ISO OUT endpoint failure on alt-setting MPS change
Audio
^^^^^
### Audio
- Fix ``audiod_open`` with MIDI interfaces
- Fix big-endian bitfield guards for audio structs and endian-safe ``wValue``/``wIndex`` extraction in UAC2 examples
- Fix `audiod_open` with MIDI interfaces
- Fix big-endian bitfield guards for audio structs and endian-safe `wValue`/`wIndex` extraction in UAC2 examples
CDC
^^^
### CDC
- Remove ``tud_cdc_configure``
- Remove `tud_cdc_configure`
- Fix CDC echo test issue on i.MX RT and fast MCUs
HID
^^^
### HID
- Bound item size to remaining length in the report-descriptor parser
- Remove host enumeration assumption; add ``CFG_TUH_HID_SET_PROTOCOL_ON_ENUM``
- Remove host enumeration assumption; add `CFG_TUH_HID_SET_PROTOCOL_ON_ENUM`
MIDI
^^^^
### MIDI
- Add USB-MIDI 2.0 device and host class drivers
- Add cable-aware stream read ``tud_midi_n_demux_stream_read()``
- Add cable-aware stream read `tud_midi_n_demux_stream_read()`
- Fix MIDI host issue
MSC
^^^
### MSC
- Skip the command stage if the OUT endpoint is stalled
- Cap ``tud_msc_scsi_cb`` buffer size to the endpoint buffer size
- Cap `tud_msc_scsi_cb` buffer size to the endpoint buffer size
MTP
^^^
### 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``
- Fix premature phase change after a short OUT transfer; fixes in `add_string`
Network (NCM)
^^^^^^^^^^^^^
### Network (NCM)
- Fix NCM state on restart
- Support ``SetEthernetPacketFilter`` and ``SetNtbInputSize`` requests
- Support `SetEthernetPacketFilter` and `SetNtbInputSize` requests
- Add a weak callback for the initial link state
Video (UVC)
^^^^^^^^^^^
### Video (UVC)
- Fix VC interface parsing when ``bNumEndpoints`` != 0
- Assert the ``usbd_edpt_iso_activate()`` result
- Fix VC interface parsing when `bNumEndpoints` != 0
- Assert the `usbd_edpt_iso_activate()` result
DFU
^^^
### DFU
- Fix the DFU functional descriptor version (1.0.1 → 1.1.0)
Printer
^^^^^^^
### Printer
- Add the USB Printer device class driver
Vendor
^^^^^^
### Vendor
- Omit the endpoint buffer for ports with a dedicated hardware FIFO
Host Stack
----------
## 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
- 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
- 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
- Use `TUSB_ROLE_HOST` in host stack initialization
Controller Driver (DCD & HCD)
-----------------------------
## Controller Driver (DCD & HCD)
DWC2
^^^^
### DWC2
- Add ``dcd_configure`` for FIFO config and DWC2 deinit support
- 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)
^^^^^^^^^^^^^^^^^^^^
### FSDEV (STM32 / CH32)
- Add FSDEV host (HCD) driver
- Refactor FSDEV; share the PMA errata delay helper between DCD/HCD with overridable timing
@ -161,53 +138,45 @@ FSDEV (STM32 / CH32)
- 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
^^^^
### 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
^^^^^^^^^^^^^^^
### 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)
^^^^^^^^^^^^^^^^^^^^^^^^
### 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
^^^^^^^^^^^^^^
### RUSB2 / SAMx7x
- Fix RUSB2 FIFO write
- Refresh ``dcd_samx7x``
- Refresh `dcd_samx7x`
New host controllers
^^^^^^^^^^^^^^^^^^^^
### New host controllers
- Add NXP IP3516 HCD (EHCI-like)
- Add MTT (multi-TT) hub support
nRF5x
^^^^^
### nRF5x
- Request HFCLK in ``USB_EVT_READY`` to fix the post-SoftDevice deadlock
- Request HFCLK in `USB_EVT_READY` to fix the post-SoftDevice deadlock
Testing
-------
## 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
- Add `hil`, `code-size`, `pvs`, `usbmon` and `build-doc` developer skills
Contributors
------------
## 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.

View File

@ -1,7 +1,6 @@
0.5.0
=====
# 0.5.0
*2019-06*
*July 11, 2019*
First release, device stack works great, host stack works but still need improvement.
@ -9,7 +8,6 @@ First release, device stack works great, host stack works but still need improve
- Thanks to @cr1901 for adding STM32F4 port.
- Thanks to @PTS93 and @todbot for HID raw API
Contributors
------------
## Contributors
Thanks to everyone who contributed to this release: @cr1901, @gpshead, @hathach, @mithro, @tannewt, @timonsku, @zardam.

View File

@ -1,15 +1,12 @@
0.6.0
=====
# 0.6.0
*2020-03-30*
*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 **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
-----
## Added
MCU
^^^
### MCU
- Added support for Microchip SAMG55
- Added support for Nordic nRF52833
@ -21,8 +18,7 @@ MCU
- Added support for TI MSP430
- Added support for ValentyUSB's eptri
Class Driver
^^^^^^^^^^^^
### Class Driver
- Added DFU Runtime class driver
- Added Network class driver with RNDIS, CDC-ECM, CDC-EEM (work in progress)
@ -31,40 +27,37 @@ Class Driver
- 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
- Added `tud_descriptor_bos_cb()` for BOS descriptor (required for USB 2.1)
- Added `dcd_edpt0_status_complete()` as optional API for DCD
Examples
^^^^^^^^
### Examples
Following examples are added:
- ``board_test``
- ``cdc_dual_ports``
- ``dfu_rt``
- ``hid_composite``
- ``net_lwip_webserver``
- ``usbtmc``
- ``webusb_serial``
- `board_test`
- `cdc_dual_ports`
- `dfu_rt`
- `hid_composite`
- `net_lwip_webserver`
- `usbtmc`
- `webusb_serial`
Changed
-------
## 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
- 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 `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
- Fixed `cdc_msc_freertos` example build for all MCUs
Contributors
------------
## 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.

136
docs/changelog/0.7.0.md Normal file
View File

@ -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.

View File

@ -1,159 +0,0 @@
0.7.0
=====
*2020-11-08*
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``
- 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
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
- 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``
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.

View File

@ -1,86 +1,70 @@
0.8.0
=====
# 0.8.0
*2021-02-05*
*February 5, 2021*
Device Controller Driver
------------------------
## 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
- Use `dcd_event_bus_reset()` with link speed to replace bus_signal
ESP32-S2
^^^^^^^^
### ESP32-S2
- Add bus suspend and wakeup support
SAMD21
^^^^^^
### SAMD21
- Fix (workaround) samd21 setup_packet overflow by USB DMA
STM32 Synopsys
^^^^^^^^^^^^^^
### STM32 Synopsys
- Rework USB FIFO allocation scheme and allow RX FIFO size reduction
Sony CXD56
^^^^^^^^^^
### Sony CXD56
- Update Spresense SDK to 2.0.2
- Fix dcd issues with setup packets
- Correct EP number for cdc_msc example
USB Device
----------
## USB Device
USBD
^^^^
### 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
- 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
^^^
### CDC
- Allow to transmit data, even if the host does not support control line states i.e set DTR
HID
^^^
### HID
- change default ``CFG_TUD_HID_EP_BUFSIZE`` from 16 to 64
- change default `CFG_TUD_HID_EP_BUFSIZE` from 16 to 64
MIDI
^^^^
### MIDI
- Fix midi sysex sending bug
MSC
^^^
### MSC
- Invoke only scsi complete callback after status transaction is complete.
- Fix ``scsi_mode_sense6_t`` padding, which cause IAR compiler internal error.
- Fix `scsi_mode_sense6_t` padding, which cause IAR compiler internal error.
USBTMC
^^^^^^
### USBTMC
- Change interrupt endpoint example size to 8 instead of 2 for better compatibility with mcu
Example
^^^^^^^
### Example
- Support make from windows ``cmd.exe``
- Add HID Consumer Control (media keys) to ``hid_composite`` & ``hid_composite_freertos`` examples
- Support make from windows `cmd.exe`
- Add HID Consumer Control (media keys) to `hid_composite` & `hid_composite_freertos` examples
USB Host
--------
## USB Host
No noticeable changes to host stack
New Boards
----------
## New Boards
- NXP/Freescale Freedom FRDM-KL25Z
- Feather Double M33 express
@ -95,7 +79,6 @@ New Boards
- Adafruit PyPortal
- Great Scott Gadgets' LUNA D11 & D21
Contributors
------------
## Contributors
Thanks to everyone who contributed to this release: @aslampr07, @charkster, @dobairoland, @duempel, @gsteiert, @hathach, @HiFiPhile, @kamtom480, @kkitayam, @ktemkin, @majbthrd, @PanRe, @prplz.

108
docs/changelog/0.9.0.md Normal file
View File

@ -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.

View File

@ -1,126 +0,0 @@
0.9.0
=====
*2021-03-12*
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.

View File

@ -66,4 +66,4 @@ gen_presets.main()
###################
# docs/changelog/
###################
print("Add docs/changelog/{}.rst and list it at the top of docs/changelog/index.rst".format(version))
print("Add docs/changelog/{}.md and list it at the top of docs/changelog/index.rst".format(version))