jackcartersmith/blackmagic
1
0
Fork 0
Code Issues Pull Requests Releases Activity

stm32f4: adc: Correct ADC documentation

Browse Source
This commit is contained in:
Jordi Pakey-Rodriguez 2017-04-10 14:36:18 -05:00 committed by Karl Palsson
parent 74dd24a062
commit c7d46c4fbb
1 changed files with 13 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
lib/stm32/f4/adc.c
View File

@ -19,7 +19,7 @@ of 8. The ADC resolution can be set to 12, 10, 8 or 6 bits.
Each A/D converter has up to 19 channels: Each A/D converter has up to 19 channels:
@li On ADC1 the analog channels 16 is internally connected to the temperature @li On ADC1 the analog channels 16 is internally connected to the temperature
sensor, channel 17 to V<sub>REFINT</sub>, and channel 18 to V<sub>BATT</sub>. sensor, channel 17 to V<sub>REFINT</sub>, and channel 18 to V<sub>BAT</sub>.
@li On ADC2 and ADC3 the analog channels 16 - 18 are not used. @li On ADC2 and ADC3 the analog channels 16 - 18 are not used.
The conversions can occur as a one-off conversion whereby the process stops The conversions can occur as a one-off conversion whereby the process stops
@ -42,22 +42,22 @@ of conversion, which occurs after all channels have been scanned.
@section adc_f4_api_ex Basic ADC Handling API. @section adc_f4_api_ex Basic ADC Handling API.
Example 1: Simple single channel conversion polled. Enable the peripheral clock Example 1: Simple single channel conversion polled. Enable the peripheral clock
and ADC, reset ADC and set the prescaler divider. Set multiple mode to and ADC, reset ADC and set the prescaler divider. Set the sample time to a
independent. minimum of 3 cycles. Set multiple mode to independent.
@code @code
gpio_mode_setup(GPIOA, GPIO_MODE_ANALOG, GPIO_PUPD_NONE, GPIO1); gpio_mode_setup(GPIOA, GPIO_MODE_ANALOG, GPIO_PUPD_NONE, GPIO1);
rcc_peripheral_enable_clock(&RCC_APB2ENR, RCC_APB2ENR_ADC1EN); rcc_periph_clock_enable(RCC_ADC1);
adc_set_clk_prescale(RCC_CFGR_ADCPRE_BY2); adc_set_clk_prescale(ADC_CCR_ADCPRE_BY2);
adc_disable_scan_mode(ADC1); adc_disable_scan_mode(ADC1);
adc_set_single_conversion_mode(ADC1); adc_set_single_conversion_mode(ADC1);
adc_set_sample_time(ADC1, ADC_CHANNEL0, ADC_SMPR1_SMP_1DOT5CYC); adc_set_sample_time(ADC1, ADC_CHANNEL0, ADC_SMPR_SMP_3CYC);
uint8_t channels[] = ADC_CHANNEL0; uint8_t channels[] = ADC_CHANNEL0;
adc_set_regular_sequence(ADC1, 1, channels); adc_set_regular_sequence(ADC1, 1, channels);
adc_set_multi_mode(ADC_CCR_MULTI_INDEPENDENT); adc_set_multi_mode(ADC_CCR_MULTI_INDEPENDENT);
adc_power_on(ADC1); adc_power_on(ADC1);
adc_start_conversion_regular(ADC1); adc_start_conversion_regular(ADC1);
while (! adc_eoc(ADC1)); while (!adc_eoc(ADC1));
reg16 = adc_read_regular(ADC1); reg16 = adc_read_regular(ADC1);
@endcode @endcode
@ -406,13 +406,13 @@ bool adc_awd(uint32_t adc)
/*---------------------------------------------------------------------------*/ /*---------------------------------------------------------------------------*/
/** @brief ADC Enable The Temperature Sensor /** @brief ADC Enable The Temperature Sensor
This enables both the sensor and the reference voltage measurements on channels This enables both the sensor and the reference voltage measurements on ADC1
16 and 17. These are only available on ADC1 channel 16 and 17 respectively. channels 16 and 17. On STM32F42x and STM32F43x, the temperature sensor is
connected to ADC1 channel 18, the same as VBat. If both are enabled, only the
@param[in] adc Unsigned int32. ADC block register address base @ref adc_reg_base VBat conversion is performed.
*/ */
void adc_enable_temperature_sensor() void adc_enable_temperature_sensor(void)
{ {
ADC_CCR |= ADC_CCR_TSVREFE; ADC_CCR |= ADC_CCR_TSVREFE;
} }
@ -422,11 +422,9 @@ void adc_enable_temperature_sensor()
Disabling this will reduce power consumption from the sensor and the reference Disabling this will reduce power consumption from the sensor and the reference
voltage measurements. voltage measurements.
@param[in] adc Unsigned int32. ADC block register address base @ref adc_reg_base
*/ */
void adc_disable_temperature_sensor() void adc_disable_temperature_sensor(void)
{ {
ADC_CCR &= ~ADC_CCR_TSVREFE; ADC_CCR &= ~ADC_CCR_TSVREFE;
} }
@ -434,4 +432,3 @@ void adc_disable_temperature_sensor()
/*---------------------------------------------------------------------------*/ /*---------------------------------------------------------------------------*/
/**@}*/ /**@}*/