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.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 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 #include "tc_interrupt.h"
mbed_official 579:53297373a894 48
mbed_official 579:53297373a894 49 void *_tc_instances[TC_INST_NUM];
mbed_official 579:53297373a894 50
mbed_official 579:53297373a894 51 void _tc_interrupt_handler(uint8_t instance);
mbed_official 579:53297373a894 52
mbed_official 579:53297373a894 53 /**
mbed_official 579:53297373a894 54 * \brief Registers a callback.
mbed_official 579:53297373a894 55 *
mbed_official 579:53297373a894 56 * Registers a callback function which is implemented by the user.
mbed_official 579:53297373a894 57 *
mbed_official 579:53297373a894 58 * \note The callback must be enabled by \ref tc_enable_callback,
mbed_official 579:53297373a894 59 * in order for the interrupt handler to call it when the conditions for the
mbed_official 579:53297373a894 60 * callback type is met.
mbed_official 579:53297373a894 61 *
mbed_official 579:53297373a894 62 * \param[in] module Pointer to TC software instance struct
mbed_official 579:53297373a894 63 * \param[in] callback_func Pointer to callback function
mbed_official 579:53297373a894 64 * \param[in] callback_type Callback type given by an enum
mbed_official 579:53297373a894 65 */
mbed_official 579:53297373a894 66 enum status_code tc_register_callback(
mbed_official 579:53297373a894 67 struct tc_module *const module,
mbed_official 579:53297373a894 68 tc_callback_t callback_func,
mbed_official 579:53297373a894 69 const enum tc_callback callback_type)
mbed_official 579:53297373a894 70 {
mbed_official 579:53297373a894 71 /* Sanity check arguments */
mbed_official 579:53297373a894 72 Assert(module);
mbed_official 579:53297373a894 73 Assert(callback_func);
mbed_official 579:53297373a894 74
mbed_official 579:53297373a894 75 /* Register callback function */
mbed_official 579:53297373a894 76 module->callback[callback_type] = callback_func;
mbed_official 579:53297373a894 77
mbed_official 579:53297373a894 78 /* Set the bit corresponding to the callback_type */
mbed_official 579:53297373a894 79 if (callback_type == TC_CALLBACK_CC_CHANNEL0) {
mbed_official 579:53297373a894 80 module->register_callback_mask |= TC_INTFLAG_MC(1);
mbed_official 579:53297373a894 81 } else if (callback_type == TC_CALLBACK_CC_CHANNEL1) {
mbed_official 579:53297373a894 82 module->register_callback_mask |= TC_INTFLAG_MC(2);
mbed_official 579:53297373a894 83 } else {
mbed_official 579:53297373a894 84 module->register_callback_mask |= (1 << callback_type);
mbed_official 579:53297373a894 85 }
mbed_official 579:53297373a894 86 return STATUS_OK;
mbed_official 579:53297373a894 87 }
mbed_official 579:53297373a894 88
mbed_official 579:53297373a894 89 /**
mbed_official 579:53297373a894 90 * \brief Unregisters a callback.
mbed_official 579:53297373a894 91 *
mbed_official 579:53297373a894 92 * Unregisters a callback function implemented by the user. The callback should be
mbed_official 579:53297373a894 93 * disabled before it is unregistered.
mbed_official 579:53297373a894 94 *
mbed_official 579:53297373a894 95 * \param[in] module Pointer to TC software instance struct
mbed_official 579:53297373a894 96 * \param[in] callback_type Callback type given by an enum
mbed_official 579:53297373a894 97 */
mbed_official 579:53297373a894 98 enum status_code tc_unregister_callback(
mbed_official 579:53297373a894 99 struct tc_module *const module,
mbed_official 579:53297373a894 100 const enum tc_callback callback_type)
mbed_official 579:53297373a894 101 {
mbed_official 579:53297373a894 102 /* Sanity check arguments */
mbed_official 579:53297373a894 103 Assert(module);
mbed_official 579:53297373a894 104
mbed_official 579:53297373a894 105 /* Unregister callback function */
mbed_official 579:53297373a894 106 module->callback[callback_type] = NULL;
mbed_official 579:53297373a894 107
mbed_official 579:53297373a894 108 /* Clear the bit corresponding to the callback_type */
mbed_official 579:53297373a894 109 if (callback_type == TC_CALLBACK_CC_CHANNEL0) {
mbed_official 579:53297373a894 110 module->register_callback_mask &= ~TC_INTFLAG_MC(1);
mbed_official 579:53297373a894 111 } else if (callback_type == TC_CALLBACK_CC_CHANNEL1) {
mbed_official 579:53297373a894 112 module->register_callback_mask &= ~TC_INTFLAG_MC(2);
mbed_official 579:53297373a894 113 } else {
mbed_official 579:53297373a894 114 module->register_callback_mask &= ~(1 << callback_type);
mbed_official 579:53297373a894 115 }
mbed_official 579:53297373a894 116 return STATUS_OK;
mbed_official 579:53297373a894 117 }
mbed_official 579:53297373a894 118
mbed_official 579:53297373a894 119 /**
mbed_official 579:53297373a894 120 * \internal ISR handler for TC
mbed_official 579:53297373a894 121 *
mbed_official 579:53297373a894 122 * Auto-generate a set of interrupt handlers for each TC in the device.
mbed_official 579:53297373a894 123 */
mbed_official 579:53297373a894 124 #define _TC_INTERRUPT_HANDLER(n, m) \
mbed_official 579:53297373a894 125 void TC##n##_Handler(void) \
mbed_official 579:53297373a894 126 { \
mbed_official 579:53297373a894 127 _tc_interrupt_handler(m); \
mbed_official 579:53297373a894 128 }
mbed_official 579:53297373a894 129
mbed_official 579:53297373a894 130 #if (SAML21E) || (SAML21G)
mbed_official 579:53297373a894 131 _TC_INTERRUPT_HANDLER(0,0)
mbed_official 579:53297373a894 132 _TC_INTERRUPT_HANDLER(1,1)
mbed_official 579:53297373a894 133 _TC_INTERRUPT_HANDLER(4,2)
mbed_official 579:53297373a894 134 #else
mbed_official 579:53297373a894 135 MRECURSION(TC_INST_NUM, _TC_INTERRUPT_HANDLER, TC_INST_MAX_ID)
mbed_official 579:53297373a894 136 #endif
mbed_official 579:53297373a894 137
mbed_official 579:53297373a894 138
mbed_official 579:53297373a894 139 /**
mbed_official 579:53297373a894 140 * \internal Interrupt Handler for TC module
mbed_official 579:53297373a894 141 *
mbed_official 579:53297373a894 142 * Handles interrupts as they occur, it will run the callback functions
mbed_official 579:53297373a894 143 * that are registered and enabled.
mbed_official 579:53297373a894 144 *
mbed_official 579:53297373a894 145 * \param[in] instance ID of the TC instance calling the interrupt
mbed_official 579:53297373a894 146 * handler.
mbed_official 579:53297373a894 147 */
mbed_official 579:53297373a894 148 void _tc_interrupt_handler(
mbed_official 579:53297373a894 149 uint8_t instance)
mbed_official 579:53297373a894 150 {
mbed_official 579:53297373a894 151 /* Temporary variable */
mbed_official 579:53297373a894 152 uint8_t interrupt_and_callback_status_mask;
mbed_official 579:53297373a894 153
mbed_official 579:53297373a894 154 /* Get device instance from the look-up table */
mbed_official 579:53297373a894 155 struct tc_module *module
mbed_official 579:53297373a894 156 = (struct tc_module *)_tc_instances[instance];
mbed_official 579:53297373a894 157
mbed_official 579:53297373a894 158 /* Read and mask interrupt flag register */
mbed_official 579:53297373a894 159 interrupt_and_callback_status_mask = module->hw->COUNT8.INTFLAG.reg &
mbed_official 579:53297373a894 160 module->register_callback_mask &
mbed_official 579:53297373a894 161 module->enable_callback_mask;
mbed_official 579:53297373a894 162
mbed_official 579:53297373a894 163 /* Check if an Overflow interrupt has occurred */
mbed_official 579:53297373a894 164 if (interrupt_and_callback_status_mask & TC_INTFLAG_OVF) {
mbed_official 579:53297373a894 165 /* Invoke registered and enabled callback function */
mbed_official 579:53297373a894 166 (module->callback[TC_CALLBACK_OVERFLOW])(module);
mbed_official 579:53297373a894 167 /* Clear interrupt flag */
mbed_official 579:53297373a894 168 module->hw->COUNT8.INTFLAG.reg = TC_INTFLAG_OVF;
mbed_official 579:53297373a894 169 }
mbed_official 579:53297373a894 170
mbed_official 579:53297373a894 171 /* Check if an Error interrupt has occurred */
mbed_official 579:53297373a894 172 if (interrupt_and_callback_status_mask & TC_INTFLAG_ERR) {
mbed_official 579:53297373a894 173 /* Invoke registered and enabled callback function */
mbed_official 579:53297373a894 174 (module->callback[TC_CALLBACK_ERROR])(module);
mbed_official 579:53297373a894 175 /* Clear interrupt flag */
mbed_official 579:53297373a894 176 module->hw->COUNT8.INTFLAG.reg = TC_INTFLAG_ERR;
mbed_official 579:53297373a894 177 }
mbed_official 579:53297373a894 178
mbed_official 579:53297373a894 179 /* Check if an Match/Capture Channel 0 interrupt has occurred */
mbed_official 579:53297373a894 180 if (interrupt_and_callback_status_mask & TC_INTFLAG_MC(1)) {
mbed_official 579:53297373a894 181 /* Invoke registered and enabled callback function */
mbed_official 579:53297373a894 182 (module->callback[TC_CALLBACK_CC_CHANNEL0])(module);
mbed_official 579:53297373a894 183 /* Clear interrupt flag */
mbed_official 579:53297373a894 184 module->hw->COUNT8.INTFLAG.reg = TC_INTFLAG_MC(1);
mbed_official 579:53297373a894 185 }
mbed_official 579:53297373a894 186
mbed_official 579:53297373a894 187 /* Check if an Match/Capture Channel 1 interrupt has occurred */
mbed_official 579:53297373a894 188 if (interrupt_and_callback_status_mask & TC_INTFLAG_MC(2)) {
mbed_official 579:53297373a894 189 /* Invoke registered and enabled callback function */
mbed_official 579:53297373a894 190 (module->callback[TC_CALLBACK_CC_CHANNEL1])(module);
mbed_official 579:53297373a894 191 /* Clear interrupt flag */
mbed_official 579:53297373a894 192 module->hw->COUNT8.INTFLAG.reg = TC_INTFLAG_MC(2);
mbed_official 579:53297373a894 193 }
mbed_official 579:53297373a894 194 }