mbed official / mbed-src

mbed library sources

Dependents:   Encrypted my_mbed lklk CyaSSL_DTLS_Cellular ... more

Superseded

This library was superseded by mbed-dev - https://os.mbed.com/users/mbed_official/code/mbed-dev/.

Development branch of the mbed library sources. This library is kept in synch with the latest changes from the mbed SDK and it is not guaranteed to work.

If you are looking for a stable and tested release, please import one of the official mbed library releases:

Import librarymbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Last commit 20 Feb 2019 by mbed official

targets/hal/TARGET_Atmel/common/utils/interrupt/interrupt_sam_nvic.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 SAM D20, SAM3 and SAM4 (NVIC based)
mbed_official 579:53297373a894 5 *
mbed_official 579:53297373a894 6 * Copyright (c) 2012-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
mbed_official 579:53297373a894 47 #ifndef UTILS_INTERRUPT_INTERRUPT_H
mbed_official 579:53297373a894 48 #define UTILS_INTERRUPT_INTERRUPT_H
mbed_official 579:53297373a894 49
mbed_official 579:53297373a894 50 #include <compiler.h>
mbed_official 579:53297373a894 51 #include <parts.h>
mbed_official 579:53297373a894 52
mbed_official 579:53297373a894 53 #ifdef __cplusplus
mbed_official 579:53297373a894 54 extern "C" {
mbed_official 579:53297373a894 55 #endif
mbed_official 579:53297373a894 56
mbed_official 579:53297373a894 57 /**
mbed_official 579:53297373a894 58 * \weakgroup interrupt_group
mbed_official 579:53297373a894 59 *
mbed_official 579:53297373a894 60 * @{
mbed_official 579:53297373a894 61 */
mbed_official 579:53297373a894 62
mbed_official 579:53297373a894 63 /**
mbed_official 579:53297373a894 64 * \name Interrupt Service Routine definition
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 /**
mbed_official 579:53297373a894 70 * \brief Define service routine
mbed_official 579:53297373a894 71 *
mbed_official 579:53297373a894 72 * \note For NVIC devices the interrupt service routines are predefined to
mbed_official 579:53297373a894 73 * add to vector table in binary generation, so there is no service
mbed_official 579:53297373a894 74 * register at run time. The routine collections are in exceptions.h.
mbed_official 579:53297373a894 75 *
mbed_official 579:53297373a894 76 * Usage:
mbed_official 579:53297373a894 77 * \code
mbed_official 579:53297373a894 78 ISR(foo_irq_handler)
mbed_official 579:53297373a894 79 {
mbed_official 579:53297373a894 80 // Function definition
mbed_official 579:53297373a894 81 ...
mbed_official 579:53297373a894 82 }
mbed_official 579:53297373a894 83 \endcode
mbed_official 579:53297373a894 84 *
mbed_official 579:53297373a894 85 * \param func Name for the function.
mbed_official 579:53297373a894 86 */
mbed_official 579:53297373a894 87 # define ISR(func) \
mbed_official 579:53297373a894 88 void func (void)
mbed_official 579:53297373a894 89
mbed_official 579:53297373a894 90 /**
mbed_official 579:53297373a894 91 * \brief Initialize interrupt vectors
mbed_official 579:53297373a894 92 *
mbed_official 579:53297373a894 93 * For NVIC the interrupt vectors are put in vector table. So nothing
mbed_official 579:53297373a894 94 * to do to initialize them, except defined the vector function with
mbed_official 579:53297373a894 95 * right name.
mbed_official 579:53297373a894 96 *
mbed_official 579:53297373a894 97 * This must be called prior to \ref irq_register_handler.
mbed_official 579:53297373a894 98 */
mbed_official 579:53297373a894 99 # define irq_initialize_vectors() \
mbed_official 579:53297373a894 100 do { \
mbed_official 579:53297373a894 101 } while(0)
mbed_official 579:53297373a894 102
mbed_official 579:53297373a894 103 /**
mbed_official 579:53297373a894 104 * \brief Register handler for interrupt
mbed_official 579:53297373a894 105 *
mbed_official 579:53297373a894 106 * For NVIC the interrupt vectors are put in vector table. So nothing
mbed_official 579:53297373a894 107 * to do to register them, except defined the vector function with
mbed_official 579:53297373a894 108 * right name.
mbed_official 579:53297373a894 109 *
mbed_official 579:53297373a894 110 * Usage:
mbed_official 579:53297373a894 111 * \code
mbed_official 579:53297373a894 112 irq_initialize_vectors();
mbed_official 579:53297373a894 113 irq_register_handler(foo_irq_handler);
mbed_official 579:53297373a894 114 \endcode
mbed_official 579:53297373a894 115 *
mbed_official 579:53297373a894 116 * \note The function \a func must be defined with the \ref ISR macro.
mbed_official 579:53297373a894 117 * \note The functions prototypes can be found in the device exception header
mbed_official 579:53297373a894 118 * files (exceptions.h).
mbed_official 579:53297373a894 119 */
mbed_official 579:53297373a894 120 # define irq_register_handler(int_num, int_prio) \
mbed_official 579:53297373a894 121 NVIC_ClearPendingIRQ( (IRQn_Type)int_num); \
mbed_official 579:53297373a894 122 NVIC_SetPriority( (IRQn_Type)int_num, int_prio); \
mbed_official 579:53297373a894 123 NVIC_EnableIRQ( (IRQn_Type)int_num); \
mbed_official 579:53297373a894 124
mbed_official 579:53297373a894 125 //@}
mbed_official 579:53297373a894 126
mbed_official 579:53297373a894 127 # define cpu_irq_enable() \
mbed_official 579:53297373a894 128 do { \
mbed_official 579:53297373a894 129 g_interrupt_enabled = true; \
mbed_official 579:53297373a894 130 __DMB(); \
mbed_official 579:53297373a894 131 __enable_irq(); \
mbed_official 579:53297373a894 132 } while (0)
mbed_official 579:53297373a894 133 # define cpu_irq_disable() \
mbed_official 579:53297373a894 134 do { \
mbed_official 579:53297373a894 135 __disable_irq(); \
mbed_official 579:53297373a894 136 __DMB(); \
mbed_official 579:53297373a894 137 g_interrupt_enabled = false; \
mbed_official 579:53297373a894 138 } while (0)
mbed_official 579:53297373a894 139
mbed_official 579:53297373a894 140 typedef uint32_t irqflags_t;
mbed_official 579:53297373a894 141
mbed_official 579:53297373a894 142 #if !defined(__DOXYGEN__)
mbed_official 579:53297373a894 143 extern volatile bool g_interrupt_enabled;
mbed_official 579:53297373a894 144 #endif
mbed_official 579:53297373a894 145
mbed_official 579:53297373a894 146 #define cpu_irq_is_enabled() (__get_PRIMASK() == 0)
mbed_official 579:53297373a894 147
mbed_official 579:53297373a894 148 static volatile uint32_t cpu_irq_critical_section_counter;
mbed_official 579:53297373a894 149 static volatile bool cpu_irq_prev_interrupt_state;
mbed_official 579:53297373a894 150
mbed_official 579:53297373a894 151 static inline irqflags_t cpu_irq_save(void)
mbed_official 579:53297373a894 152 {
mbed_official 579:53297373a894 153 irqflags_t flags = cpu_irq_is_enabled();
mbed_official 579:53297373a894 154 cpu_irq_disable();
mbed_official 579:53297373a894 155 return flags;
mbed_official 579:53297373a894 156 }
mbed_official 579:53297373a894 157
mbed_official 579:53297373a894 158 static inline bool cpu_irq_is_enabled_flags(irqflags_t flags)
mbed_official 579:53297373a894 159 {
mbed_official 579:53297373a894 160 return (flags);
mbed_official 579:53297373a894 161 }
mbed_official 579:53297373a894 162
mbed_official 579:53297373a894 163 static inline void cpu_irq_restore(irqflags_t flags)
mbed_official 579:53297373a894 164 {
mbed_official 579:53297373a894 165 if (cpu_irq_is_enabled_flags(flags))
mbed_official 579:53297373a894 166 cpu_irq_enable();
mbed_official 579:53297373a894 167 }
mbed_official 579:53297373a894 168
mbed_official 579:53297373a894 169 void cpu_irq_enter_critical(void);
mbed_official 579:53297373a894 170 void cpu_irq_leave_critical(void);
mbed_official 579:53297373a894 171
mbed_official 579:53297373a894 172 /**
mbed_official 579:53297373a894 173 * \weakgroup interrupt_deprecated_group
mbed_official 579:53297373a894 174 * @{
mbed_official 579:53297373a894 175 */
mbed_official 579:53297373a894 176
mbed_official 579:53297373a894 177 #define Enable_global_interrupt() cpu_irq_enable()
mbed_official 579:53297373a894 178 #define Disable_global_interrupt() cpu_irq_disable()
mbed_official 579:53297373a894 179 #define Is_global_interrupt_enabled() cpu_irq_is_enabled()
mbed_official 579:53297373a894 180
mbed_official 579:53297373a894 181 //@}
mbed_official 579:53297373a894 182
mbed_official 579:53297373a894 183 //@}
mbed_official 579:53297373a894 184
mbed_official 579:53297373a894 185 #ifdef __cplusplus
mbed_official 579:53297373a894 186 }
mbed_official 579:53297373a894 187 #endif
mbed_official 579:53297373a894 188
mbed_official 579:53297373a894 189 #endif /* UTILS_INTERRUPT_INTERRUPT_H */