summaryrefslogtreecommitdiff
path: root/LICENSES/GPL-2.0.txt
blob: 0a87fbde7c6e2fdcb4b292de6ac5125a4ec9a86f (plain)
1
GPL-2.0-only.txt
>29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109
/* SPDX-License-Identifier: LGPL-2.1-or-later */
/*
 * Copyright (C) 2019, Google Inc.
 *
 * timer.cpp - Generic timer
 */

#include <time.h>

#include <libcamera/camera_manager.h>
#include <libcamera/event_dispatcher.h>
#include <libcamera/timer.h>

#include "log.h"

/**
 * \file timer.h
 * \brief Generic timer
 */

namespace libcamera {

LOG_DEFINE_CATEGORY(Timer)

/**
 * \class Timer
 * \brief Single-shot timer interface
 *
 * The Timer class models a single-shot timer that is started with start() and
 * emits the \ref timeout signal when it times out.
 *
 * Once started the timer will run until it times out. It can be stopped with
 * stop(), and once it times out or is stopped, can be started again with
 * start().
 */

/**
 * \brief Construct a timer
 */
Timer::Timer()
	: interval_(0), deadline_(0)
{
}

/**
 * \brief Start or restart the timer with a timeout of \a msec
 * \param msec The timer duration in milliseconds
 *
 * If the timer is already running it will be stopped and restarted.
 */
void Timer::start(unsigned int msec)
{
	struct timespec tp;
	clock_gettime(CLOCK_MONOTONIC, &tp);

	interval_ = msec;
	deadline_ = tp.tv_sec * 1000000000ULL + tp.tv_nsec + msec * 1000000ULL;

	LOG(Timer, Debug)
		<< "Starting timer " << this << " with interval "
		<< msec << ": deadline " << deadline_;

	CameraManager::instance()->eventDispatcher()->registerTimer(this);
}

/**
 * \brief Stop the timer
 *
 * After this function returns the timer is guaranteed not to emit the
 * \ref timeout signal.
 *
 * If the timer is not running this function performs no operation.
 */
void Timer::stop()
{
	CameraManager::instance()->eventDispatcher()->unregisterTimer(this);

	deadline_ = 0;
}

/**
 * \brief Check if the timer is running
 * \return True if the timer is running, false otherwise
 */
bool Timer::isRunning() const
{
	return deadline_ != 0;
}

/**
 * \fn Timer::interval()
 * \brief Retrieve the timer interval
 * \return The timer interval in milliseconds
 */

/**
 * \fn Timer::deadline()
 * \brief Retrieve the timer deadline
 * \return The timer deadline in nanoseconds
 */

/**
 * \var Timer::timeout
 * \brief Signal emitted when the timer times out
 *
 * The timer pointer is passed as a parameter.
 */

} /* namespace libcamera */