Reinsertion of doxygen headers

Reinsertion of doxygen headers that got lost in license change

6 files changed, 144 insertions, 86 deletions

diff --git a/drivers/gadc/AT91SAM7/gadc_lld.c b/drivers/gadc/AT91SAM7/gadc_lld.c
index 791e6bee..00af65a5 100644
--- a/drivers/gadc/AT91SAM7/gadc_lld.c
+++ b/drivers/gadc/AT91SAM7/gadc_lld.c
@@ -5,6 +5,15 @@
  *              http://chibios-gfx.com/license.html
  */
 
+/**
+ * @file    drivers/gadc/AT91SAM7/gadc_lld.c
+ * @brief   GADC - Periodic ADC driver source file for the AT91SAM7 cpu.
+ *
+ * @defgroup Driver Driver
+ * @ingroup GADC
+ * @{
+ */
+
 #include "ch.h"
 #include "hal.h"
 #include "gfx.h"
diff --git a/drivers/gaudin/gadc/gaudin_lld.c b/drivers/gaudin/gadc/gaudin_lld.c
index 7a416569..42b4aafc 100644
--- a/drivers/gaudin/gadc/gaudin_lld.c
+++ b/drivers/gaudin/gadc/gaudin_lld.c
@@ -4,6 +4,15 @@
  *
  *              http://chibios-gfx.com/license.html
  */
+
+/**
+ * @file    drivers/gaudin/gadc/gaudin_lld.c
+ * @brief   GAUDIN - Driver file for using the cpu ADC (via GADC).
+ *
+ * @addtogroup GAUDIN
+ *
+ * @{
+ */
 #include "ch.h"
 #include "hal.h"
 
diff --git a/drivers/ginput/touch/ADS7843/ginput_lld_mouse_config.h b/drivers/ginput/touch/ADS7843/ginput_lld_mouse_config.h
index e2d44b4b..c0219712 100644
--- a/drivers/ginput/touch/ADS7843/ginput_lld_mouse_config.h
+++ b/drivers/ginput/touch/ADS7843/ginput_lld_mouse_config.h
@@ -4,19 +4,29 @@
  *
  *              http://chibios-gfx.com/license.html
  */
-

-#ifndef _LLD_GINPUT_MOUSE_CONFIG_H

-#define _LLD_GINPUT_MOUSE_CONFIG_H

-

-#define GINPUT_MOUSE_EVENT_TYPE					GEVENT_TOUCH

-#define GINPUT_MOUSE_NEED_CALIBRATION			TRUE

-#define GINPUT_MOUSE_LLD_CALIBRATION_LOADSAVE	FALSE

-#define GINPUT_MOUSE_MAX_CALIBRATION_ERROR		5

-#define GINPUT_MOUSE_READ_CYCLES				4

-#define GINPUT_MOUSE_POLL_PERIOD				25

-#define GINPUT_MOUSE_MAX_CLICK_JITTER			10

-#define GINPUT_MOUSE_MAX_MOVE_JITTER			2

-#define GINPUT_MOUSE_CLICK_TIME					500

-

-#endif /* _LLD_GINPUT_MOUSE_CONFIG_H */

-/** @} */

