HAL
Select one of the symbols to view example projects that use it.
 
Outline
#define STM32F4xx_LL_USB_H
#include "stm32f4xx_hal_def.h"
Exported types
#define HAL_USB_TIMEOUT
#define HAL_USB_CURRENT_MODE_MAX_DELAY_MS
USB_ModeTypeDef
USB_URBStateTypeDef
USB_HCStateTypeDef
USB_CfgTypeDef
USB_EPTypeDef
USB_HCTypeDef
USB_OTG_ModeTypeDef
USB_OTG_CfgTypeDef
USB_OTG_EPTypeDef
USB_OTG_URBStateTypeDef
USB_OTG_HCStateTypeDef
USB_OTG_HCTypeDef
Exported constants
#define USB_OTG_CORE_ID_300A
#define USB_OTG_CORE_ID_310A
#define USB_OTG_MODE_DEVICE
#define USB_OTG_MODE_HOST
#define USB_OTG_MODE_DRD
#define USB_OTG_SPEED_HIGH
#define USB_OTG_SPEED_HIGH_IN_FULL
#define USB_OTG_SPEED_FULL
#define USB_OTG_ULPI_PHY
#define USB_OTG_EMBEDDED_PHY
#define USBD_HS_TRDT_VALUE
#define USBD_FS_TRDT_VALUE
#define USBD_DEFAULT_TRDT_VALUE
#define USB_OTG_HS_MAX_PACKET_SIZE
#define USB_OTG_FS_MAX_PACKET_SIZE
#define USB_OTG_MAX_EP0_SIZE
#define DSTS_ENUMSPD_HS_PHY_30MHZ_OR_60MHZ
#define DSTS_ENUMSPD_FS_PHY_30MHZ_OR_60MHZ
#define DSTS_ENUMSPD_FS_PHY_48MHZ
#define DCFG_FRAME_INTERVAL_80
#define DCFG_FRAME_INTERVAL_85
#define DCFG_FRAME_INTERVAL_90
#define DCFG_FRAME_INTERVAL_95
#define EP_MPS_64
#define EP_MPS_32
#define EP_MPS_16
#define EP_MPS_8
#define EP_TYPE_CTRL
#define EP_TYPE_ISOC
#define EP_TYPE_BULK
#define EP_TYPE_INTR
#define EP_TYPE_MSK
#define EP_SPEED_LOW
#define EP_SPEED_FULL
#define EP_SPEED_HIGH
#define HC_PID_DATA0
#define HC_PID_DATA2
#define HC_PID_DATA1
#define HC_PID_SETUP
#define USBD_HS_SPEED
#define USBD_HSINFS_SPEED
#define USBH_HS_SPEED
#define USBD_FS_SPEED
#define USBH_FSLS_SPEED
#define STS_GOUT_NAK
#define STS_DATA_UPDT
#define STS_XFER_COMP
#define STS_SETUP_COMP
#define STS_SETUP_UPDT
#define HCFG_30_60_MHZ
#define HCFG_48_MHZ
#define HCFG_6_MHZ
#define HFIR_6_MHZ
#define HFIR_60_MHZ
#define HFIR_48_MHZ
#define HPRT0_PRTSPD_HIGH_SPEED
#define HPRT0_PRTSPD_FULL_SPEED
#define HPRT0_PRTSPD_LOW_SPEED
#define HCCHAR_CTRL
#define HCCHAR_ISOC
#define HCCHAR_BULK
#define HCCHAR_INTR
#define GRXSTS_PKTSTS_IN
#define GRXSTS_PKTSTS_IN_XFER_COMP
#define GRXSTS_PKTSTS_DATA_TOGGLE_ERR
#define GRXSTS_PKTSTS_CH_HALTED
#define CLEAR_INTERRUPT_MASK
#define HC_MAX_PKT_CNT
#define ISO_SPLT_MPS
#define HCSPLT_BEGIN
#define HCSPLT_MIDDLE
#define HCSPLT_END
#define HCSPLT_FULL
#define TEST_J
#define TEST_K
#define TEST_SE0_NAK
#define TEST_PACKET
#define TEST_FORCE_EN
#define USBx_PCGCCTL
#define USBx_HPRT0
#define USBx_DEVICE
#define USBx_DFIFO
#define USBx_HOST
#define EP_ADDR_MSK
Exported macro
#define USB_MASK_INTERRUPT
#define USB_UNMASK_INTERRUPT
#define CLEAR_IN_EP_INTR
#define CLEAR_OUT_EP_INTR
USB_CoreInit(USB_OTG_GlobalTypeDef *, USB_OTG_CfgTypeDef);
USB_DevInit(USB_OTG_GlobalTypeDef *, USB_OTG_CfgTypeDef);
USB_EnableGlobalInt(USB_OTG_GlobalTypeDef *);
USB_DisableGlobalInt(USB_OTG_GlobalTypeDef *);
USB_SetTurnaroundTime(USB_OTG_GlobalTypeDef *, uint32_t, uint8_t);
USB_SetCurrentMode(USB_OTG_GlobalTypeDef *, USB_OTG_ModeTypeDef);
USB_SetDevSpeed(const USB_OTG_GlobalTypeDef *, uint8_t);
USB_FlushRxFifo(USB_OTG_GlobalTypeDef *);
USB_FlushTxFifo(USB_OTG_GlobalTypeDef *, uint32_t);
USB_ActivateEndpoint(const USB_OTG_GlobalTypeDef *, const USB_OTG_EPTypeDef *);
USB_DeactivateEndpoint(const USB_OTG_GlobalTypeDef *, const USB_OTG_EPTypeDef *);
USB_ActivateDedicatedEndpoint(const USB_OTG_GlobalTypeDef *, const USB_OTG_EPTypeDef *);
USB_DeactivateDedicatedEndpoint(const USB_OTG_GlobalTypeDef *, const USB_OTG_EPTypeDef *);
USB_EPStartXfer(USB_OTG_GlobalTypeDef *, USB_OTG_EPTypeDef *, uint8_t);
USB_WritePacket(const USB_OTG_GlobalTypeDef *, uint8_t *, uint8_t, uint16_t, uint8_t);
USB_ReadPacket(const USB_OTG_GlobalTypeDef *, uint8_t *, uint16_t);
USB_EPSetStall(const USB_OTG_GlobalTypeDef *, const USB_OTG_EPTypeDef *);
USB_EPClearStall(const USB_OTG_GlobalTypeDef *, const USB_OTG_EPTypeDef *);
USB_EPStopXfer(const USB_OTG_GlobalTypeDef *, USB_OTG_EPTypeDef *);
USB_SetDevAddress(const USB_OTG_GlobalTypeDef *, uint8_t);
USB_DevConnect(const USB_OTG_GlobalTypeDef *);
USB_DevDisconnect(const USB_OTG_GlobalTypeDef *);
USB_StopDevice(USB_OTG_GlobalTypeDef *);
USB_ActivateSetup(const USB_OTG_GlobalTypeDef *);
USB_EP0_OutStart(const USB_OTG_GlobalTypeDef *, uint8_t, const uint8_t *);
USB_GetDevSpeed(const USB_OTG_GlobalTypeDef *);
USB_GetMode(const USB_OTG_GlobalTypeDef *);
USB_ReadInterrupts(const USB_OTG_GlobalTypeDef *);
USB_ReadChInterrupts(const USB_OTG_GlobalTypeDef *, uint8_t);
USB_ReadDevAllOutEpInterrupt(const USB_OTG_GlobalTypeDef *);
USB_ReadDevOutEPInterrupt(const USB_OTG_GlobalTypeDef *, uint8_t);
USB_ReadDevAllInEpInterrupt(const USB_OTG_GlobalTypeDef *);
USB_ReadDevInEPInterrupt(const USB_OTG_GlobalTypeDef *, uint8_t);
USB_ClearInterrupts(USB_OTG_GlobalTypeDef *, uint32_t);
USB_HostInit(USB_OTG_GlobalTypeDef *, USB_OTG_CfgTypeDef);
USB_InitFSLSPClkSel(const USB_OTG_GlobalTypeDef *, uint8_t);
USB_ResetPort(const USB_OTG_GlobalTypeDef *);
USB_DriveVbus(const USB_OTG_GlobalTypeDef *, uint8_t);
USB_GetHostSpeed(const USB_OTG_GlobalTypeDef *);
USB_GetCurrentFrame(const USB_OTG_GlobalTypeDef *);
USB_HC_Init(USB_OTG_GlobalTypeDef *, uint8_t, uint8_t, uint8_t, uint8_t, uint8_t, uint16_t);
USB_HC_StartXfer(USB_OTG_GlobalTypeDef *, USB_OTG_HCTypeDef *, uint8_t);
USB_HC_ReadInterrupt(const USB_OTG_GlobalTypeDef *);
USB_HC_Halt(const USB_OTG_GlobalTypeDef *, uint8_t);
USB_DoPing(const USB_OTG_GlobalTypeDef *, uint8_t);
USB_StopHost(USB_OTG_GlobalTypeDef *);
USB_ActivateRemoteWakeup(const USB_OTG_GlobalTypeDef *);
USB_DeActivateRemoteWakeup(const USB_OTG_GlobalTypeDef *);
Files
loading...
SourceVuSTM32 Libraries and SamplesHALInc/stm32f4xx_ll_usb.h
 
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
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
/** ****************************************************************************** * @file stm32f4xx_ll_usb.h * @author MCD Application Team * @brief Header file of USB Low Layer HAL module. ****************************************************************************** * @attention * * Copyright (c) 2016 STMicroelectronics. * All rights reserved. * * This software is licensed under terms that can be found in the LICENSE file * in the root directory of this software component. * If no LICENSE file comes with this software, it is provided AS-IS. * ****************************************************************************** *//* ... */ /* Define to prevent recursive inclusion -------------------------------------*/ #ifndef STM32F4xx_LL_USB_H #define STM32F4xx_LL_USB_H #ifdef __cplusplus extern "C" { #endif /* __cplusplus */ /* Includes ------------------------------------------------------------------*/ #include "stm32f4xx_hal_def.h" #if defined (USB_OTG_FS) || defined (USB_OTG_HS) /** @addtogroup STM32F4xx_HAL_Driver * @{ *//* ... */ /** @addtogroup USB_LL * @{ *//* ... */ /* Exported types ------------------------------------------------------------*/ #ifndef HAL_USB_TIMEOUT #define HAL_USB_TIMEOUT 0xF000000U #endif /* define HAL_USB_TIMEOUT */ #ifndef HAL_USB_CURRENT_MODE_MAX_DELAY_MS #define HAL_USB_CURRENT_MODE_MAX_DELAY_MS 200U #endif /* define HAL_USB_CURRENT_MODE_MAX_DELAY_MS */ /** * @brief USB Mode definition *//* ... */ typedef enum { USB_DEVICE_MODE = 0, USB_HOST_MODE = 1, USB_DRD_MODE = 2 ...} USB_ModeTypeDef; /** * @brief URB States definition *//* ... */ typedef enum { URB_IDLE = 0, URB_DONE, URB_NOTREADY, URB_NYET, URB_ERROR, URB_STALL ...} USB_URBStateTypeDef; /** * @brief Host channel States definition *//* ... */ typedef enum { HC_IDLE = 0, HC_XFRC, HC_HALTED, HC_ACK, HC_NAK, HC_NYET, HC_STALL, HC_XACTERR, HC_BBLERR, HC_DATATGLERR ...} USB_HCStateTypeDef; /** * @brief USB Instance Initialization Structure definition *//* ... */ typedef struct { uint8_t dev_endpoints; /*!< Device Endpoints number. This parameter depends on the used USB core. This parameter must be a number between Min_Data = 1 and Max_Data = 15 *//* ... */ uint8_t Host_channels; /*!< Host Channels number. This parameter Depends on the used USB core. This parameter must be a number between Min_Data = 1 and Max_Data = 15 *//* ... */ uint8_t dma_enable; /*!< USB DMA state. If DMA is not supported this parameter shall be set by default to zero *//* ... */ uint8_t speed; /*!< USB Core speed. This parameter can be any value of @ref PCD_Speed/HCD_Speed (HCD_SPEED_xxx, HCD_SPEED_xxx) *//* ... */ uint8_t ep0_mps; /*!< Set the Endpoint 0 Max Packet size. */ uint8_t phy_itface; /*!< Select the used PHY interface. This parameter can be any value of @ref PCD_PHY_Module/HCD_PHY_Module *//* ... */ uint8_t Sof_enable; /*!< Enable or disable the output of the SOF signal. */ uint8_t low_power_enable; /*!< Enable or disable the low Power Mode. */ uint8_t lpm_enable; /*!< Enable or disable Link Power Management. */ uint8_t battery_charging_enable; /*!< Enable or disable Battery charging. */ uint8_t vbus_sensing_enable; /*!< Enable or disable the VBUS Sensing feature. */ uint8_t use_dedicated_ep1; /*!< Enable or disable the use of the dedicated EP1 interrupt. */ uint8_t use_external_vbus; /*!< Enable or disable the use of the external VBUS. */ ...} USB_CfgTypeDef; typedef struct { uint8_t num; /*!< Endpoint number This parameter must be a number between Min_Data = 1 and Max_Data = 15 *//* ... */ uint8_t is_in; /*!< Endpoint direction This parameter must be a number between Min_Data = 0 and Max_Data = 1 *//* ... */ uint8_t is_stall; /*!< Endpoint stall condition This parameter must be a number between Min_Data = 0 and Max_Data = 1 *//* ... */ uint8_t is_iso_incomplete; /*!< Endpoint isoc condition This parameter must be a number between Min_Data = 0 and Max_Data = 1 *//* ... */ uint8_t type; /*!< Endpoint type This parameter can be any value of @ref USB_LL_EP_Type *//* ... */ uint8_t data_pid_start; /*!< Initial data PID This parameter must be a number between Min_Data = 0 and Max_Data = 1 *//* ... */ uint32_t maxpacket; /*!< Endpoint Max packet size This parameter must be a number between Min_Data = 0 and Max_Data = 64KB *//* ... */ uint8_t *xfer_buff; /*!< Pointer to transfer buffer */ uint32_t xfer_len; /*!< Current transfer length */ uint32_t xfer_count; /*!< Partial transfer length in case of multi packet transfer */ uint8_t even_odd_frame; /*!< IFrame parity This parameter must be a number between Min_Data = 0 and Max_Data = 1 *//* ... */ uint16_t tx_fifo_num; /*!< Transmission FIFO number This parameter must be a number between Min_Data = 1 and Max_Data = 15 *//* ... */ uint32_t dma_addr; /*!< 32 bits aligned transfer buffer address */ uint32_t xfer_size; /*!< requested transfer size */ ...} USB_EPTypeDef; typedef struct { uint8_t dev_addr; /*!< USB device address. This parameter must be a number between Min_Data = 1 and Max_Data = 255 *//* ... */ uint8_t ch_num; /*!< Host channel number. This parameter must be a number between Min_Data = 1 and Max_Data = 15 *//* ... */ uint8_t ep_num; /*!< Endpoint number. This parameter must be a number between Min_Data = 1 and Max_Data = 15 *//* ... */ uint8_t ep_is_in; /*!< Endpoint direction This parameter must be a number between Min_Data = 0 and Max_Data = 1 *//* ... */ uint8_t speed; /*!< USB Host Channel speed. This parameter can be any value of @ref HCD_Device_Speed: (HCD_DEVICE_SPEED_xxx) *//* ... */ uint8_t do_ping; /*!< Enable or disable the use of the PING protocol for HS mode. */ uint8_t do_ssplit; /*!< Enable start split transaction in HS mode. */ uint8_t do_csplit; /*!< Enable complete split transaction in HS mode. */ uint8_t ep_ss_schedule; /*!< Enable periodic endpoint start split schedule . */ uint32_t iso_splt_xactPos; /*!< iso split transfer transaction position. */ uint8_t hub_port_nbr; /*!< USB HUB port number */ uint8_t hub_addr; /*!< USB HUB address */ uint8_t ep_type; /*!< Endpoint Type. This parameter can be any value of @ref USB_LL_EP_Type *//* ... */ uint16_t max_packet; /*!< Endpoint Max packet size. This parameter must be a number between Min_Data = 0 and Max_Data = 64KB *//* ... */ uint8_t data_pid; /*!< Initial data PID. This parameter must be a number between Min_Data = 0 and Max_Data = 1 *//* ... */ uint8_t *xfer_buff; /*!< Pointer to transfer buffer. */ uint32_t XferSize; /*!< OTG Channel transfer size. */ uint32_t xfer_len; /*!< Current transfer length. */ uint32_t xfer_count; /*!< Partial transfer length in case of multi packet transfer. */ uint8_t toggle_in; /*!< IN transfer current toggle flag. This parameter must be a number between Min_Data = 0 and Max_Data = 1 *//* ... */ uint8_t toggle_out; /*!< OUT transfer current toggle flag This parameter must be a number between Min_Data = 0 and Max_Data = 1 *//* ... */ uint32_t dma_addr; /*!< 32 bits aligned transfer buffer address. */ uint32_t ErrCnt; /*!< Host channel error count. */ uint32_t NyetErrCnt; /*!< Complete Split NYET Host channel error count. */ USB_URBStateTypeDef urb_state; /*!< URB state. This parameter can be any value of @ref USB_URBStateTypeDef *//* ... */ USB_HCStateTypeDef state; /*!< Host Channel state. This parameter can be any value of @ref USB_HCStateTypeDef *//* ... */ ...} USB_HCTypeDef; typedef USB_ModeTypeDef USB_OTG_ModeTypeDef; typedef USB_CfgTypeDef USB_OTG_CfgTypeDef; typedef USB_EPTypeDef USB_OTG_EPTypeDef; typedef USB_URBStateTypeDef USB_OTG_URBStateTypeDef; typedef USB_HCStateTypeDef USB_OTG_HCStateTypeDef; typedef USB_HCTypeDef USB_OTG_HCTypeDef; Exported types /* Exported constants --------------------------------------------------------*/ /** @defgroup PCD_Exported_Constants PCD Exported Constants * @{ *//* ... */ #if defined (USB_OTG_FS) || defined (USB_OTG_HS) /** @defgroup USB_OTG_CORE VERSION ID * @{ *//* ... */ #define USB_OTG_CORE_ID_300A 0x4F54300AU #define USB_OTG_CORE_ID_310A 0x4F54310AU /** * @} *//* ... */ /** @defgroup USB_Core_Mode_ USB Core Mode * @{ *//* ... */ #define USB_OTG_MODE_DEVICE 0U #define USB_OTG_MODE_HOST 1U #define USB_OTG_MODE_DRD 2U /** * @} *//* ... */ /** @defgroup USB_LL_Core_Speed USB Low Layer Core Speed * @{ *//* ... */ #define USB_OTG_SPEED_HIGH 0U #define USB_OTG_SPEED_HIGH_IN_FULL 1U #define USB_OTG_SPEED_FULL 3U /** * @} *//* ... */ /** @defgroup USB_LL_Core_PHY USB Low Layer Core PHY * @{ *//* ... */ #define USB_OTG_ULPI_PHY 1U #define USB_OTG_EMBEDDED_PHY 2U 10 defines/** * @} *//* ... */ /** @defgroup USB_LL_Turnaround_Timeout Turnaround Timeout Value * @{ *//* ... */ #ifndef USBD_HS_TRDT_VALUE #define USBD_HS_TRDT_VALUE 9U #endif /* USBD_HS_TRDT_VALUE */ #ifndef USBD_FS_TRDT_VALUE #define USBD_FS_TRDT_VALUE 5U #define USBD_DEFAULT_TRDT_VALUE 9U /* ... */#endif /* USBD_HS_TRDT_VALUE */ /** * @} *//* ... */ /** @defgroup USB_LL_Core_MPS USB Low Layer Core MPS * @{ *//* ... */ #define USB_OTG_HS_MAX_PACKET_SIZE 512U #define USB_OTG_FS_MAX_PACKET_SIZE 64U #define USB_OTG_MAX_EP0_SIZE 64U /** * @} *//* ... */ /** @defgroup USB_LL_Core_PHY_Frequency USB Low Layer Core PHY Frequency * @{ *//* ... */ #define DSTS_ENUMSPD_HS_PHY_30MHZ_OR_60MHZ (0U << 1) #define DSTS_ENUMSPD_FS_PHY_30MHZ_OR_60MHZ (1U << 1) #define DSTS_ENUMSPD_FS_PHY_48MHZ (3U << 1) /** * @} *//* ... */ /** @defgroup USB_LL_CORE_Frame_Interval USB Low Layer Core Frame Interval * @{ *//* ... */ #define DCFG_FRAME_INTERVAL_80 0U #define DCFG_FRAME_INTERVAL_85 1U #define DCFG_FRAME_INTERVAL_90 2U #define DCFG_FRAME_INTERVAL_95 3U 10 defines/** * @} *//* ... */ /* ... */#endif /* defined (USB_OTG_FS) || defined (USB_OTG_HS) */ /** @defgroup USB_LL_EP0_MPS USB Low Layer EP0 MPS * @{ *//* ... */ #define EP_MPS_64 0U #define EP_MPS_32 1U #define EP_MPS_16 2U #define EP_MPS_8 3U /** * @} *//* ... */ /** @defgroup USB_LL_EP_Type USB Low Layer EP Type * @{ *//* ... */ #define EP_TYPE_CTRL 0U #define EP_TYPE_ISOC 1U #define EP_TYPE_BULK 2U #define EP_TYPE_INTR 3U #define EP_TYPE_MSK 3U /** * @} *//* ... */ /** @defgroup USB_LL_EP_Speed USB Low Layer EP Speed * @{ *//* ... */ #define EP_SPEED_LOW 0U #define EP_SPEED_FULL 1U #define EP_SPEED_HIGH 2U /** * @} *//* ... */ /** @defgroup USB_LL_CH_PID_Type USB Low Layer Channel PID Type * @{ *//* ... */ #define HC_PID_DATA0 0U #define HC_PID_DATA2 1U #define HC_PID_DATA1 2U #define HC_PID_SETUP 3U /** * @} *//* ... */ /** @defgroup USB_LL Device Speed * @{ *//* ... */ #define USBD_HS_SPEED 0U #define USBD_HSINFS_SPEED 1U #define USBH_HS_SPEED 0U #define USBD_FS_SPEED 2U #define USBH_FSLS_SPEED 1U 21 defines/** * @} *//* ... */ #if defined (USB_OTG_FS) || defined (USB_OTG_HS) /** @defgroup USB_LL_STS_Defines USB Low Layer STS Defines * @{ *//* ... */ #define STS_GOUT_NAK 1U #define STS_DATA_UPDT 2U #define STS_XFER_COMP 3U #define STS_SETUP_COMP 4U #define STS_SETUP_UPDT 6U /** * @} *//* ... */ /** @defgroup USB_LL_HCFG_SPEED_Defines USB Low Layer HCFG Speed Defines * @{ *//* ... */ #define HCFG_30_60_MHZ 0U #define HCFG_48_MHZ 1U #define HCFG_6_MHZ 2U /** * @} *//* ... */ /** @defgroup USB_LL_HFIR_Defines USB Low Layer frame interval Defines * @{ *//* ... */ #define HFIR_6_MHZ 6000U #define HFIR_60_MHZ 60000U #define HFIR_48_MHZ 48000U /** * @} *//* ... */ /** @defgroup USB_LL_HPRT0_PRTSPD_SPEED_Defines USB Low Layer HPRT0 PRTSPD Speed Defines * @{ *//* ... */ #define HPRT0_PRTSPD_HIGH_SPEED 0U #define HPRT0_PRTSPD_FULL_SPEED 1U #define HPRT0_PRTSPD_LOW_SPEED 2U /** * @} *//* ... */ #define HCCHAR_CTRL 0U #define HCCHAR_ISOC 1U #define HCCHAR_BULK 2U #define HCCHAR_INTR 3U #define GRXSTS_PKTSTS_IN 2U #define GRXSTS_PKTSTS_IN_XFER_COMP 3U #define GRXSTS_PKTSTS_DATA_TOGGLE_ERR 5U #define GRXSTS_PKTSTS_CH_HALTED 7U #define CLEAR_INTERRUPT_MASK 0xFFFFFFFFU #define HC_MAX_PKT_CNT 256U #define ISO_SPLT_MPS 188U #define HCSPLT_BEGIN 1U #define HCSPLT_MIDDLE 2U #define HCSPLT_END 3U #define HCSPLT_FULL 4U #define TEST_J 1U #define TEST_K 2U #define TEST_SE0_NAK 3U #define TEST_PACKET 4U #define TEST_FORCE_EN 5U #define USBx_PCGCCTL *(__IO uint32_t *)((uint32_t)USBx_BASE + USB_OTG_PCGCCTL_BASE) #define USBx_HPRT0 *(__IO uint32_t *)((uint32_t)USBx_BASE + USB_OTG_HOST_PORT_BASE) #define USBx_DEVICE ((USB_OTG_DeviceTypeDef *)(USBx_BASE + USB_OTG_DEVICE_BASE)) #define USBx_INEP(i) ((USB_OTG_INEndpointTypeDef *)(USBx_BASE\ + USB_OTG_IN_ENDPOINT_BASE + ((i) * USB_OTG_EP_REG_SIZE)))... #define USBx_OUTEP(i) ((USB_OTG_OUTEndpointTypeDef *)(USBx_BASE\ + USB_OTG_OUT_ENDPOINT_BASE + ((i) * USB_OTG_EP_REG_SIZE)))... #define USBx_DFIFO(i) *(__IO uint32_t *)(USBx_BASE + USB_OTG_FIFO_BASE + ((i) * USB_OTG_FIFO_SIZE)) #define USBx_HOST ((USB_OTG_HostTypeDef *)(USBx_BASE + USB_OTG_HOST_BASE)) #define USBx_HC(i) ((USB_OTG_HostChannelTypeDef *)(USBx_BASE\ + USB_OTG_HOST_CHANNEL_BASE\ + ((i) * USB_OTG_HOST_CHANNEL_SIZE)))... #define EP_ADDR_MSK 0xFU 43 defines#endif/* ... */ /* defined (USB_OTG_FS) || defined (USB_OTG_HS) */ /** * @} *//* ... */ Exported constants /* Exported macro ------------------------------------------------------------*/ /** @defgroup USB_LL_Exported_Macros USB Low Layer Exported Macros * @{ *//* ... */ #if defined (USB_OTG_FS) || defined (USB_OTG_HS) #define USB_MASK_INTERRUPT(__INSTANCE__, __INTERRUPT__) ((__INSTANCE__)->GINTMSK &= ~(__INTERRUPT__)) #define USB_UNMASK_INTERRUPT(__INSTANCE__, __INTERRUPT__) ((__INSTANCE__)->GINTMSK |= (__INTERRUPT__)) #define CLEAR_IN_EP_INTR(__EPNUM__, __INTERRUPT__) (USBx_INEP(__EPNUM__)->DIEPINT = (__INTERRUPT__)) #define CLEAR_OUT_EP_INTR(__EPNUM__, __INTERRUPT__) (USBx_OUTEP(__EPNUM__)->DOEPINT = (__INTERRUPT__)) /* ... */#endif /* defined (USB_OTG_FS) || defined (USB_OTG_HS) */ /** * @} *//* ... */ Exported macro /* Exported functions --------------------------------------------------------*/ /** @addtogroup USB_LL_Exported_Functions USB Low Layer Exported Functions * @{ *//* ... */ #if defined (USB_OTG_FS) || defined (USB_OTG_HS) HAL_StatusTypeDef USB_CoreInit(USB_OTG_GlobalTypeDef *USBx, USB_OTG_CfgTypeDef cfg); HAL_StatusTypeDef USB_DevInit(USB_OTG_GlobalTypeDef *USBx, USB_OTG_CfgTypeDef cfg); HAL_StatusTypeDef USB_EnableGlobalInt(USB_OTG_GlobalTypeDef *USBx); HAL_StatusTypeDef USB_DisableGlobalInt(USB_OTG_GlobalTypeDef *USBx); HAL_StatusTypeDef USB_SetTurnaroundTime(USB_OTG_GlobalTypeDef *USBx, uint32_t hclk, uint8_t speed); HAL_StatusTypeDef USB_SetCurrentMode(USB_OTG_GlobalTypeDef *USBx, USB_OTG_ModeTypeDef mode); HAL_StatusTypeDef USB_SetDevSpeed(const USB_OTG_GlobalTypeDef *USBx, uint8_t speed); HAL_StatusTypeDef USB_FlushRxFifo(USB_OTG_GlobalTypeDef *USBx); HAL_StatusTypeDef USB_FlushTxFifo(USB_OTG_GlobalTypeDef *USBx, uint32_t num); HAL_StatusTypeDef USB_ActivateEndpoint(const USB_OTG_GlobalTypeDef *USBx, const USB_OTG_EPTypeDef *ep); HAL_StatusTypeDef USB_DeactivateEndpoint(const USB_OTG_GlobalTypeDef *USBx, const USB_OTG_EPTypeDef *ep); HAL_StatusTypeDef USB_ActivateDedicatedEndpoint(const USB_OTG_GlobalTypeDef *USBx, const USB_OTG_EPTypeDef *ep); HAL_StatusTypeDef USB_DeactivateDedicatedEndpoint(const USB_OTG_GlobalTypeDef *USBx, const USB_OTG_EPTypeDef *ep); HAL_StatusTypeDef USB_EPStartXfer(USB_OTG_GlobalTypeDef *USBx, USB_OTG_EPTypeDef *ep, uint8_t dma); HAL_StatusTypeDef USB_WritePacket(const USB_OTG_GlobalTypeDef *USBx, uint8_t *src, uint8_t ch_ep_num, uint16_t len, uint8_t dma); void *USB_ReadPacket(const USB_OTG_GlobalTypeDef *USBx, uint8_t *dest, uint16_t len); HAL_StatusTypeDef USB_EPSetStall(const USB_OTG_GlobalTypeDef *USBx, const USB_OTG_EPTypeDef *ep); HAL_StatusTypeDef USB_EPClearStall(const USB_OTG_GlobalTypeDef *USBx, const USB_OTG_EPTypeDef *ep); HAL_StatusTypeDef USB_EPStopXfer(const USB_OTG_GlobalTypeDef *USBx, USB_OTG_EPTypeDef *ep); HAL_StatusTypeDef USB_SetDevAddress(const USB_OTG_GlobalTypeDef *USBx, uint8_t address); HAL_StatusTypeDef USB_DevConnect(const USB_OTG_GlobalTypeDef *USBx); HAL_StatusTypeDef USB_DevDisconnect(const USB_OTG_GlobalTypeDef *USBx); HAL_StatusTypeDef USB_StopDevice(USB_OTG_GlobalTypeDef *USBx); HAL_StatusTypeDef USB_ActivateSetup(const USB_OTG_GlobalTypeDef *USBx); HAL_StatusTypeDef USB_EP0_OutStart(const USB_OTG_GlobalTypeDef *USBx, uint8_t dma, const uint8_t *psetup); uint8_t USB_GetDevSpeed(const USB_OTG_GlobalTypeDef *USBx); uint32_t USB_GetMode(const USB_OTG_GlobalTypeDef *USBx); uint32_t USB_ReadInterrupts(USB_OTG_GlobalTypeDef const *USBx); uint32_t USB_ReadChInterrupts(const USB_OTG_GlobalTypeDef *USBx, uint8_t chnum); uint32_t USB_ReadDevAllOutEpInterrupt(const USB_OTG_GlobalTypeDef *USBx); uint32_t USB_ReadDevOutEPInterrupt(const USB_OTG_GlobalTypeDef *USBx, uint8_t epnum); uint32_t USB_ReadDevAllInEpInterrupt(const USB_OTG_GlobalTypeDef *USBx); uint32_t USB_ReadDevInEPInterrupt(const USB_OTG_GlobalTypeDef *USBx, uint8_t epnum); void USB_ClearInterrupts(USB_OTG_GlobalTypeDef *USBx, uint32_t interrupt); HAL_StatusTypeDef USB_HostInit(USB_OTG_GlobalTypeDef *USBx, USB_OTG_CfgTypeDef cfg); HAL_StatusTypeDef USB_InitFSLSPClkSel(const USB_OTG_GlobalTypeDef *USBx, uint8_t freq); HAL_StatusTypeDef USB_ResetPort(const USB_OTG_GlobalTypeDef *USBx); HAL_StatusTypeDef USB_DriveVbus(const USB_OTG_GlobalTypeDef *USBx, uint8_t state); uint32_t USB_GetHostSpeed(USB_OTG_GlobalTypeDef const *USBx); uint32_t USB_GetCurrentFrame(USB_OTG_GlobalTypeDef const *USBx); HAL_StatusTypeDef USB_HC_Init(USB_OTG_GlobalTypeDef *USBx, uint8_t ch_num, uint8_t epnum, uint8_t dev_address, uint8_t speed, uint8_t ep_type, uint16_t mps); HAL_StatusTypeDef USB_HC_StartXfer(USB_OTG_GlobalTypeDef *USBx, USB_OTG_HCTypeDef *hc, uint8_t dma); uint32_t USB_HC_ReadInterrupt(const USB_OTG_GlobalTypeDef *USBx); HAL_StatusTypeDef USB_HC_Halt(const USB_OTG_GlobalTypeDef *USBx, uint8_t hc_num); HAL_StatusTypeDef USB_DoPing(const USB_OTG_GlobalTypeDef *USBx, uint8_t ch_num); HAL_StatusTypeDef USB_StopHost(USB_OTG_GlobalTypeDef *USBx); HAL_StatusTypeDef USB_ActivateRemoteWakeup(const USB_OTG_GlobalTypeDef *USBx); HAL_StatusTypeDef USB_DeActivateRemoteWakeup(const USB_OTG_GlobalTypeDef *USBx);/* ... */ #endif /* defined (USB_OTG_FS) || defined (USB_OTG_HS) */ /** * @} *//* ... */ /** * @} *//* ... */ /** * @} *//* ... */ /** * @} *//* ... */ /* ... */#endif /* defined (USB_OTG_FS) || defined (USB_OTG_HS) */ #ifdef __cplusplus }extern "C" { ... } #endif /* __cplusplus */ /* ... */ #endif /* STM32F4xx_LL_USB_H */
Details
Show:
from
Types: Columns:
This file uses the notable symbols shown below. Click anywhere in the file to view more details.