346 lines
27 KiB
HTML
346 lines
27 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.5"/>
|
|
<title>MCUXpresso SDK API Reference Manual: I2C: Inter-Integrated Circuit 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">MCUXpresso SDK API Reference Manual
|
|
 <span id="projectnumber">Rev 2.15.000</span>
|
|
</div>
|
|
<div id="projectbrief">NXP Semiconductors</div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<!-- end header part -->
|
|
<!-- Generated by Doxygen 1.8.5 -->
|
|
<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('a00245.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> </div>
|
|
<div class="headertitle">
|
|
<div class="title">I2C: Inter-Integrated Circuit Driver</div> </div>
|
|
</div><!--header-->
|
|
<div class="contents">
|
|
<a name="details" id="details"></a><h2 class="groupheader">Overview</h2>
|
|
<p>The MCUXpresso SDK provides a peripheral driver for the Inter-Integrated Circuit (I2C) module of MCUXpresso SDK devices.</p>
|
|
<p>The I2C driver includes functional APIs and transactional APIs.</p>
|
|
<p>Functional APIs are feature/property target low-level APIs. Functional APIs can be used for the I2C master/slave initialization/configuration/operation for optimization/customization purpose. Using the functional APIs requires the knowledge of the I2C master peripheral and how to organize functional APIs to meet the application requirements. The I2C functional operation groups provide the functional APIs set.</p>
|
|
<p>Transactional APIs are transaction target high-level APIs. The transactional APIs can be used to enable the peripheral quickly and also in the application if the code size and performance of transactional APIs satisfy the requirements. If the code size and performance are critical requirements, see the transactional API implementation and write custom code using the functional APIs or accessing the hardware registers.</p>
|
|
<p>Transactional APIs support asynchronous transfer. This means that the functions <a class="el" href="a00028.html#gac7f76a04b6f6873c52ad176d58901fe9" title="Performs a non-blocking transaction on the I2C bus. ">I2C_MasterTransferNonBlocking()</a> set up the interrupt non-blocking transfer. When the transfer completes, the upper layer is notified through a callback function with the status.</p>
|
|
<h1><a class="anchor" id="I2CTpyUC"></a>
|
|
Typical use case</h1>
|
|
<h2><a class="anchor" id="I2CMasterOpsFunctional"></a>
|
|
Master Operation in functional method</h2>
|
|
<div class="fragment"><div class="line"><a class="code" href="a00028.html#a00342">i2c_master_config_t</a> masterConfig;</div>
|
|
<div class="line">uint8_t status;</div>
|
|
<div class="line"><a class="code" href="a00242.html#gaaabdaf7ee58ca7269bd4bf24efcde092">status_t</a> result = <a class="code" href="a00242.html#ggadf764cbdea00d65edcd07bb9953ad2b7a829bee76c6b02225d9c891ae8ef70881">kStatus_Success</a>;</div>
|
|
<div class="line">uint8_t txBuff[BUFFER_SIZE];</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="comment">/* Get default configuration for master. */</span></div>
|
|
<div class="line"><a class="code" href="a00028.html#gad69f2d63ea756dda60749ff6b09f587d">I2C_MasterGetDefaultConfig</a>(&masterConfig);</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="comment">/* Init I2C master. */</span></div>
|
|
<div class="line"><a class="code" href="a00028.html#ga29f967b3ae8487a36ba2a58deb01ccae">I2C_MasterInit</a>(EXAMPLE_I2C_MASTER_BASEADDR, &masterConfig, I2C_MASTER_CLK);</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="comment">/* Send start and slave address. */</span></div>
|
|
<div class="line"><a class="code" href="a00028.html#ga7664234966e4162e952b6d57efcaa8a6">I2C_MasterStart</a>(EXAMPLE_I2C_MASTER_BASEADDR, 7-bit slave address, <a class="code" href="a00028.html#gga1625497320644ba123718bafdd2c1f39a93b476b469c2a4bfed5916b458ae9bb0">kI2C_Write</a>/<a class="code" href="a00028.html#gga1625497320644ba123718bafdd2c1f39a3a7bb24dc8d1c1be8925603eeafe9b30">kI2C_Read</a>);</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="comment">/* Wait address sent out. */</span></div>
|
|
<div class="line"><span class="keywordflow">while</span>(!((status = I2C_GetStatusFlag(EXAMPLE_I2C_MASTER_BASEADDR)) & kI2C_IntPendingFlag))</div>
|
|
<div class="line">{</div>
|
|
<div class="line"></div>
|
|
<div class="line">}</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="keywordflow">if</span>(status & kI2C_ReceiveNakFlag)</div>
|
|
<div class="line">{</div>
|
|
<div class="line"> <span class="keywordflow">return</span> <a class="code" href="a00246.html#gga99fb83031ce9923c84392b4e92f956b5a72fd33d0b5263a63766e62f71d16be00">kStatus_I2C_Nak</a>;</div>
|
|
<div class="line">}</div>
|
|
<div class="line"></div>
|
|
<div class="line">result = <a class="code" href="a00028.html#ga3b4d71b59e118adc63afbc5434e5e7dd">I2C_MasterWriteBlocking</a>(EXAMPLE_I2C_MASTER_BASEADDR, txBuff, BUFFER_SIZE, <a class="code" href="a00028.html#gga87ea07668194cfb46c7c368d2cb42433ae80f7b768b1621e42ac965d3d23de5e2">kI2C_TransferDefaultFlag</a>);</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="keywordflow">if</span>(result)</div>
|
|
<div class="line">{</div>
|
|
<div class="line"> <span class="comment">/* If error occours, send STOP. */</span></div>
|
|
<div class="line"> <a class="code" href="a00028.html#gaf46a8cc094fc18c6cadea8de71448723">I2C_MasterStop</a>(EXAMPLE_I2C_MASTER_BASEADDR, kI2CStop);</div>
|
|
<div class="line"> <span class="keywordflow">return</span> result;</div>
|
|
<div class="line">}</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="keywordflow">while</span>(!(I2C_GetStatusFlag(EXAMPLE_I2C_MASTER_BASEADDR) & kI2C_IntPendingFlag))</div>
|
|
<div class="line">{</div>
|
|
<div class="line"></div>
|
|
<div class="line">}</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="comment">/* Wait all data sent out, send STOP. */</span></div>
|
|
<div class="line"><a class="code" href="a00028.html#gaf46a8cc094fc18c6cadea8de71448723">I2C_MasterStop</a>(EXAMPLE_I2C_MASTER_BASEADDR, kI2CStop);</div>
|
|
</div><!-- fragment --><h2><a class="anchor" id="I2CMasterOpsTransIRQ"></a>
|
|
Master Operation in interrupt transactional method</h2>
|
|
<div class="fragment"><div class="line"><a class="code" href="a00028.html#a00344">i2c_master_handle_t</a> g_m_handle;</div>
|
|
<div class="line"><span class="keyword">volatile</span> <span class="keywordtype">bool</span> g_MasterCompletionFlag = <span class="keyword">false</span>;</div>
|
|
<div class="line"><a class="code" href="a00028.html#a00342">i2c_master_config_t</a> masterConfig;</div>
|
|
<div class="line">uint8_t status;</div>
|
|
<div class="line"><a class="code" href="a00242.html#gaaabdaf7ee58ca7269bd4bf24efcde092">status_t</a> result = <a class="code" href="a00242.html#ggadf764cbdea00d65edcd07bb9953ad2b7a829bee76c6b02225d9c891ae8ef70881">kStatus_Success</a>;</div>
|
|
<div class="line">uint8_t txBuff[BUFFER_SIZE];</div>
|
|
<div class="line"><a class="code" href="a00028.html#a00345">i2c_master_transfer_t</a> masterXfer;</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="keyword">static</span> <span class="keywordtype">void</span> i2c_master_callback(I2C_Type *base, <a class="code" href="a00028.html#a00344">i2c_master_handle_t</a> *handle, <a class="code" href="a00242.html#gaaabdaf7ee58ca7269bd4bf24efcde092">status_t</a> status, <span class="keywordtype">void</span> *userData)</div>
|
|
<div class="line">{</div>
|
|
<div class="line"> <span class="comment">/* Signal transfer success when received success status. */</span></div>
|
|
<div class="line"> <span class="keywordflow">if</span> (status == <a class="code" href="a00242.html#ggadf764cbdea00d65edcd07bb9953ad2b7a829bee76c6b02225d9c891ae8ef70881">kStatus_Success</a>)</div>
|
|
<div class="line"> {</div>
|
|
<div class="line"> g_MasterCompletionFlag = <span class="keyword">true</span>;</div>
|
|
<div class="line"> }</div>
|
|
<div class="line">}</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="comment">/* Get default configuration for master. */</span></div>
|
|
<div class="line"><a class="code" href="a00028.html#gad69f2d63ea756dda60749ff6b09f587d">I2C_MasterGetDefaultConfig</a>(&masterConfig);</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="comment">/* Init I2C master. */</span></div>
|
|
<div class="line"><a class="code" href="a00028.html#ga29f967b3ae8487a36ba2a58deb01ccae">I2C_MasterInit</a>(EXAMPLE_I2C_MASTER_BASEADDR, &masterConfig, I2C_MASTER_CLK);</div>
|
|
<div class="line"></div>
|
|
<div class="line">masterXfer.<a class="code" href="a00028.html#aa6d93caa78fc9bf0f0aac10f66b8eba1">slaveAddress</a> = I2C_MASTER_SLAVE_ADDR_7BIT;</div>
|
|
<div class="line">masterXfer.<a class="code" href="a00028.html#a7bd3afcf89b78d9397b2f0c55f9deb27">direction</a> = <a class="code" href="a00028.html#gga1625497320644ba123718bafdd2c1f39a93b476b469c2a4bfed5916b458ae9bb0">kI2C_Write</a>;</div>
|
|
<div class="line">masterXfer.<a class="code" href="a00028.html#a7a4f43a16e63d9f286bc41b6255b5e3f">subaddress</a> = NULL;</div>
|
|
<div class="line">masterXfer.<a class="code" href="a00028.html#a0c2c6dde8d11db7793fdea90f1b34afb">subaddressSize</a> = 0;</div>
|
|
<div class="line">masterXfer.<a class="code" href="a00028.html#a083727a4268398628225a68cad8c4a50">data</a> = txBuff;</div>
|
|
<div class="line">masterXfer.<a class="code" href="a00028.html#a7034b157201c46c116dc251e3b56412d">dataSize</a> = BUFFER_SIZE;</div>
|
|
<div class="line">masterXfer.<a class="code" href="a00028.html#a84861e140902bd67ae901b2f4c53bfc0">flags</a> = <a class="code" href="a00028.html#gga87ea07668194cfb46c7c368d2cb42433ae80f7b768b1621e42ac965d3d23de5e2">kI2C_TransferDefaultFlag</a>;</div>
|
|
<div class="line"></div>
|
|
<div class="line"><a class="code" href="a00028.html#ga31e3de02b57801c6896e6045c4a31268">I2C_MasterTransferCreateHandle</a>(EXAMPLE_I2C_MASTER_BASEADDR, &g_m_handle, i2c_master_callback, NULL);</div>
|
|
<div class="line"><a class="code" href="a00028.html#gac7f76a04b6f6873c52ad176d58901fe9">I2C_MasterTransferNonBlocking</a>(EXAMPLE_I2C_MASTER_BASEADDR, &g_m_handle, &masterXfer);</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="comment">/* Wait for transfer completed. */</span></div>
|
|
<div class="line"><span class="keywordflow">while</span> (!g_MasterCompletionFlag)</div>
|
|
<div class="line">{</div>
|
|
<div class="line">}</div>
|
|
<div class="line">g_MasterCompletionFlag = <span class="keyword">false</span>;</div>
|
|
</div><!-- fragment --><h2><a class="anchor" id="I2CMasterOpsTransDMA"></a>
|
|
Master Operation in DMA transactional method</h2>
|
|
<div class="fragment"><div class="line"><a class="code" href="a00029.html#a00343">i2c_master_dma_handle_t</a> g_m_dma_handle;</div>
|
|
<div class="line"><a class="code" href="a00017.html#a00319">dma_handle_t</a> dmaHandle;</div>
|
|
<div class="line"><span class="keyword">volatile</span> <span class="keywordtype">bool</span> g_MasterCompletionFlag = <span class="keyword">false</span>;</div>
|
|
<div class="line"><a class="code" href="a00028.html#a00342">i2c_master_config_t</a> masterConfig;</div>
|
|
<div class="line">uint8_t txBuff[BUFFER_SIZE];</div>
|
|
<div class="line"><a class="code" href="a00028.html#a00345">i2c_master_transfer_t</a> masterXfer;</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="keyword">static</span> <span class="keywordtype">void</span> i2c_master_callback(I2C_Type *base, <a class="code" href="a00029.html#a00343">i2c_master_dma_handle_t</a> *handle, <a class="code" href="a00242.html#gaaabdaf7ee58ca7269bd4bf24efcde092">status_t</a> status, <span class="keywordtype">void</span> *userData)</div>
|
|
<div class="line">{</div>
|
|
<div class="line"> <span class="comment">/* Signal transfer success when received success status. */</span></div>
|
|
<div class="line"> <span class="keywordflow">if</span> (status == <a class="code" href="a00242.html#ggadf764cbdea00d65edcd07bb9953ad2b7a829bee76c6b02225d9c891ae8ef70881">kStatus_Success</a>)</div>
|
|
<div class="line"> {</div>
|
|
<div class="line"> g_MasterCompletionFlag = <span class="keyword">true</span>;</div>
|
|
<div class="line"> }</div>
|
|
<div class="line">}</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="comment">/* Get default configuration for master. */</span></div>
|
|
<div class="line"><a class="code" href="a00028.html#gad69f2d63ea756dda60749ff6b09f587d">I2C_MasterGetDefaultConfig</a>(&masterConfig);</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="comment">/* Init I2C master. */</span></div>
|
|
<div class="line"><a class="code" href="a00028.html#ga29f967b3ae8487a36ba2a58deb01ccae">I2C_MasterInit</a>(EXAMPLE_I2C_MASTER_BASEADDR, &masterConfig, I2C_MASTER_CLK);</div>
|
|
<div class="line"></div>
|
|
<div class="line">masterXfer.<a class="code" href="a00028.html#aa6d93caa78fc9bf0f0aac10f66b8eba1">slaveAddress</a> = I2C_MASTER_SLAVE_ADDR_7BIT;</div>
|
|
<div class="line">masterXfer.<a class="code" href="a00028.html#a7bd3afcf89b78d9397b2f0c55f9deb27">direction</a> = <a class="code" href="a00028.html#gga1625497320644ba123718bafdd2c1f39a93b476b469c2a4bfed5916b458ae9bb0">kI2C_Write</a>;</div>
|
|
<div class="line">masterXfer.<a class="code" href="a00028.html#a7a4f43a16e63d9f286bc41b6255b5e3f">subaddress</a> = NULL;</div>
|
|
<div class="line">masterXfer.<a class="code" href="a00028.html#a0c2c6dde8d11db7793fdea90f1b34afb">subaddressSize</a> = 0;</div>
|
|
<div class="line">masterXfer.<a class="code" href="a00028.html#a083727a4268398628225a68cad8c4a50">data</a> = txBuff;</div>
|
|
<div class="line">masterXfer.<a class="code" href="a00028.html#a7034b157201c46c116dc251e3b56412d">dataSize</a> = BUFFER_SIZE;</div>
|
|
<div class="line">masterXfer.<a class="code" href="a00028.html#a84861e140902bd67ae901b2f4c53bfc0">flags</a> = <a class="code" href="a00028.html#gga87ea07668194cfb46c7c368d2cb42433ae80f7b768b1621e42ac965d3d23de5e2">kI2C_TransferDefaultFlag</a>;</div>
|
|
<div class="line"></div>
|
|
<div class="line"><a class="code" href="a00017.html#gaa0293771d55ee1a7c42a8ffecb0728e7">DMA_EnableChannel</a>(EXAMPLE_DMA, EXAMPLE_I2C_MASTER_CHANNEL);</div>
|
|
<div class="line"><a class="code" href="a00017.html#ga5354ff2c0c1ec53e2cbd712169fc5558">DMA_CreateHandle</a>(&dmaHandle, EXAMPLE_DMA, EXAMPLE_I2C_MASTER_CHANNEL);</div>
|
|
<div class="line"></div>
|
|
<div class="line"><a class="code" href="a00029.html#ga83d8463e42b12e7b797a3f928f51b3cb">I2C_MasterTransferCreateHandleDMA</a>(EXAMPLE_I2C_MASTER_BASEADDR, &g_m_dma_handle, i2c_master_callback, NULL, &dmaHandle);</div>
|
|
<div class="line"><a class="code" href="a00029.html#ga8643ea43510b8d97b94db05766444cd2">I2C_MasterTransferDMA</a>(EXAMPLE_I2C_MASTER_BASEADDR, &g_m_dma_handle, &masterXfer);</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="comment">/* Wait for transfer completed. */</span></div>
|
|
<div class="line"><span class="keywordflow">while</span> (!g_MasterCompletionFlag)</div>
|
|
<div class="line">{</div>
|
|
<div class="line">}</div>
|
|
<div class="line">g_MasterCompletionFlag = <span class="keyword">false</span>;</div>
|
|
</div><!-- fragment --><h2><a class="anchor" id="I2CSlaveOpsFunctional"></a>
|
|
Slave Operation in functional method</h2>
|
|
<div class="fragment"><div class="line"><a class="code" href="a00030.html#a00347">i2c_slave_config_t</a> slaveConfig;</div>
|
|
<div class="line">uint8_t status;</div>
|
|
<div class="line"><a class="code" href="a00242.html#gaaabdaf7ee58ca7269bd4bf24efcde092">status_t</a> result = <a class="code" href="a00242.html#ggadf764cbdea00d65edcd07bb9953ad2b7a829bee76c6b02225d9c891ae8ef70881">kStatus_Success</a>;</div>
|
|
<div class="line"></div>
|
|
<div class="line"><a class="code" href="a00030.html#ga7115f80e28b62bbbd3be1a2a918529ba">I2C_SlaveGetDefaultConfig</a>(&slaveConfig); <span class="comment">/*default configuration 7-bit addressing mode*/</span></div>
|
|
<div class="line">slaveConfig.slaveAddr = 7-bit address</div>
|
|
<div class="line">slaveConfig.addressingMode = kI2C_Address7bit/kI2C_RangeMatch;</div>
|
|
<div class="line"><a class="code" href="a00030.html#ga175a81b5ab74dd78469d6cdea690d8cc">I2C_SlaveInit</a>(EXAMPLE_I2C_SLAVE_BASEADDR, &slaveConfig);</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="comment">/* Wait address match. */</span></div>
|
|
<div class="line"><span class="keywordflow">while</span>(!((status = I2C_GetStatusFlag(EXAMPLE_I2C_SLAVE_BASEADDR)) & kI2C_AddressMatchFlag))</div>
|
|
<div class="line">{</div>
|
|
<div class="line"></div>
|
|
<div class="line">}</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="comment">/* Slave transmit, master reading from slave. */</span></div>
|
|
<div class="line"><span class="keywordflow">if</span> (status & kI2C_TransferDirectionFlag)</div>
|
|
<div class="line">{</div>
|
|
<div class="line"> result = <a class="code" href="a00030.html#ga280404c6b1ede542f2c1c20bd382869c">I2C_SlaveWriteBlocking</a>(EXAMPLE_I2C_SLAVE_BASEADDR);</div>
|
|
<div class="line">}</div>
|
|
<div class="line"><span class="keywordflow">else</span></div>
|
|
<div class="line">{</div>
|
|
<div class="line"> <a class="code" href="a00030.html#ga89baaf8bc82b19c837032665e89a1707">I2C_SlaveReadBlocking</a>(EXAMPLE_I2C_SLAVE_BASEADDR);</div>
|
|
<div class="line">}</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="keywordflow">return</span> result;</div>
|
|
</div><!-- fragment --><h2><a class="anchor" id="I2CSlaveOpsTransIRQ"></a>
|
|
Slave Operation in interrupt transactional method</h2>
|
|
<div class="fragment"><div class="line"><a class="code" href="a00030.html#a00347">i2c_slave_config_t</a> slaveConfig;</div>
|
|
<div class="line"><a class="code" href="a00030.html#a00348">i2c_slave_handle_t</a> g_s_handle;</div>
|
|
<div class="line"><span class="keyword">volatile</span> <span class="keywordtype">bool</span> g_SlaveCompletionFlag = <span class="keyword">false</span>;</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="keyword">static</span> <span class="keywordtype">void</span> i2c_slave_callback(I2C_Type *base, <a class="code" href="a00030.html#a00349">i2c_slave_transfer_t</a> *xfer, <span class="keywordtype">void</span> *userData)</div>
|
|
<div class="line">{</div>
|
|
<div class="line"> <span class="keywordflow">switch</span> (xfer-><a class="code" href="a00030.html#a461d482d4a91765e8820b55b17e7e53c">event</a>)</div>
|
|
<div class="line"> {</div>
|
|
<div class="line"> <span class="comment">/* Transmit request */</span></div>
|
|
<div class="line"> <span class="keywordflow">case</span> <a class="code" href="a00030.html#gga87e42e170b60f17f657ef3c06a918133a2f85039a57379838909876a1d509b7aa">kI2C_SlaveTransmitEvent</a>:</div>
|
|
<div class="line"> <span class="comment">/* Update information for transmit process */</span></div>
|
|
<div class="line"> xfer->data = g_slave_buff;</div>
|
|
<div class="line"> xfer->dataSize = I2C_DATA_LENGTH;</div>
|
|
<div class="line"> <span class="keywordflow">break</span>;</div>
|
|
<div class="line"></div>
|
|
<div class="line"> <span class="comment">/* Receive request */</span></div>
|
|
<div class="line"> <span class="keywordflow">case</span> <a class="code" href="a00030.html#gga87e42e170b60f17f657ef3c06a918133aac8593e808a8137d1b5d3a51640779de">kI2C_SlaveReceiveEvent</a>:</div>
|
|
<div class="line"> <span class="comment">/* Update information for received process */</span></div>
|
|
<div class="line"> xfer->data = g_slave_buff;</div>
|
|
<div class="line"> xfer->dataSize = I2C_DATA_LENGTH;</div>
|
|
<div class="line"> <span class="keywordflow">break</span>;</div>
|
|
<div class="line"></div>
|
|
<div class="line"> <span class="comment">/* Transfer done */</span></div>
|
|
<div class="line"> <span class="keywordflow">case</span> <a class="code" href="a00030.html#gga87e42e170b60f17f657ef3c06a918133a38cca3cd668e73f51b8e574835d419df">kI2C_SlaveCompletionEvent</a>:</div>
|
|
<div class="line"> g_SlaveCompletionFlag = <span class="keyword">true</span>;</div>
|
|
<div class="line"> <span class="keywordflow">break</span>;</div>
|
|
<div class="line"></div>
|
|
<div class="line"> <span class="keywordflow">default</span>:</div>
|
|
<div class="line"> g_SlaveCompletionFlag = <span class="keyword">true</span>;</div>
|
|
<div class="line"> <span class="keywordflow">break</span>;</div>
|
|
<div class="line"> }</div>
|
|
<div class="line">}</div>
|
|
<div class="line"></div>
|
|
<div class="line"><a class="code" href="a00030.html#ga7115f80e28b62bbbd3be1a2a918529ba">I2C_SlaveGetDefaultConfig</a>(&slaveConfig); <span class="comment">/*default configuration 7-bit addressing mode*/</span></div>
|
|
<div class="line">slaveConfig.slaveAddr = 7-bit address</div>
|
|
<div class="line">slaveConfig.addressingMode = kI2C_Address7bit/kI2C_RangeMatch;</div>
|
|
<div class="line"></div>
|
|
<div class="line"><a class="code" href="a00030.html#ga175a81b5ab74dd78469d6cdea690d8cc">I2C_SlaveInit</a>(EXAMPLE_I2C_SLAVE_BASEADDR, &slaveConfig);</div>
|
|
<div class="line"></div>
|
|
<div class="line"><a class="code" href="a00030.html#gac9b90f575d92ff8ad3cc350a5c8ad1b9">I2C_SlaveTransferCreateHandle</a>(EXAMPLE_I2C_SLAVE_BASEADDR, &g_s_handle, i2c_slave_callback, NULL);</div>
|
|
<div class="line"></div>
|
|
<div class="line"><a class="code" href="a00030.html#gaa387d81ea08a9d4b39cfeb3dfec505f7">I2C_SlaveTransferNonBlocking</a>(EXAMPLE_I2C_SLAVE_BASEADDR, &g_s_handle, <a class="code" href="a00030.html#gga87e42e170b60f17f657ef3c06a918133a38cca3cd668e73f51b8e574835d419df">kI2C_SlaveCompletionEvent</a>);</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="comment">/* Wait for transfer completed. */</span></div>
|
|
<div class="line"><span class="keywordflow">while</span> (!g_SlaveCompletionFlag)</div>
|
|
<div class="line">{</div>
|
|
<div class="line">}</div>
|
|
<div class="line">g_SlaveCompletionFlag = <span class="keyword">false</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:a00247"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="a00247.html">I2C CMSIS Driver</a></td></tr>
|
|
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a00029"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="a00029.html">I2C DMA Driver</a></td></tr>
|
|
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a00246"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="a00246.html">I2C Driver</a></td></tr>
|
|
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a00028"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="a00028.html">I2C Master Driver</a></td></tr>
|
|
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a00030"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="a00030.html">I2C Slave Driver</a></td></tr>
|
|
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table>
|
|
</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>
|