tinyusb

TinyUSB
=======

|Sponsor| |License| |Build Status| |CircleCI Status| |Documentation Status| |Static Analysis| |Fuzzing Status| |Membrowse| |CodeRabbit| |Greptile|

Overview
--------

.. figure:: docs/assets/logo.svg
   :alt: TinyUSB
   :align: left

.. raw:: html

   <div class="clear-both"></div>

TinyUSB is an open-source cross-platform USB Host/Device stack for embedded systems. It’s designed for memory safety
(no dynamic allocation) and thread safety (all interrupts deferred to non-ISR task functions). The stack emphasizes portability,
small footprint, and real-time performance across 50+ MCU families.

Sponsors
--------

TinyUSB's continued development is made possible by its sponsors. If TinyUSB helps your products or projects, consider funding its development on `GitHub Sponsors`_.

Platinum
^^^^^^^^

`Adafruit`_ has backed TinyUSB since day one as its founding and sole Platinum sponsor. Buying their products directly funds the project's development.

.. figure:: docs/assets/adafruit_logo.svg
   :alt: Adafruit Logo
   :align: left
   :target: https://www.adafruit.com

.. raw:: html

   <div class="clear-both"></div>

Sponsors (QWORD)
^^^^^^^^^^^^^^^^

.. QWORD-SPONSORS-START

*No QWORD sponsors yet — be the first!*

.. QWORD-SPONSORS-END

Backers (DWORD)
^^^^^^^^^^^^^^^

.. DWORD-BACKERS-START

*No backers yet — be the first!*

.. DWORD-BACKERS-END

Supporters (Word)
^^^^^^^^^^^^^^^^^

.. WORD-SUPPORTERS-START

cee\*\*\*\*

.. WORD-SUPPORTERS-END

Thanks (Byte)
^^^^^^^^^^^^^

.. BYTE-THANKS-START

`@8086net <https://github.com/8086net>`__, `@GCRev <https://github.com/GCRev>`__

.. BYTE-THANKS-END

.. _GitHub Sponsors: https://github.com/sponsors/hathach
.. _Adafruit: https://www.adafruit.com

Key Features
------------

* **Thread-safe:** USB interrupts deferred to task context
* **Memory-safe:** No dynamic allocation, all buffers static
* **Portable:** Supports 50+ MCU families
* **Comprehensive:** Includes CDC, HID, MSC, Audio, and Host support
* **RTOS-friendly:** Works with bare metal, FreeRTOS, RT-Thread, and Mynewt

.. figure:: docs/assets/stack.svg
   :width: 500px
   :align: left
   :alt: stackup

.. raw:: html

   <div class="clear-both"></div>

::

    .
    ├── docs            # Documentation
    ├── examples        # Examples with make and cmake build system
    ├── hw
    │   ├── bsp         # Supported boards source files
    │   └── mcu         # Low level mcu core & peripheral drivers
    ├── lib             # Sources from 3rd party such as FreeRTOS, FatFs ...
    ├── src             # All sources files for TinyUSB stack itself.
    ├── test            # Tests: unit test, fuzzing, hardware test
    └── tools           # Files used internally


Getting started
---------------

See the `online documentation <https://docs.tinyusb.org>`_ for information about using TinyUSB and how it is implemented.

Check out `Getting Started`_ guide for adding TinyUSB to your project or building the examples. If you are new to TinyUSB, we rec