src/sdevent/timer.hpp

#pragma once

#include <chrono>
#include <functional>
#include <memory>
#include <systemd/sd-event.h>

#include "sdevent/source.hpp"
#include "sdevent/event.hpp"

// TODO: openbmc/openbmc#1720 - add error handling for sd_event API failures

namespace sdevent
{
namespace event
{
namespace timer
{

/** @class Timer
 *  @brief Provides C++ bindings to the sd_event_source* timer functions.
 */
class Timer
{
  public:
    /* Define all of the basic class operations:
     *     Not allowed:
     *         - Default constructor to avoid nullptrs.
     *         - Copy operations due to internal unique_ptr.
     *     Allowed:
     *         - Move operations.
     *         - Destructor.
     */
    Timer() = delete;
    Timer(const Timer&) = delete;
    Timer& operator=(const Timer&) = delete;
    Timer(Timer&&) = default;
    Timer& operator=(Timer&&) = default;
    ~Timer() = default;

    using Callback = std::function<void(source::Source&)>;

    /** @brief Register a timer callback.
     *
     *  @param[in] event - The event to register on.
     *  @param[in] expires - The initial timer expiration time.
     *  @param[in] callback - The callback method.
     */
    Timer(sdevent::event::Event& event,
          const std::chrono::steady_clock::time_point& expires,
          Callback callback) :
        src(nullptr),
        cb(std::make_unique<Callback>(std::move(callback)))
    {
        using namespace std::chrono;
        auto epoch = expires.time_since_epoch();
        auto time = duration_cast<microseconds>(epoch);
        sd_event_source* source = nullptr;
        sd_event_add_time(event.get(), &source, CLOCK_MONOTONIC, time.count(),
                          0, callCallback, cb.get());
        // **INDENT-OFF**
        src = decltype(src){source, std::false_type()};
        // **INDENT-ON**
    }

    /** @brief Register a disabled timer callback.
     *
     *  @param[in] event - The event to register on.
     *  @param[in] callback - The callback method.
     */
    Timer(sdevent::event::Event& event, Callback callback) :
        src(nullptr), cb(std::make_unique<Callback>(std::move(callback)))
    {
        sd_event_source* source = nullptr;
        sd_event_add_time(event.get(), &source, CLOCK_MONOTONIC, ULLONG_MAX, 0,
                          callCallback, cb.get());
        // **INDENT-OFF**
        src = decltype(src){source, std::false_type()};
        // **INDENT-ON**
    }

    /** @brief Set the timer expiration time. */
    void setTime(const std::chrono::steady_clock::time_point& expires)
    {
        src.setTime(expires);
    }

    /** @brief Get the timer expiration time. */
    auto getTime()
    {
        return src.getTime();
    }

    /** @brief Set the timer source enable state. */
    void enable(int enable)
    {
        src.enable(enable);
    }

    /** @brief Query timer state. */
    auto enabled()
    {
        return src.enabled();
    }

  private:
    source::Source src;
    std::unique_ptr<Callback> cb = nullptr;

    static int callCallback(sd_event_source* s, uint64_t usec, void* context)
    {
        source::Source source(s);
        auto c = static_cast<Callback*>(context);
        (*c)(source);

        return 0;
    }
};
} // namespace timer
} // namespace event
} // namespace sdevent