+
+/**
+ * @file    drivers/ginput/touch/ADS7843/ginput_lld_mouse_config.h
+ * @brief   GINPUT LLD header file for mouse/touch driver.
+ *
+ * @defgroup Mouse Mouse
+ * @ingroup GINPUT 
+ *
+ * @{
+ */
+
+#ifndef _LLD_GINPUT_MOUSE_CONFIG_H
+#define _LLD_GINPUT_MOUSE_CONFIG_H
+
+#define GINPUT_MOUSE_EVENT_TYPE					GEVENT_TOUCH
+#define GINPUT_MOUSE_NEED_CALIBRATION			TRUE
+#define GINPUT_MOUSE_LLD_CALIBRATION_LOADSAVE	FALSE
+#define GINPUT_MOUSE_MAX_CALIBRATION_ERROR		5
+#define GINPUT_MOUSE_READ_CYCLES				4
+#define GINPUT_MOUSE_POLL_PERIOD				25
+#define GINPUT_MOUSE_MAX_CLICK_JITTER			10
+#define GINPUT_MOUSE_MAX_MOVE_JITTER			2
+#define GINPUT_MOUSE_CLICK_TIME					500
+
+#endif /* _LLD_GINPUT_MOUSE_CONFIG_H */
+/** @} */
diff --git a/drivers/ginput/touch/MCU/ginput_lld_mouse_config.h b/drivers/ginput/touch/MCU/ginput_lld_mouse_config.h
index bf84cb7c..29d6aea5 100644
--- a/drivers/ginput/touch/MCU/ginput_lld_mouse_config.h
+++ b/drivers/ginput/touch/MCU/ginput_lld_mouse_config.h
@@ -4,19 +4,29 @@
  *
  *              http://chibios-gfx.com/license.html
  */
-

-#ifndef _LLD_GINPUT_MOUSE_CONFIG_H

-#define _LLD_GINPUT_MOUSE_CONFIG_H

-

-#define GINPUT_MOUSE_EVENT_TYPE					GEVENT_TOUCH

-#define GINPUT_MOUSE_NEED_CALIBRATION			TRUE

-#define GINPUT_MOUSE_LLD_CALIBRATION_LOADSAVE	FALSE

-#define GINPUT_MOUSE_MAX_CALIBRATION_ERROR		12

-#define GINPUT_MOUSE_READ_CYCLES				4

-#define GINPUT_MOUSE_POLL_PERIOD				25

-#define GINPUT_MOUSE_MAX_CLICK_JITTER			2

-#define GINPUT_MOUSE_MAX_MOVE_JITTER			2

-#define GINPUT_MOUSE_CLICK_TIME					500

-

-#endif /* _LLD_GINPUT_MOUSE_CONFIG_H */

-/** @} */

+
+/**
+ * @file    drivers/ginput/touch/MCU/ginput_lld_mouse_config.h
+ * @brief   GINPUT LLD header file for touch driver.
+ *
+ * @defgroup Mouse Mouse
+ * @ingroup GINPUT
+ *
+ * @{
+ */
+
+#ifndef _LLD_GINPUT_MOUSE_CONFIG_H
+#define _LLD_GINPUT_MOUSE_CONFIG_H
+
+#define GINPUT_MOUSE_EVENT_TYPE					GEVENT_TOUCH
+#define GINPUT_MOUSE_NEED_CALIBRATION			TRUE
+#define GINPUT_MOUSE_LLD_CALIBRATION_LOADSAVE	FALSE
+#define GINPUT_MOUSE_MAX_CALIBRATION_ERROR		12
+#define GINPUT_MOUSE_READ_CYCLES				4
+#define GINPUT_MOUSE_POLL_PERIOD				25
+#define GINPUT_MOUSE_MAX_CLICK_JITTER			2
+#define GINPUT_MOUSE_MAX_MOVE_JITTER			2
+#define GINPUT_MOUSE_CLICK_TIME					500
+
+#endif /* _LLD_GINPUT_MOUSE_CONFIG_H */
+/** @} */
diff --git a/drivers/ginput/touch/STMPE811/ginput_lld_mouse_config.h b/drivers/ginput/touch/STMPE811/ginput_lld_mouse_config.h
index 84cb7aa9..9d08d724 100644
--- a/drivers/ginput/touch/STMPE811/ginput_lld_mouse_config.h
+++ b/drivers/ginput/touch/STMPE811/ginput_lld_mouse_config.h
@@ -4,23 +4,33 @@
  *
  *              http://chibios-gfx.com/license.html
  */
-

-#ifndef _LLD_GINPUT_MOUSE_CONFIG_H

