aboutsummaryrefslogtreecommitdiffstats
path: root/os/hal/src/tm.c
blob: 5b002cd90897195dd06d55b601d75c9ad886f0d7 (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
119
120
121
122
123
124
125
126
127
128
/*
    ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010,
                 2011,2012,2013 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/>.
*/

/**
 * @file    tm.c
 * @brief   Time Measurement driver code.
 *
 * @addtogroup TM
 * @{
 */

#include "ch.h"
#include "hal.h"

#if HAL_USE_TM || defined(__DOXYGEN__)

/*===========================================================================*/
/* Driver local definitions.                                                 */
/*===========================================================================*/

/*===========================================================================*/
/* Driver exported variables.                                                */
/*===========================================================================*/

/*===========================================================================*/
/* Driver local variables and types.                                         */
/*===========================================================================*/

/**
 * @brief   Subsystem calibration value.
 */
static halrtcnt_t measurement_offset;

/*===========================================================================*/
/* Driver local functions.                                                   */
/*===========================================================================*/

/**
 * @brief   Starts a measurement.
 *
 * @param[in,out] tmp   pointer to a @p TimeMeasurement structure
 *
 * @notapi
 */
static void tm_start(TimeMeasurement *tmp) {

  tmp->last = halGetCounterValue();
}

/**
 * @brief   Stops a measurement.
 *
 * @param[in,out] tmp   pointer to a @p TimeMeasurement structure
 *
 * @notapi
 */
static void tm_stop(TimeMeasurement *tmp) {

  halrtcnt_t now = halGetCounterValue();
  tmp->last = now - tmp->last - measurement_offset;
  if (tmp->last > tmp->worst)
      tmp->worst = tmp->last;
  else if (tmp->last < tmp->best)
      tmp->best = tmp->last;
}

/*===========================================================================*/
/* Driver interrupt handlers.                                                */
/*===========================================================================*/

/*===========================================================================*/
/* Driver exported functions.                                                */
/*===========================================================================*/

/**
 * @brief   Initializes the Time Measurement unit.
 *
 * @init
 */
void tmInit(void) {
  TimeMeasurement tm;

  /* Time Measurement subsystem calibration, it does a null measurement
     and calculates the call overhead which is subtracted to real
     measurements.*/
  measurement_offset = 0;
  tmObjectInit(&tm);
  tmStartMeasurement(&tm);
  tmStopMeasurement(&tm);
  measurement_offset = tm.last;
}

/**
 * @brief   Initializes a @p TimeMeasurement object.
 *
 * @param[out] tmp      pointer to a @p TimeMeasurement structure
 *
 * @init
 */
void tmObjectInit(TimeMeasurement *tmp) {

  tmp->start = tm_start;
  tmp->stop  = tm_stop;
  tmp->last  = (halrtcnt_t)0;
  tmp->worst = (halrtcnt_t)0;
  tmp->best  = (halrtcnt_t)-1;
}

#endif /* HAL_USE_TM */

/** @} */