git.sur5r.net Git - freertos/blob - FreeRTOS/Demo/RISC-V_RV32_SiFive_HiFive1_GCC/freedom-metal/doc/html/apiref/interrupt.html

   1
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
   3   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   4
   5 <html xmlns="http://www.w3.org/1999/xhtml">
   6   <head>
   7     <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
   8     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
   9     <title>Interrupts &#8212; Freedom Metal v201905 documentation</title>
  10     <link rel="stylesheet" href="../_static/alabaster.css" type="text/css" />
  11     <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
  12     <script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
  13     <script type="text/javascript" src="../_static/jquery.js"></script>
  14     <script type="text/javascript" src="../_static/underscore.js"></script>
  15     <script type="text/javascript" src="../_static/doctools.js"></script>
  16     <link rel="index" title="Index" href="../genindex.html" />
  17     <link rel="search" title="Search" href="../search.html" />
  18     <link rel="next" title="ITIM" href="itim.html" />
  19     <link rel="prev" title="GPIO" href="gpio.html" />
  20
  21   <link rel="stylesheet" href="../_static/custom.css" type="text/css" />
  22
  23
  24   <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
  25
  26   </head><body>
  27
  28
  29     <div class="document">
  30       <div class="documentwrapper">
  31         <div class="bodywrapper">
  32
  33
  34           <div class="body" role="main">
  35
  36   <div class="section" id="interrupts">
  37 <h1>Interrupts<a class="headerlink" href="#interrupts" title="Permalink to this headline">¶</a></h1>
  38 <p>API for registering and manipulating interrupts. </p>
  39 <div class="breathe-sectiondef docutils container">
  40 <p class="breathe-sectiondef-title rubric">Typedefs</p>
  41 <dl class="type">
  42 <dt id="_CPPv317metal_vector_mode">
  43 <span id="_CPPv217metal_vector_mode"></span><span id="metal_vector_mode"></span><span class="target" id="interrupt_8h_1a12da577bb3179597221662c5589561b3"></span><em class="property">typedef </em><em class="property">enum</em> <a class="reference internal" href="#_CPPv318metal_vector_mode_" title="metal_vector_mode_">metal_vector_mode_</a> <code class="descname">metal_vector_mode</code><a class="headerlink" href="#_CPPv317metal_vector_mode" title="Permalink to this definition">¶</a><br /></dt>
  44 <dd><p>Possible mode of interrupts to operate. </p>
  45 </dd></dl>
  46
  47 <dl class="type">
  48 <dt id="_CPPv325metal_interrupt_handler_t">
  49 <span id="_CPPv225metal_interrupt_handler_t"></span><span id="metal_interrupt_handler_t"></span><span class="target" id="interrupt_8h_1acf581f8608907e67e50300eef23a130b"></span><em class="property">typedef </em>void (*<code class="descname">metal_interrupt_handler_t</code>)<span class="sig-paren">(</span>int, void *<span class="sig-paren">)</span><a class="headerlink" href="#_CPPv325metal_interrupt_handler_t" title="Permalink to this definition">¶</a><br /></dt>
  50 <dd><p>Function signature for interrupt callback handlers. </p>
  51 </dd></dl>
  52
  53 </div>
  54 <div class="breathe-sectiondef docutils container">
  55 <p class="breathe-sectiondef-title rubric">Enums</p>
  56 <dl class="type">
  57 <dt id="_CPPv318metal_vector_mode_">
  58 <span id="_CPPv218metal_vector_mode_"></span><span id="metal_vector_mode_"></span><span class="target" id="interrupt_8h_1ac60eddab23447dc04711785118af2728"></span><em class="property">enum </em><code class="descname">metal_vector_mode_</code><a class="headerlink" href="#_CPPv318metal_vector_mode_" title="Permalink to this definition">¶</a><br /></dt>
  59 <dd><p>Possible mode of interrupts to operate. </p>
  60 <p><em>Values:</em></p>
  61 <dl class="enumerator">
  62 <dt id="_CPPv317METAL_DIRECT_MODE">
  63 <span id="_CPPv217METAL_DIRECT_MODE"></span><span class="target" id="interrupt_8h_1ac60eddab23447dc04711785118af2728ad924f2ea83b99b7d5be2e042e88c6dbd"></span><code class="descname">METAL_DIRECT_MODE</code> = 0<a class="headerlink" href="#_CPPv317METAL_DIRECT_MODE" title="Permalink to this definition">¶</a><br /></dt>
  64 <dd></dd></dl>
  65
  66 <dl class="enumerator">
  67 <dt id="_CPPv317METAL_VECTOR_MODE">
  68 <span id="_CPPv217METAL_VECTOR_MODE"></span><span class="target" id="interrupt_8h_1ac60eddab23447dc04711785118af2728a4287274b1ef3c4a1a5b40ee32740e522"></span><code class="descname">METAL_VECTOR_MODE</code> = 1<a class="headerlink" href="#_CPPv317METAL_VECTOR_MODE" title="Permalink to this definition">¶</a><br /></dt>
  69 <dd></dd></dl>
  70
  71 <dl class="enumerator">
  72 <dt id="_CPPv327METAL_SELECTIVE_VECTOR_MODE">
  73 <span id="_CPPv227METAL_SELECTIVE_VECTOR_MODE"></span><span class="target" id="interrupt_8h_1ac60eddab23447dc04711785118af2728a2a0f324727404e6d792bb629b532388e"></span><code class="descname">METAL_SELECTIVE_VECTOR_MODE</code> = 2<a class="headerlink" href="#_CPPv327METAL_SELECTIVE_VECTOR_MODE" title="Permalink to this definition">¶</a><br /></dt>
  74 <dd></dd></dl>
  75
  76 <dl class="enumerator">
  77 <dt id="_CPPv326METAL_HARDWARE_VECTOR_MODE">
  78 <span id="_CPPv226METAL_HARDWARE_VECTOR_MODE"></span><span class="target" id="interrupt_8h_1ac60eddab23447dc04711785118af2728a4d512f09eb589d9ffd8444706569f9e1"></span><code class="descname">METAL_HARDWARE_VECTOR_MODE</code> = 3<a class="headerlink" href="#_CPPv326METAL_HARDWARE_VECTOR_MODE" title="Permalink to this definition">¶</a><br /></dt>
  79 <dd></dd></dl>
  80
  81 </dd></dl>
  82
  83 </div>
  84 <div class="breathe-sectiondef docutils container">
  85 <p class="breathe-sectiondef-title rubric">Functions</p>
  86 <dl class="function">
  87 <dt id="_CPPv320metal_interrupt_initP15metal_interrupt">
  88 <span id="_CPPv220metal_interrupt_initP15metal_interrupt"></span><span id="metal_interrupt_init__metal_interruptP"></span><span class="target" id="interrupt_8h_1a8bb69d1c3f0a58fbbe9f849c2dd5d0f6"></span>void <code class="descname">metal_interrupt_init</code><span class="sig-paren">(</span><em class="property">struct</em> <a class="reference internal" href="#_CPPv315metal_interrupt" title="metal_interrupt">metal_interrupt</a> *<em>controller</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv320metal_interrupt_initP15metal_interrupt" title="Permalink to this definition">¶</a><br /></dt>
  89 <dd><p>Initialize a given interrupt controller. </p>
  90 <p>Initialize a given interrupt controller. This function must be called before any interrupts are registered or enabled with the handler. It is invalid to initialize an interrupt controller more than once.</p>
  91 <p><dl class="docutils">
  92 <dt><strong>Parameters</strong></dt>
  93 <dd><ul class="breatheparameterlist first last simple">
  94 <li><code class="docutils literal notranslate"><span class="pre">controller</span></code>: The handle for the interrupt controller </li>
  95 </ul>
  96 </dd>
  97 </dl>
  98 </p>
  99 </dd></dl>
 100
 101 <dl class="function">
 102 <dt id="_CPPv332metal_interrupt_register_handlerP15metal_interrupti25metal_interrupt_handler_tPv">
 103 <span id="_CPPv232metal_interrupt_register_handlerP15metal_interrupti25metal_interrupt_handler_tPv"></span><span id="metal_interrupt_register_handler__metal_interruptP.i.metal_interrupt_handler_t.voidP"></span><span class="target" id="interrupt_8h_1a308bebb1f3baa79e140f62ed5c15637a"></span>int <code class="descname">metal_interrupt_register_handler</code><span class="sig-paren">(</span><em class="property">struct</em> <a class="reference internal" href="#_CPPv315metal_interrupt" title="metal_interrupt">metal_interrupt</a> *<em>controller</em>, int <em>id</em>, <a class="reference internal" href="#_CPPv325metal_interrupt_handler_t" title="metal_interrupt_handler_t">metal_interrupt_handler_t</a> <em>handler</em>, void *<em>priv_data</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv332metal_interrupt_register_handlerP15metal_interrupti25metal_interrupt_handler_tPv" title="Permalink to this definition">¶</a><br /></dt>
 104 <dd><p>Register an interrupt handler. </p>
 105 <p><dl class="docutils">
 106 <dt><strong>Return</strong></dt>
 107 <dd>0 upon success </dd>
 108 <dt><strong>Parameters</strong></dt>
 109 <dd><ul class="breatheparameterlist first last simple">
 110 <li><code class="docutils literal notranslate"><span class="pre">controller</span></code>: The handle for the interrupt controller </li>
 111 <li><code class="docutils literal notranslate"><span class="pre">id</span></code>: The interrupt ID to register </li>
 112 <li><code class="docutils literal notranslate"><span class="pre">handler</span></code>: The interrupt handler callback </li>
 113 <li><code class="docutils literal notranslate"><span class="pre">priv_data</span></code>: Private data for the interrupt handler </li>
 114 </ul>
 115 </dd>
 116 </dl>
 117 </p>
 118 </dd></dl>
 119
 120 <dl class="function">
 121 <dt id="_CPPv322metal_interrupt_enableP15metal_interrupti">
 122 <span id="_CPPv222metal_interrupt_enableP15metal_interrupti"></span><span id="metal_interrupt_enable__metal_interruptP.i"></span><span class="target" id="interrupt_8h_1a783a6d5804e097dad0a4434a058e45de"></span>int <code class="descname">metal_interrupt_enable</code><span class="sig-paren">(</span><em class="property">struct</em> <a class="reference internal" href="#_CPPv315metal_interrupt" title="metal_interrupt">metal_interrupt</a> *<em>controller</em>, int <em>id</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv322metal_interrupt_enableP15metal_interrupti" title="Permalink to this definition">¶</a><br /></dt>
 123 <dd><p>Enable an interrupt. </p>
 124 <p><dl class="docutils">
 125 <dt><strong>Return</strong></dt>
 126 <dd>0 upon success </dd>
 127 <dt><strong>Parameters</strong></dt>
 128 <dd><ul class="breatheparameterlist first last simple">
 129 <li><code class="docutils literal notranslate"><span class="pre">controller</span></code>: The handle for the interrupt controller </li>
 130 <li><code class="docutils literal notranslate"><span class="pre">id</span></code>: The interrupt ID to enable </li>
 131 </ul>
 132 </dd>
 133 </dl>
 134 </p>
 135 </dd></dl>
 136
 137 <dl class="function">
 138 <dt id="_CPPv323metal_interrupt_disableP15metal_interrupti">
 139 <span id="_CPPv223metal_interrupt_disableP15metal_interrupti"></span><span id="metal_interrupt_disable__metal_interruptP.i"></span><span class="target" id="interrupt_8h_1a3f1ed02d57dd231db5c92945e0a347e8"></span>int <code class="descname">metal_interrupt_disable</code><span class="sig-paren">(</span><em class="property">struct</em> <a class="reference internal" href="#_CPPv315metal_interrupt" title="metal_interrupt">metal_interrupt</a> *<em>controller</em>, int <em>id</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv323metal_interrupt_disableP15metal_interrupti" title="Permalink to this definition">¶</a><br /></dt>
 140 <dd><p>Disable an interrupt. </p>
 141 <p><dl class="docutils">
 142 <dt><strong>Return</strong></dt>
 143 <dd>0 upon success </dd>
 144 <dt><strong>Parameters</strong></dt>
 145 <dd><ul class="breatheparameterlist first last simple">
 146 <li><code class="docutils literal notranslate"><span class="pre">controller</span></code>: The handle for the interrupt controller </li>
 147 <li><code class="docutils literal notranslate"><span class="pre">id</span></code>: The interrupt ID to disable </li>
 148 </ul>
 149 </dd>
 150 </dl>
 151 </p>
 152 </dd></dl>
 153
 154 <dl class="function">
 155 <dt id="_CPPv329metal_interrupt_vector_enableP15metal_interrupti17metal_vector_mode">
 156 <span id="_CPPv229metal_interrupt_vector_enableP15metal_interrupti17metal_vector_mode"></span><span id="metal_interrupt_vector_enable__metal_interruptP.i.metal_vector_mode"></span><span class="target" id="interrupt_8h_1a2535af198e205b152e6794ac9fe9c41c"></span>int <code class="descname">metal_interrupt_vector_enable</code><span class="sig-paren">(</span><em class="property">struct</em> <a class="reference internal" href="#_CPPv315metal_interrupt" title="metal_interrupt">metal_interrupt</a> *<em>controller</em>, int <em>id</em>, <a class="reference internal" href="#_CPPv317metal_vector_mode" title="metal_vector_mode">metal_vector_mode</a> <em>mode</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv329metal_interrupt_vector_enableP15metal_interrupti17metal_vector_mode" title="Permalink to this definition">¶</a><br /></dt>
 157 <dd><p>Enable an interrupt vector. </p>
 158 <p><dl class="docutils">
 159 <dt><strong>Return</strong></dt>
 160 <dd>0 upon success </dd>
 161 <dt><strong>Parameters</strong></dt>
 162 <dd><ul class="breatheparameterlist first last simple">
 163 <li><code class="docutils literal notranslate"><span class="pre">controller</span></code>: The handle for the interrupt controller </li>
 164 <li><code class="docutils literal notranslate"><span class="pre">id</span></code>: The interrupt ID to enable </li>
 165 <li><code class="docutils literal notranslate"><span class="pre">mode</span></code>: The interrupt mode type to enable </li>
 166 </ul>
 167 </dd>
 168 </dl>
 169 </p>
 170 </dd></dl>
 171
 172 <dl class="function">
 173 <dt id="_CPPv330metal_interrupt_vector_disableP15metal_interrupti">
 174 <span id="_CPPv230metal_interrupt_vector_disableP15metal_interrupti"></span><span id="metal_interrupt_vector_disable__metal_interruptP.i"></span><span class="target" id="interrupt_8h_1ac1c55fc3389c5c83b7488dde8f4c863b"></span>int <code class="descname">metal_interrupt_vector_disable</code><span class="sig-paren">(</span><em class="property">struct</em> <a class="reference internal" href="#_CPPv315metal_interrupt" title="metal_interrupt">metal_interrupt</a> *<em>controller</em>, int <em>id</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv330metal_interrupt_vector_disableP15metal_interrupti" title="Permalink to this definition">¶</a><br /></dt>
 175 <dd><p>Disable an interrupt vector. </p>
 176 <p><dl class="docutils">
 177 <dt><strong>Return</strong></dt>
 178 <dd>0 upon success </dd>
 179 <dt><strong>Parameters</strong></dt>
 180 <dd><ul class="breatheparameterlist first last simple">
 181 <li><code class="docutils literal notranslate"><span class="pre">controller</span></code>: The handle for the interrupt controller </li>
 182 <li><code class="docutils literal notranslate"><span class="pre">id</span></code>: The interrupt ID to disable </li>
 183 </ul>
 184 </dd>
 185 </dl>
 186 </p>
 187 </dd></dl>
 188
 189 </div>
 190 <dl class="class">
 191 <dt id="_CPPv315metal_interrupt">
 192 <span id="_CPPv215metal_interrupt"></span><span id="metal_interrupt"></span><span class="target" id="structmetal__interrupt"></span><em class="property">struct </em><code class="descname">metal_interrupt</code><a class="headerlink" href="#_CPPv315metal_interrupt" title="Permalink to this definition">¶</a><br /></dt>
 193 <dd><em>#include &lt;interrupt.h&gt;</em><p>A handle for an interrupt. </p>
 194 </dd></dl>
 195
 196 </div>
 197
 198
 199           </div>
 200
 201         </div>
 202       </div>
 203       <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 204         <div class="sphinxsidebarwrapper">
 205 <h1 class="logo"><a href="../index.html">Freedom Metal</a></h1>
 206
 207
 208
 209
 210
 211
 212
 213
 214 <h3>Navigation</h3>
 215 <ul class="current">
 216 <li class="toctree-l1"><a class="reference internal" href="../introduction.html">Introduction to Freedom Metal</a></li>
 217 <li class="toctree-l1"><a class="reference internal" href="../devguide.html">Developer Guide</a></li>
 218 <li class="toctree-l1 current"><a class="reference internal" href="../api.html">API Reference</a><ul class="current">
 219 <li class="toctree-l2"><a class="reference internal" href="button.html">Buttons</a></li>
 220 <li class="toctree-l2"><a class="reference internal" href="cache.html">Caches</a></li>
 221 <li class="toctree-l2"><a class="reference internal" href="clock.html">Clocks</a></li>
 222 <li class="toctree-l2"><a class="reference internal" href="cpu.html">CPU</a></li>
 223 <li class="toctree-l2"><a class="reference internal" href="gpio.html">GPIO</a></li>
 224 <li class="toctree-l2 current"><a class="current reference internal" href="#">Interrupts</a></li>
 225 <li class="toctree-l2"><a class="reference internal" href="itim.html">ITIM</a></li>
 226 <li class="toctree-l2"><a class="reference internal" href="led.html">LEDs</a></li>
 227 <li class="toctree-l2"><a class="reference internal" href="lock.html">Locks</a></li>
 228 <li class="toctree-l2"><a class="reference internal" href="memory.html">Memory Enumeration</a></li>
 229 <li class="toctree-l2"><a class="reference internal" href="pmp.html">PMPs</a></li>
 230 <li class="toctree-l2"><a class="reference internal" href="shutdown.html">Shutdown</a></li>
 231 <li class="toctree-l2"><a class="reference internal" href="spi.html">SPIs</a></li>
 232 <li class="toctree-l2"><a class="reference internal" href="switch.html">Switches</a></li>
 233 <li class="toctree-l2"><a class="reference internal" href="timer.html">Timer API</a></li>
 234 <li class="toctree-l2"><a class="reference internal" href="tty.html">TTY</a></li>
 235 <li class="toctree-l2"><a class="reference internal" href="uart.html">UARTs</a></li>
 236 </ul>
 237 </li>
 238 </ul>
 239
 240 <div class="relations">
 241 <h3>Related Topics</h3>
 242 <ul>
 243   <li><a href="../index.html">Documentation overview</a><ul>
 244   <li><a href="../api.html">API Reference</a><ul>
 245       <li>Previous: <a href="gpio.html" title="previous chapter">GPIO</a></li>
 246       <li>Next: <a href="itim.html" title="next chapter">ITIM</a></li>
 247   </ul></li>
 248   </ul></li>
 249 </ul>
 250 </div>
 251 <div id="searchbox" style="display: none" role="search">
 252   <h3>Quick search</h3>
 253     <div class="searchformwrapper">
 254     <form class="search" action="../search.html" method="get">
 255       <input type="text" name="q" />
 256       <input type="submit" value="Go" />
 257       <input type="hidden" name="check_keywords" value="yes" />
 258       <input type="hidden" name="area" value="default" />
 259     </form>
 260     </div>
 261 </div>
 262 <script type="text/javascript">$('#searchbox').show(0);</script>
 263         </div>
 264       </div>
 265       <div class="clearer"></div>
 266     </div>
 267     <div class="footer">
 268       &copy;2019, SiFive Inc..
 269
 270       |
 271       Powered by <a href="http://sphinx-doc.org/">Sphinx 1.7.5</a>
 272       &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.11</a>
 273
 274       |
 275       <a href="../_sources/apiref/interrupt.rst.txt"
 276           rel="nofollow">Page source</a>
 277     </div>
 278
 279
 280
 281
 282   </body>
 283 </html>