summaryrefslogtreecommitdiffstats
path: root/src/include/ipxe/timer.h
blob: a6dffaf1c3934ff64337408f250287e85ba0e53c (plain) (blame)
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
#ifndef	_IPXE_TIMER_H
#define _IPXE_TIMER_H

/** @file
 *
 * iPXE timers
 *
 */

FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );

#include <ipxe/tables.h>

/** Number of ticks per second */
#define TICKS_PER_SEC 1024

/** Number of ticks per millisecond
 *
 * This is (obviously) not 100% consistent with the definition of
 * TICKS_PER_SEC, but it allows for multiplications and divisions to
 * be elided.  In any case, timer ticks are not expected to be a
 * precision timing source; for example, the standard BIOS timer is
 * based on an 18.2Hz clock.
 */
#define TICKS_PER_MS 1

/** A timer */
struct timer {
	/** Name */
	const char *name;
	/**
	 * Probe timer
	 *
	 * @ret rc		Return status code
	 */
	int ( * probe ) ( void );
	/**
	 * Get current system time in ticks
	 *
	 * @ret ticks		Current time, in ticks
	 */
	unsigned long ( * currticks ) ( void );
	/**
	 * Delay for a fixed number of microseconds
	 *
	 * @v usecs		Number of microseconds for which to delay
	 */
	void ( * udelay ) ( unsigned long usecs );
};

/** Timer table */
#define TIMERS __table ( struct timer, "timers" )

/** Declare a timer */
#define __timer( order ) __table_entry ( TIMERS, order )

/** @defgroup timer_order Timer detection order
 *
 * @{
 */

#define TIMER_PREFERRED	01	/**< Preferred timer */
#define TIMER_NORMAL	02	/**< Normal timer */

/** @} */

/*
 * sleep() prototype is defined by POSIX.1.  usleep() prototype is
 * defined by 4.3BSD.  udelay() and mdelay() prototypes are chosen to
 * be reasonably sensible.
 *
 */

extern void udelay ( unsigned long usecs );
extern void mdelay ( unsigned long msecs );
extern unsigned long currticks ( void );
extern unsigned int sleep ( unsigned int seconds );
extern void sleep_fixed ( unsigned int secs );

#endif /* _IPXE_TIMER_H */