1 <!-- HTML header for doxygen 1.9.6-->
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="en-US">
5 <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
6 <meta http-equiv="X-UA-Compatible" content="IE=11"/>
7 <meta name="viewport" content="width=device-width, initial-scale=1"/>
8 <title>CMSIS-Core (Cortex-M): Core Register Access Functions</title>
9 <link href="doxygen.css" rel="stylesheet" type="text/css" />
10 <script type="text/javascript" src="jquery.js"></script>
11 <script type="text/javascript" src="dynsections.js"></script>
12 <script type="text/javascript" src="tabs.js"></script>
13 <script type="text/javascript" src="footer.js"></script>
14 <script type="text/javascript" src="navtree.js"></script>
15 <link href="navtree.css" rel="stylesheet" type="text/css"/>
16 <script type="text/javascript" src="resize.js"></script>
17 <script type="text/javascript" src="navtreedata.js"></script>
18 <script type="text/javascript" src="navtree.js"></script>
19 <link href="search/search.css" rel="stylesheet" type="text/css"/>
20 <script type="text/javascript" src="search/searchdata.js"></script>
21 <script type="text/javascript" src="search/search.js"></script>
22 <script type="text/javascript">
23 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
24 $(document).ready(function() { init_search(); });
27 <script type="text/javascript" src="darkmode_toggle.js"></script>
28 <link href="extra_stylesheet.css" rel="stylesheet" type="text/css"/>
29 <link href="extra_navtree.css" rel="stylesheet" type="text/css"/>
30 <link href="extra_search.css" rel="stylesheet" type="text/css"/>
31 <link href="extra_tabs.css" rel="stylesheet" type="text/css"/>
32 <link href="version.css" rel="stylesheet" type="text/css"/>
33 <script type="text/javascript" src="../../version.js"></script>
36 <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
38 <table cellspacing="0" cellpadding="0">
40 <tr style="height: 55px;">
41 <td id="projectlogo" style="padding: 1.5em;"><img alt="Logo" src="cmsis_logo_white_small.png"/></td>
42 <td style="padding-left: 1em; padding-bottom: 1em;padding-top: 1em;">
43 <div id="projectname">CMSIS-Core (Cortex-M)
44  <span id="projectnumber"><script type="text/javascript">
46 writeHeader.call(this);
47 writeVersionDropdown.call(this, "CMSIS-Core (Cortex-M)");
52 <div id="projectbrief">CMSIS-Core support for Cortex-M processor-based devices</div>
54 <td> <div id="MSearchBox" class="MSearchBoxInactive">
56 <span id="MSearchSelect" onmouseover="return searchBox.OnSearchSelectShow()" onmouseout="return searchBox.OnSearchSelectHide()"> </span>
57 <input type="text" id="MSearchField" value="" placeholder="Search" accesskey="S"
58 onfocus="searchBox.OnSearchFieldFocus(true)"
59 onblur="searchBox.OnSearchFieldFocus(false)"
60 onkeyup="searchBox.OnSearchFieldChange(event)"/>
61 </span><span class="right">
62 <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.svg" alt=""/></a>
66 <!--END !PROJECT_NAME-->
71 <!-- end header part -->
72 <div id="CMSISnav" class="tabs1">
74 <script type="text/javascript">
75 writeComponentTabs.call(this);
79 <script type="text/javascript">
80 writeSubComponentTabs.call(this);
82 <!-- Generated by Doxygen 1.9.6 -->
83 <script type="text/javascript">
84 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
85 var searchBox = new SearchBox("searchBox", "search/",'.html');
89 <div id="side-nav" class="ui-resizable side-nav-resizable">
91 <div id="nav-tree-contents">
92 <div id="nav-sync" class="sync"></div>
95 <div id="splitbar" style="-moz-user-select:none;"
96 class="ui-resizable-handle">
99 <script type="text/javascript">
100 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
101 $(document).ready(function(){initNavTree('group__coreregister__trustzone__functions.html',''); initResizable(); });
104 <div id="doc-content">
105 <!-- window showing the filter options -->
106 <div id="MSearchSelectWindow"
107 onmouseover="return searchBox.OnSearchSelectShow()"
108 onmouseout="return searchBox.OnSearchSelectHide()"
109 onkeydown="return searchBox.OnSearchSelectKey(event)">
112 <!-- iframe showing the search results (closed by default) -->
113 <div id="MSearchResultsWindow">
114 <div id="MSearchResults">
117 <div id="SRResults"></div>
118 <div class="SRStatus" id="Loading">Loading...</div>
119 <div class="SRStatus" id="Searching">Searching...</div>
120 <div class="SRStatus" id="NoMatches">No Matches</div>
127 <div class="summary">
128 <a href="#func-members">Functions</a> </div>
129 <div class="headertitle"><div class="title">Core Register Access Functions<div class="ingroups"><a class="el" href="group__trustzone__functions.html">TrustZone for Armv8-M/v8.1-M</a></div></div></div>
131 <div class="contents">
133 <p>Core register Access functions related to TrustZone for Armv8-M.
134 <a href="#details">More...</a></p>
135 <table class="memberdecls">
136 <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="func-members" name="func-members"></a>
137 Functions</h2></td></tr>
138 <tr class="memitem:ga624509c924d2583f0d4dca6ab270f051"><td class="memItemLeft" align="right" valign="top">uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#ga624509c924d2583f0d4dca6ab270f051">__TZ_get_BASEPRI_NS</a> (void)</td></tr>
139 <tr class="memdesc:ga624509c924d2583f0d4dca6ab270f051"><td class="mdescLeft"> </td><td class="mdescRight">Get Base Priority (non-secure) <br /></td></tr>
140 <tr class="separator:ga624509c924d2583f0d4dca6ab270f051"><td class="memSeparator" colspan="2"> </td></tr>
141 <tr class="memitem:ga27bf1f88e794c30808ee73a29d46e358"><td class="memItemLeft" align="right" valign="top">uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#ga27bf1f88e794c30808ee73a29d46e358">__TZ_get_CONTROL_NS</a> (void)</td></tr>
142 <tr class="memdesc:ga27bf1f88e794c30808ee73a29d46e358"><td class="mdescLeft"> </td><td class="mdescRight">Get Control register (non-secure) <br /></td></tr>
143 <tr class="separator:ga27bf1f88e794c30808ee73a29d46e358"><td class="memSeparator" colspan="2"> </td></tr>
144 <tr class="memitem:ga578b41087f207e1a475daae6cc8a28dc"><td class="memItemLeft" align="right" valign="top">uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#ga578b41087f207e1a475daae6cc8a28dc">__TZ_get_FAULTMASK_NS</a> (void)</td></tr>
145 <tr class="memdesc:ga578b41087f207e1a475daae6cc8a28dc"><td class="mdescLeft"> </td><td class="mdescRight">Get Fault Mask (non-secure) <br /></td></tr>
146 <tr class="separator:ga578b41087f207e1a475daae6cc8a28dc"><td class="memSeparator" colspan="2"> </td></tr>
147 <tr class="memitem:gab3aa15eb4f352e230b9f7a3e8856a9e9"><td class="memItemLeft" align="right" valign="top">uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#gab3aa15eb4f352e230b9f7a3e8856a9e9">__TZ_get_MSP_NS</a> (void)</td></tr>
148 <tr class="memdesc:gab3aa15eb4f352e230b9f7a3e8856a9e9"><td class="mdescLeft"> </td><td class="mdescRight">Get Main Stack Pointer (non-secure) <br /></td></tr>
149 <tr class="separator:gab3aa15eb4f352e230b9f7a3e8856a9e9"><td class="memSeparator" colspan="2"> </td></tr>
150 <tr class="memitem:gada00853d3e49fa8d21f375c53d28fa51"><td class="memItemLeft" align="right" valign="top">uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#gada00853d3e49fa8d21f375c53d28fa51">__TZ_get_MSPLIM_NS</a> (void)</td></tr>
151 <tr class="memdesc:gada00853d3e49fa8d21f375c53d28fa51"><td class="mdescLeft"> </td><td class="mdescRight">Get Main Stack Pointer Limit (non-secure) Devices without Armv8-M Main Extensions (i.e. Cortex-M23) lack the non-secure Stack Pointer Limit register hence zero is returned always. <br /></td></tr>
152 <tr class="separator:gada00853d3e49fa8d21f375c53d28fa51"><td class="memSeparator" colspan="2"> </td></tr>
153 <tr class="memitem:ga7cc3271c79e619f8838e8767df3cb509"><td class="memItemLeft" align="right" valign="top">uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#ga7cc3271c79e619f8838e8767df3cb509">__TZ_get_PRIMASK_NS</a> (void)</td></tr>
154 <tr class="memdesc:ga7cc3271c79e619f8838e8767df3cb509"><td class="mdescLeft"> </td><td class="mdescRight">Get Priority Mask (non-secure) <br /></td></tr>
155 <tr class="separator:ga7cc3271c79e619f8838e8767df3cb509"><td class="memSeparator" colspan="2"> </td></tr>
156 <tr class="memitem:ga40ff8336c6d09af6da1081d4e4adc126"><td class="memItemLeft" align="right" valign="top">uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#ga40ff8336c6d09af6da1081d4e4adc126">__TZ_get_PSP_NS</a> (void)</td></tr>
157 <tr class="memdesc:ga40ff8336c6d09af6da1081d4e4adc126"><td class="mdescLeft"> </td><td class="mdescRight">Get Process Stack Pointer (non-secure) <br /></td></tr>
158 <tr class="separator:ga40ff8336c6d09af6da1081d4e4adc126"><td class="memSeparator" colspan="2"> </td></tr>
159 <tr class="memitem:ga5da646ec291b6a183f38497ce92be51c"><td class="memItemLeft" align="right" valign="top">uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#ga5da646ec291b6a183f38497ce92be51c">__TZ_get_PSPLIM_NS</a> (void)</td></tr>
160 <tr class="memdesc:ga5da646ec291b6a183f38497ce92be51c"><td class="mdescLeft"> </td><td class="mdescRight">Get Process Stack Pointer Limit (non-secure) Devices without Armv8-M Main Extensions (i.e. Cortex-M23) lack the non-secure Stack Pointer Limit register hence zero is returned always. <br /></td></tr>
161 <tr class="separator:ga5da646ec291b6a183f38497ce92be51c"><td class="memSeparator" colspan="2"> </td></tr>
162 <tr class="memitem:gaaaf2aaf904b25ed17fd3e5e63f8e029b"><td class="memItemLeft" align="right" valign="top">uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#gaaaf2aaf904b25ed17fd3e5e63f8e029b">__TZ_get_SP_NS</a> (void)</td></tr>
163 <tr class="memdesc:gaaaf2aaf904b25ed17fd3e5e63f8e029b"><td class="mdescLeft"> </td><td class="mdescRight">Get Stack Pointer (non-secure) <br /></td></tr>
164 <tr class="separator:gaaaf2aaf904b25ed17fd3e5e63f8e029b"><td class="memSeparator" colspan="2"> </td></tr>
165 <tr class="memitem:ga92c187f0b4d53627b59e0fd0bda0b0df"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#ga92c187f0b4d53627b59e0fd0bda0b0df">__TZ_set_BASEPRI_NS</a> (uint32_t basePri)</td></tr>
166 <tr class="memdesc:ga92c187f0b4d53627b59e0fd0bda0b0df"><td class="mdescLeft"> </td><td class="mdescRight">Set Base Priority (non-secure) <br /></td></tr>
167 <tr class="separator:ga92c187f0b4d53627b59e0fd0bda0b0df"><td class="memSeparator" colspan="2"> </td></tr>
168 <tr class="memitem:ga3eb150204e6d389d5b49065179b9cde5"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#ga3eb150204e6d389d5b49065179b9cde5">__TZ_set_CONTROL_NS</a> (uint32_t control)</td></tr>
169 <tr class="memdesc:ga3eb150204e6d389d5b49065179b9cde5"><td class="mdescLeft"> </td><td class="mdescRight">Set Control register (non-secure) <br /></td></tr>
170 <tr class="separator:ga3eb150204e6d389d5b49065179b9cde5"><td class="memSeparator" colspan="2"> </td></tr>
171 <tr class="memitem:ga4f0912db7bc65439d23817c1d372a7a4"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#ga4f0912db7bc65439d23817c1d372a7a4">__TZ_set_FAULTMASK_NS</a> (uint32_t faultMask)</td></tr>
172 <tr class="memdesc:ga4f0912db7bc65439d23817c1d372a7a4"><td class="mdescLeft"> </td><td class="mdescRight">Set Fault Mask (non-secure) <br /></td></tr>
173 <tr class="separator:ga4f0912db7bc65439d23817c1d372a7a4"><td class="memSeparator" colspan="2"> </td></tr>
174 <tr class="memitem:ga41c3ac2d9af23c40647c053ad7d564e7"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#ga41c3ac2d9af23c40647c053ad7d564e7">__TZ_set_MSP_NS</a> (uint32_t topOfMainStack)</td></tr>
175 <tr class="memdesc:ga41c3ac2d9af23c40647c053ad7d564e7"><td class="mdescLeft"> </td><td class="mdescRight">Set Main Stack Pointer (non-secure) <br /></td></tr>
176 <tr class="separator:ga41c3ac2d9af23c40647c053ad7d564e7"><td class="memSeparator" colspan="2"> </td></tr>
177 <tr class="memitem:gad2013f4d4311d6db253594a12d192617"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#gad2013f4d4311d6db253594a12d192617">__TZ_set_MSPLIM_NS</a> (uint32_t MainStackPtrLimit)</td></tr>
178 <tr class="memdesc:gad2013f4d4311d6db253594a12d192617"><td class="mdescLeft"> </td><td class="mdescRight">Set Main Stack Pointer Limit (non-secure) Devices without Armv8-M Main Extensions (i.e. Cortex-M23) lack the non-secure Stack Pointer Limit register hence zero is returned always. <br /></td></tr>
179 <tr class="separator:gad2013f4d4311d6db253594a12d192617"><td class="memSeparator" colspan="2"> </td></tr>
180 <tr class="memitem:ga6686c2ab5756b5049fad1644e89b3340"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#ga6686c2ab5756b5049fad1644e89b3340">__TZ_set_PRIMASK_NS</a> (uint32_t priMask)</td></tr>
181 <tr class="memdesc:ga6686c2ab5756b5049fad1644e89b3340"><td class="mdescLeft"> </td><td class="mdescRight">Set Priority Mask (non-secure) <br /></td></tr>
182 <tr class="separator:ga6686c2ab5756b5049fad1644e89b3340"><td class="memSeparator" colspan="2"> </td></tr>
183 <tr class="memitem:gaea8db21c00cfa4144ee74dc65dbd7580"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#gaea8db21c00cfa4144ee74dc65dbd7580">__TZ_set_PSP_NS</a> (uint32_t topOfProcStack)</td></tr>
184 <tr class="memdesc:gaea8db21c00cfa4144ee74dc65dbd7580"><td class="mdescLeft"> </td><td class="mdescRight">Set Process Stack Pointer (non-secure) <br /></td></tr>
185 <tr class="separator:gaea8db21c00cfa4144ee74dc65dbd7580"><td class="memSeparator" colspan="2"> </td></tr>
186 <tr class="memitem:ga81e0995ee0fd2a9dcd9e9681bc22c76f"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#ga81e0995ee0fd2a9dcd9e9681bc22c76f">__TZ_set_PSPLIM_NS</a> (uint32_t ProcStackPtrLimit)</td></tr>
187 <tr class="memdesc:ga81e0995ee0fd2a9dcd9e9681bc22c76f"><td class="mdescLeft"> </td><td class="mdescRight">Set Process Stack Pointer (non-secure) Devices without Armv8-M Main Extensions (i.e. Cortex-M23) lack the non-secure Stack Pointer Limit register hence zero is returned always. <br /></td></tr>
188 <tr class="separator:ga81e0995ee0fd2a9dcd9e9681bc22c76f"><td class="memSeparator" colspan="2"> </td></tr>
189 <tr class="memitem:gab7263167cb006aeeb04b68e579dae015"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#gab7263167cb006aeeb04b68e579dae015">__TZ_set_SP_NS</a> (uint32_t topOfStack)</td></tr>
190 <tr class="memdesc:gab7263167cb006aeeb04b68e579dae015"><td class="mdescLeft"> </td><td class="mdescRight">Set Stack Pointer (non-secure) <br /></td></tr>
191 <tr class="separator:gab7263167cb006aeeb04b68e579dae015"><td class="memSeparator" colspan="2"> </td></tr>
193 <a name="details" id="details"></a><h2 class="groupheader">Description</h2>
194 <p>Core register Access functions related to TrustZone for Armv8-M. </p>
195 <h2 class="groupheader">Function Documentation</h2>
196 <a id="ga624509c924d2583f0d4dca6ab270f051" name="ga624509c924d2583f0d4dca6ab270f051"></a>
197 <h2 class="memtitle"><span class="permalink"><a href="#ga624509c924d2583f0d4dca6ab270f051">◆ </a></span>__TZ_get_BASEPRI_NS()</h2>
199 <div class="memitem">
200 <div class="memproto">
201 <table class="memname">
203 <td class="memname">uint32_t __TZ_get_BASEPRI_NS </td>
205 <td class="paramtype">void </td>
206 <td class="paramname"></td><td>)</td>
210 </div><div class="memdoc">
212 <p>Get Base Priority (non-secure) </p>
213 <p>Returns the current value of the non-secure Base Priority register when in secure state. </p><dl class="section return"><dt>Returns</dt><dd>Base Priority register value </dd></dl>
214 <dl class="section see"><dt>See also</dt><dd><br />
216 <li><a class="el" href="group__Core__Register__gr.html#ga32da759f46e52c95bcfbde5012260667">__get_BASEPRI</a> </li>
222 <a id="ga27bf1f88e794c30808ee73a29d46e358" name="ga27bf1f88e794c30808ee73a29d46e358"></a>
223 <h2 class="memtitle"><span class="permalink"><a href="#ga27bf1f88e794c30808ee73a29d46e358">◆ </a></span>__TZ_get_CONTROL_NS()</h2>
225 <div class="memitem">
226 <div class="memproto">
227 <table class="memname">
229 <td class="memname">uint32_t __TZ_get_CONTROL_NS </td>
231 <td class="paramtype">void </td>
232 <td class="paramname"></td><td>)</td>
236 </div><div class="memdoc">
238 <p>Get Control register (non-secure) </p>
239 <p>Returns the content of the non-secure Control register when in secure mode. </p><dl class="section return"><dt>Returns</dt><dd>non-secure Control register value </dd></dl>
240 <dl class="section see"><dt>See also</dt><dd><br />
242 <li><a class="el" href="group__Core__Register__gr.html#ga963cf236b73219ce78e965deb01b81a7">__get_CONTROL</a>; <a class="el" href="unionCONTROL__Type.html" title="Union type to access the Control Registers (CONTROL).">CONTROL_Type</a> </li>
248 <a id="ga578b41087f207e1a475daae6cc8a28dc" name="ga578b41087f207e1a475daae6cc8a28dc"></a>
249 <h2 class="memtitle"><span class="permalink"><a href="#ga578b41087f207e1a475daae6cc8a28dc">◆ </a></span>__TZ_get_FAULTMASK_NS()</h2>
251 <div class="memitem">
252 <div class="memproto">
253 <table class="memname">
255 <td class="memname">uint32_t __TZ_get_FAULTMASK_NS </td>
257 <td class="paramtype">void </td>
258 <td class="paramname"></td><td>)</td>
262 </div><div class="memdoc">
264 <p>Get Fault Mask (non-secure) </p>
265 <p>Returns the current value of the non-secure Fault Mask register when in secure state. </p><dl class="section return"><dt>Returns</dt><dd>Fault Mask register value </dd></dl>
266 <dl class="section see"><dt>See also</dt><dd><br />
268 <li><a class="el" href="group__Core__Register__gr.html#gaa78e4e6bf619a65e9f01b4af13fed3a8">__get_FAULTMASK</a> </li>
274 <a id="gab3aa15eb4f352e230b9f7a3e8856a9e9" name="gab3aa15eb4f352e230b9f7a3e8856a9e9"></a>
275 <h2 class="memtitle"><span class="permalink"><a href="#gab3aa15eb4f352e230b9f7a3e8856a9e9">◆ </a></span>__TZ_get_MSP_NS()</h2>
277 <div class="memitem">
278 <div class="memproto">
279 <table class="memname">
281 <td class="memname">uint32_t __TZ_get_MSP_NS </td>
283 <td class="paramtype">void </td>
284 <td class="paramname"></td><td>)</td>
288 </div><div class="memdoc">
290 <p>Get Main Stack Pointer (non-secure) </p>
291 <p>Returns the current value of the non-secure Main Stack Pointer (MSP) when in secure state. </p><dl class="section return"><dt>Returns</dt><dd>MSP register value </dd></dl>
292 <dl class="section see"><dt>See also</dt><dd><br />
294 <li><a class="el" href="group__Core__Register__gr.html#gab898559392ba027814e5bbb5a98b38d2">__get_MSP</a> </li>
300 <a id="gada00853d3e49fa8d21f375c53d28fa51" name="gada00853d3e49fa8d21f375c53d28fa51"></a>
301 <h2 class="memtitle"><span class="permalink"><a href="#gada00853d3e49fa8d21f375c53d28fa51">◆ </a></span>__TZ_get_MSPLIM_NS()</h2>
303 <div class="memitem">
304 <div class="memproto">
305 <table class="memname">
307 <td class="memname">uint32_t __TZ_get_MSPLIM_NS </td>
309 <td class="paramtype">void </td>
310 <td class="paramname"></td><td>)</td>
314 </div><div class="memdoc">
316 <p>Get Main Stack Pointer Limit (non-secure) Devices without Armv8-M Main Extensions (i.e. Cortex-M23) lack the non-secure Stack Pointer Limit register hence zero is returned always. </p>
317 <p>Returns the current value of the non-secure Main Stack Pointer Limit(MSPLIM) when in secure state. </p><dl class="section return"><dt>Returns</dt><dd>MSPLIM register value </dd></dl>
321 <a id="ga7cc3271c79e619f8838e8767df3cb509" name="ga7cc3271c79e619f8838e8767df3cb509"></a>
322 <h2 class="memtitle"><span class="permalink"><a href="#ga7cc3271c79e619f8838e8767df3cb509">◆ </a></span>__TZ_get_PRIMASK_NS()</h2>
324 <div class="memitem">
325 <div class="memproto">
326 <table class="memname">
328 <td class="memname">uint32_t __TZ_get_PRIMASK_NS </td>
330 <td class="paramtype">void </td>
331 <td class="paramname"></td><td>)</td>
335 </div><div class="memdoc">
337 <p>Get Priority Mask (non-secure) </p>
338 <p>Returns the current state of the non-secure priority mask bit from the Priority Mask register when in secure state. </p><dl class="section return"><dt>Returns</dt><dd>Priority Mask value </dd></dl>
339 <dl class="section see"><dt>See also</dt><dd><br />
341 <li><a class="el" href="group__Core__Register__gr.html#ga799b5d9a2ae75e459264c8512c7c0e02">__get_PRIMASK</a> </li>
347 <a id="ga40ff8336c6d09af6da1081d4e4adc126" name="ga40ff8336c6d09af6da1081d4e4adc126"></a>
348 <h2 class="memtitle"><span class="permalink"><a href="#ga40ff8336c6d09af6da1081d4e4adc126">◆ </a></span>__TZ_get_PSP_NS()</h2>
350 <div class="memitem">
351 <div class="memproto">
352 <table class="memname">
354 <td class="memname">uint32_t __TZ_get_PSP_NS </td>
356 <td class="paramtype">void </td>
357 <td class="paramname"></td><td>)</td>
361 </div><div class="memdoc">
363 <p>Get Process Stack Pointer (non-secure) </p>
364 <p>Returns the current value of the non-secure Process Stack Pointer (PSP) when in secure state. </p><dl class="section return"><dt>Returns</dt><dd>PSP register value </dd></dl>
365 <dl class="section see"><dt>See also</dt><dd><br />
367 <li><a class="el" href="group__Core__Register__gr.html#ga914dfa8eff7ca53380dd54cf1d8bebd9">__get_PSP</a> </li>
373 <a id="ga5da646ec291b6a183f38497ce92be51c" name="ga5da646ec291b6a183f38497ce92be51c"></a>
374 <h2 class="memtitle"><span class="permalink"><a href="#ga5da646ec291b6a183f38497ce92be51c">◆ </a></span>__TZ_get_PSPLIM_NS()</h2>
376 <div class="memitem">
377 <div class="memproto">
378 <table class="memname">
380 <td class="memname">uint32_t __TZ_get_PSPLIM_NS </td>
382 <td class="paramtype">void </td>
383 <td class="paramname"></td><td>)</td>
387 </div><div class="memdoc">
389 <p>Get Process Stack Pointer Limit (non-secure) Devices without Armv8-M Main Extensions (i.e. Cortex-M23) lack the non-secure Stack Pointer Limit register hence zero is returned always. </p>
390 <p>Returns the current value of the non-secure Process Stack Pointer Limit (PSPLIM) when in secure state. </p><dl class="section return"><dt>Returns</dt><dd>PSPLIM register value </dd></dl>
394 <a id="gaaaf2aaf904b25ed17fd3e5e63f8e029b" name="gaaaf2aaf904b25ed17fd3e5e63f8e029b"></a>
395 <h2 class="memtitle"><span class="permalink"><a href="#gaaaf2aaf904b25ed17fd3e5e63f8e029b">◆ </a></span>__TZ_get_SP_NS()</h2>
397 <div class="memitem">
398 <div class="memproto">
399 <table class="memname">
401 <td class="memname">uint32_t __TZ_get_SP_NS </td>
403 <td class="paramtype">void </td>
404 <td class="paramname"></td><td>)</td>
408 </div><div class="memdoc">
410 <p>Get Stack Pointer (non-secure) </p>
411 <p>Returns the current value of the non-secure Stack Pointer (SP) when in secure state. </p><dl class="section return"><dt>Returns</dt><dd>SP register value </dd></dl>
415 <a id="ga92c187f0b4d53627b59e0fd0bda0b0df" name="ga92c187f0b4d53627b59e0fd0bda0b0df"></a>
416 <h2 class="memtitle"><span class="permalink"><a href="#ga92c187f0b4d53627b59e0fd0bda0b0df">◆ </a></span>__TZ_set_BASEPRI_NS()</h2>
418 <div class="memitem">
419 <div class="memproto">
420 <table class="memname">
422 <td class="memname">void __TZ_set_BASEPRI_NS </td>
424 <td class="paramtype">uint32_t </td>
425 <td class="paramname"><em>basePri</em></td><td>)</td>
429 </div><div class="memdoc">
431 <p>Set Base Priority (non-secure) </p>
432 <p>Assigns the given value to the non-secure Base Priority register when in secure state. </p><dl class="params"><dt>Parameters</dt><dd>
433 <table class="params">
434 <tr><td class="paramdir">[in]</td><td class="paramname">basePri</td><td>Base Priority value to set </td></tr>
438 <dl class="section see"><dt>See also</dt><dd><br />
440 <li><a class="el" href="group__Core__Register__gr.html#ga360c73eb7ffb16088556f9278953b882">__set_BASEPRI</a> </li>
446 <a id="ga3eb150204e6d389d5b49065179b9cde5" name="ga3eb150204e6d389d5b49065179b9cde5"></a>
447 <h2 class="memtitle"><span class="permalink"><a href="#ga3eb150204e6d389d5b49065179b9cde5">◆ </a></span>__TZ_set_CONTROL_NS()</h2>
449 <div class="memitem">
450 <div class="memproto">
451 <table class="memname">
453 <td class="memname">void __TZ_set_CONTROL_NS </td>
455 <td class="paramtype">uint32_t </td>
456 <td class="paramname"><em>control</em></td><td>)</td>
460 </div><div class="memdoc">
462 <p>Set Control register (non-secure) </p>
463 <p>Writes the given value to the non-secure Control register when in secure state. </p><dl class="params"><dt>Parameters</dt><dd>
464 <table class="params">
465 <tr><td class="paramdir">[in]</td><td class="paramname">control</td><td>Control register value to set </td></tr>
469 <dl class="section see"><dt>See also</dt><dd><br />
471 <li><a class="el" href="group__Core__Register__gr.html#gac64d37e7ff9de06437f9fb94bbab8b6c">__set_CONTROL</a>; <a class="el" href="unionCONTROL__Type.html" title="Union type to access the Control Registers (CONTROL).">CONTROL_Type</a> </li>
477 <a id="ga4f0912db7bc65439d23817c1d372a7a4" name="ga4f0912db7bc65439d23817c1d372a7a4"></a>
478 <h2 class="memtitle"><span class="permalink"><a href="#ga4f0912db7bc65439d23817c1d372a7a4">◆ </a></span>__TZ_set_FAULTMASK_NS()</h2>
480 <div class="memitem">
481 <div class="memproto">
482 <table class="memname">
484 <td class="memname">void __TZ_set_FAULTMASK_NS </td>
486 <td class="paramtype">uint32_t </td>
487 <td class="paramname"><em>faultMask</em></td><td>)</td>
491 </div><div class="memdoc">
493 <p>Set Fault Mask (non-secure) </p>
494 <p>Assigns the given value to the non-secure Fault Mask register when in secure state. </p><dl class="params"><dt>Parameters</dt><dd>
495 <table class="params">
496 <tr><td class="paramdir">[in]</td><td class="paramname">faultMask</td><td>Fault Mask value to set </td></tr>
500 <dl class="section see"><dt>See also</dt><dd><br />
502 <li><a class="el" href="group__Core__Register__gr.html#gaa5587cc09031053a40a35c14ec36078a">__set_FAULTMASK</a> </li>
508 <a id="ga41c3ac2d9af23c40647c053ad7d564e7" name="ga41c3ac2d9af23c40647c053ad7d564e7"></a>
509 <h2 class="memtitle"><span class="permalink"><a href="#ga41c3ac2d9af23c40647c053ad7d564e7">◆ </a></span>__TZ_set_MSP_NS()</h2>
511 <div class="memitem">
512 <div class="memproto">
513 <table class="memname">
515 <td class="memname">void __TZ_set_MSP_NS </td>
517 <td class="paramtype">uint32_t </td>
518 <td class="paramname"><em>topOfMainStack</em></td><td>)</td>
522 </div><div class="memdoc">
524 <p>Set Main Stack Pointer (non-secure) </p>
525 <p>Assigns the given value to the non-secure Main Stack Pointer (MSP) when in secure state. </p><dl class="params"><dt>Parameters</dt><dd>
526 <table class="params">
527 <tr><td class="paramdir">[in]</td><td class="paramname">topOfMainStack</td><td>Main Stack Pointer value to set </td></tr>
531 <dl class="section see"><dt>See also</dt><dd><br />
533 <li><a class="el" href="group__Core__Register__gr.html#ga0bf9564ebc1613a8faba014275dac2a4">__set_MSP</a> </li>
539 <a id="gad2013f4d4311d6db253594a12d192617" name="gad2013f4d4311d6db253594a12d192617"></a>
540 <h2 class="memtitle"><span class="permalink"><a href="#gad2013f4d4311d6db253594a12d192617">◆ </a></span>__TZ_set_MSPLIM_NS()</h2>
542 <div class="memitem">
543 <div class="memproto">
544 <table class="memname">
546 <td class="memname">void __TZ_set_MSPLIM_NS </td>
548 <td class="paramtype">uint32_t </td>
549 <td class="paramname"><em>MainStackPtrLimit</em></td><td>)</td>
553 </div><div class="memdoc">
555 <p>Set Main Stack Pointer Limit (non-secure) Devices without Armv8-M Main Extensions (i.e. Cortex-M23) lack the non-secure Stack Pointer Limit register hence zero is returned always. </p>
556 <p>Assigns the given value to the non-secure Main Stack Pointer Limit (MSPLIM) when in secure state. </p><dl class="params"><dt>Parameters</dt><dd>
557 <table class="params">
558 <tr><td class="paramdir">[in]</td><td class="paramname">MainStackPtrLimit</td><td>Main Stack Pointer value to set </td></tr>
565 <a id="ga6686c2ab5756b5049fad1644e89b3340" name="ga6686c2ab5756b5049fad1644e89b3340"></a>
566 <h2 class="memtitle"><span class="permalink"><a href="#ga6686c2ab5756b5049fad1644e89b3340">◆ </a></span>__TZ_set_PRIMASK_NS()</h2>
568 <div class="memitem">
569 <div class="memproto">
570 <table class="memname">
572 <td class="memname">void __TZ_set_PRIMASK_NS </td>
574 <td class="paramtype">uint32_t </td>
575 <td class="paramname"><em>priMask</em></td><td>)</td>
579 </div><div class="memdoc">
581 <p>Set Priority Mask (non-secure) </p>
582 <p>Assigns the given value to the non-secure Priority Mask register when in secure state. </p><dl class="params"><dt>Parameters</dt><dd>
583 <table class="params">
584 <tr><td class="paramdir">[in]</td><td class="paramname">priMask</td><td>Priority Mask </td></tr>
588 <dl class="section see"><dt>See also</dt><dd><br />
590 <li><a class="el" href="group__Core__Register__gr.html#ga70b4e1a6c1c86eb913fb9d6e8400156f">__set_PRIMASK</a> </li>
596 <a id="gaea8db21c00cfa4144ee74dc65dbd7580" name="gaea8db21c00cfa4144ee74dc65dbd7580"></a>
597 <h2 class="memtitle"><span class="permalink"><a href="#gaea8db21c00cfa4144ee74dc65dbd7580">◆ </a></span>__TZ_set_PSP_NS()</h2>
599 <div class="memitem">
600 <div class="memproto">
601 <table class="memname">
603 <td class="memname">void __TZ_set_PSP_NS </td>
605 <td class="paramtype">uint32_t </td>
606 <td class="paramname"><em>topOfProcStack</em></td><td>)</td>
610 </div><div class="memdoc">
612 <p>Set Process Stack Pointer (non-secure) </p>
613 <p>Assigns the given value to the non-secure Process Stack Pointer (PSP) when in secure state. </p><dl class="params"><dt>Parameters</dt><dd>
614 <table class="params">
615 <tr><td class="paramdir">[in]</td><td class="paramname">topOfProcStack</td><td>Process Stack Pointer value to set </td></tr>
619 <dl class="section see"><dt>See also</dt><dd><br />
621 <li><a class="el" href="group__Core__Register__gr.html#ga48e5853f417e17a8a65080f6a605b743">__set_PSP</a> </li>
627 <a id="ga81e0995ee0fd2a9dcd9e9681bc22c76f" name="ga81e0995ee0fd2a9dcd9e9681bc22c76f"></a>
628 <h2 class="memtitle"><span class="permalink"><a href="#ga81e0995ee0fd2a9dcd9e9681bc22c76f">◆ </a></span>__TZ_set_PSPLIM_NS()</h2>
630 <div class="memitem">
631 <div class="memproto">
632 <table class="memname">
634 <td class="memname">void __TZ_set_PSPLIM_NS </td>
636 <td class="paramtype">uint32_t </td>
637 <td class="paramname"><em>ProcStackPtrLimit</em></td><td>)</td>
641 </div><div class="memdoc">
643 <p>Set Process Stack Pointer (non-secure) Devices without Armv8-M Main Extensions (i.e. Cortex-M23) lack the non-secure Stack Pointer Limit register hence zero is returned always. </p>
644 <p>Assigns the given value to the non-secure Process Stack Pointer Limit (PSPLIM) when in secure state. </p><dl class="params"><dt>Parameters</dt><dd>
645 <table class="params">
646 <tr><td class="paramdir">[in]</td><td class="paramname">ProcStackPtrLimit</td><td>Process Stack Pointer Limit value to set </td></tr>
653 <a id="gab7263167cb006aeeb04b68e579dae015" name="gab7263167cb006aeeb04b68e579dae015"></a>
654 <h2 class="memtitle"><span class="permalink"><a href="#gab7263167cb006aeeb04b68e579dae015">◆ </a></span>__TZ_set_SP_NS()</h2>
656 <div class="memitem">
657 <div class="memproto">
658 <table class="memname">
660 <td class="memname">void __TZ_set_SP_NS </td>
662 <td class="paramtype">uint32_t </td>
663 <td class="paramname"><em>topOfStack</em></td><td>)</td>
667 </div><div class="memdoc">
669 <p>Set Stack Pointer (non-secure) </p>
670 <p>Assigns the given value to the non-secure Stack Pointer (SP) when in secure state. </p><dl class="params"><dt>Parameters</dt><dd>
671 <table class="params">
672 <tr><td class="paramdir">[in]</td><td class="paramname">topOfStack</td><td>Stack Pointer value to set </td></tr>
679 </div><!-- contents -->
680 </div><!-- doc-content -->
681 <!-- start footer part -->
682 <div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
685 <script type="text/javascript">
687 writeFooter.call(this);