aboutsummaryrefslogtreecommitdiffstats
path: root/os/hal/include
diff options
context:
space:
mode:
authorgdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>2012-01-09 18:28:29 +0000
committergdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>2012-01-09 18:28:29 +0000
commit7041c5b167918def8ad906cbd9a46d73acc73c56 (patch)
tree3ce109d0f20448364fbb908fcbe6ed413c3454e6 /os/hal/include
parentda38ec03db0391378811e0214bf039feea6d79f3 (diff)
downloadChibiOS-7041c5b167918def8ad906cbd9a46d73acc73c56.tar.gz
ChibiOS-7041c5b167918def8ad906cbd9a46d73acc73c56.tar.bz2
ChibiOS-7041c5b167918def8ad906cbd9a46d73acc73c56.zip
git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@3775 35acf78f-673a-0410-8e92-d51de3d6d3f4
Diffstat (limited to 'os/hal/include')
-rw-r--r--os/hal/include/hal.h19
-rw-r--r--os/hal/include/tm.h94
2 files changed, 112 insertions, 1 deletions
diff --git a/os/hal/include/hal.h b/os/hal/include/hal.h
index b7e6141cc..c9a7ad169 100644
--- a/os/hal/include/hal.h
+++ b/os/hal/include/hal.h
@@ -34,6 +34,7 @@
#include "hal_lld.h"
+#include "tm.h"
#include "pal.h"
#include "adc.h"
#include "can.h"
@@ -43,6 +44,7 @@
#include "icu.h"
#include "mac.h"
#include "pwm.h"
+#include "rtc.h"
#include "serial.h"
#include "sdc.h"
#include "spi.h"
@@ -50,7 +52,6 @@
#include "usb.h"
#include "mmc_spi.h"
#include "serial_usb.h"
-#include "rtc.h"
/*===========================================================================*/
/* Driver constants. */
@@ -188,6 +189,22 @@
(halGetCounterValue() < end))
/** @} */
+/**
+ * @brief Polled delay.
+ * @note The real delays is always few cycles in excess of the specified
+ * value.
+ *
+ * @param[in] ticks number of ticks
+ *
+ * @api
+ */
+#define halPolledDelay(ticks) { \
+ halrtcnt_t start = halGetCounterValue(); \
+ halrtcnt_t timeout = start + (ticks); \
+ while (halIsCounterWithin(start, timeout)) \
+ ; \
+}
+
/*===========================================================================*/
/* External declarations. */
/*===========================================================================*/
diff --git a/os/hal/include/tm.h b/os/hal/include/tm.h
new file mode 100644
index 000000000..23b9255f2
--- /dev/null
+++ b/os/hal/include/tm.h
@@ -0,0 +1,94 @@
+/*
+ ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010,
+ 2011 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.h
+ * @brief Time Measurement unit header.
+ *
+ * @addtogroup TM
+ * @{
+ */
+
+#ifndef _TM_H_
+#define _TM_H_
+
+#if HAL_USE_TM
+
+/**
+ * @brief Type of a Time Measurement object.
+ * @note Start/stop of measurements is performed through the function
+ * pointers in order to avoid inlining of those functions which
+ * could compromise measurement accuracy.
+ * @note The maximum measurable time period depends on the implementation
+ * of the realtime counter in the HAL driver.
+ * @note The measurement is not 100% cycle-accurate, it can be in excess
+ * of few cycles depending on the compiler and target architecture.
+ * @note Interrupts can affect measurement if the measurement is performed
+ * with interrupts enabled.
+ */
+typedef struct TimeMeasurement TimeMeasurement;
+
+/**
+ * @brief Time Measurement structure.
+ */
+struct TimeMeasurement {
+ void (*start)(TimeMeasurement *tmp); /**< @brief Starts a measurement. */
+ void (*stop)(TimeMeasurement *tmp); /**< @brief Stops a measurement. */
+ halrtcnt_t last; /**< @brief Last measurement. */
+ halrtcnt_t worst; /**< @brief Worst measurement. */
+ halrtcnt_t best; /**< @brief Best measurement. */
+};
+
+/**
+ * @brief Starts a measurement.
+ * @pre The @p TimeMeasurement must be initialized.
+ * @note This function can be invoked in any context.
+ *
+ * @param[in,out] tmp pointer to a @p TimeMeasurement structure
+ *
+ * @special
+ */
+#define tmStartMeasurement(tmp) (tmp)->start(tmp)
+
+/**
+ * @brief Stops a measurement.
+ * @pre The @p TimeMeasurement must be initialized.
+ * @note This function can be invoked in any context.
+ *
+ * @param[in,out] tmp pointer to a @p TimeMeasurement structure
+ *
+ * @special
+ */
+#define tmStopMeasurement(tmp) (tmp)->stop(tmp)
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+ void tmInit(void);
+ void tmObjectInit(TimeMeasurement *tmp);
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* HAL_USE_TM */
+
+#endif /* _TM_H_ */
+
+/** @} */