summaryrefslogtreecommitdiffstats
path: root/src/include/kernel/timemgr.H
blob: 0590dedff954ba33825052d7d73dd9cad18b4586 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
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
110
111
112
113
114
115
116
117
118
//  IBM_PROLOG_BEGIN_TAG
//  This is an automatically generated prolog.
//
//  $Source: src/include/kernel/timemgr.H $
//
//  IBM CONFIDENTIAL
//
//  COPYRIGHT International Business Machines Corp. 2010 - 2011
//
//  p1
//
//  Object Code Only (OCO) source materials
//  Licensed Internal Code Source Materials
//  IBM HostBoot Licensed Internal Code
//
//  The source code for this program is not published or other-
//  wise divested of its trade secrets, irrespective of what has
//  been deposited with the U.S. Copyright Office.
//
//  Origin: 30
//
//  IBM_PROLOG_END
#ifndef __KERNEL_TIMEMGR_H
#define __KERNEL_TIMEMGR_H

#include <kernel/types.h>
#include <kernel/cpu.H>
#include <arch/ppc.H>

#include <util/locked/pqueue.H>
#include <kernel/spinlock.H>

class Scheduler;

/** Struct to hold sleeping tasks in a pqueue */
struct _TimeManager_Delay_t
{
    _TimeManager_Delay_t * next;
    _TimeManager_Delay_t * prev;
    uint64_t key;
    task_t* task;
};

/** @class TimeManager
 *  @brief Keeps track of sleeping of tasks and conversions between TB and time.
 */
class TimeManager
{
    public:
	enum
	    {
                /** Number of time-slices to allow per second.
                 *
                 *  Context length becomes (1/TIMESLICE_PER_SECOND) sec.
                 */
		TIMESLICE_PER_SEC = 1000,
	    };

            /** Initialize the time subsystem. */
	static void init();
            /** Return the number of ticks per time-slice. */
	static uint64_t getTimeSliceCount()
	    {
		return iv_timebaseFreq / TIMESLICE_PER_SEC;
	    };

            /** Returns the value of the processor timebase register. */
	static uint64_t getCurrentTimeBase()
	    {
		return getTB();
	    };

        /** Converts seconds/nsecs to timebase ticks.
         *
         *  Typically this is used for calculating the number of ticks in an
         *  interval.
         *
         *  @param[in] i_sec - Number of seconds.
         *  @param[in] i_nsec - Number of nsecs.
         *
         *  @return Number of timebase ticks.
         */
	static uint64_t convertSecToTicks(uint64_t i_sec, uint64_t i_nsec);
        /** Converts timebase ticks to seconds/nsecs.
         *
         *  @param[in] i_ticks - Number of ticks.
         *  @param[out] o_sec - Number of seconds.
         *  @param[out] o_nsec - Number of nsecs.
         */
        static void convertTicksToSec(uint64_t i_ticks,
                                      uint64_t& o_sec, uint64_t& o_nsec);

        /** Delay (sleep) a task for a length of time.
         *
         *  @param[in] t - Task to delay.
         *  @param[in] i_sec - Seconds.
         *  @param[in] i_nsec - Nsecs.
         */
	static void delayTask(task_t* t, uint64_t i_sec, uint64_t i_nsec);
        /** Checks the sleep queue to determine if any tasks should be woken. */
	static void checkReleaseTasks(Scheduler* s);

    protected:
	TimeManager() {};
	~TimeManager() {};

    private:
	void _init();
	void _delayTask(task_t* t, uint64_t i_sec, uint64_t i_nsec);
	void _checkReleaseTasks(Scheduler* s);

	Util::Locked::PQueue<_TimeManager_Delay_t, uint64_t>
			iv_taskList[KERNEL_MAX_SUPPORTED_CPUS];
        /** Frequency of the timebase register in Hz. (ticks per second) */
	static uint64_t iv_timebaseFreq;
};

#endif
OpenPOWER on IntegriCloud