lzbp li / mbed-src

mbed library sources

Fork of mbed-src by mbed official

targets/hal/TARGET_Atmel/common/utils/interrupt.h@579:53297373a894, 2015-07-01 (annotated)

Committer:
mbed_official
Date:
Wed Jul 01 09:45:11 2015 +0100
Revision:
579:53297373a894
Child:
592:a274ee790e56
Synchronized with git revision d5b4d2ab9c47edb4dc5776e7177b0c2263459081



Full URL: https://github.com/mbedmicro/mbed/commit/d5b4d2ab9c47edb4dc5776e7177b0c2263459081/



Initial version of drivers for SAMR21

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 579:53297373a894 1 /**
mbed_official 579:53297373a894 2 * \file
mbed_official 579:53297373a894 3 *
mbed_official 579:53297373a894 4 * \brief Global interrupt management for 8- and 32-bit AVR
mbed_official 579:53297373a894 5 *
mbed_official 579:53297373a894 6 * Copyright (c) 2010-2014 Atmel Corporation. All rights reserved.
mbed_official 579:53297373a894 7 *
mbed_official 579:53297373a894 8 * \asf_license_start
mbed_official 579:53297373a894 9 *
mbed_official 579:53297373a894 10 * \page License
mbed_official 579:53297373a894 11 *
mbed_official 579:53297373a894 12 * Redistribution and use in source and binary forms, with or without
mbed_official 579:53297373a894 13 * modification, are permitted provided that the following conditions are met:
mbed_official 579:53297373a894 14 *
mbed_official 579:53297373a894 15 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 579:53297373a894 16 * this list of conditions and the following disclaimer.
mbed_official 579:53297373a894 17 *
mbed_official 579:53297373a894 18 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 579:53297373a894 19 * this list of conditions and the following disclaimer in the documentation
mbed_official 579:53297373a894 20 * and/or other materials provided with the distribution.
mbed_official 579:53297373a894 21 *
mbed_official 579:53297373a894 22 * 3. The name of Atmel may not be used to endorse or promote products derived
mbed_official 579:53297373a894 23 * from this software without specific prior written permission.
mbed_official 579:53297373a894 24 *
mbed_official 579:53297373a894 25 * 4. This software may only be redistributed and used in connection with an
mbed_official 579:53297373a894 26 * Atmel microcontroller product.
mbed_official 579:53297373a894 27 *
mbed_official 579:53297373a894 28 * THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR IMPLIED
mbed_official 579:53297373a894 29 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
mbed_official 579:53297373a894 30 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE
mbed_official 579:53297373a894 31 * EXPRESSLY AND SPECIFICALLY DISCLAIMED. IN NO EVENT SHALL ATMEL BE LIABLE FOR
mbed_official 579:53297373a894 32 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 579:53297373a894 33 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
mbed_official 579:53297373a894 34 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
mbed_official 579:53297373a894 35 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
mbed_official 579:53297373a894 36 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
mbed_official 579:53297373a894 37 * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
mbed_official 579:53297373a894 38 * POSSIBILITY OF SUCH DAMAGE.
mbed_official 579:53297373a894 39 *
mbed_official 579:53297373a894 40 * \asf_license_stop
mbed_official 579:53297373a894 41 *
mbed_official 579:53297373a894 42 */
mbed_official 579:53297373a894 43 /**
mbed_official 579:53297373a894 44 * Support and FAQ: visit <a href="http://www.atmel.com/design-support/">Atmel Support</a>
mbed_official 579:53297373a894 45 */
mbed_official 579:53297373a894 46 #ifndef UTILS_INTERRUPT_H
mbed_official 579:53297373a894 47 #define UTILS_INTERRUPT_H
mbed_official 579:53297373a894 48
mbed_official 579:53297373a894 49 #include <parts.h>
mbed_official 579:53297373a894 50
mbed_official 579:53297373a894 51 #if XMEGA || MEGA || TINY
mbed_official 579:53297373a894 52 # include "interrupt/interrupt_avr8.h"
mbed_official 579:53297373a894 53 #elif UC3
mbed_official 579:53297373a894 54 # include "interrupt/interrupt_avr32.h"
mbed_official 579:53297373a894 55 #elif SAM
mbed_official 579:53297373a894 56 # include "interrupt/interrupt_sam_nvic.h"
mbed_official 579:53297373a894 57 #else
mbed_official 579:53297373a894 58 # error Unsupported device.
mbed_official 579:53297373a894 59 #endif
mbed_official 579:53297373a894 60
mbed_official 579:53297373a894 61 /**
mbed_official 579:53297373a894 62 * \defgroup interrupt_group Global interrupt management
mbed_official 579:53297373a894 63 *
mbed_official 579:53297373a894 64 * This is a driver for global enabling and disabling of interrupts.
mbed_official 579:53297373a894 65 *
mbed_official 579:53297373a894 66 * @{
mbed_official 579:53297373a894 67 */
mbed_official 579:53297373a894 68
mbed_official 579:53297373a894 69 #if defined(__DOXYGEN__)
mbed_official 579:53297373a894 70 /**
mbed_official 579:53297373a894 71 * \def CONFIG_INTERRUPT_FORCE_INTC
mbed_official 579:53297373a894 72 * \brief Force usage of the ASF INTC driver
mbed_official 579:53297373a894 73 *
mbed_official 579:53297373a894 74 * Predefine this symbol when preprocessing to force the use of the ASF INTC driver.
mbed_official 579:53297373a894 75 * This is useful to ensure compatibility across compilers and shall be used only when required
mbed_official 579:53297373a894 76 * by the application needs.
mbed_official 579:53297373a894 77 */
mbed_official 579:53297373a894 78 # define CONFIG_INTERRUPT_FORCE_INTC
mbed_official 579:53297373a894 79 #endif
mbed_official 579:53297373a894 80
mbed_official 579:53297373a894 81 //! \name Global interrupt flags
mbed_official 579:53297373a894 82 //@{
mbed_official 579:53297373a894 83 /**
mbed_official 579:53297373a894 84 * \typedef irqflags_t
mbed_official 579:53297373a894 85 * \brief Type used for holding state of interrupt flag
mbed_official 579:53297373a894 86 */
mbed_official 579:53297373a894 87
mbed_official 579:53297373a894 88 /**
mbed_official 579:53297373a894 89 * \def cpu_irq_enable
mbed_official 579:53297373a894 90 * \brief Enable interrupts globally
mbed_official 579:53297373a894 91 */
mbed_official 579:53297373a894 92
mbed_official 579:53297373a894 93 /**
mbed_official 579:53297373a894 94 * \def cpu_irq_disable
mbed_official 579:53297373a894 95 * \brief Disable interrupts globally
mbed_official 579:53297373a894 96 */
mbed_official 579:53297373a894 97
mbed_official 579:53297373a894 98 /**
mbed_official 579:53297373a894 99 * \fn irqflags_t cpu_irq_save(void)
mbed_official 579:53297373a894 100 * \brief Get and clear the global interrupt flags
mbed_official 579:53297373a894 101 *
mbed_official 579:53297373a894 102 * Use in conjunction with \ref cpu_irq_restore.
mbed_official 579:53297373a894 103 *
mbed_official 579:53297373a894 104 * \return Current state of interrupt flags.
mbed_official 579:53297373a894 105 *
mbed_official 579:53297373a894 106 * \note This function leaves interrupts disabled.
mbed_official 579:53297373a894 107 */
mbed_official 579:53297373a894 108
mbed_official 579:53297373a894 109 /**
mbed_official 579:53297373a894 110 * \fn void cpu_irq_restore(irqflags_t flags)
mbed_official 579:53297373a894 111 * \brief Restore global interrupt flags
mbed_official 579:53297373a894 112 *
mbed_official 579:53297373a894 113 * Use in conjunction with \ref cpu_irq_save.
mbed_official 579:53297373a894 114 *
mbed_official 579:53297373a894 115 * \param flags State to set interrupt flag to.
mbed_official 579:53297373a894 116 */
mbed_official 579:53297373a894 117
mbed_official 579:53297373a894 118 /**
mbed_official 579:53297373a894 119 * \fn bool cpu_irq_is_enabled_flags(irqflags_t flags)
mbed_official 579:53297373a894 120 * \brief Check if interrupts are globally enabled in supplied flags
mbed_official 579:53297373a894 121 *
mbed_official 579:53297373a894 122 * \param flags Currents state of interrupt flags.
mbed_official 579:53297373a894 123 *
mbed_official 579:53297373a894 124 * \return True if interrupts are enabled.
mbed_official 579:53297373a894 125 */
mbed_official 579:53297373a894 126
mbed_official 579:53297373a894 127 /**
mbed_official 579:53297373a894 128 * \def cpu_irq_is_enabled
mbed_official 579:53297373a894 129 * \brief Check if interrupts are globally enabled
mbed_official 579:53297373a894 130 *
mbed_official 579:53297373a894 131 * \return True if interrupts are enabled.
mbed_official 579:53297373a894 132 */
mbed_official 579:53297373a894 133 //@}
mbed_official 579:53297373a894 134
mbed_official 579:53297373a894 135 //! @}
mbed_official 579:53297373a894 136
mbed_official 579:53297373a894 137 /**
mbed_official 579:53297373a894 138 * \ingroup interrupt_group
mbed_official 579:53297373a894 139 * \defgroup interrupt_deprecated_group Deprecated interrupt definitions
mbed_official 579:53297373a894 140 */
mbed_official 579:53297373a894 141
mbed_official 579:53297373a894 142 #endif /* UTILS_INTERRUPT_H */