2128 lines
132 KiB
HTML
2128 lines
132 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
|
|
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
|
|
<meta name="generator" content="Doxygen 1.8.6"/>
|
|
<title>Kinetis SDK v.2.0 API Reference Manual: UART Driver</title>
|
|
<link href="tabs.css" rel="stylesheet" type="text/css"/>
|
|
<script type="text/javascript" src="jquery.js"></script>
|
|
<script type="text/javascript" src="dynsections.js"></script>
|
|
<link href="navtree.css" rel="stylesheet" type="text/css"/>
|
|
<script type="text/javascript" src="resize.js"></script>
|
|
<script type="text/javascript" src="navtree.js"></script>
|
|
<script type="text/javascript">
|
|
$(document).ready(initResizable);
|
|
$(window).load(resizeHeight);
|
|
</script>
|
|
<link href="search/search.css" rel="stylesheet" type="text/css"/>
|
|
<script type="text/javascript" src="search/search.js"></script>
|
|
<script type="text/javascript">
|
|
$(document).ready(function() { searchBox.OnSelectItem(0); });
|
|
</script>
|
|
<link href="doxygen.css" rel="stylesheet" type="text/css" />
|
|
<link href="customdoxygen.css" rel="stylesheet" type="text/css"/>
|
|
</head>
|
|
<body>
|
|
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
|
|
<div id="titlearea">
|
|
<table cellspacing="0" cellpadding="0">
|
|
<tbody>
|
|
<tr style="height: 56px;">
|
|
<td id="projectlogo"><img alt="Logo" src="fs_logo.gif"/></td>
|
|
<td style="padding-left: 0.5em;">
|
|
<div id="projectname">Kinetis SDK v.2.0 API Reference Manual
|
|
 <span id="projectnumber">Rev. 0</span>
