text: /**
    ******************************************************************************
    * @file    Examples_LL/USART/USART_Communication_Tx/Inc/main.h
    * @author  MCD Application Team
    * @brief   Header for main.c module
    ******************************************************************************
    * @attention
    *
    * <h2><center>&copy; COPYRIGHT(c) 2017 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.
    *
    ******************************************************************************
    */
  
  /* Define to prevent recursive inclusion -------------------------------------*/
  #ifndef __MAIN_H
  #define __MAIN_H
  
  /* Includes ------------------------------------------------------------------*/
  #include "stm32l4xx_ll_bus.h"
  #include "stm32l4xx_ll_rcc.h"
  #include "stm32l4xx_ll_system.h"
  #include "stm32l4xx_ll_utils.h"
  #include "stm32l4xx_ll_cortex.h"
  #include "stm32l4xx_ll_gpio.h"
  #include "stm32l4xx_ll_exti.h"
  #include "stm32l4xx_ll_usart.h"
  #include "stm32l4xx_ll_pwr.h"
  #if defined(USE_FULL_ASSERT)
  #include "stm32_assert.h"
  #endif /* USE_FULL_ASSERT */
  
  /* Exported types ------------------------------------------------------------*/
  /* Exported constants --------------------------------------------------------*/
  #define APP_ERROR_NONE    0
  #define APP_ERROR_TIMEOUT 1
  
  /* Define used to enable time-out management*/
  #define USE_TIMEOUT       0
  
  /* Define used to enable Virtual Com Port use : 
       USE_VCP_CONNECTION == 0
         USART1 instance is used. (TX on PA.09, RX on PA.10)
         (requires wiring USART1 TX/Rx Pins to PC connection (could be achieved thanks to a USB to UART adapter)
       USE_VCP_CONNECTION == 1
         USART2 instance is used. (TX on PA.02, RX on PA.03)
         (please ensure that USART communication between the target MCU and ST-LINK MCU is properly enabled 
         on HW board in order to support Virtual Com Port)
  */
  #define USE_VCP_CONNECTION       1
  
  /* Private definitions covering GPIO clock and USART pins 
     depending on selected USART instance. */
  #if (USE_VCP_CONNECTION == 0) 
  
  /* USART1 instance is used. (TX on PA.09, RX on PA.10)
     (requires wiring USART1 TX/Rx Pins to USB to UART adapter) */
  #define USARTx_INSTANCE               USART1
  #define USARTx_CLK_ENABLE()           LL_APB2_GRP1_EnableClock(LL_APB2_GRP1_PERIPH_USART1)
  #define USARTx_CLK_SOURCE()           LL_RCC_SetUSARTClockSource(LL_RCC_USART1_CLKSOURCE_PCLK2)
  
  #define USARTx_GPIO_CLK_ENABLE()      LL_AHB2_GRP1_EnableClock(LL_AHB2_GRP1_PERIPH_GPIOA)   /* Enable the peripheral clock of GPIOA */
  #define USARTx_TX_PIN                 LL_GPIO_PIN_9
  #define USARTx_TX_GPIO_PORT           GPIOA
  #define USARTx_SET_TX_GPIO_AF()       LL_GPIO_SetAFPin_8_15(GPIOA, LL_GPIO_PIN_9, LL_GPIO_AF_7)
  #define USARTx_RX_PIN                 LL_GPIO_PIN_10
  #define USARTx_RX_GPIO_PORT           GPIOA
  #define USARTx_SET_RX_GPIO_AF()       LL_GPIO_SetAFPin_8_15(GPIOA, LL_GPIO_PIN_10, LL_GPIO_AF_7)
  
  #else
      
  /* USART2 instance is used. (TX on PA.02, RX on PA.03)
     (please ensure that USART communication between the target MCU and ST-LINK MCU is properly enabled 
      on HW board in order to support Virtual Com Port) */
  #define USARTx_INSTANCE               USART2
  #define USARTx_CLK_ENABLE()           LL_APB1_GRP1_EnableClock(LL_APB1_GRP1_PERIPH_USART2)
  #define USARTx_CLK_SOURCE()           LL_RCC_SetUSARTClockSource(LL_RCC_USART2_CLKSOURCE_PCLK1)
  
  #define USARTx_GPIO_CLK_ENABLE()      LL_AHB2_GRP1_EnableClock(LL_AHB2_GRP1_PERIPH_GPIOA)   /* Enable the peripheral clock of GPIOA */
  #define USARTx_TX_PIN                 LL_GPIO_PIN_2
  #define USARTx_TX_GPIO_PORT           GPIOA
  #define USARTx_SET_TX_GPIO_AF()       LL_GPIO_SetAFPin_0_7(GPIOA, LL_GPIO_PIN_2, LL_GPIO_AF_7)
  #define USARTx_RX_PIN                 LL_GPIO_PIN_3
  #define USARTx_RX_GPIO_PORT           GPIOA
  #define USARTx_SET_RX_GPIO_AF()       LL_GPIO_SetAFPin_0_7(GPIOA, LL_GPIO_PIN_3, LL_GPIO_AF_7)
  
  #endif /* (USE_VCP_CONNECTION == 0) */
  
  /**
    * @brief LED2 
    */
  
  #define LED2_PIN                           LL_GPIO_PIN_5
  #define LED2_GPIO_PORT                     GPIOA
  #define LED2_GPIO_CLK_ENABLE()             LL_AHB2_GRP1_EnableClock(LL_AHB2_GRP1_PERIPH_GPIOA)
  
  /**
    * @brief Toggle periods for various blinking modes
    */
  
  #define LED_BLINK_FAST  200
  #define LED_BLINK_SLOW  500
  #define LED_BLINK_ERROR 1000
  
  
  /**
    * @brief Key push-button
    */
  #define USER_BUTTON_PIN                         LL_GPIO_PIN_13
  #define USER_BUTTON_GPIO_PORT                   GPIOC
  #define USER_BUTTON_GPIO_CLK_ENABLE()           LL_AHB2_GRP1_EnableClock(LL_AHB2_GRP1_PERIPH_GPIOC)   
  #define USER_BUTTON_EXTI_LINE                   LL_EXTI_LINE_13
  #define USER_BUTTON_EXTI_IRQn                   EXTI15_10_IRQn
  #define USER_BUTTON_EXTI_LINE_ENABLE()          LL_EXTI_EnableIT_0_31(USER_BUTTON_EXTI_LINE)   
  #define USER_BUTTON_EXTI_FALLING_TRIG_ENABLE()  LL_EXTI_EnableFallingTrig_0_31(USER_BUTTON_EXTI_LINE)   
  #define USER_BUTTON_SYSCFG_SET_EXTI()           do {                                                                     \
                                                    LL_APB2_GRP1_EnableClock(LL_APB2_GRP1_PERIPH_SYSCFG);                  \
                                                    LL_SYSCFG_SetEXTISource(LL_SYSCFG_EXTI_PORTC, LL_SYSCFG_EXTI_LINE13);  \
                                                  } while(0)
  #define USER_BUTTON_IRQHANDLER                  EXTI15_10_IRQHandler
  
  /* Exported macro ------------------------------------------------------------*/
  
  /* Exported functions ------------------------------------------------------- */
  /* IRQ Handler treatment functions */
  void UserButton_Callback(void); 
  
  #endif /* __MAIN_H */
  
  /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
  