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/tc/tc_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 SAM TC - Timer Counter Callback Driver
mbed_official 579:53297373a894 5 *
mbed_official 579:53297373a894 6 * Copyright (C) 2013-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 TC_INTERRUPT_H_INCLUDED
mbed_official 579:53297373a894 48 #define TC_INTERRUPT_H_INCLUDED
mbed_official 579:53297373a894 49
mbed_official 579:53297373a894 50 #include "tc.h"
mbed_official 579:53297373a894 51 #include <system_interrupt.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 #if !defined(__DOXYGEN__)
mbed_official 579:53297373a894 58 extern void *_tc_instances[TC_INST_NUM];
mbed_official 579:53297373a894 59
mbed_official 579:53297373a894 60 # define _TC_INTERRUPT_VECT_NUM(n, unused) \
mbed_official 579:53297373a894 61 SYSTEM_INTERRUPT_MODULE_TC##n,
mbed_official 579:53297373a894 62 /**
mbed_official 579:53297373a894 63 * \internal Get the interrupt vector for the given device instance
mbed_official 579:53297373a894 64 *
mbed_official 579:53297373a894 65 * \param[in] TC module instance number.
mbed_official 579:53297373a894 66 *
mbed_official 579:53297373a894 67 * \return Interrupt vector for of the given TC module instance.
mbed_official 579:53297373a894 68 */
mbed_official 579:53297373a894 69 static enum system_interrupt_vector _tc_interrupt_get_interrupt_vector(
mbed_official 579:53297373a894 70 uint32_t inst_num)
mbed_official 579:53297373a894 71 {
mbed_official 579:53297373a894 72 static uint8_t tc_interrupt_vectors[TC_INST_NUM] = {
mbed_official 579:53297373a894 73 #if (SAML21E) || (SAML21G)
mbed_official 579:53297373a894 74 SYSTEM_INTERRUPT_MODULE_TC0,
mbed_official 579:53297373a894 75 SYSTEM_INTERRUPT_MODULE_TC1,
mbed_official 579:53297373a894 76 SYSTEM_INTERRUPT_MODULE_TC4
mbed_official 579:53297373a894 77 #else
mbed_official 579:53297373a894 78 MRECURSION(TC_INST_NUM, _TC_INTERRUPT_VECT_NUM, TC_INST_MAX_ID)
mbed_official 579:53297373a894 79 #endif
mbed_official 579:53297373a894 80 };
mbed_official 579:53297373a894 81
mbed_official 579:53297373a894 82 return (enum system_interrupt_vector)tc_interrupt_vectors[inst_num];
mbed_official 579:53297373a894 83 }
mbed_official 579:53297373a894 84 #endif /* !defined(__DOXYGEN__) */
mbed_official 579:53297373a894 85
mbed_official 579:53297373a894 86 /**
mbed_official 579:53297373a894 87 * \name Callback Management
mbed_official 579:53297373a894 88 * {@
mbed_official 579:53297373a894 89 */
mbed_official 579:53297373a894 90
mbed_official 579:53297373a894 91 enum status_code tc_register_callback(
mbed_official 579:53297373a894 92 struct tc_module *const module,
mbed_official 579:53297373a894 93 tc_callback_t callback_func,
mbed_official 579:53297373a894 94 const enum tc_callback callback_type);
mbed_official 579:53297373a894 95
mbed_official 579:53297373a894 96 enum status_code tc_unregister_callback(
mbed_official 579:53297373a894 97 struct tc_module *const module,
mbed_official 579:53297373a894 98 const enum tc_callback callback_type);
mbed_official 579:53297373a894 99
mbed_official 579:53297373a894 100 /**
mbed_official 579:53297373a894 101 * \brief Enables callback.
mbed_official 579:53297373a894 102 *
mbed_official 579:53297373a894 103 * Enables the callback function registered by the \ref
mbed_official 579:53297373a894 104 * tc_register_callback. The callback function will be called from the
mbed_official 579:53297373a894 105 * interrupt handler when the conditions for the callback type are
mbed_official 579:53297373a894 106 * met. This function will also enable the appropriate interrupts.
mbed_official 579:53297373a894 107 *
mbed_official 579:53297373a894 108 * \param[in] module Pointer to TC software instance struct
mbed_official 579:53297373a894 109 * \param[in] callback_type Callback type given by an enum
mbed_official 579:53297373a894 110 */
mbed_official 579:53297373a894 111 static inline void tc_enable_callback(
mbed_official 579:53297373a894 112 struct tc_module *const module,
mbed_official 579:53297373a894 113 const enum tc_callback callback_type)
mbed_official 579:53297373a894 114 {
mbed_official 579:53297373a894 115 /* Sanity check arguments */
mbed_official 579:53297373a894 116 Assert(module);
mbed_official 579:53297373a894 117
mbed_official 579:53297373a894 118
mbed_official 579:53297373a894 119 /* Enable interrupts for this TC module */
mbed_official 579:53297373a894 120 system_interrupt_enable(_tc_interrupt_get_interrupt_vector(_tc_get_inst_index(module->hw)));
mbed_official 579:53297373a894 121
mbed_official 579:53297373a894 122 /* Enable callback */
mbed_official 579:53297373a894 123 if (callback_type == TC_CALLBACK_CC_CHANNEL0) {
mbed_official 579:53297373a894 124 module->enable_callback_mask |= TC_INTFLAG_MC(1);
mbed_official 579:53297373a894 125 module->hw->COUNT8.INTENSET.reg = TC_INTFLAG_MC(1);
mbed_official 579:53297373a894 126 } else if (callback_type == TC_CALLBACK_CC_CHANNEL1) {
mbed_official 579:53297373a894 127 module->enable_callback_mask |= TC_INTFLAG_MC(2);
mbed_official 579:53297373a894 128 module->hw->COUNT8.INTENSET.reg = TC_INTFLAG_MC(2);
mbed_official 579:53297373a894 129 } else {
mbed_official 579:53297373a894 130 module->enable_callback_mask |= (1 << callback_type);
mbed_official 579:53297373a894 131 module->hw->COUNT8.INTENSET.reg = (1 << callback_type);
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 * \brief Disables callback.
mbed_official 579:53297373a894 137 *
mbed_official 579:53297373a894 138 * Disables the callback function registered by the \ref
mbed_official 579:53297373a894 139 * tc_register_callback, and the callback will not be called from the
mbed_official 579:53297373a894 140 * interrupt routine. The function will also disable the appropriate
mbed_official 579:53297373a894 141 * interrupts.
mbed_official 579:53297373a894 142 *
mbed_official 579:53297373a894 143 * \param[in] module Pointer to TC software instance struct
mbed_official 579:53297373a894 144 * \param[in] callback_type Callback type given by an enum
mbed_official 579:53297373a894 145 */
mbed_official 579:53297373a894 146 static inline void tc_disable_callback(
mbed_official 579:53297373a894 147 struct tc_module *const module,
mbed_official 579:53297373a894 148 const enum tc_callback callback_type)
mbed_official 579:53297373a894 149 {
mbed_official 579:53297373a894 150 /* Sanity check arguments */
mbed_official 579:53297373a894 151 Assert(module);
mbed_official 579:53297373a894 152
mbed_official 579:53297373a894 153 /* Disable callback */
mbed_official 579:53297373a894 154 if (callback_type == TC_CALLBACK_CC_CHANNEL0) {
mbed_official 579:53297373a894 155 module->hw->COUNT8.INTENCLR.reg = TC_INTFLAG_MC(1);
mbed_official 579:53297373a894 156 module->enable_callback_mask &= ~TC_INTFLAG_MC(1);
mbed_official 579:53297373a894 157 } else if (callback_type == TC_CALLBACK_CC_CHANNEL1) {
mbed_official 579:53297373a894 158 module->hw->COUNT8.INTENCLR.reg = TC_INTFLAG_MC(2);
mbed_official 579:53297373a894 159 module->enable_callback_mask &= ~TC_INTFLAG_MC(2);
mbed_official 579:53297373a894 160 } else {
mbed_official 579:53297373a894 161 module->hw->COUNT8.INTENCLR.reg = (1 << callback_type);
mbed_official 579:53297373a894 162 module->enable_callback_mask &= ~(1 << callback_type);
mbed_official 579:53297373a894 163 }
mbed_official 579:53297373a894 164 }
mbed_official 579:53297373a894 165
mbed_official 579:53297373a894 166 /**
mbed_official 579:53297373a894 167 * @}
mbed_official 579:53297373a894 168 */
mbed_official 579:53297373a894 169
mbed_official 579:53297373a894 170 #ifdef __cplusplus
mbed_official 579:53297373a894 171 }
mbed_official 579:53297373a894 172 #endif
mbed_official 579:53297373a894 173
mbed_official 579:53297373a894 174 #endif /* TC_INTERRUPT_H_INCLUDED */