1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
|
### Lightweight USB Device Stack ###
+ Lightweight and fast
+ Event-driven process workflow
+ Completely separated USB hardware driver and usb core
+ Easy to use.
### Requirements ###
+ [CMSIS V4](https://github.com/ARM-software/CMSIS) or [CMSIS V5](https://github.com/ARM-software/CMSIS_5).
+ [stm32.h](https://github.com/dmitrystu/stm32h) STM32 universal header
All requirements can be downloaded into a directory specified in environment variable `CMSIS` using
`make cmsis` command.
### Supported hardware ###
<table>
<tr><th>MCU Series</th><th>Features</th><th>Driver</th><th>File</th></tr>
<tr>
<td rowspan="2">STM32L0x2 STM32L0x3 STM32F070 STM32F0x2 STM32F0x8</td>
<td nowrap rowspan="2">Doublebuffered<sup>[2]</sup><br />8<sup>[1]</sup> endpoints<br /> BC1.2</td>
<td>usbd_devfs</td>
<td>usbd_stm32l052_devfs.c</td>
</tr>
<tr>
<td>usbd_devfs_asm</td>
<td>usbd_stm32l052_devfs_asm.S</td>
</tr>
<tr>
<td rowspan="2">STM32L4x2 STM32L4x3 STM32G4 series</td>
<td nowrap rowspan="2">Doublebuffered<sup>[2]</sup><br />8<sup>[1]</sup> endpoints<br /> BC1.2</td>
<td>usbd_devfs</td>
<td>usbd_stm32l433_devfs.c</td>
</tr>
<tr>
<td>usbd_devfs_asm</td>
<td>usbd_stm32l052_devfs_asm.S</td>
</tr>
<tr>
<td rowspan="2">STM32L1xx</td>
<td nowrap rowspan="2">Doublebuffered<sup>[2]</sup><br />8<sup>[1]</sup> endpoints</td>
<td>usbd_devfs</td>
<td>usbd_stm32l100_devfs.c</td>
</tr>
<tr>
<td>usbd_devfs_asm</td>
<td>usbd_stm32l100_devfs_asm.S</td>
</tr>
<tr>
<td rowspan="2">STM32F102 STM32F103 STM32F302 STM32F303 STM32F373</td>
<td nowrap rowspan="2">Doublebuffered<sup>[2]</sup><br />External DP pullup<br />8<sup>[1]</sup> endpoints</td>
<td>usbd_devfs</td>
<td>usbd_stm32f103_devfs.c</td>
</tr>
<tr>
<td>usbd_devfs_asm</td>
<td>usbd_stm32f103_devfs_asm.S</td>
</tr>
<tr>
<td>STM32WB55</td>
<td>Doublebuffered<sup>[2]</sup><br />External DP pullup<br />8<sup>[1]</sup> endpoints</td>
<td>usbd_devfs</td>
<td>usbd_stm32wb55_devfs.c</td>
</tr>
<tr>
<td>STM32L4x5 STM32L4x6</td>
<td nowrap>Doublebuffered<br />6 endpoints<br /> BC1.2<br />VBUS detection</td>
<td>usbd_otgfs</td>
<td>usbd_stm32l476_otgfs.c</td>
</tr>
<tr>
<td>STM32F401 STM32F411</td>
<td nowrap>Doublebuffered<br/>4 endpoints<br/>VBUS detection<br/>SOF output</td>
<td>usbd_otgfs</td>
<td>usbd_stm32f429_otgfs.c</td>
</tr>
<tr>
<td rowspan="2">STM32F4x5 STM32F4x7 STM32F4x9</td>
<td nowrap>Doublebuffered<br/>4 endpoints<br/>VBUS detection<br/>SOF output</td>
<td>usbd_otgfs</td>
<td>usbd_stm32f429_otgfs.c</td>
</tr>
<tr>
<td nowrap>Doublebuffered<br/>6 endpoints<br/>VBUS detection<br/>SOF output</td>
<td>usbd_otghs</td>
<td>usbd_stm32f429_otghs.c</td>
</tr>
<tr>
<td>STM32F105 STM32F107</td>
<td nowrap>Doublebuffered<br/>4 endpoints<br/>VBUS detection<br/>SOF output</td>
<td>usbd_otgfs</td>
<td>usbd_stm32f105_otgfs.c</td>
</tr>
<tr>
<td rowspan="2">STM32F4x6 STM32F7</td>
<td nowrap>Doublebuffered<br/>6 endpoints<br/>VBUS detection<br/>SOF output</td>
<td>usbd_otgfs</td>
<td>usbd_stm32f446_otgfs.c</td>
</tr>
<tr>
<td nowrap>Doublebuffered<br/>9 endpoints<br/>VBUS detection<br/>SOF output</td>
<td>usbd_otghs</td>
<td>usbd_stm32f446_otghs.c</td>
</tr>
<tr>
<td>STM32H743</td>
<td nowrap>Doublebuffered<br/>6 endpoints<br/>VBUS detection<br/>SOF output</td>
<td>usbd_otgfs</td>
<td>usbd_stm32h743_otgfs.c</td>
</tr>
</table>
1. Single physical endpoint can be used to implement
+ one bi-directional/single-buffer logical endpoint (CONTROL)
+ one uni-directional/double-buffer logical endpoint (BULK OR ISOCHRONOUS)
+ two uni-directional/single-buffer logical endpoints (BULK OR INTERRUPT)
2. At this moment BULK IN endpoint can use both buffers, but it is not **real** doublebuffered.
3. Tested with STM32L052K8, STM32L100RC, STM32L476RG, STM32F072C8, STM32F103C8, STM32F103CB,
STM32F303CC, STM32F303RE, STM32F429ZI, STM32F105RBT6, STM32F107VCT6, STM32L433CCT6, STM32F070CBT6,
STM32G431RB, STM32F411CEUx, STM32F405RG, STM32F446RE, STM32F373CC, STM32L053R8, GD32F103C8T6,
STM32F745VE, STM32F401CE, STM32H743.
See [hardware.md](hardware.md) for details.
### Implemented definitions for classes ###
1. USB HID based on [Device Class Definition for Human Interface Devices (HID) Version 1.11](https://www.usb.org/sites/default/files/documents/hid1_11.pdf)
2. USB DFU based on [USB Device Firmware Upgrade Specification, Revision 1.1](https://www.usb.org/sites/default/files/DFU_1.1.pdf)
3. USB CDC based on [Class definitions for Communication Devices 1.2](https://www.usb.org/sites/default/files/CDC1.2_WMC1.1_012011.zip)
4. USB TMC based on [USB Device Test and Measurement Class Specification, Revision 1.0](https://www.usb.org/sites/default/files/USBTMC_1_006a.zip)
### Using makefile ###
+ to build library module
```
make module MODULE=path/module.a DEFINES="mcu specified defines" CFLAGS="cpu specified compiler flags"
```
+ to build demo
```
make bluepill program
make stm32l052x8
```
+ to get a help
```
make help
```
### Default values: ###
| Variable | Default Value | Means |
|----------|-------------------------------------|-------------------------------|
| CMSIS | ./CMSIS | path to CMSIS root folder |
| CMSISDEV | $(CMSIS)/Device | path to CMSIS device folder |
| CMSISCORE| $(CMSIS)/CMSIS/Include $(CMSIS)/CMSIS/Core/Include | path to CMSIS core headers |
| MCU | stm32l100xc | MCU selection for demo project|
| CFLAGS | -mcpu=cortex-m3 -mfloat-abi=soft | MCU specified compiler flags |
| DEFINES | STM32L1 STM32L100xC | MCU specified defines |
| STPROG_CLI | ~/STMicroelectronics/STM32Cube/STM32CubeProgrammer/bin/STM32_Programmer_CLI | Path to the ST Cube Programmer CLI |
| OPTFLAGS | -Os | Code optimization flags |
### Useful Resources ###
1. [USB Implementers Forum official site](https://www.usb.org/)
2. [USB Made Simple](http://www.usbmadesimple.co.uk/)
3. [LUFA - the Lightweight USB Framework for AVRs.](https://github.com/abcminiuser/lufa)
4. [Open Source ARM cortex m microcontroller library](https://github.com/libopencm3/libopencm3)
|
