aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorJoel Bodenmann <joel@unormal.org>2012-11-19 20:26:19 +0100
committerJoel Bodenmann <joel@unormal.org>2012-11-19 20:26:19 +0100
commit93fdd5dcdbfc4b4b6c41e0b7836ce754cba7f0a1 (patch)
treebcea54076fc499eb39651ab4e4a0a52def48aae2 /docs
parent8515ed53f517eb497ca619ec2c24429a9dcd580e (diff)
downloaduGFX-93fdd5dcdbfc4b4b6c41e0b7836ce754cba7f0a1.tar.gz
uGFX-93fdd5dcdbfc4b4b6c41e0b7836ce754cba7f0a1.tar.bz2
uGFX-93fdd5dcdbfc4b4b6c41e0b7836ce754cba7f0a1.zip
doxygen of gtimer
Diffstat (limited to 'docs')
-rw-r--r--docs/src/gtimer.dox36
1 files changed, 36 insertions, 0 deletions
diff --git a/docs/src/gtimer.dox b/docs/src/gtimer.dox
new file mode 100644
index 00000000..65dca871
--- /dev/null
+++ b/docs/src/gtimer.dox
@@ -0,0 +1,36 @@
+/*
+ ChibiOS/GFX - Copyright (C) 2012
+ Joel Bodenmann aka Tectu <joel@unormal.org>
+
+ This file is part of ChibiOS/GFX.
+
+ ChibiOS/GFX 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/GFX 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 GTIMER
+ * @details The GTIMER module provides high level, simple and hardware
+ * independend timers. The timers are meant to be used in different
+ * ChibiOS/GFX modules and are not very accurate.
+ *
+ * @details The reason why ChibiOS/GFX has it's own timer abstraction is because
+ * virtual timers provided by ChibiOS/RT are interrupt context only.
+ * While great for what they are designed for, they make coding of the input
+ * drivers much more complex.
+ * For non-performance critical drivers like these input drivers, it would also
+ * hog an in-ordinate amount of critical (interrupt locked) system time.
+ * This contrary to the goals of a real-time operating system. So a user-land
+ * (thread based) timer mechanism is also required.
+ */
+