diff --git a/drivers/include/adcxx1c.h b/drivers/include/adcxx1c.h index 382858cfde..d33fd74919 100644 --- a/drivers/include/adcxx1c.h +++ b/drivers/include/adcxx1c.h @@ -10,13 +10,13 @@ * @defgroup drivers_adcxx1x ADCXX1C ADC device driver * @ingroup drivers_sensors * @brief I2C Analog-to-Digital Converter device driver + * + * This driver works with adc081c, adc101c and adc121c versions. * @{ * * @file * @brief ADCXX1C ADC device driver * - * This driver works with adc081c, adc101c and adc121c versions. - * * @author Vincent Dupont */ diff --git a/drivers/include/bmp180.h b/drivers/include/bmp180.h index 926c83a030..5e888d5203 100644 --- a/drivers/include/bmp180.h +++ b/drivers/include/bmp180.h @@ -7,9 +7,9 @@ */ /** - * @defgroup drivers_bmp180 BMP180 + * @defgroup drivers_bmp180 BMP180 temperature and pressure sensor * @ingroup drivers_sensors - * @brief Device driver interface for the BMP180 sensor + * @brief Device driver interface for the BMP180 sensor. * @{ * * @file diff --git a/drivers/include/bmx280.h b/drivers/include/bmx280.h index 12de4a94e1..541114162e 100644 --- a/drivers/include/bmx280.h +++ b/drivers/include/bmx280.h @@ -8,9 +8,16 @@ */ /** - * @defgroup drivers_bmx280 BMX280 + * @defgroup drivers_bmx280 BMP280/BME280 temperature, pressure and humidity sensor * @ingroup drivers_sensors - * @brief Device driver interface for the BMX280 sensors (BMP280 and BME280). + * @brief Device driver interface for the Bosch BMP280 and BME280 sensors. + * + * BMP280 and BME280 measure temperature in centi °C and pressure in Pa. BME280 + * can also measure relative humidity in %. + * + * For more information, see the datasheets: + * * [BMP280](https://ae-bst.resource.bosch.com/media/_tech/media/datasheets/BST-BMP280-DS001-18.pdf) + * * [BME280](https://ae-bst.resource.bosch.com/media/_tech/media/datasheets/BST-BME280_DS001-11.pdf) * * @{ * @file diff --git a/drivers/include/cc110x.h b/drivers/include/cc110x.h index 63c1fdda6f..156a5c52a8 100644 --- a/drivers/include/cc110x.h +++ b/drivers/include/cc110x.h @@ -8,9 +8,9 @@ */ /** - * @defgroup drivers_cc110x CC110x + * @defgroup drivers_cc110x CC1100/CC1101 radio driver * @ingroup drivers_netdev - * @brief TI CC110x + * @brief Driver for TI CC1100/CC1101 radios * @{ * @file * @brief Public interface for cc110x driver diff --git a/drivers/include/cc2420.h b/drivers/include/cc2420.h index 9c02d90bd4..c0e50108ef 100644 --- a/drivers/include/cc2420.h +++ b/drivers/include/cc2420.h @@ -7,7 +7,7 @@ */ /** - * @defgroup drivers_cc2420 CC2420 driver + * @defgroup drivers_cc2420 CC2420 radio driver * @ingroup drivers_netdev * @{ * diff --git a/drivers/include/io1_xplained.h b/drivers/include/io1_xplained.h index 278db2a30f..c6737186d2 100644 --- a/drivers/include/io1_xplained.h +++ b/drivers/include/io1_xplained.h @@ -7,13 +7,30 @@ */ /** - * @defgroup drivers_io1_xplained IO1_XPLAINED + * @defgroup drivers_io1_xplained Atmel IO1 Xplained Extension board * @ingroup drivers_sensors - * @brief Device driver interface for the IO1 Xplained extension. + * @brief Device driver interface for the Atmel IO1 Xplained extension. + * + * This board contains several sensors and actuators: + * * @ref drivers_at30tse75x + * * TEMT6000 Light sensor (not yet supported by this driver) + * * microSD card connector (not yet supported by this driver) + * * one yellow LED + * * 2 GPIO pins + * + * This board can be used with the following Atmel evaluation boards: + * * @ref boards_samr21-xpro + * * @ref boards_samd21-xpro + * * @ref boards_saml21-xpro + * + * See the [datasheet] + * (http://www.atmel.com/images/atmel-42078-io1-xplained-pro_user-guide.pdf) + * for more information + * * @{ * * @file - * @brief Device driver interface for the IO1 Xplained extention. + * @brief Device driver interface for the Atmel IO1 Xplained extention. * * @author Alexandre Abadie */ diff --git a/drivers/include/led.h b/drivers/include/led.h index 09fa19f7d6..a29d5690ae 100644 --- a/drivers/include/led.h +++ b/drivers/include/led.h @@ -8,7 +8,7 @@ /** * @defgroup drivers_led Control on-board LEDs - * @ingroup drivers + * @ingroup drivers_actuators * @brief Access macros to control the on-board LEDs * * This header contains a set of macros for controlling the on-board LEDs of diff --git a/drivers/include/mpu9150.h b/drivers/include/mpu9150.h index 9fc21bf55e..735dd9d20d 100644 --- a/drivers/include/mpu9150.h +++ b/drivers/include/mpu9150.h @@ -7,7 +7,7 @@ */ /** - * @defgroup drivers_mpu9150 MPU-9150 + * @defgroup drivers_mpu9150 MPU-9150 accelerometer/magnetometer/gyroscope * @ingroup drivers_sensors * @brief Device driver interface for the MPU-9150 * @{ diff --git a/drivers/include/sht11.h b/drivers/include/sht11.h index f28f4a7b85..e70d38cb7e 100644 --- a/drivers/include/sht11.h +++ b/drivers/include/sht11.h @@ -10,7 +10,7 @@ #define SHT11_H /** - * @defgroup drivers_sht11 SHT11 + * @defgroup drivers_sht11 SHT11 Humidity and Temperature Sensor * @ingroup drivers_sensors * @brief Driver for Sensirion SHT11 Humidity and Temperature Sensor * @{ diff --git a/drivers/include/si70xx.h b/drivers/include/si70xx.h index 36533e382f..498b98a09d 100644 --- a/drivers/include/si70xx.h +++ b/drivers/include/si70xx.h @@ -7,7 +7,7 @@ */ /** - * @defgroup driver_si70xx Si70xx + * @defgroup driver_si70xx Si7006/13/20/21 temperature and humidity sensors * @ingroup drivers_sensors * @brief Driver for the Si7006/13/20/21 temperature and humidity sensor. * @{ diff --git a/drivers/include/srf02.h b/drivers/include/srf02.h index 1a584a5d0a..f71c618168 100644 --- a/drivers/include/srf02.h +++ b/drivers/include/srf02.h @@ -8,7 +8,7 @@ */ /** - * @defgroup driver_srf02 SRF02 + * @defgroup driver_srf02 SRF02 ultrasonic range sensor * @ingroup drivers_sensors * @brief Driver for the SRF02 ultrasonic range sensor * @{ diff --git a/drivers/include/sx127x.h b/drivers/include/sx127x.h index f3a45acb20..06eb1450fb 100644 --- a/drivers/include/sx127x.h +++ b/drivers/include/sx127x.h @@ -8,9 +8,9 @@ */ /** - * @defgroup drivers_sx127x SX127X + * @defgroup drivers_sx127x Semtech SX1272 and SX1276 radios driver * @ingroup drivers_netdev - * @brief Semtech SX127X driver (SX1272 and SX1276) + * @brief Driver for Semtech SX1272 and SX1276 radios. * * This module contains the driver for radio devices of the Semtech SX127x * series (SX1272 and SX1276). diff --git a/drivers/include/tsl2561.h b/drivers/include/tsl2561.h index d824337be0..e2f7cef37f 100644 --- a/drivers/include/tsl2561.h +++ b/drivers/include/tsl2561.h @@ -7,9 +7,9 @@ */ /** - * @defgroup drivers_tsl2561 TSL2561 + * @defgroup drivers_tsl2561 TSL2561 illuminance sensor * @ingroup drivers_sensors - * @brief Device driver interface for the illuminance TSL2561 sensor + * @brief Device driver interface for the illuminance TSL2561 sensor * @{ * * @file diff --git a/drivers/include/veml6070.h b/drivers/include/veml6070.h index dff261852a..d1c12f0f8a 100644 --- a/drivers/include/veml6070.h +++ b/drivers/include/veml6070.h @@ -7,7 +7,7 @@ */ /** - * @defgroup drivers_veml6070 VEML6070 + * @defgroup drivers_veml6070 VEML6070 UV sensor * @ingroup drivers_sensors * @brief Device driver interface for the VEML6070 UV sensor * @{ diff --git a/drivers/include/w5100.h b/drivers/include/w5100.h index 361bd2f048..ce2e07887b 100644 --- a/drivers/include/w5100.h +++ b/drivers/include/w5100.h @@ -7,7 +7,7 @@ */ /** - * @defgroup drivers_w5100 W5100 + * @defgroup drivers_w5100 W5100 ethernet driver * @ingroup drivers_netdev * @brief Driver for W5100 ethernet devices * diff --git a/drivers/io1_xplained/include/io1_xplained_internals.h b/drivers/io1_xplained/include/io1_xplained_internals.h index 3fb6a5ce68..fbdcaec3e5 100644 --- a/drivers/io1_xplained/include/io1_xplained_internals.h +++ b/drivers/io1_xplained/include/io1_xplained_internals.h @@ -7,8 +7,7 @@ */ /** - * @defgroup drivers_io1_xplained IO1_XPLAINED - * @ingroup drivers_sensors + * @ingroup drivers_io1_xplained * @brief Internal addresses, constants for the IO1 Xplained extension. * @{ *