-#define _LLD_GINPUT_MOUSE_CONFIG_H

-

-#define GINPUT_MOUSE_EVENT_TYPE					GEVENT_TOUCH

-#define GINPUT_MOUSE_NEED_CALIBRATION			TRUE

-#define GINPUT_MOUSE_LLD_CALIBRATION_LOADSAVE	FALSE

-#define GINPUT_MOUSE_MAX_CALIBRATION_ERROR		5

-#define GINPUT_MOUSE_READ_CYCLES				1

-#define GINPUT_MOUSE_POLL_PERIOD				25

-#define GINPUT_MOUSE_MAX_CLICK_JITTER			10

-#define GINPUT_MOUSE_MAX_MOVE_JITTER			5

-#define GINPUT_MOUSE_CLICK_TIME					450

-

-/* default values - over write these in your boad files */

-#define STMP811_SLOWER_RESPONSE 				FALSE

-#define STMP811_NO_GPIO_IRQPIN 					FALSE

-

-#endif /* _LLD_GINPUT_MOUSE_CONFIG_H */

-/** @} */

+
+/**
+ * @file    drivers/ginput/touch/STMPE811/ginput_lld_mouse_config.h
+ * @brief   GINPUT LLD header file for mouse/touch driver.
+ *
+ * @defgroup Mouse Mouse
+ * @ingroup GINPUT 
+ *
+ * @{
+ */
+
+#ifndef _LLD_GINPUT_MOUSE_CONFIG_H
+#define _LLD_GINPUT_MOUSE_CONFIG_H
+
+#define GINPUT_MOUSE_EVENT_TYPE					GEVENT_TOUCH
+#define GINPUT_MOUSE_NEED_CALIBRATION			TRUE
+#define GINPUT_MOUSE_LLD_CALIBRATION_LOADSAVE	FALSE
+#define GINPUT_MOUSE_MAX_CALIBRATION_ERROR		5
+#define GINPUT_MOUSE_READ_CYCLES				1
+#define GINPUT_MOUSE_POLL_PERIOD				25
+#define GINPUT_MOUSE_MAX_CLICK_JITTER			10
+#define GINPUT_MOUSE_MAX_MOVE_JITTER			5
+#define GINPUT_MOUSE_CLICK_TIME					450
+
+/* default values - over write these in your boad files */
+#define STMP811_SLOWER_RESPONSE 				FALSE
+#define STMP811_NO_GPIO_IRQPIN 					FALSE
+
+#endif /* _LLD_GINPUT_MOUSE_CONFIG_H */
+/** @} */
diff --git a/drivers/multiple/Win32/ginput_lld_mouse_config.h b/drivers/multiple/Win32/ginput_lld_mouse_config.h
index 4c322e18..39478aaa 100644
--- a/drivers/multiple/Win32/ginput_lld_mouse_config.h
+++ b/drivers/multiple/Win32/ginput_lld_mouse_config.h
@@ -4,37 +4,47 @@
  *
  *              http://chibios-gfx.com/license.html
  */
-

-#ifndef _LLD_GINPUT_MOUSE_CONFIG_H

-#define _LLD_GINPUT_MOUSE_CONFIG_H

-

-// This driver supports being both a mouse or a touch device (we don't actually know which it really is)

-//	When operating in mouse mode a long left button click does not generate a context click.

-//	When operating in touch mode we allow sloppier clicks etc

-#if 1

-	#define GINPUT_MOUSE_EVENT_TYPE					GEVENT_MOUSE

-	#define GINPUT_MOUSE_CLICK_TIME					TIME_INFINITE			// Long click != Context Click

-	#define GINPUT_MOUSE_NEED_CALIBRATION			FALSE

-	#define GINPUT_MOUSE_LLD_CALIBRATION_LOADSAVE	FALSE

-	#define GINPUT_MOUSE_READ_CYCLES				1

