doxygen tweaks - not complete yet

ugfx_release_2.6
Joel Bodenmann 2012-11-06 23:55:45 +01:00
parent a39a8427d9
commit b86c313aa2
6 changed files with 62 additions and 23 deletions

View File

@ -19,10 +19,11 @@
*/
/**
* @file drivers/touchpad/XPT2046/touchpad_lld.c
* @file drivers/touchpad/ADS7843/touchpad_lld.c
* @brief Touchpad Driver subsystem low level driver source.
*
* @addtogroup TOUCHPAD
* @defgroup ADS7843
* @ingroup DRIVERS
* @{
*/
@ -85,7 +86,6 @@ void tp_lld_init(const TOUCHPADDriver *tp) {
* @param[in] cmd The command bits to send to the touchpad
*
* @return The read value 12-bit right-justified
*
* @note This function only reads data, it is assumed that the pins are
* configured properly and the bus has been acquired beforehand
*
@ -107,7 +107,6 @@ uint16_t tp_lld_read_value(uint8_t cmd) {
/**
* @brief 7-point median filtering code for touchpad samples
*
* @note This is an internally used routine only.
*
* @notapi
@ -129,10 +128,11 @@ static void tp_lld_filter(void) {
}
/**
* @brief Reads out the X direction.
*
* @brief Reads out the X value.
* @note The samples are median filtered for greater noise reduction
*
* @return The uncalibrated but filtered X value
*
* @notapi
*/
uint16_t tp_lld_read_x(void) {
@ -170,8 +170,11 @@ uint16_t tp_lld_read_x(void) {
return sampleBuf[3];
}
/*
* @brief Reads out the Y direction.
/**
* @brief Reads out the Y value.
* @note The samples are median filtered for greater noise reduction
*
* @return The uncalibrated but filtered Y value
*
* @notapi
*/
@ -212,8 +215,8 @@ uint16_t tp_lld_read_y(void) {
/* ---- Optional Routines ---- */
#if TOUCHPAD_HAS_IRQ || defined(__DOXYGEN__)
/*
* @brief for checking if touchpad is pressed or not.
/**
* @brief For checking if touchpad is pressed or not.
*
* @return 1 if pressed / 0 if not pressed
*
@ -225,9 +228,11 @@ uint16_t tp_lld_read_y(void) {
#endif
#if TOUCHPAD_HAS_PRESSURE || defined(__DOXYGEN__)
/*
/**
* @brief Reads out the Z direction / pressure.
*
* @return The amount of preasure
*
* @notapi
*/
uint16_t tp_lld_read_z(void) {

View File

@ -22,7 +22,8 @@
* @file drivers/touchpad/ADS7843/touchpad_lld_config.h
* @brief Touchpad Driver subsystem low level driver.
*
* @addtogroup TOUCHPAD
* @defgroup ADS7843
* @ingroup DRIVERS
* @{
*/

View File

@ -22,7 +22,8 @@
* @file drivers/touchpad/XPT2046/touchpad_lld.c
* @brief Touchpad Driver subsystem low level driver source.
*
* @addtogroup TOUCHPAD
* @defgroup XPT2046
* @ingroup DRIVERS
* @{
*/
@ -107,8 +108,7 @@ uint16_t tp_lld_read_value(uint8_t cmd) {
/**
* @brief 7-point median filtering code for touchpad samples
*
* @note This is an internally used routine only.
* @note This is an internally used routine only
*
* @notapi
*/
@ -129,10 +129,11 @@ static void tp_lld_filter(void) {
}
/**
* @brief Reads out the X direction.
*
* @brief Reads out the X value.
* @note The samples are median filtered for greater noise reduction
*
* @return The uncalibrated but filtered X value
*
* @notapi
*/
uint16_t tp_lld_read_x(void) {
@ -170,8 +171,11 @@ uint16_t tp_lld_read_x(void) {
return sampleBuf[3];
}
/*
* @brief Reads out the Y direction.
/**
* @brief Reads out the Y value.
* @note The samples are median filtered for greated noise reduction
*
* @return The uncalibrated but filtered Y value
*
* @notapi
*/
@ -212,7 +216,7 @@ uint16_t tp_lld_read_y(void) {
/* ---- Optional Routines ---- */
#if TOUCHPAD_HAS_IRQ || defined(__DOXYGEN__)
/*
/**
* @brief for checking if touchpad is pressed or not.
*
* @return 1 if pressed / 0 if not pressed
@ -225,9 +229,11 @@ uint16_t tp_lld_read_y(void) {
#endif
#if TOUCHPAD_HAS_PRESSURE || defined(__DOXYGEN__)
/*
/**
* @brief Reads out the Z direction / pressure.
*
* @return The mount of preasure
*
* @notapi
*/
uint16_t tp_lld_read_z(void) {

View File

@ -22,7 +22,8 @@
* @file drivers/touchpad/XPT2046/touchpad_lld_config.h
* @brief Touchppad Driver subsystem low level driver.
*
* @addtogroup TOUCHPAD
* @defgroup XPT2046
* @ingroup DRIVERS
* @{
*/

25
src/drivers.c 100644
View File

@ -0,0 +1,25 @@
/*
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 DRIVERS
* @{
*/

View File

@ -22,7 +22,8 @@
* @file templates/touchpadXXX/touchpad_lld.c
* @brief Touchpad Driver subsystem low level driver source.
*
* @addtogroup TOUCHPAD
* @defgroup touchpadXXX
* @ingroup DRIVERS
* @{
*/