|
|
</div>
|
|
<div id="projectbrief">Freescale Semiconductor, Inc.</div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<!-- end header part -->
|
|
<!-- Generated by Doxygen 1.8.6 -->
|
|
<script type="text/javascript">
|
|
var searchBox = new SearchBox("searchBox", "search",false,'Search');
|
|
</script>
|
|
<div id="navrow1" class="tabs">
|
|
<ul class="tablist">
|
|
<li><a href="index.html"><span>Main Page</span></a></li>
|
|
<li><a href="pages.html"><span>Related Pages</span></a></li>
|
|
<li><a href="modules.html"><span>API Reference</span></a></li>
|
|
<li>
|
|
<div id="MSearchBox" class="MSearchBoxInactive">
|
|
<span class="left">
|
|
<img id="MSearchSelect" src="search/mag_sel.png"
|
|
onmouseover="return searchBox.OnSearchSelectShow()"
|
|
onmouseout="return searchBox.OnSearchSelectHide()"
|
|
alt=""/>
|
|
<input type="text" id="MSearchField" value="Search" accesskey="S"
|
|
onfocus="searchBox.OnSearchFieldFocus(true)"
|
|
onblur="searchBox.OnSearchFieldFocus(false)"
|
|
onkeyup="searchBox.OnSearchFieldChange(event)"/>
|
|
</span><span class="right">
|
|
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
|
|
</span>
|
|
</div>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div><!-- top -->
|
|
<div id="side-nav" class="ui-resizable side-nav-resizable">
|
|
<div id="nav-tree">
|
|
<div id="nav-tree-contents">
|
|
<div id="nav-sync" class="sync"></div>
|
|
</div>
|
|
</div>
|
|
<div id="splitbar" style="-moz-user-select:none;"
|
|
class="ui-resizable-handle">
|
|
</div>
|
|
</div>
|
|
<script type="text/javascript">
|
|
$(document).ready(function(){initNavTree('group__uart__driver.html','');});
|
|
</script>
|
|
<div id="doc-content">
|
|
<!-- window showing the filter options -->
|
|
<div id="MSearchSelectWindow"
|
|
onmouseover="return searchBox.OnSearchSelectShow()"
|
|
onmouseout="return searchBox.OnSearchSelectHide()"
|
|
onkeydown="return searchBox.OnSearchSelectKey(event)">
|
|
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark"> </span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark"> </span>Data Structures</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark"> </span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark"> </span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark"> </span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark"> </span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark"> </span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark"> </span>Groups</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark"> </span>Pages</a></div>
|
|
|
|
<!-- iframe showing the search results (closed by default) -->
|
|
<div id="MSearchResultsWindow">
|
|
<iframe src="javascript:void(0)" frameborder="0"
|
|
name="MSearchResults" id="MSearchResults">
|
|
</iframe>
|
|
</div>
|
|
|
|
<div class="header">
|
|
<div class="summary">
|
|
<a href="#groups">Modules</a> |
|
|
<a href="#files">Files</a> |
|
|
<a href="#nested-classes">Data Structures</a> |
|
|
<a href="#typedef-members">Typedefs</a> |
|
|
<a href="#enum-members">Enumerations</a> </div>
|
|
<div class="headertitle">
|
|
<div class="title">UART Driver<div class="ingroups"><a class="el" href="group__uart.html">UART: Universal Asynchronous Receiver/Transmitter Driver</a></div></div> </div>
|
|
</div><!--header-->
|
|
<div class="contents">
|
|
<a name="details" id="details"></a><h2 class="groupheader">Overview</h2>
|
|
<p>The KSDK provides a peripheral driver for the Universal Asynchronous Receiver/Transmitter (UART) module of Kinetis devices.</p>
|
|
<p>The UART driver includes two parts: functional APIs and transactional APIs.</p>
|
|
<p>Functional APIs are used for UART initialization/configuration/operation for optimization/customization purpose. Using the functional API requires the knowledge of the UART peripheral and know how to organize functional APIs to meet the application requirements. All functional API use the peripheral base address as the first parameter. UART functional operation groups provide the functional APIs set.</p>
|
|
<p>Transactional APIs can be used to enable the peripheral quickly and in the application if the code size and performance of transactional APIs can satisfy the requirements. If the code size and performance are critical requirements, see the transactional API implementation and write custom code. All transactional APIs use the uart_handle_t as the first parameter. Initialize the handle by calling the UART_CreateHandle() API.</p>
|
|
<p>Transactional APIs support asynchronous transfer, which means that the functions UART_SendNonBlocking() and UART_ReceiveNonBlocking() set up an interrupt for data transfer. When the transfer completes, the upper layer is notified through a callback function with the kStatus_UART_TxIdle and kStatus_UART_RxIdle.</p>
|
|
<p>Transactional receive APIs support the ring buffer. Prepare the memory for the ring buffer and pass in the start address and size while calling the UART_CreateHandle(). If passing NULL, the ring buffer feature is disabled. When the ring buffer is enabled, the received data is saved to the ring buffer in the background. The UART_ReceiveNonBlocking() function first gets data from the ring buffer. If the ring buffer does not have enough data, the function first returns the data in the ring buffer and then saves the received data to user memory. When all data is received, the upper layer is informed through a callback with the kStatus_UART_RxIdle.</p>
|
|
<p>If the receive ring buffer is full, the upper layer is informed through a callback with the kStatus_UART_RxRingBufferOverrun. In the callback function, the upper layer reads data out from the ring buffer. If not, the oldest data is overwritten by the new data.</p>
|
|
<p>The ring buffer size is specified when creating the handle. Note that one byte is reserved for the ring buffer maintenance. When creating handle using the following code:</p>
|
|
<div class="fragment"><div class="line">UART_CreateHandle(&handle, UART0, &ringBuffer, 32);</div>
|
|
</div><!-- fragment --><p>In this example, the buffer size is 32, but only 31 bytes are used for saving data.</p>
|
|
<h1><a class="anchor" id="UARTCase"></a>
|
|
Typical use case</h1>
|
|
<h2><a class="anchor" id="UARTCasePolling"></a>
|
|
UART Send/receive using a polling method</h2>
|
|
<div class="fragment"><div class="line">uint8_t ch;</div>
|
|
<div class="line"><a class="code" href="group__uart__driver.html#ga47c7c09e04a0497f4530d553e27d96c5">UART_GetDefaultConfig</a>(&user_config);</div>
|
|
<div class="line">user_config.baudRate_Bps = 115200U;</div>
|
|
<div class="line">user_config.enableTx = <span class="keyword">true</span>;</div>
|
|
<div class="line">user_config.enableRx = <span class="keyword">true</span>;</div>
|
|
<div class="line"></div>
|
|
<div class="line"><a class="code" href="group__uart__driver.html#gaa6162686a1aced16ff39c7d54d81fe5b">UART_Init</a>(UART1,&user_config,120000000U);</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="keywordflow">while</span>(1)</div>
|
|
<div class="line">{</div>
|
|
<div class="line"> UART_TransferReceiveBlocking(UART1, &ch, 1);</div>
|
|
<div class="line"> UART_TransferSendBlocking(UART1, &ch, 1);</div>
|
|
<div class="line">}</div>
|
|
</div><!-- fragment --><h2><a class="anchor" id="UARTCaseInterrupt"></a>
|
|
UART Send/receive using an interrupt method</h2>
|
|
<div class="fragment"><div class="line">uart_handle_t g_uartHandle;</div>
|
|
<div class="line"><a class="code" href="group__uart__driver.html#structuart__config__t">uart_config_t</a> user_config;</div>
|
|
<div class="line"><a class="code" href="group__uart__driver.html#structuart__transfer__t">uart_transfer_t</a> sendXfer;</div>
|
|
<div class="line"><a class="code" href="group__uart__driver.html#structuart__transfer__t">uart_transfer_t</a> receiveXfer;</div>
|
|
<div class="line"><span class="keyword">volatile</span> <span class="keywordtype">bool</span> txFinished;</div>
|
|
<div class="line"><span class="keyword">volatile</span> <span class="keywordtype">bool</span> rxFinished;</div>
|
|
<div class="line">uint8_t sendData[] = [<span class="charliteral">'H'</span>, <span class="charliteral">'e'</span>, <span class="charliteral">'l'</span>, <span class="charliteral">'l'</span>, <span class="charliteral">'o'</span>];</div>
|
|
<div class="line">uint8_t receiveData[32];</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="keywordtype">void</span> UART_UserCallback(uart_handle_t *handle, status_t status, <span class="keywordtype">void</span> *userData)</div>
|
|
<div class="line">{</div>
|
|
<div class="line"> userData = userData;</div>
|
|
<div class="line"></div>
|
|
<div class="line"> <span class="keywordflow">if</span> (<a class="code" href="group__uart__driver.html#ggacef40dc8e8ac174bfe40ebcbc980f84baf36c829b1b889517bf775c0d7ce29fa6">kStatus_UART_TxIdle</a> == status)</div>
|
|
<div class="line"> {</div>
|
|
<div class="line"> txFinished = <span class="keyword">true</span>;</div>
|
|
<div class="line"> }</div>
|
|
<div class="line"></div>
|
|
<div class="line"> <span class="keywordflow">if</span> (<a class="code" href="group__uart__driver.html#ggacef40dc8e8ac174bfe40ebcbc980f84bae0877b14627ed2aa8ddb2bf5b033f407">kStatus_UART_RxIdle</a> == status)</div>
|
|
<div class="line"> {</div>
|
|
<div class="line"> rxFinished = <span class="keyword">true</span>;</div>
|
|
<div class="line"> }</div>
|
|
<div class="line">}</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="keywordtype">void</span> main(<span class="keywordtype">void</span>)</div>
|
|
<div class="line">{</div>
|
|
<div class="line"> <span class="comment">//...</span></div>
|
|
<div class="line"></div>
|
|
<div class="line"> <a class="code" href="group__uart__driver.html#ga47c7c09e04a0497f4530d553e27d96c5">UART_GetDefaultConfig</a>(&user_config);</div>
|
|
<div class="line"> user_config.<a class="code" href="group__uart__driver.html#acc123668836f3432c54ee6a2f6f318f1">baudRate_Bps</a> = 115200U;</div>
|
|
<div class="line"> user_config.<a class="code" href="group__uart__driver.html#a91d575902455699a312c64b564133a8d">enableTx</a> = <span class="keyword">true</span>;</div>
|
|
<div class="line"> user_config.<a class="code" href="group__uart__driver.html#aa045acd340fc86d70a497f49e0a95bdd">enableRx</a> = <span class="keyword">true</span>;</div>
|
|
<div class="line"></div>
|
|
<div class="line"> <a class="code" href="group__uart__driver.html#gaa6162686a1aced16ff39c7d54d81fe5b">UART_Init</a>(UART1, &user_config, 120000000U);</div>
|
|
<div class="line"> UART_CreateHandle(&g_uartHandle, UART1, NULL, 0);</div>
|
|
<div class="line"> UART_SetTransferCallback(&g_uartHandle, UART_UserCallback, NULL);</div>
|
|
<div class="line"></div>
|
|
<div class="line"> <span class="comment">// Prepare to send.</span></div>
|
|
<div class="line"> sendXfer.<a class="code" href="group__uart__driver.html#af91f05b0f951836e3002f60f0575f369">data</a> = sendData</div>
|
|
<div class="line"> sendXfer.<a class="code" href="group__uart__driver.html#a21820f8294de0d75d863b72512a7c12f">dataSize</a> = <span class="keyword">sizeof</span>(sendData)/<span class="keyword">sizeof</span>(sendData[0]);</div>
|
|
<div class="line"> txFinished = <span class="keyword">false</span>;</div>
|
|
<div class="line"></div>
|
|
<div class="line"> <span class="comment">// Send out.</span></div>
|
|
<div class="line"> UART_SendNonBlocking(&g_uartHandle, &sendXfer);</div>
|
|
<div class="line"></div>
|
|
<div class="line"> <span class="comment">// Wait send finished.</span></div>
|
|
<div class="line"> <span class="keywordflow">while</span> (!txFinished)</div>
|
|
<div class="line"> {</div>
|
|
<div class="line"> }</div>
|
|
<div class="line"></div>
|
|
<div class="line"> <span class="comment">// Prepare to receive.</span></div>
|
|
<div class="line"> receiveXfer.<a class="code" href="group__uart__driver.html#af91f05b0f951836e3002f60f0575f369">data</a> = receiveData;</div>
|
|
<div class="line"> receiveXfer.<a class="code" href="group__uart__driver.html#a21820f8294de0d75d863b72512a7c12f">dataSize</a> = <span class="keyword">sizeof</span>(receiveData)/<span class="keyword">sizeof</span>(receiveData[0]);</div>
|
|
<div class="line"> rxFinished = <span class="keyword">false</span>;</div>
|
|
<div class="line"></div>
|
|
<div class="line"> <span class="comment">// Receive.</span></div>
|
|
<div class="line"> UART_ReceiveNonBlocking(&g_uartHandle, &receiveXfer, NULL);</div>
|
|
<div class="line"></div>
|
|
<div class="line"> <span class="comment">// Wait receive finished.</span></div>
|
|
<div class="line"> <span class="keywordflow">while</span> (!rxFinished)</div>
|
|
<div class="line"> {</div>
|
|
<div class="line"> }</div>
|
|
<div class="line"></div>
|
|
<div class="line"> <span class="comment">// ...</span></div>
|
|
<div class="line">}</div>
|
|
</div><!-- fragment --><h2><a class="anchor" id="UARTCaseRing"></a>
|
|
UART Receive using the ringbuffer feature</h2>
|
|
<div class="fragment"><div class="line"><span class="preprocessor">#define RING_BUFFER_SIZE 64</span></div>
|
|
<div class="line"><span class="preprocessor"></span><span class="preprocessor">#define RX_DATA_SIZE 32</span></div>
|
|
<div class="line"><span class="preprocessor"></span></div>
|
|
<div class="line">uart_handle_t g_uartHandle;</div>
|
|
<div class="line"><a class="code" href="group__uart__driver.html#structuart__config__t">uart_config_t</a> user_config;</div>
|
|
<div class="line"><a class="code" href="group__uart__driver.html#structuart__transfer__t">uart_transfer_t</a> sendXfer;</div>
|
|
<div class="line"><a class="code" href="group__uart__driver.html#structuart__transfer__t">uart_transfer_t</a> receiveXfer;</div>
|
|
<div class="line"><span class="keyword">volatile</span> <span class="keywordtype">bool</span> txFinished;</div>
|
|
<div class="line"><span class="keyword">volatile</span> <span class="keywordtype">bool</span> rxFinished;</div>
|
|
<div class="line">uint8_t receiveData[RX_DATA_SIZE];</div>
|
|
<div class="line">uint8_t ringBuffer[RING_BUFFER_SIZE];</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="keywordtype">void</span> UART_UserCallback(uart_handle_t *handle, status_t status, <span class="keywordtype">void</span> *userData)</div>
|
|
<div class="line">{</div>
|
|
<div class="line"> userData = userData;</div>
|
|
<div class="line"></div>
|
|
<div class="line"> <span class="keywordflow">if</span> (<a class="code" href="group__uart__driver.html#ggacef40dc8e8ac174bfe40ebcbc980f84bae0877b14627ed2aa8ddb2bf5b033f407">kStatus_UART_RxIdle</a> == status)</div>
|
|
<div class="line"> {</div>
|
|
<div class="line"> rxFinished = <span class="keyword">true</span>;</div>
|
|
<div class="line"> }</div>
|
|
<div class="line">}</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="keywordtype">void</span> main(<span class="keywordtype">void</span>)</div>
|
|
<div class="line">{</div>
|
|
<div class="line"> <span class="keywordtype">size_t</span> bytesRead;</div>
|
|
<div class="line"> <span class="comment">//...</span></div>
|
|
<div class="line"></div>
|
|
<div class="line"> <a class="code" href="group__uart__driver.html#ga47c7c09e04a0497f4530d553e27d96c5">UART_GetDefaultConfig</a>(&user_config);</div>
|
|
<div class="line"> user_config.<a class="code" href="group__uart__driver.html#acc123668836f3432c54ee6a2f6f318f1">baudRate_Bps</a> = 115200U;</div>
|
|
<div class="line"> user_config.<a class="code" href="group__uart__driver.html#a91d575902455699a312c64b564133a8d">enableTx</a> = <span class="keyword">true</span>;</div>
|
|
<div class="line"> user_config.<a class="code" href="group__uart__driver.html#aa045acd340fc86d70a497f49e0a95bdd">enableRx</a> = <span class="keyword">true</span>;</div>
|
|
<div class="line"></div>
|
|
<div class="line"> <a class="code" href="group__uart__driver.html#gaa6162686a1aced16ff39c7d54d81fe5b">UART_Init</a>(UART1, &user_config, 120000000U);</div>
|
|
<div class="line"> UART_CreateHandle(&g_uartHandle, UART1, &ringBuffer, RING_BUFFER_SIZE);</div>
|
|
<div class="line"> UART_SetTransferCallback(&g_uartHandle, UART_UserCallback, NULL);</div>
|
|
<div class="line"></div>
|
|
<div class="line"> <span class="comment">// Now the RX is working in background, receive in to ring buffer.</span></div>
|
|
<div class="line"></div>
|
|
<div class="line"> <span class="comment">// Prepare to receive.</span></div>
|
|
<div class="line"> receiveXfer.<a class="code" href="group__uart__driver.html#af91f05b0f951836e3002f60f0575f369">data</a> = receiveData;</div>
|
|
<div class="line"> receiveXfer.<a class="code" href="group__uart__driver.html#a21820f8294de0d75d863b72512a7c12f">dataSize</a> = RX_DATA_SIZE;</div>
|
|
<div class="line"> rxFinished = <span class="keyword">false</span>;</div>
|
|
<div class="line"></div>
|
|
<div class="line"> <span class="comment">// Receive.</span></div>
|
|
<div class="line"> UART_ReceiveNonBlocking(&g_uartHandle, &receiveXfer, &bytesRead);</div>
|
|
<div class="line"></div>
|
|
<div class="line"> <span class="keywordflow">if</span> (bytesRead = RX_DATA_SIZE) <span class="comment">/* Have read enough data. </span></div>
|
|
<div class="line"><span class="comment"> {</span></div>
|
|
<div class="line"><span class="comment"> ;</span></div>
|
|
<div class="line"><span class="comment"> }</span></div>
|
|
<div class="line"><span class="comment"> else</span></div>
|
|
<div class="line"><span class="comment"> {</span></div>
|
|
<div class="line"><span class="comment"> if (bytesRead) /* Received some data, process first. </span></div>
|
|
<div class="line"><span class="comment"> {</span></div>
|
|
<div class="line"><span class="comment"> ;</span></div>
|
|
<div class="line"><span class="comment"> }</span></div>
|
|
<div class="line"><span class="comment"></span></div>
|
|
<div class="line"><span class="comment"> // Wait receive finished.</span></div>
|
|
<div class="line"><span class="comment"> while (!rxFinished)</span></div>
|
|
<div class="line"><span class="comment"> {</span></div>
|
|
<div class="line"><span class="comment"> }</span></div>
|
|
<div class="line"><span class="comment"> }</span></div>
|
|
<div class="line"><span class="comment"></span></div>
|
|
<div class="line"><span class="comment"> // ...</span></div>
|
|
<div class="line"><span class="comment">}</span></div>
|
|
</div><!-- fragment --><h2><a class="anchor" id="UARTCaseDma"></a>
|
|
UART Send/Receive using the DMA method</h2>
|
|
<div class="fragment"><div class="line">uart_handle_t g_uartHandle;</div>
|
|
<div class="line"><a class="code" href="group__dma__driver.html#structdma__handle__t">dma_handle_t</a> g_uartTxDmaHandle;</div>
|
|
<div class="line"><a class="code" href="group__dma__driver.html#structdma__handle__t">dma_handle_t</a> g_uartRxDmaHandle;</div>
|
|
<div class="line"><a class="code" href="group__uart__driver.html#structuart__config__t">uart_config_t</a> user_config;</div>
|
|
<div class="line"><a class="code" href="group__uart__driver.html#structuart__transfer__t">uart_transfer_t</a> sendXfer;</div>
|
|
<div class="line"><a class="code" href="group__uart__driver.html#structuart__transfer__t">uart_transfer_t</a> receiveXfer;</div>
|
|
<div class="line"><span class="keyword">volatile</span> <span class="keywordtype">bool</span> txFinished;</div>
|
|
<div class="line"><span class="keyword">volatile</span> <span class="keywordtype">bool</span> rxFinished;</div>
|
|
<div class="line">uint8_t sendData[] = [<span class="charliteral">'H'</span>, <span class="charliteral">'e'</span>, <span class="charliteral">'l'</span>, <span class="charliteral">'l'</span>, <span class="charliteral">'o'</span>];</div>
|
|
<div class="line">uint8_t receiveData[32];</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="keywordtype">void</span> UART_UserCallback(uart_handle_t *handle, status_t status, <span class="keywordtype">void</span> *userData)</div>
|
|
<div class="line">{</div>
|
|
<div class="line"> userData = userData;</div>
|
|
<div class="line"></div>
|
|
<div class="line"> <span class="keywordflow">if</span> (<a class="code" href="group__uart__driver.html#ggacef40dc8e8ac174bfe40ebcbc980f84baf36c829b1b889517bf775c0d7ce29fa6">kStatus_UART_TxIdle</a> == status)</div>
|
|
<div class="line"> {</div>
|
|
<div class="line"> txFinished = <span class="keyword">true</span>;</div>
|
|
<div class="line"> }</div>
|
|
<div class="line"></div>
|
|
<div class="line"> <span class="keywordflow">if</span> (<a class="code" href="group__uart__driver.html#ggacef40dc8e8ac174bfe40ebcbc980f84bae0877b14627ed2aa8ddb2bf5b033f407">kStatus_UART_RxIdle</a> == status)</div>
|
|
<div class="line"> {</div>
|
|
<div class="line"> rxFinished = <span class="keyword">true</span>;</div>
|
|
<div class="line"> }</div>
|
|
<div class="line">}</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="keywordtype">void</span> main(<span class="keywordtype">void</span>)</div>
|
|
<div class="line">{</div>
|
|
<div class="line"> <span class="comment">//...</span></div>
|
|
<div class="line"></div>
|
|
<div class="line"> <a class="code" href="group__uart__driver.html#ga47c7c09e04a0497f4530d553e27d96c5">UART_GetDefaultConfig</a>(&user_config);</div>
|
|
<div class="line"> user_config.<a class="code" href="group__uart__driver.html#acc123668836f3432c54ee6a2f6f318f1">baudRate_Bps</a> = 115200U;</div>
|
|
<div class="line"> user_config.<a class="code" href="group__uart__driver.html#a91d575902455699a312c64b564133a8d">enableTx</a> = <span class="keyword">true</span>;</div>
|
|
<div class="line"> user_config.<a class="code" href="group__uart__driver.html#aa045acd340fc86d70a497f49e0a95bdd">enableRx</a> = <span class="keyword">true</span>;</div>
|
|
<div class="line"></div>
|
|
<div class="line"> <a class="code" href="group__uart__driver.html#gaa6162686a1aced16ff39c7d54d81fe5b">UART_Init</a>(UART1, &user_config, 120000000U);</div>
|
|
<div class="line"></div>
|
|
<div class="line"> <span class="comment">// Set up the DMA</span></div>
|
|
<div class="line"> <a class="code" href="group__dmamux.html#ga850545ac61a004df8ca312db2ca9db73">DMAMUX_Init</a>(DMAMUX0);</div>
|
|
<div class="line"> <a class="code" href="group__dmamux.html#gaeef2299701369971128b0be4d5237e3d">DMAMUX_SetSource</a>(DMAMUX0, UART_TX_DMA_CHANNEL, UART_TX_DMA_REQUEST);</div>
|
|
<div class="line"> <a class="code" href="group__dmamux.html#gaecac68802d961c31a06389caa97387f5">DMAMUX_EnableChannel</a>(DMAMUX0, UART_TX_DMA_CHANNEL);</div>
|
|
<div class="line"> <a class="code" href="group__dmamux.html#gaeef2299701369971128b0be4d5237e3d">DMAMUX_SetSource</a>(DMAMUX0, UART_RX_DMA_CHANNEL, UART_RX_DMA_REQUEST);</div>
|
|
<div class="line"> <a class="code" href="group__dmamux.html#gaecac68802d961c31a06389caa97387f5">DMAMUX_EnableChannel</a>(DMAMUX0, UART_RX_DMA_CHANNEL);</div>
|
|
<div class="line"></div>
|
|
<div class="line"> <a class="code" href="group__dma__driver.html#gade1b5efa61054ce538b37b181dd075bb">DMA_Init</a>(DMA0);</div>
|
|
<div class="line"></div>
|
|
<div class="line"> <span class="comment">/* Create DMA handle. </span></div>
|
|
<div class="line"><span class="comment"> DMA_CreateHandle(&g_uartTxDmaHandle, DMA0, UART_TX_DMA_CHANNEL);</span></div>
|
|
<div class="line"><span class="comment"> DMA_CreateHandle(&g_uartRxDmaHandle, DMA0, UART_RX_DMA_CHANNEL);</span></div>
|
|
<div class="line"><span class="comment"></span></div>
|
|
<div class="line"><span class="comment"> UART_CreateHandleDMA(&g_uartHandle, UART1, &g_uartTxDmaHandle, &g_uartRxDmaHandle);</span></div>
|
|
<div class="line"><span class="comment"> UART_SetTransferCallbackDMA(&g_uartDmaHandle, UART_UserCallback, NULL);</span></div>
|
|
<div class="line"><span class="comment"></span></div>
|
|
<div class="line"><span class="comment"> // Prepare to send.</span></div>
|
|
<div class="line"><span class="comment"> sendXfer.data = sendData</span></div>
|
|
<div class="line"><span class="comment"> sendXfer.dataSize = sizeof(sendData)/sizeof(sendData[0]);</span></div>
|
|
<div class="line"><span class="comment"> txFinished = false;</span></div>
|
|
<div class="line"><span class="comment"></span></div>
|
|
<div class="line"><span class="comment"> // Send out.</span></div>
|
|
<div class="line"><span class="comment"> UART_SendDMA(&g_uartHandle, &sendXfer);</span></div>
|
|
<div class="line"><span class="comment"></span></div>
|
|
<div class="line"><span class="comment"> // Wait send finished.</span></div>
|
|
<div class="line"><span class="comment"> while (!txFinished)</span></div>
|
|
<div class="line"><span class="comment"> {</span></div>
|
|
<div class="line"><span class="comment"> }</span></div>
|
|
<div class="line"><span class="comment"></span></div>
|
|
<div class="line"><span class="comment"> // Prepare to receive.</span></div>
|
|
<div class="line"><span class="comment"> receiveXfer.data = receiveData;</span></div>
|
|
<div class="line"><span class="comment"> receiveXfer.dataSize = sizeof(receiveData)/sizeof(receiveData[0]);</span></div>
|
|
<div class="line"><span class="comment"> rxFinished = false;</span></div>
|
|
<div class="line"><span class="comment"></span></div>
|
|
<div class="line"><span class="comment"> // Receive.</span></div>
|
|
<div class="line"><span class="comment"> UART_ReceiveDMA(&g_uartHandle, &receiveXfer, NULL);</span></div>
|
|
<div class="line"><span class="comment"></span></div>
|
|
<div class="line"><span class="comment"> // Wait receive finished.</span></div>
|
|
<div class="line"><span class="comment"> while (!rxFinished)</span></div>
|
|
<div class="line"><span class="comment"> {</span></div>
|
|
<div class="line"><span class="comment"> }</span></div>
|
|
<div class="line"><span class="comment"></span></div>
|
|
<div class="line"><span class="comment"> // ...</span></div>
|
|
<div class="line"><span class="comment">}</span></div>
|
|
</div><!-- fragment --> <table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="groups"></a>
|
|
Modules</h2></td></tr>
|
|
<tr class="memitem:group__uart__dma__driver"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__dma__driver.html">UART DMA Driver</a></td></tr>
|
|
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:group__uart__edma__driver"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__edma__driver.html">UART eDMA Driver</a></td></tr>
|
|
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table><table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="files"></a>
|
|
Files</h2></td></tr>
|
|
<tr class="memitem:fsl__uart_8h"><td class="memItemLeft" align="right" valign="top">file  </td><td class="memItemRight" valign="bottom"><a class="el" href="fsl__uart_8h.html">fsl_uart.h</a></td></tr>
|
|
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table><table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="nested-classes"></a>
|
|
Data Structures</h2></td></tr>
|
|
<tr class="memitem:structuart__config__t"><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#structuart__config__t">uart_config_t</a></td></tr>
|
|
<tr class="memdesc:structuart__config__t"><td class="mdescLeft"> </td><td class="mdescRight">UART configuration structure. <a href="group__uart__driver.html#structuart__config__t">More...</a><br/></td></tr>
|
|
<tr class="separator:structuart__config__t"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:structuart__transfer__t"><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#structuart__transfer__t">uart_transfer_t</a></td></tr>
|
|
<tr class="memdesc:structuart__transfer__t"><td class="mdescLeft"> </td><td class="mdescRight">UART transfer structure. <a href="group__uart__driver.html#structuart__transfer__t">More...</a><br/></td></tr>
|
|
<tr class="separator:structuart__transfer__t"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:struct__uart__handle"><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#struct__uart__handle">uart_handle_t</a></td></tr>
|
|
<tr class="memdesc:struct__uart__handle"><td class="mdescLeft"> </td><td class="mdescRight">UART handle structure. <a href="group__uart__driver.html#struct__uart__handle">More...</a><br/></td></tr>
|
|
<tr class="separator:struct__uart__handle"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table><table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="typedef-members"></a>
|
|
Typedefs</h2></td></tr>
|
|
<tr class="memitem:gaf164fa4e12ff8a3e3f3997512001e007"><td class="memItemLeft" align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#gaf164fa4e12ff8a3e3f3997512001e007">uart_transfer_callback_t</a> )(UART_Type *base, uart_handle_t *handle, status_t status, void *userData)</td></tr>
|
|
<tr class="memdesc:gaf164fa4e12ff8a3e3f3997512001e007"><td class="mdescLeft"> </td><td class="mdescRight">UART transfer callback function. <a href="#gaf164fa4e12ff8a3e3f3997512001e007">More...</a><br/></td></tr>
|
|
<tr class="separator:gaf164fa4e12ff8a3e3f3997512001e007"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table><table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="enum-members"></a>
|
|
Enumerations</h2></td></tr>
|
|
<tr class="memitem:gacef40dc8e8ac174bfe40ebcbc980f84b"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#gacef40dc8e8ac174bfe40ebcbc980f84b">_uart_status</a> { <br/>
|
|
  <a class="el" href="group__uart__driver.html#ggacef40dc8e8ac174bfe40ebcbc980f84ba19ddee4fe5963467600028b78fb468e7">kStatus_UART_TxBusy</a> = MAKE_STATUS(kStatusGroup_UART, 0),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#ggacef40dc8e8ac174bfe40ebcbc980f84ba68cf23f981c4b85f82291163fbb2a5e6">kStatus_UART_RxBusy</a> = MAKE_STATUS(kStatusGroup_UART, 1),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#ggacef40dc8e8ac174bfe40ebcbc980f84baf36c829b1b889517bf775c0d7ce29fa6">kStatus_UART_TxIdle</a> = MAKE_STATUS(kStatusGroup_UART, 2),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#ggacef40dc8e8ac174bfe40ebcbc980f84bae0877b14627ed2aa8ddb2bf5b033f407">kStatus_UART_RxIdle</a> = MAKE_STATUS(kStatusGroup_UART, 3),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#ggacef40dc8e8ac174bfe40ebcbc980f84ba765913f003819ed87b861d187bf79ab8">kStatus_UART_TxWatermarkTooLarge</a> = MAKE_STATUS(kStatusGroup_UART, 4),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#ggacef40dc8e8ac174bfe40ebcbc980f84ba720cefde05389830f35f6e6df6f6ac67">kStatus_UART_RxWatermarkTooLarge</a> = MAKE_STATUS(kStatusGroup_UART, 5),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#ggacef40dc8e8ac174bfe40ebcbc980f84ba5ee8e23fc9ab20cf366942751b895f54">kStatus_UART_FlagCannotClearManually</a>,
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#ggacef40dc8e8ac174bfe40ebcbc980f84ba950972a9e2ebbaa13c92e8f5a51f785d">kStatus_UART_Error</a> = MAKE_STATUS(kStatusGroup_UART, 7),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#ggacef40dc8e8ac174bfe40ebcbc980f84ba2e5b644b1e10c426af818bc78657e992">kStatus_UART_RxRingBufferOverrun</a> = MAKE_STATUS(kStatusGroup_UART, 8),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#ggacef40dc8e8ac174bfe40ebcbc980f84bab6b1fd6c2deec25992449f5b12303a26">kStatus_UART_RxHardwareOverrun</a> = MAKE_STATUS(kStatusGroup_UART, 9),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#ggacef40dc8e8ac174bfe40ebcbc980f84bae4ef4df9a5f756ccf1b4bf08292ec2fb">kStatus_UART_NoiseError</a> = MAKE_STATUS(kStatusGroup_UART, 10),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#ggacef40dc8e8ac174bfe40ebcbc980f84baa7aa134f85df3d5863ca962ce1ea7ee0">kStatus_UART_FramingError</a> = MAKE_STATUS(kStatusGroup_UART, 11),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#ggacef40dc8e8ac174bfe40ebcbc980f84baea20b2588c38f259f1412aa7132c9ef8">kStatus_UART_ParityError</a> = MAKE_STATUS(kStatusGroup_UART, 12)
|
|
<br/>
|
|
}</td></tr>
|
|
<tr class="memdesc:gacef40dc8e8ac174bfe40ebcbc980f84b"><td class="mdescLeft"> </td><td class="mdescRight">Error codes for the UART driver. <a href="group__uart__driver.html#gacef40dc8e8ac174bfe40ebcbc980f84b">More...</a><br/></td></tr>
|
|
<tr class="separator:gacef40dc8e8ac174bfe40ebcbc980f84b"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:ga436e5a7bdb5f24decb5bfb0c87a83ff4"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#ga436e5a7bdb5f24decb5bfb0c87a83ff4">uart_parity_mode_t</a> { <br/>
|
|
  <a class="el" href="group__uart__driver.html#gga436e5a7bdb5f24decb5bfb0c87a83ff4a97e2feae6671a6de1126ebc2edf4606b">kUART_ParityDisabled</a> = 0x0U,
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#gga436e5a7bdb5f24decb5bfb0c87a83ff4a9e68fe3aba46e045bee5433ed098bff0">kUART_ParityEven</a> = 0x2U,
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#gga436e5a7bdb5f24decb5bfb0c87a83ff4ae48c7fabc9babf1be626ebeb2627a54c">kUART_ParityOdd</a> = 0x3U
|
|
<br/>
|
|
}</td></tr>
|
|
<tr class="memdesc:ga436e5a7bdb5f24decb5bfb0c87a83ff4"><td class="mdescLeft"> </td><td class="mdescRight">UART parity mode. <a href="group__uart__driver.html#ga436e5a7bdb5f24decb5bfb0c87a83ff4">More...</a><br/></td></tr>
|
|
<tr class="separator:ga436e5a7bdb5f24decb5bfb0c87a83ff4"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:gaca4f14d23735c6afefb76cbee18e1db6"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#gaca4f14d23735c6afefb76cbee18e1db6">uart_stop_bit_count_t</a> { <br/>
|
|
  <a class="el" href="group__uart__driver.html#ggaca4f14d23735c6afefb76cbee18e1db6a5a8829a108d8a46abb097a36cde051a7">kUART_OneStopBit</a> = 0U,
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#ggaca4f14d23735c6afefb76cbee18e1db6a9704b3ae3ee851acf324eb357f75ab56">kUART_TwoStopBit</a> = 1U
|
|
<br/>
|
|
}</td></tr>
|
|
<tr class="memdesc:gaca4f14d23735c6afefb76cbee18e1db6"><td class="mdescLeft"> </td><td class="mdescRight">UART stop bit count. <a href="group__uart__driver.html#gaca4f14d23735c6afefb76cbee18e1db6">More...</a><br/></td></tr>
|
|
<tr class="separator:gaca4f14d23735c6afefb76cbee18e1db6"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:ga700f3cd8e3800273a1591307cab6311c"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#ga700f3cd8e3800273a1591307cab6311c">_uart_interrupt_enable</a> { <br/>
|
|
  <a class="el" href="group__uart__driver.html#gga700f3cd8e3800273a1591307cab6311ca71755319c216d0bdf79729c18c24cf64">kUART_RxActiveEdgeInterruptEnable</a> = (UART_BDH_RXEDGIE_MASK),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#gga700f3cd8e3800273a1591307cab6311ca5a0870233f2ffa8f5ca60d80f1e3ed14">kUART_TxDataRegEmptyInterruptEnable</a> = (UART_C2_TIE_MASK << 8),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#gga700f3cd8e3800273a1591307cab6311cafd337213dae85b532dfaf9a90e2e5d7b">kUART_TransmissionCompleteInterruptEnable</a> = (UART_C2_TCIE_MASK << 8),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#gga700f3cd8e3800273a1591307cab6311cac8a751a334e172413ab833cb0ccb01c3">kUART_RxDataRegFullInterruptEnable</a> = (UART_C2_RIE_MASK << 8),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#gga700f3cd8e3800273a1591307cab6311ca078ea32d8587f92337a3dee495a1ceed">kUART_IdleLineInterruptEnable</a> = (UART_C2_ILIE_MASK << 8),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#gga700f3cd8e3800273a1591307cab6311ca3e85b14c1b64dbfef1d0b4b7bc39c19d">kUART_RxOverrunInterruptEnable</a> = (UART_C3_ORIE_MASK << 16),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#gga700f3cd8e3800273a1591307cab6311ca53d0fe2bb0cd90198c632f08488af4b3">kUART_NoiseErrorInterruptEnable</a> = (UART_C3_NEIE_MASK << 16),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#gga700f3cd8e3800273a1591307cab6311ca00a387446d0ca7fd843968eca8af22a5">kUART_FramingErrorInterruptEnable</a> = (UART_C3_FEIE_MASK << 16),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#gga700f3cd8e3800273a1591307cab6311cadc2475fa65313c6f1d13b36f0443b20a">kUART_ParityErrorInterruptEnable</a> = (UART_C3_PEIE_MASK << 16)
|
|
<br/>
|
|
}</td></tr>
|
|
<tr class="memdesc:ga700f3cd8e3800273a1591307cab6311c"><td class="mdescLeft"> </td><td class="mdescRight">UART interrupt configuration structure, default settings all disabled. <a href="group__uart__driver.html#ga700f3cd8e3800273a1591307cab6311c">More...</a><br/></td></tr>
|
|
<tr class="separator:ga700f3cd8e3800273a1591307cab6311c"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:ga259a53f363288115306a45d08fc66eb8"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#ga259a53f363288115306a45d08fc66eb8">_uart_flags</a> { <br/>
|
|
  <a class="el" href="group__uart__driver.html#gga259a53f363288115306a45d08fc66eb8a5209c671b2f2f064dc512655387e9e1a">kUART_TxDataRegEmptyFlag</a> = (UART_S1_TDRE_MASK),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#gga259a53f363288115306a45d08fc66eb8a4468b60b2d78c34b93c9199df9e95d3a">kUART_TransmissionCompleteFlag</a> = (UART_S1_TC_MASK),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#gga259a53f363288115306a45d08fc66eb8aa86a34b2ea609eeeb63f98fea498e540">kUART_RxDataRegFullFlag</a> = (UART_S1_RDRF_MASK),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#gga259a53f363288115306a45d08fc66eb8ab2fc4e1b1164ed3e3fe7e19a39029b2c">kUART_IdleLineFlag</a> = (UART_S1_IDLE_MASK),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#gga259a53f363288115306a45d08fc66eb8a93d3c56466b4656dcce08d9323d7afd8">kUART_RxOverrunFlag</a> = (UART_S1_OR_MASK),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#gga259a53f363288115306a45d08fc66eb8abd56419f102fb01c7bbc2c38f81ab360">kUART_NoiseErrorFlag</a> = (UART_S1_NF_MASK),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#gga259a53f363288115306a45d08fc66eb8aade5071fa56646adcda3562051443868">kUART_FramingErrorFlag</a> = (UART_S1_FE_MASK),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#gga259a53f363288115306a45d08fc66eb8a0c92973ab1d527115fa01934c62a053d">kUART_ParityErrorFlag</a> = (UART_S1_PF_MASK),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#gga259a53f363288115306a45d08fc66eb8adcfe89feb164ff5b1720312922006a7a">kUART_RxActiveEdgeFlag</a> = (UART_S2_RXEDGIF_MASK << 8),
|
|
<br/>
|
|
  <a class="el" href="group__uart__driver.html#gga259a53f363288115306a45d08fc66eb8a7a4521cd44a3272a94784670d1bf5a0c">kUART_RxActiveFlag</a> = (UART_S2_RAF_MASK << 8)
|
|
<br/>
|
|
}</td></tr>
|
|
<tr class="memdesc:ga259a53f363288115306a45d08fc66eb8"><td class="mdescLeft"> </td><td class="mdescRight">UART status flags. <a href="group__uart__driver.html#ga259a53f363288115306a45d08fc66eb8">More...</a><br/></td></tr>
|
|
<tr class="separator:ga259a53f363288115306a45d08fc66eb8"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table><table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="member-group"></a>
|
|
Driver version</h2></td></tr>
|
|
<tr class="memitem:ga89f9649bfe350eb7b1e53146f35d3de5"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#ga89f9649bfe350eb7b1e53146f35d3de5">FSL_UART_DRIVER_VERSION</a>   (<a class="el" href="group__flash__driver.html#ga812138aa3315b0c6953c1a26130bcc37">MAKE_VERSION</a>(2, 1, 0))</td></tr>
|
|
<tr class="memdesc:ga89f9649bfe350eb7b1e53146f35d3de5"><td class="mdescLeft"> </td><td class="mdescRight">UART driver version 2.1.0. <a href="#ga89f9649bfe350eb7b1e53146f35d3de5">More...</a><br/></td></tr>
|
|
<tr class="separator:ga89f9649bfe350eb7b1e53146f35d3de5"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table><table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="member-group"></a>
|
|
Initialization and deinitialization</h2></td></tr>
|
|
<tr class="memitem:gaa6162686a1aced16ff39c7d54d81fe5b"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#gaa6162686a1aced16ff39c7d54d81fe5b">UART_Init</a> (UART_Type *base, const <a class="el" href="group__uart__driver.html#structuart__config__t">uart_config_t</a> *config, uint32_t srcClock_Hz)</td></tr>
|
|
<tr class="memdesc:gaa6162686a1aced16ff39c7d54d81fe5b"><td class="mdescLeft"> </td><td class="mdescRight">Initializes a UART instance with user configuration structure and peripheral clock. <a href="#gaa6162686a1aced16ff39c7d54d81fe5b">More...</a><br/></td></tr>
|
|
<tr class="separator:gaa6162686a1aced16ff39c7d54d81fe5b"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:ga3ff48bc211831be33e6fe5c50eb671a0"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#ga3ff48bc211831be33e6fe5c50eb671a0">UART_Deinit</a> (UART_Type *base)</td></tr>
|
|
<tr class="memdesc:ga3ff48bc211831be33e6fe5c50eb671a0"><td class="mdescLeft"> </td><td class="mdescRight">Deinitializes a UART instance. <a href="#ga3ff48bc211831be33e6fe5c50eb671a0">More...</a><br/></td></tr>
|
|
<tr class="separator:ga3ff48bc211831be33e6fe5c50eb671a0"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:ga47c7c09e04a0497f4530d553e27d96c5"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#ga47c7c09e04a0497f4530d553e27d96c5">UART_GetDefaultConfig</a> (<a class="el" href="group__uart__driver.html#structuart__config__t">uart_config_t</a> *config)</td></tr>
|
|
<tr class="memdesc:ga47c7c09e04a0497f4530d553e27d96c5"><td class="mdescLeft"> </td><td class="mdescRight">Gets the default configuration structure. <a href="#ga47c7c09e04a0497f4530d553e27d96c5">More...</a><br/></td></tr>
|
|
<tr class="separator:ga47c7c09e04a0497f4530d553e27d96c5"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:gae0482730b0d5f6b7f8d12aba1e4044e5"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#gae0482730b0d5f6b7f8d12aba1e4044e5">UART_SetBaudRate</a> (UART_Type *base, uint32_t baudRate_Bps, uint32_t srcClock_Hz)</td></tr>
|
|
<tr class="memdesc:gae0482730b0d5f6b7f8d12aba1e4044e5"><td class="mdescLeft"> </td><td class="mdescRight">Sets the UART instance baud rate. <a href="#gae0482730b0d5f6b7f8d12aba1e4044e5">More...</a><br/></td></tr>
|
|
<tr class="separator:gae0482730b0d5f6b7f8d12aba1e4044e5"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table><table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="member-group"></a>
|
|
Status</h2></td></tr>
|
|
<tr class="memitem:ga28bf715678c0d3c8c3902e79455ee923"><td class="memItemLeft" align="right" valign="top">uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#ga28bf715678c0d3c8c3902e79455ee923">UART_GetStatusFlags</a> (UART_Type *base)</td></tr>
|
|
<tr class="memdesc:ga28bf715678c0d3c8c3902e79455ee923"><td class="mdescLeft"> </td><td class="mdescRight">Get UART status flags. <a href="#ga28bf715678c0d3c8c3902e79455ee923">More...</a><br/></td></tr>
|
|
<tr class="separator:ga28bf715678c0d3c8c3902e79455ee923"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:gacc4cb85534361f836edca9454a6426c6"><td class="memItemLeft" align="right" valign="top">status_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#gacc4cb85534361f836edca9454a6426c6">UART_ClearStatusFlags</a> (UART_Type *base, uint32_t mask)</td></tr>
|
|
<tr class="memdesc:gacc4cb85534361f836edca9454a6426c6"><td class="mdescLeft"> </td><td class="mdescRight">Clears status flags with the provided mask. <a href="#gacc4cb85534361f836edca9454a6426c6">More...</a><br/></td></tr>
|
|
<tr class="separator:gacc4cb85534361f836edca9454a6426c6"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table><table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="member-group"></a>
|
|
Interrupts</h2></td></tr>
|
|
<tr class="memitem:ga49ecd761481a22956e3f46285038719c"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#ga49ecd761481a22956e3f46285038719c">UART_EnableInterrupts</a> (UART_Type *base, uint32_t mask)</td></tr>
|
|
<tr class="memdesc:ga49ecd761481a22956e3f46285038719c"><td class="mdescLeft"> </td><td class="mdescRight">Enables UART interrupts according to the provided mask. <a href="#ga49ecd761481a22956e3f46285038719c">More...</a><br/></td></tr>
|
|
<tr class="separator:ga49ecd761481a22956e3f46285038719c"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:ga3f24b6b9b730046a9a81918f9abe7d99"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#ga3f24b6b9b730046a9a81918f9abe7d99">UART_DisableInterrupts</a> (UART_Type *base, uint32_t mask)</td></tr>
|
|
<tr class="memdesc:ga3f24b6b9b730046a9a81918f9abe7d99"><td class="mdescLeft"> </td><td class="mdescRight">Disables the UART interrupts according to the provided mask. <a href="#ga3f24b6b9b730046a9a81918f9abe7d99">More...</a><br/></td></tr>
|
|
<tr class="separator:ga3f24b6b9b730046a9a81918f9abe7d99"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:ga79bc0b880286ec0dc0543606fc772912"><td class="memItemLeft" align="right" valign="top">uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#ga79bc0b880286ec0dc0543606fc772912">UART_GetEnabledInterrupts</a> (UART_Type *base)</td></tr>
|
|
<tr class="memdesc:ga79bc0b880286ec0dc0543606fc772912"><td class="mdescLeft"> </td><td class="mdescRight">Gets the enabled UART interrupts. <a href="#ga79bc0b880286ec0dc0543606fc772912">More...</a><br/></td></tr>
|
|
<tr class="separator:ga79bc0b880286ec0dc0543606fc772912"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table><table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="member-group"></a>
|
|
Bus Operations</h2></td></tr>
|
|
<tr class="memitem:gaf2ed68f3dd6ee8a272e9afd8ebd84f93"><td class="memItemLeft" align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#gaf2ed68f3dd6ee8a272e9afd8ebd84f93">UART_EnableTx</a> (UART_Type *base, bool enable)</td></tr>
|
|
<tr class="memdesc:gaf2ed68f3dd6ee8a272e9afd8ebd84f93"><td class="mdescLeft"> </td><td class="mdescRight">Enables or disables the UART transmitter. <a href="#gaf2ed68f3dd6ee8a272e9afd8ebd84f93">More...</a><br/></td></tr>
|
|
<tr class="separator:gaf2ed68f3dd6ee8a272e9afd8ebd84f93"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:gaa503e36c8ce82f1042ce186b9863871f"><td class="memItemLeft" align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#gaa503e36c8ce82f1042ce186b9863871f">UART_EnableRx</a> (UART_Type *base, bool enable)</td></tr>
|
|
<tr class="memdesc:gaa503e36c8ce82f1042ce186b9863871f"><td class="mdescLeft"> </td><td class="mdescRight">Enables or disables the UART receiver. <a href="#gaa503e36c8ce82f1042ce186b9863871f">More...</a><br/></td></tr>
|
|
<tr class="separator:gaa503e36c8ce82f1042ce186b9863871f"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:ga371d2ceda535de3a74beba5a3465fab0"><td class="memItemLeft" align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#ga371d2ceda535de3a74beba5a3465fab0">UART_WriteByte</a> (UART_Type *base, uint8_t data)</td></tr>
|
|
<tr class="memdesc:ga371d2ceda535de3a74beba5a3465fab0"><td class="mdescLeft"> </td><td class="mdescRight">Writes to the TX register. <a href="#ga371d2ceda535de3a74beba5a3465fab0">More...</a><br/></td></tr>
|
|
<tr class="separator:ga371d2ceda535de3a74beba5a3465fab0"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:ga3728011ac7906f3e03bb677b0f9cf7b4"><td class="memItemLeft" align="right" valign="top">static uint8_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#ga3728011ac7906f3e03bb677b0f9cf7b4">UART_ReadByte</a> (UART_Type *base)</td></tr>
|
|
<tr class="memdesc:ga3728011ac7906f3e03bb677b0f9cf7b4"><td class="mdescLeft"> </td><td class="mdescRight">Reads the RX register directly. <a href="#ga3728011ac7906f3e03bb677b0f9cf7b4">More...</a><br/></td></tr>
|
|
<tr class="separator:ga3728011ac7906f3e03bb677b0f9cf7b4"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:gad67794d80b7ee2d3292b41af6ff1e100"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#gad67794d80b7ee2d3292b41af6ff1e100">UART_WriteBlocking</a> (UART_Type *base, const uint8_t *data, size_t length)</td></tr>
|
|
<tr class="memdesc:gad67794d80b7ee2d3292b41af6ff1e100"><td class="mdescLeft"> </td><td class="mdescRight">Writes to the TX register using a blocking method. <a href="#gad67794d80b7ee2d3292b41af6ff1e100">More...</a><br/></td></tr>
|
|
<tr class="separator:gad67794d80b7ee2d3292b41af6ff1e100"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:ga39d59e8a94f1af451a0db81888596639"><td class="memItemLeft" align="right" valign="top">status_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#ga39d59e8a94f1af451a0db81888596639">UART_ReadBlocking</a> (UART_Type *base, uint8_t *data, size_t length)</td></tr>
|
|
<tr class="memdesc:ga39d59e8a94f1af451a0db81888596639"><td class="mdescLeft"> </td><td class="mdescRight">Read RX data register using a blocking method. <a href="#ga39d59e8a94f1af451a0db81888596639">More...</a><br/></td></tr>
|
|
<tr class="separator:ga39d59e8a94f1af451a0db81888596639"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table><table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="member-group"></a>
|
|
Transactional</h2></td></tr>
|
|
<tr class="memitem:ga63db308c32019b7dd6c0647d618e5247"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#ga63db308c32019b7dd6c0647d618e5247">UART_TransferCreateHandle</a> (UART_Type *base, uart_handle_t *handle, <a class="el" href="group__uart__driver.html#gaf164fa4e12ff8a3e3f3997512001e007">uart_transfer_callback_t</a> callback, void *userData)</td></tr>
|
|
<tr class="memdesc:ga63db308c32019b7dd6c0647d618e5247"><td class="mdescLeft"> </td><td class="mdescRight">Initializes the UART handle. <a href="#ga63db308c32019b7dd6c0647d618e5247">More...</a><br/></td></tr>
|
|
<tr class="separator:ga63db308c32019b7dd6c0647d618e5247"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:ga223fba584bfabd599629d5ce92f929ac"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#ga223fba584bfabd599629d5ce92f929ac">UART_TransferStartRingBuffer</a> (UART_Type *base, uart_handle_t *handle, uint8_t *ringBuffer, size_t ringBufferSize)</td></tr>
|
|
<tr class="memdesc:ga223fba584bfabd599629d5ce92f929ac"><td class="mdescLeft"> </td><td class="mdescRight">Sets up the RX ring buffer. <a href="#ga223fba584bfabd599629d5ce92f929ac">More...</a><br/></td></tr>
|
|
<tr class="separator:ga223fba584bfabd599629d5ce92f929ac"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:ga0c0bc73df49cb31dff0e903630314f5b"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#ga0c0bc73df49cb31dff0e903630314f5b">UART_TransferStopRingBuffer</a> (UART_Type *base, uart_handle_t *handle)</td></tr>
|
|
<tr class="memdesc:ga0c0bc73df49cb31dff0e903630314f5b"><td class="mdescLeft"> </td><td class="mdescRight">Aborts the background transfer and uninstalls the ring buffer. <a href="#ga0c0bc73df49cb31dff0e903630314f5b">More...</a><br/></td></tr>
|
|
<tr class="separator:ga0c0bc73df49cb31dff0e903630314f5b"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:gad89afd7db1656c5aef404bb285d0dc05"><td class="memItemLeft" align="right" valign="top">status_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#gad89afd7db1656c5aef404bb285d0dc05">UART_TransferSendNonBlocking</a> (UART_Type *base, uart_handle_t *handle, <a class="el" href="group__uart__driver.html#structuart__transfer__t">uart_transfer_t</a> *xfer)</td></tr>
|
|
<tr class="memdesc:gad89afd7db1656c5aef404bb285d0dc05"><td class="mdescLeft"> </td><td class="mdescRight">Transmits a buffer of data using the interrupt method. <a href="#gad89afd7db1656c5aef404bb285d0dc05">More...</a><br/></td></tr>
|
|
<tr class="separator:gad89afd7db1656c5aef404bb285d0dc05"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:gaa64f9f89d8286fd3ef0736a8c40be2c2"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#gaa64f9f89d8286fd3ef0736a8c40be2c2">UART_TransferAbortSend</a> (UART_Type *base, uart_handle_t *handle)</td></tr>
|
|
<tr class="memdesc:gaa64f9f89d8286fd3ef0736a8c40be2c2"><td class="mdescLeft"> </td><td class="mdescRight">Aborts the interrupt driven data transmit. <a href="#gaa64f9f89d8286fd3ef0736a8c40be2c2">More...</a><br/></td></tr>
|
|
<tr class="separator:gaa64f9f89d8286fd3ef0736a8c40be2c2"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:ga071727ba05b2937ef5ad641ca7faf9c7"><td class="memItemLeft" align="right" valign="top">status_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#ga071727ba05b2937ef5ad641ca7faf9c7">UART_TransferGetSendCount</a> (UART_Type *base, uart_handle_t *handle, uint32_t *count)</td></tr>
|
|
<tr class="memdesc:ga071727ba05b2937ef5ad641ca7faf9c7"><td class="mdescLeft"> </td><td class="mdescRight">Get the number of bytes that have been written to UART TX register. <a href="#ga071727ba05b2937ef5ad641ca7faf9c7">More...</a><br/></td></tr>
|
|
<tr class="separator:ga071727ba05b2937ef5ad641ca7faf9c7"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:gaf804acde5d73ce0a5bf54b06195e1218"><td class="memItemLeft" align="right" valign="top">status_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#gaf804acde5d73ce0a5bf54b06195e1218">UART_TransferReceiveNonBlocking</a> (UART_Type *base, uart_handle_t *handle, <a class="el" href="group__uart__driver.html#structuart__transfer__t">uart_transfer_t</a> *xfer, size_t *receivedBytes)</td></tr>
|
|
<tr class="memdesc:gaf804acde5d73ce0a5bf54b06195e1218"><td class="mdescLeft"> </td><td class="mdescRight">Receives a buffer of data using an interrupt method. <a href="#gaf804acde5d73ce0a5bf54b06195e1218">More...</a><br/></td></tr>
|
|
<tr class="separator:gaf804acde5d73ce0a5bf54b06195e1218"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:gacc35671622b2401545cc55cc6ae572d4"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#gacc35671622b2401545cc55cc6ae572d4">UART_TransferAbortReceive</a> (UART_Type *base, uart_handle_t *handle)</td></tr>
|
|
<tr class="memdesc:gacc35671622b2401545cc55cc6ae572d4"><td class="mdescLeft"> </td><td class="mdescRight">Aborts the interrupt-driven data receiving. <a href="#gacc35671622b2401545cc55cc6ae572d4">More...</a><br/></td></tr>
|
|
<tr class="separator:gacc35671622b2401545cc55cc6ae572d4"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:ga05df10f570cdca4ac2dff63b069d254e"><td class="memItemLeft" align="right" valign="top">status_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#ga05df10f570cdca4ac2dff63b069d254e">UART_TransferGetReceiveCount</a> (UART_Type *base, uart_handle_t *handle, uint32_t *count)</td></tr>
|
|
<tr class="memdesc:ga05df10f570cdca4ac2dff63b069d254e"><td class="mdescLeft"> </td><td class="mdescRight">Get the number of bytes that have been received. <a href="#ga05df10f570cdca4ac2dff63b069d254e">More...</a><br/></td></tr>
|
|
<tr class="separator:ga05df10f570cdca4ac2dff63b069d254e"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:gadb0c4f1e5b59db3aa2261df4f5ddb48d"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#gadb0c4f1e5b59db3aa2261df4f5ddb48d">UART_TransferHandleIRQ</a> (UART_Type *base, uart_handle_t *handle)</td></tr>
|
|
<tr class="memdesc:gadb0c4f1e5b59db3aa2261df4f5ddb48d"><td class="mdescLeft"> </td><td class="mdescRight">UART IRQ handle function. <a href="#gadb0c4f1e5b59db3aa2261df4f5ddb48d">More...</a><br/></td></tr>
|
|
<tr class="separator:gadb0c4f1e5b59db3aa2261df4f5ddb48d"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:gafc364352e879f53138ee1107e3da0a7d"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#gafc364352e879f53138ee1107e3da0a7d">UART_TransferHandleErrorIRQ</a> (UART_Type *base, uart_handle_t *handle)</td></tr>
|
|
<tr class="memdesc:gafc364352e879f53138ee1107e3da0a7d"><td class="mdescLeft"> </td><td class="mdescRight">UART Error IRQ handle function. <a href="#gafc364352e879f53138ee1107e3da0a7d">More...</a><br/></td></tr>
|
|
<tr class="separator:gafc364352e879f53138ee1107e3da0a7d"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table>
|
|
<hr/><h2 class="groupheader">Data Structure Documentation</h2>
|
|
<a name="structuart__config__t" id="structuart__config__t"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">struct uart_config_t</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<div class="textblock"></div><table class="memberdecls">
|
|
<tr><td colspan="2"><h3>Data Fields</h3></td></tr>
|
|
<tr class="memitem:acc123668836f3432c54ee6a2f6f318f1"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="acc123668836f3432c54ee6a2f6f318f1"></a>
|
|
uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#acc123668836f3432c54ee6a2f6f318f1">baudRate_Bps</a></td></tr>
|
|
<tr class="memdesc:acc123668836f3432c54ee6a2f6f318f1"><td class="mdescLeft"> </td><td class="mdescRight">UART baud rate. <br/></td></tr>
|
|
<tr class="separator:acc123668836f3432c54ee6a2f6f318f1"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a1a3abcf4f0f5d0a3893df14f2991aa39"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a1a3abcf4f0f5d0a3893df14f2991aa39"></a>
|
|
<a class="el" href="group__uart__driver.html#ga436e5a7bdb5f24decb5bfb0c87a83ff4">uart_parity_mode_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#a1a3abcf4f0f5d0a3893df14f2991aa39">parityMode</a></td></tr>
|
|
<tr class="memdesc:a1a3abcf4f0f5d0a3893df14f2991aa39"><td class="mdescLeft"> </td><td class="mdescRight">Parity mode, disabled (default), even, odd. <br/></td></tr>
|
|
<tr class="separator:a1a3abcf4f0f5d0a3893df14f2991aa39"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a91d575902455699a312c64b564133a8d"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a91d575902455699a312c64b564133a8d"></a>
|
|
bool </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#a91d575902455699a312c64b564133a8d">enableTx</a></td></tr>
|
|
<tr class="memdesc:a91d575902455699a312c64b564133a8d"><td class="mdescLeft"> </td><td class="mdescRight">Enable TX. <br/></td></tr>
|
|
<tr class="separator:a91d575902455699a312c64b564133a8d"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:aa045acd340fc86d70a497f49e0a95bdd"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aa045acd340fc86d70a497f49e0a95bdd"></a>
|
|
bool </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#aa045acd340fc86d70a497f49e0a95bdd">enableRx</a></td></tr>
|
|
<tr class="memdesc:aa045acd340fc86d70a497f49e0a95bdd"><td class="mdescLeft"> </td><td class="mdescRight">Enable RX. <br/></td></tr>
|
|
<tr class="separator:aa045acd340fc86d70a497f49e0a95bdd"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table>
|
|
|
|
</div>
|
|
</div>
|
|
<a name="structuart__transfer__t" id="structuart__transfer__t"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">struct uart_transfer_t</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<div class="textblock"></div><table class="memberdecls">
|
|
<tr><td colspan="2"><h3>Data Fields</h3></td></tr>
|
|
<tr class="memitem:af91f05b0f951836e3002f60f0575f369"><td class="memItemLeft" align="right" valign="top">uint8_t * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#af91f05b0f951836e3002f60f0575f369">data</a></td></tr>
|
|
<tr class="memdesc:af91f05b0f951836e3002f60f0575f369"><td class="mdescLeft"> </td><td class="mdescRight">The buffer of data to be transfer. <a href="#af91f05b0f951836e3002f60f0575f369">More...</a><br/></td></tr>
|
|
<tr class="separator:af91f05b0f951836e3002f60f0575f369"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a21820f8294de0d75d863b72512a7c12f"><td class="memItemLeft" align="right" valign="top">size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#a21820f8294de0d75d863b72512a7c12f">dataSize</a></td></tr>
|
|
<tr class="memdesc:a21820f8294de0d75d863b72512a7c12f"><td class="mdescLeft"> </td><td class="mdescRight">The byte count to be transfer. <a href="#a21820f8294de0d75d863b72512a7c12f">More...</a><br/></td></tr>
|
|
<tr class="separator:a21820f8294de0d75d863b72512a7c12f"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table>
|
|
<h4 class="groupheader">Field Documentation</h4>
|
|
<a class="anchor" id="af91f05b0f951836e3002f60f0575f369"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">uint8_t* uart_transfer_t::data</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a21820f8294de0d75d863b72512a7c12f"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">size_t uart_transfer_t::dataSize</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
</div>
|
|
<a name="struct__uart__handle" id="struct__uart__handle"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">struct _uart_handle</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<div class="textblock"></div><table class="memberdecls">
|
|
<tr><td colspan="2"><h3>Data Fields</h3></td></tr>
|
|
<tr class="memitem:a046372eac11f58a16f519c0ee264ea9e"><td class="memItemLeft" align="right" valign="top">uint8_t *volatile </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#a046372eac11f58a16f519c0ee264ea9e">txData</a></td></tr>
|
|
<tr class="memdesc:a046372eac11f58a16f519c0ee264ea9e"><td class="mdescLeft"> </td><td class="mdescRight">Address of remaining data to send. <a href="#a046372eac11f58a16f519c0ee264ea9e">More...</a><br/></td></tr>
|
|
<tr class="separator:a046372eac11f58a16f519c0ee264ea9e"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a1e67a92b463ad328646834ea0de4d70d"><td class="memItemLeft" align="right" valign="top">volatile size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#a1e67a92b463ad328646834ea0de4d70d">txDataSize</a></td></tr>
|
|
<tr class="memdesc:a1e67a92b463ad328646834ea0de4d70d"><td class="mdescLeft"> </td><td class="mdescRight">Size of the remaining data to send. <a href="#a1e67a92b463ad328646834ea0de4d70d">More...</a><br/></td></tr>
|
|
<tr class="separator:a1e67a92b463ad328646834ea0de4d70d"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a80361474eb03b3aa30d02bda82adce65"><td class="memItemLeft" align="right" valign="top">size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#a80361474eb03b3aa30d02bda82adce65">txDataSizeAll</a></td></tr>
|
|
<tr class="memdesc:a80361474eb03b3aa30d02bda82adce65"><td class="mdescLeft"> </td><td class="mdescRight">Size of the data to send out. <a href="#a80361474eb03b3aa30d02bda82adce65">More...</a><br/></td></tr>
|
|
<tr class="separator:a80361474eb03b3aa30d02bda82adce65"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a5c87354702502998d3ccca9d9bfd3069"><td class="memItemLeft" align="right" valign="top">uint8_t *volatile </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#a5c87354702502998d3ccca9d9bfd3069">rxData</a></td></tr>
|
|
<tr class="memdesc:a5c87354702502998d3ccca9d9bfd3069"><td class="mdescLeft"> </td><td class="mdescRight">Address of remaining data to receive. <a href="#a5c87354702502998d3ccca9d9bfd3069">More...</a><br/></td></tr>
|
|
<tr class="separator:a5c87354702502998d3ccca9d9bfd3069"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a46bd84d885004806f89744ad79edd81e"><td class="memItemLeft" align="right" valign="top">volatile size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#a46bd84d885004806f89744ad79edd81e">rxDataSize</a></td></tr>
|
|
<tr class="memdesc:a46bd84d885004806f89744ad79edd81e"><td class="mdescLeft"> </td><td class="mdescRight">Size of the remaining data to receive. <a href="#a46bd84d885004806f89744ad79edd81e">More...</a><br/></td></tr>
|
|
<tr class="separator:a46bd84d885004806f89744ad79edd81e"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a800a05d5ea3c6240daad46f466a8fea4"><td class="memItemLeft" align="right" valign="top">size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#a800a05d5ea3c6240daad46f466a8fea4">rxDataSizeAll</a></td></tr>
|
|
<tr class="memdesc:a800a05d5ea3c6240daad46f466a8fea4"><td class="mdescLeft"> </td><td class="mdescRight">Size of the data to receive. <a href="#a800a05d5ea3c6240daad46f466a8fea4">More...</a><br/></td></tr>
|
|
<tr class="separator:a800a05d5ea3c6240daad46f466a8fea4"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:afeba8b549facc329937046e734681963"><td class="memItemLeft" align="right" valign="top">uint8_t * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#afeba8b549facc329937046e734681963">rxRingBuffer</a></td></tr>
|
|
<tr class="memdesc:afeba8b549facc329937046e734681963"><td class="mdescLeft"> </td><td class="mdescRight">Start address of the receiver ring buffer. <a href="#afeba8b549facc329937046e734681963">More...</a><br/></td></tr>
|
|
<tr class="separator:afeba8b549facc329937046e734681963"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a8d6afed4b64233c959a180b66686c14c"><td class="memItemLeft" align="right" valign="top">size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#a8d6afed4b64233c959a180b66686c14c">rxRingBufferSize</a></td></tr>
|
|
<tr class="memdesc:a8d6afed4b64233c959a180b66686c14c"><td class="mdescLeft"> </td><td class="mdescRight">Size of the ring buffer. <a href="#a8d6afed4b64233c959a180b66686c14c">More...</a><br/></td></tr>
|
|
<tr class="separator:a8d6afed4b64233c959a180b66686c14c"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a85d061606b31401fb4a9d0e22e77056c"><td class="memItemLeft" align="right" valign="top">volatile uint16_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#a85d061606b31401fb4a9d0e22e77056c">rxRingBufferHead</a></td></tr>
|
|
<tr class="memdesc:a85d061606b31401fb4a9d0e22e77056c"><td class="mdescLeft"> </td><td class="mdescRight">Index for the driver to store received data into ring buffer. <a href="#a85d061606b31401fb4a9d0e22e77056c">More...</a><br/></td></tr>
|
|
<tr class="separator:a85d061606b31401fb4a9d0e22e77056c"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a9f4482059188bea2603b1c07cf9cc084"><td class="memItemLeft" align="right" valign="top">volatile uint16_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#a9f4482059188bea2603b1c07cf9cc084">rxRingBufferTail</a></td></tr>
|
|
<tr class="memdesc:a9f4482059188bea2603b1c07cf9cc084"><td class="mdescLeft"> </td><td class="mdescRight">Index for the user to get data from the ring buffer. <a href="#a9f4482059188bea2603b1c07cf9cc084">More...</a><br/></td></tr>
|
|
<tr class="separator:a9f4482059188bea2603b1c07cf9cc084"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a2ef9706e8203ba72fa1e04c48581fb0f"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__uart__driver.html#gaf164fa4e12ff8a3e3f3997512001e007">uart_transfer_callback_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#a2ef9706e8203ba72fa1e04c48581fb0f">callback</a></td></tr>
|
|
<tr class="memdesc:a2ef9706e8203ba72fa1e04c48581fb0f"><td class="mdescLeft"> </td><td class="mdescRight">Callback function. <a href="#a2ef9706e8203ba72fa1e04c48581fb0f">More...</a><br/></td></tr>
|
|
<tr class="separator:a2ef9706e8203ba72fa1e04c48581fb0f"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a69ce1fdb7a2f60c0ecc94c4d1b2ed6ff"><td class="memItemLeft" align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#a69ce1fdb7a2f60c0ecc94c4d1b2ed6ff">userData</a></td></tr>
|
|
<tr class="memdesc:a69ce1fdb7a2f60c0ecc94c4d1b2ed6ff"><td class="mdescLeft"> </td><td class="mdescRight">UART callback function parameter. <a href="#a69ce1fdb7a2f60c0ecc94c4d1b2ed6ff">More...</a><br/></td></tr>
|
|
<tr class="separator:a69ce1fdb7a2f60c0ecc94c4d1b2ed6ff"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a9fa8f119b6e0e3a7805fb25edafb1498"><td class="memItemLeft" align="right" valign="top">volatile uint8_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#a9fa8f119b6e0e3a7805fb25edafb1498">txState</a></td></tr>
|
|
<tr class="memdesc:a9fa8f119b6e0e3a7805fb25edafb1498"><td class="mdescLeft"> </td><td class="mdescRight">TX transfer state. <a href="#a9fa8f119b6e0e3a7805fb25edafb1498">More...</a><br/></td></tr>
|
|
<tr class="separator:a9fa8f119b6e0e3a7805fb25edafb1498"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a5aa95f3d2cb81a8bb01a11ab2cf66234"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a5aa95f3d2cb81a8bb01a11ab2cf66234"></a>
|
|
volatile uint8_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__uart__driver.html#a5aa95f3d2cb81a8bb01a11ab2cf66234">rxState</a></td></tr>
|
|
<tr class="memdesc:a5aa95f3d2cb81a8bb01a11ab2cf66234"><td class="mdescLeft"> </td><td class="mdescRight">RX transfer state. <br/></td></tr>
|
|
<tr class="separator:a5aa95f3d2cb81a8bb01a11ab2cf66234"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table>
|
|
<h4 class="groupheader">Field Documentation</h4>
|
|
<a class="anchor" id="a046372eac11f58a16f519c0ee264ea9e"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">uint8_t* volatile uart_handle_t::txData</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a1e67a92b463ad328646834ea0de4d70d"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">volatile size_t uart_handle_t::txDataSize</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a80361474eb03b3aa30d02bda82adce65"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">size_t uart_handle_t::txDataSizeAll</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a5c87354702502998d3ccca9d9bfd3069"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">uint8_t* volatile uart_handle_t::rxData</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a46bd84d885004806f89744ad79edd81e"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">volatile size_t uart_handle_t::rxDataSize</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a800a05d5ea3c6240daad46f466a8fea4"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">size_t uart_handle_t::rxDataSizeAll</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="afeba8b549facc329937046e734681963"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">uint8_t* uart_handle_t::rxRingBuffer</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a8d6afed4b64233c959a180b66686c14c"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">size_t uart_handle_t::rxRingBufferSize</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a85d061606b31401fb4a9d0e22e77056c"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">volatile uint16_t uart_handle_t::rxRingBufferHead</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a9f4482059188bea2603b1c07cf9cc084"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">volatile uint16_t uart_handle_t::rxRingBufferTail</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a2ef9706e8203ba72fa1e04c48581fb0f"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname"><a class="el" href="group__uart__driver.html#gaf164fa4e12ff8a3e3f3997512001e007">uart_transfer_callback_t</a> uart_handle_t::callback</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a69ce1fdb7a2f60c0ecc94c4d1b2ed6ff"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void* uart_handle_t::userData</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a9fa8f119b6e0e3a7805fb25edafb1498"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">volatile uint8_t uart_handle_t::txState</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
</div>
|
|
<h2 class="groupheader">Macro Definition Documentation</h2>
|
|
<a class="anchor" id="ga89f9649bfe350eb7b1e53146f35d3de5"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">#define FSL_UART_DRIVER_VERSION   (<a class="el" href="group__flash__driver.html#ga812138aa3315b0c6953c1a26130bcc37">MAKE_VERSION</a>(2, 1, 0))</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
</div>
|
|
</div>
|
|
<h2 class="groupheader">Typedef Documentation</h2>
|
|
<a class="anchor" id="gaf164fa4e12ff8a3e3f3997512001e007"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">typedef void(* uart_transfer_callback_t)(UART_Type *base, uart_handle_t *handle, status_t status, void *userData)</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
</div>
|
|
</div>
|
|
<h2 class="groupheader">Enumeration Type Documentation</h2>
|
|
<a class="anchor" id="gacef40dc8e8ac174bfe40ebcbc980f84b"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">enum <a class="el" href="group__uart__driver.html#gacef40dc8e8ac174bfe40ebcbc980f84b">_uart_status</a></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<table class="fieldtable">
|
|
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><em><a class="anchor" id="ggacef40dc8e8ac174bfe40ebcbc980f84ba19ddee4fe5963467600028b78fb468e7"></a>kStatus_UART_TxBusy</em> </td><td class="fielddoc">
|
|
<p>Transmitter is busy. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="ggacef40dc8e8ac174bfe40ebcbc980f84ba68cf23f981c4b85f82291163fbb2a5e6"></a>kStatus_UART_RxBusy</em> </td><td class="fielddoc">
|
|
<p>Receiver is busy. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="ggacef40dc8e8ac174bfe40ebcbc980f84baf36c829b1b889517bf775c0d7ce29fa6"></a>kStatus_UART_TxIdle</em> </td><td class="fielddoc">
|
|
<p>UART transmitter is idle. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="ggacef40dc8e8ac174bfe40ebcbc980f84bae0877b14627ed2aa8ddb2bf5b033f407"></a>kStatus_UART_RxIdle</em> </td><td class="fielddoc">
|
|
<p>UART receiver is idle. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="ggacef40dc8e8ac174bfe40ebcbc980f84ba765913f003819ed87b861d187bf79ab8"></a>kStatus_UART_TxWatermarkTooLarge</em> </td><td class="fielddoc">
|
|
<p>TX FIFO watermark too large. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="ggacef40dc8e8ac174bfe40ebcbc980f84ba720cefde05389830f35f6e6df6f6ac67"></a>kStatus_UART_RxWatermarkTooLarge</em> </td><td class="fielddoc">
|
|
<p>RX FIFO watermark too large. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="ggacef40dc8e8ac174bfe40ebcbc980f84ba5ee8e23fc9ab20cf366942751b895f54"></a>kStatus_UART_FlagCannotClearManually</em> </td><td class="fielddoc">
|
|
<p>UART flag can't be manually cleared. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="ggacef40dc8e8ac174bfe40ebcbc980f84ba950972a9e2ebbaa13c92e8f5a51f785d"></a>kStatus_UART_Error</em> </td><td class="fielddoc">
|
|
<p>Error happens on UART. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="ggacef40dc8e8ac174bfe40ebcbc980f84ba2e5b644b1e10c426af818bc78657e992"></a>kStatus_UART_RxRingBufferOverrun</em> </td><td class="fielddoc">
|
|
<p>UART RX software ring buffer overrun. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="ggacef40dc8e8ac174bfe40ebcbc980f84bab6b1fd6c2deec25992449f5b12303a26"></a>kStatus_UART_RxHardwareOverrun</em> </td><td class="fielddoc">
|
|
<p>UART RX receiver overrun. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="ggacef40dc8e8ac174bfe40ebcbc980f84bae4ef4df9a5f756ccf1b4bf08292ec2fb"></a>kStatus_UART_NoiseError</em> </td><td class="fielddoc">
|
|
<p>UART noise error. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="ggacef40dc8e8ac174bfe40ebcbc980f84baa7aa134f85df3d5863ca962ce1ea7ee0"></a>kStatus_UART_FramingError</em> </td><td class="fielddoc">
|
|
<p>UART framing error. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="ggacef40dc8e8ac174bfe40ebcbc980f84baea20b2588c38f259f1412aa7132c9ef8"></a>kStatus_UART_ParityError</em> </td><td class="fielddoc">
|
|
<p>UART parity error. </p>
|
|
</td></tr>
|
|
</table>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="ga436e5a7bdb5f24decb5bfb0c87a83ff4"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">enum <a class="el" href="group__uart__driver.html#ga436e5a7bdb5f24decb5bfb0c87a83ff4">uart_parity_mode_t</a></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<table class="fieldtable">
|
|
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><em><a class="anchor" id="gga436e5a7bdb5f24decb5bfb0c87a83ff4a97e2feae6671a6de1126ebc2edf4606b"></a>kUART_ParityDisabled</em> </td><td class="fielddoc">
|
|
<p>Parity disabled. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="gga436e5a7bdb5f24decb5bfb0c87a83ff4a9e68fe3aba46e045bee5433ed098bff0"></a>kUART_ParityEven</em> </td><td class="fielddoc">
|
|
<p>Parity enabled, type even, bit setting: PE|PT = 10. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="gga436e5a7bdb5f24decb5bfb0c87a83ff4ae48c7fabc9babf1be626ebeb2627a54c"></a>kUART_ParityOdd</em> </td><td class="fielddoc">
|
|
<p>Parity enabled, type odd, bit setting: PE|PT = 11. </p>
|
|
</td></tr>
|
|
</table>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="gaca4f14d23735c6afefb76cbee18e1db6"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">enum <a class="el" href="group__uart__driver.html#gaca4f14d23735c6afefb76cbee18e1db6">uart_stop_bit_count_t</a></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<table class="fieldtable">
|
|
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><em><a class="anchor" id="ggaca4f14d23735c6afefb76cbee18e1db6a5a8829a108d8a46abb097a36cde051a7"></a>kUART_OneStopBit</em> </td><td class="fielddoc">
|
|
<p>One stop bit. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="ggaca4f14d23735c6afefb76cbee18e1db6a9704b3ae3ee851acf324eb357f75ab56"></a>kUART_TwoStopBit</em> </td><td class="fielddoc">
|
|
<p>Two stop bits. </p>
|
|
</td></tr>
|
|
</table>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="ga700f3cd8e3800273a1591307cab6311c"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">enum <a class="el" href="group__uart__driver.html#ga700f3cd8e3800273a1591307cab6311c">_uart_interrupt_enable</a></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This structure contains the settings for all of the UART interrupt configurations. </p>
|
|
<table class="fieldtable">
|
|
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><em><a class="anchor" id="gga700f3cd8e3800273a1591307cab6311ca71755319c216d0bdf79729c18c24cf64"></a>kUART_RxActiveEdgeInterruptEnable</em> </td><td class="fielddoc">
|
|
<p>RX active edge interrupt. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="gga700f3cd8e3800273a1591307cab6311ca5a0870233f2ffa8f5ca60d80f1e3ed14"></a>kUART_TxDataRegEmptyInterruptEnable</em> </td><td class="fielddoc">
|
|
<p>Transmit data register empty interrupt. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="gga700f3cd8e3800273a1591307cab6311cafd337213dae85b532dfaf9a90e2e5d7b"></a>kUART_TransmissionCompleteInterruptEnable</em> </td><td class="fielddoc">
|
|
<p>Transmission complete interrupt. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="gga700f3cd8e3800273a1591307cab6311cac8a751a334e172413ab833cb0ccb01c3"></a>kUART_RxDataRegFullInterruptEnable</em> </td><td class="fielddoc">
|
|
<p>Receiver data register full interrupt. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="gga700f3cd8e3800273a1591307cab6311ca078ea32d8587f92337a3dee495a1ceed"></a>kUART_IdleLineInterruptEnable</em> </td><td class="fielddoc">
|
|
<p>Idle line interrupt. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="gga700f3cd8e3800273a1591307cab6311ca3e85b14c1b64dbfef1d0b4b7bc39c19d"></a>kUART_RxOverrunInterruptEnable</em> </td><td class="fielddoc">
|
|
<p>Receiver overrun interrupt. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="gga700f3cd8e3800273a1591307cab6311ca53d0fe2bb0cd90198c632f08488af4b3"></a>kUART_NoiseErrorInterruptEnable</em> </td><td class="fielddoc">
|
|
<p>Noise error flag interrupt. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="gga700f3cd8e3800273a1591307cab6311ca00a387446d0ca7fd843968eca8af22a5"></a>kUART_FramingErrorInterruptEnable</em> </td><td class="fielddoc">
|
|
<p>Framing error flag interrupt. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="gga700f3cd8e3800273a1591307cab6311cadc2475fa65313c6f1d13b36f0443b20a"></a>kUART_ParityErrorInterruptEnable</em> </td><td class="fielddoc">
|
|
<p>Parity error flag interrupt. </p>
|
|
</td></tr>
|
|
</table>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="ga259a53f363288115306a45d08fc66eb8"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">enum <a class="el" href="group__uart__driver.html#ga259a53f363288115306a45d08fc66eb8">_uart_flags</a></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This provides constants for the UART status flags for use in the UART functions. </p>
|
|
<table class="fieldtable">
|
|
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><em><a class="anchor" id="gga259a53f363288115306a45d08fc66eb8a5209c671b2f2f064dc512655387e9e1a"></a>kUART_TxDataRegEmptyFlag</em> </td><td class="fielddoc">
|
|
<p>TX data register empty flag. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="gga259a53f363288115306a45d08fc66eb8a4468b60b2d78c34b93c9199df9e95d3a"></a>kUART_TransmissionCompleteFlag</em> </td><td class="fielddoc">
|
|
<p>Transmission complete flag. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="gga259a53f363288115306a45d08fc66eb8aa86a34b2ea609eeeb63f98fea498e540"></a>kUART_RxDataRegFullFlag</em> </td><td class="fielddoc">
|
|
<p>RX data register full flag. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="gga259a53f363288115306a45d08fc66eb8ab2fc4e1b1164ed3e3fe7e19a39029b2c"></a>kUART_IdleLineFlag</em> </td><td class="fielddoc">
|
|
<p>Idle line detect flag. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="gga259a53f363288115306a45d08fc66eb8a93d3c56466b4656dcce08d9323d7afd8"></a>kUART_RxOverrunFlag</em> </td><td class="fielddoc">
|
|
<p>RX overrun flag. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="gga259a53f363288115306a45d08fc66eb8abd56419f102fb01c7bbc2c38f81ab360"></a>kUART_NoiseErrorFlag</em> </td><td class="fielddoc">
|
|
<p>RX takes 3 samples of each received bit. </p>
|
|
<p>If any of these samples differ, noise flag sets </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="gga259a53f363288115306a45d08fc66eb8aade5071fa56646adcda3562051443868"></a>kUART_FramingErrorFlag</em> </td><td class="fielddoc">
|
|
<p>Frame error flag, sets if logic 0 was detected where stop bit expected. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="gga259a53f363288115306a45d08fc66eb8a0c92973ab1d527115fa01934c62a053d"></a>kUART_ParityErrorFlag</em> </td><td class="fielddoc">
|
|
<p>If parity enabled, sets upon parity error detection. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="gga259a53f363288115306a45d08fc66eb8adcfe89feb164ff5b1720312922006a7a"></a>kUART_RxActiveEdgeFlag</em> </td><td class="fielddoc">
|
|
<p>RX pin active edge interrupt flag, sets when active edge detected. </p>
|
|
</td></tr>
|
|
<tr><td class="fieldname"><em><a class="anchor" id="gga259a53f363288115306a45d08fc66eb8a7a4521cd44a3272a94784670d1bf5a0c"></a>kUART_RxActiveFlag</em> </td><td class="fielddoc">
|
|
<p>Receiver Active Flag (RAF), sets at beginning of valid start bit. </p>
|
|
</td></tr>
|
|
</table>
|
|
|
|
</div>
|
|
</div>
|
|
<h2 class="groupheader">Function Documentation</h2>
|
|
<a class="anchor" id="gaa6162686a1aced16ff39c7d54d81fe5b"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void UART_Init </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">const <a class="el" href="group__uart__driver.html#structuart__config__t">uart_config_t</a> * </td>
|
|
<td class="paramname"><em>config</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">uint32_t </td>
|
|
<td class="paramname"><em>srcClock_Hz</em> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function configures the UART module with the user-defined settings. The user can configure the configuration structure and also get the default configuration by using the <a class="el" href="group__uart__driver.html#ga47c7c09e04a0497f4530d553e27d96c5" title="Gets the default configuration structure. ">UART_GetDefaultConfig()</a> function. Example below shows how to use this API to configure UART. </p>
|
|
<div class="fragment"><div class="line"><a class="code" href="group__uart__driver.html#structuart__config__t">uart_config_t</a> uartConfig;</div>
|
|
<div class="line">uartConfig.<a class="code" href="group__uart__driver.html#acc123668836f3432c54ee6a2f6f318f1">baudRate_Bps</a> = 115200U;</div>
|
|
<div class="line">uartConfig.<a class="code" href="group__uart__driver.html#a1a3abcf4f0f5d0a3893df14f2991aa39">parityMode</a> = <a class="code" href="group__uart__driver.html#gga436e5a7bdb5f24decb5bfb0c87a83ff4a97e2feae6671a6de1126ebc2edf4606b">kUART_ParityDisabled</a>;</div>
|
|
<div class="line">uartConfig.stopBitCount = <a class="code" href="group__uart__driver.html#ggaca4f14d23735c6afefb76cbee18e1db6a5a8829a108d8a46abb097a36cde051a7">kUART_OneStopBit</a>;</div>
|
|
<div class="line">uartConfig.txFifoWatermark = 0;</div>
|
|
<div class="line">uartConfig.rxFifoWatermark = 1;</div>
|
|
<div class="line"><a class="code" href="group__uart__driver.html#gaa6162686a1aced16ff39c7d54d81fe5b">UART_Init</a>(UART1, &uartConfig, 20000000U);</div>
|
|
</div><!-- fragment --><dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
<tr><td class="paramname">config</td><td>Pointer to user-defined configuration structure. </td></tr>
|
|
<tr><td class="paramname">srcClock_Hz</td><td>UART clock source frequency in HZ. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="ga3ff48bc211831be33e6fe5c50eb671a0"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void UART_Deinit </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function waits for TX complete, disables TX and RX, and disables the UART clock.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="ga47c7c09e04a0497f4530d553e27d96c5"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void UART_GetDefaultConfig </td>
|
|
<td>(</td>
|
|
<td class="paramtype"><a class="el" href="group__uart__driver.html#structuart__config__t">uart_config_t</a> * </td>
|
|
<td class="paramname"><em>config</em></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function initializes the UART configuration structure to a default value. The default values are: uartConfig->baudRate_Bps = 115200U; uartConfig->bitCountPerChar = kUART_8BitsPerChar; uartConfig->parityMode = kUART_ParityDisabled; uartConfig->stopBitCount = kUART_OneStopBit; uartConfig->txFifoWatermark = 0; uartConfig->rxFifoWatermark = 1; uartConfig->enableTx = false; uartConfig->enableRx = false;</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">config</td><td>Pointer to configuration structure. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="gae0482730b0d5f6b7f8d12aba1e4044e5"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void UART_SetBaudRate </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">uint32_t </td>
|
|
<td class="paramname"><em>baudRate_Bps</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">uint32_t </td>
|
|
<td class="paramname"><em>srcClock_Hz</em> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function configures the UART module baud rate. This function is used to update the UART module baud rate after the UART module is initialized by the UART_Init. </p>
|
|
<div class="fragment"><div class="line"><a class="code" href="group__uart__driver.html#gae0482730b0d5f6b7f8d12aba1e4044e5">UART_SetBaudRate</a>(UART1, 115200U, 20000000U);</div>
|
|
</div><!-- fragment --><dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
<tr><td class="paramname">baudRate_Bps</td><td>UART baudrate to be set. </td></tr>
|
|
<tr><td class="paramname">srcClock_Hz</td><td>UART clock source freqency in HZ. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="ga28bf715678c0d3c8c3902e79455ee923"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">uint32_t UART_GetStatusFlags </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function get all UART status flags, the flags are returned as the logical OR value of the enumerators <a class="el" href="group__uart__driver.html#ga259a53f363288115306a45d08fc66eb8">_uart_flags</a>. To check specific status, compare the return value with enumerators in <a class="el" href="group__uart__driver.html#ga259a53f363288115306a45d08fc66eb8">_uart_flags</a>. For example, to check whether the TX is empty: </p>
|
|
<div class="fragment"><div class="line"><span class="keywordflow">if</span> (<a class="code" href="group__uart__driver.html#gga259a53f363288115306a45d08fc66eb8a5209c671b2f2f064dc512655387e9e1a">kUART_TxDataRegEmptyFlag</a> & <a class="code" href="group__uart__driver.html#ga28bf715678c0d3c8c3902e79455ee923">UART_GetStatusFlags</a>(UART1))</div>
|
|
<div class="line">{</div>
|
|
<div class="line"> ...</div>
|
|
<div class="line">}</div>
|
|
</div><!-- fragment --><dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section return"><dt>Returns</dt><dd>UART status flags which are ORed by the enumerators in the _uart_flags. </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="gacc4cb85534361f836edca9454a6426c6"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">status_t UART_ClearStatusFlags </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">uint32_t </td>
|
|
<td class="paramname"><em>mask</em> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function clears UART status flags with a provided mask. Automatically cleared flag can't be cleared by this function. Some flags can only be cleared or set by hardware itself. These flags are: kUART_TxDataRegEmptyFlag, kUART_TransmissionCompleteFlag, kUART_RxDataRegFullFlag, kUART_RxActiveFlag, kUART_NoiseErrorInRxDataRegFlag, kUART_ParityErrorInRxDataRegFlag, kUART_TxFifoEmptyFlag,kUART_RxFifoEmptyFlag Note: This API should be called when the Tx/Rx is idle, otherwise it takes no effects.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
<tr><td class="paramname">mask</td><td>The status flags to be cleared, it is logical OR value of <a class="el" href="group__uart__driver.html#ga259a53f363288115306a45d08fc66eb8">_uart_flags</a>. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="retval"><dt>Return values</dt><dd>
|
|
<table class="retval">
|
|
<tr><td class="paramname">kStatus_UART_FlagCannotClearManually</td><td>The flag can't be cleared by this function but it is cleared automatically by hardware. </td></tr>
|
|
<tr><td class="paramname">kStatus_Success</td><td>Status in the mask are cleared. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="ga49ecd761481a22956e3f46285038719c"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void UART_EnableInterrupts </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">uint32_t </td>
|
|
<td class="paramname"><em>mask</em> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function enables the UART interrupts according to the provided mask. The mask is a logical OR of enumeration members. See <a class="el" href="group__uart__driver.html#ga700f3cd8e3800273a1591307cab6311c">_uart_interrupt_enable</a>. For example, to enable TX empty interrupt and RX full interrupt: </p>
|
|
<div class="fragment"><div class="line"><a class="code" href="group__uart__driver.html#ga49ecd761481a22956e3f46285038719c">UART_EnableInterrupts</a>(UART1,<a class="code" href="group__uart__driver.html#gga700f3cd8e3800273a1591307cab6311ca5a0870233f2ffa8f5ca60d80f1e3ed14">kUART_TxDataRegEmptyInterruptEnable</a> | <a class="code" href="group__uart__driver.html#gga700f3cd8e3800273a1591307cab6311cac8a751a334e172413ab833cb0ccb01c3">kUART_RxDataRegFullInterruptEnable</a>);</div>
|
|
</div><!-- fragment --><dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
<tr><td class="paramname">mask</td><td>The interrupts to enable. Logical OR of <a class="el" href="group__uart__driver.html#ga700f3cd8e3800273a1591307cab6311c">_uart_interrupt_enable</a>. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="ga3f24b6b9b730046a9a81918f9abe7d99"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void UART_DisableInterrupts </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">uint32_t </td>
|
|
<td class="paramname"><em>mask</em> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function disables the UART interrupts according to the provided mask. The mask is a logical OR of enumeration members. See <a class="el" href="group__uart__driver.html#ga700f3cd8e3800273a1591307cab6311c">_uart_interrupt_enable</a>. For example, to disable TX empty interrupt and RX full interrupt: </p>
|
|
<div class="fragment"><div class="line"><a class="code" href="group__uart__driver.html#ga3f24b6b9b730046a9a81918f9abe7d99">UART_DisableInterrupts</a>(UART1,<a class="code" href="group__uart__driver.html#gga700f3cd8e3800273a1591307cab6311ca5a0870233f2ffa8f5ca60d80f1e3ed14">kUART_TxDataRegEmptyInterruptEnable</a> | <a class="code" href="group__uart__driver.html#gga700f3cd8e3800273a1591307cab6311cac8a751a334e172413ab833cb0ccb01c3">kUART_RxDataRegFullInterruptEnable</a>);</div>
|
|
</div><!-- fragment --><dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
<tr><td class="paramname">mask</td><td>The interrupts to disable. Logical OR of <a class="el" href="group__uart__driver.html#ga700f3cd8e3800273a1591307cab6311c">_uart_interrupt_enable</a>. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="ga79bc0b880286ec0dc0543606fc772912"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">uint32_t UART_GetEnabledInterrupts </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function gets the enabled UART interrupts. The enabled interrupts are returned as the logical OR value of the enumerators <a class="el" href="group__uart__driver.html#ga700f3cd8e3800273a1591307cab6311c">_uart_interrupt_enable</a>. To check specific interrupts enable status, compare the return value with enumerators in <a class="el" href="group__uart__driver.html#ga700f3cd8e3800273a1591307cab6311c">_uart_interrupt_enable</a>. For example, to check whether TX empty interrupt is enabled: </p>
|
|
<div class="fragment"><div class="line">uint32_t enabledInterrupts = <a class="code" href="group__uart__driver.html#ga79bc0b880286ec0dc0543606fc772912">UART_GetEnabledInterrupts</a>(UART1);</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="keywordflow">if</span> (<a class="code" href="group__uart__driver.html#gga700f3cd8e3800273a1591307cab6311ca5a0870233f2ffa8f5ca60d80f1e3ed14">kUART_TxDataRegEmptyInterruptEnable</a> & enabledInterrupts)</div>
|
|
<div class="line">{</div>
|
|
<div class="line"> ...</div>
|
|
<div class="line">}</div>
|
|
</div><!-- fragment --><dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section return"><dt>Returns</dt><dd>UART interrupt flags which are logical OR of the enumerators in <a class="el" href="group__uart__driver.html#ga700f3cd8e3800273a1591307cab6311c">_uart_interrupt_enable</a>. </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="gaf2ed68f3dd6ee8a272e9afd8ebd84f93"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">static void UART_EnableTx </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">bool </td>
|
|
<td class="paramname"><em>enable</em> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function enables or disables the UART transmitter.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
<tr><td class="paramname">enable</td><td>True to enable, false to disable. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="gaa503e36c8ce82f1042ce186b9863871f"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">static void UART_EnableRx </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">bool </td>
|
|
<td class="paramname"><em>enable</em> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function enables or disables the UART receiver.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
<tr><td class="paramname">enable</td><td>True to enable, false to disable. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="ga371d2ceda535de3a74beba5a3465fab0"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">static void UART_WriteByte </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">uint8_t </td>
|
|
<td class="paramname"><em>data</em> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function writes data to the TX register directly. The upper layer must ensure that the TX register is empty or TX FIFO has empty room before calling this function.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
<tr><td class="paramname">data</td><td>The byte to write. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="ga3728011ac7906f3e03bb677b0f9cf7b4"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">static uint8_t UART_ReadByte </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function reads data from the TX register directly. The upper layer must ensure that the RX register is full or that the TX FIFO has data before calling this function.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section return"><dt>Returns</dt><dd>The byte read from UART data register. </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="gad67794d80b7ee2d3292b41af6ff1e100"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void UART_WriteBlocking </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">const uint8_t * </td>
|
|
<td class="paramname"><em>data</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">size_t </td>
|
|
<td class="paramname"><em>length</em> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function polls the TX register, waits for the TX register to be empty or for the TX FIFO to have room and writes data to the TX buffer.</p>
|
|
<dl class="section note"><dt>Note</dt><dd>This function does not check whether all the data has been sent out to the bus. Before disabling the TX, check kUART_TransmissionCompleteFlag to ensure that the TX is finished.</dd></dl>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
<tr><td class="paramname">data</td><td>Start address of the data to write. </td></tr>
|
|
<tr><td class="paramname">length</td><td>Size of the data to write. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="ga39d59e8a94f1af451a0db81888596639"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">status_t UART_ReadBlocking </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">uint8_t * </td>
|
|
<td class="paramname"><em>data</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">size_t </td>
|
|
<td class="paramname"><em>length</em> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function polls the RX register, waits for the RX register to be full or for RX FIFO to have data and read data from the TX register.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
<tr><td class="paramname">data</td><td>Start address of the buffer to store the received data. </td></tr>
|
|
<tr><td class="paramname">length</td><td>Size of the buffer. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="retval"><dt>Return values</dt><dd>
|
|
<table class="retval">
|
|
<tr><td class="paramname">kStatus_UART_RxHardwareOverrun</td><td>Receiver overrun happened while receiving data. </td></tr>
|
|
<tr><td class="paramname">kStatus_UART_NoiseError</td><td>Noise error happened while receiving data. </td></tr>
|
|
<tr><td class="paramname">kStatus_UART_FramingError</td><td>Framing error happened while receiving data. </td></tr>
|
|
<tr><td class="paramname">kStatus_UART_ParityError</td><td>Parity error happened while receiving data. </td></tr>
|
|
<tr><td class="paramname">kStatus_Success</td><td>Successfully received all data. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="ga63db308c32019b7dd6c0647d618e5247"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void UART_TransferCreateHandle </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">uart_handle_t * </td>
|
|
<td class="paramname"><em>handle</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype"><a class="el" href="group__uart__driver.html#gaf164fa4e12ff8a3e3f3997512001e007">uart_transfer_callback_t</a> </td>
|
|
<td class="paramname"><em>callback</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">void * </td>
|
|
<td class="paramname"><em>userData</em> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function initializes the UART handle which can be used for other UART transactional APIs. Usually, for a specified UART instance, call this API once to get the initialized handle.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
<tr><td class="paramname">handle</td><td>UART handle pointer. </td></tr>
|
|
<tr><td class="paramname">callback</td><td>The callback function. </td></tr>
|
|
<tr><td class="paramname">userData</td><td>The parameter of the callback function. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="ga223fba584bfabd599629d5ce92f929ac"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void UART_TransferStartRingBuffer </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">uart_handle_t * </td>
|
|
<td class="paramname"><em>handle</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">uint8_t * </td>
|
|
<td class="paramname"><em>ringBuffer</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">size_t </td>
|
|
<td class="paramname"><em>ringBufferSize</em> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function sets up the RX ring buffer to a specific UART handle.</p>
|
|
<p>When the RX ring buffer is used, data received are stored into the ring buffer even when the user doesn't call the <a class="el" href="group__uart__driver.html#gaf804acde5d73ce0a5bf54b06195e1218" title="Receives a buffer of data using an interrupt method. ">UART_TransferReceiveNonBlocking()</a> API. If there is already data received in the ring buffer, the user can get the received data from the ring buffer directly.</p>
|
|
<dl class="section note"><dt>Note</dt><dd>When using the RX ring buffer, one byte is reserved for internal use. In other words, if <code>ringBufferSize</code> is 32, then only 31 bytes are used for saving data.</dd></dl>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
<tr><td class="paramname">handle</td><td>UART handle pointer. </td></tr>
|
|
<tr><td class="paramname">ringBuffer</td><td>Start address of the ring buffer for background receiving. Pass NULL to disable the ring buffer. </td></tr>
|
|
<tr><td class="paramname">ringBufferSize</td><td>size of the ring buffer. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="ga0c0bc73df49cb31dff0e903630314f5b"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void UART_TransferStopRingBuffer </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">uart_handle_t * </td>
|
|
<td class="paramname"><em>handle</em> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function aborts the background transfer and uninstalls the ring buffer.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
<tr><td class="paramname">handle</td><td>UART handle pointer. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="gad89afd7db1656c5aef404bb285d0dc05"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">status_t UART_TransferSendNonBlocking </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">uart_handle_t * </td>
|
|
<td class="paramname"><em>handle</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype"><a class="el" href="group__uart__driver.html#structuart__transfer__t">uart_transfer_t</a> * </td>
|
|
<td class="paramname"><em>xfer</em> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function sends data using an interrupt method. This is a non-blocking function, which returns directly without waiting for all data to be written to the TX register. When all data is written to the TX register in the ISR, the UART driver calls the callback function and passes the <a class="el" href="group__uart__driver.html#ggacef40dc8e8ac174bfe40ebcbc980f84baf36c829b1b889517bf775c0d7ce29fa6">kStatus_UART_TxIdle</a> as status parameter.</p>
|
|
<dl class="section note"><dt>Note</dt><dd>The kStatus_UART_TxIdle is passed to the upper layer when all data is written to the TX register. However it does not ensure that all data are sent out. Before disabling the TX, check the kUART_TransmissionCompleteFlag to ensure that the TX is finished.</dd></dl>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
<tr><td class="paramname">handle</td><td>UART handle pointer. </td></tr>
|
|
<tr><td class="paramname">xfer</td><td>UART transfer structure. See <a class="el" href="group__uart__driver.html#structuart__transfer__t" title="UART transfer structure. ">uart_transfer_t</a>. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="retval"><dt>Return values</dt><dd>
|
|
<table class="retval">
|
|
<tr><td class="paramname">kStatus_Success</td><td>Successfully start the data transmission. </td></tr>
|
|
<tr><td class="paramname">kStatus_UART_TxBusy</td><td>Previous transmission still not finished, data not all written to TX register yet. </td></tr>
|
|
<tr><td class="paramname">kStatus_InvalidArgument</td><td>Invalid argument. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="gaa64f9f89d8286fd3ef0736a8c40be2c2"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void UART_TransferAbortSend </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">uart_handle_t * </td>
|
|
<td class="paramname"><em>handle</em> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function aborts the interrupt driven data sending. The user can get the remainBytes to find out how many bytes are still not sent out.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
<tr><td class="paramname">handle</td><td>UART handle pointer. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="ga071727ba05b2937ef5ad641ca7faf9c7"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">status_t UART_TransferGetSendCount </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">uart_handle_t * </td>
|
|
<td class="paramname"><em>handle</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">uint32_t * </td>
|
|
<td class="paramname"><em>count</em> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function gets the number of bytes that have been written to UART TX register by interrupt method.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
<tr><td class="paramname">handle</td><td>UART handle pointer. </td></tr>
|
|
<tr><td class="paramname">count</td><td>Send bytes count. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="retval"><dt>Return values</dt><dd>
|
|
<table class="retval">
|
|
<tr><td class="paramname">kStatus_NoTransferInProgress</td><td>No send in progress. </td></tr>
|
|
<tr><td class="paramname">kStatus_InvalidArgument</td><td>Parameter is invalid. </td></tr>
|
|
<tr><td class="paramname">kStatus_Success</td><td>Get successfully through the parameter <code>count</code>; </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="gaf804acde5d73ce0a5bf54b06195e1218"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">status_t UART_TransferReceiveNonBlocking </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">uart_handle_t * </td>
|
|
<td class="paramname"><em>handle</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype"><a class="el" href="group__uart__driver.html#structuart__transfer__t">uart_transfer_t</a> * </td>
|
|
<td class="paramname"><em>xfer</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">size_t * </td>
|
|
<td class="paramname"><em>receivedBytes</em> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function receives data using an interrupt method. This is a non-blocking function, which returns without waiting for all data to be received. If the RX ring buffer is used and not empty, the data in the ring buffer is copied and the parameter <code>receivedBytes</code> shows how many bytes are copied from the ring buffer. After copying, if the data in the ring buffer is not enough to read, the receive request is saved by the UART driver. When the new data arrives, the receive request is serviced first. When all data is received, the UART driver notifies the upper layer through a callback function and passes the status parameter <a class="el" href="group__uart__driver.html#ggacef40dc8e8ac174bfe40ebcbc980f84bae0877b14627ed2aa8ddb2bf5b033f407">kStatus_UART_RxIdle</a>. For example, the upper layer needs 10 bytes but there are only 5 bytes in the ring buffer. The 5 bytes are copied to the xfer->data and this function returns with the parameter <code>receivedBytes</code> set to 5. For the left 5 bytes, newly arrived data is saved from the xfer->data[5]. When 5 bytes are received, the UART driver notifies the upper layer. If the RX ring buffer is not enabled, this function enables the RX and RX interrupt to receive data to the xfer->data. When all data is received, the upper layer is notified.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
<tr><td class="paramname">handle</td><td>UART handle pointer. </td></tr>
|
|
<tr><td class="paramname">xfer</td><td>UART transfer structure, refer to <a class="el" href="group__uart__driver.html#structuart__transfer__t" title="UART transfer structure. ">uart_transfer_t</a>. </td></tr>
|
|
<tr><td class="paramname">receivedBytes</td><td>Bytes received from the ring buffer directly. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="retval"><dt>Return values</dt><dd>
|
|
<table class="retval">
|
|
<tr><td class="paramname">kStatus_Success</td><td>Successfully queue the transfer into transmit queue. </td></tr>
|
|
<tr><td class="paramname">kStatus_UART_RxBusy</td><td>Previous receive request is not finished. </td></tr>
|
|
<tr><td class="paramname">kStatus_InvalidArgument</td><td>Invalid argument. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="gacc35671622b2401545cc55cc6ae572d4"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void UART_TransferAbortReceive </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">uart_handle_t * </td>
|
|
<td class="paramname"><em>handle</em> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function aborts the interrupt-driven data receiving. The user can get the remainBytes to know how many bytes not received yet.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
<tr><td class="paramname">handle</td><td>UART handle pointer. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="ga05df10f570cdca4ac2dff63b069d254e"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">status_t UART_TransferGetReceiveCount </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">uart_handle_t * </td>
|
|
<td class="paramname"><em>handle</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">uint32_t * </td>
|
|
<td class="paramname"><em>count</em> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function gets the number of bytes that have been received.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
<tr><td class="paramname">handle</td><td>UART handle pointer. </td></tr>
|
|
<tr><td class="paramname">count</td><td>Receive bytes count. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="retval"><dt>Return values</dt><dd>
|
|
<table class="retval">
|
|
<tr><td class="paramname">kStatus_NoTransferInProgress</td><td>No receive in progress. </td></tr>
|
|
<tr><td class="paramname">kStatus_InvalidArgument</td><td>Parameter is invalid. </td></tr>
|
|
<tr><td class="paramname">kStatus_Success</td><td>Get successfully through the parameter <code>count</code>; </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="gadb0c4f1e5b59db3aa2261df4f5ddb48d"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void UART_TransferHandleIRQ </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">uart_handle_t * </td>
|
|
<td class="paramname"><em>handle</em> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function handles the UART transmit and receive IRQ request.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
<tr><td class="paramname">handle</td><td>UART handle pointer. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="gafc364352e879f53138ee1107e3da0a7d"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void UART_TransferHandleErrorIRQ </td>
|
|
<td>(</td>
|
|
<td class="paramtype">UART_Type * </td>
|
|
<td class="paramname"><em>base</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">uart_handle_t * </td>
|
|
<td class="paramname"><em>handle</em> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
<p>This function handle the UART error IRQ request.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">base</td><td>UART peripheral base address. </td></tr>
|
|
<tr><td class="paramname">handle</td><td>UART handle pointer. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
</div>
|
|
</div><!-- contents -->
|
|
</div><!-- doc-content -->
|
|
<!-- HTML footer for doxygen 1.8.5-->
|
|
<!-- start footer part -->
|
|
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
|
|
<ul class="foot">
|
|
<li class="footer">© 2016 NXP Semiconductors. All rights reserved.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</body>
|
|
</html>
|