mirror of https://github.com/ARMmbed/mbed-os.git
				
				
				
			
		
			
				
	
	
		
			92 lines
		
	
	
		
			2.4 KiB
		
	
	
	
		
			C++
		
	
	
			
		
		
	
	
			92 lines
		
	
	
		
			2.4 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/NonCopyable.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> {
 | 
						|
public:
 | 
						|
    TimerEvent();
 | 
						|
    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...
 | 
						|
     */
 | 
						|
    virtual ~TimerEvent();
 | 
						|
 | 
						|
#if !defined(DOXYGEN_ONLY)
 | 
						|
protected:
 | 
						|
    // 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
 | 
						|
     */
 | 
						|
    void insert(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(us_timestamp_t timestamp);
 | 
						|
 | 
						|
    /** Remove timestamp.
 | 
						|
     */
 | 
						|
    void remove();
 | 
						|
 | 
						|
    ticker_event_t event;
 | 
						|
 | 
						|
    const ticker_data_t *_ticker_data;
 | 
						|
#endif
 | 
						|
};
 | 
						|
 | 
						|
/** @}*/
 | 
						|
 | 
						|
} // namespace mbed
 | 
						|
 | 
						|
#endif
 |