一个开源跨平台嵌入式USB设备协议：TinyUSB

news2024/11/27 14:31:23

概述

TinyUSB 是一个用于嵌入式系统的开源跨平台 USB 主机/设备堆栈，设计为内存安全，无需动态分配，线程安全，所有中断事件都被推迟，然后在非 ISR 任务函数中处理。查看在线文档以获取更多详细信息。

源码链接：GitHub - chjun8/tinyusb: An open source cross-platform USB stack for embedded system

.
├── 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

入门

有关使用 TinyUSB 及其实现方式的信息，请参阅在线文档。

我们使用GitHub Discussions作为我们的论坛。这是向社区提出问题和建议或讨论基于 TinyUSB 的项目的好地方。

对于错误和功能请求，请提出问题并遵循那里的模板。

查看入门指南，将 TinyUSB 添加到您的项目或构建示例。如果您是 TinyUSB 的新手，我们建议您从cdc_msc示例开始。

请参阅移植指南以添加对新 MCU 和板的支持。

设备堆栈

通过动态更改 USB 描述符、挂起、恢复和远程唤醒等低功耗功能来支持多种设备配置。支持以下设备类别：

音频等级 2.0 (UAC2)
蓝牙主机控制器接口 (BTH HCI)
通信设备类 (CDC)
设备固件更新 (DFU)：DFU 模式 (WIP) 和运行时
人机接口设备 (HID)：通用（输入和输出）、键盘、鼠标、游戏手柄等...
海量存储类 (MSC)：具有多个 LUN
乐器数字接口 (MIDI)
与 RNDIS 网络、以太网控制模型 (ECM)、网络控制模型 (NCM)
测试与测量类 (USBTMC)
视频等级 1.5 (UVC)：正在进行中
具有通用输入和输出端点的供应商特定类支持。可与 MS OS 2.0 兼容描述符一起使用，无需 INF 文件即可加载 winUSB 驱动程序。
具有供应商特定类的WebUSB

如果您有特殊要求，可以使用usbd_app_driver_get_cb()编写自己的类驱动程序，而无需修改堆栈。以下是 RPi 团队如何添加重置接口raspberrypi/pico-sdk#197

主机堆栈

人机接口设备 (HID)：键盘、鼠标、通用
海量存储类 (MSC)
通信设备类别：CDC-ACM
通过 USB 的供应商串行：FTDI、CP210x
具有多级支持的集线器

与设备堆栈类似，如果您有特殊要求，可以使用usbh_app_driver_get_cb()编写自己的类驱动程序，而无需修改堆栈。

TypeC PD 堆栈

支持 USB Type-C 的供电 3.0 (PD3.0) (WIP)
超早期阶段，仅用于测试目的
仅支持STM32 G4

操作系统抽象层

TinyUSB 是完全线程安全的，它将所有中断服务请求 (ISR) 事件推送到中央队列，然后在非 ISR 上下文任务函数中对其进行处理。它还使用信号量/互斥体来访问共享资源，例如通信设备类 (CDC) FIFO。因此，堆栈需要使用操作系统的一些基本 API。以下操作系统已经得到开箱即用的支持。

无操作系统
自由实时操作系统
RT-Thread：回购协议
Mynewt由于 newt 包构建系统，Mynewt 示例最好位于其自己的存储库中

支持的CPU

支持以下 CPU，请查看支持的设备以获取每个 CPU 的驱动程序和功能的完整列表。

制造商	家庭
全志	F1C100/F1C200
模拟	MAX3421E（USB主机扩展板）
布里格泰克	FT90x
博通	BCM2711、BCM2837
对话	DA1469x
乐鑫	ESP32 S2、S3
兆易创新	GD32VF103
英飞凌	XMC4500
微芯片	萨姆 \| D11、D21、D51、E5x、G55、L2x、E7x、S7x、V7x ---+-------------------------------------------------------- ----------+ 图片\| 24、32mm、32mk、32mx、32mz、dsPIC33
心灵感应	毫米32
北欧半导体	nRF52833、nRF52840、nRF5340
新唐	NUC 120, 121, 125, 126, 505
恩智浦	iMXRT \| RT10xx、RT11xx ------+---------------------------------------- ----------+ 动力学\|吉隆坡，K32L2 ------+---------------------------------------- ----------+ 液化石油气 \| 11u、13、15、17、18、40、43、51u、54、55 ------+---------------------------------------- ----------+ MCX \| A15、N9
树莓派	RP2040
瑞萨	接收\| 63N、65N、72N
	RA \| 4M1、4M3、6M1、6M5
西拉布斯	EFM32GG12
索尼	CXD56
意法半导体STM32	F0、F1、F2、F3、F4、F7、H7、G0、G4、L0、L1、L4、L4+ U5、WB
TI	MSP430、MSP432E4、TM4C123
价USB	埃普特里
世界卫生大会	CH32F20x、CH32V307、