mirror of
https://github.com/STMicroelectronics/STM32CubeF0.git
synced 2025-05-06 19:29:12 +08:00
311 lines
11 KiB
C
311 lines
11 KiB
C
/**
|
||
******************************************************************************
|
||
* @file UART/UART_HyperTerminal_DMA/Src/main.c
|
||
* @author MCD Application Team
|
||
* @brief This sample code shows how to use UART HAL API to transmit
|
||
* and receive a data buffer with a communication process based on
|
||
* DMA transfer.
|
||
* The communication is done with the Hyperterminal PC application.
|
||
******************************************************************************
|
||
* @attention
|
||
*
|
||
* <h2><center>© 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 STM32F0xx_HAL_Examples
|
||
* @{
|
||
*/
|
||
|
||
/** @addtogroup UART_Hyperterminal_DMA
|
||
* @{
|
||
*/
|
||
|
||
/* Private typedef -----------------------------------------------------------*/
|
||
/* Private define ------------------------------------------------------------*/
|
||
/* Private macro -------------------------------------------------------------*/
|
||
/* Private variables ---------------------------------------------------------*/
|
||
/* UART handler declaration */
|
||
UART_HandleTypeDef UartHandle;
|
||
|
||
/* Buffer used for transmission */
|
||
uint8_t aTxStartMessage[] = "\n\r ****UART-Hyperterminal communication based on DMA****\n\r Enter 10 characters using keyboard :\n\r";
|
||
uint8_t aTxEndMessage[] = "\n\r Example Finished\n\r";
|
||
|
||
/* Buffer used for reception */
|
||
uint8_t aRxBuffer[RXBUFFERSIZE];
|
||
|
||
/* Private function prototypes -----------------------------------------------*/
|
||
static void SystemClock_Config(void);
|
||
static void Error_Handler(void);
|
||
|
||
/* Private functions ---------------------------------------------------------*/
|
||
|
||
/**
|
||
* @brief Main program
|
||
* @param None
|
||
* @retval None
|
||
*/
|
||
int main(void)
|
||
{
|
||
|
||
/* STM32F0xx 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.
|
||
- Low Level Initialization
|
||
*/
|
||
HAL_Init();
|
||
|
||
/* Configure the system clock to 48 MHz */
|
||
SystemClock_Config();
|
||
|
||
/* Configure LED3 */
|
||
BSP_LED_Init(LED3);
|
||
|
||
/*##-1- Configure the UART peripheral ######################################*/
|
||
/* Put the USART peripheral in the Asynchronous mode (UART Mode) */
|
||
/* UART configured as follows:
|
||
- Word Length = 8 Bits (7 data bit + 1 parity bit) :
|
||
BE CAREFUL : Program 7 data bits + 1 parity bit in PC HyperTerminal
|
||
- Stop Bit = One Stop bit
|
||
- Parity = ODD parity
|
||
- BaudRate = 9600 baud
|
||
- Hardware flow control disabled (RTS and CTS signals) */
|
||
UartHandle.Instance = USARTx;
|
||
|
||
UartHandle.Init.BaudRate = 9600;
|
||
UartHandle.Init.WordLength = UART_WORDLENGTH_8B;
|
||
UartHandle.Init.StopBits = UART_STOPBITS_1;
|
||
UartHandle.Init.Parity = UART_PARITY_ODD;
|
||
UartHandle.Init.HwFlowCtl = UART_HWCONTROL_NONE;
|
||
UartHandle.Init.Mode = UART_MODE_TX_RX;
|
||
|
||
if (HAL_UART_Init(&UartHandle) != HAL_OK)
|
||
{
|
||
/* Initialization Error */
|
||
Error_Handler();
|
||
}
|
||
|
||
/*##-2- Start the transmission process #####################################*/
|
||
/* User start transmission data through "TxBuffer" buffer */
|
||
if(HAL_UART_Transmit_DMA(&UartHandle, (uint8_t*)aTxStartMessage, TXSTARTMESSAGESIZE)!= HAL_OK)
|
||
{
|
||
/* Transfer error in transmission process */
|
||
Error_Handler();
|
||
}
|
||
|
||
/*##-3- Put UART peripheral in reception process ###########################*/
|
||
/* Any data received will be stored in "RxBuffer" buffer : the number max of
|
||
data received is 10 */
|
||
if (HAL_UART_Receive_DMA(&UartHandle, (uint8_t *)aRxBuffer, RXBUFFERSIZE) != HAL_OK)
|
||
{
|
||
/* Transfer error in reception process */
|
||
Error_Handler();
|
||
}
|
||
|
||
/*##-4- Wait for the end of the transfer ###################################*/
|
||
/* Before starting a new communication transfer, you need to check the current
|
||
state of the peripheral; if it<69>s busy you need to wait for the end of current
|
||
transfer before starting a new one.
|
||
For simplicity reasons, this example is just waiting till the end of the
|
||
transfer, but application may perform other tasks while transfer operation
|
||
is ongoing. */
|
||
while (HAL_UART_GetState(&UartHandle) != HAL_UART_STATE_READY)
|
||
{
|
||
}
|
||
|
||
/*##-5- Send the received Buffer ###########################################*/
|
||
if (HAL_UART_Transmit_DMA(&UartHandle, (uint8_t *)aRxBuffer, RXBUFFERSIZE) != HAL_OK)
|
||
{
|
||
/* Transfer error in transmission process */
|
||
Error_Handler();
|
||
}
|
||
|
||
/*##-6- Wait for the end of the transfer ###################################*/
|
||
/* Before starting a new communication transfer, you need to check the current
|
||
state of the peripheral; if it<69>s busy you need to wait for the end of current
|
||
transfer before starting a new one.
|
||
For simplicity reasons, this example is just waiting till the end of the
|
||
transfer, but application may perform other tasks while transfer operation
|
||
is ongoing. */
|
||
while (HAL_UART_GetState(&UartHandle) != HAL_UART_STATE_READY)
|
||
{
|
||
}
|
||
|
||
/*##-7- Send the End Message ###############################################*/
|
||
if(HAL_UART_Transmit_DMA(&UartHandle, (uint8_t*)aTxEndMessage, TXENDMESSAGESIZE)!= HAL_OK)
|
||
{
|
||
/* Transfer error in transmission process */
|
||
Error_Handler();
|
||
}
|
||
|
||
/*##-8- Wait for the end of the transfer ###################################*/
|
||
while (HAL_UART_GetState(&UartHandle) != HAL_UART_STATE_READY)
|
||
{
|
||
}
|
||
|
||
/* Infinite loop */
|
||
while (1)
|
||
{
|
||
}
|
||
}
|
||
|
||
/**
|
||
* @brief System Clock Configuration
|
||
* The system Clock is configured as follow :
|
||
* System Clock source = PLL (HSI)
|
||
* SYSCLK(Hz) = 48000000
|
||
* HCLK(Hz) = 48000000
|
||
* AHB Prescaler = 1
|
||
* APB1 Prescaler = 1
|
||
* HSI Frequency(Hz) = 8000000
|
||
* PREDIV = 1
|
||
* PLLMUL = 6
|
||
* Flash Latency(WS) = 1
|
||
* @param None
|
||
* @retval None
|
||
*/
|
||
void SystemClock_Config(void)
|
||
{
|
||
RCC_ClkInitTypeDef RCC_ClkInitStruct;
|
||
RCC_OscInitTypeDef RCC_OscInitStruct;
|
||
|
||
/* No HSE Oscillator on Nucleo, Activate PLL with HSI as source */
|
||
RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_NONE;
|
||
RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
|
||
RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSI;
|
||
RCC_OscInitStruct.PLL.PREDIV = RCC_PREDIV_DIV1;
|
||
RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL6;
|
||
if (HAL_RCC_OscConfig(&RCC_OscInitStruct)!= HAL_OK)
|
||
{
|
||
/* Initialization Error */
|
||
while(1);
|
||
}
|
||
|
||
/* Select PLL as system clock source and configure the HCLK, PCLK1 clocks dividers */
|
||
RCC_ClkInitStruct.ClockType = (RCC_CLOCKTYPE_SYSCLK | RCC_CLOCKTYPE_HCLK | RCC_CLOCKTYPE_PCLK1);
|
||
RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;
|
||
RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1;
|
||
RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV1;
|
||
if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_1)!= HAL_OK)
|
||
{
|
||
/* Initialization Error */
|
||
while(1);
|
||
}
|
||
}
|
||
|
||
|
||
/**
|
||
* @brief This function is executed in case of error occurrence.
|
||
* @param None
|
||
* @retval None
|
||
*/
|
||
static void Error_Handler(void)
|
||
{
|
||
/* Toogle LED3 for error */
|
||
while(1)
|
||
{
|
||
BSP_LED_Toggle(LED3);
|
||
HAL_Delay(1000);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* @brief Tx Transfer completed callback
|
||
* @param huart: UART handle.
|
||
* @note This example shows a simple way to report end of DMA Tx transfer, and
|
||
* you can add your own implementation.
|
||
* @retval None
|
||
*/
|
||
void HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart)
|
||
{
|
||
/* Toogle LED3 : Transfer in transmission process is correct */
|
||
BSP_LED_On(LED3);
|
||
}
|
||
|
||
/**
|
||
* @brief Rx Transfer completed callback
|
||
* @param huart: UART handle
|
||
* @note This example shows a simple way to report end of DMA Rx transfer, and
|
||
* you can add your own implementation.
|
||
* @retval None
|
||
*/
|
||
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart)
|
||
{
|
||
/* Turn LED3 on: Transfer in reception process is correct */
|
||
BSP_LED_On(LED3);
|
||
}
|
||
|
||
/**
|
||
* @brief UART error callbacks
|
||
* @param huart: UART handle
|
||
* @note This example shows a simple way to report transfer error, and you can
|
||
* add your own implementation.
|
||
* @retval None
|
||
*/
|
||
void HAL_UART_ErrorCallback(UART_HandleTypeDef *huart)
|
||
{
|
||
/* Turn LED3 off: Transfer error in reception/transmission process */
|
||
BSP_LED_Off(LED3);
|
||
}
|
||
|
||
#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****/
|