Mateusz Kowalik / Application_danix

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Fork of Application by Daniel Sygut

mbed-dev/targets/TARGET_Atmel/TARGET_SAM_CortexM0P/drivers/system/interrupt/system_interrupt.h@15:2a20c3d2616e, 2018-02-15 (annotated)

Committer:
Zaitsev
Date:
Thu Feb 15 14:29:23 2018 +0000
Revision:
15:2a20c3d2616e
Parent:
10:41552d038a69 
j

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Zaitsev 10:41552d038a69 1 /**
Zaitsev 10:41552d038a69 2 * \file
Zaitsev 10:41552d038a69 3 *
Zaitsev 10:41552d038a69 4 * \brief SAM System Interrupt Driver
Zaitsev 10:41552d038a69 5 *
Zaitsev 10:41552d038a69 6 * Copyright (C) 2012-2015 Atmel Corporation. All rights reserved.
Zaitsev 10:41552d038a69 7 *
Zaitsev 10:41552d038a69 8 * \asf_license_start
Zaitsev 10:41552d038a69 9 *
Zaitsev 10:41552d038a69 10 * \page License
Zaitsev 10:41552d038a69 11 *
Zaitsev 10:41552d038a69 12 * Redistribution and use in source and binary forms, with or without
Zaitsev 10:41552d038a69 13 * modification, are permitted provided that the following conditions are met:
Zaitsev 10:41552d038a69 14 *
Zaitsev 10:41552d038a69 15 * 1. Redistributions of source code must retain the above copyright notice,
Zaitsev 10:41552d038a69 16 * this list of conditions and the following disclaimer.
Zaitsev 10:41552d038a69 17 *
Zaitsev 10:41552d038a69 18 * 2. Redistributions in binary form must reproduce the above copyright notice,
Zaitsev 10:41552d038a69 19 * this list of conditions and the following disclaimer in the documentation
Zaitsev 10:41552d038a69 20 * and/or other materials provided with the distribution.
Zaitsev 10:41552d038a69 21 *
Zaitsev 10:41552d038a69 22 * 3. The name of Atmel may not be used to endorse or promote products derived
Zaitsev 10:41552d038a69 23 * from this software without specific prior written permission.
Zaitsev 10:41552d038a69 24 *
Zaitsev 10:41552d038a69 25 * 4. This software may only be redistributed and used in connection with an
Zaitsev 10:41552d038a69 26 * Atmel microcontroller product.
Zaitsev 10:41552d038a69 27 *
Zaitsev 10:41552d038a69 28 * THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR IMPLIED
Zaitsev 10:41552d038a69 29 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
Zaitsev 10:41552d038a69 30 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE
Zaitsev 10:41552d038a69 31 * EXPRESSLY AND SPECIFICALLY DISCLAIMED. IN NO EVENT SHALL ATMEL BE LIABLE FOR
Zaitsev 10:41552d038a69 32 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
Zaitsev 10:41552d038a69 33 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
Zaitsev 10:41552d038a69 34 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
Zaitsev 10:41552d038a69 35 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
Zaitsev 10:41552d038a69 36 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
Zaitsev 10:41552d038a69 37 * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
Zaitsev 10:41552d038a69 38 * POSSIBILITY OF SUCH DAMAGE.
Zaitsev 10:41552d038a69 39 *
Zaitsev 10:41552d038a69 40 * \asf_license_stop
Zaitsev 10:41552d038a69 41 *
Zaitsev 10:41552d038a69 42 */
Zaitsev 10:41552d038a69 43 /*
Zaitsev 10:41552d038a69 44 * Support and FAQ: visit <a href="http://www.atmel.com/design-support/">Atmel Support</a>
Zaitsev 10:41552d038a69 45 */
Zaitsev 10:41552d038a69 46 #ifndef SYSTEM_INTERRUPT_H_INCLUDED
Zaitsev 10:41552d038a69 47 #define SYSTEM_INTERRUPT_H_INCLUDED
Zaitsev 10:41552d038a69 48
Zaitsev 10:41552d038a69 49 #ifdef __cplusplus
Zaitsev 10:41552d038a69 50 extern "C" {
Zaitsev 10:41552d038a69 51 #endif
Zaitsev 10:41552d038a69 52
Zaitsev 10:41552d038a69 53 /**
Zaitsev 10:41552d038a69 54 * \defgroup asfdoc_sam0_system_interrupt_group SAM System Interrupt Driver (SYSTEM INTERRUPT)
Zaitsev 10:41552d038a69 55 *
Zaitsev 10:41552d038a69 56 * This driver for Atmel&reg; | SMART SAM devices provides an interface for the configuration
Zaitsev 10:41552d038a69 57 * and management of internal software and hardware interrupts/exceptions.
Zaitsev 10:41552d038a69 58 *
Zaitsev 10:41552d038a69 59 * The following peripherals are used by this module:
Zaitsev 10:41552d038a69 60 * - NVIC (Nested Vector Interrupt Controller)
Zaitsev 10:41552d038a69 61 *
Zaitsev 10:41552d038a69 62 * The following devices can use this module:
Zaitsev 10:41552d038a69 63 * - Atmel | SMART SAM D20/D21
Zaitsev 10:41552d038a69 64 * - Atmel | SMART SAM R21
Zaitsev 10:41552d038a69 65 * - Atmel | SMART SAM D10/D11
Zaitsev 10:41552d038a69 66 * - Atmel | SMART SAM L21
Zaitsev 10:41552d038a69 67 * - Atmel | SMART SAM DAx
Zaitsev 10:41552d038a69 68 * - Atmel | SMART SAM C20/C21
Zaitsev 10:41552d038a69 69 *
Zaitsev 10:41552d038a69 70 * The outline of this documentation is as follows:
Zaitsev 10:41552d038a69 71 * - \ref asfdoc_sam0_system_interrupt_prerequisites
Zaitsev 10:41552d038a69 72 * - \ref asfdoc_sam0_system_interrupt_module_overview
Zaitsev 10:41552d038a69 73 * - \ref asfdoc_sam0_system_interrupt_special_considerations
Zaitsev 10:41552d038a69 74 * - \ref asfdoc_sam0_system_interrupt_extra_info
Zaitsev 10:41552d038a69 75 * - \ref asfdoc_sam0_system_interrupt_examples
Zaitsev 10:41552d038a69 76 * - \ref asfdoc_sam0_system_interrupt_api_overview
Zaitsev 10:41552d038a69 77 *
Zaitsev 10:41552d038a69 78 *
Zaitsev 10:41552d038a69 79 * \section asfdoc_sam0_system_interrupt_prerequisites Prerequisites
Zaitsev 10:41552d038a69 80 *
Zaitsev 10:41552d038a69 81 * There are no prerequisites for this module.
Zaitsev 10:41552d038a69 82 *
Zaitsev 10:41552d038a69 83 *
Zaitsev 10:41552d038a69 84 * \section asfdoc_sam0_system_interrupt_module_overview Module Overview
Zaitsev 10:41552d038a69 85 *
Zaitsev 10:41552d038a69 86 * The ARM&reg; Cortex&reg; M0+ core contains an interrupt and exception vector table, which
Zaitsev 10:41552d038a69 87 * can be used to configure the device's interrupt handlers; individual
Zaitsev 10:41552d038a69 88 * interrupts and exceptions can be enabled and disabled, as well as configured
Zaitsev 10:41552d038a69 89 * with a variable priority.
Zaitsev 10:41552d038a69 90 *
Zaitsev 10:41552d038a69 91 * This driver provides a set of wrappers around the core interrupt functions,
Zaitsev 10:41552d038a69 92 * to expose a simple API for the management of global and individual interrupts
Zaitsev 10:41552d038a69 93 * within the device.
Zaitsev 10:41552d038a69 94 *
Zaitsev 10:41552d038a69 95 * \subsection asfdoc_sam0_system_interrupt_module_overview_criticalsec Critical Sections
Zaitsev 10:41552d038a69 96 * In some applications it is important to ensure that no interrupts may be
Zaitsev 10:41552d038a69 97 * executed by the system whilst a critical portion of code is being run; for
Zaitsev 10:41552d038a69 98 * example, a buffer may be copied from one context to another - during which
Zaitsev 10:41552d038a69 99 * interrupts must be disabled to avoid corruption of the source buffer contents
Zaitsev 10:41552d038a69 100 * until the copy has completed. This driver provides a basic API to enter and
Zaitsev 10:41552d038a69 101 * exit nested critical sections, so that global interrupts can be kept disabled
Zaitsev 10:41552d038a69 102 * for as long as necessary to complete a critical application code section.
Zaitsev 10:41552d038a69 103 *
Zaitsev 10:41552d038a69 104 * \subsection asfdoc_sam0_system_interrupt_module_overview_softints Software Interrupts
Zaitsev 10:41552d038a69 105 * For some applications, it may be desirable to raise a module or core
Zaitsev 10:41552d038a69 106 * interrupt via software. For this reason, a set of APIs to set an interrupt or
Zaitsev 10:41552d038a69 107 * exception as pending are provided to the user application.
Zaitsev 10:41552d038a69 108 *
Zaitsev 10:41552d038a69 109 * \section asfdoc_sam0_system_interrupt_special_considerations Special Considerations
Zaitsev 10:41552d038a69 110 *
Zaitsev 10:41552d038a69 111 * Interrupts from peripherals in the SAM devices are on a per-module basis;
Zaitsev 10:41552d038a69 112 * an interrupt raised from any source within a module will cause a single,
Zaitsev 10:41552d038a69 113 * module-common handler to execute. It is the user application or driver's
Zaitsev 10:41552d038a69 114 * responsibility to de-multiplex the module-common interrupt to determine the
Zaitsev 10:41552d038a69 115 * exact interrupt cause.
Zaitsev 10:41552d038a69 116 *
Zaitsev 10:41552d038a69 117 * \section asfdoc_sam0_system_interrupt_extra_info Extra Information
Zaitsev 10:41552d038a69 118 *
Zaitsev 10:41552d038a69 119 * For extra information, see \ref asfdoc_sam0_system_interrupt_extra. This includes:
Zaitsev 10:41552d038a69 120 * - \ref asfdoc_sam0_system_interrupt_extra_acronyms
Zaitsev 10:41552d038a69 121 * - \ref asfdoc_sam0_system_interrupt_extra_dependencies
Zaitsev 10:41552d038a69 122 * - \ref asfdoc_sam0_system_interrupt_extra_errata
Zaitsev 10:41552d038a69 123 * - \ref asfdoc_sam0_system_interrupt_extra_history
Zaitsev 10:41552d038a69 124 *
Zaitsev 10:41552d038a69 125 *
Zaitsev 10:41552d038a69 126 * \section asfdoc_sam0_system_interrupt_examples Examples
Zaitsev 10:41552d038a69 127 *
Zaitsev 10:41552d038a69 128 * For a list of examples related to this driver, see
Zaitsev 10:41552d038a69 129 * \ref asfdoc_sam0_system_interrupt_exqsg.
Zaitsev 10:41552d038a69 130 *
Zaitsev 10:41552d038a69 131 * \section asfdoc_sam0_system_interrupt_api_overview API Overview
Zaitsev 10:41552d038a69 132 * @{
Zaitsev 10:41552d038a69 133 */
Zaitsev 10:41552d038a69 134
Zaitsev 10:41552d038a69 135 #include <compiler.h>
Zaitsev 10:41552d038a69 136 #include <core_cm0plus.h>
Zaitsev 10:41552d038a69 137 #include "system_interrupt_features.h"
Zaitsev 10:41552d038a69 138
Zaitsev 10:41552d038a69 139 /**
Zaitsev 10:41552d038a69 140 * \brief Table of possible system interrupt/exception vector priorities.
Zaitsev 10:41552d038a69 141 *
Zaitsev 10:41552d038a69 142 * Table of all possible interrupt and exception vector priorities within the
Zaitsev 10:41552d038a69 143 * device.
Zaitsev 10:41552d038a69 144 */
Zaitsev 10:41552d038a69 145 enum system_interrupt_priority_level {
Zaitsev 10:41552d038a69 146 /** Priority level 0, the highest possible interrupt priority. */
Zaitsev 10:41552d038a69 147 SYSTEM_INTERRUPT_PRIORITY_LEVEL_0 = 0,
Zaitsev 10:41552d038a69 148 /** Priority level 1. */
Zaitsev 10:41552d038a69 149 SYSTEM_INTERRUPT_PRIORITY_LEVEL_1 = 1,
Zaitsev 10:41552d038a69 150 /** Priority level 2. */
Zaitsev 10:41552d038a69 151 SYSTEM_INTERRUPT_PRIORITY_LEVEL_2 = 2,
Zaitsev 10:41552d038a69 152 /** Priority level 3, the lowest possible interrupt priority. */
Zaitsev 10:41552d038a69 153 SYSTEM_INTERRUPT_PRIORITY_LEVEL_3 = 3,
Zaitsev 10:41552d038a69 154 };
Zaitsev 10:41552d038a69 155
Zaitsev 10:41552d038a69 156 /**
Zaitsev 10:41552d038a69 157 * \name Critical Section Management
Zaitsev 10:41552d038a69 158 * @{
Zaitsev 10:41552d038a69 159 */
Zaitsev 10:41552d038a69 160
Zaitsev 10:41552d038a69 161 /**
Zaitsev 10:41552d038a69 162 * \brief Enters a critical section.
Zaitsev 10:41552d038a69 163 *
Zaitsev 10:41552d038a69 164 * Disables global interrupts. To support nested critical sections, an internal
Zaitsev 10:41552d038a69 165 * count of the critical section nesting will be kept, so that global interrupts
Zaitsev 10:41552d038a69 166 * are only re-enabled upon leaving the outermost nested critical section.
Zaitsev 10:41552d038a69 167 *
Zaitsev 10:41552d038a69 168 */
Zaitsev 10:41552d038a69 169 static inline void system_interrupt_enter_critical_section(void)
Zaitsev 10:41552d038a69 170 {
Zaitsev 10:41552d038a69 171 cpu_irq_enter_critical();
Zaitsev 10:41552d038a69 172 }
Zaitsev 10:41552d038a69 173
Zaitsev 10:41552d038a69 174 /**
Zaitsev 10:41552d038a69 175 * \brief Leaves a critical section.
Zaitsev 10:41552d038a69 176 *
Zaitsev 10:41552d038a69 177 * Enables global interrupts. To support nested critical sections, an internal
Zaitsev 10:41552d038a69 178 * count of the critical section nesting will be kept, so that global interrupts
Zaitsev 10:41552d038a69 179 * are only re-enabled upon leaving the outermost nested critical section.
Zaitsev 10:41552d038a69 180 *
Zaitsev 10:41552d038a69 181 */
Zaitsev 10:41552d038a69 182 static inline void system_interrupt_leave_critical_section(void)
Zaitsev 10:41552d038a69 183 {
Zaitsev 10:41552d038a69 184 cpu_irq_leave_critical();
Zaitsev 10:41552d038a69 185 }
Zaitsev 10:41552d038a69 186
Zaitsev 10:41552d038a69 187 /** @} */
Zaitsev 10:41552d038a69 188
Zaitsev 10:41552d038a69 189 /**
Zaitsev 10:41552d038a69 190 * \name Interrupt Enabling/Disabling
Zaitsev 10:41552d038a69 191 * @{
Zaitsev 10:41552d038a69 192 */
Zaitsev 10:41552d038a69 193
Zaitsev 10:41552d038a69 194 /**
Zaitsev 10:41552d038a69 195 * \brief Check if global interrupts are enabled.
Zaitsev 10:41552d038a69 196 *
Zaitsev 10:41552d038a69 197 * Checks if global interrupts are currently enabled.
Zaitsev 10:41552d038a69 198 *
Zaitsev 10:41552d038a69 199 * \returns A boolean that identifies if the global interrupts are enabled or not.
Zaitsev 10:41552d038a69 200 *
Zaitsev 10:41552d038a69 201 * \retval true Global interrupts are currently enabled
Zaitsev 10:41552d038a69 202 * \retval false Global interrupts are currently disabled
Zaitsev 10:41552d038a69 203 *
Zaitsev 10:41552d038a69 204 */
Zaitsev 10:41552d038a69 205 static inline bool system_interrupt_is_global_enabled(void)
Zaitsev 10:41552d038a69 206 {
Zaitsev 10:41552d038a69 207 return cpu_irq_is_enabled();
Zaitsev 10:41552d038a69 208 }
Zaitsev 10:41552d038a69 209
Zaitsev 10:41552d038a69 210 /**
Zaitsev 10:41552d038a69 211 * \brief Enables global interrupts.
Zaitsev 10:41552d038a69 212 *
Zaitsev 10:41552d038a69 213 * Enables global interrupts in the device to fire any enabled interrupt handlers.
Zaitsev 10:41552d038a69 214 */
Zaitsev 10:41552d038a69 215 static inline void system_interrupt_enable_global(void)
Zaitsev 10:41552d038a69 216 {
Zaitsev 10:41552d038a69 217 cpu_irq_enable();
Zaitsev 10:41552d038a69 218 }
Zaitsev 10:41552d038a69 219
Zaitsev 10:41552d038a69 220 /**
Zaitsev 10:41552d038a69 221 * \brief Disables global interrupts.
Zaitsev 10:41552d038a69 222 *
Zaitsev 10:41552d038a69 223 * Disabled global interrupts in the device, preventing any enabled interrupt
Zaitsev 10:41552d038a69 224 * handlers from executing.
Zaitsev 10:41552d038a69 225 */
Zaitsev 10:41552d038a69 226 static inline void system_interrupt_disable_global(void)
Zaitsev 10:41552d038a69 227 {
Zaitsev 10:41552d038a69 228 cpu_irq_disable();
Zaitsev 10:41552d038a69 229 }
Zaitsev 10:41552d038a69 230
Zaitsev 10:41552d038a69 231 /**
Zaitsev 10:41552d038a69 232 * \brief Checks if an interrupt vector is enabled or not.
Zaitsev 10:41552d038a69 233 *
Zaitsev 10:41552d038a69 234 * Checks if a specific interrupt vector is currently enabled.
Zaitsev 10:41552d038a69 235 *
Zaitsev 10:41552d038a69 236 * \param[in] vector Interrupt vector number to check
Zaitsev 10:41552d038a69 237 *
Zaitsev 10:41552d038a69 238 * \returns A variable identifying if the requested interrupt vector is enabled.
Zaitsev 10:41552d038a69 239 *
Zaitsev 10:41552d038a69 240 * \retval true Specified interrupt vector is currently enabled
Zaitsev 10:41552d038a69 241 * \retval false Specified interrupt vector is currently disabled
Zaitsev 10:41552d038a69 242 *
Zaitsev 10:41552d038a69 243 */
Zaitsev 10:41552d038a69 244 static inline bool system_interrupt_is_enabled(
Zaitsev 10:41552d038a69 245 const enum system_interrupt_vector vector)
Zaitsev 10:41552d038a69 246 {
Zaitsev 10:41552d038a69 247 return (bool)((NVIC->ISER[0] >> (uint32_t)vector) & 0x00000001);
Zaitsev 10:41552d038a69 248 }
Zaitsev 10:41552d038a69 249
Zaitsev 10:41552d038a69 250 /**
Zaitsev 10:41552d038a69 251 * \brief Enable interrupt vector.
Zaitsev 10:41552d038a69 252 *
Zaitsev 10:41552d038a69 253 * Enables execution of the software handler for the requested interrupt vector.
Zaitsev 10:41552d038a69 254 *
Zaitsev 10:41552d038a69 255 * \param[in] vector Interrupt vector to enable
Zaitsev 10:41552d038a69 256 */
Zaitsev 10:41552d038a69 257 static inline void system_interrupt_enable(
Zaitsev 10:41552d038a69 258 const enum system_interrupt_vector vector)
Zaitsev 10:41552d038a69 259 {
Zaitsev 10:41552d038a69 260 NVIC->ISER[0] = (uint32_t)(1 << ((uint32_t)vector & 0x0000001f));
Zaitsev 10:41552d038a69 261 }
Zaitsev 10:41552d038a69 262
Zaitsev 10:41552d038a69 263 /**
Zaitsev 10:41552d038a69 264 * \brief Disable interrupt vector.
Zaitsev 10:41552d038a69 265 *
Zaitsev 10:41552d038a69 266 * Disables execution of the software handler for the requested interrupt vector.
Zaitsev 10:41552d038a69 267 *
Zaitsev 10:41552d038a69 268 * \param[in] vector Interrupt vector to disable
Zaitsev 10:41552d038a69 269 */
Zaitsev 10:41552d038a69 270 static inline void system_interrupt_disable(
Zaitsev 10:41552d038a69 271 const enum system_interrupt_vector vector)
Zaitsev 10:41552d038a69 272 {
Zaitsev 10:41552d038a69 273 NVIC->ICER[0] = (uint32_t)(1 << ((uint32_t)vector & 0x0000001f));
Zaitsev 10:41552d038a69 274 }
Zaitsev 10:41552d038a69 275
Zaitsev 10:41552d038a69 276 /** @} */
Zaitsev 10:41552d038a69 277
Zaitsev 10:41552d038a69 278 /**
Zaitsev 10:41552d038a69 279 * \name Interrupt State Management
Zaitsev 10:41552d038a69 280 * @{
Zaitsev 10:41552d038a69 281 */
Zaitsev 10:41552d038a69 282
Zaitsev 10:41552d038a69 283 /**
Zaitsev 10:41552d038a69 284 * \brief Get active interrupt (if any).
Zaitsev 10:41552d038a69 285 *
Zaitsev 10:41552d038a69 286 * Return the vector number for the current executing software handler, if any.
Zaitsev 10:41552d038a69 287 *
Zaitsev 10:41552d038a69 288 * \return Interrupt number that is currently executing.
Zaitsev 10:41552d038a69 289 */
Zaitsev 10:41552d038a69 290 static inline enum system_interrupt_vector system_interrupt_get_active(void)
Zaitsev 10:41552d038a69 291 {
Zaitsev 10:41552d038a69 292 uint32_t IPSR = __get_IPSR();
Zaitsev 10:41552d038a69 293 /* The IPSR returns the Exception number, which with an offset 16 to IRQ number. */
Zaitsev 10:41552d038a69 294 return (enum system_interrupt_vector)((IPSR & _SYSTEM_INTERRUPT_IPSR_MASK) - 16);
Zaitsev 10:41552d038a69 295 }
Zaitsev 10:41552d038a69 296
Zaitsev 10:41552d038a69 297 bool system_interrupt_is_pending(
Zaitsev 10:41552d038a69 298 const enum system_interrupt_vector vector);
Zaitsev 10:41552d038a69 299
Zaitsev 10:41552d038a69 300 enum status_code system_interrupt_set_pending(
Zaitsev 10:41552d038a69 301 const enum system_interrupt_vector vector);
Zaitsev 10:41552d038a69 302
Zaitsev 10:41552d038a69 303 enum status_code system_interrupt_clear_pending(
Zaitsev 10:41552d038a69 304 const enum system_interrupt_vector vector);
Zaitsev 10:41552d038a69 305
Zaitsev 10:41552d038a69 306 /** @} */
Zaitsev 10:41552d038a69 307
Zaitsev 10:41552d038a69 308 /**
Zaitsev 10:41552d038a69 309 * \name Interrupt Priority Management
Zaitsev 10:41552d038a69 310 * @{
Zaitsev 10:41552d038a69 311 */
Zaitsev 10:41552d038a69 312
Zaitsev 10:41552d038a69 313 enum status_code system_interrupt_set_priority(
Zaitsev 10:41552d038a69 314 const enum system_interrupt_vector vector,
Zaitsev 10:41552d038a69 315 const enum system_interrupt_priority_level priority_level);
Zaitsev 10:41552d038a69 316
Zaitsev 10:41552d038a69 317 enum system_interrupt_priority_level system_interrupt_get_priority(
Zaitsev 10:41552d038a69 318 const enum system_interrupt_vector vector);
Zaitsev 10:41552d038a69 319
Zaitsev 10:41552d038a69 320 /** @} */
Zaitsev 10:41552d038a69 321
Zaitsev 10:41552d038a69 322 /** @} */
Zaitsev 10:41552d038a69 323
Zaitsev 10:41552d038a69 324 /**
Zaitsev 10:41552d038a69 325 * \page asfdoc_sam0_system_interrupt_extra Extra Information for SYSTEM INTERRUPT Driver
Zaitsev 10:41552d038a69 326 *
Zaitsev 10:41552d038a69 327 * \section asfdoc_sam0_system_interrupt_extra_acronyms Acronyms
Zaitsev 10:41552d038a69 328 * The table below presents the acronyms used in this module:
Zaitsev 10:41552d038a69 329 *
Zaitsev 10:41552d038a69 330 * <table>
Zaitsev 10:41552d038a69 331 * <tr>
Zaitsev 10:41552d038a69 332 * <th>Acronym</th>
Zaitsev 10:41552d038a69 333 * <th>Description</th>
Zaitsev 10:41552d038a69 334 * </tr>
Zaitsev 10:41552d038a69 335 * <tr>
Zaitsev 10:41552d038a69 336 * <td>ISR</td>
Zaitsev 10:41552d038a69 337 * <td>Interrupt Service Routine</td>
Zaitsev 10:41552d038a69 338 * </tr>
Zaitsev 10:41552d038a69 339 * <tr>
Zaitsev 10:41552d038a69 340 * <td>NMI</td>
Zaitsev 10:41552d038a69 341 * <td>Non-maskable Interrupt</td>
Zaitsev 10:41552d038a69 342 * </tr>
Zaitsev 10:41552d038a69 343 * <tr>
Zaitsev 10:41552d038a69 344 * <td>SERCOM</td>
Zaitsev 10:41552d038a69 345 * <td>Serial Communication Interface</td>
Zaitsev 10:41552d038a69 346 * </tr>
Zaitsev 10:41552d038a69 347 * </table>
Zaitsev 10:41552d038a69 348 *
Zaitsev 10:41552d038a69 349 *
Zaitsev 10:41552d038a69 350 * \section asfdoc_sam0_system_interrupt_extra_dependencies Dependencies
Zaitsev 10:41552d038a69 351 * This driver has the following dependencies:
Zaitsev 10:41552d038a69 352 *
Zaitsev 10:41552d038a69 353 * - None
Zaitsev 10:41552d038a69 354 *
Zaitsev 10:41552d038a69 355 *
Zaitsev 10:41552d038a69 356 * \section asfdoc_sam0_system_interrupt_extra_errata Errata
Zaitsev 10:41552d038a69 357 * There are no errata related to this driver.
Zaitsev 10:41552d038a69 358 *
Zaitsev 10:41552d038a69 359 *
Zaitsev 10:41552d038a69 360 * \section asfdoc_sam0_system_interrupt_extra_history Module History
Zaitsev 10:41552d038a69 361 * An overview of the module history is presented in the table below, with
Zaitsev 10:41552d038a69 362 * details on the enhancements and fixes made to the module since its first
Zaitsev 10:41552d038a69 363 * release. The current version of this corresponds to the newest version in
Zaitsev 10:41552d038a69 364 * the table.
Zaitsev 10:41552d038a69 365 *
Zaitsev 10:41552d038a69 366 * <table>
Zaitsev 10:41552d038a69 367 * <tr>
Zaitsev 10:41552d038a69 368 * <th>Changelog</th>
Zaitsev 10:41552d038a69 369 * </tr>
Zaitsev 10:41552d038a69 370 * <tr>
Zaitsev 10:41552d038a69 371 * <td>Initial Release</td>
Zaitsev 10:41552d038a69 372 * </tr>
Zaitsev 10:41552d038a69 373 * </table>
Zaitsev 10:41552d038a69 374 */
Zaitsev 10:41552d038a69 375
Zaitsev 10:41552d038a69 376 /**
Zaitsev 10:41552d038a69 377 * \page asfdoc_sam0_system_interrupt_exqsg Examples for SYSTEM INTERRUPT Driver
Zaitsev 10:41552d038a69 378 *
Zaitsev 10:41552d038a69 379 * This is a list of the available Quick Start guides (QSGs) and example
Zaitsev 10:41552d038a69 380 * applications for \ref asfdoc_sam0_system_interrupt_group. QSGs are simple examples with
Zaitsev 10:41552d038a69 381 * step-by-step instructions to configure and use this driver in a selection of
Zaitsev 10:41552d038a69 382 * use cases. Note that QSGs can be compiled as a standalone application or be
Zaitsev 10:41552d038a69 383 * added to the user application.
Zaitsev 10:41552d038a69 384 *
Zaitsev 10:41552d038a69 385 * - \subpage asfdoc_sam0_system_interrupt_critsec_use_case
Zaitsev 10:41552d038a69 386 * - \subpage asfdoc_sam0_system_interrupt_enablemodint_use_case
Zaitsev 10:41552d038a69 387 *
Zaitsev 10:41552d038a69 388 * \page asfdoc_sam0_system_interrupt_document_revision_history Document Revision History
Zaitsev 10:41552d038a69 389 *
Zaitsev 10:41552d038a69 390 * <table>
Zaitsev 10:41552d038a69 391 * <tr>
Zaitsev 10:41552d038a69 392 * <th>Doc. Rev.</td>
Zaitsev 10:41552d038a69 393 * <th>Date</td>
Zaitsev 10:41552d038a69 394 * <th>Comments</td>
Zaitsev 10:41552d038a69 395 * </tr>
Zaitsev 10:41552d038a69 396 * <tr>
Zaitsev 10:41552d038a69 397 * <td>E</td>
Zaitsev 10:41552d038a69 398 * <td>06/2015</td>
Zaitsev 10:41552d038a69 399 * <td>Add support for SAML21, SAMDAx, and SAMC20/C21.</td>
Zaitsev 10:41552d038a69 400 * </tr>
Zaitsev 10:41552d038a69 401 * <tr>
Zaitsev 10:41552d038a69 402 * <td>D</td>
Zaitsev 10:41552d038a69 403 * <td>12/2014</td>
Zaitsev 10:41552d038a69 404 * <td>Add support for SAMR21 and SAMD10/D11.</td>
Zaitsev 10:41552d038a69 405 * </tr>
Zaitsev 10:41552d038a69 406 * <tr>
Zaitsev 10:41552d038a69 407 * <td>C</td>
Zaitsev 10:41552d038a69 408 * <td>01/2014</td>
Zaitsev 10:41552d038a69 409 * <td>Add support for SAMD21.</td>
Zaitsev 10:41552d038a69 410 * </tr>
Zaitsev 10:41552d038a69 411 * <tr>
Zaitsev 10:41552d038a69 412 * <td>B</td>
Zaitsev 10:41552d038a69 413 * <td>06/2013</td>
Zaitsev 10:41552d038a69 414 * <td>Corrected documentation typos.</td>
Zaitsev 10:41552d038a69 415 * </tr>
Zaitsev 10:41552d038a69 416 * <tr>
Zaitsev 10:41552d038a69 417 * <td>A</td>
Zaitsev 10:41552d038a69 418 * <td>06/2013</td>
Zaitsev 10:41552d038a69 419 * <td>Initial release</td>
Zaitsev 10:41552d038a69 420 * </tr>
Zaitsev 10:41552d038a69 421 * </table>
Zaitsev 10:41552d038a69 422 */
Zaitsev 10:41552d038a69 423
Zaitsev 10:41552d038a69 424 #ifdef __cplusplus
Zaitsev 10:41552d038a69 425 }
Zaitsev 10:41552d038a69 426 #endif
Zaitsev 10:41552d038a69 427
Zaitsev 10:41552d038a69 428 #endif // #ifndef SYSTEM_INTERRUPT_H_INCLUDED