# cherry-embedded/CherryUSB

CherryUSB is a tiny and beautiful, high performance and portable USB host and device stack for embedded system with USB IP

Repository: https://github.com/cherry-embedded/CherryUSB
Canonical: https://ross.abutalabs.com/products/cherryusb
Homepage: https://cherryusb.readthedocs.io
Language: C
License: Apache-2.0
License Family: permissive
Topics: usb-host, usb-device, usb, cdc, hid, uvc, uac, dfu, ehci, hub, rndis, musb, dwc2, xhci, cherryusb, cdns2, cdns3, ohci
Last push: 2026-08-25T13:32:47+00:00

## Health v2 (maintenance only)
Score: 89/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 69, longevity 100
- inputs: {"age_days": 1880, "days_push": 8, "days_rel": 128, "gap_med": 63, "n_releases_24m": 10}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2009, forks 438 (observed 2026-08-28T04:06:04.975511+00:00)

## What it is
CherryUSB is a portable, high-performance USB host and device stack written in C for embedded systems with various USB IPs. It provides class drivers (CDC, HID, UVC, UAC, DFU, RNDIS), a USB core, and porting layers for controllers like DWC2, EHCI, XHCI, and MUSB.

## Use cases
- implement usb device firmware on an mcu
- add usb host support to an embedded system
- create a cdc virtual serial port over usb
- implement usb hid keyboard or mouse device
- stream video over usb with uvc
- port a usb stack to a custom usb ip core
- achieve near-theoretical usb bandwidth with dma

## When to choose
- you need a lightweight, portable USB stack for bare-metal or RTOS embedded projects
- you want zero-copy, DMA-friendly USB performance
- you need both host and device support in one stack
- you want readable, well-structured USB code for learning

## When to avoid
- you need a USB stack for desktop operating systems
- your project already uses a vendor-provided USB stack with no porting needs
- you need USB 3.x features not covered by supported IPs

## Facets
- artifact type: library
- maturity: active
- function: embedded, sdk, file-system
- domain: embedded-systems, hardware, developer-tools
- platform: embedded, c, cross-platform
- tags: usb-host, usb-device, usb-stack, hid, cdc, uvc, dfu, dwc2, ehci, xhci

## Member repositories
- cherry-embedded/CherryUSB (main) score 89

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:04.975511+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:01:15.577416+00:00, confidence not recorded.
  - readme: https://github.com/cherry-embedded/CherryUSB (fetched 2026-08-28T04:06:04.975511+00:00, sha 3cf6ad62d03d)
- Data as of 2026-08-30T08:39:29.467469+00:00.