Fixed CDC and USBtoSerial demos freezing where buffers were full while still transmit...

[pub/lufa.git] / LUFA / Drivers / Board / Temperature.h

diff --git a/LUFA/Drivers/Board/Temperature.h b/LUFA/Drivers/Board/Temperature.h
index c205093..7069e3e 100644 (file)
--- a/LUFA/Drivers/Board/Temperature.h
+++ b/LUFA/Drivers/Board/Temperature.h
@@ -33,6 +33,14 @@
  *  Temperature sensor board driver for the USB boards which contain a temperature sensor.\r
  */\r
 \r
+/** \ingroup Group_BoardDrivers\r
+ *  @defgroup Group_Temperature Temperature Driver - LUFA/Drivers/Board/Temperature.h\r
+ *\r
+ *  Functions, macros, variables, enums and types related to the control of board temperature sensors.\r
+ *\r
+ *  @{\r
+ */\r
+\r
 #ifndef __TEMPERATURE_H__\r
 #define __TEMPERATURE_H__\r
 \r
@@ -44,8 +52,8 @@
        /* Includes: */\r
                #include <avr/pgmspace.h>\r
 \r
-               #include "../AT90USBXXX/ADC.h"\r
                #include "../../Common/Common.h"\r
+               #include "../Peripheral/ADC.h"\r
        \r
                #if !defined(BOARD)\r
                        #error #error BOARD must be set in makefile to a value specified in BoardTypes.h.       \r
@@ -68,20 +76,25 @@
 \r
                        /** Maximum returnable temperature from the Temperature_GetTemperature() function. */\r
                        #define TEMP_MAX_TEMP      ((TEMP_TABLE_SIZE - 1) + TEMP_TABLE_OFFSET)\r
-                       \r
-                       /** Initializes the temperature sensor driver, including setting up the appropriate ADC channel.\r
-                        *  This must be called before any other temperature sensor routines.\r
-                        *\r
-                        *  The ADC itself (not the ADC channel) must be configured seperately before calling the temperature\r
-                        *  sensor functions.\r
-                        */\r
-                       #define Temperature_Init() ADC_SetupChannel(TEMP_ADC_CHANNEL);\r
+               \r
+               /* Psuedo-Functions: */\r
+                       #if defined(__DOXYGEN__)\r
+                               /** Initializes the temperature sensor driver, including setting up the appropriate ADC channel.\r
+                                *  This must be called before any other temperature sensor routines.\r
+                                *\r
+                                *  The ADC itself (not the ADC channel) must be configured separately before calling the temperature\r
+                                *  sensor functions.\r
+                                */\r
+                               static inline void Temperature_Init(void);\r
+                       #else\r
+                               #define Temperature_Init() ADC_SetupChannel(TEMP_ADC_CHANNEL);\r
+                       #endif\r
 \r
                /* Function Prototypes: */\r
                        /** Performs a complete ADC on the temperature sensor channel, and converts the result into a\r
-                        *  valid temperature between TEMP_MIN_TEMP and TEMP_MAX_TEMP in degrees Celcius.\r
+                        *  valid temperature between TEMP_MIN_TEMP and TEMP_MAX_TEMP in degrees Celsius.\r
                         *\r
-                        *  \return Signed temperature in degrees Celcius\r
+                        *  \return Signed temperature in degrees Celsius\r
                         */\r
                        int8_t Temperature_GetTemperature(void) ATTR_WARN_UNUSED_RESULT;\r
 \r
@@ -98,3 +111,5 @@
                #endif\r
                \r
 #endif\r
+\r
+/** @} */\r