114 lines
4.0 KiB
Markdown
114 lines
4.0 KiB
Markdown
# USB Stack
|
||
|
||
[English](./README.md)
|
||
|
||
USB Stack 是一个小而美的、可移植性高的、用于嵌入式系统的 USB 主从协议栈。
|
||
|
||
## USB Stack 目录结构
|
||
|
||
```
|
||
.
|
||
├── class
|
||
│ ├── audio
|
||
│ ├── cdc
|
||
│ ├── dfu
|
||
│ ├── hid
|
||
│ ├── hub
|
||
│ ├── midi
|
||
│ ├── msc
|
||
│ ├── tmc
|
||
│ └── video
|
||
├── common
|
||
├── core
|
||
├── demo
|
||
│ ├── bouffalolab
|
||
│ └── stm32
|
||
│ └── mm32
|
||
│ └── ch32
|
||
├── docs
|
||
├── packet capture
|
||
└── port
|
||
├── bouffalolab
|
||
│ └── bl702
|
||
├── ch32
|
||
├── fsdev
|
||
├── mm32
|
||
├── synopsys
|
||
├── musb
|
||
└── template
|
||
```
|
||
|
||
| 目录名 | 描述 |
|
||
|:-------------:|:------------------------------:|
|
||
|class | usb class 类主从驱动 |
|
||
|common | usb spec 定义和一些常用函数 |
|
||
|core | usb 主从核心实现 |
|
||
|demo | 示例 |
|
||
|docs | 文档 |
|
||
|packet capture | 抓包文件（需要使用力科软件打开）|
|
||
|port | usb 主从需要实现的 porting 接口 |
|
||
|
||
## USB Device 协议栈简介
|
||
|
||
USB Device 协议栈对标准设备请求、CLASS 请求、VENDOR 请求以及 custom 特殊请求规范了一套统一的函数框架，采用面向对象和链表的方式，能够使得用户快速上手复合设备，不用管底层的逻辑。同时，规范了一套标准的 dcd porting 接口，用于适配不同的 USB IP，达到面向 ip 编程。
|
||
|
||
USB Device 协议栈的代码实现过程参考 <https://www.bilibili.com/video/BV1Ef4y1t73d> 。
|
||
|
||
USB Device 协议栈当前实现以下功能：
|
||
|
||
- 支持 USB2.0 全速和高速设备
|
||
- 支持端点中断注册功能，porting 给用户自己处理中断里的数据
|
||
- 支持复合设备
|
||
- 支持 Communication Class (CDC)
|
||
- 支持 Human Interface Device (HID)
|
||
- 支持 Custom human Interface Device (HID)
|
||
- 支持 Mass Storage Class (MSC)
|
||
- 支持 USB VIDEO CLASS (UVC)
|
||
- 支持 USB AUDIO CLASS (UAC)
|
||
- 支持 Device Firmware Upgrade CLASS (DFU)
|
||
- 支持 USB MIDI CLASS (MIDI)
|
||
- 支持 Test and Measurement CLASS (TMC)
|
||
- 支持 Vendor 类 class
|
||
- 支持 WINUSB1.0、WINUSB2.0
|
||
|
||
USB Device 协议栈资源占用说明：
|
||
|
||
| file | FLASH (Byte) | RAM (Byte) |
|
||
|:-----------:|:--------------:|:------------:|
|
||
|usbd_core.c | 3045 | 373 |
|
||
|usbd_cdc.c | 302 | 20 |
|
||
|usbd_msc.c | 2452 | 132 |
|
||
|usbd_hid.c | 784 | 201 |
|
||
|usbd_audio.c | 438 | 14 |
|
||
|usbd_video.c | 402 | 4 |
|
||
|
||
## USB Host 协议栈简介
|
||
|
||
waiting....
|
||
|
||
## USB Device API
|
||
|
||
更详细的设备协议栈 API 请参考: [USB Device API](docs/usb_device.md)
|
||
|
||
## USB Host API
|
||
|
||
更详细的主机协议栈 API 请参考: [USB Host API](docs/usb_host.md)
|
||
|
||
## RT-Thread 软件包使用
|
||
|
||
如何在 RT-Thread OS 中使用软件包，请参考：[USB Stack 在 RT-Thread package 中的使用](docs/rt-thread_zh.md)
|
||
|
||
## USB 参考手册
|
||
|
||
- USB2.0 spec: <https://www.usb.org/document-library/usb-20-specification>
|
||
- CDC: <https://www.usb.org/document-library/class-definitions-communication-devices-12>
|
||
- MSC: <https://www.usb.org/document-library/mass-storage-class-specification-overview-14>
|
||
<https://www.usb.org/document-library/mass-storage-bulk-only-10>
|
||
- HID: <https://www.usb.org/document-library/device-class-definition-hid-111>
|
||
<https://www.usb.org/document-library/hid-usage-tables-122>
|
||
- AUDIO: <https://www.usb.org/document-library/audiovideo-device-class-v10-spec-and-adopters-agreement>
|
||
<https://www.usb.org/document-library/audio-data-formats-10>
|
||
- VIDEO: <https://www.usb.org/document-library/video-class-v11-document-set>
|
||
- TMC: <https://www.usb.org/document-library/test-measurement-class-specification>
|
||
- DFU: <https://www.st.com/resource/zh/application_note/cd00264379-usb-dfu-protocol-used-in-the-stm32-bootloader-stmicroelectronics.pdf>
|