zhang boie / mbed-dev-f30333

drivers/InterruptManager.cpp@0:bdf663c61a82, 2022-06-14 (annotated)

Committer:
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4
Date:
Tue Jun 14 09:21:18 2022 +0000
Revision:
0:bdf663c61a82
lib

Who changed what in which revision?

UserRevisionLine numberNew contents of line
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 1 /* mbed Microcontroller Library
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 2 * Copyright (c) 2006-2013 ARM Limited
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 3 *
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 4 * Licensed under the Apache License, Version 2.0 (the "License");
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 5 * you may not use this file except in compliance with the License.
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 6 * You may obtain a copy of the License at
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 7 *
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 8 * http://www.apache.org/licenses/LICENSE-2.0
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 9 *
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 10 * Unless required by applicable law or agreed to in writing, software
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 11 * distributed under the License is distributed on an "AS IS" BASIS,
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 13 * See the License for the specific language governing permissions and
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 14 * limitations under the License.
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 15 */
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 16 #include "cmsis.h"
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 17 #if defined(NVIC_NUM_VECTORS)
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 18
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 19 #include "drivers/InterruptManager.h"
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 20 #include "platform/mbed_critical.h"
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 21 #include <string.h>
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 22
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 23 #define CHAIN_INITIAL_SIZE 4
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 24
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 25 namespace mbed {
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 26
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 27 typedef void (*pvoidf)(void);
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 28
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 29 InterruptManager* InterruptManager::_instance = (InterruptManager*)NULL;
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 30
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 31 InterruptManager* InterruptManager::get() {
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 32
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 33 if (NULL == _instance) {
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 34 InterruptManager* temp = new InterruptManager();
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 35
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 36 // Atomically set _instance
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 37 core_util_critical_section_enter();
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 38 if (NULL == _instance) {
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 39 _instance = temp;
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 40 }
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 41 core_util_critical_section_exit();
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 42
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 43 // Another thread got there first so delete ours
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 44 if (temp != _instance) {
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 45 delete temp;
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 46 }
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 47
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 48 }
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 49 return _instance;
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 50 }
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 51
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 52 InterruptManager::InterruptManager() {
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 53 // No mutex needed in constructor
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 54 memset(_chains, 0, NVIC_NUM_VECTORS * sizeof(CallChain*));
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 55 }
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 56
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 57 void InterruptManager::destroy() {
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 58 // Not a good idea to call this unless NO interrupt at all
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 59 // is under the control of the handler; otherwise, a system crash
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 60 // is very likely to occur
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 61 if (NULL != _instance) {
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 62 delete _instance;
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 63 _instance = (InterruptManager*)NULL;
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 64 }
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 65 }
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 66
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 67 InterruptManager::~InterruptManager() {
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 68 for(int i = 0; i < NVIC_NUM_VECTORS; i++)
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 69 if (NULL != _chains[i])
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 70 delete _chains[i];
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 71 }
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 72
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 73 bool InterruptManager::must_replace_vector(IRQn_Type irq) {
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 74 lock();
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 75
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 76 int ret = false;
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 77 int irq_pos = get_irq_index(irq);
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 78 if (NULL == _chains[irq_pos]) {
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 79 _chains[irq_pos] = new CallChain(CHAIN_INITIAL_SIZE);
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 80 _chains[irq_pos]->add((pvoidf)NVIC_GetVector(irq));
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 81 ret = true;
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 82 }
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 83 unlock();
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 84 return ret;
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 85 }
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 86
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 87 pFunctionPointer_t InterruptManager::add_common(void (*function)(void), IRQn_Type irq, bool front) {
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 88 lock();
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 89 int irq_pos = get_irq_index(irq);
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 90 bool change = must_replace_vector(irq);
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 91
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 92 pFunctionPointer_t pf = front ? _chains[irq_pos]->add_front(function) : _chains[irq_pos]->add(function);
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 93 if (change)
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 94 NVIC_SetVector(irq, (uint32_t)&InterruptManager::static_irq_helper);
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 95 unlock();
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 96 return pf;
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 97 }
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 98
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 99 bool InterruptManager::remove_handler(pFunctionPointer_t handler, IRQn_Type irq) {
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 100 int irq_pos = get_irq_index(irq);
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 101 bool ret = false;
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 102
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 103 lock();
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 104 if (_chains[irq_pos] != NULL) {
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 105 if (_chains[irq_pos]->remove(handler)) {
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 106 ret = true;
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 107 }
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 108 }
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 109 unlock();
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 110
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 111 return ret;
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 112 }
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 113
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 114 void InterruptManager::irq_helper() {
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 115 _chains[__get_IPSR()]->call();
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 116 }
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 117
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 118 int InterruptManager::get_irq_index(IRQn_Type irq) {
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 119 // Pure function - no lock needed
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 120 return (int)irq + NVIC_USER_IRQ_OFFSET;
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 121 }
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 122
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 123 void InterruptManager::static_irq_helper() {
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 124 InterruptManager::get()->irq_helper();
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 125 }
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 126
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 127 void InterruptManager::lock() {
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 128 _mutex.lock();
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 129 }
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 130
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 131 void InterruptManager::unlock() {
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 132 _mutex.unlock();
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 133 }
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 134
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 135 } // namespace mbed
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 136
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 137 #endif
abe5b02d-a2d4-4fe9-818e-c4e57c809ea4 0:bdf663c61a82 138