aboutsummaryrefslogtreecommitdiffstats
path: root/src/include/delta.h
blob: 4365eb482fa14a8dfb0309dbc59af71a2b2a0763 (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
/*
    ChibiOS/RT - Copyright (C) 2006-2007 Giovanni Di Sirio.

    This file is part of ChibiOS/RT.

    ChibiOS/RT is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 3 of the License, or
    (at your option) any later version.

    ChibiOS/RT is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.
*/

/**
 * @addtogroup VirtualTimers
 * @{
 */

#ifndef _DELTA_H_
#define _DELTA_H_

#ifdef CH_USE_VIRTUAL_TIMERS

/** Virtual Timer callback function.*/
typedef void (*t_vtfunc)(void *);

typedef struct VirtualTimer VirtualTimer;

/**
 * Virtual Timer descriptor structure.
 */
struct VirtualTimer {
    /** Next timer in the delta list.*/
    VirtualTimer    *vt_next;
    /** Previous timer in the delta list.*/
    VirtualTimer    *vt_prev;
    /** Time delta before timeout.*/
    t_time          vt_dtime;
    /** Timer callback function pointer. The pointer is reset to zero after
        the callback is invoked.*/
    t_vtfunc        vt_func;
    /** Timer callback function parameter.*/
    void            *vt_par;
};

/**
 * Delta List header.
 * @note The delta list is implemented as a double link bidirectional list in
 *       order to make the unlink time constant, the reset of a virtual timer
 *       is often used in the code. An slower implementation using a single
 *       link list is possible and might be added later with a
 *       \p CH_OPTIMIZE_SPACE option.
 */
typedef struct {
    /** Next timer in the list (the one that will be triggered next).*/
    VirtualTimer    *dl_next;
    /** Last timer in the list.*/
    VirtualTimer    *dl_prev;
    /** Not used but it must be set to /p MAXDELTA.*/
    t_time          dl_dtime;
} DeltaList;

extern DeltaList dlist;

#define chVTDoTickI() \
  if (&dlist != (DeltaList *)dlist.dl_next) {                           \
    VirtualTimer *vtp;                                                  \
                                                                        \
    --dlist.dl_next->vt_dtime;                                          \
    while (!(vtp = dlist.dl_next)->vt_dtime) {                          \
      t_vtfunc fn = vtp->vt_func;                                       \
      vtp->vt_func = 0;                                                 \
      (vtp->vt_next->vt_prev = (VirtualTimer *)&dlist)->vt_next = vtp->vt_next; \
      fn(vtp->vt_par);                                                  \
    }                                                                   \
  }

/** Infinite time specification.*/
#define TIME_INFINITE 0

/*
 * Virtual Timers APIs.
 */
#ifdef __cplusplus
extern "C" {
#endif
  void chVTInit(void);
  void chVTSetI(VirtualTimer *vtp, t_time time, t_vtfunc vtfunc, void *par);
  void chVTResetI(VirtualTimer *vtp);
#ifdef __cplusplus
}
#endif

/** Returns TRUE if the speciified timer is armed.*/
#define chVTIsArmedI(vtp) ((vtp)->vt_func != NULL)

#endif /* CH_USE_VIRTUAL_TIMER */

#endif /* _DELTA_H_ */

/** @} */