MCUXpresso_MIMXRT1021xxxxx/docs/MCUXpresso SDK API Referenc.../a00267.html

344 lines
16 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: GPC: General Power Controller 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
&#160;<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&#160;Page</span></a></li>
<li><a href="pages.html"><span>Related&#160;Pages</span></a></li>
<li><a href="modules.html"><span>API&#160;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('a00267.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">&#160;</span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark">&#160;</span>Data Structures</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark">&#160;</span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark">&#160;</span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark">&#160;</span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark">&#160;</span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark">&#160;</span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark">&#160;</span>Groups</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark">&#160;</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="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">GPC: General Power Controller 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 General Power Controller (GPC) module of MCUXpresso SDK devices.</p>
<p>API functions are provided to configure the system about working in dedicated power mode. There are mainly about enabling the power for memory, enabling the wakeup sources for STOP modes, and power up/down operations for various peripherals. </p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:ga7c73d81bfb34ebb7ca40a5ad2a63ad7e"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="a00267.html#ga7c73d81bfb34ebb7ca40a5ad2a63ad7e">GPC_EnableIRQ</a> (GPC_Type *base, uint32_t irqId)</td></tr>
<tr class="memdesc:ga7c73d81bfb34ebb7ca40a5ad2a63ad7e"><td class="mdescLeft">&#160;</td><td class="mdescRight">Enable the IRQ. <a href="#ga7c73d81bfb34ebb7ca40a5ad2a63ad7e">More...</a><br/></td></tr>
<tr class="separator:ga7c73d81bfb34ebb7ca40a5ad2a63ad7e"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:gacfd07601d1a0e90e3b80fffe14830010"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="a00267.html#gacfd07601d1a0e90e3b80fffe14830010">GPC_DisableIRQ</a> (GPC_Type *base, uint32_t irqId)</td></tr>
<tr class="memdesc:gacfd07601d1a0e90e3b80fffe14830010"><td class="mdescLeft">&#160;</td><td class="mdescRight">Disable the IRQ. <a href="#gacfd07601d1a0e90e3b80fffe14830010">More...</a><br/></td></tr>
<tr class="separator:gacfd07601d1a0e90e3b80fffe14830010"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga1118000efd3c822329c63a7155bbe12e"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="a00267.html#ga1118000efd3c822329c63a7155bbe12e">GPC_GetIRQStatusFlag</a> (GPC_Type *base, uint32_t irqId)</td></tr>
<tr class="memdesc:ga1118000efd3c822329c63a7155bbe12e"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get the IRQ/Event flag. <a href="#ga1118000efd3c822329c63a7155bbe12e">More...</a><br/></td></tr>
<tr class="separator:ga1118000efd3c822329c63a7155bbe12e"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga8270fba73a065a4e14af1bc895e55969"><td class="memItemLeft" align="right" valign="top">static void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="a00267.html#ga8270fba73a065a4e14af1bc895e55969">GPC_RequestPdram0PowerDown</a> (GPC_Type *base, bool enable)</td></tr>
<tr class="memdesc:ga8270fba73a065a4e14af1bc895e55969"><td class="mdescLeft">&#160;</td><td class="mdescRight">FLEXRAM PDRAM0 Power Gate Enable. <a href="#ga8270fba73a065a4e14af1bc895e55969">More...</a><br/></td></tr>
<tr class="separator:ga8270fba73a065a4e14af1bc895e55969"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:gaac50bee55eb34b329680e6fd0d2a9582"><td class="memItemLeft" align="right" valign="top">static void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="a00267.html#gaac50bee55eb34b329680e6fd0d2a9582">GPC_RequestMEGAPowerOn</a> (GPC_Type *base, bool enable)</td></tr>
<tr class="memdesc:gaac50bee55eb34b329680e6fd0d2a9582"><td class="mdescLeft">&#160;</td><td class="mdescRight">Requests the MEGA power switch sequence. <a href="#gaac50bee55eb34b329680e6fd0d2a9582">More...</a><br/></td></tr>
<tr class="separator:gaac50bee55eb34b329680e6fd0d2a9582"><td class="memSeparator" colspan="2">&#160;</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:ga91a1b6b08dc09200c3b0ee314b362b74"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="a00267.html#ga91a1b6b08dc09200c3b0ee314b362b74">FSL_GPC_DRIVER_VERSION</a>&#160;&#160;&#160;(<a class="el" href="a00260.html#ga812138aa3315b0c6953c1a26130bcc37">MAKE_VERSION</a>(2, 1, 1))</td></tr>
<tr class="memdesc:ga91a1b6b08dc09200c3b0ee314b362b74"><td class="mdescLeft">&#160;</td><td class="mdescRight">GPC driver version 2.1.1. <a href="#ga91a1b6b08dc09200c3b0ee314b362b74">More...</a><br/></td></tr>
<tr class="separator:ga91a1b6b08dc09200c3b0ee314b362b74"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table>
<h2 class="groupheader">Macro Definition Documentation</h2>
<a class="anchor" id="ga91a1b6b08dc09200c3b0ee314b362b74"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define FSL_GPC_DRIVER_VERSION&#160;&#160;&#160;(<a class="el" href="a00260.html#ga812138aa3315b0c6953c1a26130bcc37">MAKE_VERSION</a>(2, 1, 1))</td>
</tr>
</table>
</div><div class="memdoc">
</div>
</div>
<h2 class="groupheader">Function Documentation</h2>
<a class="anchor" id="ga7c73d81bfb34ebb7ca40a5ad2a63ad7e"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void GPC_EnableIRQ </td>
<td>(</td>
<td class="paramtype">GPC_Type *&#160;</td>
<td class="paramname"><em>base</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint32_t&#160;</td>
<td class="paramname"><em>irqId</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">base</td><td>GPC peripheral base address. </td></tr>
<tr><td class="paramname">irqId</td><td>ID number of IRQ to be enabled, available range is 32-159. 0-31 is available in some platforms. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="gacfd07601d1a0e90e3b80fffe14830010"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void GPC_DisableIRQ </td>
<td>(</td>
<td class="paramtype">GPC_Type *&#160;</td>
<td class="paramname"><em>base</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint32_t&#160;</td>
<td class="paramname"><em>irqId</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">base</td><td>GPC peripheral base address. </td></tr>
<tr><td class="paramname">irqId</td><td>ID number of IRQ to be disabled, available range is 32-159. 0-31 is available in some platforms. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga1118000efd3c822329c63a7155bbe12e"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool GPC_GetIRQStatusFlag </td>
<td>(</td>
<td class="paramtype">GPC_Type *&#160;</td>
<td class="paramname"><em>base</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint32_t&#160;</td>
<td class="paramname"><em>irqId</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">base</td><td>GPC peripheral base address. </td></tr>
<tr><td class="paramname">irqId</td><td>ID number of IRQ to be enabled, available range is 32-159. 0-31 is available in some platforms. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>Indicated IRQ/Event is asserted or not. </dd></dl>
</div>
</div>
<a class="anchor" id="ga8270fba73a065a4e14af1bc895e55969"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">static void GPC_RequestPdram0PowerDown </td>
<td>(</td>
<td class="paramtype">GPC_Type *&#160;</td>
<td class="paramname"><em>base</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool&#160;</td>
<td class="paramname"><em>enable</em>&#160;</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 configures the FLEXRAM PDRAM0 if it will keep power when cpu core is power down. When the PDRAM0 Power is 1, PDRAM0 will be power down once when CPU core is power down. When the PDRAM0 Power is 0, PDRAM0 will keep power on even if CPU core is power down. When CPU core is re-power up, the default setting is 1.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">base</td><td>GPC peripheral base address. </td></tr>
<tr><td class="paramname">enable</td><td>Enable the request or not. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="gaac50bee55eb34b329680e6fd0d2a9582"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">static void GPC_RequestMEGAPowerOn </td>
<td>(</td>
<td class="paramtype">GPC_Type *&#160;</td>
<td class="paramname"><em>base</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool&#160;</td>
<td class="paramname"><em>enable</em>&#160;</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">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">base</td><td>GPC peripheral base address. </td></tr>
<tr><td class="paramname">enable</td><td>Enable the power on sequence, or the power down sequence. </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">&copy; 2016 NXP Semiconductors. All rights reserved.
</li>
</ul>
</div>
</body>
</html>