stm8s_uart2.c

STM8全部资料

/**
  ********************************************************************************
  * @file stm8s_uart2.c
  * @brief This file contains all the functions for the UART2 peripheral.
  * @author STMicroelectronics - MCD Application Team
  * @version V1.0.1
  * @date 09/22/2008
  ******************************************************************************
  *
  * THE PRESENT FIRMWARE WHICH IS FOR GUIDANCE ONLY AIMS AT PROVIDING CUSTOMERS
  * WITH CODING INFORMATION REGARDING THEIR PRODUCTS IN ORDER FOR THEM TO SAVE
  * TIME. AS A RESULT, STMICROELECTRONICS SHALL NOT BE HELD LIABLE FOR ANY
  * DIRECT, INDIRECT OR CONSEQUENTIAL DAMAGES WITH RESPECT TO ANY CLAIMS ARISING
  * FROM THE CONTENT OF SUCH FIRMWARE AND/OR THE USE MADE BY CUSTOMERS OF THE
  * CODING INFORMATION CONTAINED HEREIN IN CONNECTION WITH THEIR PRODUCTS.
  *
  * <h2><center>&copy; COPYRIGHT 2008 STMicroelectronics</center></h2>
  * @image html logo.bmp
  ******************************************************************************
  */

/* Includes ------------------------------------------------------------------*/
#include "stm8s_uart2.h"
#include "stm8s_clk.h"

/* LINKER SECTIONS DEFINITION FOR THIS FILE ONLY */
#ifdef USE_COSMIC_SECTIONS
#pragma section (UART2_CODE)
#pragma section const {UART2_CONST}
#pragma section @near [UART2_URAM]
#pragma section @near {UART2_IRAM}
#pragma section @tiny [UART2_UZRAM]
#pragma section @tiny {UART2_IZRAM}
#endif

/* Private typedef -----------------------------------------------------------*/
/* Private define ------------------------------------------------------------*/
/* Private macro -------------------------------------------------------------*/
/* Private variables ---------------------------------------------------------*/
/* Private function prototypes -----------------------------------------------*/
/* Private functions ---------------------------------------------------------*/
/* Public functions ----------------------------------------------------------*/

/** @}
  * @addtogroup UART2_Public_Functions
  * @{
  */

/**
  * @brief Deinitializes the UART2 peripheral.
  * @par Full description:
  * Set the UART2 peripheral registers to their default reset values.
  * @retval void None
  * @par Required preconditions:
  * None
  * @par Called functions:
  * None
  * @par Example:
  * Deinitialize UART2 peripheral.
  * @code
  * UART2_DeInit();
  * @endcode
  */

void UART2_DeInit(void)
{
  u8 dummy = 0;
  /*< Clear the Idle Line Detected bit in the status rerister by a read
     to the UART2_SR register followed by a Read to the UART2_DR register */
  dummy = UART2->SR;
  dummy = UART2->DR;

  UART2->BRR2 = UART2_BRR2_RESET_VALUE;  /*< Set UART2_BRR2 to reset value 0x00 */
  UART2->BRR1 = UART2_BRR1_RESET_VALUE;  /*< Set UART2_BRR1 to reset value 0x00 */

  UART2->CR1 = UART2_CR1_RESET_VALUE; /*< Set UART2_CR1 to reset value 0x00  */
  UART2->CR2 = UART2_CR2_RESET_VALUE; /*< Set UART2_CR2 to reset value 0x00  */
  UART2->CR3 = UART2_CR3_RESET_VALUE;  /*< Set UART2_CR3 to reset value 0x00  */
  UART2->CR4 = UART2_CR4_RESET_VALUE;  /*< Set UART2_CR4 to reset value 0x00  */
  UART2->CR5 = UART2_CR5_RESET_VALUE; /*< Set UART2_CR5 to reset value 0x00  */
	UART2->CR6 = UART2_CR6_RESET_VALUE; /*< Set UART2_CR6 to reset value 0x00  */

}

