一个简易的STM32 USB主机和设备协议栈
A teeny USB device and host stack for STM32 MCUs
关于TeenyUSB的实现细节和使用方式请阅读《STM32 USB设备开发指南》 Github下载 , 21IC下载
- HID class
- MSC 大容量存储设备，U盘。 Mass storage class
- CDC ACM 虚拟串口。 Communication device class, abstract control mode, known as virtual serial port.
- CDC RNDIS 虚拟网口。 Communication device class, remote NDIS
- Vendor 厂商自定义设备。 vendor class
USB描述符由TeenyDT生成。 在线试用TeenyDT
USB descriptor is generate by TeenyDT. Try TeenyDT online
- 复合设备，包含HID CDC(虚拟串口) WinUSB MSC(U盘) Composite device with HID+CDC+WinUSB+MSC
- WinUSB设备，Bulk传输免驱动。 Bulk device with WinUSB support
- CMSIS DAP on STM32F723 discovery
- 虚拟网卡, CDC RNDIS device
- HUB class, 支持多设备级连, support multiple device and hub
- HID class, 支持键盘、鼠标以及自定义HIDden设备。support keyboard, mouse, custom device
- MSC class, 大容量存储类(U盘)，使用BOT协议。 mass storage class with BOT protocol
- CDC ACM class, 虚拟串口。 Communication device class, abstract control mode
- CDC RNDIS class, 虚拟网口。 Communication device class, remote NDIS
- Vendor class，厂商自定义设备
- 简易交互式主机，支持U盘、HUB、键盘、鼠标以及自定义设备 更多说明。 Interactive host, support HUB,MSC,Keyboard,Mouse and generic device. more info
- rt-thread双角色设备, 支持运行时切换设备类行，支持动态mount U盘，更多说明。Dual role device with rt-thread, more info.
编译工具为 arm-none-eabi-gcc is the compile toolchain.
调试使用VSCode+OpenOCD，如何在VSCode中配置STM32开发调试环境?
git clone https://github.com/xtoolbox/TeenyUSB.git
cd TeenyUSB
git submodule update --init
cd demo
make all -j8如果更新mcu库很慢，可以使用gitee.com镜像。https://gitee.com/xtoolbox/st_driver.git
$ echo " text data bss dec hex filename" && make all -j8 LOG_INFO=0 | grep '^[^l].*output/.*.elf'
text data bss dec hex filename
12072 1084 69296 82452 14214 output/f723dap.elf
4480 1080 6068 11628 2d6c output/f072bulk.elf
6392 1084 6416 13892 3644 output/f407bulk.elf
5396 1084 6064 12544 3100 output/f303bulk.elf
4972 1080 6068 12120 2f58 output/f103bulk.elf
6524 1084 6416 14024 36c8 output/f723bulk.elf
6284 1084 6416 13784 35d8 output/f767bulk.elf
8100 3500 2200 13800 35e8 output/f103comp.elf
8324 3500 2200 14024 36c8 output/f072comp.elf
10132 3504 2588 16224 3f60 output/f407comp.elf
10240 3504 2588 16332 3fcc output/f723comp.elf
8528 3504 2196 14228 3794 output/f303comp.elf
10000 3504 2588 16092 3edc output/f767comp.elf
27560 1092 35776 64428 fbac output/f107host.elf
28704 1092 28608 58404 e424 output/f407host.elf
28860 1092 28832 58784 e5a0 output/f723host.elf
28504 1092 28792 58388 e414 output/f767host.elf
.
├── TeenyDT # 基于lua的USB描述符生成工具 A lua based USB descriptor generator
├── demo # 示例代码 Sample projects
├── mcu_lib # MCU文件子仓库，MCU library sub module
├── usb_stack # USB主机及设备类文件 TeenyUSB host and deivce class
├── pc_test_tool # 基于lua Qt的Windows USB 测试程序 A luaQt based Windows program to test CDC/HID/WinUSB devices
└── third_part # 第三方代码,如FatFs,rt-thread。 Third part source code, e.g. FatFs, rt-thread.
| Board Folder | Board Type | Chip | HSE Freq | USB Core |
|---|---|---|---|---|
| stm32f072c8t6 | Custom board | STM32F072C8T6 | No HSE | USB FS |
| stm32f103ret6 | Custom board | STM32F103RET6 | 8 MHz | USB FS |
| stm32f107vc | Custom board | STM32F107VCT6 | 25 MHz | OTG_FS |
| stm32f3_disco | stm32f3 disco | STM32F303VCT6 | 8 MHz | USB FS |
| stm32f407_evk | Waveshare EVK407I | STM32F407IGT6 | 8 MHz | OTG_FS/OTG_HS_ULPI |
| stm32f723e_disco | stm32f723e discovery | STM32F723IEK6 | 25 MHz | OTG_FS/OTG_HS_Embed |
| stm32767zi_nucleo | stm32f767zi nucleo | STM32F767ZIT6 | 8 MHz | OTG_FS |
- tinyusb 全静态内存分配，不支持多设备，不支持同一设备上使用多个同类型接口，暂时不支持STM32主机模式。
- libopencm3 动态生成描述符，不依赖官方库。USB设备类型少，不支持主机模式。
- libusb_stm32 资源占用极少的USB设备库，不支持主机模式。
- lufa 运行于AVR的轻量级USB主机和从机栈。