high_resolution_timer.hpp

Go to the documentation of this file.

#pragma once
 
// High-resolution periodic timer for sub-millisecond callbacks.
// Uses platform-specific high-precision timer APIs.
 
#include <atomic>
#include <functional>
#include <memory>
#include <mutex>
#include <thread>
#include <chrono>
 
namespace pulp::runtime {

enum class TimerMode {
    DedicatedThread,
    OsTimerQueue,
};
 
class HighResolutionTimer {
public:
    HighResolutionTimer() = default;
    ~HighResolutionTimer();

    void start(std::chrono::microseconds interval, std::function<void()> callback);

    void start(std::chrono::microseconds interval,
               std::function<void()> callback,
               TimerMode mode);

    void stop();

    bool is_running() const { return running_.load(std::memory_order_relaxed); }

    TimerMode active_mode() const { return active_mode_; }
 
    // No copy or move
    HighResolutionTimer(const HighResolutionTimer&) = delete;
    HighResolutionTimer& operator=(const HighResolutionTimer&) = delete;
 
private:
    struct TimerState;
 
    std::atomic<bool> running_{false};
    std::mutex mutex_;
    std::thread thread_;
    std::shared_ptr<TimerState> state_;
    TimerMode active_mode_ = TimerMode::DedicatedThread;
    void* dispatch_source_ = nullptr; 
};
 
}  // namespace pulp::runtime