genode/repos/os/src/test/timer/main.cc

/*
 * \brief  Test for timer service
 * \author Norman Feske
 * \date   2009-06-22
 */

/*
 * Copyright (C) 2009-2013 Genode Labs GmbH
 *
 * This file is part of the Genode OS framework, which is distributed
 * under the terms of the GNU General Public License version 2.
 */

#include <util/list.h>
#include <base/log.h>
#include <base/sleep.h>
#include <base/thread.h>
#include <timer_session/connection.h>

enum { STACK_SIZE = 1024*sizeof(long) };

class Timer_client : public Genode::List<Timer_client>::Element,
                     Timer::Connection, Genode::Thread_deprecated<STACK_SIZE>
{
	private:

		unsigned long _period_msec;
		unsigned long _cnt;
		bool          _stop;

		/**
		 * Thread entry function
		 */
		void entry()
		{
			while (!_stop) {

				/* call timer service to block for a while */
				msleep(_period_msec);
				_cnt++;
			}
		}

	public:

		/**
		 * Constructor
		 */
		Timer_client(unsigned long period_msec)
		: Thread_deprecated("timer_client"),
		  _period_msec(period_msec), _cnt(0), _stop(false) { }

		/**
		 * Start calling the timer service
		 */
		void start()
		{
			Genode::Thread_deprecated<STACK_SIZE>::start();
		}

		/**
		 * Stop calling the timer service
		 */
		void stop() { _stop = true; }

		/**
		 * Return configured period in milliseconds
		 */
		unsigned long period_msec() { return _period_msec; }

		/**
		 * Return the number of performed calls to the timer service
		 */
		unsigned long cnt() { return _cnt; }
};


/**
 * Timer client that continuously reprograms timeouts
 */
struct Timer_stressful_client : Timer::Connection, Genode::Thread_deprecated<STACK_SIZE>
{
	unsigned long us;

	/*
	 * In principle, we could constantly execute 'trigger_once' in a busy loop.
	 * This however would significantly skew the precision of the timer on
	 * platforms w/o priority support. The behaviour would highly depend on the
	 * kernel's scheduling and its parameters such as the time-slice length. To
	 * even out those kernel-specific peculiarities, we let the stressful
	 * client delay its execution after each iteration instead of keeping it
	 * busy all the time. The delay must be smaller than scheduled 'us' to
	 * trigger the edge case of constantly reprogramming timeouts that never
	 * trigger.
	 */
	Timer::Connection delayer;

	void entry() { for (;;) { trigger_once(us); delayer.usleep(us/2); } }

	Timer_stressful_client(unsigned long us)
	:
		Thread_deprecated("timer_stressful_client"), us(us)
	{
		Genode::Thread_deprecated<STACK_SIZE>::start();
	}
};


using namespace Genode;

extern "C" int usleep(unsigned long usec);


int main(int argc, char **argv)
{
	log("--- timer test ---");

	static Genode::List<Timer_client> timer_clients;
	static Timer::Connection main_timer;

	/*
	 * Check long single timeout in the presence of another client that
	 * reprograms timeouts all the time.
	 */
	{
		/* will get destructed at the end of the current scope */
		Timer_stressful_client stressful_client(250*1000);

		log("register two-seconds timeout...");
		main_timer.msleep(2000);
		log("timeout fired");
	}

	/* check periodic timeouts */
	Signal_receiver           sig_rcv;
	Signal_context            sig_cxt;
	Signal_context_capability sig = sig_rcv.manage(&sig_cxt);
	main_timer.sigh(sig);
	enum { PTEST_TIME_US = 2000000 };
	unsigned period_us = 500000, periods = PTEST_TIME_US / period_us, i = 0;
	log("start periodic timeouts");
	for (unsigned j = 0; j < 5; j++) {
		unsigned elapsed_ms = main_timer.elapsed_ms();
		main_timer.trigger_periodic(period_us);
		while (i < periods) {
			Signal s = sig_rcv.wait_for_signal();
			i += s.num();
		}
		elapsed_ms = main_timer.elapsed_ms() - elapsed_ms;
		unsigned const min_ms     = ((i - 1) * period_us) / 1000;
		unsigned const max_us     = i * period_us;
		unsigned const max_err_us = max_us / 100;
		unsigned const max_ms     = (max_us + max_err_us) / 1000;
		if (min_ms > elapsed_ms || max_ms < elapsed_ms) {
			error("timing ", period_us / 1000, " ms "
			      "period ", i, " times failed: ",
			      elapsed_ms, " ms (min ", min_ms, ", max ", max_ms, ")");
			return -1;
		}
		log("Done ", period_us / 1000, " ms period ", i, " times: ",
		    elapsed_ms, " ms (min ", min_ms, ", max ", max_ms, ")");
		i = 0, period_us /= 2, periods = PTEST_TIME_US / period_us;
	}

	/* create timer clients with different periods */
	for (unsigned period_msec = 1; period_msec < 28; period_msec++) {
		Timer_client *tc = new (env()->heap()) Timer_client(period_msec);
		timer_clients.insert(tc);
		tc->start();
	}

	enum { SECONDS_TO_WAIT = 10 };
	for (unsigned i = 0; i < SECONDS_TO_WAIT; i++) {
		main_timer.msleep(1000);
		log("wait ", i + 1, "/", (int)SECONDS_TO_WAIT);
	}

	/* stop all timers */
	for (Timer_client *curr = timer_clients.first(); curr; curr = curr->next())
		curr->stop();

	/* print statistics about each timer client */
	for (Timer_client *curr = timer_clients.first(); curr; curr = curr->next())
		log("timer (period ", curr->period_msec(), " ms) "
		    "triggered ", curr->cnt(), " times -> "
		    "slept ", curr->period_msec()*curr->cnt(), " ms");

	log("--- timer test finished ---");
	Genode::sleep_forever();

	return 0;
}