diff options
| author | Ha Thach <[email protected]> | 2026-06-30 16:11:24 +0700 |
|---|---|---|
| committer | GitHub <[email protected]> | 2026-06-30 16:11:24 +0700 |
| commit | da41189467c00e339b89f722b6c6e24e4481b288 (patch) | |
| tree | 1822de246f30fad267343a58831d71e4413fcb96 /docs/info | |
| parent | 40f4c12c6be504031d2e2808f191134739206b5e (diff) | |
| parent | 47ce85fc1916ea08bee3c70c261fd8674604f169 (diff) | |
Merge pull request #3745 from hathach/claude/release-0.21.0
Release 0.21.0
Diffstat (limited to 'docs/info')
| -rw-r--r-- | docs/info/changelog.rst | 1483 | ||||
| -rw-r--r-- | docs/info/code_of_conduct.rst | 1 | ||||
| -rw-r--r-- | docs/info/contributors.rst | 1 | ||||
| -rw-r--r-- | docs/info/index.rst | 13 |
4 files changed, 0 insertions, 1498 deletions
diff --git a/docs/info/changelog.rst b/docs/info/changelog.rst deleted file mode 100644 index 35c8515cc..000000000 --- a/docs/info/changelog.rst +++ /dev/null @@ -1,1483 +0,0 @@ -********* -Changelog -********* - -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 - -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 - -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 - -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 - -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 - -0.15.0 -====== - -- Add codespell to detect typo -- Add support for fuzzing and bagde 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 masstorage 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 - -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 santiy -- [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 -- [Venndor] Improve write performance - -Host Stack ----------- - -- Add new API ``tuh_configure(rhport, cfg_id, cfg_param)`` for dynamnic 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 - -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 - -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 - -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 techinical 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 - -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 - -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 - - -0.9.0 (2021-03-12) -================== - -Device Stack ------------- - -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 walkaround 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 Stack ----------- - -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 - - -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 (walkaround) samd21 setup_packet overflow by USB DMA - -- STM32 Synopsys: - - - Rework USB FIFO allocation scheme and allow RX FIFO size reduction - -- Sony CXD56 - - - Update 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 - -**Class Driver** - -- 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 - - -0.7.0 (2020-11-08) -================== - -Device Controller Driver ------------------------- - -- Added new support for Espressif ESP32-S2 -- Added new support for Dialog DA1469x -- Enhance STM32 Synopsys - -- Support bus events disconnection/suspend/resume/wakeup - - - Improve transfer performance with optimizing xfer and fifo size - - Support Highspeed port (OTG_HS) with both internal and external PHY - - Support multiple usb ports with rhport=1 is highspeed on selected MCUs e.g H743, F23. It is possible to have OTG_HS to run on Fullspeed PHY (e.g lacking external PHY) - - Add ISO transfer, fix odd/even frame - - Fix FIFO flush during stall - - Implement ``dcd_edpt_close()`` API - - Support F105, F107 - -- Enhance STM32 fsdev - - - Improve dcd fifo allocation - - Fix ISTR race condition - - Support remap USB IRQ on supported MCUs - - Implement ``dcd_edpt_close()`` API - -- Enhance NUC 505: enhance set configure behavior - -- Enhance SAMD - - - Fix race condition with setup packet - - Add SAMD11 option ``OPT_MCU_SAMD11`` - - Add SAME5x option ``OPT_MCU_SAME5X`` - -- Fix SAMG control data toggle and stall race condition - -- Enhance nRF - - - Fix hanged when ``tud_task()`` is called within critical section (disabled interrupt) - - Fix disconnect bus event not submitted - - Implement ISO transfer and ``dcd_edpt_close()`` - - -USB Device ----------- - -**USBD** - -- Add new class driver for **Bluetooth HCI** class driver with example can be found in [mynewt-tinyusb-example](https://github.com/hathach/mynewt-tinyusb-example) since it needs mynewt OS to run with. -- Fix USBD endpoint usage racing condition with ``usbd_edpt_claim()``/``usbd_edpt_release()`` -- Added ``tud_task_event_ready()`` and ``osal_queue_empty()``. This API is needed to check before enter low power mode with WFI/WFE -- Rename USB IRQ Handler to ``dcd_int_handler()``. Application must define IRQ handler in which it calls this API. -- Add ``dcd_connect()`` and ``dcd_disconnect()`` to enable/disable internal pullup on D+/D- on supported MCUs. -- Add ``usbd_edpt_open()`` -- Remove ``dcd_set_config()`` -- Add ``OPT_OS_CUMSTOM`` as hook for application to overwrite and/or add their own OS implementation -- Support SET_INTERFACE, GET_INTERFACE request -- Add Logging for debug with optional uart/rtt/swo printf retarget or ``CFG_TUSB_DEBUG_PRINTF`` hook -- Add IAR compiler support -- Support multiple configuration descriptors. ``TUD_CONFIG_DESCRIPTOR()`` template has extra config_num as 1st argument -- Improve USB Highspeed support with actual link speed detection with ``dcd_event_bus_reset()`` - -- Enhance class driver management - - - ``usbd_driver_open()`` add max length argument, and return length of interface (0 for not supported). Return value is used for finding appropriate driver - - Add application implemented class driver via ``usbd_app_driver_get_cb()`` - - IAD is handled to assign driver id - -- Added ``tud_descriptor_device_qualifier_cb()`` callback -- Optimize ``tu_fifo`` bulk write/read transfer -- Forward non-std control request to class driver -- Let application handle Microsoft OS 1.0 Descriptors (the 0xEE index string) -- Fix OSAL FreeRTOS yield from ISR - -**Class Drivers** - -- 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 - - -0.6.0 (2020-03-30) -================== - -Added **CONTRIBUTORS.md** to give proper credit for contributors to the stack. Special thanks to `Nathan Conrad <https://github.com/pigrew>`__ , `Peter Lawrence <https://github.com/majbthrd>`__ , `William D. Jones <https://github.com/cr1901>`__ and `Sean Cross <https://github.com/xobs>`__ and others for spending their precious time to add lots of features and ports for this release. - -Added ------ - -**MCU** - -- Added support for Microchip SAMG55 -- Added support for Nordic nRF52833 -- Added support for Nuvoton: NUC120, NUC121/NUC125, NUC126, NUC505 -- Added support for NXP LPC: 51Uxx, 54xxx, 55xx -- Added support for NXP iMXRT: RT1011, RT1015, RT1021, RT1052, RT1062, RT1064 -- Added support for Sony CXD56 (Spresense) -- Added support for STM32: L0, F0, F1, F2, F3, F4, F7, H7 -- Added support for TI MSP430 -- Added support for ValentyUSB's eptri - -**Class Driver** - -- Added DFU Runtime class driver -- Added Network class driver with RNDIS, CDC-ECM, CDC-EEM (work in progress) -- Added USBTMC class driver -- Added WebUSB class driver using vendor-specific class -- Added multiple instances support for CDC and MIDI -- Added a handful of unit test with Ceedling. -- Added LOG support for debugging with CFG_TUSB_DEBUG -- Added ``tud_descriptor_bos_cb()`` for BOS descriptor (required for USB 2.1) -- Added ``dcd_edpt0_status_complete()`` as optional API for DCD - -**Examples** - -Following examples are added: - -- ``board_test`` -- ``cdc_dual_ports`` -- ``dfu_rt`` -- ``hid_composite`` -- ``net_lwip_webserver`` -- ``usbtmc`` -- ``webusb_serial`` - -Changed -------- - -- Changed ``tud_descriptor_string_cb()`` to have additional Language ID argument -- Merged ``hal_nrf5x.c`` into ``dcd_nrf5x.c`` -- Merged ``dcd_samd21.c`` and ``dcd_samd51.c`` into ``dcd_samd.c`` -- Generalized ``dcd_stm32f4.c`` to ``dcd_synopsys.c`` -- Changed ``cdc_msc_hid`` to ``cdc_msc`` (drop hid) due to limited endpoints number of some MCUs -- Improved DCD SAMD stability, fix missing setup packet occasionally -- Improved ``usbd/usbd_control`` with proper handling of zero-length packet (ZLP) -- Improved STM32 DCD FSDev -- Improved STM32 DCD Synopsys -- Migrated CI from Travis to Github Action -- Updated nrfx submodule to 2.1.0 -- Fixed mynewt osal queue definition -- Fixed ``cdc_msc_freertos`` example build for all MCUs - - -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 diff --git a/docs/info/code_of_conduct.rst b/docs/info/code_of_conduct.rst deleted file mode 100644 index 2d70708d4..000000000 --- a/docs/info/code_of_conduct.rst +++ /dev/null @@ -1 +0,0 @@ -.. include:: ../../CODE_OF_CONDUCT.rst diff --git a/docs/info/contributors.rst b/docs/info/contributors.rst deleted file mode 100644 index 35e0b05f5..000000000 --- a/docs/info/contributors.rst +++ /dev/null @@ -1 +0,0 @@ -.. include:: ../../CONTRIBUTORS.rst
\ No newline at end of file diff --git a/docs/info/index.rst b/docs/info/index.rst deleted file mode 100644 index b6d30b432..000000000 --- a/docs/info/index.rst +++ /dev/null @@ -1,13 +0,0 @@ -**** -Info -**** - -Index -===== - -.. toctree:: - :maxdepth: 2 - - changelog - contributors - code_of_conduct |
