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
|
/**
@page ADC_SingleConversion_TriggerTimer_DMA_Init ADC example
@verbatim
******************************************************************************
* @file Examples_LL/ADC/ADC_SingleConversion_TriggerTimer_DMA_Init/readme.txt
* @author MCD Application Team
* @brief Description of the ADC_SingleConversion_TriggerTimer_DMA_Init example.
******************************************************************************
*
* Copyright (c) 2019-2021 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.
*
******************************************************************************
@endverbatim
@par Example Description
How to use an ADC peripheral to perform a single ADC conversion on a channel
at each trigger event from a timer. Converted data is transferred by DMA
into a table in RAM memory.
This example is based on the STM32WBxx ADC LL API.
The peripheral initialization is done using LL unitary service functions
for optimization purposes (performance and size).
Example configuration:
ADC is configured to convert a single channel, in single conversion mode,
from HW trigger: timer peripheral (timer instance: TIM2).
timer is configured to provide a time base of 1kHz.
DMA is configured to transfer conversion data in an array, in circular mode.
A timer is configured in time base and to generate TRGO events.
Example execution:
From the main program execution, the ADC group regular converts the
selected channel at each trig from timer. DMA transfers conversion data to the array,
indefinitely (DMA in circular mode).
When conversion are completed (DMA half or full buffer complete),
interruption occurs and data is processed in callback functions (for this example purpose,
convert digital data to physical value in mV).
LED2 is used to monitor program execution status:
- Normal operation: ADC group regular buffer activity (buffer complete events):
LED toggle at frequency of time base / half buffer size (approx. 31Hz with this example default settings)
- Error: LED remaining turned on
Debug: variables to monitor with debugger:
- "uhADCxConvertedData": ADC group regular buffer conversion data (resolution 12 bits)
- "uhADCxConvertedData_Voltage_mVolt": ADC group regular buffer conversion data computed to voltage value (unit: mV)
Connection needed:
Use an external power supply to generate a voltage in range [0V; 3.3V]
and connect it to analog input pin (cf pin below).
Note: If no power supply available, this pin can be let floating (in this case
ADC conversion data will be undetermined).
Other peripherals used:
1 GPIO for LED2
1 GPIO for analog input: ADC channel 6 on pin PA.01 (Arduino connector CN8 pin A2, Morpho connector CN7 pin 32)
1 DMA channel
1 timer instance
@par Keywords
ADC, analog digital converter, analog, conversion, voltage, channel, analog input, regular, injected, DMA transfer, trigger
@par Directory contents
- ADC/ADC_SingleConversion_TriggerTimer_DMA_Init/Inc/stm32wbxx_it.h Interrupt handlers header file
- ADC/ADC_SingleConversion_TriggerTimer_DMA_Init/Inc/main.h Header for main.c module
- ADC/ADC_SingleConversion_TriggerTimer_DMA_Init/Inc/stm32_assert.h Template file to include assert_failed function
- ADC/ADC_SingleConversion_TriggerTimer_DMA_Init/Src/stm32wbxx_it.c Interrupt handlers
- ADC/ADC_SingleConversion_TriggerTimer_DMA_Init/Src/main.c Main program
- ADC/ADC_SingleConversion_TriggerTimer_DMA_Init/Src/system_stm32wbxx.c STM32WBxx system source file
@par Hardware and Software environment
- This example runs on STM32WB15CCUx devices.
- This example has been tested with NUCLEO-WB15CC board and can be
easily tailored to any other supported device and development board.
@par How to use it ?
In order to make the program work, you must do the following :
- Open your preferred toolchain
- Rebuild all files and load your image into target memory
- Run the example
* <h3><center>© COPYRIGHT STMicroelectronics</center></h3>
*/
|