/**
 * @brief Initializes the UART2 according to the specified parameters.
  * @param[in] BaudRate: The baudrate.
 * @param[in] WordLength : This parameter can be any of the @ref UART2_WordLength_TypeDef enumeration.
  * @param[in] StopBits: This parameter can be any of the @ref UART2_StopBits_TypeDef enumeration.
  * @param[in] Parity: This parameter can be any of the @ref UART2_Parity_TypeDef enumeration.
  * @param[in] SyncMode: This parameter can be any of the @ref UART2_SyncMode_TypeDef values.
  * @param[in] Mode: This parameter can be any of the @ref UART2_Mode_TypeDef values
  * @retval void None
  * @par Required preconditions:
  * None
  * @par Called functions:
  * - CLK_GetClockFreq().
  * @par Example:
  * @code
  * UART2_Init(9600, UART2_WORDLENGTH_8D, UART2_STOPBITS_1, UART2_PARITY_NO, UART2_SYNCMODE_CLOCK_DISABLE, UART2_MODE_TXRX_ENABLE);
  * @endcode
  */
void UART2_Init(u32 BaudRate, UART2_WordLength_TypeDef WordLength, UART2_StopBits_TypeDef StopBits, UART2_Parity_TypeDef Parity, UART2_SyncMode_TypeDef SyncMode, UART2_Mode_TypeDef Mode)
{
	u8 BRR2_1, BRR2_2 = 0;
	u32 BaudRate_Mantissa, BaudRate_Mantissa100 = 0;

  /* assert_param: BaudRate value should be <= 625000 bps */
  assert_param(IS_UART2_BAUDRATE_OK(BaudRate));

  assert_param(IS_UART2_WORDLENGTH_OK(WordLength));

  assert_param(IS_UART2_STOPBITS_OK(StopBits));

  assert_param(IS_UART2_PARITY_OK(Parity));

  /* assert_param: UART2_Mode value should exclude values such as  UART2_ModeTx_Enable|UART2_ModeTx_Disable */
  assert_param(IS_UART2_MODE_OK((u8)Mode));

  /* assert_param: UART2_SyncMode value should exclude values such as
     UART2_CLOCK_ENABLE|UART2_CLOCK_DISABLE */
  assert_param(IS_UART2_SYNCMODE_OK((u8)SyncMode));

  UART2->CR1 &= (u8)(~UART2_CR1_M);  /**< Clear the word length bit */
  UART2->CR1 |= (u8)WordLength; /**< Set the word length bit according to UART2_WordLength value */

  UART2->CR3 &= (u8)(~UART2_CR3_STOP);  /**< Clear the STOP bits */
  UART2->CR3 |= (u8)StopBits;  /**< Set the STOP bits number according to UART2_StopBits value  */

  UART2->CR1 &= (u8)(~(UART2_CR1_PCEN | UART2_CR1_PS  ));  /**< Clear the Parity Control bit */
  UART2->CR1 |= (u8)Parity;  /**< Set the Parity Control bit to UART2_Parity value */

  UART2->BRR1 &= (u8)(~UART2_BRR1_DIVM);  /**< Clear the LSB mantissa of UARTDIV  */
  UART2->BRR2 &= (u8)(~UART2_BRR2_DIVM);  /**< Clear the MSB mantissa of UARTDIV  */
  UART2->BRR2 &= (u8)(~UART2_BRR2_DIVF);  /**< Clear the Fraction bits of UARTDIV */

  /**< Set the UART2 BaudRates in BRR1 and BRR2 registers according to UART2_BaudRate value */
  BaudRate_Mantissa    = ((u32)CLK_GetClockFreq() / (BaudRate << 4));
  BaudRate_Mantissa100 = (((u32)CLK_GetClockFreq() * 100) / (BaudRate << 4));
  /**< The fraction and MSB mantissa should be loaded in one step in the BRR2 register*/ 
  BRR2_1 = (u8)((u8)(((BaudRate_Mantissa100 - (BaudRate_Mantissa * 100))
                      << 4) / 100) & (u8)0x0F); /**< Set the fraction of UARTDIV  */
  BRR2_2 = (u8)((BaudRate_Mantissa >> 4) & (u8)0xF0);

  UART2->BRR2 = (u8)(BRR2_1 | BRR2_2);
  UART2->BRR1 = (u8)BaudRate_Mantissa;           /**< Set the LSB mantissa of UARTDIV  */

  UART2->CR2 &= (u8)~(UART2_CR2_TEN | UART2_CR2_REN); /**< Disable the Transmitter and Receiver before seting the LBCL, CPOL and CPHA bits */
  UART2->CR3 &= (u8)~(UART2_CR3_CPOL | UART2_CR3_CPHA | UART2_CR3_LBCL); /**< Clear the Clock Polarity, lock Phase, Last Bit Clock pulse */
  UART2->CR3 |= (u8)((u8)SyncMode & (u8)(UART2_CR3_CPOL | UART2_CR3_CPHA | UART2_CR3_LBCL));  /**< Set the Clock Polarity, lock Phase, Last Bit Clock pulse */

  if ((u8)Mode & (u8)UART2_MODE_TX_ENABLE)
  {
    UART2->CR2 |= (u8)UART2_CR2_TEN;  /**< Set the Transmitter Enable bit */
  }
  else
  {
    UART2->CR2 &= (u8)(~UART2_CR2_TEN);  /**< Clear the Transmitter Disable bit */
  }
  if ((u8)Mode & (u8)UART2_MODE_RX_ENABLE)
  {
    UART2->CR2 |= (u8)UART2_CR2_REN;  /**< Set the Receiver Enable bit */
  }
  else
  {
    UART2->CR2 &= (u8)(~UART2_CR2_REN);  /**< Clear the Receiver Disable bit */
  }
  /**< Set the Clock Enable bit, lock Polarity, lock Phase and Last Bit Clock pulse bits according to UART2_Mode value */
  if ((u8)SyncMode&(u8)UART2_SYNCMODE_CLOCK_DISABLE)
  {
    UART2->CR3 &= (u8)(~UART2_CR3_CKEN); /**< Clear the Clock Enable bit */
    /**< configure in Push Pull or Open Drain mode the Tx I/O line by setting the correct I/O Port register according the product package and line configuration*/
  }
  else
  {
    UART2->CR3 |= (u8)((u8)SyncMode & UART2_CR3_CKEN);
  }
}
/**
  * @brief Enable the UART2 peripheral.
  * @par Full description:
  * Enable the UART2 peripheral.
  * @param[in] NewState new state of the UART2 Communication.
  * This parameter can be:
  * - ENABLE
  * - DISABLE
  * @retval void None
  * @par Required preconditions:
  * None
  * @par Called functions:
  * None
  * @par Example:
  * Enable UART2 peripheral.
  * @code
  * UART2_Cmd(ENABLE);
  * @endcode
  */
