From 20200b35202e5dd0a1a5e8be1db081dc57f6ae8e Mon Sep 17 00:00:00 2001 From: hathach Date: Tue, 30 Jun 2026 14:39:57 +0700 Subject: docs: move changelog to docs/changelog, drop the docs/info folder Relocate docs/info/changelog/ -> docs/changelog/ (docs/info held only the changelog) and update all references: the toctree, README + MAINTAINERS links, make_release.py, and the make-release skill. Co-Authored-By: Claude Opus 4.8 (1M context) --- .claude/skills/make-release/SKILL.md | 10 +- MAINTAINERS.rst | 2 +- README.rst | 2 +- docs/changelog/0.10.0.rst | 83 ++++++++++++ docs/changelog/0.10.1.rst | 20 +++ docs/changelog/0.11.0.rst | 107 +++++++++++++++ docs/changelog/0.12.0.rst | 35 +++++ docs/changelog/0.13.0.rst | 45 +++++++ docs/changelog/0.14.0.rst | 79 +++++++++++ docs/changelog/0.15.0.rst | 86 ++++++++++++ docs/changelog/0.16.0.rst | 165 +++++++++++++++++++++++ docs/changelog/0.17.0.rst | 184 ++++++++++++++++++++++++++ docs/changelog/0.18.0.rst | 62 +++++++++ docs/changelog/0.19.0.rst | 247 +++++++++++++++++++++++++++++++++++ docs/changelog/0.20.0.rst | 107 +++++++++++++++ docs/changelog/0.21.0.rst | 213 ++++++++++++++++++++++++++++++ docs/changelog/0.5.0.rst | 15 +++ docs/changelog/0.6.0.rst | 70 ++++++++++ docs/changelog/0.7.0.rst | 159 ++++++++++++++++++++++ docs/changelog/0.8.0.rst | 101 ++++++++++++++ docs/changelog/0.9.0.rst | 126 ++++++++++++++++++ docs/changelog/index.rst | 27 ++++ docs/index.rst | 2 +- docs/info/changelog/0.10.0.rst | 83 ------------ docs/info/changelog/0.10.1.rst | 20 --- docs/info/changelog/0.11.0.rst | 107 --------------- docs/info/changelog/0.12.0.rst | 35 ----- docs/info/changelog/0.13.0.rst | 45 ------- docs/info/changelog/0.14.0.rst | 79 ----------- docs/info/changelog/0.15.0.rst | 86 ------------ docs/info/changelog/0.16.0.rst | 165 ----------------------- docs/info/changelog/0.17.0.rst | 184 -------------------------- docs/info/changelog/0.18.0.rst | 62 --------- docs/info/changelog/0.19.0.rst | 247 ----------------------------------- docs/info/changelog/0.20.0.rst | 107 --------------- docs/info/changelog/0.21.0.rst | 213 ------------------------------ docs/info/changelog/0.5.0.rst | 15 --- docs/info/changelog/0.6.0.rst | 70 ---------- docs/info/changelog/0.7.0.rst | 159 ---------------------- docs/info/changelog/0.8.0.rst | 101 -------------- docs/info/changelog/0.9.0.rst | 126 ------------------ docs/info/changelog/index.rst | 27 ---- tools/make_release.py | 4 +- 43 files changed, 1941 insertions(+), 1941 deletions(-) create mode 100644 docs/changelog/0.10.0.rst create mode 100644 docs/changelog/0.10.1.rst create mode 100644 docs/changelog/0.11.0.rst create mode 100644 docs/changelog/0.12.0.rst create mode 100644 docs/changelog/0.13.0.rst create mode 100644 docs/changelog/0.14.0.rst create mode 100644 docs/changelog/0.15.0.rst create mode 100644 docs/changelog/0.16.0.rst create mode 100644 docs/changelog/0.17.0.rst create mode 100644 docs/changelog/0.18.0.rst create mode 100644 docs/changelog/0.19.0.rst create mode 100644 docs/changelog/0.20.0.rst create mode 100644 docs/changelog/0.21.0.rst create mode 100644 docs/changelog/0.5.0.rst create mode 100644 docs/changelog/0.6.0.rst create mode 100644 docs/changelog/0.7.0.rst create mode 100644 docs/changelog/0.8.0.rst create mode 100644 docs/changelog/0.9.0.rst create mode 100644 docs/changelog/index.rst delete mode 100644 docs/info/changelog/0.10.0.rst delete mode 100644 docs/info/changelog/0.10.1.rst delete mode 100644 docs/info/changelog/0.11.0.rst delete mode 100644 docs/info/changelog/0.12.0.rst delete mode 100644 docs/info/changelog/0.13.0.rst delete mode 100644 docs/info/changelog/0.14.0.rst delete mode 100644 docs/info/changelog/0.15.0.rst delete mode 100644 docs/info/changelog/0.16.0.rst delete mode 100644 docs/info/changelog/0.17.0.rst delete mode 100644 docs/info/changelog/0.18.0.rst delete mode 100644 docs/info/changelog/0.19.0.rst delete mode 100644 docs/info/changelog/0.20.0.rst delete mode 100644 docs/info/changelog/0.21.0.rst delete mode 100644 docs/info/changelog/0.5.0.rst delete mode 100644 docs/info/changelog/0.6.0.rst delete mode 100644 docs/info/changelog/0.7.0.rst delete mode 100644 docs/info/changelog/0.8.0.rst delete mode 100644 docs/info/changelog/0.9.0.rst delete mode 100644 docs/info/changelog/index.rst diff --git a/.claude/skills/make-release/SKILL.md b/.claude/skills/make-release/SKILL.md index 49ca29313..058d7245d 100644 --- a/.claude/skills/make-release/SKILL.md +++ b/.claude/skills/make-release/SKILL.md @@ -1,6 +1,6 @@ --- name: make-release -description: Use when cutting a new TinyUSB release — bumping the version, running tools/make_release.py, writing the per-release docs/info/changelog/ entry from the PRs merged since the last tag, and validating before the maintainer commits and tags. Covers the changelog PR-boundary reconciliation and the regenerated-file gotchas. +description: Use when cutting a new TinyUSB release — bumping the version, running tools/make_release.py, writing the per-release docs/changelog/ entry from the PRs merged since the last tag, and validating before the maintainer commits and tags. Covers the changelog PR-boundary reconciliation and the regenerated-file gotchas. --- # Cut a TinyUSB Release @@ -20,9 +20,9 @@ Gotchas: - `gen_doc` imports `pandas` + `tabulate` at line 3 and crashes before writing if they're missing (not in `docs/requirements.txt`) → `pip install pandas tabulate`. See the **build-doc** skill. - `boards.rst` is written with no trailing newline → pre-commit's `end-of-file-fixer` adds it; run pre-commit on the regenerated files (step 3). -## 2. Changelog — `docs/info/changelog/` (the hard part) +## 2. Changelog — `docs/changelog/` (the hard part) -Each release is its own file: create `docs/info/changelog/X.Y.Z.rst` and add it as the **first** entry in the `docs/info/changelog/index.rst` toctree (newest first). Determine the PR set by **git commit reachability, not by merge date** — a date query (`gh ... --search merged:>=DATE`) both includes the *previous* release's own changelog PR (its `mergedAt` shares the tag day) and is awkward at the boundary; `--merges | grep "Merge pull request"` silently drops squash-merged PRs. +Each release is its own file: create `docs/changelog/X.Y.Z.rst` and add it as the **first** entry in the `docs/changelog/index.rst` toctree (newest first). Determine the PR set by **git commit reachability, not by merge date** — a date query (`gh ... --search merged:>=DATE`) both includes the *previous* release's own changelog PR (its `mergedAt` shares the tag day) and is awkward at the boundary; `--merges | grep "Merge pull request"` silently drops squash-merged PRs. ```bash PREV=0.20.0 # last release tag @@ -42,7 +42,7 @@ Why this is correct: `$PREV..HEAD` excludes everything reachable from the last t A PR merged into a *feature branch* (rather than master) is folded into its parent top-level PR and won't appear on its own — intended (review follow-ups aren't double-listed), but make the parent's changelog bullet reflect the final merged state. This is also why a date-based `gh` query returns *more* numbers than this set: those extras are the prior changelog PR plus these sub-PRs. Then **curate** into the existing sections, matching the prior release file's RST style exactly: -- The file's title is the version (`X.Y.Z` with `======` underline matching its length), then the italic date (the planned tag date — ask if unknown). Add the file to the top of `docs/info/changelog/index.rst`. +- The file's title is the version (`X.Y.Z` with `======` underline matching its length), then the italic date (the planned tag date — ask if unknown). Add the file to the top of `docs/changelog/index.rst`. - Sections in order: **General** (New MCUs and Boards / Code Quality and Build / Documentation), **API Changes**, **Device Stack** (per class: Audio, CDC, HID, MIDI, MSC, MTP, Net, Video, …), **Host Stack**, **Controller Driver (DCD & HCD)** (per driver: DWC2, FSDEV, MUSB, RP2040, …), **Testing**, **Contributors**. Within a section, each driver/class group is a ``^^^``-underlined sub-heading (not a bullet). - RST inline code (double backticks) for symbols. Group related PRs into one bullet — summarize, don't dump 200 lines. Driver/`Port *` PR labels help bucket DCD/HCD entries. - **Contributors** section credits the release's PR authors (this is where contributor credit lives — there is no separate contributors page). List the unique non-bot author handles alphabetically: @@ -55,7 +55,7 @@ Then **curate** into the existing sections, matching the prior release file's RS ## 3. Validate (all unstaged) ```bash -pre-commit run --files docs/info/changelog/X.Y.Z.rst docs/info/changelog/index.rst \ +pre-commit run --files docs/changelog/X.Y.Z.rst 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; new release page wired into the toctree (see build-doc skill) diff --git a/MAINTAINERS.rst b/MAINTAINERS.rst index e9c063e08..6183e233e 100644 --- a/MAINTAINERS.rst +++ b/MAINTAINERS.rst @@ -6,5 +6,5 @@ Maintainers - `Zixun Li (HiFiPhile) `__ — maintainer; audio expertise Everyone who has contributed is credited per release in the -`changelog `__ and in the GitHub +`changelog `__ and in the GitHub `contributors graph `__. diff --git a/README.rst b/README.rst index bfe38234f..e5806bafc 100644 --- a/README.rst +++ b/README.rst @@ -355,7 +355,7 @@ The following tools are provided freely to support the development of the TinyUS :target: https://github.com/sponsors/hathach -.. _Changelog: docs/info/changelog/index.rst +.. _Changelog: docs/changelog/index.rst .. _Getting Started: docs/getting_started.rst .. _Supported Boards: docs/reference/boards.rst .. _Dependencies: docs/reference/dependencies.rst diff --git a/docs/changelog/0.10.0.rst b/docs/changelog/0.10.0.rst new file mode 100644 index 000000000..7c11dd176 --- /dev/null +++ b/docs/changelog/0.10.0.rst @@ -0,0 +1,83 @@ +0.10.0 +====== + +*2021-05-28* + +- Rework tu_fifo_t with separated mutex for read and write, better support DMA with read/write buffer info. And constant address mode +- Improve audio_test example and add audio_4_channel_mic example +- Add new dfu example +- Remove pico-sdk from submodule + +Device Controller Driver (DCD) +------------------------------ + +- Add new DCD port for Silabs EFM32GG12 with board Thunderboard Kit (SLTB009A) +- Add new DCD port Renesas RX63N, board GR-CITRUS +- Add new (optional) endpoint API dcd_edpt_xfer_fifo +- Fix build with nRF5340 +- Fix build with lpc15 and lpc54 +- Fix build with lpc177x_8x +- STM32 Synopsys: greatly improve Isochronous transfer with ``edpt_xfer_fifo()`` API +- Support LPC55 port1 highspeed +- Add support for Espressif esp32s3 +- nRF: fix race condition that could cause drop packet of Bulk OUT transfer + +USB Device Driver (USBD) +------------------------ + +- Add new (optional) endpoint ADPI ``usbd_edpt_xfer_fifo()`` + +Device Class Driver +------------------- + +CDC +^^^ + +- [Breaking] ``tud_cdc_peek()``, ``tud_vendor_peek()`` no longer support random offset and dropped position parameter. + +DFU +^^^ + +- Add new DFU 1.1 class driver (WIP) + +HID +^^^ + +- Fix keyboard report descriptor template +- Add more hid keys constant from 0x6B to 0xA4 +- [Breaking] rename API + + - ``HID_PROTOCOL_NONE/KEYBOARD/MOUSE`` to ``HID_ITF_PROTOCOL_NONE/KEYBOARD/MOUSE`` + - ``tud_hid_boot_mode()`` to ``tud_hid_get_protocol()`` + - ``tud_hid_boot_mode_cb()`` to ``tud_hid_set_protocol_cb()`` + +MIDI +^^^^ + +- Fix MIDI buffer overflow issue +- [Breaking] rename API + + - Rename ``tud_midi_read()`` to ``tud_midi_stream_read()`` + - Rename ``tud_midi_write()`` to ``tud_midi_stream_write()`` + - Rename ``tud_midi_receive()`` to ``tud_midi_packet_read()`` + - Rename ``tud_midi_send()`` to ``tud_midi_packet_write()`` + +Host Controller Driver (HCD) +---------------------------- + +- No noticeable changes + +USB Host Driver (USBH) +---------------------- + +- No noticeable changes + +Host Class Driver +----------------- + +- HID: Rework host hid driver, basically everything changes + +Contributors +------------ + +Thanks to everyone who contributed to this release: @alisitsyn, @corvus-ossifragus, @hathach, @jgressmann, @joeycastillo, @kapacuk, @kasjer, @kkitayam, @ned-pcs, @noodlefighter, @ogatatsu, @PanRe, @perigoso, @pigrew, @sjanc, @xmos-jmccarthy. diff --git a/docs/changelog/0.10.1.rst b/docs/changelog/0.10.1.rst new file mode 100644 index 000000000..30f1bbd98 --- /dev/null +++ b/docs/changelog/0.10.1.rst @@ -0,0 +1,20 @@ +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. diff --git a/docs/changelog/0.11.0.rst b/docs/changelog/0.11.0.rst new file mode 100644 index 000000000..c27b027dd --- /dev/null +++ b/docs/changelog/0.11.0.rst @@ -0,0 +1,107 @@ +0.11.0 +====== + +*2021-08-29* + +- Add host/hid_controller example: only worked/tested with Sony PS4 DualShock controller +- Add device/hid_boot_interface example +- Add support for Renesas CCRX toolchain for RX mcu + +Device Controller Driver (DCD) +------------------------------ + +- Add new DCD port for SAMx7x (E70, S70, V70, V71) +- Add new mcu K32L2Bxx +- Add new mcu GD32VF103 +- Add new mcu STM32l151 +- Add new mcu SAML21 +- Add new mcu RX65n RX72n +- Fix NUC120/121/126 USBRAM can only be accessed in byte manner. Also improve set_address & disable sof +- Add Suspend/Resume handling for Renesas RX family. +- Fix DA1469x no VBUS startup + +Synopsys +^^^^^^^^ + +- Fix Synopsys set address bug which could cause re-enumeration failed +- Fix ``dcd_synopsys`` driver integer overflow in HS mode (issue #968) + +nRF5x +^^^^^ + +- Add nRF5x suspend, resume and remote wakeup +- Fix nRF5x race condition with ``TASKS_EP0RCVOUT`` + +RP2040 +^^^^^^ + +- Add RP2040 suspend & resume support +- Implement double buffer for both host and device (#891). However device EPOUT is still single buffered due to technical issue with short packet + +Device Stack +------------ + +USBD +^^^^ + +- Better support big endian mcu +- Add ``tuh_inited()`` and ``tud_inited()``, will separate ``tusb_init/inited()`` to ``tud/tuh_init/inited()`` +- Add ``dcd_attr.h`` for defining common controller attribute such as max endpoints + +Bluetooth +^^^^^^^^^ + +- Fix stridx error in descriptor template + +DFU +^^^ + +- Enhance DFU implementation to support multiple alternate interface and better support ``bwPollTimeout`` +- Rename ``CFG_TUD_DFU_MODE`` to simply ``CFG_TUD_DFU`` + +HID +^^^ + +- Fix newline usage keyboard (ENTER 0x28) +- Better support Hid Get/Set report +- Change max gamepad support from 16 to 32 buttons + +MIDI +^^^^ + +- Fix midi available +- Fix midi data +- Fix an issue when calling midi API when not enumerated yet + +UAC2 +^^^^ + +- Fix bug and enhance of UAC2 + +Vendor +^^^^^^ + +- Fix vendor fifo deadlock in certain case +- Add ``tud_vendor_n_read_flush()`` + +Host Controller Driver (HCD) +---------------------------- + +RP2040 +^^^^^^ + +- Implement double buffered to fix E4 errata and boost performance +- Lots of rp2040 update and enhancement + +Host Stack +---------- + +- Major update and rework most of host stack, still needs more improvement +- Lots of improvement and update in parsing configuration and control +- Rework and major update to HID driver. Will default to enable boot interface if available +- Separate ``CFG_TUH_DEVICE_MAX`` and ``CFG_TUH_HUB`` for better management and reduce SRAM usage + +Contributors +------------ + +Thanks to everyone who contributed to this release: @a-h, @BennyEvans, @ctag-fh-kiel, @DuMaM, @hathach, @HiFiPhile, @KarlK90, @kasjer, @kilograham, @kkitayam, @majbthrd, @mmosca, @mws-rmain, @ned-pcs, @nxf58843, @perigoso, @sabas1080, @salkinium, @tringis, @Wini-Buh, @xcguang, @xmos-jmccarthy, @zhangslice. diff --git a/docs/changelog/0.12.0.rst b/docs/changelog/0.12.0.rst new file mode 100644 index 000000000..65ac4741f --- /dev/null +++ b/docs/changelog/0.12.0.rst @@ -0,0 +1,35 @@ +0.12.0 +====== + +- add ``CFG_TUSB_OS_INC_PATH`` for os include path + +Device Controller Driver (DCD) +------------------------------ + +- Getting device stack to pass USB Compliance Verification test (chapter9, HID, MSC). Ports are tested: + nRF, SAMD 21/51, rp2040, stm32f4, Renesas RX, iMXRT, ESP32-S2/3, Kinetic KL25/32, DA146xx +- Added ``dcd_edpt_close_all()`` for switching configuration +- [Transdimension] Support ``dcd_edpt_xfer_fifo()`` with auto wrap over if fifo buffer is 4K aligned and size is multiple of 4K. +- [DA146xx] Improve vbus, reset, suspend, resume detection, and remote wakeup. + +Device Stack +------------ + +- Add new network driver Network Control Model (CDC-NCM), update ``net_lwip_webserver`` to work with NCM (need re-configure example) +- Add new USB Video Class UVC 1.5 driver and video_capture example (work in progress) +- Fix potential buffer overflow for HID, bluetooth drivers + +Host Controller Driver (HCD) +---------------------------- + +No notable changes + +Host Stack +---------- + +No notable changes + +Contributors +------------ + +Thanks to everyone who contributed to this release: @Daft-Freak, @dshadoff, @hansfbaier, @hathach, @HiFiPhile, @kamtom480, @kasjer, @kkitayam, @majbthrd, @szymonh, @unlimitedcodeworks. diff --git a/docs/changelog/0.13.0.rst b/docs/changelog/0.13.0.rst new file mode 100644 index 000000000..a860918d0 --- /dev/null +++ b/docs/changelog/0.13.0.rst @@ -0,0 +1,45 @@ +0.13.0 +====== + +- [tu_fifo] Fix locked mutex when full, and return type in ``peek_n()`` + +Controller Driver (DCD & HCD) +----------------------------- + +- [DWC2] Generalize synopsys dwc2 with synopsys/dwc2 which support both FS and HS phy (UTMI and ULPI) for various MCUs. + + - Broadcom 28/27xx on raspberrypi SBC + - Silicon Labs EFM32 + - Espressif ESP32 Sx + - GigaDevice GD32 + - ST STM32 + - Infineon XMC +- [KL25] Add new HCD for NXP KL25 +- [MUSB] Add new DCD and HCD for Mentor musb with TI MSP432E4 +- [F1C100s] Add new DCD for Allwinner F1C100s family +- [PIC32MZ] Add new DCD for PIC32MZ +- [nRF] Fix/Enhance various race condition with: EASY DMA, request HFXO, EPOUT +- [ChipIdea] rename Transdimension to more popular ChipIdea Highspeed, +- [RP2040] various update/fix for hcd/dcd +- [FT9XX] new DCD port for Bridgetek FT90x and FT93x devices +- [DA1469X] Fix resume +- [OHCI] Fix device array out of bound + +Note: legacy drivers such as st/synopsys, nxp/transdimension are still present in this release but won't receive more update and could be removed in the future. + +Device Stack +------------ + +- [Audio] Support disabling feedback format correction (16.16 <-> 10.14 format) +- [MSC] Add ``tud_msc_request_sense_cb()`` callback, change most default sense error to medium not present (0x02, 0x3A, 0x00) +- [Video] Fix video_capture example fails enumeration when 8FPS + +Host Stack +---------- + +No notable changes + +Contributors +------------ + +Thanks to everyone who contributed to this release: @alisitsyn, @brtchip-gdm, @cr1901, @EmergReanimator, @hathach, @HiFiPhile, @JayToltTech, @jgressmann, @kasjer, @kkitayam, @leptun, @liamfraser, @majbthrd, @mkj, @mysterywolf, @NexusXe, @nxf58843, @perigoso, @rppicomidi, @Ryzee119, @scoudreau, @sharpie7, @suda-morris, @t123yh, @tannewt, @vmilea, @ZenithalHourlyRate. diff --git a/docs/changelog/0.14.0.rst b/docs/changelog/0.14.0.rst new file mode 100644 index 000000000..421e6d8d5 --- /dev/null +++ b/docs/changelog/0.14.0.rst @@ -0,0 +1,79 @@ +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. diff --git a/docs/changelog/0.15.0.rst b/docs/changelog/0.15.0.rst new file mode 100644 index 000000000..f1d55f349 --- /dev/null +++ b/docs/changelog/0.15.0.rst @@ -0,0 +1,86 @@ +0.15.0 +====== + +- Add codespell to detect typo +- Add support for fuzzing and badge for oss-fuzz + +osal +^^^^ + +- Allow the use of non-static allocation for FreeRTOS +- Fix FreeRTOS wrong task switch in some cases + +- Fix tu_fifo memory overflown when repeatedly write to overwritable fifo (accumulated more than 2 depths) +- Better support for IAR (ARM) with ci build check for stm32 mcus. +- Fix Windows build for some mingw gnu make situations + +Controller Driver (DCD & HCD) +----------------------------- + +- Add new port support (WIP) for WCH CH32V307 USB Highspeed +- Add new port support (WIP) for PIC32MM/MX & PIC24 + +nRF +^^^ + +- Fix endpoint internal state when closed +- Fix reception of large ISO packets + +rp2040 +^^^^^^ + +- [dcd] Implement workaround for Errata 15. This enable SOF when bulk-in endpoint is in use and reduce its bandwidth to only 80% +- [hcd] Fix shared irq slots filling up when ``hcd_init()`` is called multiple times +- [hcd] Support host bulk endpoint using hw "interrupt" endpoint. Note speed limit is 64KB/s + +- [samd][dcd] Add support for ISO endpoint +- [dwc2][dcd] Add support for stm32u5xx +- [esp32sx] Fix Isochronous transfers only transmitted on even frame +- [lpc_ip3511][dcd] Add isochronous support and fix endpoint accidental write +- [ft90x] Improve and enhance support for FT9xx MCU, tested with more examples + +Device Stack +------------ + +Video +^^^^^ + +- Add support for MJPEG +- Fix probe on macOS + +MIDI +^^^^ + +- Support port name strings +- fix MS Header wTotalLength computation + +HID +^^^ + +- Add FIDO descriptor template +- change length in ``tud_hid_report_complete_cb()`` from ``uint8_t`` to ``uint16_t`` + +CDC +^^^ + +- Fix autoflush for FIFO < MPS +- Fix tx fifo memory overflown when DTR is not set and ``tud_cdc_write()`` is called repeatedly with large enough data + +- [USBTMC] Fix packet size with highspeed + +Host Stack +---------- + +- Retry a few times with transfers in enumeration since device can be unstable when starting up +- [MSC] Rework host mass storage API. Add new ``host/msc_file_explorer`` example + +CDC +^^^ + +- Add support for host cdc +- Fix host cdc with device without IAD e.g Arduino Due + +Contributors +------------ + +Thanks to everyone who contributed to this release: @battlesnake, @benishor, @brtchip-gdm, @DRNadler, @gregdavill, @hadess, @hathach, @hfegran, @HiFiPhile, @jbruneaux31, @jmark1m, @kasjer, @kaysievers, @kilograham, @kkitayam, @kripton, @Lan-Hekary, @LynnL4, @maddyaby, @mingpepe, @nathaniel-brough, @P33M, @pete-pjb, @ReimuNotMoe, @rppicomidi, @scoudreau, @Skyler84, @Staacks, @tore-espressif, @tswan-quasi, @tyustli. diff --git a/docs/changelog/0.16.0.rst b/docs/changelog/0.16.0.rst new file mode 100644 index 000000000..7065f18ff --- /dev/null +++ b/docs/changelog/0.16.0.rst @@ -0,0 +1,165 @@ +0.16.0 +====== + +- New controller driver: MAX3421e (usb host shield), rusb2 (Renesas USB2.0), ChipIdea fullspeed +- New MCUs: MCXn9, nRF5340, STM32: G0, G4, L5, U575, U5A5, RA6m5, CH32F20x +- Add initial TypeC PowerDelivery support with STM32G4 +- Remove submodules and use python script to manage repo dependencies #1947 +- Add CMake support for most families and boards, move build file from tools/ to examples/build_system +- Add ETM trace support with JTrace for nrf52840, nrf5340, mcb1857, stm32h743eval, ra6m5 +- [osal] Make it possible to override the ``osal_task_delay()`` in osal_none +- Add CDC+UAC2 composite device example +- Enhance Hardware-in-the-loop (HIL) testing with more boards: rp2040, stm32l412nucleo, stm32f746disco, lpcxpresso43s67 + +Controller Driver (DCD & HCD) +----------------------------- + +- Add new ISO endpoint API: ``dcd_edpt_iso_alloc()`` and ``dcd_edpt_iso_activate()`` +- Remove legacy driver st/synopsys + +EHCI +^^^^ + +- [iMXRT] Add dache clean/invalidate when memory is in cacheable memory +- Fix portsc write issue which cause problem with enumeration +- Fix an issue when doing port reset write to portsc +- Fix port change detect is not recognized when power on with attached device +- Fix xfer failed with disconnected device as stalled +- Fix error on EHCI causes xfer error in non-queued qhd which cause memory fault +- Un-roll recursive hub removal with usbh queue +- Fix issue when removing queue head +- Implement ``hcd_edpt_abort_xfer()`` +- use standard USB complete interrupt instead of custom chipidea async/period interrupt to be more compatible with other ehci implementation +- refactor usb complete & error isr processing, merge, update. Fix EHCI QHD reuses QTD on wrong endpoint +- Improve bus reset, fix ``send_setup()`` not carried out if halted previously +- Fix clear qhd halted bit if not caused by STALL protocol to allow for next transfer + +ChipIdea Highspeed +^^^^^^^^^^^^^^^^^^ + +- Fix control transfer issue when previous status and new setup complete in the same isr frame +- [imxrt] Add dcache support for cache region + +ChipIdea Fullspeed +^^^^^^^^^^^^^^^^^^ + +- Generalize ChipIdea Fullspeed driver for mcxn9 (port 0), kinetis + +nrf +^^^ + +- Fix DMA race condition with ISO OUT transfer #1946 +- Add support for nRF5340 with pca10095 board + +Renesas rusb2 +^^^^^^^^^^^^^ + +- Generalize rusb2 driver for ra, rx mcus +- rework both dcd and hcd for better multiple ports support +- Add support for board with HS USB port: ra6m5 port1 + +rp2040 +^^^^^^ + +- [dcd] Make writes to SIE_CTRL aware of concurrent access +- [hcd] add ``hcd_frame_number()``, ``hcd_edpt_abort_xfer()`` for pio-usb host + +stm32 fsdev +^^^^^^^^^^^ + +- Add STM32L5 support +- Implement ``dcd_edpt_iso_alloc()`` and ``dcd_edpt_iso_activate()`` + +OHCI +^^^^ + +- Allows configurable root hub ports, handles SMM mode (Ref OHCI spec 5.1.1.3.3) and Bios mode (Ref OHCI spec 5.1.1.3.4) +- Fix FrameIntervalToggle must be toggled after we write the FrameInterval (Ref OHCI Spec 7.3.1) +- Wait PowerOnToPowerGoodTime after we enable power of the RH ports (Ref OHCI Spec 7.4.1) +- Generate port interrupts for devices already connected during init. +- Fix issue when removing queue head +- Disable MIE during IRQ processing and clear HccaDoneHead on completion as per OCHI Spec Page 80 + +Device Stack +------------ + +- Add optional hooks ``tud_event_hook_cb()`` + +Audio (UAC2) +^^^^^^^^^^^^ + +- Fix feedback EP buffer alignment. +- Fix encoding, update example +- Improve IN transfer + +Bluetooth +^^^^^^^^^ + +- Add historical EP compatibility for Bluetooth HCI + +CDC +^^^ + +- Fix line_coding alignment +- Fix typo in cdc line coding enum + +MIDI +^^^^ + +- Fix ``stream_write()`` always writes system messages to cable 0 +- Fix incorrect NOTE_ON, NOTE_OFF definitions + +- USBTMC: Fix tmc488 bit order + +- Vendor: fix ``read()``/``write()`` race condition + +Video (UVC) +^^^^^^^^^^^ + +- Add the capability for video class to handle a bulk endpoint in the streaming interface. + +Host Stack +---------- + +USBH +^^^^ + +- Add new APIs: ``tuh_interface_set()``, ``tuh_task_event_ready()``, ``tuh_edpt_abort_xfer()``, ``tuh_rhport_reset_bus()``, ``tuh_rhport_is_active()`` +- Fix issue when device generate multiple attach/detach/attach when plugging in +- Prefer application callback over built-in driver on transfer complete event +- Correct ``hcd_edpt_clear_stall()`` API signature +- Separate bus reset delay and contact debouncing delay in enumeration +- Support ``usbh_app_driver_get_cb()`` for application drivers +- Fix usbh enumeration removal race condition +- Add optional hooks ``tuh_event_hook_cb()`` + +CDC +^^^ + +- Breaking: change ``tuh_cdc_itf_get_info()`` to use tuh_itf_info_t instead of tuh_cdc_info_t +- Fix cdc host enumeration issue when device does not support line request +- Add support for vendor usb2uart serial: ftdi, cp210x, ch9102f +- Improve sync control API e.g ``tuh_cdc_set_control_line_state()``, ``tuh_cdc_set_line_coding()`` + +HID +^^^ + +- Add new APIs ``tuh_hid_send_report()``, ``tuh_hid_itf_get_info()``, ``tuh_hid_receive_ready()``, ``tuh_hid_send_ready()``, ``tuh_hid_set_default_protocol()`` +- Change meaning of CFG_TUH_HID to total number of HID interfaces supported. Previously ``CFG_TUH_HID`` is max number of interfaces per device which is rather limited and consume more resources than needed. + +HUB +^^^ + +- Fix handling of empty "status change" interrupt +- Fix issue with hub status_change is not aligned + +MSC +^^^ + +- Fix bug in ``tuh_msc_ready()`` +- Fix host msc get maxlun not using aligned section memory + +Contributors +------------ + +Thanks to everyone who contributed to this release: @0xCCF4, @abakosh, @ahooper, @antoniovazquezblanco, @bavison, @bencowperthwaite, @bpaddock, @branalba, @ccrome, @dauc, @dhalbert, @DRNadler, @dsugisawa-mixi, @epatstarkey, @eustas, @facchinm, @gabChouin, @georgeboc, @hathach, @HiFiPhile, @howard0su, @HubertD, @ipopov, @jbtheou, @jefftrull, @jfedor2, @jferreir, @jfm92, @jncronin, @JustAnother1, @kasjer, @kholia, @kilograham, @kkitayam, @koendv, @Krasutski, @kripton, @maidnl, @MattMills, @mikee47, @mndza, @nathaniel-brough, @NullMember, @perigoso, @projectgus, @raiden00pl, @ReimuNotMoe, @Rocky04, @rppicomidi, @Ryzee119, @sinitax, @sjanc, @slark-yuxj, @slc-tl, @Tails86, @tannewt, @tswan-quasi, @tyustli, @Yveaux. diff --git a/docs/changelog/0.17.0.rst b/docs/changelog/0.17.0.rst new file mode 100644 index 000000000..af9a486c3 --- /dev/null +++ b/docs/changelog/0.17.0.rst @@ -0,0 +1,184 @@ +0.17.0 +====== + +General +------- + +- Improved CI: build both cmake and make. Make use of CircleCI for part of build process to speed up CI +- Add CodeQL Workflow for Code Security Analysis +- Add Clang compiler support +- Add default implementation for weak callbacks functions for better Keil compatibility +- Upgrade hardware-in-the-loop (HIL) testing with more boards and examples: including dual stack example + +Controller Driver (DCD & HCD) +----------------------------- + +Chipidea +^^^^^^^^ + +- Support MCXA + +DWC2 +^^^^ + +- Fix tickless issue with stm32f7: disable ULPI clock during sleep when using internal phy +- Fix SOF interrupt handling +- Fix fifo level half/empty issue +- Add DWC2 Test Mode support. +- for esp32 force disconnect/connect using USB_WRAP otg pad override + +FSDEV +^^^^^ + +- Rewrite and Generalize driver to support non-stm32 mcu such as wch +- Simplify PMA, HW FIFO access and bit manipulation for different access scheme 1x16, 2x16 and 32 bit +- Add support for ch32 usbd e.g ch32v203 +- Add support for STM32G4 and STM32U5 microcontrollers. +- Fix h5 (32-bit) errata 2.15.1: Buffer description table update completes after CTR interrupt triggers +- ISO EP buffer allocation improvements, implement ``dcd_edpt_close_all()`` + +- Fix ch32v203 race condition and stability issue with + + - fix ch32v203 seems to unconditionally accept ZLP on EP0 OUT. + - fix v203 race condition between rx bufsize and RX_STAT which cause PMAOVR, occurs with WRITE10 + - correctly handle setup prepare at ``dcd_edpt0_status_complete()``, which fixes the race condition with windows where we could miss setup packet (setup bit set, but count = 0) + +MAX3421E +^^^^^^^^ + +- Add support for rp2040, esp32 (c3, c6, h2, etc..) +- Add ``hcd_deinit()`` for max3421 +- Retry NAK handling next frame to reduce CPU and SPI bus usage +- add ``cpuctl`` and ``pinctl`` to ``tuh_configure()`` option for max3421 +- Implement hcd abort transfer for Max3421 +- Properly Handle NAK Response in MAX3421E driver: correctly switch and skip writing to 2 FIFOs when NAK received. Otherwise, the driver may hang in certain conditions. + +- MSP430: support non-bus-powered + +MUSB +^^^^ + +- Add support for Analoog devices: max32650, max32666, max32690, max3278002 + +nRF +^^^ + +- Fix ``dcd_edpt_open()`` for iso endpoint +- Handle ISOOUT CRC errors +- Add compile support with old nordic sdk +- Fix a few race conditions + +OHCI +^^^^ + +- Allow more than 16 devices + +RP2040 +^^^^^^ + +- Correctly abort control transfer when new setup arrived. Due to RP2040-E2 only able to fix B2 or later +- Implement hcd abort transfer for rp2040 +- Add support for rp2350 + +RUSB2 +^^^^^ + +- Support ra2a1 pipe number scheme + +WCH CH32 +^^^^^^^^ + +- Added support for USB OTG/FS and FSDev Driver. Update CH32V307 to allow manual select FS or HS driver. +- Fixed various bugs in CH32v307 usbhs driver: endpoint handling and data transfer management. + +Device Stack +------------ + +- Add ``tud_deinit()`` and ``class driver deinit()`` to deinitialize TinyUSB device stack. +- Add support for generic SOF callback. +- Add set address recovery time 2ms per USB spec. + +Audio +^^^^^ + +- Add audio_test_freertos & audio_4_channel_mic_freertos +- Improved support for Audio Class 2.0 (UAC2) with various bug fixes. +- Add feedback by fifo counting. + +Bluetooth HCI +^^^^^^^^^^^^^ + +- Issue ZLP on ACL IN ep when transfer is multiple of endpoint max packet size + +CDC +^^^ + +- Add ``tud_cdc_configure_fifo()`` to make RX/TX buffer persistent (not clear when disconnected) +- Add missing capability bit for CDC ACM serial break support +- Enhanced CDC class with better handling of large data transmissions. +- Add missing capability bit for CDC ACM serial break support + +HID +^^^ + +- Added missing key codes for keypad +- Added HID Lighting and Illumination functionality +- Fixed issues in the HID class for more reliable device enumeration. +- Support HID Mouse with absolute positioning +- Use separate buffer for control SET_REPORT, fix conflict with interrupt endpoint out + +- MSC: Added support for SCSI_CMD_PREVENT_ALLOW_MEDIUM_REMOVAL + +Net +^^^ + +- Rewrite of NCM device driver to improve throughput +- removed obsolete ``tud_network_link_state_cb()`` + +- USBTMC Added notification support + +Vendor +^^^^^^ + +- Migrate to new endpoint stream API, support non-buffered TX/RX +- Add ZLP for ``write()`` when needed + +Video +^^^^^ + +- Enhance UVC descriptors and example +- Video Added support for USB Video Class (UVC) with MJPEG. +- Fix multiple interfaces, add an example of 2ch video capture. +- Fix race for ``tud_video_n_streaming()`` check + +Host Stack +---------- + +- Added ``tuh_deinit()`` to de-initialize TinyUSB host stack. +- Added support for new USB mass storage class APIs. +- Improved error handling and retry mechanisms for unstable devices. + +CDC Serial +^^^^^^^^^^ + +- Add support for ch34x +- Allow to overwrite ``CFG_TUH_CDC_FTDI/CP210X/CH32X_VID_PID_LIST`` +- Enhanced stability of CDC-ACM devices during enumeration. + +HID +^^^ + +- Add ``tuh_hid_receive_abort()`` +- Add ``tuh_hid_get_report()`` + +Hub +^^^ + +- Prevent status request to invalid ep_num +- Fix double status xfer +- unroll hub removal + +Contributors +------------ + +Thanks to everyone who contributed to this release: @acscd, @andrewleech, @angmolin, @antoniovazquezblanco, @arntsonl, @b4yuan, @battlesnake, @BrentK-ADI, @camilaodsouza, @cdesjardins, @ChrisDeadman, @clhenry, @cumhuronat, @donatieng, @dp111, @dragonlock2, @duckylotl, @eightycc, @emb4fun, @Erlkoenig90, @feaser, @gschorcht, @hathach, @HiFiPhile, @hinxx, @hjalleboii, @ikskuh, @IngHK, @jerpa77, @jotonedev, @kaidegit, @kasjer, @kaspernyhus, @kilograham, @kkitayam, @Krasutski, @LarssonOliver, @leptun, @liamfraser, @lijunru-hub, @lurch, @Lurcy38, @maflcko, @mamiral, @MatiMcFly, @Okarss, @pigrew, @ra1nb0w, @Rbb666, @rgrr, @Rocky04, @rsolorzanomsft, @Ryzee119, @shuffle2, @slark-yuxj, @tannewt, @thierer, @tinic, @tlyu, @tobozo, @tommie, @trejan, @tyustli, @wjklimek1, @XelaRellum, @Xelus22, @xudongzheng, @YixingShen, @zx96. diff --git a/docs/changelog/0.18.0.rst b/docs/changelog/0.18.0.rst new file mode 100644 index 000000000..05dfd0579 --- /dev/null +++ b/docs/changelog/0.18.0.rst @@ -0,0 +1,62 @@ +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. diff --git a/docs/changelog/0.19.0.rst b/docs/changelog/0.19.0.rst new file mode 100644 index 000000000..dbda59e61 --- /dev/null +++ b/docs/changelog/0.19.0.rst @@ -0,0 +1,247 @@ +0.19.0 +====== + +General +------- + +New MCUs and Boards +^^^^^^^^^^^^^^^^^^^ + +- Add ESP32-H4, ESP32-C5, ESP32-C61 support +- Add STM32U0, STM32WBA, STM32N6 +- Add AT32F405, AT32F403A, AT32F415, AT32F423 support +- Add CH32V305 support and CH32V20x USB host support +- Add MCXA156 SDK 2.16 support and FRDM-MCXA156 board + +API Changes +----------- + +Core APIs +^^^^^^^^^ + +- Add weak callbacks with new syntax for better compiler compatibility +- Add ``tusb_deinit()`` to cleanup stack +- Add time functions: ``tusb_time_millis_api()`` and ``tusb_time_delay_ms_api()`` +- Add ``osal_critical`` APIs for critical section handling +- Introduce ``xfer_isr()`` callback for ISO transfer optimization in device classes + +Device APIs +^^^^^^^^^^^ + +- CDC: Add notification support ``tud_cdc_configure()``, ``tud_cdc_n_notify_uart_state()``, + ``tud_cdc_n_notify_conn_speed_change()``, ``tud_cdc_notify_complete_cb()`` +- MSC: Add ``tud_msc_inquiry2_cb()`` with bufsize parameter, update ``tud_msc_async_io_done()`` + with ``in_isr`` parameter +- Audio: Add ``tud_audio_n_mounted()`` and various FIFO access functions +- MTP: Add ``tud_mtp_mounted()``, ``tud_mtp_data_send()``, ``tud_mtp_data_receive()``, + ``tud_mtp_response_send()``, ``tud_mtp_event_send()`` + +Host APIs +^^^^^^^^^ + +- Core: Add ``tuh_edpt_close()``, ``tuh_address_set()``, ``tuh_descriptor_get_device_local()``, + ``tuh_descriptor_get_string_langid()``, ``tuh_connected()``, ``tuh_bus_info_get()`` +- Add enumeration callbacks: ``tuh_enum_descriptor_device_cb()``, + ``tuh_enum_descriptor_configuration_cb()`` +- CDC: Add ``tuh_cdc_get_control_line_state_local()``, ``tuh_cdc_get/set_dtr/rts()``, + ``tuh_cdc_connect/disconnect()`` and sync versions of all control APIs +- MIDI: Add ``tuh_midi_itf_get_info()``, ``tuh_midi_packet_read_n()``, + ``tuh_midi_packet_write_n()``, ``tuh_midi_read_available()``, ``tuh_midi_write_flush()``, + ``tuh_midi_descriptor_cb()`` + +Controller Driver (DCD & HCD) +----------------------------- + +DWC2 +^^^^ + +- Support DWC2 v4.30a with improved reset procedure +- Fix core reset: wait for AHB idle before reset +- Add STM32 DWC2 data cache support with proper alignment +- Host improvements: + - Fix disconnect detection and SOF flag handling + - Fix HFIR timing off-by-one error + - Retry IN token immediately for bInterval=1 + - Proper attach debouncing (200ms) + - Fix all retry intervals + - Resume OUT transfer when PING ACKed +- Fix enumeration racing conditions +- Refactor bitfields for better code generation + +FSDEV (STM32) +^^^^^^^^^^^^^ + +- Fix AT32 compile issues after single-buffered endpoint changes +- Add configurable single-buffered isochronous endpoints +- Fix STM32H7 recurrent suspend ISR +- Fix STM32L4 GPIOD clock enable for variants without GPIOD +- Fix STM32 PHYC PLL stability wait +- Improve PMA size handling for STM32U0 + +EHCI +^^^^ + +- Fix removed QHD getting reused +- Fix NXP USBPHY disconnection detection + +Chipidea/NXP +^^^^^^^^^^^^ + +- Fix race condition with spinlock +- Improve iMXRT support: fix build, disable BOARD_ConfigMPU, fix attach debouncing on port1 highspeed +- Fix iMXRT1064 and add to HIL test pool + +MAX3421E +^^^^^^^^ + +- Use spinlock for thread safety instead of atomic flag +- Implement ``hcd_edpt_close()`` + +RP2040 +^^^^^^ + +- Fix audio ISO transfer: reset state before notifying stack +- Fix CMake RTOS cache variable +- Abort transfer if active in ``iso_activate()`` + +SAMD +^^^^ + +- Add host controller driver support + +Device Stack +------------ + +USBD Core +^^^^^^^^^ + +- Introduce ``xfer_isr()`` callback for interrupt-time transfer handling +- Add ``usbd_edpt_xfer_fifo()`` stub +- Revert endpoint busy/claim status if ``xfer_isr()`` defers to ``xfer_cb()`` + +Audio +^^^^^ + +- Major simplification of UAC driver and alt settings management +- Move ISO transfers into ``xfer_isr()`` for better performance +- Remove FIFO mutex (single producer/consumer optimization) +- Add implicit feedback support for data IN endpoints +- Fix alignment issues +- Update buffer macros with cache line size alignment + +CDC +^^^ + +- Add notification support: ``CFG_TUD_CDC_NOTIFY``, ``tud_cdc_n_notify_conn_speed_change()``, ``tud_cdc_notify_complete_cb()`` +- Reduce default bInterval from 16ms to 1ms for better responsiveness +- Rename ``tud_cdc_configure_fifo()`` to ``tud_cdc_configure()`` and add ``tx_overwritable_if_not_connected`` option +- Fix web serial robustness with major overhaul and logic cleanup + +HID +^^^ + +- Add Usage Page and Table for Power Devices (0x84 - 0x85) +- Fix HID descriptor parser variable size and 4-byte item handling +- Add consumer page configurations + +MIDI +^^^^ + +- Fix MIDI interface descriptor handling after audio streaming interface +- Skip RX data with all zeroes + +MSC +^^^ + +- Add async I/O support for MSC using ``tud_msc_async_io_done()`` +- Add ``tud_msc_inquiry2_cb()`` with bufsize for full inquiry response + +MTP +^^^ + +- Add new Media Transfer Protocol (MTP) device class driver +- Support MTP operations: GetDeviceInfo, SendObjectInfo, SendObject +- Add MTP event support with ``tud_mtp_event_send()`` +- Implement filesystem example with callbacks +- Add hardware-in-the-loop testing support + +NCM +^^^ + +- Add USB NCM link state control support +- Fix DHCP offer/ACK destination + +USBTMC +^^^^^^ + +- Add vendor-specific message support + +Vendor +^^^^^^ + +- Fix vendor device reset and open issues +- Fix descriptor parsing for ``CFG_TUD_VENDOR > 1`` +- Fix vendor FIFO argument calculation + +Host Stack +---------- + +USBH Core +^^^^^^^^^ + +- Major enumeration improvements: + - Fix enumeration racing conditions + - Add proper attach debouncing with hub/rootport handling (200ms delay) + - Reduce ``ENUM_DEBOUNCING_DELAY_MS`` to 200ms + - Always get language ID, manufacturer, product, and serial strings during enumeration + - Always get first 2 bytes of string descriptor to determine length (prevents buffer overflow) + - Support devices with multiple configurations +- Add ``tuh_enum_descriptor_device_cb()`` and ``tuh_enum_descriptor_configuration_cb()`` callbacks +- Add ``tuh_descriptor_get_string_langid()`` API +- Hub improvements: + - Check status before getting first device descriptor + - Properly handle port status and change detection + - Queue status endpoint for detach/remove events + - Fix hub status change endpoint handling +- Fix endpoint management: + - ``hcd_edpt_open()`` returns false if endpoint already opened + - Add ``hcd_edpt_close()`` implementation + - Abort pending transfers on close +- Add roothub debouncing flag to ignore attach/remove during debouncing +- Move address setting and bus info management to separate structures +- Force removed devices in same bus info before setting address + +CDC Serial Host +^^^^^^^^^^^^^^^ + +- Major refactor to generalize CDC serial drivers (FTDI, CP210x, CH34x, PL2303, ACM) +- Add explicit ``sync()`` API with ``TU_API_SYNC()`` returning ``tusb_xfer_result_t`` +- Rename ``tuh_cdc_get_local_line_coding()`` to ``tuh_cdc_get_line_coding_local()`` +- Add ``tuh_cdc_get_control_line_state_local()`` +- Implement ``tuh_cdc_get/set_dtr/rts()`` as inline functions + +MIDI Host +^^^^^^^^^ + +- Major API changes: + - Rename ``tuh_midi_stream_flush()`` to ``tuh_midi_write_flush()`` + - Add ``tuh_midi_packet_read_n()`` and ``tuh_midi_packet_write_n()`` + - Add ``CFG_TUH_MIDI_STREAM_API`` to opt out of stream API + - Change API to use index instead of device address (supports multiple MIDI per device) +- Rename ``tuh_midi_get_num_rx/tx_cables()`` to ``tuh_midi_get_rx/tx_cable_count()`` +- Add ``tuh_midi_descriptor_cb()`` and ``tuh_midi_itf_get_info()`` + +MSC Host +^^^^^^^^ + +- Continue async I/O improvements + +HID Host +^^^^^^^^ + +- Fix version string to actually show version + +Contributors +------------ + +Thanks to everyone who contributed to this release: @andrewleech, @armusin, @atoktoto, @byteit101, @ceedriic, @ChrisDeadman, @Cynventria, @dauc, @Dazza0, @deshipu, @Dolphindalt, @ehughes, @elipsitz, @fenugrec, @hathach, @HiFiPhile, @ho-ho-ho, @igi540, @IngHK, @Isoheptane, @james-advatek, @JannisKonradBecker, @jay94ks, @joelpmichael, @karlp, @kasjer, @ludoux, @majbthrd, @martijnvdwoude, @maximevince, @Milek7, @ning3270455369, @ohmdelta, @peppapighs, @pschatzmann, @PwnVerse, @raldone01, @ReimuNotMoe, @rhgndf, @roundby, @rppicomidi, @s09289728096, @salkinium, @tannewt, @terjr, @tore-espressif, @verylowfreq, @YixingShen, @ZakDanger. diff --git a/docs/changelog/0.20.0.rst b/docs/changelog/0.20.0.rst new file mode 100644 index 000000000..d5952a830 --- /dev/null +++ b/docs/changelog/0.20.0.rst @@ -0,0 +1,107 @@ +0.20.0 +====== + +*November 19, 2025* + +General +------- + +New MCUs and Boards +^^^^^^^^^^^^^^^^^^^ + +- Add STM32U3 device support (adjusted from STM32U0) +- Add nRF54H20 support with initial board configuration +- Rename board names: pca10056→nrf52840dk, pca10059→nrf52840dongle, pca10095→nrf5340dk +- Improve CMake: Move startup and linker files from board target to executable. Enhance target warning flags and fix various build warnings + +Code Quality and Static Analysis +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +- Add PVS-Studio static analysis to CI +- Add SonarQube scan support +- Add IAR C-Stat analysis capability +- Add ``.clang-format`` for consistent code formatting +- Fix numerous alerts and warnings found by static analysis tools + +Documentation +^^^^^^^^^^^^^ + +- Improve Getting Started documentation structure and flow +- Add naming conventions and buffer handling documentation + +Controller Driver (DCD & HCD) +----------------------------- + +DWC2 +^^^^ + +- Fix incorrect handling of Zero-Length Packets (ZLP) in the DWC2 driver when receiving data (OUT transfers) +- Improve EP0 multi-packet logic +- Support EP0 with max packet size = 8 +- For IN endpoint, write initial packet directly to FIFO and only use TXFE interrupt for subsequent packets +- Fix ISO with bInterval > 2 using incomplete IN interrupt handling. +- Fix compile issues when enabling both host and device +- Clear pending suspend interrupt after USB reset (enum end) +- Improve host closing endpoint and channel handling when device is unplugged + +FSDEV (STM32) +^^^^^^^^^^^^^ + +- Fix AT32 USB interrupt remapping in ``dcd_int_enable()`` + +OHCI +^^^^ + +- Add initial LPC55 OHCI support +- Improve data cache support + +Device Stack +------------ + +USBD Core +^^^^^^^^^ + +- Support configurable EP0 buffer size CFG_TUD_ENDPOINT0_BUFSIZE +- Make dcd_edpt_iso_alloc/activate as default API for ISO endpoint + +Audio +^^^^^ + +- Add UAC1 support +- Implement RX FIFO threshold adjustment with ``tud_audio_get/set_ep_in_fifo_threshold()`` + +CDC +^^^ + +- Migrate to endpoint stream API + +HID +^^^ + +- Fix HID stylus descriptor + +MIDI +^^^^ + +- Migrate to endpoint stream API +- Add ``tud_midi_n_packet_write_n()`` and ``tud_midi_n_packet_read_n()`` + +MTP +^^^ + +- Fix incorrect MTP xact_len calculation + +Video +^^^^^ + +- Add bufferless operation callback for dynamic frame generation with tud_video_prepare_payload_cb() + +Host Stack +---------- + +No changes + +Contributors +------------ + +Thanks to everyone who contributed to this release: @adam-embedded, @ArcaneNibble, @c1570, @embedded-ideas, @gabChouin, @hathach, @HiFiPhile, @karlp, @ldube, @peppapighs, @poornadharshan13-rgb, @RigoLigoRLC, @tangpipi, @ToonVanEyck, @tswan22. diff --git a/docs/changelog/0.21.0.rst b/docs/changelog/0.21.0.rst new file mode 100644 index 000000000..bae39770e --- /dev/null +++ b/docs/changelog/0.21.0.rst @@ -0,0 +1,213 @@ +0.21.0 +====== + +*June 29, 2026* + +General +------- + +New MCUs and Boards +^^^^^^^^^^^^^^^^^^^ + +- Add HPMicro HPM6xxx support with HPM6750EVK2 board +- Add NXP RW61x (RW612, ChipIdea high-speed) support +- Add Artery AT32F45x series support +- Add STM32C5 series support +- Add Espressif ESP32-S31 (high-speed) support +- Add WCH CH582/CH583 (USBFS) support +- Add CH32V103 USB device support (combined-control USBFS) with CH32V103C8T6 Bluepill board +- Add FreeRTOS support for RP2040/RP2350 +- New boards: nRF54LM20-DK, WeAct STM32H743, EK-TM4C1294XL, STM32H747-DISCO, NUCLEO-H533RE +- Migrate i.MX RT to the new ``mcux-devices-rt`` SDK package + +Code Quality and Build +^^^^^^^^^^^^^^^^^^^^^^ + +- Major refactor of dedicated hardware-FIFO (HWFIFO) handling: omit per-endpoint RAM buffers on ports with a dedicated hardware FIFO, add stride-aware FIFO access, and store raw bytes in ``tusb_fifo`` +- Reduce code size via control/descriptor and stream refactors, and remove ``snprintf`` usage +- Remove IAR toolchain support from the Make build; add IAR warning flags and resolve warnings in CMake +- Fix Zephyr build with nrfx v4, C++/``-Werror=extra`` builds, and various ``-Wconversion`` warnings +- Update FatFS to R0.16 +- Fix the fuzzing harness +- Various BSP fixes (STM32H5 UID read with ICACHE, STM32F411 Black Pill HSE, RT1011 data cache, Teensy) + +Documentation +^^^^^^^^^^^^^ + +- Add a README for every example and ``build-doc`` tooling +- Add Sponsors section and ``FUNDING`` configuration +- Various README/doc fixes (FTDI host, STM32C071 Nucleo URL, Supported CPUs table) + +API Changes +----------- + +- Add ``is_isr`` parameter to ``dcd_edpt_xfer``, ``dcd_edpt_xfer_fifo``, ``usbd_edpt_xfer`` and ``usbd_edpt_xfer_fifo`` +- Remove the no-FIFO mode from the endpoint stream API +- Add ``tud_vendor_write_clear()`` to forcefully clear the TX buffer +- Add ``tud_midi_n_demux_stream_read()`` cable-aware MIDI stream read +- Add ``CFG_TUH_HID_SET_PROTOCOL_ON_ENUM`` host HID option +- Add ``CFG_TUSB_DEBUG_BREAKPOINT`` hook for ``TU_BREAKPOINT`` +- Add ThreadX OSAL support +- ``tud_task_ext()`` / ``tuh_task_ext()`` now limit the number of events processed per call +- Replace ``CFG_TUD_NET_ENDPOINT_SIZE`` with the descriptor-based endpoint size + +Device Stack +------------ + +USBD Core +^^^^^^^^^ + +- Refactor and validate device descriptor handling; move control transfer handling into ``usbd.c`` +- Use the EP0 buffer directly when large enough; clamp EP0 OUT data copy to the control buffer +- Fix stream write logic/racing without FIFO; fix zero ``wLength`` control request +- Fix ISO OUT endpoint failure on alt-setting MPS change + +Audio +^^^^^ + +- Fix ``audiod_open`` with MIDI interfaces +- Fix big-endian bitfield guards for audio structs and endian-safe ``wValue``/``wIndex`` extraction in UAC2 examples + +CDC +^^^ + +- Remove ``tud_cdc_configure`` +- Fix CDC echo test issue on i.MX RT and fast MCUs + +HID +^^^ + +- Bound item size to remaining length in the report-descriptor parser +- Remove host enumeration assumption; add ``CFG_TUH_HID_SET_PROTOCOL_ON_ENUM`` + +MIDI +^^^^ + +- Add USB-MIDI 2.0 device and host class drivers +- Add cable-aware stream read ``tud_midi_n_demux_stream_read()`` +- Fix MIDI host issue + +MSC +^^^ + +- Skip the command stage if the OUT endpoint is stalled +- Cap ``tud_msc_scsi_cb`` buffer size to the endpoint buffer size + +MTP +^^^ + +- Fix transfer completion detection for exact-length packets; queue ZLP when needed +- Fix premature phase change after a short OUT transfer; fixes in ``add_string`` + +Network (NCM) +^^^^^^^^^^^^^ + +- Fix NCM state on restart +- Support ``SetEthernetPacketFilter`` and ``SetNtbInputSize`` requests +- Add a weak callback for the initial link state + +Video (UVC) +^^^^^^^^^^^ + +- Fix VC interface parsing when ``bNumEndpoints`` != 0 +- Assert the ``usbd_edpt_iso_activate()`` result + +DFU +^^^ + +- Fix the DFU functional descriptor version (1.0.1 → 1.1.0) + +Printer +^^^^^^^ + +- Add the USB Printer device class driver + +Vendor +^^^^^^ + +- Omit the endpoint buffer for ports with a dedicated hardware FIFO + +Host Stack +---------- + +- Fully asynchronous host code: remove blocking delays from ``tuh_task_ext()``, respect its ``timeout_ms``, and avoid stalling one device while another enumerates +- Add an async control-transfer FIFO so queued control transfers are dispatched instead of dropped +- Hub enumeration reliability improvements; add MTT hub support +- Support full-speed host with a high-speed PHY (DWC2) +- Fix FTDI host multi-channel loop +- CDC host: use a local control buffer; fix ``cdch_open`` typo +- Big-endian host support for SETUP packet handling +- Use ``TUSB_ROLE_HOST`` in host stack initialization + +Controller Driver (DCD & HCD) +----------------------------- + +DWC2 +^^^^ + +- Add ``dcd_configure`` for FIFO config and DWC2 deinit support +- Support full-speed host operation on a high-speed PHY +- Vbus sensing enhancement; do not modify FS PHY registers on HS PHY (ESP32-P4) +- Fix HCD TX FIFO full check, ISO IN endpoint disabled after incomplete transfer, and EP0 status completion before SETUP +- Submit SETUP on SETUP_DONE and handle v3.10a spurious RX_COMPLETE (STM32L476) +- HCD: correct HFIR for low-speed devices via internal FS PHY; fix split-IN NAK storm and UART starvation (STM32F723) + +FSDEV (STM32 / CH32) +^^^^^^^^^^^^^^^^^^^^ + +- Add FSDEV host (HCD) driver +- Refactor FSDEV; share the PMA errata delay helper between DCD/HCD with overridable timing +- Fix single-buffered isochronous endpoint cases, STM32U0 data stride, and PMA pointer advance on ring-buffer wrap +- Fix CH32V20x enumeration by enabling the D+ pull-up; work around CH32 EP0 premature OUT ACK +- Do not enable the unused USB wakeup EXTI IRQ (F1/F3/G4/L1) + +MUSB +^^^^ + +- Enhance driver: double packet, EP0 refactor, fix DATAEND race with EP0 +- Fix ZLP IN transfer, RXRDY clearing, and defer EP0 SETUP during the DATA_IN/STATUS race + +RP2040 / RP2350 +^^^^^^^^^^^^^^^ + +- Refactor RP2 driver +- HCD rework: EPX for non-interrupt endpoints and ping-pong double buffering +- Fix RP2350 hard fault in unaligned memcpy to USB DPRAM +- Host: fix OUT-data control transfers sending DATA0 instead of DATA1 + +CH32 USBFS / USBHS (WCH) +^^^^^^^^^^^^^^^^^^^^^^^^ + +- Fix dropped bulk OUT packets by re-arming the EP_RX_CTRL state (usbfs) +- Fix endpoint stall length index and clear-stall response (usbhs) +- Fix CH32V103 hard fault + +RUSB2 / SAMx7x +^^^^^^^^^^^^^^ + +- Fix RUSB2 FIFO write +- Refresh ``dcd_samx7x`` + +New host controllers +^^^^^^^^^^^^^^^^^^^^ + +- Add NXP IP3516 HCD (EHCI-like) +- Add MTT (multi-TT) hub support + +nRF5x +^^^^^ + +- Request HFCLK in ``USB_EVT_READY`` to fix the post-SoftDevice deadlock + +Testing +------- + +- Expand Hardware-in-the-Loop (HIL) coverage (MTP, audio, throughput; nanoch32v203, ch32v103, stm32u083nucleo, tm4c123x) and post pass/fail/skip HIL reports as PR comments +- Add MemBrowse code-size CI integration and size-difference reporting +- Add automated Claude Code PR review and bug-fix CI workflows +- Add ``hil``, ``code-size``, ``pvs``, ``usbmon`` and ``build-doc`` developer skills + +Contributors +------------ + +Thanks to everyone who contributed to this release: @Alex-Schaefer, @alt-0191, @andrewleech, @armusin, @bdolgov, @BrentK-ADI, @ceedriic, @chenzhihong007, @dangfan, @DavidKorczynski, @dinsfire64, @dxbjavid, @embedded-ideas, @felhub, @gab-k, @gabChouin, @HakanL, @hathach, @HiFiPhile, @igi540, @IntegraSources, @kira-live, @LeZerb, @michael-membrowse, @michaelajax, @mickabrig7, @Milek7, @morse-cedricvandenbergh, @nminaylov, @non-bin, @Phozer, @remiberthoz, @renjieah, @rhgndf, @RobertDaleSmith, @roma-jam, @sauloverissimo, @sgrunza-at-BadgerMeter, @sidcha, @StefanOroel, @Tails86, @thamul, @tore-espressif, @UMRnInside, @ValentiWorkLearning, @verylowfreq, @wjklimek1, @YixingShen, @zhiqiang-ch, @zjzhang-cn. diff --git a/docs/changelog/0.5.0.rst b/docs/changelog/0.5.0.rst new file mode 100644 index 000000000..676ae2fd0 --- /dev/null +++ b/docs/changelog/0.5.0.rst @@ -0,0 +1,15 @@ +0.5.0 +===== + +*2019-06* + +First release, device stack works great, host stack works but still need improvement. + +- Special thanks to @adafruit team, especially @tannewt to help out immensely to rework device stack: simplify osal & control transfer, adding SAMD21/SAMD51 ports, writing porting docs, adding MIDI class support etc... +- Thanks to @cr1901 for adding STM32F4 port. +- Thanks to @PTS93 and @todbot for HID raw API + +Contributors +------------ + +Thanks to everyone who contributed to this release: @cr1901, @gpshead, @hathach, @mithro, @tannewt, @timonsku, @zardam. diff --git a/docs/changelog/0.6.0.rst b/docs/changelog/0.6.0.rst new file mode 100644 index 000000000..5ec65f302 --- /dev/null +++ b/docs/changelog/0.6.0.rst @@ -0,0 +1,70 @@ +0.6.0 +===== + +*2020-03-30* + +Added **CONTRIBUTORS.md** to give proper credit for contributors to the stack. Special thanks to `Nathan Conrad `__ , `Peter Lawrence `__ , `William D. Jones `__ and `Sean Cross `__ and others for spending their precious time to add lots of features and ports for this release. + +Added +----- + +MCU +^^^ + +- Added support for Microchip SAMG55 +- Added support for Nordic nRF52833 +- Added support for Nuvoton: NUC120, NUC121/NUC125, NUC126, NUC505 +- Added support for NXP LPC: 51Uxx, 54xxx, 55xx +- Added support for NXP iMXRT: RT1011, RT1015, RT1021, RT1052, RT1062, RT1064 +- Added support for Sony CXD56 (Spresense) +- Added support for STM32: L0, F0, F1, F2, F3, F4, F7, H7 +- Added support for TI MSP430 +- Added support for ValentyUSB's eptri + +Class Driver +^^^^^^^^^^^^ + +- Added DFU Runtime class driver +- Added Network class driver with RNDIS, CDC-ECM, CDC-EEM (work in progress) +- Added USBTMC class driver +- Added WebUSB class driver using vendor-specific class +- Added multiple instances support for CDC and MIDI +- Added a handful of unit test with Ceedling. +- Added LOG support for debugging with CFG_TUSB_DEBUG +- Added ``tud_descriptor_bos_cb()`` for BOS descriptor (required for USB 2.1) +- Added ``dcd_edpt0_status_complete()`` as optional API for DCD + +Examples +^^^^^^^^ + +Following examples are added: + +- ``board_test`` +- ``cdc_dual_ports`` +- ``dfu_rt`` +- ``hid_composite`` +- ``net_lwip_webserver`` +- ``usbtmc`` +- ``webusb_serial`` + +Changed +------- + +- Changed ``tud_descriptor_string_cb()`` to have additional Language ID argument +- Merged ``hal_nrf5x.c`` into ``dcd_nrf5x.c`` +- Merged ``dcd_samd21.c`` and ``dcd_samd51.c`` into ``dcd_samd.c`` +- Generalized ``dcd_stm32f4.c`` to ``dcd_synopsys.c`` +- Changed ``cdc_msc_hid`` to ``cdc_msc`` (drop hid) due to limited endpoints number of some MCUs +- Improved DCD SAMD stability, fix missing setup packet occasionally +- Improved ``usbd/usbd_control`` with proper handling of zero-length packet (ZLP) +- Improved STM32 DCD FSDev +- Improved STM32 DCD Synopsys +- Migrated CI from Travis to Github Action +- Updated nrfx submodule to 2.1.0 +- Fixed mynewt osal queue definition +- Fixed ``cdc_msc_freertos`` example build for all MCUs + +Contributors +------------ + +Thanks to everyone who contributed to this release: @an-dr, @arturo182, @chang196700, @cr1901, @hathach, @jepler, @jeremyherbert, @kamtom480, @kasjer, @ladyada, @majbthrd, @mateusz-holenko, @noebrun, @nxf58843, @pigrew, @samveen, @smunaut, @tannewt, @xobs. diff --git a/docs/changelog/0.7.0.rst b/docs/changelog/0.7.0.rst new file mode 100644 index 000000000..664b323c8 --- /dev/null +++ b/docs/changelog/0.7.0.rst @@ -0,0 +1,159 @@ +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 `__ 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. diff --git a/docs/changelog/0.8.0.rst b/docs/changelog/0.8.0.rst new file mode 100644 index 000000000..38f51ba6b --- /dev/null +++ b/docs/changelog/0.8.0.rst @@ -0,0 +1,101 @@ +0.8.0 +===== + +*2021-02-05* + +Device Controller Driver +------------------------ + +- Added new device support for Raspberry Pi RP2040 +- Added new device support for NXP Kinetis KL25ZXX +- Use ``dcd_event_bus_reset()`` with link speed to replace bus_signal + +ESP32-S2 +^^^^^^^^ + +- Add bus suspend and wakeup support + +SAMD21 +^^^^^^ + +- Fix (workaround) samd21 setup_packet overflow by USB DMA + +STM32 Synopsys +^^^^^^^^^^^^^^ + +- Rework USB FIFO allocation scheme and allow RX FIFO size reduction + +Sony CXD56 +^^^^^^^^^^ + +- Update Spresense SDK to 2.0.2 +- Fix dcd issues with setup packets +- Correct EP number for cdc_msc example + +USB Device +---------- + +USBD +^^^^ + +- Rework usbd control transfer to have additional stage parameter for setup, data, status +- Fix ``tusb_init()`` return true instead of ``TUSB_ERROR_NONE`` +- Added new API ``tud_connected()`` that return true after device got out of bus reset and received the very first setup packet + +CDC +^^^ + +- Allow to transmit data, even if the host does not support control line states i.e set DTR + +HID +^^^ + +- change default ``CFG_TUD_HID_EP_BUFSIZE`` from 16 to 64 + +MIDI +^^^^ + +- Fix midi sysex sending bug + +MSC +^^^ + +- Invoke only scsi complete callback after status transaction is complete. +- Fix ``scsi_mode_sense6_t`` padding, which cause IAR compiler internal error. + +USBTMC +^^^^^^ + +- Change interrupt endpoint example size to 8 instead of 2 for better compatibility with mcu + +Example +^^^^^^^ + +- Support make from windows ``cmd.exe`` +- Add HID Consumer Control (media keys) to ``hid_composite`` & ``hid_composite_freertos`` examples + +USB Host +-------- + +No noticeable changes to host stack + +New Boards +---------- + +- NXP/Freescale Freedom FRDM-KL25Z +- Feather Double M33 express +- Raspberry Pi Pico +- Adafruit Feather RP2040 +- Adafruit Itsy Bitsy RP2040 +- Adafruit QT RP2040 +- Adfruit Feather ESP32-S2 +- Adafruit Magtag 29" Eink +- Adafruit Metro ESP32-S2 +- Adafruit PyBadge +- Adafruit PyPortal +- Great Scott Gadgets' LUNA D11 & D21 + +Contributors +------------ + +Thanks to everyone who contributed to this release: @aslampr07, @charkster, @dobairoland, @duempel, @gsteiert, @hathach, @HiFiPhile, @kamtom480, @kkitayam, @ktemkin, @majbthrd, @PanRe, @prplz. diff --git a/docs/changelog/0.9.0.rst b/docs/changelog/0.9.0.rst new file mode 100644 index 000000000..a48642144 --- /dev/null +++ b/docs/changelog/0.9.0.rst @@ -0,0 +1,126 @@ +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. diff --git a/docs/changelog/index.rst b/docs/changelog/index.rst new file mode 100644 index 000000000..833008cd6 --- /dev/null +++ b/docs/changelog/index.rst @@ -0,0 +1,27 @@ +********* +Changelog +********* + +Release notes for each TinyUSB version, newest first. + +.. toctree:: + :maxdepth: 1 + + 0.21.0 + 0.20.0 + 0.19.0 + 0.18.0 + 0.17.0 + 0.16.0 + 0.15.0 + 0.14.0 + 0.13.0 + 0.12.0 + 0.11.0 + 0.10.1 + 0.10.0 + 0.9.0 + 0.8.0 + 0.7.0 + 0.6.0 + 0.5.0 diff --git a/docs/index.rst b/docs/index.rst index c3cee41da..38cb4d870 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -18,7 +18,7 @@ troubleshooting faq maintainers - info/changelog/index + changelog/index .. toctree:: :maxdepth: 2 diff --git a/docs/info/changelog/0.10.0.rst b/docs/info/changelog/0.10.0.rst deleted file mode 100644 index 7c11dd176..000000000 --- a/docs/info/changelog/0.10.0.rst +++ /dev/null @@ -1,83 +0,0 @@ -0.10.0 -====== - -*2021-05-28* - -- Rework tu_fifo_t with separated mutex for read and write, better support DMA with read/write buffer info. And constant address mode -- Improve audio_test example and add audio_4_channel_mic example -- Add new dfu example -- Remove pico-sdk from submodule - -Device Controller Driver (DCD) ------------------------------- - -- Add new DCD port for Silabs EFM32GG12 with board Thunderboard Kit (SLTB009A) -- Add new DCD port Renesas RX63N, board GR-CITRUS -- Add new (optional) endpoint API dcd_edpt_xfer_fifo -- Fix build with nRF5340 -- Fix build with lpc15 and lpc54 -- Fix build with lpc177x_8x -- STM32 Synopsys: greatly improve Isochronous transfer with ``edpt_xfer_fifo()`` API -- Support LPC55 port1 highspeed -- Add support for Espressif esp32s3 -- nRF: fix race condition that could cause drop packet of Bulk OUT transfer - -USB Device Driver (USBD) ------------------------- - -- Add new (optional) endpoint ADPI ``usbd_edpt_xfer_fifo()`` - -Device Class Driver -------------------- - -CDC -^^^ - -- [Breaking] ``tud_cdc_peek()``, ``tud_vendor_peek()`` no longer support random offset and dropped position parameter. - -DFU -^^^ - -- Add new DFU 1.1 class driver (WIP) - -HID -^^^ - -- Fix keyboard report descriptor template -- Add more hid keys constant from 0x6B to 0xA4 -- [Breaking] rename API - - - ``HID_PROTOCOL_NONE/KEYBOARD/MOUSE`` to ``HID_ITF_PROTOCOL_NONE/KEYBOARD/MOUSE`` - - ``tud_hid_boot_mode()`` to ``tud_hid_get_protocol()`` - - ``tud_hid_boot_mode_cb()`` to ``tud_hid_set_protocol_cb()`` - -MIDI -^^^^ - -- Fix MIDI buffer overflow issue -- [Breaking] rename API - - - Rename ``tud_midi_read()`` to ``tud_midi_stream_read()`` - - Rename ``tud_midi_write()`` to ``tud_midi_stream_write()`` - - Rename ``tud_midi_receive()`` to ``tud_midi_packet_read()`` - - Rename ``tud_midi_send()`` to ``tud_midi_packet_write()`` - -Host Controller Driver (HCD) ----------------------------- - -- No noticeable changes - -USB Host Driver (USBH) ----------------------- - -- No noticeable changes - -Host Class Driver ------------------ - -- HID: Rework host hid driver, basically everything changes - -Contributors ------------- - -Thanks to everyone who contributed to this release: @alisitsyn, @corvus-ossifragus, @hathach, @jgressmann, @joeycastillo, @kapacuk, @kasjer, @kkitayam, @ned-pcs, @noodlefighter, @ogatatsu, @PanRe, @perigoso, @pigrew, @sjanc, @xmos-jmccarthy. diff --git a/docs/info/changelog/0.10.1.rst b/docs/info/changelog/0.10.1.rst deleted file mode 100644 index 30f1bbd98..000000000 --- a/docs/info/changelog/0.10.1.rst +++ /dev/null @@ -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. diff --git a/docs/info/changelog/0.11.0.rst b/docs/info/changelog/0.11.0.rst deleted file mode 100644 index c27b027dd..000000000 --- a/docs/info/changelog/0.11.0.rst +++ /dev/null @@ -1,107 +0,0 @@ -0.11.0 -====== - -*2021-08-29* - -- Add host/hid_controller example: only worked/tested with Sony PS4 DualShock controller -- Add device/hid_boot_interface example -- Add support for Renesas CCRX toolchain for RX mcu - -Device Controller Driver (DCD) ------------------------------- - -- Add new DCD port for SAMx7x (E70, S70, V70, V71) -- Add new mcu K32L2Bxx -- Add new mcu GD32VF103 -- Add new mcu STM32l151 -- Add new mcu SAML21 -- Add new mcu RX65n RX72n -- Fix NUC120/121/126 USBRAM can only be accessed in byte manner. Also improve set_address & disable sof -- Add Suspend/Resume handling for Renesas RX family. -- Fix DA1469x no VBUS startup - -Synopsys -^^^^^^^^ - -- Fix Synopsys set address bug which could cause re-enumeration failed -- Fix ``dcd_synopsys`` driver integer overflow in HS mode (issue #968) - -nRF5x -^^^^^ - -- Add nRF5x suspend, resume and remote wakeup -- Fix nRF5x race condition with ``TASKS_EP0RCVOUT`` - -RP2040 -^^^^^^ - -- Add RP2040 suspend & resume support -- Implement double buffer for both host and device (#891). However device EPOUT is still single buffered due to technical issue with short packet - -Device Stack ------------- - -USBD -^^^^ - -- Better support big endian mcu -- Add ``tuh_inited()`` and ``tud_inited()``, will separate ``tusb_init/inited()`` to ``tud/tuh_init/inited()`` -- Add ``dcd_attr.h`` for defining common controller attribute such as max endpoints - -Bluetooth -^^^^^^^^^ - -- Fix stridx error in descriptor template - -DFU -^^^ - -- Enhance DFU implementation to support multiple alternate interface and better support ``bwPollTimeout`` -- Rename ``CFG_TUD_DFU_MODE`` to simply ``CFG_TUD_DFU`` - -HID -^^^ - -- Fix newline usage keyboard (ENTER 0x28) -- Better support Hid Get/Set report -- Change max gamepad support from 16 to 32 buttons - -MIDI -^^^^ - -- Fix midi available -- Fix midi data -- Fix an issue when calling midi API when not enumerated yet - -UAC2 -^^^^ - -- Fix bug and enhance of UAC2 - -Vendor -^^^^^^ - -- Fix vendor fifo deadlock in certain case -- Add ``tud_vendor_n_read_flush()`` - -Host Controller Driver (HCD) ----------------------------- - -RP2040 -^^^^^^ - -- Implement double buffered to fix E4 errata and boost performance -- Lots of rp2040 update and enhancement - -Host Stack ----------- - -- Major update and rework most of host stack, still needs more improvement -- Lots of improvement and update in parsing configuration and control -- Rework and major update to HID driver. Will default to enable boot interface if available -- Separate ``CFG_TUH_DEVICE_MAX`` and ``CFG_TUH_HUB`` for better management and reduce SRAM usage - -Contributors ------------- - -Thanks to everyone who contributed to this release: @a-h, @BennyEvans, @ctag-fh-kiel, @DuMaM, @hathach, @HiFiPhile, @KarlK90, @kasjer, @kilograham, @kkitayam, @majbthrd, @mmosca, @mws-rmain, @ned-pcs, @nxf58843, @perigoso, @sabas1080, @salkinium, @tringis, @Wini-Buh, @xcguang, @xmos-jmccarthy, @zhangslice. diff --git a/docs/info/changelog/0.12.0.rst b/docs/info/changelog/0.12.0.rst deleted file mode 100644 index 65ac4741f..000000000 --- a/docs/info/changelog/0.12.0.rst +++ /dev/null @@ -1,35 +0,0 @@ -0.12.0 -====== - -- add ``CFG_TUSB_OS_INC_PATH`` for os include path - -Device Controller Driver (DCD) ------------------------------- - -- Getting device stack to pass USB Compliance Verification test (chapter9, HID, MSC). Ports are tested: - nRF, SAMD 21/51, rp2040, stm32f4, Renesas RX, iMXRT, ESP32-S2/3, Kinetic KL25/32, DA146xx -- Added ``dcd_edpt_close_all()`` for switching configuration -- [Transdimension] Support ``dcd_edpt_xfer_fifo()`` with auto wrap over if fifo buffer is 4K aligned and size is multiple of 4K. -- [DA146xx] Improve vbus, reset, suspend, resume detection, and remote wakeup. - -Device Stack ------------- - -- Add new network driver Network Control Model (CDC-NCM), update ``net_lwip_webserver`` to work with NCM (need re-configure example) -- Add new USB Video Class UVC 1.5 driver and video_capture example (work in progress) -- Fix potential buffer overflow for HID, bluetooth drivers - -Host Controller Driver (HCD) ----------------------------- - -No notable changes - -Host Stack ----------- - -No notable changes - -Contributors ------------- - -Thanks to everyone who contributed to this release: @Daft-Freak, @dshadoff, @hansfbaier, @hathach, @HiFiPhile, @kamtom480, @kasjer, @kkitayam, @majbthrd, @szymonh, @unlimitedcodeworks. diff --git a/docs/info/changelog/0.13.0.rst b/docs/info/changelog/0.13.0.rst deleted file mode 100644 index a860918d0..000000000 --- a/docs/info/changelog/0.13.0.rst +++ /dev/null @@ -1,45 +0,0 @@ -0.13.0 -====== - -- [tu_fifo] Fix locked mutex when full, and return type in ``peek_n()`` - -Controller Driver (DCD & HCD) ------------------------------ - -- [DWC2] Generalize synopsys dwc2 with synopsys/dwc2 which support both FS and HS phy (UTMI and ULPI) for various MCUs. - - - Broadcom 28/27xx on raspberrypi SBC - - Silicon Labs EFM32 - - Espressif ESP32 Sx - - GigaDevice GD32 - - ST STM32 - - Infineon XMC -- [KL25] Add new HCD for NXP KL25 -- [MUSB] Add new DCD and HCD for Mentor musb with TI MSP432E4 -- [F1C100s] Add new DCD for Allwinner F1C100s family -- [PIC32MZ] Add new DCD for PIC32MZ -- [nRF] Fix/Enhance various race condition with: EASY DMA, request HFXO, EPOUT -- [ChipIdea] rename Transdimension to more popular ChipIdea Highspeed, -- [RP2040] various update/fix for hcd/dcd -- [FT9XX] new DCD port for Bridgetek FT90x and FT93x devices -- [DA1469X] Fix resume -- [OHCI] Fix device array out of bound - -Note: legacy drivers such as st/synopsys, nxp/transdimension are still present in this release but won't receive more update and could be removed in the future. - -Device Stack ------------- - -- [Audio] Support disabling feedback format correction (16.16 <-> 10.14 format) -- [MSC] Add ``tud_msc_request_sense_cb()`` callback, change most default sense error to medium not present (0x02, 0x3A, 0x00) -- [Video] Fix video_capture example fails enumeration when 8FPS - -Host Stack ----------- - -No notable changes - -Contributors ------------- - -Thanks to everyone who contributed to this release: @alisitsyn, @brtchip-gdm, @cr1901, @EmergReanimator, @hathach, @HiFiPhile, @JayToltTech, @jgressmann, @kasjer, @kkitayam, @leptun, @liamfraser, @majbthrd, @mkj, @mysterywolf, @NexusXe, @nxf58843, @perigoso, @rppicomidi, @Ryzee119, @scoudreau, @sharpie7, @suda-morris, @t123yh, @tannewt, @vmilea, @ZenithalHourlyRate. diff --git a/docs/info/changelog/0.14.0.rst b/docs/info/changelog/0.14.0.rst deleted file mode 100644 index 421e6d8d5..000000000 --- a/docs/info/changelog/0.14.0.rst +++ /dev/null @@ -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. diff --git a/docs/info/changelog/0.15.0.rst b/docs/info/changelog/0.15.0.rst deleted file mode 100644 index f1d55f349..000000000 --- a/docs/info/changelog/0.15.0.rst +++ /dev/null @@ -1,86 +0,0 @@ -0.15.0 -====== - -- Add codespell to detect typo -- Add support for fuzzing and badge for oss-fuzz - -osal -^^^^ - -- Allow the use of non-static allocation for FreeRTOS -- Fix FreeRTOS wrong task switch in some cases - -- Fix tu_fifo memory overflown when repeatedly write to overwritable fifo (accumulated more than 2 depths) -- Better support for IAR (ARM) with ci build check for stm32 mcus. -- Fix Windows build for some mingw gnu make situations - -Controller Driver (DCD & HCD) ------------------------------ - -- Add new port support (WIP) for WCH CH32V307 USB Highspeed -- Add new port support (WIP) for PIC32MM/MX & PIC24 - -nRF -^^^ - -- Fix endpoint internal state when closed -- Fix reception of large ISO packets - -rp2040 -^^^^^^ - -- [dcd] Implement workaround for Errata 15. This enable SOF when bulk-in endpoint is in use and reduce its bandwidth to only 80% -- [hcd] Fix shared irq slots filling up when ``hcd_init()`` is called multiple times -- [hcd] Support host bulk endpoint using hw "interrupt" endpoint. Note speed limit is 64KB/s - -- [samd][dcd] Add support for ISO endpoint -- [dwc2][dcd] Add support for stm32u5xx -- [esp32sx] Fix Isochronous transfers only transmitted on even frame -- [lpc_ip3511][dcd] Add isochronous support and fix endpoint accidental write -- [ft90x] Improve and enhance support for FT9xx MCU, tested with more examples - -Device Stack ------------- - -Video -^^^^^ - -- Add support for MJPEG -- Fix probe on macOS - -MIDI -^^^^ - -- Support port name strings -- fix MS Header wTotalLength computation - -HID -^^^ - -- Add FIDO descriptor template -- change length in ``tud_hid_report_complete_cb()`` from ``uint8_t`` to ``uint16_t`` - -CDC -^^^ - -- Fix autoflush for FIFO < MPS -- Fix tx fifo memory overflown when DTR is not set and ``tud_cdc_write()`` is called repeatedly with large enough data - -- [USBTMC] Fix packet size with highspeed - -Host Stack ----------- - -- Retry a few times with transfers in enumeration since device can be unstable when starting up -- [MSC] Rework host mass storage API. Add new ``host/msc_file_explorer`` example - -CDC -^^^ - -- Add support for host cdc -- Fix host cdc with device without IAD e.g Arduino Due - -Contributors ------------- - -Thanks to everyone who contributed to this release: @battlesnake, @benishor, @brtchip-gdm, @DRNadler, @gregdavill, @hadess, @hathach, @hfegran, @HiFiPhile, @jbruneaux31, @jmark1m, @kasjer, @kaysievers, @kilograham, @kkitayam, @kripton, @Lan-Hekary, @LynnL4, @maddyaby, @mingpepe, @nathaniel-brough, @P33M, @pete-pjb, @ReimuNotMoe, @rppicomidi, @scoudreau, @Skyler84, @Staacks, @tore-espressif, @tswan-quasi, @tyustli. diff --git a/docs/info/changelog/0.16.0.rst b/docs/info/changelog/0.16.0.rst deleted file mode 100644 index 7065f18ff..000000000 --- a/docs/info/changelog/0.16.0.rst +++ /dev/null @@ -1,165 +0,0 @@ -0.16.0 -====== - -- New controller driver: MAX3421e (usb host shield), rusb2 (Renesas USB2.0), ChipIdea fullspeed -- New MCUs: MCXn9, nRF5340, STM32: G0, G4, L5, U575, U5A5, RA6m5, CH32F20x -- Add initial TypeC PowerDelivery support with STM32G4 -- Remove submodules and use python script to manage repo dependencies #1947 -- Add CMake support for most families and boards, move build file from tools/ to examples/build_system -- Add ETM trace support with JTrace for nrf52840, nrf5340, mcb1857, stm32h743eval, ra6m5 -- [osal] Make it possible to override the ``osal_task_delay()`` in osal_none -- Add CDC+UAC2 composite device example -- Enhance Hardware-in-the-loop (HIL) testing with more boards: rp2040, stm32l412nucleo, stm32f746disco, lpcxpresso43s67 - -Controller Driver (DCD & HCD) ------------------------------ - -- Add new ISO endpoint API: ``dcd_edpt_iso_alloc()`` and ``dcd_edpt_iso_activate()`` -- Remove legacy driver st/synopsys - -EHCI -^^^^ - -- [iMXRT] Add dache clean/invalidate when memory is in cacheable memory -- Fix portsc write issue which cause problem with enumeration -- Fix an issue when doing port reset write to portsc -- Fix port change detect is not recognized when power on with attached device -- Fix xfer failed with disconnected device as stalled -- Fix error on EHCI causes xfer error in non-queued qhd which cause memory fault -- Un-roll recursive hub removal with usbh queue -- Fix issue when removing queue head -- Implement ``hcd_edpt_abort_xfer()`` -- use standard USB complete interrupt instead of custom chipidea async/period interrupt to be more compatible with other ehci implementation -- refactor usb complete & error isr processing, merge, update. Fix EHCI QHD reuses QTD on wrong endpoint -- Improve bus reset, fix ``send_setup()`` not carried out if halted previously -- Fix clear qhd halted bit if not caused by STALL protocol to allow for next transfer - -ChipIdea Highspeed -^^^^^^^^^^^^^^^^^^ - -- Fix control transfer issue when previous status and new setup complete in the same isr frame -- [imxrt] Add dcache support for cache region - -ChipIdea Fullspeed -^^^^^^^^^^^^^^^^^^ - -- Generalize ChipIdea Fullspeed driver for mcxn9 (port 0), kinetis - -nrf -^^^ - -- Fix DMA race condition with ISO OUT transfer #1946 -- Add support for nRF5340 with pca10095 board - -Renesas rusb2 -^^^^^^^^^^^^^ - -- Generalize rusb2 driver for ra, rx mcus -- rework both dcd and hcd for better multiple ports support -- Add support for board with HS USB port: ra6m5 port1 - -rp2040 -^^^^^^ - -- [dcd] Make writes to SIE_CTRL aware of concurrent access -- [hcd] add ``hcd_frame_number()``, ``hcd_edpt_abort_xfer()`` for pio-usb host - -stm32 fsdev -^^^^^^^^^^^ - -- Add STM32L5 support -- Implement ``dcd_edpt_iso_alloc()`` and ``dcd_edpt_iso_activate()`` - -OHCI -^^^^ - -- Allows configurable root hub ports, handles SMM mode (Ref OHCI spec 5.1.1.3.3) and Bios mode (Ref OHCI spec 5.1.1.3.4) -- Fix FrameIntervalToggle must be toggled after we write the FrameInterval (Ref OHCI Spec 7.3.1) -- Wait PowerOnToPowerGoodTime after we enable power of the RH ports (Ref OHCI Spec 7.4.1) -- Generate port interrupts for devices already connected during init. -- Fix issue when removing queue head -- Disable MIE during IRQ processing and clear HccaDoneHead on completion as per OCHI Spec Page 80 - -Device Stack ------------- - -- Add optional hooks ``tud_event_hook_cb()`` - -Audio (UAC2) -^^^^^^^^^^^^ - -- Fix feedback EP buffer alignment. -- Fix encoding, update example -- Improve IN transfer - -Bluetooth -^^^^^^^^^ - -- Add historical EP compatibility for Bluetooth HCI - -CDC -^^^ - -- Fix line_coding alignment -- Fix typo in cdc line coding enum - -MIDI -^^^^ - -- Fix ``stream_write()`` always writes system messages to cable 0 -- Fix incorrect NOTE_ON, NOTE_OFF definitions - -- USBTMC: Fix tmc488 bit order - -- Vendor: fix ``read()``/``write()`` race condition - -Video (UVC) -^^^^^^^^^^^ - -- Add the capability for video class to handle a bulk endpoint in the streaming interface. - -Host Stack ----------- - -USBH -^^^^ - -- Add new APIs: ``tuh_interface_set()``, ``tuh_task_event_ready()``, ``tuh_edpt_abort_xfer()``, ``tuh_rhport_reset_bus()``, ``tuh_rhport_is_active()`` -- Fix issue when device generate multiple attach/detach/attach when plugging in -- Prefer application callback over built-in driver on transfer complete event -- Correct ``hcd_edpt_clear_stall()`` API signature -- Separate bus reset delay and contact debouncing delay in enumeration -- Support ``usbh_app_driver_get_cb()`` for application drivers -- Fix usbh enumeration removal race condition -- Add optional hooks ``tuh_event_hook_cb()`` - -CDC -^^^ - -- Breaking: change ``tuh_cdc_itf_get_info()`` to use tuh_itf_info_t instead of tuh_cdc_info_t -- Fix cdc host enumeration issue when device does not support line request -- Add support for vendor usb2uart serial: ftdi, cp210x, ch9102f -- Improve sync control API e.g ``tuh_cdc_set_control_line_state()``, ``tuh_cdc_set_line_coding()`` - -HID -^^^ - -- Add new APIs ``tuh_hid_send_report()``, ``tuh_hid_itf_get_info()``, ``tuh_hid_receive_ready()``, ``tuh_hid_send_ready()``, ``tuh_hid_set_default_protocol()`` -- Change meaning of CFG_TUH_HID to total number of HID interfaces supported. Previously ``CFG_TUH_HID`` is max number of interfaces per device which is rather limited and consume more resources than needed. - -HUB -^^^ - -- Fix handling of empty "status change" interrupt -- Fix issue with hub status_change is not aligned - -MSC -^^^ - -- Fix bug in ``tuh_msc_ready()`` -- Fix host msc get maxlun not using aligned section memory - -Contributors ------------- - -Thanks to everyone who contributed to this release: @0xCCF4, @abakosh, @ahooper, @antoniovazquezblanco, @bavison, @bencowperthwaite, @bpaddock, @branalba, @ccrome, @dauc, @dhalbert, @DRNadler, @dsugisawa-mixi, @epatstarkey, @eustas, @facchinm, @gabChouin, @georgeboc, @hathach, @HiFiPhile, @howard0su, @HubertD, @ipopov, @jbtheou, @jefftrull, @jfedor2, @jferreir, @jfm92, @jncronin, @JustAnother1, @kasjer, @kholia, @kilograham, @kkitayam, @koendv, @Krasutski, @kripton, @maidnl, @MattMills, @mikee47, @mndza, @nathaniel-brough, @NullMember, @perigoso, @projectgus, @raiden00pl, @ReimuNotMoe, @Rocky04, @rppicomidi, @Ryzee119, @sinitax, @sjanc, @slark-yuxj, @slc-tl, @Tails86, @tannewt, @tswan-quasi, @tyustli, @Yveaux. diff --git a/docs/info/changelog/0.17.0.rst b/docs/info/changelog/0.17.0.rst deleted file mode 100644 index af9a486c3..000000000 --- a/docs/info/changelog/0.17.0.rst +++ /dev/null @@ -1,184 +0,0 @@ -0.17.0 -====== - -General -------- - -- Improved CI: build both cmake and make. Make use of CircleCI for part of build process to speed up CI -- Add CodeQL Workflow for Code Security Analysis -- Add Clang compiler support -- Add default implementation for weak callbacks functions for better Keil compatibility -- Upgrade hardware-in-the-loop (HIL) testing with more boards and examples: including dual stack example - -Controller Driver (DCD & HCD) ------------------------------ - -Chipidea -^^^^^^^^ - -- Support MCXA - -DWC2 -^^^^ - -- Fix tickless issue with stm32f7: disable ULPI clock during sleep when using internal phy -- Fix SOF interrupt handling -- Fix fifo level half/empty issue -- Add DWC2 Test Mode support. -- for esp32 force disconnect/connect using USB_WRAP otg pad override - -FSDEV -^^^^^ - -- Rewrite and Generalize driver to support non-stm32 mcu such as wch -- Simplify PMA, HW FIFO access and bit manipulation for different access scheme 1x16, 2x16 and 32 bit -- Add support for ch32 usbd e.g ch32v203 -- Add support for STM32G4 and STM32U5 microcontrollers. -- Fix h5 (32-bit) errata 2.15.1: Buffer description table update completes after CTR interrupt triggers -- ISO EP buffer allocation improvements, implement ``dcd_edpt_close_all()`` - -- Fix ch32v203 race condition and stability issue with - - - fix ch32v203 seems to unconditionally accept ZLP on EP0 OUT. - - fix v203 race condition between rx bufsize and RX_STAT which cause PMAOVR, occurs with WRITE10 - - correctly handle setup prepare at ``dcd_edpt0_status_complete()``, which fixes the race condition with windows where we could miss setup packet (setup bit set, but count = 0) - -MAX3421E -^^^^^^^^ - -- Add support for rp2040, esp32 (c3, c6, h2, etc..) -- Add ``hcd_deinit()`` for max3421 -- Retry NAK handling next frame to reduce CPU and SPI bus usage -- add ``cpuctl`` and ``pinctl`` to ``tuh_configure()`` option for max3421 -- Implement hcd abort transfer for Max3421 -- Properly Handle NAK Response in MAX3421E driver: correctly switch and skip writing to 2 FIFOs when NAK received. Otherwise, the driver may hang in certain conditions. - -- MSP430: support non-bus-powered - -MUSB -^^^^ - -- Add support for Analoog devices: max32650, max32666, max32690, max3278002 - -nRF -^^^ - -- Fix ``dcd_edpt_open()`` for iso endpoint -- Handle ISOOUT CRC errors -- Add compile support with old nordic sdk -- Fix a few race conditions - -OHCI -^^^^ - -- Allow more than 16 devices - -RP2040 -^^^^^^ - -- Correctly abort control transfer when new setup arrived. Due to RP2040-E2 only able to fix B2 or later -- Implement hcd abort transfer for rp2040 -- Add support for rp2350 - -RUSB2 -^^^^^ - -- Support ra2a1 pipe number scheme - -WCH CH32 -^^^^^^^^ - -- Added support for USB OTG/FS and FSDev Driver. Update CH32V307 to allow manual select FS or HS driver. -- Fixed various bugs in CH32v307 usbhs driver: endpoint handling and data transfer management. - -Device Stack ------------- - -- Add ``tud_deinit()`` and ``class driver deinit()`` to deinitialize TinyUSB device stack. -- Add support for generic SOF callback. -- Add set address recovery time 2ms per USB spec. - -Audio -^^^^^ - -- Add audio_test_freertos & audio_4_channel_mic_freertos -- Improved support for Audio Class 2.0 (UAC2) with various bug fixes. -- Add feedback by fifo counting. - -Bluetooth HCI -^^^^^^^^^^^^^ - -- Issue ZLP on ACL IN ep when transfer is multiple of endpoint max packet size - -CDC -^^^ - -- Add ``tud_cdc_configure_fifo()`` to make RX/TX buffer persistent (not clear when disconnected) -- Add missing capability bit for CDC ACM serial break support -- Enhanced CDC class with better handling of large data transmissions. -- Add missing capability bit for CDC ACM serial break support - -HID -^^^ - -- Added missing key codes for keypad -- Added HID Lighting and Illumination functionality -- Fixed issues in the HID class for more reliable device enumeration. -- Support HID Mouse with absolute positioning -- Use separate buffer for control SET_REPORT, fix conflict with interrupt endpoint out - -- MSC: Added support for SCSI_CMD_PREVENT_ALLOW_MEDIUM_REMOVAL - -Net -^^^ - -- Rewrite of NCM device driver to improve throughput -- removed obsolete ``tud_network_link_state_cb()`` - -- USBTMC Added notification support - -Vendor -^^^^^^ - -- Migrate to new endpoint stream API, support non-buffered TX/RX -- Add ZLP for ``write()`` when needed - -Video -^^^^^ - -- Enhance UVC descriptors and example -- Video Added support for USB Video Class (UVC) with MJPEG. -- Fix multiple interfaces, add an example of 2ch video capture. -- Fix race for ``tud_video_n_streaming()`` check - -Host Stack ----------- - -- Added ``tuh_deinit()`` to de-initialize TinyUSB host stack. -- Added support for new USB mass storage class APIs. -- Improved error handling and retry mechanisms for unstable devices. - -CDC Serial -^^^^^^^^^^ - -- Add support for ch34x -- Allow to overwrite ``CFG_TUH_CDC_FTDI/CP210X/CH32X_VID_PID_LIST`` -- Enhanced stability of CDC-ACM devices during enumeration. - -HID -^^^ - -- Add ``tuh_hid_receive_abort()`` -- Add ``tuh_hid_get_report()`` - -Hub -^^^ - -- Prevent status request to invalid ep_num -- Fix double status xfer -- unroll hub removal - -Contributors ------------- - -Thanks to everyone who contributed to this release: @acscd, @andrewleech, @angmolin, @antoniovazquezblanco, @arntsonl, @b4yuan, @battlesnake, @BrentK-ADI, @camilaodsouza, @cdesjardins, @ChrisDeadman, @clhenry, @cumhuronat, @donatieng, @dp111, @dragonlock2, @duckylotl, @eightycc, @emb4fun, @Erlkoenig90, @feaser, @gschorcht, @hathach, @HiFiPhile, @hinxx, @hjalleboii, @ikskuh, @IngHK, @jerpa77, @jotonedev, @kaidegit, @kasjer, @kaspernyhus, @kilograham, @kkitayam, @Krasutski, @LarssonOliver, @leptun, @liamfraser, @lijunru-hub, @lurch, @Lurcy38, @maflcko, @mamiral, @MatiMcFly, @Okarss, @pigrew, @ra1nb0w, @Rbb666, @rgrr, @Rocky04, @rsolorzanomsft, @Ryzee119, @shuffle2, @slark-yuxj, @tannewt, @thierer, @tinic, @tlyu, @tobozo, @tommie, @trejan, @tyustli, @wjklimek1, @XelaRellum, @Xelus22, @xudongzheng, @YixingShen, @zx96. diff --git a/docs/info/changelog/0.18.0.rst b/docs/info/changelog/0.18.0.rst deleted file mode 100644 index 05dfd0579..000000000 --- a/docs/info/changelog/0.18.0.rst +++ /dev/null @@ -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. diff --git a/docs/info/changelog/0.19.0.rst b/docs/info/changelog/0.19.0.rst deleted file mode 100644 index dbda59e61..000000000 --- a/docs/info/changelog/0.19.0.rst +++ /dev/null @@ -1,247 +0,0 @@ -0.19.0 -====== - -General -------- - -New MCUs and Boards -^^^^^^^^^^^^^^^^^^^ - -- Add ESP32-H4, ESP32-C5, ESP32-C61 support -- Add STM32U0, STM32WBA, STM32N6 -- Add AT32F405, AT32F403A, AT32F415, AT32F423 support -- Add CH32V305 support and CH32V20x USB host support -- Add MCXA156 SDK 2.16 support and FRDM-MCXA156 board - -API Changes ------------ - -Core APIs -^^^^^^^^^ - -- Add weak callbacks with new syntax for better compiler compatibility -- Add ``tusb_deinit()`` to cleanup stack -- Add time functions: ``tusb_time_millis_api()`` and ``tusb_time_delay_ms_api()`` -- Add ``osal_critical`` APIs for critical section handling -- Introduce ``xfer_isr()`` callback for ISO transfer optimization in device classes - -Device APIs -^^^^^^^^^^^ - -- CDC: Add notification support ``tud_cdc_configure()``, ``tud_cdc_n_notify_uart_state()``, - ``tud_cdc_n_notify_conn_speed_change()``, ``tud_cdc_notify_complete_cb()`` -- MSC: Add ``tud_msc_inquiry2_cb()`` with bufsize parameter, update ``tud_msc_async_io_done()`` - with ``in_isr`` parameter -- Audio: Add ``tud_audio_n_mounted()`` and various FIFO access functions -- MTP: Add ``tud_mtp_mounted()``, ``tud_mtp_data_send()``, ``tud_mtp_data_receive()``, - ``tud_mtp_response_send()``, ``tud_mtp_event_send()`` - -Host APIs -^^^^^^^^^ - -- Core: Add ``tuh_edpt_close()``, ``tuh_address_set()``, ``tuh_descriptor_get_device_local()``, - ``tuh_descriptor_get_string_langid()``, ``tuh_connected()``, ``tuh_bus_info_get()`` -- Add enumeration callbacks: ``tuh_enum_descriptor_device_cb()``, - ``tuh_enum_descriptor_configuration_cb()`` -- CDC: Add ``tuh_cdc_get_control_line_state_local()``, ``tuh_cdc_get/set_dtr/rts()``, - ``tuh_cdc_connect/disconnect()`` and sync versions of all control APIs -- MIDI: Add ``tuh_midi_itf_get_info()``, ``tuh_midi_packet_read_n()``, - ``tuh_midi_packet_write_n()``, ``tuh_midi_read_available()``, ``tuh_midi_write_flush()``, - ``tuh_midi_descriptor_cb()`` - -Controller Driver (DCD & HCD) ------------------------------ - -DWC2 -^^^^ - -- Support DWC2 v4.30a with improved reset procedure -- Fix core reset: wait for AHB idle before reset -- Add STM32 DWC2 data cache support with proper alignment -- Host improvements: - - Fix disconnect detection and SOF flag handling - - Fix HFIR timing off-by-one error - - Retry IN token immediately for bInterval=1 - - Proper attach debouncing (200ms) - - Fix all retry intervals - - Resume OUT transfer when PING ACKed -- Fix enumeration racing conditions -- Refactor bitfields for better code generation - -FSDEV (STM32) -^^^^^^^^^^^^^ - -- Fix AT32 compile issues after single-buffered endpoint changes -- Add configurable single-buffered isochronous endpoints -- Fix STM32H7 recurrent suspend ISR -- Fix STM32L4 GPIOD clock enable for variants without GPIOD -- Fix STM32 PHYC PLL stability wait -- Improve PMA size handling for STM32U0 - -EHCI -^^^^ - -- Fix removed QHD getting reused -- Fix NXP USBPHY disconnection detection - -Chipidea/NXP -^^^^^^^^^^^^ - -- Fix race condition with spinlock -- Improve iMXRT support: fix build, disable BOARD_ConfigMPU, fix attach debouncing on port1 highspeed -- Fix iMXRT1064 and add to HIL test pool - -MAX3421E -^^^^^^^^ - -- Use spinlock for thread safety instead of atomic flag -- Implement ``hcd_edpt_close()`` - -RP2040 -^^^^^^ - -- Fix audio ISO transfer: reset state before notifying stack -- Fix CMake RTOS cache variable -- Abort transfer if active in ``iso_activate()`` - -SAMD -^^^^ - -- Add host controller driver support - -Device Stack ------------- - -USBD Core -^^^^^^^^^ - -- Introduce ``xfer_isr()`` callback for interrupt-time transfer handling -- Add ``usbd_edpt_xfer_fifo()`` stub -- Revert endpoint busy/claim status if ``xfer_isr()`` defers to ``xfer_cb()`` - -Audio -^^^^^ - -- Major simplification of UAC driver and alt settings management -- Move ISO transfers into ``xfer_isr()`` for better performance -- Remove FIFO mutex (single producer/consumer optimization) -- Add implicit feedback support for data IN endpoints -- Fix alignment issues -- Update buffer macros with cache line size alignment - -CDC -^^^ - -- Add notification support: ``CFG_TUD_CDC_NOTIFY``, ``tud_cdc_n_notify_conn_speed_change()``, ``tud_cdc_notify_complete_cb()`` -- Reduce default bInterval from 16ms to 1ms for better responsiveness -- Rename ``tud_cdc_configure_fifo()`` to ``tud_cdc_configure()`` and add ``tx_overwritable_if_not_connected`` option -- Fix web serial robustness with major overhaul and logic cleanup - -HID -^^^ - -- Add Usage Page and Table for Power Devices (0x84 - 0x85) -- Fix HID descriptor parser variable size and 4-byte item handling -- Add consumer page configurations - -MIDI -^^^^ - -- Fix MIDI interface descriptor handling after audio streaming interface -- Skip RX data with all zeroes - -MSC -^^^ - -- Add async I/O support for MSC using ``tud_msc_async_io_done()`` -- Add ``tud_msc_inquiry2_cb()`` with bufsize for full inquiry response - -MTP -^^^ - -- Add new Media Transfer Protocol (MTP) device class driver -- Support MTP operations: GetDeviceInfo, SendObjectInfo, SendObject -- Add MTP event support with ``tud_mtp_event_send()`` -- Implement filesystem example with callbacks -- Add hardware-in-the-loop testing support - -NCM -^^^ - -- Add USB NCM link state control support -- Fix DHCP offer/ACK destination - -USBTMC -^^^^^^ - -- Add vendor-specific message support - -Vendor -^^^^^^ - -- Fix vendor device reset and open issues -- Fix descriptor parsing for ``CFG_TUD_VENDOR > 1`` -- Fix vendor FIFO argument calculation - -Host Stack ----------- - -USBH Core -^^^^^^^^^ - -- Major enumeration improvements: - - Fix enumeration racing conditions - - Add proper attach debouncing with hub/rootport handling (200ms delay) - - Reduce ``ENUM_DEBOUNCING_DELAY_MS`` to 200ms - - Always get language ID, manufacturer, product, and serial strings during enumeration - - Always get first 2 bytes of string descriptor to determine length (prevents buffer overflow) - - Support devices with multiple configurations -- Add ``tuh_enum_descriptor_device_cb()`` and ``tuh_enum_descriptor_configuration_cb()`` callbacks -- Add ``tuh_descriptor_get_string_langid()`` API -- Hub improvements: - - Check status before getting first device descriptor - - Properly handle port status and change detection - - Queue status endpoint for detach/remove events - - Fix hub status change endpoint handling -- Fix endpoint management: - - ``hcd_edpt_open()`` returns false if endpoint already opened - - Add ``hcd_edpt_close()`` implementation - - Abort pending transfers on close -- Add roothub debouncing flag to ignore attach/remove during debouncing -- Move address setting and bus info management to separate structures -- Force removed devices in same bus info before setting address - -CDC Serial Host -^^^^^^^^^^^^^^^ - -- Major refactor to generalize CDC serial drivers (FTDI, CP210x, CH34x, PL2303, ACM) -- Add explicit ``sync()`` API with ``TU_API_SYNC()`` returning ``tusb_xfer_result_t`` -- Rename ``tuh_cdc_get_local_line_coding()`` to ``tuh_cdc_get_line_coding_local()`` -- Add ``tuh_cdc_get_control_line_state_local()`` -- Implement ``tuh_cdc_get/set_dtr/rts()`` as inline functions - -MIDI Host -^^^^^^^^^ - -- Major API changes: - - Rename ``tuh_midi_stream_flush()`` to ``tuh_midi_write_flush()`` - - Add ``tuh_midi_packet_read_n()`` and ``tuh_midi_packet_write_n()`` - - Add ``CFG_TUH_MIDI_STREAM_API`` to opt out of stream API - - Change API to use index instead of device address (supports multiple MIDI per device) -- Rename ``tuh_midi_get_num_rx/tx_cables()`` to ``tuh_midi_get_rx/tx_cable_count()`` -- Add ``tuh_midi_descriptor_cb()`` and ``tuh_midi_itf_get_info()`` - -MSC Host -^^^^^^^^ - -- Continue async I/O improvements - -HID Host -^^^^^^^^ - -- Fix version string to actually show version - -Contributors ------------- - -Thanks to everyone who contributed to this release: @andrewleech, @armusin, @atoktoto, @byteit101, @ceedriic, @ChrisDeadman, @Cynventria, @dauc, @Dazza0, @deshipu, @Dolphindalt, @ehughes, @elipsitz, @fenugrec, @hathach, @HiFiPhile, @ho-ho-ho, @igi540, @IngHK, @Isoheptane, @james-advatek, @JannisKonradBecker, @jay94ks, @joelpmichael, @karlp, @kasjer, @ludoux, @majbthrd, @martijnvdwoude, @maximevince, @Milek7, @ning3270455369, @ohmdelta, @peppapighs, @pschatzmann, @PwnVerse, @raldone01, @ReimuNotMoe, @rhgndf, @roundby, @rppicomidi, @s09289728096, @salkinium, @tannewt, @terjr, @tore-espressif, @verylowfreq, @YixingShen, @ZakDanger. diff --git a/docs/info/changelog/0.20.0.rst b/docs/info/changelog/0.20.0.rst deleted file mode 100644 index d5952a830..000000000 --- a/docs/info/changelog/0.20.0.rst +++ /dev/null @@ -1,107 +0,0 @@ -0.20.0 -====== - -*November 19, 2025* - -General -------- - -New MCUs and Boards -^^^^^^^^^^^^^^^^^^^ - -- Add STM32U3 device support (adjusted from STM32U0) -- Add nRF54H20 support with initial board configuration -- Rename board names: pca10056→nrf52840dk, pca10059→nrf52840dongle, pca10095→nrf5340dk -- Improve CMake: Move startup and linker files from board target to executable. Enhance target warning flags and fix various build warnings - -Code Quality and Static Analysis -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -- Add PVS-Studio static analysis to CI -- Add SonarQube scan support -- Add IAR C-Stat analysis capability -- Add ``.clang-format`` for consistent code formatting -- Fix numerous alerts and warnings found by static analysis tools - -Documentation -^^^^^^^^^^^^^ - -- Improve Getting Started documentation structure and flow -- Add naming conventions and buffer handling documentation - -Controller Driver (DCD & HCD) ------------------------------ - -DWC2 -^^^^ - -- Fix incorrect handling of Zero-Length Packets (ZLP) in the DWC2 driver when receiving data (OUT transfers) -- Improve EP0 multi-packet logic -- Support EP0 with max packet size = 8 -- For IN endpoint, write initial packet directly to FIFO and only use TXFE interrupt for subsequent packets -- Fix ISO with bInterval > 2 using incomplete IN interrupt handling. -- Fix compile issues when enabling both host and device -- Clear pending suspend interrupt after USB reset (enum end) -- Improve host closing endpoint and channel handling when device is unplugged - -FSDEV (STM32) -^^^^^^^^^^^^^ - -- Fix AT32 USB interrupt remapping in ``dcd_int_enable()`` - -OHCI -^^^^ - -- Add initial LPC55 OHCI support -- Improve data cache support - -Device Stack ------------- - -USBD Core -^^^^^^^^^ - -- Support configurable EP0 buffer size CFG_TUD_ENDPOINT0_BUFSIZE -- Make dcd_edpt_iso_alloc/activate as default API for ISO endpoint - -Audio -^^^^^ - -- Add UAC1 support -- Implement RX FIFO threshold adjustment with ``tud_audio_get/set_ep_in_fifo_threshold()`` - -CDC -^^^ - -- Migrate to endpoint stream API - -HID -^^^ - -- Fix HID stylus descriptor - -MIDI -^^^^ - -- Migrate to endpoint stream API -- Add ``tud_midi_n_packet_write_n()`` and ``tud_midi_n_packet_read_n()`` - -MTP -^^^ - -- Fix incorrect MTP xact_len calculation - -Video -^^^^^ - -- Add bufferless operation callback for dynamic frame generation with tud_video_prepare_payload_cb() - -Host Stack ----------- - -No changes - -Contributors ------------- - -Thanks to everyone who contributed to this release: @adam-embedded, @ArcaneNibble, @c1570, @embedded-ideas, @gabChouin, @hathach, @HiFiPhile, @karlp, @ldube, @peppapighs, @poornadharshan13-rgb, @RigoLigoRLC, @tangpipi, @ToonVanEyck, @tswan22. diff --git a/docs/info/changelog/0.21.0.rst b/docs/info/changelog/0.21.0.rst deleted file mode 100644 index bae39770e..000000000 --- a/docs/info/changelog/0.21.0.rst +++ /dev/null @@ -1,213 +0,0 @@ -0.21.0 -====== - -*June 29, 2026* - -General -------- - -New MCUs and Boards -^^^^^^^^^^^^^^^^^^^ - -- Add HPMicro HPM6xxx support with HPM6750EVK2 board -- Add NXP RW61x (RW612, ChipIdea high-speed) support -- Add Artery AT32F45x series support -- Add STM32C5 series support -- Add Espressif ESP32-S31 (high-speed) support -- Add WCH CH582/CH583 (USBFS) support -- Add CH32V103 USB device support (combined-control USBFS) with CH32V103C8T6 Bluepill board -- Add FreeRTOS support for RP2040/RP2350 -- New boards: nRF54LM20-DK, WeAct STM32H743, EK-TM4C1294XL, STM32H747-DISCO, NUCLEO-H533RE -- Migrate i.MX RT to the new ``mcux-devices-rt`` SDK package - -Code Quality and Build -^^^^^^^^^^^^^^^^^^^^^^ - -- Major refactor of dedicated hardware-FIFO (HWFIFO) handling: omit per-endpoint RAM buffers on ports with a dedicated hardware FIFO, add stride-aware FIFO access, and store raw bytes in ``tusb_fifo`` -- Reduce code size via control/descriptor and stream refactors, and remove ``snprintf`` usage -- Remove IAR toolchain support from the Make build; add IAR warning flags and resolve warnings in CMake -- Fix Zephyr build with nrfx v4, C++/``-Werror=extra`` builds, and various ``-Wconversion`` warnings -- Update FatFS to R0.16 -- Fix the fuzzing harness -- Various BSP fixes (STM32H5 UID read with ICACHE, STM32F411 Black Pill HSE, RT1011 data cache, Teensy) - -Documentation -^^^^^^^^^^^^^ - -- Add a README for every example and ``build-doc`` tooling -- Add Sponsors section and ``FUNDING`` configuration -- Various README/doc fixes (FTDI host, STM32C071 Nucleo URL, Supported CPUs table) - -API Changes ------------ - -- Add ``is_isr`` parameter to ``dcd_edpt_xfer``, ``dcd_edpt_xfer_fifo``, ``usbd_edpt_xfer`` and ``usbd_edpt_xfer_fifo`` -- Remove the no-FIFO mode from the endpoint stream API -- Add ``tud_vendor_write_clear()`` to forcefully clear the TX buffer -- Add ``tud_midi_n_demux_stream_read()`` cable-aware MIDI stream read -- Add ``CFG_TUH_HID_SET_PROTOCOL_ON_ENUM`` host HID option -- Add ``CFG_TUSB_DEBUG_BREAKPOINT`` hook for ``TU_BREAKPOINT`` -- Add ThreadX OSAL support -- ``tud_task_ext()`` / ``tuh_task_ext()`` now limit the number of events processed per call -- Replace ``CFG_TUD_NET_ENDPOINT_SIZE`` with the descriptor-based endpoint size - -Device Stack ------------- - -USBD Core -^^^^^^^^^ - -- Refactor and validate device descriptor handling; move control transfer handling into ``usbd.c`` -- Use the EP0 buffer directly when large enough; clamp EP0 OUT data copy to the control buffer -- Fix stream write logic/racing without FIFO; fix zero ``wLength`` control request -- Fix ISO OUT endpoint failure on alt-setting MPS change - -Audio -^^^^^ - -- Fix ``audiod_open`` with MIDI interfaces -- Fix big-endian bitfield guards for audio structs and endian-safe ``wValue``/``wIndex`` extraction in UAC2 examples - -CDC -^^^ - -- Remove ``tud_cdc_configure`` -- Fix CDC echo test issue on i.MX RT and fast MCUs - -HID -^^^ - -- Bound item size to remaining length in the report-descriptor parser -- Remove host enumeration assumption; add ``CFG_TUH_HID_SET_PROTOCOL_ON_ENUM`` - -MIDI -^^^^ - -- Add USB-MIDI 2.0 device and host class drivers -- Add cable-aware stream read ``tud_midi_n_demux_stream_read()`` -- Fix MIDI host issue - -MSC -^^^ - -- Skip the command stage if the OUT endpoint is stalled -- Cap ``tud_msc_scsi_cb`` buffer size to the endpoint buffer size - -MTP -^^^ - -- Fix transfer completion detection for exact-length packets; queue ZLP when needed -- Fix premature phase change after a short OUT transfer; fixes in ``add_string`` - -Network (NCM) -^^^^^^^^^^^^^ - -- Fix NCM state on restart -- Support ``SetEthernetPacketFilter`` and ``SetNtbInputSize`` requests -- Add a weak callback for the initial link state - -Video (UVC) -^^^^^^^^^^^ - -- Fix VC interface parsing when ``bNumEndpoints`` != 0 -- Assert the ``usbd_edpt_iso_activate()`` result - -DFU -^^^ - -- Fix the DFU functional descriptor version (1.0.1 → 1.1.0) - -Printer -^^^^^^^ - -- Add the USB Printer device class driver - -Vendor -^^^^^^ - -- Omit the endpoint buffer for ports with a dedicated hardware FIFO - -Host Stack ----------- - -- Fully asynchronous host code: remove blocking delays from ``tuh_task_ext()``, respect its ``timeout_ms``, and avoid stalling one device while another enumerates -- Add an async control-transfer FIFO so queued control transfers are dispatched instead of dropped -- Hub enumeration reliability improvements; add MTT hub support -- Support full-speed host with a high-speed PHY (DWC2) -- Fix FTDI host multi-channel loop -- CDC host: use a local control buffer; fix ``cdch_open`` typo -- Big-endian host support for SETUP packet handling -- Use ``TUSB_ROLE_HOST`` in host stack initialization - -Controller Driver (DCD & HCD) ------------------------------ - -DWC2 -^^^^ - -- Add ``dcd_configure`` for FIFO config and DWC2 deinit support -- Support full-speed host operation on a high-speed PHY -- Vbus sensing enhancement; do not modify FS PHY registers on HS PHY (ESP32-P4) -- Fix HCD TX FIFO full check, ISO IN endpoint disabled after incomplete transfer, and EP0 status completion before SETUP -- Submit SETUP on SETUP_DONE and handle v3.10a spurious RX_COMPLETE (STM32L476) -- HCD: correct HFIR for low-speed devices via internal FS PHY; fix split-IN NAK storm and UART starvation (STM32F723) - -FSDEV (STM32 / CH32) -^^^^^^^^^^^^^^^^^^^^ - -- Add FSDEV host (HCD) driver -- Refactor FSDEV; share the PMA errata delay helper between DCD/HCD with overridable timing -- Fix single-buffered isochronous endpoint cases, STM32U0 data stride, and PMA pointer advance on ring-buffer wrap -- Fix CH32V20x enumeration by enabling the D+ pull-up; work around CH32 EP0 premature OUT ACK -- Do not enable the unused USB wakeup EXTI IRQ (F1/F3/G4/L1) - -MUSB -^^^^ - -- Enhance driver: double packet, EP0 refactor, fix DATAEND race with EP0 -- Fix ZLP IN transfer, RXRDY clearing, and defer EP0 SETUP during the DATA_IN/STATUS race - -RP2040 / RP2350 -^^^^^^^^^^^^^^^ - -- Refactor RP2 driver -- HCD rework: EPX for non-interrupt endpoints and ping-pong double buffering -- Fix RP2350 hard fault in unaligned memcpy to USB DPRAM -- Host: fix OUT-data control transfers sending DATA0 instead of DATA1 - -CH32 USBFS / USBHS (WCH) -^^^^^^^^^^^^^^^^^^^^^^^^ - -- Fix dropped bulk OUT packets by re-arming the EP_RX_CTRL state (usbfs) -- Fix endpoint stall length index and clear-stall response (usbhs) -- Fix CH32V103 hard fault - -RUSB2 / SAMx7x -^^^^^^^^^^^^^^ - -- Fix RUSB2 FIFO write -- Refresh ``dcd_samx7x`` - -New host controllers -^^^^^^^^^^^^^^^^^^^^ - -- Add NXP IP3516 HCD (EHCI-like) -- Add MTT (multi-TT) hub support - -nRF5x -^^^^^ - -- Request HFCLK in ``USB_EVT_READY`` to fix the post-SoftDevice deadlock - -Testing -------- - -- Expand Hardware-in-the-Loop (HIL) coverage (MTP, audio, throughput; nanoch32v203, ch32v103, stm32u083nucleo, tm4c123x) and post pass/fail/skip HIL reports as PR comments -- Add MemBrowse code-size CI integration and size-difference reporting -- Add automated Claude Code PR review and bug-fix CI workflows -- Add ``hil``, ``code-size``, ``pvs``, ``usbmon`` and ``build-doc`` developer skills - -Contributors ------------- - -Thanks to everyone who contributed to this release: @Alex-Schaefer, @alt-0191, @andrewleech, @armusin, @bdolgov, @BrentK-ADI, @ceedriic, @chenzhihong007, @dangfan, @DavidKorczynski, @dinsfire64, @dxbjavid, @embedded-ideas, @felhub, @gab-k, @gabChouin, @HakanL, @hathach, @HiFiPhile, @igi540, @IntegraSources, @kira-live, @LeZerb, @michael-membrowse, @michaelajax, @mickabrig7, @Milek7, @morse-cedricvandenbergh, @nminaylov, @non-bin, @Phozer, @remiberthoz, @renjieah, @rhgndf, @RobertDaleSmith, @roma-jam, @sauloverissimo, @sgrunza-at-BadgerMeter, @sidcha, @StefanOroel, @Tails86, @thamul, @tore-espressif, @UMRnInside, @ValentiWorkLearning, @verylowfreq, @wjklimek1, @YixingShen, @zhiqiang-ch, @zjzhang-cn. diff --git a/docs/info/changelog/0.5.0.rst b/docs/info/changelog/0.5.0.rst deleted file mode 100644 index 676ae2fd0..000000000 --- a/docs/info/changelog/0.5.0.rst +++ /dev/null @@ -1,15 +0,0 @@ -0.5.0 -===== - -*2019-06* - -First release, device stack works great, host stack works but still need improvement. - -- Special thanks to @adafruit team, especially @tannewt to help out immensely to rework device stack: simplify osal & control transfer, adding SAMD21/SAMD51 ports, writing porting docs, adding MIDI class support etc... -- Thanks to @cr1901 for adding STM32F4 port. -- Thanks to @PTS93 and @todbot for HID raw API - -Contributors ------------- - -Thanks to everyone who contributed to this release: @cr1901, @gpshead, @hathach, @mithro, @tannewt, @timonsku, @zardam. diff --git a/docs/info/changelog/0.6.0.rst b/docs/info/changelog/0.6.0.rst deleted file mode 100644 index 5ec65f302..000000000 --- a/docs/info/changelog/0.6.0.rst +++ /dev/null @@ -1,70 +0,0 @@ -0.6.0 -===== - -*2020-03-30* - -Added **CONTRIBUTORS.md** to give proper credit for contributors to the stack. Special thanks to `Nathan Conrad `__ , `Peter Lawrence `__ , `William D. Jones `__ and `Sean Cross `__ and others for spending their precious time to add lots of features and ports for this release. - -Added ------ - -MCU -^^^ - -- Added support for Microchip SAMG55 -- Added support for Nordic nRF52833 -- Added support for Nuvoton: NUC120, NUC121/NUC125, NUC126, NUC505 -- Added support for NXP LPC: 51Uxx, 54xxx, 55xx -- Added support for NXP iMXRT: RT1011, RT1015, RT1021, RT1052, RT1062, RT1064 -- Added support for Sony CXD56 (Spresense) -- Added support for STM32: L0, F0, F1, F2, F3, F4, F7, H7 -- Added support for TI MSP430 -- Added support for ValentyUSB's eptri - -Class Driver -^^^^^^^^^^^^ - -- Added DFU Runtime class driver -- Added Network class driver with RNDIS, CDC-ECM, CDC-EEM (work in progress) -- Added USBTMC class driver -- Added WebUSB class driver using vendor-specific class -- Added multiple instances support for CDC and MIDI -- Added a handful of unit test with Ceedling. -- Added LOG support for debugging with CFG_TUSB_DEBUG -- Added ``tud_descriptor_bos_cb()`` for BOS descriptor (required for USB 2.1) -- Added ``dcd_edpt0_status_complete()`` as optional API for DCD - -Examples -^^^^^^^^ - -Following examples are added: - -- ``board_test`` -- ``cdc_dual_ports`` -- ``dfu_rt`` -- ``hid_composite`` -- ``net_lwip_webserver`` -- ``usbtmc`` -- ``webusb_serial`` - -Changed -------- - -- Changed ``tud_descriptor_string_cb()`` to have additional Language ID argument -- Merged ``hal_nrf5x.c`` into ``dcd_nrf5x.c`` -- Merged ``dcd_samd21.c`` and ``dcd_samd51.c`` into ``dcd_samd.c`` -- Generalized ``dcd_stm32f4.c`` to ``dcd_synopsys.c`` -- Changed ``cdc_msc_hid`` to ``cdc_msc`` (drop hid) due to limited endpoints number of some MCUs -- Improved DCD SAMD stability, fix missing setup packet occasionally -- Improved ``usbd/usbd_control`` with proper handling of zero-length packet (ZLP) -- Improved STM32 DCD FSDev -- Improved STM32 DCD Synopsys -- Migrated CI from Travis to Github Action -- Updated nrfx submodule to 2.1.0 -- Fixed mynewt osal queue definition -- Fixed ``cdc_msc_freertos`` example build for all MCUs - -Contributors ------------- - -Thanks to everyone who contributed to this release: @an-dr, @arturo182, @chang196700, @cr1901, @hathach, @jepler, @jeremyherbert, @kamtom480, @kasjer, @ladyada, @majbthrd, @mateusz-holenko, @noebrun, @nxf58843, @pigrew, @samveen, @smunaut, @tannewt, @xobs. diff --git a/docs/info/changelog/0.7.0.rst b/docs/info/changelog/0.7.0.rst deleted file mode 100644 index 664b323c8..000000000 --- a/docs/info/changelog/0.7.0.rst +++ /dev/null @@ -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 `__ 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. diff --git a/docs/info/changelog/0.8.0.rst b/docs/info/changelog/0.8.0.rst deleted file mode 100644 index 38f51ba6b..000000000 --- a/docs/info/changelog/0.8.0.rst +++ /dev/null @@ -1,101 +0,0 @@ -0.8.0 -===== - -*2021-02-05* - -Device Controller Driver ------------------------- - -- Added new device support for Raspberry Pi RP2040 -- Added new device support for NXP Kinetis KL25ZXX -- Use ``dcd_event_bus_reset()`` with link speed to replace bus_signal - -ESP32-S2 -^^^^^^^^ - -- Add bus suspend and wakeup support - -SAMD21 -^^^^^^ - -- Fix (workaround) samd21 setup_packet overflow by USB DMA - -STM32 Synopsys -^^^^^^^^^^^^^^ - -- Rework USB FIFO allocation scheme and allow RX FIFO size reduction - -Sony CXD56 -^^^^^^^^^^ - -- Update Spresense SDK to 2.0.2 -- Fix dcd issues with setup packets -- Correct EP number for cdc_msc example - -USB Device ----------- - -USBD -^^^^ - -- Rework usbd control transfer to have additional stage parameter for setup, data, status -- Fix ``tusb_init()`` return true instead of ``TUSB_ERROR_NONE`` -- Added new API ``tud_connected()`` that return true after device got out of bus reset and received the very first setup packet - -CDC -^^^ - -- Allow to transmit data, even if the host does not support control line states i.e set DTR - -HID -^^^ - -- change default ``CFG_TUD_HID_EP_BUFSIZE`` from 16 to 64 - -MIDI -^^^^ - -- Fix midi sysex sending bug - -MSC -^^^ - -- Invoke only scsi complete callback after status transaction is complete. -- Fix ``scsi_mode_sense6_t`` padding, which cause IAR compiler internal error. - -USBTMC -^^^^^^ - -- Change interrupt endpoint example size to 8 instead of 2 for better compatibility with mcu - -Example -^^^^^^^ - -- Support make from windows ``cmd.exe`` -- Add HID Consumer Control (media keys) to ``hid_composite`` & ``hid_composite_freertos`` examples - -USB Host --------- - -No noticeable changes to host stack - -New Boards ----------- - -- NXP/Freescale Freedom FRDM-KL25Z -- Feather Double M33 express -- Raspberry Pi Pico -- Adafruit Feather RP2040 -- Adafruit Itsy Bitsy RP2040 -- Adafruit QT RP2040 -- Adfruit Feather ESP32-S2 -- Adafruit Magtag 29" Eink -- Adafruit Metro ESP32-S2 -- Adafruit PyBadge -- Adafruit PyPortal -- Great Scott Gadgets' LUNA D11 & D21 - -Contributors ------------- - -Thanks to everyone who contributed to this release: @aslampr07, @charkster, @dobairoland, @duempel, @gsteiert, @hathach, @HiFiPhile, @kamtom480, @kkitayam, @ktemkin, @majbthrd, @PanRe, @prplz. diff --git a/docs/info/changelog/0.9.0.rst b/docs/info/changelog/0.9.0.rst deleted file mode 100644 index a48642144..000000000 --- a/docs/info/changelog/0.9.0.rst +++ /dev/null @@ -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. diff --git a/docs/info/changelog/index.rst b/docs/info/changelog/index.rst deleted file mode 100644 index 833008cd6..000000000 --- a/docs/info/changelog/index.rst +++ /dev/null @@ -1,27 +0,0 @@ -********* -Changelog -********* - -Release notes for each TinyUSB version, newest first. - -.. toctree:: - :maxdepth: 1 - - 0.21.0 - 0.20.0 - 0.19.0 - 0.18.0 - 0.17.0 - 0.16.0 - 0.15.0 - 0.14.0 - 0.13.0 - 0.12.0 - 0.11.0 - 0.10.1 - 0.10.0 - 0.9.0 - 0.8.0 - 0.7.0 - 0.6.0 - 0.5.0 diff --git a/tools/make_release.py b/tools/make_release.py index fc118af14..b24fc69b2 100755 --- a/tools/make_release.py +++ b/tools/make_release.py @@ -64,6 +64,6 @@ gen_doc.gen_boards_doc() gen_presets.main() ################### -# docs/info/changelog/ +# docs/changelog/ ################### -print("Add docs/info/changelog/{}.rst and list it at the top of docs/info/changelog/index.rst".format(version)) +print("Add docs/changelog/{}.rst and list it at the top of docs/changelog/index.rst".format(version)) -- cgit v1.3.1