OrgST-Microelectronics/STM32CubeF3
1
0
Fork 0
mirror of https://github.com/STMicroelectronics/STM32CubeF3.git synced 2025-05-01 22:18:23 +08:00
Code Issues Releases Wiki Activity
STM32CubeF3/Projects/STM32373C_EVAL/Examples/SDADC/SDADC_TempMeasurement/Src/main.c
Ali Labbene e684e8712c Release v1.10.0
2019-07-15 15:37:15 +01:00

492 lines
18 KiB
C
Raw Blame History

/**
******************************************************************************
* @file SDADC/SDADC_TempMeasurement/Src/main.c
* @author MCD Application Team
* @brief This example describes how to configure and use SDADC through
* the STM32F3xx HAL API to realize a temperature measurement. The sensor
* used is a PT100.
******************************************************************************
* @attention
*
* <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
* 1. Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
* 3. Neither the name of STMicroelectronics nor the names of its contributors
* may be used to endorse or promote products derived from this software
* without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
******************************************************************************
*/
/* Includes ------------------------------------------------------------------*/
#include "main.h"
/** @addtogroup STM32F3xx_HAL_Examples
* @{
*/
/** @addtogroup SDADC_TempMeasurement
* @{
*/
/* Private typedef -----------------------------------------------------------*/
/* Private define ------------------------------------------------------------*/
/* Private macro -------------------------------------------------------------*/
/* Private variables ---------------------------------------------------------*/
/* AvrgRegularConvData contains the */
__IO int16_t AvrgRegularConvData = 0;
/* FirstConversionDone is used to indicate that at least one conversion occurs to compute the temperature */
uint8_t FirstConversionDone = 0;
/* hsdadc is a handle to manage the SDADC*/
SDADC_HandleTypeDef hsdadc;
/* Private function prototypes -----------------------------------------------*/
static void SystemClock_Config(void);
void ErrorDisplay(uint8_t *strLine4, uint8_t *strLine5, uint8_t *strLine6);
float PT100Calibration(void);
/* Private functions ---------------------------------------------------------*/
/**
* @brief Main program
* @param None
* @retval None
*/
int main(void)
{
/* coeffCorrection is the result of the calibration */
float coeffCorrection = 1.0f;
/* temperaturePT100 is the ambient temperature displayed on screen*/
float temperaturePT100 = 0;
/* LCDstr is a buffer to store the string to display on screen */
uint8_t LCDstr[40] = {0};
/* confParam contains the channel configuration */
SDADC_ConfParamTypeDef confParam;
/* endOfExample is set to 1 when the user press the key button. This give an overview on how to disable the SDADC when it is no more required to use it.*/
uint32_t endOfExample = 0;
/* STM32F3xx HAL library initialization:
- Configure the Flash prefetch
- Systick timer is configured by default as source of time base, but user
can eventually implement his proper time base source (a general purpose
timer for example or other time source), keeping in mind that Time base
duration should be kept 1ms since PPP_TIMEOUT_VALUEs are defined and
handled in milliseconds basis.
- Set NVIC Group Priority to 4
- Low Level Initialization
*/
HAL_Init();
/* Configure the system clock to 72 Mhz */
SystemClock_Config();
/* Configure the User Button in GPIO Mode */
BSP_PB_Init(BUTTON_KEY, BUTTON_MODE_GPIO);
/* Initialise the LCD */
BSP_LCD_Init();
/* Set a font*/
BSP_LCD_SetFont(&Font20);
/* Clear the LCD */
BSP_LCD_SetBackColor(LCD_COLOR_BLUE);
BSP_LCD_Clear(LCD_COLOR_WHITE);
/* Set the LCD Text Color */
BSP_LCD_SetTextColor(LCD_COLOR_WHITE);
BSP_LCD_DisplayStringAtLine(0, (uint8_t *)MESSAGE1);
BSP_LCD_DisplayStringAtLine(1, (uint8_t *)MESSAGE2);
/* Set the LCD Back Color */
BSP_LCD_SetBackColor(LCD_COLOR_WHITE);
/* Set the LCD Text Color */
BSP_LCD_SetTextColor(LCD_COLOR_RED);
BSP_LCD_DisplayStringAtLine(3, (uint8_t *)"=> Calibration phase");
BSP_LCD_DisplayStringAtLine(4, (uint8_t *)"1. Set JP18 in 2-3 ");
BSP_LCD_DisplayStringAtLine(5, (uint8_t *)"2. Press KEY button ");
/* Set the LCD Text Color */
BSP_LCD_SetTextColor(LCD_COLOR_BLUE);
BSP_LCD_DisplayStringAtLine(7, (uint8_t *)" Measurement phase ");
BSP_LCD_DisplayStringAtLine(8, (uint8_t *)"1. Set JP18 in 1-2 ");
BSP_LCD_DisplayStringAtLine(9, (uint8_t *)"2. Press KEY button ");
/* Wait for KEY button to be pressed */
while (BSP_PB_GetState(BUTTON_KEY) != SET);
/* Wait for KEY button to be released */
while (BSP_PB_GetState(BUTTON_KEY) == SET);
/* Fill the SDADC handler with the parameters of initialisation */
/* An external reference is used. The other options are not used (low power, fast conversion,slow clock mode)*/
hsdadc.Instance = SDADC1;
hsdadc.Init.ReferenceVoltage = SDADC_VREF_EXT;
hsdadc.Init.IdleLowPowerMode = SDADC_LOWPOWER_NONE;
hsdadc.Init.FastConversionMode = SDADC_FAST_CONV_DISABLE;
hsdadc.Init.SlowClockMode = SDADC_SLOW_CLOCK_DISABLE;
/* -1- Initialise the SDADC */
if (HAL_SDADC_Init(&hsdadc) != HAL_OK)
{
/* An error occurs during the initialisation */
ErrorDisplay((uint8_t*)"Fail to initialise",(uint8_t*)"the SDADC",(uint8_t*)"");
}
/* -2- Prepare the channel configuration */
confParam.CommonMode = SDADC_COMMON_MODE_VSSA;
confParam.Gain = PT100_SDADC_GAIN;
confParam.InputMode = SDADC_INPUT_MODE_SE_OFFSET;
confParam.Offset = 0x00000000;
if (HAL_SDADC_PrepareChannelConfig(&hsdadc, SDADC_CONF_INDEX_0, &confParam) != HAL_OK)
{
/* An error occurs during the preparation of the channel's configuration */
ErrorDisplay((uint8_t*)"Fail to prepare",(uint8_t*)"the channel",(uint8_t*)"configuration");
}
/* Associate the channel of PT100 sensor to the configuration 0 */
if (HAL_SDADC_AssociateChannelConfig(&hsdadc, PT100_SDADC_CHANNEL, SDADC_CONF_INDEX_0) != HAL_OK)
{
/* An error occurs during the association of the channel to the prepared configuration */
ErrorDisplay((uint8_t*)"Fail to associate",(uint8_t*)"the channel to the",(uint8_t*)"configuration");
}
/* Select the channel of PT100 for a regular conversion and not for continuous mode */
if (HAL_SDADC_ConfigChannel(&hsdadc, PT100_SDADC_CHANNEL, SDADC_CONTINUOUS_CONV_OFF) != HAL_OK)
{
/* An error occurs during the selection of the channel for the regular conversion */
ErrorDisplay((uint8_t*)"Fail to select the", (uint8_t*)"channel for a", (uint8_t*)"regular conversion");
}
/* Select software trigger for regular conversion */
if (HAL_SDADC_SelectRegularTrigger(&hsdadc, SDADC_SOFTWARE_TRIGGER) != HAL_OK)
{
/* An error occurs during the selection of the trigger */
ErrorDisplay((uint8_t*)"Fail to select the", (uint8_t*)"trigger for a", (uint8_t*)"regular conversion");
}
/* Start Calibration in polling mode */
if (HAL_SDADC_CalibrationStart(&hsdadc, SDADC_CALIBRATION_SEQ_1) != HAL_OK)
{
/* An error occurs during the starting phase of the calibration */
ErrorDisplay((uint8_t*)"Fail to start the",(uint8_t*)"calibration",(uint8_t*)"");
}
/* Pool for the end of calibration */
if (HAL_SDADC_PollForCalibEvent(&hsdadc, HAL_MAX_DELAY) != HAL_OK)
{
/* An error occurs while waiting for the end of the calibration */
ErrorDisplay((uint8_t*)"Fail to correctly",(uint8_t*)"calibrate SDADC",(uint8_t*)"");
}
/* Calibration of the sensor (refer to readme.txt for more detail on this part)*/
coeffCorrection = PT100Calibration();
/* Clear the display*/
BSP_LCD_ClearStringLine(3);
BSP_LCD_ClearStringLine(4);
BSP_LCD_ClearStringLine(5);
BSP_LCD_ClearStringLine(6);
BSP_LCD_ClearStringLine(7);
BSP_LCD_ClearStringLine(8);
BSP_LCD_ClearStringLine(9);
/* Set the LCD Text Color */
BSP_LCD_SetTextColor(LCD_COLOR_BLUE);
BSP_LCD_DisplayStringAtLine(3, (uint8_t *)" Calibration phase");
BSP_LCD_DisplayStringAtLine(4, (uint8_t *)"1. Set JP18 in 2-3 ");
BSP_LCD_DisplayStringAtLine(5, (uint8_t *)"2. Press KEY button ");
/* Set the LCD Text Color */
BSP_LCD_SetTextColor(LCD_COLOR_RED);
BSP_LCD_DisplayStringAtLine(7, (uint8_t *)"=> Measurement phase");
BSP_LCD_DisplayStringAtLine(8, (uint8_t *)"1. Set JP18 in 1-2 ");
BSP_LCD_DisplayStringAtLine(9, (uint8_t *)"2. Press KEY button ");
/* Wait for KEY button to be pressed */
while (BSP_PB_GetState(BUTTON_KEY) != SET);
/* Wait for KEY button to be released */
while (BSP_PB_GetState(BUTTON_KEY) == SET);
/* Set the LCD Back Color */
BSP_LCD_SetBackColor(LCD_COLOR_WHITE);
/* Set the LCD Text Color */
BSP_LCD_SetTextColor(LCD_COLOR_BLUE);
BSP_LCD_ClearStringLine(3);
BSP_LCD_ClearStringLine(4);
BSP_LCD_ClearStringLine(5);
BSP_LCD_ClearStringLine(6);
BSP_LCD_ClearStringLine(7);
BSP_LCD_ClearStringLine(8);
BSP_LCD_ClearStringLine(9);
BSP_LCD_DisplayStringAtLine(9, (uint8_t *)"KEY button to stop");
/* Select the channel of PT100 for a regular conversion in continuous mode */
if (HAL_SDADC_ConfigChannel(&hsdadc, PT100_SDADC_CHANNEL, SDADC_CONTINUOUS_CONV_ON) != HAL_OK)
{
/* An error occurs during the selection of the channel for the regular conversion */
ErrorDisplay((uint8_t*)"Fail to select the", (uint8_t*)"channel for a", (uint8_t*)"regular conversion");
}
/* Activate the interrupt. This could be done also in HAL_SDADC_MspInit function but, as
a conversion without interrupt is required in PT100Calibration function, it is added here */
HAL_NVIC_SetPriority(PT100_SDADC_IRQn, 0x01, 0);
HAL_NVIC_EnableIRQ(PT100_SDADC_IRQn);
/* Start regular conversion in interrupt mode */
if (HAL_SDADC_Start_IT(&hsdadc) != HAL_OK)
{
/* An error occurs while starting the regular conversion */
ErrorDisplay((uint8_t*)"Fail to start the", (uint8_t*)"regular conversion", (uint8_t*)"in interrupt mode");
}
/* Infinite loop */
while (endOfExample == 0)
{
if(FirstConversionDone == 1) /* AvrgRegularConvData need to be updated before used */
{
/* Compute the temperature value */
temperaturePT100 = (float)((((coeffCorrection * (AvrgRegularConvData / SDADC_GAIN) * REFERENCE_RESISTOR * 2) / SDADC_RESOL) - RESISTANCE_ZERODEGRE) / RESISTANCE_COEFFICIENT);
sprintf((char *)LCDstr, "Temperature = %2.1f C ", temperaturePT100);
BSP_LCD_DisplayStringAtLine(5, LCDstr);
}
/* If the KEY button is pressed, the end of the example is reached*/
if (BSP_PB_GetState(BUTTON_KEY) == RESET)
{
while (BSP_PB_GetState(BUTTON_KEY) == RESET);
endOfExample = 1;
}
}
/* Stop the regular conversion in interrupt mode */
if (HAL_SDADC_Stop_IT(&hsdadc) != HAL_OK)
{
/* An error occurs while stopping the regular conversion */
ErrorDisplay((uint8_t*)"Fail to stop the", (uint8_t*)"regular conversion", (uint8_t*)"");
}
/* Deactivate the interrupt. This could be done also in HAL_SDADC_MspDeInit function. As
a conversion without interrupt is required in PT100Calibration function, it is added here */
HAL_NVIC_DisableIRQ(PT100_SDADC_IRQn);
/* DeInit the SDADC */
HAL_SDADC_DeInit(&hsdadc);
/* This is the end of the example*/
BSP_LCD_ClearStringLine(9);
BSP_LCD_DisplayStringAtLine(9, (uint8_t *)" End of example");
return 1;
}
/**
* @brief Display an error message on screen and never return from the while(1) loop.
* @param strLine4 : the string displayed on line 4.
* @param strLine5 : the string displayed on line 5.
* @param strLine6 : the string displayed on line 6.
* @retval None
*/
void ErrorDisplay(uint8_t *strLine4, uint8_t *strLine5, uint8_t *strLine6)
{
/* Set the Back Color */
BSP_LCD_SetBackColor(LCD_COLOR_BLUE);
/* Set the Text Color */
BSP_LCD_SetTextColor(LCD_COLOR_RED);
/* Remark: a line can contains only 18 characters */
BSP_LCD_DisplayStringAtLine(4, strLine4);
BSP_LCD_DisplayStringAtLine(5, strLine5);
BSP_LCD_DisplayStringAtLine(6, strLine6);
while (1);
}
/**
* @brief Convert 256 times the external reference voltage (using external
* reference resistor 100 Ohm) and compute the correction factor
* @param None
* @retval the correction factor
*/
float PT100Calibration(void)
{
float averageValue = 0.0f;
int16_t GetValueResult = 0;
uint16_t samplesCounter = 0;
for (samplesCounter = 0; samplesCounter < 256; samplesCounter++)
{
/* Start regular conversion in polling mode */
if (HAL_SDADC_Start(&hsdadc) != HAL_OK)
{
/* An error occurs during the conversion */
ErrorDisplay((uint8_t*)"PT100 Calibration:", (uint8_t*)"Fail to", (uint8_t*)"convert");
}
/* wait for end of regular conversion */
if (HAL_SDADC_PollForConversion(&hsdadc, HAL_MAX_DELAY) != HAL_OK)
{
/* An error occurs while waiting for the end of the conversion */
ErrorDisplay((uint8_t*)"PT100 Calibration:", (uint8_t*)"Error while", (uint8_t*)"waiting the EOC");
}
GetValueResult = HAL_SDADC_GetValue(&hsdadc);
/* Get value */
averageValue += GetValueResult;
}
/* Compute the average value */
averageValue = averageValue / (256.0 * SDADC_GAIN);
/* compute the correction factor */
return ((float)(1820.0f / averageValue)); /* 1820 = 100 * 65535 / 3600 */
/* T = ((sdadcsample * 3600 / 65535) - 100) / 0.385 = 0 <20>C
sdadcsample * 3600 / 65535 = 100 ==> sdadcsample = 100 * 65535 / 3600 = 1820 */
}
/**
* @brief Regular conversion complete callback.
* @param hsdadc : SDADC handle.
* @retval None
*/
void HAL_SDADC_ConvCpltCallback(SDADC_HandleTypeDef *hsdadc)
{
int16_t RegularConvData = 0;
static uint16_t RegularConvCounter = 0;
static int32_t SumRegularConvData = 0;
/* Get the converted value */
RegularConvData = HAL_SDADC_GetValue(hsdadc);
/* Increment the counter */
RegularConvCounter++;
/* sum up the samples */
SumRegularConvData += RegularConvData;
if (RegularConvCounter >= 256)
{
/* Compute the average value for 256 samples */
AvrgRegularConvData = SumRegularConvData / 256;
RegularConvCounter = 0;
SumRegularConvData = 0;
FirstConversionDone = 1;
}
}
/**
* @brief System Clock Configuration
* The system Clock is configured as follow :
* System Clock source = PLL (HSE)
* SYSCLK(Hz) = 72000000
* HCLK(Hz) = 72000000
* AHB Prescaler = 1
* APB1 Prescaler = 2
* APB2 Prescaler = 1
* HSE Frequency(Hz) = 8000000
* HSE PREDIV = 1
* PLLMUL = RCC_PLL_MUL9 (9)
* Flash Latency(WS) = 2
* @param None
* @retval None
*/
static void SystemClock_Config(void)
{
RCC_ClkInitTypeDef RCC_ClkInitStruct;
RCC_OscInitTypeDef RCC_OscInitStruct;
/* Enable HSE Oscillator and activate PLL with HSE as source */
RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;
RCC_OscInitStruct.HSEState = RCC_HSE_ON;
RCC_OscInitStruct.HSEPredivValue = RCC_HSE_PREDIV_DIV1;
RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE;
RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9;
if (HAL_RCC_OscConfig(&RCC_OscInitStruct)!= HAL_OK)
{
Error_Handler();
}
/* Select PLL as system clock source and configure the HCLK, PCLK1 and PCLK2
clocks dividers */
RCC_ClkInitStruct.ClockType = (RCC_CLOCKTYPE_SYSCLK | RCC_CLOCKTYPE_HCLK | RCC_CLOCKTYPE_PCLK1 | RCC_CLOCKTYPE_PCLK2);
RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;
RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1;
RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2;
RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1;
if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_2)!= HAL_OK)
{
Error_Handler();
}
}
/**
* @brief This function is executed in case of error occurrence.
* @param None
* @retval None
*/
void Error_Handler(void)
{
/* User may add here some code to deal with this error */
while(1)
{
}
}
#ifdef USE_FULL_ASSERT
/**
* @brief Reports the name of the source file and the source line number
* where the assert_param error has occurred.
* @param file: pointer to the source file name
* @param line: assert_param error line source number
* @retval None
*/
void assert_failed(char *file, uint32_t line)
{
/* User can add his own implementation to report the file name and line number,
ex: printf("Wrong parameters value: file %s on line %d\r\n", file, line) */
/* Infinite loop */
while (1)
{
}
}
#endif
/**
* @}
*/
/**
* @}
*/
/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
Reference in New Issue View Git Blame Copy Permalink