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/TARGET_SAM21/drivers/system/interrupt/system_interrupt.c@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 SAM System Interrupt Driver
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 #include "system_interrupt.h"
mbed_official 579:53297373a894 47
mbed_official 579:53297373a894 48 /**
mbed_official 579:53297373a894 49 * \brief Check if a interrupt line is pending.
mbed_official 579:53297373a894 50 *
mbed_official 579:53297373a894 51 * Checks if the requested interrupt vector is pending.
mbed_official 579:53297373a894 52 *
mbed_official 579:53297373a894 53 * \param[in] vector Interrupt vector number to check
mbed_official 579:53297373a894 54 *
mbed_official 579:53297373a894 55 * \returns A boolean identifying if the requested interrupt vector is pending.
mbed_official 579:53297373a894 56 *
mbed_official 579:53297373a894 57 * \retval true Specified interrupt vector is pending
mbed_official 579:53297373a894 58 * \retval false Specified interrupt vector is not pending
mbed_official 579:53297373a894 59 *
mbed_official 579:53297373a894 60 */
mbed_official 579:53297373a894 61 bool system_interrupt_is_pending(
mbed_official 579:53297373a894 62 const enum system_interrupt_vector vector)
mbed_official 579:53297373a894 63 {
mbed_official 579:53297373a894 64 bool result;
mbed_official 579:53297373a894 65
mbed_official 579:53297373a894 66 if (vector >= _SYSTEM_INTERRUPT_EXTERNAL_VECTOR_START) {
mbed_official 579:53297373a894 67 result = ((NVIC->ISPR[0] & (1 << vector)) != 0);
mbed_official 579:53297373a894 68 } else if (vector == SYSTEM_INTERRUPT_SYSTICK) {
mbed_official 579:53297373a894 69 result = ((SCB->ICSR & SCB_ICSR_PENDSTSET_Msk) != 0);
mbed_official 579:53297373a894 70 } else {
mbed_official 579:53297373a894 71 Assert(false);
mbed_official 579:53297373a894 72 result = false;
mbed_official 579:53297373a894 73 }
mbed_official 579:53297373a894 74
mbed_official 579:53297373a894 75 return result;
mbed_official 579:53297373a894 76 }
mbed_official 579:53297373a894 77
mbed_official 579:53297373a894 78 /**
mbed_official 579:53297373a894 79 * \brief Set a interrupt vector as pending.
mbed_official 579:53297373a894 80 *
mbed_official 579:53297373a894 81 * Set the requested interrupt vector as pending (i.e issues a software
mbed_official 579:53297373a894 82 * interrupt request for the specified vector). The software handler will be
mbed_official 579:53297373a894 83 * handled (if enabled) in a priority order based on vector number and
mbed_official 579:53297373a894 84 * configured priority settings.
mbed_official 579:53297373a894 85 *
mbed_official 579:53297373a894 86 * \param[in] vector Interrupt vector number which is set as pending
mbed_official 579:53297373a894 87 *
mbed_official 579:53297373a894 88 * \returns Status code identifying if the vector was successfully set as
mbed_official 579:53297373a894 89 * pending.
mbed_official 579:53297373a894 90 *
mbed_official 579:53297373a894 91 * \retval STATUS_OK If no error was detected
mbed_official 579:53297373a894 92 * \retval STATUS_INVALID_ARG If an unsupported interrupt vector number was given
mbed_official 579:53297373a894 93 */
mbed_official 579:53297373a894 94 enum status_code system_interrupt_set_pending(
mbed_official 579:53297373a894 95 const enum system_interrupt_vector vector)
mbed_official 579:53297373a894 96 {
mbed_official 579:53297373a894 97 enum status_code status = STATUS_OK;
mbed_official 579:53297373a894 98
mbed_official 579:53297373a894 99 if (vector >= _SYSTEM_INTERRUPT_EXTERNAL_VECTOR_START) {
mbed_official 579:53297373a894 100 NVIC->ISPR[0] = (1 << vector);
mbed_official 579:53297373a894 101 } else if (vector == SYSTEM_INTERRUPT_NON_MASKABLE) {
mbed_official 579:53297373a894 102 /* Note: Because NMI has highest priority it will be executed
mbed_official 579:53297373a894 103 * immediately after it has been set pending */
mbed_official 579:53297373a894 104 SCB->ICSR = SCB_ICSR_NMIPENDSET_Msk;
mbed_official 579:53297373a894 105 } else if (vector == SYSTEM_INTERRUPT_SYSTICK) {
mbed_official 579:53297373a894 106 SCB->ICSR = SCB_ICSR_PENDSTSET_Msk;
mbed_official 579:53297373a894 107 } else {
mbed_official 579:53297373a894 108 /* The user want to set something unsupported as pending */
mbed_official 579:53297373a894 109 Assert(false);
mbed_official 579:53297373a894 110 status = STATUS_ERR_INVALID_ARG;
mbed_official 579:53297373a894 111 }
mbed_official 579:53297373a894 112
mbed_official 579:53297373a894 113 return status;
mbed_official 579:53297373a894 114 }
mbed_official 579:53297373a894 115
mbed_official 579:53297373a894 116 /**
mbed_official 579:53297373a894 117 * \brief Clear pending interrupt vector.
mbed_official 579:53297373a894 118 *
mbed_official 579:53297373a894 119 * Clear a pending interrupt vector, so the software handler is not executed.
mbed_official 579:53297373a894 120 *
mbed_official 579:53297373a894 121 * \param[in] vector Interrupt vector number to clear
mbed_official 579:53297373a894 122 *
mbed_official 579:53297373a894 123 * \returns A status code identifying if the interrupt pending state was
mbed_official 579:53297373a894 124 * successfully cleared.
mbed_official 579:53297373a894 125 *
mbed_official 579:53297373a894 126 * \retval STATUS_OK If no error was detected
mbed_official 579:53297373a894 127 * \retval STATUS_INVALID_ARG If an unsupported interrupt vector number was given
mbed_official 579:53297373a894 128 */
mbed_official 579:53297373a894 129 enum status_code system_interrupt_clear_pending(
mbed_official 579:53297373a894 130 const enum system_interrupt_vector vector)
mbed_official 579:53297373a894 131 {
mbed_official 579:53297373a894 132 enum status_code status = STATUS_OK;
mbed_official 579:53297373a894 133
mbed_official 579:53297373a894 134 if (vector >= _SYSTEM_INTERRUPT_EXTERNAL_VECTOR_START) {
mbed_official 579:53297373a894 135 NVIC->ICPR[0] = (1 << vector);
mbed_official 579:53297373a894 136 } else if (vector == SYSTEM_INTERRUPT_NON_MASKABLE) {
mbed_official 579:53297373a894 137 /* Note: Clearing of NMI pending interrupts does not make sense and is
mbed_official 579:53297373a894 138 * not supported by the device, as it has the highest priority and will
mbed_official 579:53297373a894 139 * always be executed at the moment it is set */
mbed_official 579:53297373a894 140 return STATUS_ERR_INVALID_ARG;
mbed_official 579:53297373a894 141 } else if (vector == SYSTEM_INTERRUPT_SYSTICK) {
mbed_official 579:53297373a894 142 SCB->ICSR = SCB_ICSR_PENDSTCLR_Msk;
mbed_official 579:53297373a894 143 } else {
mbed_official 579:53297373a894 144 Assert(false);
mbed_official 579:53297373a894 145 status = STATUS_ERR_INVALID_ARG;
mbed_official 579:53297373a894 146 }
mbed_official 579:53297373a894 147
mbed_official 579:53297373a894 148 return status;
mbed_official 579:53297373a894 149 }
mbed_official 579:53297373a894 150
mbed_official 579:53297373a894 151 /**
mbed_official 579:53297373a894 152 * \brief Set interrupt vector priority level.
mbed_official 579:53297373a894 153 *
mbed_official 579:53297373a894 154 * Set the priority level of an external interrupt or exception.
mbed_official 579:53297373a894 155 *
mbed_official 579:53297373a894 156 * \param[in] vector Interrupt vector to change
mbed_official 579:53297373a894 157 * \param[in] priority_level New vector priority level to set
mbed_official 579:53297373a894 158 *
mbed_official 579:53297373a894 159 * \returns Status code indicating if the priority level of the interrupt was
mbed_official 579:53297373a894 160 * successfully set.
mbed_official 579:53297373a894 161 *
mbed_official 579:53297373a894 162 * \retval STATUS_OK If no error was detected
mbed_official 579:53297373a894 163 * \retval STATUS_INVALID_ARG If an unsupported interrupt vector number was given
mbed_official 579:53297373a894 164 */
mbed_official 579:53297373a894 165 enum status_code system_interrupt_set_priority(
mbed_official 579:53297373a894 166 const enum system_interrupt_vector vector,
mbed_official 579:53297373a894 167 const enum system_interrupt_priority_level priority_level)
mbed_official 579:53297373a894 168 {
mbed_official 579:53297373a894 169 enum status_code status = STATUS_OK;
mbed_official 579:53297373a894 170
mbed_official 579:53297373a894 171 if (vector >= _SYSTEM_INTERRUPT_EXTERNAL_VECTOR_START) {
mbed_official 579:53297373a894 172 uint8_t register_num = vector / 4;
mbed_official 579:53297373a894 173 uint8_t priority_pos = ((vector % 4) * 8) + (8 - __NVIC_PRIO_BITS);
mbed_official 579:53297373a894 174
mbed_official 579:53297373a894 175 NVIC->IP[register_num] =
mbed_official 579:53297373a894 176 (NVIC->IP[register_num] & ~(0x3 << priority_pos)) |
mbed_official 579:53297373a894 177 (priority_level << priority_pos);
mbed_official 579:53297373a894 178
mbed_official 579:53297373a894 179 } else if (vector == SYSTEM_INTERRUPT_SYSTICK) {
mbed_official 579:53297373a894 180 SCB->SHP[1] = (priority_level << _SYSTEM_INTERRUPT_SYSTICK_PRI_POS);
mbed_official 579:53297373a894 181 } else {
mbed_official 579:53297373a894 182 Assert(false);
mbed_official 579:53297373a894 183 status = STATUS_ERR_INVALID_ARG;
mbed_official 579:53297373a894 184 }
mbed_official 579:53297373a894 185
mbed_official 579:53297373a894 186 return status;
mbed_official 579:53297373a894 187 }
mbed_official 579:53297373a894 188
mbed_official 579:53297373a894 189 /**
mbed_official 579:53297373a894 190 * \brief Get interrupt vector priority level.
mbed_official 579:53297373a894 191 *
mbed_official 579:53297373a894 192 * Retrieves the priority level of the requested external interrupt or exception.
mbed_official 579:53297373a894 193 *
mbed_official 579:53297373a894 194 * \param[in] vector Interrupt vector of which the priority level will be read
mbed_official 579:53297373a894 195 *
mbed_official 579:53297373a894 196 * \return Currently configured interrupt priority level of the given interrupt
mbed_official 579:53297373a894 197 * vector.
mbed_official 579:53297373a894 198 */
mbed_official 579:53297373a894 199 enum system_interrupt_priority_level system_interrupt_get_priority(
mbed_official 579:53297373a894 200 const enum system_interrupt_vector vector)
mbed_official 579:53297373a894 201 {
mbed_official 579:53297373a894 202 uint8_t register_num = vector / 4;
mbed_official 579:53297373a894 203 uint8_t priority_pos = ((vector % 4) * 8) + (8 - __NVIC_PRIO_BITS);
mbed_official 579:53297373a894 204
mbed_official 579:53297373a894 205 enum system_interrupt_priority_level priority = SYSTEM_INTERRUPT_PRIORITY_LEVEL_0;
mbed_official 579:53297373a894 206
mbed_official 579:53297373a894 207 if (vector >= 0) {
mbed_official 579:53297373a894 208 priority = (enum system_interrupt_priority_level)
mbed_official 579:53297373a894 209 ((NVIC->IP[register_num] >> priority_pos) & _SYSTEM_INTERRUPT_PRIORITY_MASK);
mbed_official 579:53297373a894 210 } else if (vector == SYSTEM_INTERRUPT_SYSTICK) {
mbed_official 579:53297373a894 211 priority = (enum system_interrupt_priority_level)
mbed_official 579:53297373a894 212 ((SCB->SHP[1] >> _SYSTEM_INTERRUPT_SYSTICK_PRI_POS) & _SYSTEM_INTERRUPT_PRIORITY_MASK);
mbed_official 579:53297373a894 213 }
mbed_official 579:53297373a894 214
mbed_official 579:53297373a894 215 return priority;
mbed_official 579:53297373a894 216 }
mbed_official 579:53297373a894 217