void UART2_Cmd(FunctionalState NewState)
{

  if (NewState != DISABLE)
  {
    UART2->CR1 &= (u8)(~UART2_CR1_UARTD); /**< UART2 Enable */
  }
  else
  {
    UART2->CR1 |= UART2_CR1_UARTD;  /**< UART2 Disable (for low power consumption) */
  }
}

/**
 * @brief Enables or disables the specified UART2 interrupts.
 * @par Full description:
 * Enables or disables the specified UART2 interrupts.
 * @param[in] UART2_IT specifies the UART2 interrupt sources to be enabled or disabled.
 * This parameter can be one of the following values:
 *   - UART2_IT_LBDF:  LIN Break detection interrupt
 *   - UART2_IT_LHDF:  LIN Break detection interrupt
 *   - UART2_IT_TXE:  Tansmit Data Register empty interrupt
 *   - UART2_IT_TC:   Transmission complete interrupt
 *   - UART2_IT_RXNE_OR: Receive Data register not empty/Over run error interrupt
 *   - UART2_IT_IDLE: Idle line detection interrupt
 *   - UART2_IT_PE:   Parity Error interrupt
 * @param[in] NewState new state of the specified UART2 interrupts.
 * This parameter can be: ENABLE or DISABLE.
 * @retval void None
 * @par Required preconditions:
 * None
 * @par Called functions:
 * None
 * @par Example:
 * @code
 * UART2_ITConfig(UART2_IT_PE, ENABLE)
 * @endcode
 */
