mirror of https://github.com/ARMmbed/mbed-os.git
122 lines
3.8 KiB
C++
122 lines
3.8 KiB
C++
/* mbed Microcontroller Library
|
|
* Copyright (c) 2006-2019 ARM Limited
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*
|
|
* 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_TIMEREVENT_H
|
|
#define MBED_TIMEREVENT_H
|
|
|
|
#include "hal/ticker_api.h"
|
|
#include "platform/mbed_toolchain.h"
|
|
#include "platform/NonCopyable.h"
|
|
#include "drivers/TickerDataClock.h"
|
|
|
|
namespace mbed {
|
|
|
|
/**
|
|
* \defgroup drivers_TimerEvent TimerEvent class
|
|
* \ingroup drivers-public-api-ticker
|
|
* @{
|
|
*/
|
|
|
|
/** Base abstraction for timer interrupts
|
|
*
|
|
* @note Synchronization level: Interrupt safe
|
|
*/
|
|
class TimerEvent : private NonCopyable<TimerEvent> {
|
|
#if !defined(DOXYGEN_ONLY)
|
|
protected:
|
|
TimerEvent(const ticker_data_t *data);
|
|
|
|
/** The handler registered with the underlying timer interrupt
|
|
*
|
|
* @param id Timer Event ID
|
|
*/
|
|
static void irq(uint32_t id);
|
|
|
|
/** Destruction removes it...
|
|
*/
|
|
~TimerEvent();
|
|
|
|
// The handler called to service the timer event of the derived class
|
|
virtual void handler() = 0;
|
|
|
|
/** Set relative timestamp of the internal event.
|
|
* @param timestamp event's us timestamp
|
|
*
|
|
* @warning
|
|
* Do not insert more than one timestamp.
|
|
* The same @a event object is used for every @a insert/insert_absolute call.
|
|
*
|
|
* @warning
|
|
* Ticker's present timestamp is used for reference. For timestamps
|
|
* from the past the event is scheduled after ticker's overflow.
|
|
* For reference @see convert_timestamp
|
|
*
|
|
* @deprecated use `insert(std::chrono::microseconds timestamp)`
|
|
*/
|
|
MBED_DEPRECATED_SINCE("mbed-os-6.0.0", "Pass a chrono duration, not an integer microsecond count. For example use `5ms` rather than `5000`.")
|
|
void insert(timestamp_t timestamp);
|
|
|
|
/** Set relative timestamp of the internal event.
|
|
* @param timestamp event's us timestamp
|
|
*
|
|
* @warning
|
|
* Do not insert more than one timestamp.
|
|
* The same @a event object is used for every @a insert/insert_absolute call.
|
|
*
|
|
* @warning
|
|
* Ticker's present timestamp is used for reference. For timestamps
|
|
* from the past the event is scheduled after ticker's overflow.
|
|
* For reference @see convert_timestamp
|
|
*/
|
|
void insert(std::chrono::microseconds timestamp);
|
|
|
|
/** Set absolute timestamp of the internal event.
|
|
* @param timestamp event's us timestamp
|
|
*
|
|
* @warning
|
|
* Do not insert more than one timestamp.
|
|
* The same @a event object is used for every @a insert/insert_absolute call.
|
|
*
|
|
* @deprecated use `insert_absolute(TickerDataClock::time_point timestamp)`
|
|
*/
|
|
MBED_DEPRECATED_SINCE("mbed-os-6.0.0", "Pass a chrono time_point, not an integer microsecond count. For example use `_ticker_data.now() + 5ms` rather than `ticker_read_us(_ticker_data) + 5000`.")
|
|
void insert_absolute(us_timestamp_t timestamp);
|
|
|
|
/** Set absolute timestamp of the internal event.
|
|
* @param timestamp event's us timestamp
|
|
*
|
|
* @warning
|
|
* Do not insert more than one timestamp.
|
|
* The same @a event object is used for every @a insert/insert_absolute call.
|
|
*/
|
|
void insert_absolute(TickerDataClock::time_point timestamp);
|
|
|
|
/** Remove timestamp.
|
|
*/
|
|
void remove();
|
|
|
|
ticker_event_t event;
|
|
|
|
TickerDataClock _ticker_data;
|
|
#endif
|
|
};
|
|
|
|
/** @}*/
|
|
|
|
} // namespace mbed
|
|
|
|
#endif
|