Select one of the symbols to view example projects that use it.
 
Outline
Includes
#include "main.h"
Private define
#define APP_RX_DATA_SIZE
#define APP_TX_DATA_SIZE
Private variables
LineCoding
UserRxBuffer
UserTxBuffer
UserTxBufPtrIn
UserTxBufPtrOut
UartHandle
TimHandle
Private function prototypes
USBD_CDC_fops
CDC_Itf_Init()
CDC_Itf_DeInit()
CDC_Itf_Control(uint8_t, uint8_t *, uint16_t)
HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *)
HAL_UART_RxCpltCallback(UART_HandleTypeDef *)
CDC_Itf_Receive(uint8_t *, uint32_t *)
CDC_Itf_TransmitCplt(uint8_t *, uint32_t *, uint8_t)
HAL_UART_TxCpltCallback(UART_HandleTypeDef *)
ComPort_Config()
TIM_Config()
HAL_UART_ErrorCallback(UART_HandleTypeDef *)
Error_Handler()
Files
loading...
CodeScopeSTM32 Libraries and SamplesDualCore_StandaloneSrc/usbd_cdc_interface.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
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
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
/** ****************************************************************************** * @file USB_Device/CDC_Standalone/Src/usbd_cdc_interface.c * @author MCD Application Team * @brief Source file for USBD CDC interface ****************************************************************************** * @attention * * Copyright (c) 2017 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. * ****************************************************************************** *//* ... */ /* Includes ------------------------------------------------------------------ */ #include "main.h" Includes /* Private typedef ----------------------------------------------------------- */ /* Private define ------------------------------------------------------------ */ #define APP_RX_DATA_SIZE 2048 #define APP_TX_DATA_SIZE 2048 Private define /* Private macro ------------------------------------------------------------- */ /* Private variables --------------------------------------------------------- */ USBD_CDC_LineCodingTypeDef LineCoding = { 115200, /* baud rate */ 0x00, /* stop bits-1 */ 0x00, /* parity - none */ 0x08 /* nb. of bits 8 */ ...}; uint8_t UserRxBuffer[APP_RX_DATA_SIZE]; /* Received Data over USB are stored in * this buffer *//* ... */ uint8_t UserTxBuffer[APP_TX_DATA_SIZE]; /* Received Data over UART (CDC * interface) are stored in this buffer *//* ... */ uint32_t UserTxBufPtrIn = 0; /* Increment this pointer or roll it back to * start address when data are received over * USART *//* ... */ uint32_t UserTxBufPtrOut = 0; /* Increment this pointer or roll it back to * start address when data are sent over USB *//* ... */ /* UART handler declaration */ UART_HandleTypeDef UartHandle; /* TIM handler declaration */ TIM_HandleTypeDef TimHandle; /* USB handler declaration */ extern USBD_HandleTypeDef USBD_Device_HS; Private variables /* Private function prototypes ----------------------------------------------- */ static int8_t CDC_Itf_Init(void); static int8_t CDC_Itf_DeInit(void); static int8_t CDC_Itf_Control(uint8_t cmd, uint8_t * pbuf, uint16_t length); static int8_t CDC_Itf_Receive(uint8_t* pbuf, uint32_t *Len); static int8_t CDC_Itf_TransmitCplt(uint8_t *pbuf, uint32_t *Len, uint8_t epnum); static void Error_Handler(void); static void ComPort_Config(void); static void TIM_Config(void); USBD_CDC_ItfTypeDef USBD_CDC_fops = { CDC_Itf_Init, CDC_Itf_DeInit, CDC_Itf_Control, CDC_Itf_Receive, CDC_Itf_TransmitCplt ...}; Private function prototypes /* Private functions --------------------------------------------------------- */ /** * @brief Initializes the CDC media low layer * @param None * @retval Result of the operation: USBD_OK if all operations are OK else USBD_FAIL *//* ... */ static int8_t CDC_Itf_Init(void) { /* ##-1- Configure the UART peripheral ###################################### */ /* Put the USART peripheral in the Asynchronous mode (UART Mode) */ /* USART configured as follow: - Word Length = 8 Bits - Stop Bit = One Stop * bit - Parity = No parity - BaudRate = 115200 baud - Hardware flow control * disabled (RTS and CTS signals) *//* ... */ UartHandle.Instance = USARTx; UartHandle.Init.BaudRate = 115200; UartHandle.Init.WordLength = UART_WORDLENGTH_8B; UartHandle.Init.StopBits = UART_STOPBITS_1; UartHandle.Init.Parity = UART_PARITY_NONE; UartHandle.Init.HwFlowCtl = UART_HWCONTROL_NONE; UartHandle.Init.Mode = UART_MODE_TX_RX; UartHandle.Init.OverSampling = UART_OVERSAMPLING_16; if (HAL_UART_Init(&UartHandle) != HAL_OK) { /* Initialization Error */ Error_Handler(); }if (HAL_UART_Init(&UartHandle) != HAL_OK) { ... } /* ##-2- Put UART peripheral in IT reception process ######################## */ /* Any data received will be stored in "UserTxBuffer" buffer */ if (HAL_UART_Receive_IT(&UartHandle, (uint8_t *)(UserTxBuffer + UserTxBufPtrIn), 1) != HAL_OK) { /* Transfer error in reception process */ Error_Handler(); }if (HAL_UART_Receive_IT(&UartHandle, (uint8_t *)(UserTxBuffer + UserTxBufPtrIn), 1) != HAL_OK) { ... } /* ##-3- Configure the TIM Base generation ################################# */ TIM_Config(); /* ##-4- Start the TIM Base generation in interrupt mode #################### */ /* Start Channel1 */ if (HAL_TIM_Base_Start_IT(&TimHandle) != HAL_OK) { /* Starting Error */ Error_Handler(); }if (HAL_TIM_Base_Start_IT(&TimHandle) != HAL_OK) { ... } /* ##-5- Set Application Buffers ############################################ */ USBD_CDC_SetTxBuffer(&USBD_Device_HS, UserTxBuffer, 0); USBD_CDC_SetRxBuffer(&USBD_Device_HS, UserRxBuffer); return (USBD_OK); }{ ... } /** * @brief CDC_Itf_DeInit * DeInitializes the CDC media low layer * @param None * @retval Result of the operation: USBD_OK if all operations are OK else USBD_FAIL *//* ... */ static int8_t CDC_Itf_DeInit(void) { /* DeInitialize the UART peripheral */ if (HAL_UART_DeInit(&UartHandle) != HAL_OK) { /* Initialization Error */ Error_Handler(); }if (HAL_UART_DeInit(&UartHandle) != HAL_OK) { ... } return (USBD_OK); }{ ... } /** * @brief CDC_Itf_Control * Manage the CDC class requests * @param Cmd: Command code * @param Buf: Buffer containing command data (request parameters) * @param Len: Number of data to be sent (in bytes) * @retval Result of the operation: USBD_OK if all operations are OK else USBD_FAIL *//* ... */ static int8_t CDC_Itf_Control(uint8_t cmd, uint8_t * pbuf, uint16_t length) { switch (cmd) { case CDC_SEND_ENCAPSULATED_COMMAND: /* Add your code here */ break; case CDC_SEND_ENCAPSULATED_COMMAND: case CDC_GET_ENCAPSULATED_RESPONSE: /* Add your code here */ break; case CDC_GET_ENCAPSULATED_RESPONSE: case CDC_SET_COMM_FEATURE: /* Add your code here */ break; case CDC_SET_COMM_FEATURE: case CDC_GET_COMM_FEATURE: /* Add your code here */ break; case CDC_GET_COMM_FEATURE: case CDC_CLEAR_COMM_FEATURE: /* Add your code here */ break; case CDC_CLEAR_COMM_FEATURE: case CDC_SET_LINE_CODING: LineCoding.bitrate = (uint32_t) (pbuf[0] | (pbuf[1] << 8) | (pbuf[2] << 16) | (pbuf[3] << 24)); LineCoding.format = pbuf[4]; LineCoding.paritytype = pbuf[5]; LineCoding.datatype = pbuf[6]; /* Set the new configuration */ ComPort_Config(); break; case CDC_SET_LINE_CODING: case CDC_GET_LINE_CODING: pbuf[0] = (uint8_t) (LineCoding.bitrate); pbuf[1] = (uint8_t) (LineCoding.bitrate >> 8); pbuf[2] = (uint8_t) (LineCoding.bitrate >> 16); pbuf[3] = (uint8_t) (LineCoding.bitrate >> 24); pbuf[4] = LineCoding.format; pbuf[5] = LineCoding.paritytype; pbuf[6] = LineCoding.datatype; break; case CDC_GET_LINE_CODING: case CDC_SET_CONTROL_LINE_STATE: /* Add your code here */ break; case CDC_SET_CONTROL_LINE_STATE: case CDC_SEND_BREAK: /* Add your code here */ break; case CDC_SEND_BREAK: default: break;default }switch (cmd) { ... } return (USBD_OK); }{ ... } /** * @brief TIM period elapsed callback * @param htim: TIM handle * @retval None *//* ... */ void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef * htim) { uint32_t buffptr; uint32_t buffsize; if (UserTxBufPtrOut != UserTxBufPtrIn) { if (UserTxBufPtrOut > UserTxBufPtrIn) /* Rollback */ { buffsize = APP_RX_DATA_SIZE - UserTxBufPtrOut; ...} else { buffsize = UserTxBufPtrIn - UserTxBufPtrOut; }else { ... } buffptr = UserTxBufPtrOut; USBD_CDC_SetTxBuffer(&USBD_Device_HS, (uint8_t *) & UserTxBuffer[buffptr], buffsize); if (USBD_CDC_TransmitPacket(&USBD_Device_HS) == USBD_OK) { UserTxBufPtrOut += buffsize; if (UserTxBufPtrOut == APP_RX_DATA_SIZE) { UserTxBufPtrOut = 0; }if (UserTxBufPtrOut == APP_RX_DATA_SIZE) { ... } }if (USBD_CDC_TransmitPacket(&USBD_Device_HS) == USBD_OK) { ... } }if (UserTxBufPtrOut != UserTxBufPtrIn) { ... } }{ ... } /** * @brief Rx Transfer completed callback * @param huart: UART handle * @retval None *//* ... */ void HAL_UART_RxCpltCallback(UART_HandleTypeDef * huart) { /* Increment Index for buffer writing */ UserTxBufPtrIn++; /* To avoid buffer overflow */ if (UserTxBufPtrIn == APP_RX_DATA_SIZE) { UserTxBufPtrIn = 0; }if (UserTxBufPtrIn == APP_RX_DATA_SIZE) { ... } /* Start another reception: provide the buffer pointer with offset and the * buffer size *//* ... */ HAL_UART_Receive_IT(huart, (uint8_t *) (UserTxBuffer + UserTxBufPtrIn), 1); }{ ... } /** * @brief CDC_Itf_DataRx * Data received over USB OUT endpoint are sent over CDC interface * through this function. * @param Buf: Buffer of data to be transmitted * @param Len: Number of data received (in bytes) * @retval Result of the operation: USBD_OK if all operations are OK else USBD_FAIL *//* ... */ static int8_t CDC_Itf_Receive(uint8_t * Buf, uint32_t * Len) { HAL_UART_Transmit_DMA(&UartHandle, Buf, *Len); return (USBD_OK); }{ ... } /** * @brief CDC_Itf_TransmitCplt * Data transmitted callback * * @note * This function is IN transfer complete callback used to inform user that * the submitted Data is successfully sent over USB. * * @param Buf: Buffer of data to be received * @param Len: Number of data received (in bytes) * @retval Result of the operation: USBD_OK if all operations are OK else USBD_FAIL *//* ... */ static int8_t CDC_Itf_TransmitCplt(uint8_t *Buf, uint32_t *Len, uint8_t epnum) { return (0); }{ ... } /** * @brief Tx Transfer completed callback * @param huart: UART handle * @retval None *//* ... */ void HAL_UART_TxCpltCallback(UART_HandleTypeDef * huart) { /* Initiate next USB packet transfer once UART completes transfer * (transmitting data over Tx line) *//* ... */ USBD_CDC_ReceivePacket(&USBD_Device_HS); }{ ... } /** * @brief ComPort_Config * Configure the COM Port with the parameters received from host. * @param None. * @retval None * @note When a configuration is not supported, a default value is used. *//* ... */ static void ComPort_Config(void) { if (HAL_UART_DeInit(&UartHandle) != HAL_OK) { /* Initialization Error */ Error_Handler(); }if (HAL_UART_DeInit(&UartHandle) != HAL_OK) { ... } /* set the Stop bit */ switch (LineCoding.format) { case 0: UartHandle.Init.StopBits = UART_STOPBITS_1; break;case 0: case 2: UartHandle.Init.StopBits = UART_STOPBITS_2; break;case 2: default: UartHandle.Init.StopBits = UART_STOPBITS_1; break;default }switch (LineCoding.format) { ... } /* set the parity bit */ switch (LineCoding.paritytype) { case 0: UartHandle.Init.Parity = UART_PARITY_NONE; break;case 0: case 1: UartHandle.Init.Parity = UART_PARITY_ODD; break;case 1: case 2: UartHandle.Init.Parity = UART_PARITY_EVEN; break;case 2: default: UartHandle.Init.Parity = UART_PARITY_NONE; break;default }switch (LineCoding.paritytype) { ... } /* set the data type : only 8bits and 9bits is supported */ switch (LineCoding.datatype) { case 0x07: /* With this configuration a parity (Even or Odd) must be set */ UartHandle.Init.WordLength = UART_WORDLENGTH_8B; break;case 0x07: case 0x08: if (UartHandle.Init.Parity == UART_PARITY_NONE) { UartHandle.Init.WordLength = UART_WORDLENGTH_8B; }if (UartHandle.Init.Parity == UART_PARITY_NONE) { ... } else { UartHandle.Init.WordLength = UART_WORDLENGTH_9B; }else { ... } break;case 0x08: default: UartHandle.Init.WordLength = UART_WORDLENGTH_8B; break;default }switch (LineCoding.datatype) { ... } UartHandle.Init.BaudRate = LineCoding.bitrate; UartHandle.Init.HwFlowCtl = UART_HWCONTROL_NONE; UartHandle.Init.Mode = UART_MODE_TX_RX; UartHandle.Init.OverSampling = UART_OVERSAMPLING_16; if (HAL_UART_Init(&UartHandle) != HAL_OK) { /* Initialization Error */ Error_Handler(); }if (HAL_UART_Init(&UartHandle) != HAL_OK) { ... } /* Start reception: provide the buffer pointer with offset and the buffer * size *//* ... */ HAL_UART_Receive_IT(&UartHandle, (uint8_t *) (UserTxBuffer + UserTxBufPtrIn), 1); }{ ... } /** * @brief TIM_Config: Configure TIMx timer * @param None. * @retval None *//* ... */ static void TIM_Config(void) { /* Set TIMx instance */ TimHandle.Instance = TIMx; /* Initialize TIM3 peripheral as follows: + Period = (CDC_POLLING_INTERVAL * * 10000) - 1 + Prescaler = ((APB1 frequency / 1000000) - 1) + ClockDivision * = 0 + Counter direction = Up *//* ... */ TimHandle.Init.Period = (CDC_POLLING_INTERVAL * 1000) - 1; TimHandle.Init.Prescaler = 84 - 1; TimHandle.Init.ClockDivision = 0; TimHandle.Init.CounterMode = TIM_COUNTERMODE_UP; if (HAL_TIM_Base_Init(&TimHandle) != HAL_OK) { /* Initialization Error */ Error_Handler(); }if (HAL_TIM_Base_Init(&TimHandle) != HAL_OK) { ... } }{ ... } /** * @brief UART error callbacks * @param UartHandle: UART handle * @retval None *//* ... */ void HAL_UART_ErrorCallback(UART_HandleTypeDef * UartHandle) { /* Transfer error occurred in reception and/or transmission process */ Error_Handler(); }{ ... } /** * @brief This function is executed in case of error occurrence. * @param None * @retval None *//* ... */ static void Error_Handler(void) { /* Add your own code here */ }{ ... }