/
usbd_if.c
193 lines (177 loc) · 7.39 KB
/
usbd_if.c
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
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
/**
******************************************************************************
* @file usbd_if.c
* @author fpistm
* @brief USB Device common interface file
******************************************************************************
*/
#ifdef USBCON
#include "usbd_if.h"
#include "usbd_cdc_if.h"
#include "stm32yyxx_ll_system.h"
#if !defined(USBD_REENUM_DISABLED)
/*
* Below, support for re-attaching to USB is handled. USB-attachment is
* detected by the presence of a pullup on one of the USB datalines.
*
* To force the USB host to re-enumerate, we must detach (disable
* pullup), wait a bit, and re-attach (enable pullup). This can be done
* while running, but must also happen at startup (including the detach
* and delay, since USB might have been active just before reset, so we
* must force a re-enumeration). On a cold boot (e.g. USB just plugged
* in), the forced detach might not be needed, but will not be harmful
* either.
*
* For pullup control, a number of cases are supported:
* 1. An external pullup controllable through a GPIO (e.g. using an
* external transistor). The default output state (e.g. when the
* GPIO is floating) can be enabled or disabled, and the output
* polarity can be configured.
* 2. A pullup built into the chip's USB core. This is automatically
* enabled by hardware or USB HAL code, and can be manually
* controlled using HAL functions.
* 3. A fixed (always enabled) external pullup. To still allow detaching,
* a bit of a hack is used: By setting the D+ to OUTPUT LOW, it
* *looks* like the pullup is removed (the host has own, bigger,
* pulldown, to detect detaching, so writing LOW looks the same).
* This probably violates USB specifications, but does seem to work
* well in practice. It probably also should only be used briefly,
* keeping the pin OUTPUT LOW for longer might be problematic.
*
* These scenarios are considered in order: If the variant defines an
* external pullup control pin, it is used, else if an internal pullup
* is present, that is used, else the D+ trick is used.
*
* To configure #1, the variant should either define USBD_ATTACH_PIN and
* USBD_ATTACH_LEVEL when the pullup is disabled by default and the pin
* can be used to *attach*, or USBD_DETACH_PIN and USBD_DETACH_LEVEL
* when the pullup is enabled by default and the pin can be used to
* *detach*.
*/
/* Compatibility with the old way to specify this */
#if defined(USB_DISC_PIN) && !defined(USBD_ATTACH_PIN)
#define USBD_ATTACH_PIN USB_DISC_PIN
#define USBD_ATTACH_LEVEL LOW
#warning "USB_DISC_PIN is deprecated, use USBD_ATTACH_PIN instead"
#endif /* defined(USB_DISC_PIN) && !defined(USBD_ATTACH_PIN) */
/* Some sanity checks */
#if defined(USBD_ATTACH_PIN) && defined(USBD_DETACH_PIN)
#error "Cannot define both USBD_ATTACH_PIN and USBD_DETACH_PIN"
#endif /* defined(USBD_ATTACH_PIN) && defined(USBD_DETACH_PIN) */
#if defined(USBD_ATTACH_PIN) && !defined(USBD_ATTACH_LEVEL)
#error "USBD_ATTACH_PIN also needs USBD_ATTACH_LEVEL defined"
#endif /* defined(USBD_ATTACH_PIN) && !defined(USBD_ATTACH_LEVEL) */
#if defined(USBD_DETACH_PIN) && !defined(USBD_DETACH_LEVEL)
#error "USBD_DETACH_PIN also needs USBD_DETACH_LEVEL defined"
#endif /* defined(USBD_DETACH_PIN) && !defined(USBD_DETACH_LEVEL) */
#if (defined(USBD_DETACH_PIN) || defined(USBD_ATTACH_PIN)) && defined(USBD_FIXED_PULLUP)
#error "Cannot define both USBD_FIXED_PULLUP and USBD_ATTACH_PIN or USBD_DETACH_PIN"
#endif /* (defined(USBD_DETACH_PIN) || defined(USBD_ATTACH_PIN)) && defined(USBD_FIXED_PULLUP) */
/* Either of these bits indicate that there are internal pullups */
#if defined(USB_BCDR_DPPU) || defined(USB_OTG_DCTL_SDIS) || defined(SYSCFG_PMC_USB_PU)
#define USBD_HAVE_INTERNAL_PULLUPS
#endif /* defined(USB_BCDR_DPPU) || defined(USB_OTG_DCTL_SDIS) */
/* Figure out which USB instance is used. This mirrors the decision made
* in USBD_LL_Init in usbd_conf.c. */
#if defined(USE_USB_HS)
#define USBD_USB_INSTANCE USB_OTG_HS
#define USBD_DP_PINNAME USB_OTG_HS_DP
#elif defined(USB_OTG_FS)
#define USBD_USB_INSTANCE USB_OTG_FS
#define USBD_DP_PINNAME USB_OTG_FS_DP
#elif defined(USB)
#define USBD_USB_INSTANCE USB
#define USBD_DP_PINNAME USB_DP
#endif
/*
* Translate pin number to a pin name (using the same define for both
* attach and detach pins) and also define the complementary level. This
* allows using the same code for the default-enabled and
* default-disabled case as well as for the D+ trick (which does not
* know the pin number, only the pin name).
*/
#if defined(USBD_ATTACH_PIN)
#define USBD_PULLUP_CONTROL_PINNAME digitalPinToPinName(USBD_ATTACH_PIN)
#define USBD_DETACH_LEVEL !(USBD_ATTACH_LEVEL)
#elif defined(USBD_DETACH_PIN)
#define USBD_PULLUP_CONTROL_PINNAME digitalPinToPinName(USBD_DETACH_PIN)
#define USBD_ATTACH_LEVEL !(USBD_DETACH_LEVEL)
#elif !defined(USBD_HAVE_INTERNAL_PULLUPS) || defined(USBD_FIXED_PULLUP)
/* When no USB attach and detach pins were defined, and there are also
* no internal pullups, assume there is a fixed external pullup and apply
* the D+ trick. Also do this when there are internal *and* external
* pulups (which is a hardware bug, but there are boards out there with
* this). */
#define USBD_PULLUP_CONTROL_PINNAME USBD_DP_PINNAME
#define USBD_DETACH_LEVEL LOW
// USBD_ATTACH_LEVEL not needed.
#define USBD_DP_TRICK
#endif
/**
* @brief Force to re-enumerate USB.
*
* This is intended to be called at startup by core code. It could be
* used at runtime, while USB is connected, to force re-enumeration
* too, but that does not work in all cases (when USB is enabled on an
* F103C8, setting output mode on the DP pin no longer has any effect).
*
* @param None
* @retval None
*/
WEAK void USBD_reenumerate(void)
{
#if defined(USBD_PULLUP_CONTROL_PINNAME)
/* Detach */
pin_function(USBD_PULLUP_CONTROL_PINNAME, STM_PIN_DATA(STM_MODE_OUTPUT_PP, GPIO_NOPULL, 0));
digitalWriteFast(USBD_PULLUP_CONTROL_PINNAME, USBD_DETACH_LEVEL);
/* Wait */
delay(USBD_ENUM_DELAY);
/* Attach */
#if defined(USBD_DP_TRICK)
/* Revert back to input (floating), needed for the D+ trick */
pin_function(USBD_PULLUP_CONTROL_PINNAME, STM_PIN_DATA(STM_MODE_INPUT, GPIO_NOPULL, 0));
#else
digitalWriteFast(USBD_PULLUP_CONTROL_PINNAME, USBD_ATTACH_LEVEL);
#endif /* defined(USBD_PULLUP_CONTROL_FLOATING) */
#elif defined(USBD_HAVE_INTERNAL_PULLUPS)
#if defined(SYSCFG_PMC_USB_PU)
/**
* STM32L1xx USB_DevDisconnect() and USB_DevConnect()
* do not manage the internal pull-up, so manage
* internal pull-up manually.
*/
LL_SYSCFG_DisableUSBPullUp();
delay(USBD_ENUM_DELAY);
LL_SYSCFG_EnableUSBPullUp();
#else
USB_DevDisconnect(USBD_USB_INSTANCE);
delay(USBD_ENUM_DELAY);
USB_DevConnect(USBD_USB_INSTANCE);
#endif
#else
#warning "No USB attach/detach method, USB might not be reliable through system resets"
#endif
}
#else /* !defined(USBD_REENUM_DISABLED) */
WEAK void USBD_reenumerate(void) { }
#endif
#ifdef USBD_USE_CDC
void USBD_CDC_init(void)
{
CDC_init();
}
#endif /* USBD_USE_CDC */
/**
* @brief Configures system clock and system IP clocks after wake-up from USB
* resume callBack
* @note Weaked function which can be redefined by user at the sketch level.
* By default, calls 'SystemClock_Config()'.
* @param None
* @retval None
*/
WEAK void USBD_SystemClockConfigFromResume(void)
{
configIPClock();
SystemClock_Config();
}
#endif /* USBCON */