blob: 457f78c4b8b170396345738e43639d521bfbf4e4 (
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
|
//-----------------------------------------------------------------------------
// *! (C) Copyright International Business Machines Corp. 2014
// *! All Rights Reserved -- Property of IBM
// *! *** IBM Confidential ***
//-----------------------------------------------------------------------------
/// \file pk_timer_init.c
/// \brief PK timer initialization
///
/// The entry points in this file might only be used during initialization of
/// the application. In this case the code space for these routines could be
/// recovered and reused after initialization.
#include "pk.h"
/// Create (initialize) a timer.
///
/// \param timer The PkTimer to initialize.
///
/// \param callback The timer callback
///
/// \param arg Private data provided to the callback.
///
/// Once created with pk_timer_create() a timer can be scheduled with
/// pk_timer_schedule() or pk_timer_schedule_absolute(), which queues the
/// timer in the kernel time queue. Timers can be cancelled by a call of
/// pk_timer_cancel().
///
/// Timers created with pk_timer_create() are always run as
/// bottom-half handlers with interrupt preemption enabled. Timer callbacks are
/// free to enter critical sections if required, but must
/// always exit with interrupts enabled.
///
/// Caution: PK has no way to know if an PkTimer structure provided to
/// pk_timer_create() is safe to use as a timer, and will silently modify
/// whatever memory is provided.
///
/// Return values other then PK_OK (0) are errors; see \ref pk_errors
///
/// \retval 0 Successful completion
///
/// \retval -PK_INVALID_TIMER_AT_CREATE The \a timer is a null (0) pointer.
int
pk_timer_create(PkTimer *timer,
PkTimerCallback callback,
void *arg)
{
if (PK_ERROR_CHECK_API) {
PK_ERROR_IF((timer == 0), PK_INVALID_TIMER_AT_CREATE);
}
pk_deque_element_create((PkDeque*)timer);
timer->timeout = 0;
timer->callback = callback;
timer->arg = arg;
return PK_OK;
}
|