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/extint/extint_callback.c@592:a274ee790e56, 2015-07-17 (annotated)

Committer:
mbed_official
Date:
Fri Jul 17 09:15:10 2015 +0100
Revision:
592:a274ee790e56
Parent:
579:53297373a894 
Synchronized with git revision e7144f83a8d75df80c4877936b6ffe552b0be9e6



Full URL: https://github.com/mbedmicro/mbed/commit/e7144f83a8d75df80c4877936b6ffe552b0be9e6/



More API implementation for SAMR21

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 579:53297373a894 1 #include "extint.h"
mbed_official 579:53297373a894 2 #include "extint_callback.h"
mbed_official 579:53297373a894 3
mbed_official 579:53297373a894 4 /**
mbed_official 579:53297373a894 5 * \internal
mbed_official 579:53297373a894 6 * Internal driver device instance struct, declared in the main module driver.
mbed_official 579:53297373a894 7 */
mbed_official 579:53297373a894 8 extern struct _extint_module _extint_dev;
mbed_official 579:53297373a894 9
mbed_official 579:53297373a894 10 /**
mbed_official 579:53297373a894 11 * \internal
mbed_official 579:53297373a894 12 * This is the number of the channel whose callback is currently running
mbed_official 579:53297373a894 13 */
mbed_official 579:53297373a894 14 uint8_t _current_channel;
mbed_official 579:53297373a894 15
mbed_official 579:53297373a894 16 /**
mbed_official 579:53297373a894 17 * \brief Registers an asynchronous callback function with the driver.
mbed_official 579:53297373a894 18 *
mbed_official 579:53297373a894 19 * Registers an asynchronous callback with the EXTINT driver, fired when a
mbed_official 579:53297373a894 20 * channel detects the configured channel detection criteria
mbed_official 579:53297373a894 21 * (e.g. edge or level). Callbacks are fired once for each detected channel.
mbed_official 579:53297373a894 22 *
mbed_official 579:53297373a894 23 * \note NMI channel callbacks cannot be registered via this function; the
mbed_official 579:53297373a894 24 * device's NMI interrupt should be hooked directly in the user
mbed_official 579:53297373a894 25 * application and the NMI flags manually cleared via
mbed_official 579:53297373a894 26 * \ref extint_nmi_clear_detected().
mbed_official 579:53297373a894 27 *
mbed_official 579:53297373a894 28 * \param[in] callback Pointer to the callback function to register
mbed_official 579:53297373a894 29 * \param[in] channel Logical channel to register callback for
mbed_official 579:53297373a894 30 * \param[in] type Type of callback function to register
mbed_official 579:53297373a894 31 *
mbed_official 579:53297373a894 32 * \return Status of the registration operation.
mbed_official 579:53297373a894 33 * \retval STATUS_OK The callback was registered successfully
mbed_official 579:53297373a894 34 * \retval STATUS_ERR_INVALID_ARG If an invalid callback type was supplied
mbed_official 579:53297373a894 35 * \retval STATUS_ERR_ALREADY_INITIALIZED Callback function has been
mbed_official 579:53297373a894 36 * registered, need unregister first
mbed_official 579:53297373a894 37 */
mbed_official 579:53297373a894 38 enum status_code extint_register_callback(
mbed_official 579:53297373a894 39 const extint_callback_t callback,
mbed_official 579:53297373a894 40 const uint8_t channel,
mbed_official 579:53297373a894 41 const enum extint_callback_type type)
mbed_official 579:53297373a894 42 {
mbed_official 579:53297373a894 43 /* Sanity check arguments */
mbed_official 579:53297373a894 44 Assert(callback);
mbed_official 579:53297373a894 45
mbed_official 579:53297373a894 46 if (type != EXTINT_CALLBACK_TYPE_DETECT) {
mbed_official 579:53297373a894 47 Assert(false);
mbed_official 579:53297373a894 48 return STATUS_ERR_INVALID_ARG;
mbed_official 579:53297373a894 49 }
mbed_official 579:53297373a894 50
mbed_official 579:53297373a894 51 if (_extint_dev.callbacks[channel] == NULL) {
mbed_official 579:53297373a894 52 _extint_dev.callbacks[channel] = callback;
mbed_official 579:53297373a894 53 return STATUS_OK;
mbed_official 579:53297373a894 54 } else if (_extint_dev.callbacks[channel] == callback) {
mbed_official 579:53297373a894 55 return STATUS_OK;
mbed_official 579:53297373a894 56 }
mbed_official 579:53297373a894 57
mbed_official 579:53297373a894 58 return STATUS_ERR_ALREADY_INITIALIZED;
mbed_official 579:53297373a894 59 }
mbed_official 579:53297373a894 60
mbed_official 579:53297373a894 61 /**
mbed_official 579:53297373a894 62 * \brief Unregisters an asynchronous callback function with the driver.
mbed_official 579:53297373a894 63 *
mbed_official 579:53297373a894 64 * Unregisters an asynchronous callback with the EXTINT driver, removing it
mbed_official 579:53297373a894 65 * from the internal callback registration table.
mbed_official 579:53297373a894 66 *
mbed_official 579:53297373a894 67 * \param[in] callback Pointer to the callback function to unregister
mbed_official 579:53297373a894 68 * \param[in] channel Logical channel to unregister callback for
mbed_official 579:53297373a894 69 * \param[in] type Type of callback function to unregister
mbed_official 579:53297373a894 70 *
mbed_official 579:53297373a894 71 * \return Status of the de-registration operation.
mbed_official 579:53297373a894 72 * \retval STATUS_OK The callback was Unregistered successfully
mbed_official 579:53297373a894 73 * \retval STATUS_ERR_INVALID_ARG If an invalid callback type was supplied
mbed_official 579:53297373a894 74 * \retval STATUS_ERR_BAD_ADDRESS No matching entry was found in the
mbed_official 579:53297373a894 75 * registration table
mbed_official 579:53297373a894 76 */
mbed_official 579:53297373a894 77 enum status_code extint_unregister_callback(
mbed_official 579:53297373a894 78 const extint_callback_t callback,
mbed_official 579:53297373a894 79 const uint8_t channel,
mbed_official 579:53297373a894 80 const enum extint_callback_type type)
mbed_official 579:53297373a894 81 {
mbed_official 579:53297373a894 82 /* Sanity check arguments */
mbed_official 579:53297373a894 83 Assert(callback);
mbed_official 579:53297373a894 84
mbed_official 579:53297373a894 85 if (type != EXTINT_CALLBACK_TYPE_DETECT) {
mbed_official 579:53297373a894 86 Assert(false);
mbed_official 579:53297373a894 87 return STATUS_ERR_INVALID_ARG;
mbed_official 579:53297373a894 88 }
mbed_official 579:53297373a894 89
mbed_official 579:53297373a894 90 if (_extint_dev.callbacks[channel] == callback) {
mbed_official 579:53297373a894 91 _extint_dev.callbacks[channel] = NULL;
mbed_official 579:53297373a894 92 return STATUS_OK;
mbed_official 579:53297373a894 93 }
mbed_official 579:53297373a894 94
mbed_official 579:53297373a894 95 return STATUS_ERR_BAD_ADDRESS;
mbed_official 579:53297373a894 96 }
mbed_official 579:53297373a894 97
mbed_official 579:53297373a894 98 /**
mbed_official 579:53297373a894 99 * \brief Enables asynchronous callback generation for a given channel and type.
mbed_official 579:53297373a894 100 *
mbed_official 579:53297373a894 101 * Enables asynchronous callbacks for a given logical external interrupt channel
mbed_official 579:53297373a894 102 * and type. This must be called before an external interrupt channel will
mbed_official 579:53297373a894 103 * generate callback events.
mbed_official 579:53297373a894 104 *
mbed_official 579:53297373a894 105 * \param[in] channel Logical channel to enable callback generation for
mbed_official 579:53297373a894 106 * \param[in] type Type of callback function callbacks to enable
mbed_official 579:53297373a894 107 *
mbed_official 579:53297373a894 108 * \return Status of the callback enable operation.
mbed_official 579:53297373a894 109 * \retval STATUS_OK The callback was enabled successfully
mbed_official 579:53297373a894 110 * \retval STATUS_ERR_INVALID_ARG If an invalid callback type was supplied
mbed_official 579:53297373a894 111 */
mbed_official 579:53297373a894 112 enum status_code extint_chan_enable_callback(
mbed_official 579:53297373a894 113 const uint8_t channel,
mbed_official 579:53297373a894 114 const enum extint_callback_type type)
mbed_official 579:53297373a894 115 {
mbed_official 579:53297373a894 116 if (type == EXTINT_CALLBACK_TYPE_DETECT) {
mbed_official 579:53297373a894 117 Eic *const eic = _extint_get_eic_from_channel(channel);
mbed_official 579:53297373a894 118
mbed_official 579:53297373a894 119 eic->INTENSET.reg = (1UL << channel);
mbed_official 579:53297373a894 120 } else {
mbed_official 579:53297373a894 121 Assert(false);
mbed_official 579:53297373a894 122 return STATUS_ERR_INVALID_ARG;
mbed_official 579:53297373a894 123 }
mbed_official 579:53297373a894 124
mbed_official 579:53297373a894 125 return STATUS_OK;
mbed_official 579:53297373a894 126 }
mbed_official 579:53297373a894 127
mbed_official 579:53297373a894 128 /**
mbed_official 579:53297373a894 129 * \brief Disables asynchronous callback generation for a given channel and type.
mbed_official 579:53297373a894 130 *
mbed_official 579:53297373a894 131 * Disables asynchronous callbacks for a given logical external interrupt
mbed_official 579:53297373a894 132 * channel and type.
mbed_official 579:53297373a894 133 *
mbed_official 579:53297373a894 134 * \param[in] channel Logical channel to disable callback generation for
mbed_official 579:53297373a894 135 * \param[in] type Type of callback function callbacks to disable
mbed_official 579:53297373a894 136 *
mbed_official 579:53297373a894 137 * \return Status of the callback disable operation.
mbed_official 579:53297373a894 138 * \retval STATUS_OK The callback was disabled successfully
mbed_official 579:53297373a894 139 * \retval STATUS_ERR_INVALID_ARG If an invalid callback type was supplied
mbed_official 579:53297373a894 140 */
mbed_official 579:53297373a894 141 enum status_code extint_chan_disable_callback(
mbed_official 579:53297373a894 142 const uint8_t channel,
mbed_official 579:53297373a894 143 const enum extint_callback_type type)
mbed_official 579:53297373a894 144 {
mbed_official 579:53297373a894 145 if (type == EXTINT_CALLBACK_TYPE_DETECT) {
mbed_official 579:53297373a894 146 Eic *const eic = _extint_get_eic_from_channel(channel);
mbed_official 579:53297373a894 147
mbed_official 579:53297373a894 148 eic->INTENCLR.reg = (1UL << channel);
mbed_official 579:53297373a894 149 } else {
mbed_official 579:53297373a894 150 Assert(false);
mbed_official 579:53297373a894 151 return STATUS_ERR_INVALID_ARG;
mbed_official 579:53297373a894 152 }
mbed_official 579:53297373a894 153
mbed_official 579:53297373a894 154 return STATUS_OK;
mbed_official 579:53297373a894 155 }
mbed_official 579:53297373a894 156
mbed_official 579:53297373a894 157 /**
mbed_official 579:53297373a894 158 * \brief Find what channel caused the callback.
mbed_official 579:53297373a894 159 *
mbed_official 579:53297373a894 160 * Can be used in an EXTINT callback function to find what channel caused
mbed_official 579:53297373a894 161 * the callback in case same callback is used by multiple channels.
mbed_official 579:53297373a894 162 *
mbed_official 579:53297373a894 163 * \return Channel number.
mbed_official 579:53297373a894 164 */
mbed_official 579:53297373a894 165 uint8_t extint_get_current_channel(void)
mbed_official 579:53297373a894 166 {
mbed_official 579:53297373a894 167 return _current_channel;
mbed_official 579:53297373a894 168 }
mbed_official 579:53297373a894 169
mbed_official 579:53297373a894 170 /** Handler for the EXTINT hardware module interrupt. */
mbed_official 579:53297373a894 171 void EIC_Handler(void)
mbed_official 579:53297373a894 172 {
mbed_official 579:53297373a894 173 /* Find any triggered channels, run associated callback handlers */
mbed_official 579:53297373a894 174 for (_current_channel = 0; _current_channel < EIC_NUMBER_OF_INTERRUPTS ; _current_channel++) {
mbed_official 579:53297373a894 175 if (extint_chan_is_detected(_current_channel)) {
mbed_official 579:53297373a894 176 /* Clear flag */
mbed_official 579:53297373a894 177 extint_chan_clear_detected(_current_channel);
mbed_official 579:53297373a894 178 /* Find any associated callback entries in the callback table */
mbed_official 579:53297373a894 179 if (_extint_dev.callbacks[_current_channel] != NULL) {
mbed_official 579:53297373a894 180 /* Run the registered callback */
mbed_official 579:53297373a894 181 _extint_dev.callbacks[_current_channel]();
mbed_official 579:53297373a894 182 }
mbed_official 579:53297373a894 183 }
mbed_official 579:53297373a894 184 }
mbed_official 579:53297373a894 185 }