RTC auf true
Diff: drivers/InterruptIn.h
- Revision:
- 0:38ceb79fef03
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/drivers/InterruptIn.h Wed Nov 28 15:10:15 2018 +0000 @@ -0,0 +1,181 @@ +/* mbed Microcontroller Library + * Copyright (c) 2006-2013 ARM Limited + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +#ifndef MBED_INTERRUPTIN_H +#define MBED_INTERRUPTIN_H + +#include "platform/platform.h" + +#if defined (DEVICE_INTERRUPTIN) || defined(DOXYGEN_ONLY) + +#include "hal/gpio_api.h" +#include "hal/gpio_irq_api.h" +#include "platform/Callback.h" +#include "platform/mbed_critical.h" +#include "platform/mbed_toolchain.h" +#include "platform/NonCopyable.h" + +namespace mbed { +/** \addtogroup drivers */ + +/** A digital interrupt input, used to call a function on a rising or falling edge + * + * @note Synchronization level: Interrupt safe + * + * Example: + * @code + * // Flash an LED while waiting for events + * + * #include "mbed.h" + * + * InterruptIn event(p16); + * DigitalOut led(LED1); + * + * void trigger() { + * printf("triggered!\n"); + * } + * + * int main() { + * // register trigger() to be called upon the rising edge of event + * event.rise(&trigger); + * while(1) { + * led = !led; + * wait(0.25); + * } + * } + * @endcode + * @ingroup drivers + */ +class InterruptIn : private NonCopyable<InterruptIn> { + +public: + + /** Create an InterruptIn connected to the specified pin + * + * @param pin InterruptIn pin to connect to + */ + InterruptIn(PinName pin); + + /** Create an InterruptIn connected to the specified pin, + * and the pin configured to the specified mode. + * + * @param pin InterruptIn pin to connect to + * @param mode Desired Pin mode configuration. + * (Valid values could be PullNone, PullDown, PullUp and PullDefault. + * See PinNames.h for your target for definitions) + * + */ + InterruptIn(PinName pin, PinMode mode); + + virtual ~InterruptIn(); + + /** Read the input, represented as 0 or 1 (int) + * + * @returns + * An integer representing the state of the input pin, + * 0 for logical 0, 1 for logical 1 + */ + int read(); + + /** An operator shorthand for read() + */ + operator int(); + + + /** Attach a function to call when a rising edge occurs on the input + * + * @param func A pointer to a void function, or 0 to set as none + */ + void rise(Callback<void()> func); + + /** Attach a member function to call when a rising edge occurs on the input + * + * @param obj pointer to the object to call the member function on + * @param method pointer to the member function to be called + * @deprecated + * The rise function does not support cv-qualifiers. Replaced by + * rise(callback(obj, method)). + */ + template<typename T, typename M> + MBED_DEPRECATED_SINCE("mbed-os-5.1", + "The rise function does not support cv-qualifiers. Replaced by " + "rise(callback(obj, method)).") + void rise(T *obj, M method) + { + core_util_critical_section_enter(); + rise(callback(obj, method)); + core_util_critical_section_exit(); + } + + /** Attach a function to call when a falling edge occurs on the input + * + * @param func A pointer to a void function, or 0 to set as none + */ + void fall(Callback<void()> func); + + /** Attach a member function to call when a falling edge occurs on the input + * + * @param obj pointer to the object to call the member function on + * @param method pointer to the member function to be called + * @deprecated + * The rise function does not support cv-qualifiers. Replaced by + * rise(callback(obj, method)). + */ + template<typename T, typename M> + MBED_DEPRECATED_SINCE("mbed-os-5.1", + "The fall function does not support cv-qualifiers. Replaced by " + "fall(callback(obj, method)).") + void fall(T *obj, M method) + { + core_util_critical_section_enter(); + fall(callback(obj, method)); + core_util_critical_section_exit(); + } + + /** Set the input pin mode + * + * @param pull PullUp, PullDown, PullNone, PullDefault + * See PinNames.h for your target for definitions) + */ + void mode(PinMode pull); + + /** Enable IRQ. This method depends on hardware implementation, might enable one + * port interrupts. For further information, check gpio_irq_enable(). + */ + void enable_irq(); + + /** Disable IRQ. This method depends on hardware implementation, might disable one + * port interrupts. For further information, check gpio_irq_disable(). + */ + void disable_irq(); + + static void _irq_handler(uint32_t id, gpio_irq_event event); +#if !defined(DOXYGEN_ONLY) +protected: + gpio_t gpio; + gpio_irq_t gpio_irq; + + Callback<void()> _rise; + Callback<void()> _fall; + + void irq_init(PinName pin); +#endif +}; + +} // namespace mbed + +#endif + +#endif