-	#define GINPUT_MOUSE_MAX_CALIBRATION_ERROR		-1

-	#define GINPUT_MOUSE_MAX_CLICK_JITTER			0

-	#define GINPUT_MOUSE_MAX_MOVE_JITTER			0

-#else

-	#define GINPUT_MOUSE_EVENT_TYPE					GEVENT_TOUCH

-	#define GINPUT_MOUSE_CLICK_TIME					700						// Long click = Context Click

-	#define GINPUT_MOUSE_NEED_CALIBRATION			FALSE					// Can be set to TRUE just for testing

-	#define GINPUT_MOUSE_LLD_CALIBRATION_LOADSAVE	FALSE

-	#define GINPUT_MOUSE_READ_CYCLES				1

-	#define GINPUT_MOUSE_MAX_CALIBRATION_ERROR		2

-	#define GINPUT_MOUSE_MAX_CLICK_JITTER			2

-	#define GINPUT_MOUSE_MAX_MOVE_JITTER			2

-#endif

-

-// This driver supports both an "interrupt" mode, and a polled mode

-#define GINPUT_MOUSE_POLL_PERIOD				TIME_INFINITE			// Interrupt driven by the Window thread

-//#define GINPUT_MOUSE_POLL_PERIOD				25						// Poll driven

-

-#endif /* _LLD_GINPUT_MOUSE_CONFIG_H */

-/** @} */

-

+
+/**
+ * @file    drivers/multiple/Win32/ginput_lld_mouse_config.h
+ * @brief   GINPUT LLD header file for mouse/touch driver.
+ *
+ * @defgroup Mouse Mouse
+ * @ingroup GINPUT
+ *
+ * @{
+ */
+
+#ifndef _LLD_GINPUT_MOUSE_CONFIG_H
+#define _LLD_GINPUT_MOUSE_CONFIG_H
+
+// This driver supports being both a mouse or a touch device (we don't actually know which it really is)
+//	When operating in mouse mode a long left button click does not generate a context click.
+//	When operating in touch mode we allow sloppier clicks etc
+#if 1
+	#define GINPUT_MOUSE_EVENT_TYPE					GEVENT_MOUSE
+	#define GINPUT_MOUSE_CLICK_TIME					TIME_INFINITE			// Long click != Context Click
+	#define GINPUT_MOUSE_NEED_CALIBRATION			FALSE
+	#define GINPUT_MOUSE_LLD_CALIBRATION_LOADSAVE	FALSE
+	#define GINPUT_MOUSE_READ_CYCLES				1
+	#define GINPUT_MOUSE_MAX_CALIBRATION_ERROR		-1
+	#define GINPUT_MOUSE_MAX_CLICK_JITTER			0
+	#define GINPUT_MOUSE_MAX_MOVE_JITTER			0
+#else
+	#define GINPUT_MOUSE_EVENT_TYPE					GEVENT_TOUCH
+	#define GINPUT_MOUSE_CLICK_TIME					700						// Long click = Context Click
+	#define GINPUT_MOUSE_NEED_CALIBRATION			FALSE					// Can be set to TRUE just for testing
+	#define GINPUT_MOUSE_LLD_CALIBRATION_LOADSAVE	FALSE
+	#define GINPUT_MOUSE_READ_CYCLES				1
+	#define GINPUT_MOUSE_MAX_CALIBRATION_ERROR		2
+	#define GINPUT_MOUSE_MAX_CLICK_JITTER			2
+	#define GINPUT_MOUSE_MAX_MOVE_JITTER			2
+#endif
+
+// This driver supports both an "interrupt" mode, and a polled mode
+#define GINPUT_MOUSE_POLL_PERIOD				TIME_INFINITE			// Interrupt driven by the Window thread
+//#define GINPUT_MOUSE_POLL_PERIOD				25						// Poll driven
+
+#endif /* _LLD_GINPUT_MOUSE_CONFIG_H */
+/** @} */
+