SimpleTimer.h

Go to the documentation of this file.

/****
 * Sming Framework Project - Open Source framework for high efficiency native ESP8266 development.
 * Created 2015 by Skurydin Alexey
 * http://github.com/SmingHub/Sming
 * All files of the Sming Core are provided under the LGPL v3 license.
 *
 * SimpleTimer.h
 *
 * @author: 13 August 2018 - mikee47 <mike@sillyhouse.net>
 *
 * This class wraps the OS timer functions, in a class called SimpleTimer.
 *
*/
 
#pragma once
 
#include "esp_systemapi.h"
#include "CallbackTimer.h"
#include <Platform/Clocks.h>
#include <driver/os_timer.h>
 
class OsTimerApi : public CallbackTimerApi<OsTimerApi>
{
public:
    using Clock = OsTimerClock;
    using TickType = uint32_t;
    using TimeType = uint32_t;
 
    static constexpr const char* typeName()
    {
        return "OsTimerApi";
    }
 
    static constexpr TickType minTicks()
    {
        // Note: The minimum specified by the SDK is 100us
        return 1;
    }
 
    static constexpr TickType maxTicks()
    {
        return 0x7FFFFFFF;
    }
 
    __forceinline bool isArmed() const
    {
        return os_timer_expire(&osTimer) != 0;
    }
 
    TickType ticks() const
    {
        uint64_t expiry = os_timer_expire(&osTimer);
        if(expiry == 0) {
            return 0;
        }
 
        int remain = expiry - Clock::ticks();
        return (remain > 0) ? remain : 0;
    }
 
    ~OsTimerApi()
    {
        disarm();
        os_timer_done(&osTimer);
    }
 
    __forceinline void IRAM_ATTR setCallback(TimerCallback callback, void* arg)
    {
        os_timer_setfn(&osTimer, callback, arg);
    }
 
    __forceinline void IRAM_ATTR setInterval(TickType interval)
    {
        this->interval = interval;
    }
 
    __forceinline TickType IRAM_ATTR getInterval() const
    {
        return interval;
    }
 
    __forceinline void IRAM_ATTR arm(bool repeating)
    {
        os_timer_arm_ticks(&osTimer, interval, repeating);
    }
 
    __forceinline void IRAM_ATTR disarm()
    {
        if(isArmed()) {
            os_timer_disarm(&osTimer);
        }
    }
 
private:
    os_timer_t osTimer = OS_TIMER_DEFAULT();
    TickType interval = 0;
};
 
using SimpleTimer = CallbackTimer<OsTimerApi>;