void UART2_ITConfig(UART2_IT_TypeDef UART2_IT, FunctionalState NewState)
{
  u8 uartreg, itpos = 0x00;
  assert_param(IS_UART2_CONFIG_IT_OK(UART2_IT));
  assert_param(IS_FUNCTIONALSTATE_OK(NewState));

  /* Get the UART2 register index */
  uartreg = (u8)(UART2_IT >> 0x08);

  /* Get the UART2 IT index */
  itpos = (u8)((u8)1 << (u8)((u8)UART2_IT & (u8)0x0F));

  if (NewState != DISABLE)
  {
    /**< Enable the Interrupt bits according to UART2_IT mask */
    if (uartreg == 0x01)
    {
      UART2->CR1 |= itpos;
    }
    else if (uartreg == 0x02)
    {
      UART2->CR2 |= itpos;
    }
    else if (uartreg == 0x03)
    {
      UART2->CR4 |= itpos;
    }
    else
    {
      UART2->CR6 |= itpos;
    }
  }
  else
  {
    /**< Disable the interrupt bits according to UART2_IT mask */
    if (uartreg == 0x01)
    {
      UART2->CR1 &= (u8)(~itpos);
    }
    else if (uartreg == 0x02)
    {
      UART2->CR2 &= (u8)(~itpos);
    }
    else if (uartreg == 0x03)
    {
      UART2->CR4 &= (u8)(~itpos);
    }
    else
    {
      UART2->CR6 &= (u8)(~itpos);
    }
  }
}
/**
  * @brief Configures the UART2抯 IrDA interface.
  * @par Full description:
  * Configures the UART2抯 IrDA interface.
  * @par This function is valid only for UART2.
  * @param[in] UART2_IrDAMode specifies the IrDA mode.
  * This parameter can be any of the @ref UART2_IrDAMode_TypeDef values.
  * @retval void None
  * @par Required preconditions:
  * None
  * @par Called functions:
  * None
  * @par Example:
  * @code
  * UART2_IrDAConfig(UART2_IRDAMODE_LOWPOWER)
  * @endcode
  */
void UART2_IrDAConfig(UART2_IrDAMode_TypeDef UART2_IrDAMode)
{
  assert_param(IS_UART2_IRDAMODE_OK(UART2_IrDAMode));

  if (UART2_IrDAMode != UART2_IRDAMODE_NORMAL)
  {
    UART2->CR5 |= UART2_CR5_IRLP;
  }
  else
  {
    UART2->CR5 &= ((u8)~UART2_CR5_IRLP);
  }
}

/**
  * @brief Enables or disables the UART2抯 IrDA interface.
  * @par Full description:
  * Enables or disables the UART2抯 IrDA interface.
  * @par This function is related to IrDA mode.
  * @param[in] NewState new state of the IrDA mode.
  *                    This parameter can be: ENABLE or DISABLE.
  * @retval void None
  * @par Required preconditions:
  * None
  * @par Called functions:
  * None
  * @par Example:
  * @code
  * UART2_IrDACmd(ENABLE)
  * @endcode
  */
void UART2_IrDACmd(FunctionalState NewState)
{

  /* Check parameters */
  assert_param(IS_FUNCTIONALSTATE_OK(NewState));

  if (NewState != DISABLE)
  {
    /* Enable the IrDA mode by setting the IREN bit in the CR3 register */
    UART2->CR5 |= UART2_CR5_IREN;
  }
  else
  {
    /* Disable the IrDA mode by clearing the IREN bit in the CR3 register */
    UART2->CR5 &= ((u8)~UART2_CR5_IREN);
  }
}

/**
  * @brief Sets the UART2 LIN Break detection length.
  * @par Full description:
  * Sets the UART2 LIN Break detection length.
  * @param[in] UART2_LINBreakDetectionLength specifies the LIN break detection length.
  * This parameter can be any of the @ref UART2_LINBreakDetectionLength_TypeDef values.
  * @retval void None
  * @par Required preconditions:
  * None
  * @par Called functions:
  * None
  * @par Example:
  * @code
  * UART2_LINBreakDetectionConfig(UART2_LINBREAKDETECTIONLENGTH_11BITS)
  * @endcode
  */
void UART2_LINBreakDetectionConfig(UART2_LINBreakDetectionLength_TypeDef UART2_LINBreakDetectionLength)
{
  assert_param(IS_UART2_LINBREAKDETECTIONLENGTH_OK(UART2_LINBreakDetectionLength));