注册 登录
21ic电子技术开发论坛 返回首页

FSL_FAE_ConstYu的个人空间 https://bbs.21ic.com/?1105562 [收藏] [复制] [RSS]

日志

Kinetis UART 驱动分析

已有 2149 次阅读2014-10-4 10:34 |个人分类:Kinetis SDK|系统分类:ARM

       
  1. /*FUNCTION**********************************************************************
  2.  *
  3.  * Function Name : UART_DRV_Init
  4.  * Description   : This function initializes a UART instance for operation.
  5.  * This function will initialize the run-time state structure to keep track of the on-going
  6.  * transfers, ungate the clock to the UART module, initialize the module
  7.  * to user defined settings and default settings, configure the IRQ state structure and enable
  8.  * the module-level interrupt to the core, and enable the UART module transmitter and receiver.
  9.  * The following is an example of how to set up the uart_state_t and the
  10.  * uart_user_config_t parameters and how to call the UART_DRV_Init function by passing
  11.  * in these parameters:
  12.  *    uart_user_config_t uartConfig;
  13.  *    uartConfig.baudRate = 9600;
  14.  *    uartConfig.bitCountPerChar = kUart8BitsPerChar;
  15.  *    uartConfig.parityMode = kUartParityDisabled;
  16.  *    uartConfig.stopBitCount = kUartOneStopBit;
  17.  *    uart_state_t uartState;
  18.  *    UART_DRV_Init(instance, &uartState, &uartConfig);
  19.  *
  20.  *END**************************************************************************/
  21. uart_status_t UART_DRV_Init(uint32_t instance, uart_state_t * uartStatePtr,
  22.                             const uart_user_config_t * uartUserConfig)
  23. {
  24.     assert(uartStatePtr && uartUserConfig);
  25.     assert(instance < HW_UART_INSTANCE_COUNT);

  27.     uint32_t baseAddr = g_uartBaseAddr[instance];
  28.     uint32_t uartSourceClock;

  30.     /* Exit if current instance is already initialized. */
  31.     if (g_uartStatePtr[instance])
  32.     {
  33.         return kStatus_UART_Initialized;
  34.     }

  36.     /* Clear the state structure for this instance. */
  37.     memset(uartStatePtr, 0, sizeof(uart_state_t));

  39.     /* Save runtime structure pointer.*/
  40.     g_uartStatePtr[instance] = uartStatePtr;

  42.     /* Un-gate UART module clock */
  43.     CLOCK_SYS_EnableUartClock(instance);

  45.     /* Initialize UART to a known state. */
  46.     UART_HAL_Init(baseAddr);

  48.     /* Create Semaphore for txIrq and rxIrq. */
  49.     OSA_SemaCreate(&uartStatePtr->txIrqSync, 0);
  50.     OSA_SemaCreate(&uartStatePtr->rxIrqSync, 0);

  52.     /* UART clock source is either system clock or bus clock depending on the instance */
  53.     uartSourceClock = CLOCK_SYS_GetUartFreq(instance);

  55.     /* Initialize UART baud rate, bit count, parity and stop bit. */
  56.     UART_HAL_SetBaudRate(baseAddr, uartSourceClock, uartUserConfig->baudRate);
  57.     UART_HAL_SetBitCountPerChar(baseAddr, uartUserConfig->bitCountPerChar);
  58.     UART_HAL_SetParityMode(baseAddr, uartUserConfig->parityMode);
  59. #if FSL_FEATURE_UART_HAS_STOP_BIT_CONFIG_SUPPORT
  60.     UART_HAL_SetStopBitCount(baseAddr, uartUserConfig->stopBitCount);
  61. #endif

  63. #if FSL_FEATURE_UART_HAS_FIFO
  64.     uint8_t fifoSize;
  65.     /* Obtain raw TX FIFO size bit setting */
  66.     fifoSize = UART_HAL_GetTxFifoSize(baseAddr);
  67.     /* Now calculate the number of data words per given FIFO size */
  68.     uartStatePtr->txFifoEntryCount = (fifoSize == 0 ? 1 : 0x1 << (fifoSize + 1));

  70.     /* Configure the TX FIFO watermark to be 1/2 of the total entry or 0 if entry count = 1
  71.      * A watermark setting of 0 for TX FIFO entry count of 1 means that TDRE will only interrupt
  72.      * when the TX buffer (the one entry in the TX FIFO) is empty. Otherwise, if we set the
  73.      * watermark to 1, the TDRE will always be set regardless if the TX buffer was empty or not
  74.      * as the spec says TDRE will set when the FIFO is at or below the configured watermark. */
  75.     if (uartStatePtr->txFifoEntryCount > 1)
  76.     {
  77.         UART_HAL_SetTxFifoWatermark(baseAddr, (uartStatePtr->txFifoEntryCount >> 1U));
  78.     }
  79.     else
  80.     {
  81.         UART_HAL_SetTxFifoWatermark(baseAddr, 0);
  82.     }

  84.     /* Configure the RX FIFO watermark to be 1. 
  85.      * Note about RX FIFO support: There is only one RX data full interrupt that is
  86.      * associated with the RX FIFO Watermark.  The watermark cannot be dynamically changed.
  87.      * This means if the rxSize is less than the programmed watermark the interrupt will 
  88.      * never occur. If we try to change the watermark, this will involve shutting down
  89.      * the receiver first - which is not a desirable operation when the UART is actively
  90.      * receiving data. Hence, the best solution is to set the RX FIFO watermark to 1. */
  91.     UART_HAL_SetRxFifoWatermark(baseAddr, 1);

  93.     /* Enable and flush the FIFO prior to enabling the TX/RX */
  94.     UART_HAL_SetTxFifoCmd(baseAddr, true);
  95.     UART_HAL_SetRxFifoCmd(baseAddr, true);
  96.     UART_HAL_FlushTxFifo(baseAddr);
  97.     UART_HAL_FlushRxFifo(baseAddr);
  98. #else
  99.     /* For modules that do not support a FIFO, they have a data buffer that essentially
  100.      * acts likes a one-entry FIFO, thus to make the code cleaner, we'll
  101.      * equate txFifoEntryCount to 1.  Also note that TDRE flag will set only when the tx
  102.      * buffer is empty. */
  103.     uartStatePtr->txFifoEntryCount = 1;
  104. #endif

  106.     /* Enable UART interrupt on NVIC level. */
  107.     INT_SYS_EnableIRQ(g_uartRxTxIrqId[instance]);

  109.     /* Finally, enable the UART transmitter and receiver*/
  110.     UART_HAL_EnableTransmitter(baseAddr);
  111.     UART_HAL_EnableReceiver(baseAddr);

  113.     return kStatus_UART_Success;
  114. }
复制代码


路过
鸡蛋
鲜花
握手
雷人
收藏 邀请 举报

全部作者的其他最新日志

评论 (0 个评论)