]> begriffs open source - cmsis/blob - main/Core/group__coreregister__trustzone__functions.html
Update main branch documentation
[cmsis] / main / Core / group__coreregister__trustzone__functions.html
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">
4 <head>
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 <link href="tabs.css" rel="stylesheet" type="text/css"/>
11 <link href="extra_navtree.css" rel="stylesheet" type="text/css"/>
12 <link href="extra_stylesheet.css" rel="stylesheet" type="text/css"/>
13 <link href="extra_search.css" rel="stylesheet" type="text/css"/>
14 <script type="text/javascript" src="jquery.js"></script>
15 <script type="text/javascript" src="dynsections.js"></script>
16 <script type="text/javascript" src="printComponentTabs.js"></script>
17 <script type="text/javascript" src="footer.js"></script>
18 <script type="text/javascript" src="navtree.js"></script>
19 <link href="navtree.css" rel="stylesheet" type="text/css"/>
20 <script type="text/javascript" src="resize.js"></script>
21 <script type="text/javascript" src="navtreedata.js"></script>
22 <script type="text/javascript" src="navtree.js"></script>
23 <link href="search/search.css" rel="stylesheet" type="text/css"/>
24 <script type="text/javascript" src="search/searchdata.js"></script>
25 <script type="text/javascript" src="search/search.js"></script>
26 <script type="text/javascript">
27 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
28   $(document).ready(function() { init_search(); });
29 /* @license-end */
30 </script>
31 <script type="text/javascript" src="darkmode_toggle.js"></script>
32 <link href="extra_stylesheet.css" rel="stylesheet" type="text/css"/>
33 <link href="extra_navtree.css" rel="stylesheet" type="text/css"/>
34 <link href="extra_search.css" rel="stylesheet" type="text/css"/>
35 <link href="version.css" rel="stylesheet" type="text/css" />
36 <script type="text/javascript" src="../../version.js"></script>
37 </head>
38 <body>
39 <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
40 <div id="titlearea">
41 <table cellspacing="0" cellpadding="0">
42  <tbody>
43  <tr style="height: 55px;">
44   <td id="projectlogo" style="padding: 1.5em;"><img alt="Logo" src="cmsis_logo_white_small.png"/></td>
45   <td style="padding-left: 1em; padding-bottom: 1em;padding-top: 1em;">
46    <div id="projectname">CMSIS-Core (Cortex-M)
47    &#160;<span id="projectnumber"><script type="text/javascript">
48      <!--
49      writeHeader.call(this);
50      writeVersionDropdown.call(this, "CMSIS-Core (Cortex-M)");
51      //-->
52     </script>
53    </span>
54    </div>
55    <div id="projectbrief">CMSIS-Core support for Cortex-M processor-based devices</div>
56   </td>
57    <td>        <div id="MSearchBox" class="MSearchBoxInactive">
58         <span class="left">
59           <span id="MSearchSelect"                onmouseover="return searchBox.OnSearchSelectShow()"                onmouseout="return searchBox.OnSearchSelectHide()">&#160;</span>
60           <input type="text" id="MSearchField" value="" placeholder="Search" accesskey="S"
61                onfocus="searchBox.OnSearchFieldFocus(true)" 
62                onblur="searchBox.OnSearchFieldFocus(false)" 
63                onkeyup="searchBox.OnSearchFieldChange(event)"/>
64           </span><span class="right">
65             <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.svg" alt=""/></a>
66           </span>
67         </div>
68 </td>
69   <!--END !PROJECT_NAME-->
70  </tr>
71  </tbody>
72 </table>
73 </div>
74 <!-- end header part -->
75 <div id="CMSISnav" class="tabs1">
76   <ul class="tablist">
77     <script type="text/javascript">
78       writeComponentTabs.call(this);
79     </script>
80   </ul>
81 </div>
82 <script type="text/javascript">
83   writeSubComponentTabs.call(this);
84 </script>
85 <!-- Generated by Doxygen 1.9.6 -->
86 <script type="text/javascript">
87 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
88 var searchBox = new SearchBox("searchBox", "search/",'.html');
89 /* @license-end */
90 </script>
91 </div><!-- top -->
92 <div id="side-nav" class="ui-resizable side-nav-resizable">
93   <div id="nav-tree">
94     <div id="nav-tree-contents">
95       <div id="nav-sync" class="sync"></div>
96     </div>
97   </div>
98   <div id="splitbar" style="-moz-user-select:none;" 
99        class="ui-resizable-handle">
100   </div>
101 </div>
102 <script type="text/javascript">
103 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
104 $(document).ready(function(){initNavTree('group__coreregister__trustzone__functions.html',''); initResizable(); });
105 /* @license-end */
106 </script>
107 <div id="doc-content">
108 <!-- window showing the filter options -->
109 <div id="MSearchSelectWindow"
110      onmouseover="return searchBox.OnSearchSelectShow()"
111      onmouseout="return searchBox.OnSearchSelectHide()"
112      onkeydown="return searchBox.OnSearchSelectKey(event)">
113 </div>
114
115 <!-- iframe showing the search results (closed by default) -->
116 <div id="MSearchResultsWindow">
117 <div id="MSearchResults">
118 <div class="SRPage">
119 <div id="SRIndex">
120 <div id="SRResults"></div>
121 <div class="SRStatus" id="Loading">Loading...</div>
122 <div class="SRStatus" id="Searching">Searching...</div>
123 <div class="SRStatus" id="NoMatches">No Matches</div>
124 </div>
125 </div>
126 </div>
127 </div>
128
129 <div class="header">
130   <div class="summary">
131 <a href="#func-members">Functions</a>  </div>
132   <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>
133 </div><!--header-->
134 <div class="contents">
135
136 <p>Core register Access functions related to TrustZone for Armv8-M.  
137 <a href="#details">More...</a></p>
138 <table class="memberdecls">
139 <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="func-members" name="func-members"></a>
140 Functions</h2></td></tr>
141 <tr class="memitem:ga27bf1f88e794c30808ee73a29d46e358"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</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">&#160;</td><td class="mdescRight">Get Control register (non-secure)  <br /></td></tr>
143 <tr class="separator:ga27bf1f88e794c30808ee73a29d46e358"><td class="memSeparator" colspan="2">&#160;</td></tr>
144 <tr class="memitem:ga3eb150204e6d389d5b49065179b9cde5"><td class="memItemLeft" align="right" valign="top">void&#160;</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>
145 <tr class="memdesc:ga3eb150204e6d389d5b49065179b9cde5"><td class="mdescLeft">&#160;</td><td class="mdescRight">Set Control register (non-secure)  <br /></td></tr>
146 <tr class="separator:ga3eb150204e6d389d5b49065179b9cde5"><td class="memSeparator" colspan="2">&#160;</td></tr>
147 <tr class="memitem:ga40ff8336c6d09af6da1081d4e4adc126"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#ga40ff8336c6d09af6da1081d4e4adc126">__TZ_get_PSP_NS</a> (void)</td></tr>
148 <tr class="memdesc:ga40ff8336c6d09af6da1081d4e4adc126"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get Process Stack Pointer (non-secure)  <br /></td></tr>
149 <tr class="separator:ga40ff8336c6d09af6da1081d4e4adc126"><td class="memSeparator" colspan="2">&#160;</td></tr>
150 <tr class="memitem:gaea8db21c00cfa4144ee74dc65dbd7580"><td class="memItemLeft" align="right" valign="top">void&#160;</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>
151 <tr class="memdesc:gaea8db21c00cfa4144ee74dc65dbd7580"><td class="mdescLeft">&#160;</td><td class="mdescRight">Set Process Stack Pointer (non-secure)  <br /></td></tr>
152 <tr class="separator:gaea8db21c00cfa4144ee74dc65dbd7580"><td class="memSeparator" colspan="2">&#160;</td></tr>
153 <tr class="memitem:gab3aa15eb4f352e230b9f7a3e8856a9e9"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#gab3aa15eb4f352e230b9f7a3e8856a9e9">__TZ_get_MSP_NS</a> (void)</td></tr>
154 <tr class="memdesc:gab3aa15eb4f352e230b9f7a3e8856a9e9"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get Main Stack Pointer (non-secure)  <br /></td></tr>
155 <tr class="separator:gab3aa15eb4f352e230b9f7a3e8856a9e9"><td class="memSeparator" colspan="2">&#160;</td></tr>
156 <tr class="memitem:ga41c3ac2d9af23c40647c053ad7d564e7"><td class="memItemLeft" align="right" valign="top">void&#160;</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>
157 <tr class="memdesc:ga41c3ac2d9af23c40647c053ad7d564e7"><td class="mdescLeft">&#160;</td><td class="mdescRight">Set Main Stack Pointer (non-secure)  <br /></td></tr>
158 <tr class="separator:ga41c3ac2d9af23c40647c053ad7d564e7"><td class="memSeparator" colspan="2">&#160;</td></tr>
159 <tr class="memitem:gaaaf2aaf904b25ed17fd3e5e63f8e029b"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#gaaaf2aaf904b25ed17fd3e5e63f8e029b">__TZ_get_SP_NS</a> (void)</td></tr>
160 <tr class="memdesc:gaaaf2aaf904b25ed17fd3e5e63f8e029b"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get Stack Pointer (non-secure)  <br /></td></tr>
161 <tr class="separator:gaaaf2aaf904b25ed17fd3e5e63f8e029b"><td class="memSeparator" colspan="2">&#160;</td></tr>
162 <tr class="memitem:gab7263167cb006aeeb04b68e579dae015"><td class="memItemLeft" align="right" valign="top">void&#160;</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>
163 <tr class="memdesc:gab7263167cb006aeeb04b68e579dae015"><td class="mdescLeft">&#160;</td><td class="mdescRight">Set Stack Pointer (non-secure)  <br /></td></tr>
164 <tr class="separator:gab7263167cb006aeeb04b68e579dae015"><td class="memSeparator" colspan="2">&#160;</td></tr>
165 <tr class="memitem:ga7cc3271c79e619f8838e8767df3cb509"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#ga7cc3271c79e619f8838e8767df3cb509">__TZ_get_PRIMASK_NS</a> (void)</td></tr>
166 <tr class="memdesc:ga7cc3271c79e619f8838e8767df3cb509"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get Priority Mask (non-secure)  <br /></td></tr>
167 <tr class="separator:ga7cc3271c79e619f8838e8767df3cb509"><td class="memSeparator" colspan="2">&#160;</td></tr>
168 <tr class="memitem:ga6686c2ab5756b5049fad1644e89b3340"><td class="memItemLeft" align="right" valign="top">void&#160;</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>
169 <tr class="memdesc:ga6686c2ab5756b5049fad1644e89b3340"><td class="mdescLeft">&#160;</td><td class="mdescRight">Set Priority Mask (non-secure)  <br /></td></tr>
170 <tr class="separator:ga6686c2ab5756b5049fad1644e89b3340"><td class="memSeparator" colspan="2">&#160;</td></tr>
171 <tr class="memitem:ga624509c924d2583f0d4dca6ab270f051"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#ga624509c924d2583f0d4dca6ab270f051">__TZ_get_BASEPRI_NS</a> (void)</td></tr>
172 <tr class="memdesc:ga624509c924d2583f0d4dca6ab270f051"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get Base Priority (non-secure)  <br /></td></tr>
173 <tr class="separator:ga624509c924d2583f0d4dca6ab270f051"><td class="memSeparator" colspan="2">&#160;</td></tr>
174 <tr class="memitem:ga92c187f0b4d53627b59e0fd0bda0b0df"><td class="memItemLeft" align="right" valign="top">void&#160;</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>
175 <tr class="memdesc:ga92c187f0b4d53627b59e0fd0bda0b0df"><td class="mdescLeft">&#160;</td><td class="mdescRight">Set Base Priority (non-secure)  <br /></td></tr>
176 <tr class="separator:ga92c187f0b4d53627b59e0fd0bda0b0df"><td class="memSeparator" colspan="2">&#160;</td></tr>
177 <tr class="memitem:ga578b41087f207e1a475daae6cc8a28dc"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#ga578b41087f207e1a475daae6cc8a28dc">__TZ_get_FAULTMASK_NS</a> (void)</td></tr>
178 <tr class="memdesc:ga578b41087f207e1a475daae6cc8a28dc"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get Fault Mask (non-secure)  <br /></td></tr>
179 <tr class="separator:ga578b41087f207e1a475daae6cc8a28dc"><td class="memSeparator" colspan="2">&#160;</td></tr>
180 <tr class="memitem:ga4f0912db7bc65439d23817c1d372a7a4"><td class="memItemLeft" align="right" valign="top">void&#160;</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>
181 <tr class="memdesc:ga4f0912db7bc65439d23817c1d372a7a4"><td class="mdescLeft">&#160;</td><td class="mdescRight">Set Fault Mask (non-secure)  <br /></td></tr>
182 <tr class="separator:ga4f0912db7bc65439d23817c1d372a7a4"><td class="memSeparator" colspan="2">&#160;</td></tr>
183 <tr class="memitem:ga5da646ec291b6a183f38497ce92be51c"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#ga5da646ec291b6a183f38497ce92be51c">__TZ_get_PSPLIM_NS</a> (void)</td></tr>
184 <tr class="memdesc:ga5da646ec291b6a183f38497ce92be51c"><td class="mdescLeft">&#160;</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>
185 <tr class="separator:ga5da646ec291b6a183f38497ce92be51c"><td class="memSeparator" colspan="2">&#160;</td></tr>
186 <tr class="memitem:ga81e0995ee0fd2a9dcd9e9681bc22c76f"><td class="memItemLeft" align="right" valign="top">void&#160;</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">&#160;</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">&#160;</td></tr>
189 <tr class="memitem:gada00853d3e49fa8d21f375c53d28fa51"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__coreregister__trustzone__functions.html#gada00853d3e49fa8d21f375c53d28fa51">__TZ_get_MSPLIM_NS</a> (void)</td></tr>
190 <tr class="memdesc:gada00853d3e49fa8d21f375c53d28fa51"><td class="mdescLeft">&#160;</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>
191 <tr class="separator:gada00853d3e49fa8d21f375c53d28fa51"><td class="memSeparator" colspan="2">&#160;</td></tr>
192 <tr class="memitem:gad2013f4d4311d6db253594a12d192617"><td class="memItemLeft" align="right" valign="top">void&#160;</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>
193 <tr class="memdesc:gad2013f4d4311d6db253594a12d192617"><td class="mdescLeft">&#160;</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>
194 <tr class="separator:gad2013f4d4311d6db253594a12d192617"><td class="memSeparator" colspan="2">&#160;</td></tr>
195 </table>
196 <a name="details" id="details"></a><h2 class="groupheader">Description</h2>
197 <p>Core register Access functions related to TrustZone for Armv8-M. </p>
198 <h2 class="groupheader">Function Documentation</h2>
199 <a id="ga624509c924d2583f0d4dca6ab270f051" name="ga624509c924d2583f0d4dca6ab270f051"></a>
200 <h2 class="memtitle"><span class="permalink"><a href="#ga624509c924d2583f0d4dca6ab270f051">&#9670;&#160;</a></span>__TZ_get_BASEPRI_NS()</h2>
201
202 <div class="memitem">
203 <div class="memproto">
204       <table class="memname">
205         <tr>
206           <td class="memname">uint32_t __TZ_get_BASEPRI_NS </td>
207           <td>(</td>
208           <td class="paramtype">void&#160;</td>
209           <td class="paramname"></td><td>)</td>
210           <td></td>
211         </tr>
212       </table>
213 </div><div class="memdoc">
214
215 <p>Get Base Priority (non-secure) </p>
216 <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>
217 <dl class="section see"><dt>See also</dt><dd><br  />
218 <ul>
219 <li><a class="el" href="group__Core__Register__gr.html#ga32da759f46e52c95bcfbde5012260667">__get_BASEPRI</a> </li>
220 </ul>
221 </dd></dl>
222
223 </div>
224 </div>
225 <a id="ga27bf1f88e794c30808ee73a29d46e358" name="ga27bf1f88e794c30808ee73a29d46e358"></a>
226 <h2 class="memtitle"><span class="permalink"><a href="#ga27bf1f88e794c30808ee73a29d46e358">&#9670;&#160;</a></span>__TZ_get_CONTROL_NS()</h2>
227
228 <div class="memitem">
229 <div class="memproto">
230       <table class="memname">
231         <tr>
232           <td class="memname">uint32_t __TZ_get_CONTROL_NS </td>
233           <td>(</td>
234           <td class="paramtype">void&#160;</td>
235           <td class="paramname"></td><td>)</td>
236           <td></td>
237         </tr>
238       </table>
239 </div><div class="memdoc">
240
241 <p>Get Control register (non-secure) </p>
242 <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>
243 <dl class="section see"><dt>See also</dt><dd><br  />
244 <ul>
245 <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>
246 </ul>
247 </dd></dl>
248
249 </div>
250 </div>
251 <a id="ga578b41087f207e1a475daae6cc8a28dc" name="ga578b41087f207e1a475daae6cc8a28dc"></a>
252 <h2 class="memtitle"><span class="permalink"><a href="#ga578b41087f207e1a475daae6cc8a28dc">&#9670;&#160;</a></span>__TZ_get_FAULTMASK_NS()</h2>
253
254 <div class="memitem">
255 <div class="memproto">
256       <table class="memname">
257         <tr>
258           <td class="memname">uint32_t __TZ_get_FAULTMASK_NS </td>
259           <td>(</td>
260           <td class="paramtype">void&#160;</td>
261           <td class="paramname"></td><td>)</td>
262           <td></td>
263         </tr>
264       </table>
265 </div><div class="memdoc">
266
267 <p>Get Fault Mask (non-secure) </p>
268 <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>
269 <dl class="section see"><dt>See also</dt><dd><br  />
270 <ul>
271 <li><a class="el" href="group__Core__Register__gr.html#gaa78e4e6bf619a65e9f01b4af13fed3a8">__get_FAULTMASK</a> </li>
272 </ul>
273 </dd></dl>
274
275 </div>
276 </div>
277 <a id="gab3aa15eb4f352e230b9f7a3e8856a9e9" name="gab3aa15eb4f352e230b9f7a3e8856a9e9"></a>
278 <h2 class="memtitle"><span class="permalink"><a href="#gab3aa15eb4f352e230b9f7a3e8856a9e9">&#9670;&#160;</a></span>__TZ_get_MSP_NS()</h2>
279
280 <div class="memitem">
281 <div class="memproto">
282       <table class="memname">
283         <tr>
284           <td class="memname">uint32_t __TZ_get_MSP_NS </td>
285           <td>(</td>
286           <td class="paramtype">void&#160;</td>
287           <td class="paramname"></td><td>)</td>
288           <td></td>
289         </tr>
290       </table>
291 </div><div class="memdoc">
292
293 <p>Get Main Stack Pointer (non-secure) </p>
294 <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>
295 <dl class="section see"><dt>See also</dt><dd><br  />
296 <ul>
297 <li><a class="el" href="group__Core__Register__gr.html#gab898559392ba027814e5bbb5a98b38d2">__get_MSP</a> </li>
298 </ul>
299 </dd></dl>
300
301 </div>
302 </div>
303 <a id="gada00853d3e49fa8d21f375c53d28fa51" name="gada00853d3e49fa8d21f375c53d28fa51"></a>
304 <h2 class="memtitle"><span class="permalink"><a href="#gada00853d3e49fa8d21f375c53d28fa51">&#9670;&#160;</a></span>__TZ_get_MSPLIM_NS()</h2>
305
306 <div class="memitem">
307 <div class="memproto">
308       <table class="memname">
309         <tr>
310           <td class="memname">uint32_t __TZ_get_MSPLIM_NS </td>
311           <td>(</td>
312           <td class="paramtype">void&#160;</td>
313           <td class="paramname"></td><td>)</td>
314           <td></td>
315         </tr>
316       </table>
317 </div><div class="memdoc">
318
319 <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>
320 <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
322 </div>
323 </div>
324 <a id="ga7cc3271c79e619f8838e8767df3cb509" name="ga7cc3271c79e619f8838e8767df3cb509"></a>
325 <h2 class="memtitle"><span class="permalink"><a href="#ga7cc3271c79e619f8838e8767df3cb509">&#9670;&#160;</a></span>__TZ_get_PRIMASK_NS()</h2>
326
327 <div class="memitem">
328 <div class="memproto">
329       <table class="memname">
330         <tr>
331           <td class="memname">uint32_t __TZ_get_PRIMASK_NS </td>
332           <td>(</td>
333           <td class="paramtype">void&#160;</td>
334           <td class="paramname"></td><td>)</td>
335           <td></td>
336         </tr>
337       </table>
338 </div><div class="memdoc">
339
340 <p>Get Priority Mask (non-secure) </p>
341 <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>
342 <dl class="section see"><dt>See also</dt><dd><br  />
343 <ul>
344 <li><a class="el" href="group__Core__Register__gr.html#ga799b5d9a2ae75e459264c8512c7c0e02">__get_PRIMASK</a> </li>
345 </ul>
346 </dd></dl>
347
348 </div>
349 </div>
350 <a id="ga40ff8336c6d09af6da1081d4e4adc126" name="ga40ff8336c6d09af6da1081d4e4adc126"></a>
351 <h2 class="memtitle"><span class="permalink"><a href="#ga40ff8336c6d09af6da1081d4e4adc126">&#9670;&#160;</a></span>__TZ_get_PSP_NS()</h2>
352
353 <div class="memitem">
354 <div class="memproto">
355       <table class="memname">
356         <tr>
357           <td class="memname">uint32_t __TZ_get_PSP_NS </td>
358           <td>(</td>
359           <td class="paramtype">void&#160;</td>
360           <td class="paramname"></td><td>)</td>
361           <td></td>
362         </tr>
363       </table>
364 </div><div class="memdoc">
365
366 <p>Get Process Stack Pointer (non-secure) </p>
367 <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>
368 <dl class="section see"><dt>See also</dt><dd><br  />
369 <ul>
370 <li><a class="el" href="group__Core__Register__gr.html#ga914dfa8eff7ca53380dd54cf1d8bebd9">__get_PSP</a> </li>
371 </ul>
372 </dd></dl>
373
374 </div>
375 </div>
376 <a id="ga5da646ec291b6a183f38497ce92be51c" name="ga5da646ec291b6a183f38497ce92be51c"></a>
377 <h2 class="memtitle"><span class="permalink"><a href="#ga5da646ec291b6a183f38497ce92be51c">&#9670;&#160;</a></span>__TZ_get_PSPLIM_NS()</h2>
378
379 <div class="memitem">
380 <div class="memproto">
381       <table class="memname">
382         <tr>
383           <td class="memname">uint32_t __TZ_get_PSPLIM_NS </td>
384           <td>(</td>
385           <td class="paramtype">void&#160;</td>
386           <td class="paramname"></td><td>)</td>
387           <td></td>
388         </tr>
389       </table>
390 </div><div class="memdoc">
391
392 <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>
393 <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
395 </div>
396 </div>
397 <a id="gaaaf2aaf904b25ed17fd3e5e63f8e029b" name="gaaaf2aaf904b25ed17fd3e5e63f8e029b"></a>
398 <h2 class="memtitle"><span class="permalink"><a href="#gaaaf2aaf904b25ed17fd3e5e63f8e029b">&#9670;&#160;</a></span>__TZ_get_SP_NS()</h2>
399
400 <div class="memitem">
401 <div class="memproto">
402       <table class="memname">
403         <tr>
404           <td class="memname">uint32_t __TZ_get_SP_NS </td>
405           <td>(</td>
406           <td class="paramtype">void&#160;</td>
407           <td class="paramname"></td><td>)</td>
408           <td></td>
409         </tr>
410       </table>
411 </div><div class="memdoc">
412
413 <p>Get Stack Pointer (non-secure) </p>
414 <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
416 </div>
417 </div>
418 <a id="ga92c187f0b4d53627b59e0fd0bda0b0df" name="ga92c187f0b4d53627b59e0fd0bda0b0df"></a>
419 <h2 class="memtitle"><span class="permalink"><a href="#ga92c187f0b4d53627b59e0fd0bda0b0df">&#9670;&#160;</a></span>__TZ_set_BASEPRI_NS()</h2>
420
421 <div class="memitem">
422 <div class="memproto">
423       <table class="memname">
424         <tr>
425           <td class="memname">void __TZ_set_BASEPRI_NS </td>
426           <td>(</td>
427           <td class="paramtype">uint32_t&#160;</td>
428           <td class="paramname"><em>basePri</em></td><td>)</td>
429           <td></td>
430         </tr>
431       </table>
432 </div><div class="memdoc">
433
434 <p>Set Base Priority (non-secure) </p>
435 <p>Assigns the given value to the non-secure Base Priority register when in secure state. </p><dl class="params"><dt>Parameters</dt><dd>
436   <table class="params">
437     <tr><td class="paramdir">[in]</td><td class="paramname">basePri</td><td>Base Priority value to set </td></tr>
438   </table>
439   </dd>
440 </dl>
441 <dl class="section see"><dt>See also</dt><dd><br  />
442 <ul>
443 <li><a class="el" href="group__Core__Register__gr.html#ga360c73eb7ffb16088556f9278953b882">__set_BASEPRI</a> </li>
444 </ul>
445 </dd></dl>
446
447 </div>
448 </div>
449 <a id="ga3eb150204e6d389d5b49065179b9cde5" name="ga3eb150204e6d389d5b49065179b9cde5"></a>
450 <h2 class="memtitle"><span class="permalink"><a href="#ga3eb150204e6d389d5b49065179b9cde5">&#9670;&#160;</a></span>__TZ_set_CONTROL_NS()</h2>
451
452 <div class="memitem">
453 <div class="memproto">
454       <table class="memname">
455         <tr>
456           <td class="memname">void __TZ_set_CONTROL_NS </td>
457           <td>(</td>
458           <td class="paramtype">uint32_t&#160;</td>
459           <td class="paramname"><em>control</em></td><td>)</td>
460           <td></td>
461         </tr>
462       </table>
463 </div><div class="memdoc">
464
465 <p>Set Control register (non-secure) </p>
466 <p>Writes the given value to the non-secure Control register when in secure state. </p><dl class="params"><dt>Parameters</dt><dd>
467   <table class="params">
468     <tr><td class="paramdir">[in]</td><td class="paramname">control</td><td>Control register value to set </td></tr>
469   </table>
470   </dd>
471 </dl>
472 <dl class="section see"><dt>See also</dt><dd><br  />
473 <ul>
474 <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>
475 </ul>
476 </dd></dl>
477
478 </div>
479 </div>
480 <a id="ga4f0912db7bc65439d23817c1d372a7a4" name="ga4f0912db7bc65439d23817c1d372a7a4"></a>
481 <h2 class="memtitle"><span class="permalink"><a href="#ga4f0912db7bc65439d23817c1d372a7a4">&#9670;&#160;</a></span>__TZ_set_FAULTMASK_NS()</h2>
482
483 <div class="memitem">
484 <div class="memproto">
485       <table class="memname">
486         <tr>
487           <td class="memname">void __TZ_set_FAULTMASK_NS </td>
488           <td>(</td>
489           <td class="paramtype">uint32_t&#160;</td>
490           <td class="paramname"><em>faultMask</em></td><td>)</td>
491           <td></td>
492         </tr>
493       </table>
494 </div><div class="memdoc">
495
496 <p>Set Fault Mask (non-secure) </p>
497 <p>Assigns the given value to the non-secure Fault Mask register when in secure state. </p><dl class="params"><dt>Parameters</dt><dd>
498   <table class="params">
499     <tr><td class="paramdir">[in]</td><td class="paramname">faultMask</td><td>Fault Mask value to set </td></tr>
500   </table>
501   </dd>
502 </dl>
503 <dl class="section see"><dt>See also</dt><dd><br  />
504 <ul>
505 <li><a class="el" href="group__Core__Register__gr.html#gaa5587cc09031053a40a35c14ec36078a">__set_FAULTMASK</a> </li>
506 </ul>
507 </dd></dl>
508
509 </div>
510 </div>
511 <a id="ga41c3ac2d9af23c40647c053ad7d564e7" name="ga41c3ac2d9af23c40647c053ad7d564e7"></a>
512 <h2 class="memtitle"><span class="permalink"><a href="#ga41c3ac2d9af23c40647c053ad7d564e7">&#9670;&#160;</a></span>__TZ_set_MSP_NS()</h2>
513
514 <div class="memitem">
515 <div class="memproto">
516       <table class="memname">
517         <tr>
518           <td class="memname">void __TZ_set_MSP_NS </td>
519           <td>(</td>
520           <td class="paramtype">uint32_t&#160;</td>
521           <td class="paramname"><em>topOfMainStack</em></td><td>)</td>
522           <td></td>
523         </tr>
524       </table>
525 </div><div class="memdoc">
526
527 <p>Set Main Stack Pointer (non-secure) </p>
528 <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>
529   <table class="params">
530     <tr><td class="paramdir">[in]</td><td class="paramname">topOfMainStack</td><td>Main Stack Pointer value to set </td></tr>
531   </table>
532   </dd>
533 </dl>
534 <dl class="section see"><dt>See also</dt><dd><br  />
535 <ul>
536 <li><a class="el" href="group__Core__Register__gr.html#ga0bf9564ebc1613a8faba014275dac2a4">__set_MSP</a> </li>
537 </ul>
538 </dd></dl>
539
540 </div>
541 </div>
542 <a id="gad2013f4d4311d6db253594a12d192617" name="gad2013f4d4311d6db253594a12d192617"></a>
543 <h2 class="memtitle"><span class="permalink"><a href="#gad2013f4d4311d6db253594a12d192617">&#9670;&#160;</a></span>__TZ_set_MSPLIM_NS()</h2>
544
545 <div class="memitem">
546 <div class="memproto">
547       <table class="memname">
548         <tr>
549           <td class="memname">void __TZ_set_MSPLIM_NS </td>
550           <td>(</td>
551           <td class="paramtype">uint32_t&#160;</td>
552           <td class="paramname"><em>MainStackPtrLimit</em></td><td>)</td>
553           <td></td>
554         </tr>
555       </table>
556 </div><div class="memdoc">
557
558 <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>
559 <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>
560   <table class="params">
561     <tr><td class="paramdir">[in]</td><td class="paramname">MainStackPtrLimit</td><td>Main Stack Pointer value to set </td></tr>
562   </table>
563   </dd>
564 </dl>
565
566 </div>
567 </div>
568 <a id="ga6686c2ab5756b5049fad1644e89b3340" name="ga6686c2ab5756b5049fad1644e89b3340"></a>
569 <h2 class="memtitle"><span class="permalink"><a href="#ga6686c2ab5756b5049fad1644e89b3340">&#9670;&#160;</a></span>__TZ_set_PRIMASK_NS()</h2>
570
571 <div class="memitem">
572 <div class="memproto">
573       <table class="memname">
574         <tr>
575           <td class="memname">void __TZ_set_PRIMASK_NS </td>
576           <td>(</td>
577           <td class="paramtype">uint32_t&#160;</td>
578           <td class="paramname"><em>priMask</em></td><td>)</td>
579           <td></td>
580         </tr>
581       </table>
582 </div><div class="memdoc">
583
584 <p>Set Priority Mask (non-secure) </p>
585 <p>Assigns the given value to the non-secure Priority Mask register when in secure state. </p><dl class="params"><dt>Parameters</dt><dd>
586   <table class="params">
587     <tr><td class="paramdir">[in]</td><td class="paramname">priMask</td><td>Priority Mask </td></tr>
588   </table>
589   </dd>
590 </dl>
591 <dl class="section see"><dt>See also</dt><dd><br  />
592 <ul>
593 <li><a class="el" href="group__Core__Register__gr.html#ga70b4e1a6c1c86eb913fb9d6e8400156f">__set_PRIMASK</a> </li>
594 </ul>
595 </dd></dl>
596
597 </div>
598 </div>
599 <a id="gaea8db21c00cfa4144ee74dc65dbd7580" name="gaea8db21c00cfa4144ee74dc65dbd7580"></a>
600 <h2 class="memtitle"><span class="permalink"><a href="#gaea8db21c00cfa4144ee74dc65dbd7580">&#9670;&#160;</a></span>__TZ_set_PSP_NS()</h2>
601
602 <div class="memitem">
603 <div class="memproto">
604       <table class="memname">
605         <tr>
606           <td class="memname">void __TZ_set_PSP_NS </td>
607           <td>(</td>
608           <td class="paramtype">uint32_t&#160;</td>
609           <td class="paramname"><em>topOfProcStack</em></td><td>)</td>
610           <td></td>
611         </tr>
612       </table>
613 </div><div class="memdoc">
614
615 <p>Set Process Stack Pointer (non-secure) </p>
616 <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>
617   <table class="params">
618     <tr><td class="paramdir">[in]</td><td class="paramname">topOfProcStack</td><td>Process Stack Pointer value to set </td></tr>
619   </table>
620   </dd>
621 </dl>
622 <dl class="section see"><dt>See also</dt><dd><br  />
623 <ul>
624 <li><a class="el" href="group__Core__Register__gr.html#ga48e5853f417e17a8a65080f6a605b743">__set_PSP</a> </li>
625 </ul>
626 </dd></dl>
627
628 </div>
629 </div>
630 <a id="ga81e0995ee0fd2a9dcd9e9681bc22c76f" name="ga81e0995ee0fd2a9dcd9e9681bc22c76f"></a>
631 <h2 class="memtitle"><span class="permalink"><a href="#ga81e0995ee0fd2a9dcd9e9681bc22c76f">&#9670;&#160;</a></span>__TZ_set_PSPLIM_NS()</h2>
632
633 <div class="memitem">
634 <div class="memproto">
635       <table class="memname">
636         <tr>
637           <td class="memname">void __TZ_set_PSPLIM_NS </td>
638           <td>(</td>
639           <td class="paramtype">uint32_t&#160;</td>
640           <td class="paramname"><em>ProcStackPtrLimit</em></td><td>)</td>
641           <td></td>
642         </tr>
643       </table>
644 </div><div class="memdoc">
645
646 <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>
647 <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>
648   <table class="params">
649     <tr><td class="paramdir">[in]</td><td class="paramname">ProcStackPtrLimit</td><td>Process Stack Pointer Limit value to set </td></tr>
650   </table>
651   </dd>
652 </dl>
653
654 </div>
655 </div>
656 <a id="gab7263167cb006aeeb04b68e579dae015" name="gab7263167cb006aeeb04b68e579dae015"></a>
657 <h2 class="memtitle"><span class="permalink"><a href="#gab7263167cb006aeeb04b68e579dae015">&#9670;&#160;</a></span>__TZ_set_SP_NS()</h2>
658
659 <div class="memitem">
660 <div class="memproto">
661       <table class="memname">
662         <tr>
663           <td class="memname">void __TZ_set_SP_NS </td>
664           <td>(</td>
665           <td class="paramtype">uint32_t&#160;</td>
666           <td class="paramname"><em>topOfStack</em></td><td>)</td>
667           <td></td>
668         </tr>
669       </table>
670 </div><div class="memdoc">
671
672 <p>Set Stack Pointer (non-secure) </p>
673 <p>Assigns the given value to the non-secure Stack Pointer (SP) when in secure state. </p><dl class="params"><dt>Parameters</dt><dd>
674   <table class="params">
675     <tr><td class="paramdir">[in]</td><td class="paramname">topOfStack</td><td>Stack Pointer value to set </td></tr>
676   </table>
677   </dd>
678 </dl>
679
680 </div>
681 </div>
682 </div><!-- contents -->
683 </div><!-- doc-content -->
684 <!-- start footer part -->
685 <div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
686   <ul>
687     <li class="footer">
688       <script type="text/javascript">
689         <!--
690         writeFooter.call(this);
691         //-->
692       </script> 
693     </li>
694   </ul>
695 </div>
696 </body>
697 </html>