diff --git a/boards/airfy-beacon/include/board.h b/boards/airfy-beacon/include/board.h
index 1e0687742a37a050a716de5c424dabce5c28dec2..a813dafa1e9724f06a62a4e3c151e6b1fefb64a3 100644
--- a/boards/airfy-beacon/include/board.h
+++ b/boards/airfy-beacon/include/board.h
@@ -28,7 +28,7 @@
#endif
/**
- * @brief Xtimer configuration
+ * @name Xtimer configuration
* @{
*/
#define XTIMER_DEV (0)
@@ -38,7 +38,7 @@
/** @} */
/**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
diff --git a/boards/airfy-beacon/include/periph_conf.h b/boards/airfy-beacon/include/periph_conf.h
index 0d9a1bf56634443d7237aa25c4cbad7c4c8586e4..4831b6b82464c57ee0146ad87f8454c5cf5358cd 100644
--- a/boards/airfy-beacon/include/periph_conf.h
+++ b/boards/airfy-beacon/include/periph_conf.h
@@ -43,7 +43,7 @@
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
static const timer_conf_t timer_config[] = {
@@ -57,9 +57,9 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
*
- * The CPU only supports one UART device, so we keep it simple
+ * The CPU only supports one UART device, so we keep it simple
* @{
*/
#define UART_NUMOF (1U)
@@ -78,7 +78,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
* @{
*/
static const spi_conf_t spi_config[] = {
@@ -94,7 +94,7 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name I2C (TWI) configuration
+ * @name I2C (TWI) configuration
* @{
*/
static const i2c_conf_t i2c_config[] = {
@@ -116,7 +116,7 @@ static const i2c_conf_t i2c_config[] = {
/** @} */
/**
- * @name ADC configuration
+ * @name ADC configuration
*
* The configuration consists simply of a list of channels that should be used
* @{
@@ -126,7 +126,7 @@ static const i2c_conf_t i2c_config[] = {
/** @} */
/**
- * @name Radio device configuration
+ * @name Radio device configuration
*
* The radio is not guarded by a NUMOF define, as the radio is selected by its
* own module in the build system.
diff --git a/boards/arduino-atmega-common/include/board.h b/boards/arduino-atmega-common/include/board.h
index 256e732d4afaf10babb97cd68fae637e1bbad63a..4ac9984b96f784e0871c4e39576e2cec8c825daf 100644
--- a/boards/arduino-atmega-common/include/board.h
+++ b/boards/arduino-atmega-common/include/board.h
@@ -33,15 +33,17 @@ extern "C" {
#endif
/**
- * @brief As the CPU is too slow to handle 115200 baud, we set the default
- * baudrate to 9600 for this board
+ * @name STDIO configuration
+ *
+ * As the CPU is too slow to handle 115200 baud, we set the default
+ * baudrate to 9600 for this board
* @{
*/
#define UART_STDIO_BAUDRATE (9600U)
/** @} */
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#ifdef CPU_ATMEGA328P
@@ -60,10 +62,11 @@ extern "C" {
/** @} */
/**
- ** Context swap defines
- ** Setup to use PC5 which is pin change interrupt 13 (PCINT13)
- ** This emulates a software triggered interrupt
- ***/
+ * @brief Context swap defines
+ *
+ * Setup to use PC5 which is pin change interrupt 13 (PCINT13)
+ * This emulates a software triggered interrupt
+ */
#ifdef CPU_ATMEGA328P
#define AVR_CONTEXT_SWAP_INIT do { \
DDRC |= (1 << PC5); \
@@ -85,7 +88,7 @@ extern "C" {
#endif
/**
- * @brief xtimer configuration values
+ * @name xtimer configuration values
* @{
*/
#define XTIMER_WIDTH (16)
@@ -95,7 +98,7 @@ extern "C" {
/** @} */
/**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
diff --git a/boards/arduino-atmega-common/include/periph_conf.h b/boards/arduino-atmega-common/include/periph_conf.h
index a485208392799cc7ec056ec79a19fba6d198929b..2f3c9e2c06b86099d9213f21024aef0ddee4fe4f 100644
--- a/boards/arduino-atmega-common/include/periph_conf.h
+++ b/boards/arduino-atmega-common/include/periph_conf.h
@@ -28,14 +28,14 @@ extern "C" {
#endif
/**
- * @brief Clock configuration
+ * @name Clock configuration
* @{
*/
#define CLOCK_CORECLOCK (16000000L)
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
*
* arduino uno and arduino duemilanove:
* The timer driver only supports the 16-bit timer (Timer1)
@@ -74,12 +74,10 @@ extern "C" {
#define TIMER_1_ISRB TIMER4_COMPB_vect
#define TIMER_1_ISRC TIMER4_COMPC_vect
#endif
-
-
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
*
* The UART devices have fixed pin mappings, so all we need to do, is to specify
* which devices we would like to use and their corresponding RX interrupts. See
@@ -112,7 +110,7 @@ extern "C" {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
*
* The atmega2560 has only one hardware SPI with fixed pin configuration, so all
* we can do here, is to enable or disable it...
diff --git a/boards/arduino-due/include/arduino_pinmap.h b/boards/arduino-due/include/arduino_pinmap.h
index 2ce455bc29c1bef691adc7546ccafb5613ef67c9..85f080bd38d03163c973e4794335d664be2372f4 100644
--- a/boards/arduino-due/include/arduino_pinmap.h
+++ b/boards/arduino-due/include/arduino_pinmap.h
@@ -29,7 +29,7 @@ extern "C" {
#endif
/**
- * @brief Mapping of MCU pins to Arduino pins
+ * @name Mapping of MCU pins to Arduino pins
* @{
*/
#define ARDUINO_PIN_0 GPIO_PIN(PA, 8)
diff --git a/boards/arduino-due/include/sdcard_spi_params.h b/boards/arduino-due/include/sdcard_spi_params.h
index 0cd2a1e4c19ff3e5ac34021a29366e5c19ee9791..cd3c77eb2bb424fa709147f3e8085dc496dc2709 100644
--- a/boards/arduino-due/include/sdcard_spi_params.h
+++ b/boards/arduino-due/include/sdcard_spi_params.h
@@ -28,7 +28,7 @@ extern "C" {
#endif
/**
- * @brief Set default configuration parameters for the sdcard_spi driver
+ * @name Default configuration for the sdcard_spi driver
* @{
*/
#ifndef SDCARD_SPI_PARAM_SPI
@@ -69,7 +69,6 @@ static const sdcard_spi_params_t sdcard_spi_params[] = {
.power_act_high = SDCARD_SPI_PARAM_POWER_AH
},
};
-/** @} */
#ifdef __cplusplus
}
diff --git a/boards/arduino-due/include/w5100_params.h b/boards/arduino-due/include/w5100_params.h
index 7eefa13bade2736e7e78b8a081fa9cfa977c25b9..fbd550fa851880ef9810cec602a17bf247167a1e 100644
--- a/boards/arduino-due/include/w5100_params.h
+++ b/boards/arduino-due/include/w5100_params.h
@@ -24,7 +24,7 @@ extern "C" {
#endif
/**
- * @brief Set configuration parameters for the W5100 driver
+ * @name Configuration parameters for the W5100 driver
* @{
*/
#ifndef W5100_PARAM_SPI
@@ -52,7 +52,6 @@ static const w5100_params_t w5100_params[] = {
.evt = W5100_PARAM_EVT
},
};
-/** @} */
#ifdef __cplusplus
}
diff --git a/boards/arduino-zero/include/arduino_pinmap.h b/boards/arduino-zero/include/arduino_pinmap.h
index 02a4f22136ec98a32c751184d1f506ab91d4fe60..77d7310fbbba0755a97deef479ab955a93b2e41c 100644
--- a/boards/arduino-zero/include/arduino_pinmap.h
+++ b/boards/arduino-zero/include/arduino_pinmap.h
@@ -29,7 +29,7 @@ extern "C" {
#endif
/**
- * @brief Mapping of MCU pins to Arduino pins
+ * @name Mapping of MCU pins to Arduino pins
* @{
*/
#define ARDUINO_PIN_0 GPIO_PIN(PA, 11)
diff --git a/boards/arduino-zero/include/board.h b/boards/arduino-zero/include/board.h
index 753ca5c1be54c7d45f02015ec3f4b10ca3a4c87a..c4ba1c9f8d1e538d3d16cda6df4ce9d895a4f2ad 100644
--- a/boards/arduino-zero/include/board.h
+++ b/boards/arduino-zero/include/board.h
@@ -32,7 +32,7 @@ extern "C" {
#endif
/**
- * @brief xtimer configuration
+ * @name xtimer configuration
* @{
*/
#define XTIMER TIMER_0
@@ -40,7 +40,7 @@ extern "C" {
/** @} */
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(PA, 17)
@@ -54,7 +54,7 @@ extern "C" {
/** @} */
/**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
diff --git a/boards/avsextrem/include/board.h b/boards/avsextrem/include/board.h
index 3fe0fe6bfd4728d6d7d84b3dccb9cc4fc2a4072d..81c523c7283b5155108baa966d3ec4d2942158d6 100644
--- a/boards/avsextrem/include/board.h
+++ b/boards/avsextrem/include/board.h
@@ -32,7 +32,7 @@ extern "C" {
#endif
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(2, 25)
@@ -51,7 +51,7 @@ extern "C" {
/** @} */
/**
- * @brief Initialize the board's clock system
+ * @brief Initialize the board's clock system
*/
void init_clks1(void);
diff --git a/boards/avsextrem/include/periph_conf.h b/boards/avsextrem/include/periph_conf.h
index 15a7bccbb4de8a1009022124a76faabff19b0e2f..a0851e9ddba633dffd9b9a86b76a77f303bfa7c2 100644
--- a/boards/avsextrem/include/periph_conf.h
+++ b/boards/avsextrem/include/periph_conf.h
@@ -26,7 +26,7 @@ extern "C" {
#endif
/**
- * @name Clock configuration
+ * @name Clock configuration
* @{
*/
#define CLOCK_CORECLOCK (72000000U) /* this board runs with 72MHz */
@@ -35,20 +35,20 @@ extern "C" {
/** @} */
/**
- * @name Timer configuration, select a number from 1 to 4
+ * @name Timer configuration, select a number from 1 to 4
* @{
*/
#define TIMER_NUMOF (1U)
/** @} */
/**
- * @name Real Time Clock configuration
+ * @name Real Time Clock configuration
*/
#define RTC_NUMOF (1U)
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
#define UART_NUMOF (1U)
@@ -56,7 +56,7 @@ extern "C" {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
* @{
*/
#define SPI_NUMOF (1U)
diff --git a/boards/calliope-mini/include/board.h b/boards/calliope-mini/include/board.h
index f9036e4331864a002f07aca4a3281a25116ee316..aa890627da4cfa7632f2630ef60703acf2f19dfa 100644
--- a/boards/calliope-mini/include/board.h
+++ b/boards/calliope-mini/include/board.h
@@ -29,7 +29,7 @@ extern "C" {
#endif
/**
- * @brief Xtimer configuration
+ * @name Xtimer configuration
* @{
*/
#define XTIMER_DEV (0)
@@ -39,7 +39,7 @@ extern "C" {
/** @} */
/**
- * @brief LED matrix pin configuration
+ * @name LED matrix pin configuration
* @{
*/
#define MINI_LED_COL1 GPIO_PIN(0, 4)
@@ -57,7 +57,7 @@ extern "C" {
/** @} */
/**
- * @brief Button configuration
+ * @name Button configuration
* @{
*/
#define BTN0_PIN GPIO_PIN(0, 17)
diff --git a/boards/calliope-mini/include/periph_conf.h b/boards/calliope-mini/include/periph_conf.h
index c9146207d4bca15e180bb77f29c7443468654a2f..4680d07cb3a82acca5f25822751ba729825bc43c 100644
--- a/boards/calliope-mini/include/periph_conf.h
+++ b/boards/calliope-mini/include/periph_conf.h
@@ -42,7 +42,7 @@ extern "C" {
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
static const timer_conf_t timer_config[] = {
@@ -84,7 +84,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
#define UART_NUMOF (1U)
@@ -95,7 +95,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @name I2C (TWI) configuration
+ * @name I2C (TWI) configuration
* @{
*/
static const i2c_conf_t i2c_config[] = {
@@ -111,7 +111,7 @@ static const i2c_conf_t i2c_config[] = {
/** @} */
/**
- * @name ADC configuration
+ * @name ADC configuration
*
* The configuration consists simply of a list of channels that should be used
* @{
@@ -120,7 +120,7 @@ static const i2c_conf_t i2c_config[] = {
/** @} */
/**
- * @brief Radio device configuration
+ * @name Radio device configuration
*
* The radio is not guarded by a NUMOF define, as the radio is selected by its
* own module in the build system.
diff --git a/boards/cc2538dk/include/board.h b/boards/cc2538dk/include/board.h
index d0dcc5dacc23f507534aece6aee3f29d5a1e7abc..c8bb16478578f3b09832fb4fc4a25e1f72c11710 100644
--- a/boards/cc2538dk/include/board.h
+++ b/boards/cc2538dk/include/board.h
@@ -28,7 +28,7 @@ extern "C" {
#endif
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(2, 0)
@@ -60,10 +60,9 @@ extern "C" {
/** @} */
/**
- * @name Flash Customer Configuration Area (CCA) parameters
+ * @name Flash Customer Configuration Area (CCA) parameters
* @{
*/
-
#ifndef UPDATE_CCA
#define UPDATE_CCA 1
#endif
@@ -74,7 +73,7 @@ extern "C" {
/** @} */
/**
- * @name xtimer configuration
+ * @name xtimer configuration
* @{
*/
#define XTIMER_DEV (0)
@@ -87,7 +86,7 @@ extern "C" {
/** @} */
/**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
diff --git a/boards/cc2650stk/include/board.h b/boards/cc2650stk/include/board.h
index 92be45b5002ba91208229dbae7d57e558472839c..a265863f23758458c57fe23455e578e7ff563b5d 100644
--- a/boards/cc2650stk/include/board.h
+++ b/boards/cc2650stk/include/board.h
@@ -28,14 +28,14 @@ extern "C" {
#endif
/**
- * @brief Xtimer configuration
+ * @name Xtimer configuration
* @{
*/
#define XTIMER_WIDTH (16)
/** @} */
/**
- * @brief On-board button configuration
+ * @name On-board button configuration
* @{
*/
#define BUTTON1_DIO GPIO_PIN(0, 4)
@@ -43,7 +43,7 @@ extern "C" {
/** @} */
/**
- * @brief Macros for controlling the on-board LEDs
+ * @name Macros for controlling the on-board LEDs
* @{
*/
#define LED0_PIN GPIO_PIN(0, 10)
diff --git a/boards/cc2650stk/include/periph_conf.h b/boards/cc2650stk/include/periph_conf.h
index 6b15cf439428eed8b295bf4e59f5d5f13ec66aaa..d502f3111a9abaa45a7ddf271fb6c69f33ca6ae1 100644
--- a/boards/cc2650stk/include/periph_conf.h
+++ b/boards/cc2650stk/include/periph_conf.h
@@ -26,7 +26,7 @@ extern "C" {
#endif
/**
- * @brief Clock configuration
+ * @name Clock configuration
* @{
*/
/* the main clock is fixed to 48MHZ */
@@ -34,7 +34,7 @@ extern "C" {
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
static const timer_conf_t timer_config[] = {
@@ -55,7 +55,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
*
* The used CC26x0 CPU only supports a single UART device, so all we need to
* configure are the RX and TX pins.
diff --git a/boards/chronos/include/board.h b/boards/chronos/include/board.h
index 01cb494de6fae436449490b56222ebe14b87316e..dce97b73adb0169237e548980503e8696813e025 100644
--- a/boards/chronos/include/board.h
+++ b/boards/chronos/include/board.h
@@ -15,7 +15,7 @@
* @file
* @brief Header for the chronos board
*
- * @author unknwon
+ * @author unknown
*/
#ifndef CHRONOS_BOARD_H
@@ -28,14 +28,14 @@ extern "C" {
#endif
/**
- * @brief Define the CPU model for the <msp430.h>
+ * @name Define the CPU model for the <msp430.h>
*/
#ifndef __CC430F6137__
#define __CC430F6137__
#endif
/**
- * @brief Xtimer configuration
+ * @name Xtimer configuration
* @{
*/
#define XTIMER_DEV (0)
@@ -44,9 +44,10 @@ extern "C" {
/** @} */
/**
- * @brief MSP430 core configuration
+ * @name MSP430 core configuration
* @{
*/
+/** @todo Move this to the periph_conf.h */
#define MSP430_INITIAL_CPU_SPEED 7372800uL
#define F_CPU MSP430_INITIAL_CPU_SPEED
#define F_RC_OSCILLATOR 32768
@@ -58,5 +59,5 @@ extern "C" {
}
#endif
-#endif /* _CHRONOS_BOARD_H */
+#endif /* CHRONOS_BOARD_H */
/** @} */
diff --git a/boards/chronos/include/periph_conf.h b/boards/chronos/include/periph_conf.h
index aad43225f312a1c4b86deaafd9348c9c9a45101e..1f777acd8ca2602aaf570ea2a6d78fdf1b630f40 100644
--- a/boards/chronos/include/periph_conf.h
+++ b/boards/chronos/include/periph_conf.h
@@ -26,17 +26,17 @@ extern "C" {
#endif
/**
- * @brief Clock configuration
- *
- * @todo Move all clock configuration code here from the board.h
+ * @name Clock configuration
+ * @{
*/
+/** @todo Move all clock configuration code here from the board.h */
#define CLOCK_CORECLOCK (12000000U)
#define CLOCK_CMCLK CLOCK_CORECLOCK /* no divider programmed */
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
#define TIMER_NUMOF (1U)
@@ -47,7 +47,7 @@ extern "C" {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
#define UART_NUMOF (1U)
@@ -68,9 +68,11 @@ extern "C" {
/** @} */
/**
- * @brief Real Time Clock configuration
+ * @name Real Time Clock configuration
+ * @{
*/
#define RTC_NUMOF (1)
+/** @} */
#ifdef __cplusplus
}
diff --git a/boards/ek-lm4f120xl/include/board.h b/boards/ek-lm4f120xl/include/board.h
index 5a69618d65fa042aa37d9c108508873c2865a1a8..118be9dca3cd8971daacabae0afc224d7bc646e8 100644
--- a/boards/ek-lm4f120xl/include/board.h
+++ b/boards/ek-lm4f120xl/include/board.h
@@ -30,7 +30,7 @@ extern "C" {
#endif
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(5, 7)
@@ -56,7 +56,7 @@ extern "C" {
/* @} */
/**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
extern void board_init(void);
diff --git a/boards/f4vi1/include/board.h b/boards/f4vi1/include/board.h
index 28ac4932dcaba88166b6bd6c8f2198caa5a6dc21..6296a0e5b03ce934cbcb9bac7cbe6c6d5a9585d9 100644
--- a/boards/f4vi1/include/board.h
+++ b/boards/f4vi1/include/board.h
@@ -30,7 +30,7 @@ extern "C" {
#endif
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(PORT_A, 1)
@@ -56,7 +56,7 @@ extern "C" {
/** @} */
/**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
diff --git a/boards/f4vi1/include/periph_conf.h b/boards/f4vi1/include/periph_conf.h
index a3b524d3658fdd31b2bf22fd8ed17da39d7ad22f..eca25a7f68c0acb55073b06cfa4ca9a2fde224f8 100644
--- a/boards/f4vi1/include/periph_conf.h
+++ b/boards/f4vi1/include/periph_conf.h
@@ -28,7 +28,7 @@ extern "C" {
#endif
/**
- * @name Clock system configuration
+ * @name Clock system configuration
* @{
*/
#define CLOCK_HSE (16000000U) /* external oscillator */
@@ -51,7 +51,7 @@ extern "C" {
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
static const timer_conf_t timer_config[] = {
@@ -78,7 +78,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
static const uart_conf_t uart_config[] = {
@@ -105,14 +105,14 @@ static const uart_conf_t uart_config[] = {
/** @} */
/**
- * @name ADC configuration
+ * @name ADC configuration
* @{
*/
#define ADC_NUMOF (0)
/** @} */
/**
- * @name DAC configuration
+ * @name DAC configuration
* @{
*/
#define DAC_NUMOF (0)
diff --git a/boards/fox/include/board.h b/boards/fox/include/board.h
index d87e492d07cbbb1c8264fef368edbdf5a2b972d6..bac3ecefc9b5391745be169df3b1d8545f140d09 100644
--- a/boards/fox/include/board.h
+++ b/boards/fox/include/board.h
@@ -34,12 +34,16 @@ extern "C" {
#endif
/**
- * @name Tell the xtimer that we use a 16-bit peripheral timer
+ * @name Xtimer configuration
+ *
+ * Tell the xtimer that we use a 16-bit peripheral timer
+ * @{
*/
#define XTIMER_WIDTH (16)
+/** @} */
/**
- * @name Define the interface to the AT86RF231 radio
+ * @brief Define the interface to the AT86RF231 radio
*
* {spi bus, spi speed, cs pin, int pin, reset pin, sleep pin}
*/
@@ -51,7 +55,7 @@ extern "C" {
.reset_pin = GPIO_PIN(PORT_C, 1)}
/**
- * @name Define the interface to the LPS331AP pressure sensor
+ * @name Define the interface to the LPS331AP pressure sensor
* @{
*/
#define LPS331AP_I2C I2C_0
@@ -59,7 +63,7 @@ extern "C" {
/** @} */
/**
- * @name Define the interface for the L3G4200D gyroscope
+ * @name Define the interface for the L3G4200D gyroscope
* @{
*/
#define L3G4200D_I2C I2C_0
@@ -69,7 +73,7 @@ extern "C" {
/** @} */
/**
- * @name Define the interface to the LSM303DLHC accelerometer and magnetometer
+ * @name Define the interface to the LSM303DLHC accelerometer and magnetometer
* @{
*/
#define LSM303DLHC_I2C I2C_0
@@ -81,7 +85,7 @@ extern "C" {
/** @} */
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(PORT_B, 10)
@@ -100,7 +104,7 @@ extern "C" {
/** @} */
/**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
diff --git a/boards/fox/include/periph_conf.h b/boards/fox/include/periph_conf.h
index 65c3e24613555f22700076e635c3f9fbcb209144..b2893ac7eacb9967f55154f0df774870f097b54e 100644
--- a/boards/fox/include/periph_conf.h
+++ b/boards/fox/include/periph_conf.h
@@ -26,7 +26,7 @@ extern "C" {
#endif
/**
- * @name Clock system configuration
+ * @name Clock system configuration
* @{
**/
#define CLOCK_HSE (16000000U) /* frequency of external oscillator */
@@ -45,21 +45,21 @@ extern "C" {
/** @} */
/**
- * @name ADC configuration
+ * @name ADC configuration
* @{
*/
#define ADC_NUMOF (0)
/** @} */
/**
- * @name DAC configuration
+ * @name DAC configuration
* @{
*/
#define DAC_NUMOF (0)
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
static const timer_conf_t timer_config[] = {
@@ -86,7 +86,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
static const uart_conf_t uart_config[] = {
@@ -115,7 +115,7 @@ static const uart_conf_t uart_config[] = {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
*
* @note The spi_divtable is auto-generated from
* `cpu/stm32_common/dist/spi_divtable/spi_divtable.c`
@@ -154,7 +154,7 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name Real time counter configuration
+ * @name Real time counter configuration
* @{
*/
#define RTT_NUMOF (1U)
@@ -169,7 +169,7 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name I2C configuration
+ * @name I2C configuration
* @{
*/
#define I2C_NUMOF (1U)
diff --git a/boards/frdm-k64f/include/board.h b/boards/frdm-k64f/include/board.h
index c9fcd2faef92153d4c0decc27e665b3844e42977..08e5a5e22ebafbdf8bd08e31a59bacb3021b3b55 100644
--- a/boards/frdm-k64f/include/board.h
+++ b/boards/frdm-k64f/include/board.h
@@ -31,7 +31,7 @@ extern "C"
#endif
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(PORT_B, 22)
@@ -56,7 +56,7 @@ extern "C"
/** @} */
/**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
diff --git a/boards/iotlab-common/include/board_common.h b/boards/iotlab-common/include/board_common.h
index f0161d7b8484866fe0a7810d5605a19988573866..3ff17b1ed64e0455516ca6a66ed5b0732a1135de 100644
--- a/boards/iotlab-common/include/board_common.h
+++ b/boards/iotlab-common/include/board_common.h
@@ -35,7 +35,7 @@ extern "C" {
#endif
/**
- * @name Set the default baudrate to 500K for this board
+ * @name Set the default baudrate to 500K for this board
* @{
*/
#ifndef UART_STDIO_BAUDRATE
@@ -44,12 +44,18 @@ extern "C" {
/** @} */
/**
- * @name Tell the xtimer that we use a 16-bit peripheral timer
+ * @name Xtimer configuration
+ *
+ * Tell the xtimer that we use a 16-bit peripheral timer
+ * @{
*/
-#define XTIMER_WIDTH (16)
+#define XTIMER_WIDTH (16U)
+#define XTIMER_OVERHEAD (6U)
+#define XTIMER_SHOOT_EARLY (3U)
+/** @} */
/**
- * @name Define the interface to the AT86RF231 radio
+ * @brief Define the interface to the AT86RF231 radio
*
* {spi bus, spi speed, cs pin, int pin, reset pin, sleep pin}
*/
@@ -61,7 +67,7 @@ extern "C" {
.reset_pin = GPIO_PIN(PORT_C, 1)}
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(PORT_D, 2)
@@ -86,15 +92,7 @@ extern "C" {
/** @} */
/**
- * @name xtimer tuning values
- * @{
- */
-#define XTIMER_OVERHEAD 6
-#define XTIMER_SHOOT_EARLY 3
-/** @} */
-
-/**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
diff --git a/boards/iotlab-common/include/periph_conf_common.h b/boards/iotlab-common/include/periph_conf_common.h
index 0e5f556a93f541e7d331478d916e527491d8e6b6..6c39347d25afe3fc224c58991d7ea487162fccbf 100644
--- a/boards/iotlab-common/include/periph_conf_common.h
+++ b/boards/iotlab-common/include/periph_conf_common.h
@@ -27,7 +27,7 @@ extern "C" {
#endif
/**
- * @name Clock system configuration
+ * @name Clock system configuration
* @{
**/
#define CLOCK_HSE (16000000U) /* frequency of external oscillator */
@@ -48,7 +48,7 @@ extern "C" {
/** @} */
/**
- * @name ADC configuration
+ * @name ADC configuration
* @{
*/
#define ADC_CONFIG { \
@@ -60,7 +60,7 @@ extern "C" {
/** @} */
/**
- * @brief Timer configuration
+ * @name Timer configuration
* @{
*/
static const timer_conf_t timer_config[] = {
@@ -87,7 +87,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @brief UART configuration
+ * @name UART configuration
* @{
*/
static const uart_conf_t uart_config[] = {
@@ -116,14 +116,14 @@ static const uart_conf_t uart_config[] = {
/** @} */
/**
- * @name DAC configuration
+ * @name DAC configuration
* @{
*/
#define DAC_NUMOF (0)
/** @} */
/**
- * @name Real time counter configuration
+ * @name Real time counter configuration
* @{
*/
#define RTT_NUMOF (1U)
@@ -138,7 +138,7 @@ static const uart_conf_t uart_config[] = {
/** @} */
/**
- * @name I2C configuration
+ * @name I2C configuration
* @{
*/
#define I2C_NUMOF (1U)
diff --git a/boards/limifrog-v1/include/board.h b/boards/limifrog-v1/include/board.h
index 8b2900a137cfaf2f4c9302419f6bf6dcd985e9df..5a77a8b4833180f4599710761c1f3587f565d4eb 100644
--- a/boards/limifrog-v1/include/board.h
+++ b/boards/limifrog-v1/include/board.h
@@ -31,7 +31,7 @@ extern "C" {
#endif
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(PORT_C, 3)
@@ -45,7 +45,7 @@ extern "C" {
/** @} */
/**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
diff --git a/boards/limifrog-v1/include/periph_conf.h b/boards/limifrog-v1/include/periph_conf.h
index 0762a4b8475e22cc6ee07ec7b4781da8fd2e2c02..ca761b300df9e206971869d8399828ab937caf61 100644
--- a/boards/limifrog-v1/include/periph_conf.h
+++ b/boards/limifrog-v1/include/periph_conf.h
@@ -26,7 +26,7 @@ extern "C" {
#endif
/**
- * @name Clock system configuration
+ * @name Clock system configuration
* @{
**/
#define CLOCK_HSI (16000000U) /* internal oscillator */
@@ -50,14 +50,14 @@ extern "C" {
/** @} */
/**
- * @name DAC configuration
+ * @name DAC configuration
* @{
*/
#define DAC_NUMOF (0)
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
static const timer_conf_t timer_config[] = {
@@ -76,7 +76,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
static const uart_conf_t uart_config[] = {
@@ -109,7 +109,7 @@ static const uart_conf_t uart_config[] = {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
*
* @note The spi_divtable is auto-generated from
* `cpu/stm32_common/dist/spi_divtable/spi_divtable.c`
@@ -159,7 +159,7 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name I2C configuration
+ * @name I2C configuration
* @{
*/
#define I2C_0_EN 1
diff --git a/boards/mbed_lpc1768/include/board.h b/boards/mbed_lpc1768/include/board.h
index 3cd14468c75ace23ae78cb8db60fd6d3b8d74b0c..473b291a9fc7b649832a96de6a4770a586c3f557 100644
--- a/boards/mbed_lpc1768/include/board.h
+++ b/boards/mbed_lpc1768/include/board.h
@@ -33,7 +33,7 @@ extern "C" {
#endif
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(1, 18)
@@ -62,7 +62,7 @@ extern "C" {
/** @} */
/**
- * @brief Initialize board specific hardware, include clocks, LEDs and stdio
+ * @brief Initialize board specific hardware, include clocks, LEDs and stdio
*/
void board_init(void);
diff --git a/boards/mbed_lpc1768/include/periph_conf.h b/boards/mbed_lpc1768/include/periph_conf.h
index 4240ff0c87e55bebbb1b4dfe6626d0165ee6e01d..ccefcedcfb1b40ce1d2e8980c15864bcf6885512 100644
--- a/boards/mbed_lpc1768/include/periph_conf.h
+++ b/boards/mbed_lpc1768/include/periph_conf.h
@@ -24,7 +24,7 @@ extern "C" {
#endif
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
#define TIMER_NUMOF (1U)
@@ -44,7 +44,7 @@ extern "C" {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
#define UART_NUMOF (2U)
diff --git a/boards/microbit/include/board.h b/boards/microbit/include/board.h
index befff51bb11f4da382013aef2e27bc187129e780..61551cdf5c9708a580d7e6e0e0851eb45c6ae7d5 100644
--- a/boards/microbit/include/board.h
+++ b/boards/microbit/include/board.h
@@ -29,7 +29,7 @@ extern "C" {
#endif
/**
- * @brief Xtimer configuration
+ * @name Xtimer configuration
* @{
*/
#define XTIMER_DEV (0)
@@ -39,7 +39,7 @@ extern "C" {
/** @} */
/**
- * @brief LED matrix pin configuration
+ * @name LED matrix pin configuration
* @{
*/
#define MICROBIT_LED_COL1 GPIO_PIN(0, 4)
@@ -57,7 +57,7 @@ extern "C" {
/** @} */
/**
- * @brief Button configuration
+ * @name Button configuration
* @{
*/
#define BTN0_PIN GPIO_PIN(0, 17)
@@ -65,7 +65,7 @@ extern "C" {
/** @} */
/**
- * @brief MMA8653 accelerometer configuration
+ * @name MMA8653 accelerometer configuration
* @{
*/
#define MMA8653_PARAM_I2C I2C_0,
@@ -73,7 +73,7 @@ extern "C" {
/** @} */
/**
- * @brief MAG3110 magnetometer configuration
+ * @name MAG3110 magnetometer configuration
* @{
*/
#define MAG3110_PARAM_I2C I2C_0,
diff --git a/boards/microbit/include/periph_conf.h b/boards/microbit/include/periph_conf.h
index f6dbb2e618dd436c1b392ef026c8d5fca69a0eb8..804a0cf2268eaae40d227a6a2f125b8f5899722f 100644
--- a/boards/microbit/include/periph_conf.h
+++ b/boards/microbit/include/periph_conf.h
@@ -120,7 +120,7 @@ static const i2c_conf_t i2c_config[] = {
/** @} */
/**
- * @brief Radio device configuration
+ * @name Radio device configuration
*
* The radio is not guarded by a NUMOF define, as the radio is selected by its
* own module in the build system.
diff --git a/boards/mips-malta/include/periph_conf.h b/boards/mips-malta/include/periph_conf.h
index d8dad5660d0ef3ac3e9fc960259ad980d702311f..22af279c8ba7d1225e297d695d34f2bdc32b47ca 100644
--- a/boards/mips-malta/include/periph_conf.h
+++ b/boards/mips-malta/include/periph_conf.h
@@ -28,7 +28,7 @@ extern "C" {
#endif
/**
- * @brief Timer definitions
+ * @name Timer definitions
* @{
*/
#define TIMER_NUMOF (1)
@@ -36,18 +36,18 @@ extern "C" {
/** @} */
/**
- * @brief No UART driver for this board currently
- * Note this value must be set though (to 0)
+ * @brief No UART driver for this board currently
+ * Note this value must be set though (to 0)
*/
#define UART_NUMOF (0)
/**
- * @brief Enable DSP context save + restore.
+ * @brief Enable DSP context save + restore.
*/
#define MIPS_DSP (1)
/**
- * @brief Enable FPU context save + restore.
+ * @brief Enable FPU context save + restore.
*/
#define MIPS_HARD_FLOAT (1)
diff --git a/boards/msb-430-common/include/board_common.h b/boards/msb-430-common/include/board_common.h
index c7e731fac4931fbce42402ad7261e32d05d47d7a..26c76d391999b19a7d7b4d703622b312a0494e63 100644
--- a/boards/msb-430-common/include/board_common.h
+++ b/boards/msb-430-common/include/board_common.h
@@ -34,7 +34,7 @@ extern "C" {
#define INFOMEM (0x1000)
/**
- * @brief Xtimer configuration
+ * @name Xtimer configuration
* @{
*/
#define XTIMER_DEV (0)
@@ -44,7 +44,7 @@ extern "C" {
/** @} */
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(4, 7)
diff --git a/boards/msb-430/include/board.h b/boards/msb-430/include/board.h
index a2e6a9b3cc000e3073952444dffa292975ac5515..c9372e09e3b1ce65e7aea3a794854f0784167b46 100644
--- a/boards/msb-430/include/board.h
+++ b/boards/msb-430/include/board.h
@@ -48,11 +48,10 @@ extern "C" {
#endif
/**
- * @brief CPU core configuration
- *
- * @todo Move this to the periph_conf.h
+ * @name CPU core configuration
* @{
*/
+/** @todo Move this to the periph_conf.h */
#define MSP430_INITIAL_CPU_SPEED 2457600uL
#define F_CPU MSP430_INITIAL_CPU_SPEED
#define F_RC_OSCILLATOR 32768
diff --git a/boards/msb-430/include/periph_conf.h b/boards/msb-430/include/periph_conf.h
index 1026d73e584d7f7718b2a23c76e898981f057f65..d6d05f1e232ba110c583e258658aae2c407bc589 100644
--- a/boards/msb-430/include/periph_conf.h
+++ b/boards/msb-430/include/periph_conf.h
@@ -26,17 +26,17 @@ extern "C" {
#endif
/**
- * @brief Clock configuration
- *
- * @todo Move all clock configuration code here from the board.h
+ * @name Clock configuration
+ * @{
*/
+/** @todo Move all clock configuration code here from the board.h */
#define CLOCK_CORECLOCK (7372800U)
#define CLOCK_CMCLK CLOCK_CORECLOCK /* no divider programmed */
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
#define TIMER_NUMOF (1U)
@@ -47,7 +47,7 @@ extern "C" {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
#define UART_NUMOF (1U)
@@ -68,7 +68,7 @@ extern "C" {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
* @{
*/
#define SPI_NUMOF (1U)
diff --git a/boards/msb-430h/include/board.h b/boards/msb-430h/include/board.h
index 72ea980dc605fad7dfd9003d9034a22043aa60df..6d6f1cbe832bd84ba6f792ae99fc53eb3b59e599 100644
--- a/boards/msb-430h/include/board.h
+++ b/boards/msb-430h/include/board.h
@@ -36,11 +36,10 @@ extern "C" {
#endif
/**
- * @brief CPU core configuration
- *
- * @todo Move this to the periph_conf.h
+ * @name CPU core configuration
* @{
*/
+/** @todo Move this to the periph_conf.h */
#define MSP430_INITIAL_CPU_SPEED 7372800uL
#define F_CPU MSP430_INITIAL_CPU_SPEED
#define F_RC_OSCILLATOR 32768
diff --git a/boards/msb-430h/include/periph_conf.h b/boards/msb-430h/include/periph_conf.h
index 69b52c709f4ee1567989ad1aa65d9a5a8423dae6..a1cd85b5e67e56b582fe89281c875989c7bf54ab 100644
--- a/boards/msb-430h/include/periph_conf.h
+++ b/boards/msb-430h/include/periph_conf.h
@@ -28,17 +28,17 @@ extern "C" {
#endif
/**
- * @brief Clock configuration
- *
- * @todo Move all clock configuration code here from the board.h
+ * @name Clock configuration
+ * @{
*/
+/** @todo Move all clock configuration code here from the board.h */
#define CLOCK_CORECLOCK (7372800U)
#define CLOCK_CMCLK CLOCK_CORECLOCK /* no divider programmed */
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
#define TIMER_NUMOF (1U)
@@ -49,7 +49,7 @@ extern "C" {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
#define UART_NUMOF (1U)
@@ -70,7 +70,7 @@ extern "C" {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
* @{
*/
#define SPI_NUMOF (1U)
diff --git a/boards/msba2/include/board.h b/boards/msba2/include/board.h
index 5f3840ba41acfaeddce46e5c8b98da7b74a546b9..379b1e1f08adb04b0d27d57d863b2793e7fad215 100644
--- a/boards/msba2/include/board.h
+++ b/boards/msba2/include/board.h
@@ -29,7 +29,7 @@ extern "C" {
#endif
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(2, 25)
@@ -48,7 +48,7 @@ extern "C" {
/** @} */
/**
- * @name xtimer tuning values
+ * @name xtimer tuning values
* @{
*/
#define XTIMER_OVERHEAD 7
@@ -56,7 +56,7 @@ extern "C" {
/** @} */
/**
- * @brief initialize the board's clock system
+ * @brief initialize the board's clock system
*/
void init_clks1(void);
diff --git a/boards/msba2/include/periph_conf.h b/boards/msba2/include/periph_conf.h
index 5dcb6a20edc3f5faf0487f3a27adf19f56200f50..b0a9e66692809a8827819609f623d339447ac41f 100644
--- a/boards/msba2/include/periph_conf.h
+++ b/boards/msba2/include/periph_conf.h
@@ -26,7 +26,7 @@ extern "C" {
#endif
/**
- * @brief Clock configuration
+ * @name Clock configuration
* @{
*/
#define CLOCK_CORECLOCK (72000000U) /* the msba2 runs with 72MHz */
@@ -35,7 +35,7 @@ extern "C" {
/** @} */
/**
- * @name Timer configuration, select a number from 1 to 4
+ * @name Timer configuration, select a number from 1 to 4
* @{
*/
#define TIMER_NUMOF (1U)
@@ -46,7 +46,6 @@ extern "C" {
*
* Currently, we only support a single device and 3 channels, the implementation
* is fixed on PWM1.
- *
* @{
*/
#define PWM_NUMOF (1U)
@@ -68,12 +67,14 @@ extern "C" {
/** @} */
/**
- * @brief Real Time Clock configuration
+ * @name Real Time Clock configuration
+ * @{
*/
#define RTC_NUMOF (1)
+/** @} */
/**
- * @brief uart configuration
+ * @name UART configuration
* @{
*/
#define UART_NUMOF (1)
@@ -81,7 +82,7 @@ extern "C" {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
*
* The SPI implementation is very much fixed, so we don't need to configure
* anything besides the mandatory SPI_NUMOF.
diff --git a/boards/msbiot/include/board.h b/boards/msbiot/include/board.h
index 89bfa583a4286eb5b0f6e44fdca563e66239a5d6..2f34317b4cf65dd0bb783f53cb0187e78b384f1d 100644
--- a/boards/msbiot/include/board.h
+++ b/boards/msbiot/include/board.h
@@ -29,7 +29,7 @@ extern "C" {
#endif
/**
- * @name Configure connected CC1101 (radio) device
+ * @name Configure connected CC1101 (radio) device
* @{
*/
#define CC110X_SPI SPI_DEV(0)
@@ -40,7 +40,7 @@ extern "C" {
/** @} */
/**
- * @name Configure connected MPU-9150 device
+ * @name Configure connected MPU-9150 device
* @{
*/
#define MPU9150_I2C I2C_0
@@ -49,7 +49,7 @@ extern "C" {
/** @} */
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(PORT_B, 8)
@@ -75,7 +75,7 @@ extern "C" {
/** @} */
/**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
diff --git a/boards/msbiot/include/periph_conf.h b/boards/msbiot/include/periph_conf.h
index 2dda1f35afba65147d9db057a2b51a6edd54c2d5..eeb4bdf37a290e4aae61e53f3125230985a05f93 100644
--- a/boards/msbiot/include/periph_conf.h
+++ b/boards/msbiot/include/periph_conf.h
@@ -26,7 +26,7 @@ extern "C" {
#endif
/**
- * @name Clock system configuration
+ * @name Clock system configuration
* @{
*/
#define CLOCK_HSE (16000000U) /* external oscillator */
@@ -49,7 +49,7 @@ extern "C" {
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
static const timer_conf_t timer_config[] = {
@@ -96,7 +96,7 @@ static const pwm_conf_t pwm_config[] = {
/** @} */
/**
- * @name ADC configuration
+ * @name ADC configuration
*
* We need to define the following fields:
* PIN, device (ADCx), channel
@@ -111,7 +111,7 @@ static const pwm_conf_t pwm_config[] = {
/** @} */
/**
- * @name DAC configuration
+ * @name DAC configuration
*
* We need to define the following fields:
* PIN, DAC channel
@@ -126,7 +126,7 @@ static const pwm_conf_t pwm_config[] = {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
static const uart_conf_t uart_config[] = {
@@ -187,7 +187,7 @@ static const uart_conf_t uart_config[] = {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
*
* @note The spi_divtable is auto-generated from
* `cpu/stm32_common/dist/spi_divtable/spi_divtable.c`
@@ -227,7 +227,7 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name I2C configuration
+ * @name I2C configuration
* @{
*/
#define I2C_NUMOF (1U)
diff --git a/boards/native/include/board.h b/boards/native/include/board.h
index 84d66cdad39f19a4c352e71f83ef19dafd7e2c3c..967e258e9162f33260e957419b22404ff301070b 100644
--- a/boards/native/include/board.h
+++ b/boards/native/include/board.h
@@ -35,7 +35,7 @@ extern "C" {
#endif
/**
- * @brief LED handlers
+ * @name LED handlers
* @{
*/
void _native_LED_GREEN_OFF(void);
diff --git a/boards/nrf52840dk/include/board.h b/boards/nrf52840dk/include/board.h
index 8d79d5482c3b5f38eb2cf4ea3c8588b749cc4fac..c9c0ce4997ab21af2f22126d3009c55511aa95fb 100644
--- a/boards/nrf52840dk/include/board.h
+++ b/boards/nrf52840dk/include/board.h
@@ -28,7 +28,7 @@ extern "C" {
#endif
/**
- * @brief LED pin configuration
+ * @name LED pin configuration
* @{
*/
#define LED0_PIN GPIO_PIN(0, 13)
@@ -60,7 +60,7 @@ extern "C" {
/** @} */
/**
- * @brief Button pin configuration
+ * @name Button pin configuration
* @{
*/
#define BUTTON1_PIN (GPIO_PIN(0, 11))
@@ -70,7 +70,7 @@ extern "C" {
/** @} */
/**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
diff --git a/boards/nrf52dk/include/board.h b/boards/nrf52dk/include/board.h
index 48d3447d5d231d06f3bf569734f7142677393650..6550dee0f91ec3364d64502faa62396054f2bfe4 100644
--- a/boards/nrf52dk/include/board.h
+++ b/boards/nrf52dk/include/board.h
@@ -28,7 +28,7 @@ extern "C" {
#endif
/**
- * @brief LED pin configuration
+ * @name LED pin configuration
* @{
*/
#define LED0_PIN GPIO_PIN(0, 17)
@@ -59,7 +59,7 @@ extern "C" {
/** @} */
/**
- * @brief Button pin configuration
+ * @name Button pin configuration
* @{
*/
#define BUTTON1_PIN (GPIO_PIN(0, 13))
@@ -69,7 +69,7 @@ extern "C" {
/** @} */
/**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
diff --git a/boards/nrf52dk/include/periph_conf.h b/boards/nrf52dk/include/periph_conf.h
index 0e86125f845bd66aba79b858aead73a2d7d7c823..96c46616f125c2fac73c0377edf9d12cb5da0e20 100644
--- a/boards/nrf52dk/include/periph_conf.h
+++ b/boards/nrf52dk/include/periph_conf.h
@@ -42,7 +42,7 @@ extern "C" {
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
static const timer_conf_t timer_config[] = {
diff --git a/boards/nrf6310/include/board.h b/boards/nrf6310/include/board.h
index bc5dad896415cbaff9bae282b14c5327f51e2923..5c3b9b163f5913dea6c4e8195d9701bb3759c562 100644
--- a/boards/nrf6310/include/board.h
+++ b/boards/nrf6310/include/board.h
@@ -30,7 +30,7 @@ extern "C" {
#endif
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(0, 8)
@@ -55,7 +55,7 @@ extern "C" {
/** @} */
/**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
diff --git a/boards/nrf6310/include/periph_conf.h b/boards/nrf6310/include/periph_conf.h
index 3d5cedfa1cde00d9bd222afb39ef9a12cb3ab640..3e804fbd72fcecce99f304482858a3f850d6b071 100644
--- a/boards/nrf6310/include/periph_conf.h
+++ b/boards/nrf6310/include/periph_conf.h
@@ -45,7 +45,7 @@ extern "C" {
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
static const timer_conf_t timer_config[] = {
@@ -69,7 +69,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
#define UART_NUMOF (1U)
@@ -85,7 +85,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @name Radio device configuration
+ * @name Radio device configuration
*
* The radio is not guarded by a NUMOF define, as the radio is selected by its
* own module in the build system.
@@ -95,7 +95,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
* @{
*/
static const spi_conf_t spi_config[] = {
@@ -117,7 +117,7 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name ADC configuration
+ * @name ADC configuration
*
* The configuration consists simply of a list of channels that should be used
* @{
diff --git a/boards/nucleo-f030/include/board.h b/boards/nucleo-f030/include/board.h
index 0317fa4e548bfa2267ed3c328c929af7476004b6..19f4b475572a5d7e110ae419b0efc355681534a0 100644
--- a/boards/nucleo-f030/include/board.h
+++ b/boards/nucleo-f030/include/board.h
@@ -31,7 +31,7 @@ extern "C" {
#endif
/**
- * @brief Xtimer configuration
+ * @name Xtimer configuration
* @{
*/
#define XTIMER_WIDTH (16)
diff --git a/boards/nucleo-f070/include/board.h b/boards/nucleo-f070/include/board.h
index 4f442f7e006d595358a05d2020cc2c05ee32fb7e..3da4a940581be0f5cf8b3f9a0d19e19acb740fb3 100644
--- a/boards/nucleo-f070/include/board.h
+++ b/boards/nucleo-f070/include/board.h
@@ -32,7 +32,7 @@ extern "C" {
#endif
/**
- * @brief Xtimer configuration
+ * @name Xtimer configuration
* @{
*/
#define XTIMER_WIDTH (16)
diff --git a/boards/nucleo-f072/include/board.h b/boards/nucleo-f072/include/board.h
index 4a45e5fd010851f3a7fe6f4f24bb51b4539c9e10..a69850e219085b94d4f4f916cff607df9b87747a 100644
--- a/boards/nucleo-f072/include/board.h
+++ b/boards/nucleo-f072/include/board.h
@@ -30,7 +30,7 @@ extern "C" {
#endif
/**
- * @brief Xtimer configuration
+ * @name Xtimer configuration
* @{
*/
#define XTIMER_WIDTH (16)
diff --git a/boards/nucleo-f091/include/board.h b/boards/nucleo-f091/include/board.h
index 4001e1a506ef4db15682c35862d55732513641ca..54669ce6993d959a1664fcf0306cc8d4ed1f7a17 100644
--- a/boards/nucleo-f091/include/board.h
+++ b/boards/nucleo-f091/include/board.h
@@ -29,7 +29,7 @@ extern "C" {
#endif
/**
- * @brief Xtimer configuration
+ * @name Xtimer configuration
* @{
*/
#define XTIMER_WIDTH (16)
diff --git a/boards/nucleo-f103/include/board.h b/boards/nucleo-f103/include/board.h
index 753596069e6985bf0712c7e55603e86bbfdaf074..086bb2a9bcaaf3179f489e0fba5ee775aea2ce7d 100755
--- a/boards/nucleo-f103/include/board.h
+++ b/boards/nucleo-f103/include/board.h
@@ -28,7 +28,7 @@ extern "C" {
#endif
/**
- * @name xtimer configuration
+ * @name xtimer configuration
*/
#define XTIMER_WIDTH (16)
#define XTIMER_BACKOFF 5
diff --git a/boards/nucleo-f411/include/board.h b/boards/nucleo-f411/include/board.h
index bcb823cbeba6714f237d4cde68faf5a2b2e39181..7c4f23a8cfc88600d99b6f2728674c5e74198e62 100644
--- a/boards/nucleo-f411/include/board.h
+++ b/boards/nucleo-f411/include/board.h
@@ -28,7 +28,7 @@ extern "C" {
#endif
/**
- * @name xtimer configuration
+ * @name xtimer configuration
* @{
*/
#define XTIMER_DEV TIMER_DEV(0)
diff --git a/boards/nucleo-f411/include/periph_conf.h b/boards/nucleo-f411/include/periph_conf.h
index 1061f9c10b13963cad3615699df8773d5a82d86f..d46b05dc7b9979232b358c338aac6064d2dec39f 100644
--- a/boards/nucleo-f411/include/periph_conf.h
+++ b/boards/nucleo-f411/include/periph_conf.h
@@ -26,7 +26,7 @@ extern "C" {
#endif
/**
- * @name Clock system configuration
+ * @name Clock system configuration
* @{
*/
#define CLOCK_HSE (8000000U) /* external oscillator */
@@ -49,7 +49,7 @@ extern "C" {
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
static const timer_conf_t timer_config[] = {
@@ -69,7 +69,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @brief UART configuration
+ * @name UART configuration
* @{
*/
static const uart_conf_t uart_config[] = {
@@ -129,7 +129,7 @@ static const uart_conf_t uart_config[] = {
#define UART_NUMOF (sizeof(uart_config) / sizeof(uart_config[0]))
/** @} */
-/** @brief PWM configuration
+/** @name PWM configuration
* @{
*/
static const pwm_conf_t pwm_config[] = {
@@ -159,7 +159,7 @@ static const pwm_conf_t pwm_config[] = {
/** @} */
/**
- * @brief SPI configuration
+ * @name SPI configuration
*
* @note The spi_divtable is auto-generated from
* `cpu/stm32_common/dist/spi_divtable/spi_divtable.c`
@@ -199,7 +199,7 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name I2C configuration
+ * @name I2C configuration
* @{
*/
#define I2C_NUMOF (1U)
@@ -227,14 +227,14 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name ADC configuration
+ * @name ADC configuration
* @{
*/
#define ADC_NUMOF (0)
/** @} */
/**
- * @name DAC configuration
+ * @name DAC configuration
* @{
*/
#define DAC_NUMOF (0)
diff --git a/boards/nucleo-l053/include/board.h b/boards/nucleo-l053/include/board.h
index d29f4f1c121eb7ef200dc96f9e9f036518fa5eb5..a2840657b7e4bafd0df0efb6c4829cc8bd355cf1 100644
--- a/boards/nucleo-l053/include/board.h
+++ b/boards/nucleo-l053/include/board.h
@@ -31,7 +31,7 @@ extern "C" {
#endif
/**
- * @name xtimer configuration
+ * @name xtimer configuration
* @{
*/
#define XTIMER_DEV TIMER_DEV(0)
diff --git a/boards/nucleo-l053/include/periph_conf.h b/boards/nucleo-l053/include/periph_conf.h
index 0fc55f62efd5cd186c54bd75e1c1f1397e2b1f21..702e1916bebdc52367df7675627defd6b158de27 100644
--- a/boards/nucleo-l053/include/periph_conf.h
+++ b/boards/nucleo-l053/include/periph_conf.h
@@ -28,7 +28,7 @@ extern "C" {
#endif
/**
- * @name Clock system configuration
+ * @name Clock system configuration
* @{
*/
#define CLOCK_HSI (16000000U) /* internal oscillator */
@@ -52,7 +52,7 @@ extern "C" {
/** @} */
/**
- * @brief Timer configuration
+ * @name Timer configuration
* @{
*/
static const timer_conf_t timer_config[] = {
@@ -71,7 +71,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @brief UART configuration
+ * @name UART configuration
* @{
*/
static const uart_conf_t uart_config[] = {
@@ -104,7 +104,7 @@ static const uart_conf_t uart_config[] = {
/** @} */
/**
- * @brief PWM configuration
+ * @name PWM configuration
* @{
*/
static const pwm_conf_t pwm_config[] = {
@@ -124,7 +124,7 @@ static const pwm_conf_t pwm_config[] = {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
*
* @note The spi_divtable is auto-generated from
* `cpu/stm32_common/dist/spi_divtable/spi_divtable.c`
@@ -164,7 +164,7 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name ADC configuration
+ * @name ADC configuration
* @{
*/
#define ADC_NUMOF (0)
@@ -172,14 +172,14 @@ static const spi_conf_t spi_config[] = {
/**
- * @name DAC configuration
+ * @name DAC configuration
* @{
*/
#define DAC_NUMOF (0)
/** @} */
/**
- * @name RTC configuration
+ * @name RTC configuration
* @{
*/
#define RTC_NUMOF (0U)
diff --git a/boards/nucleo-l073/include/board.h b/boards/nucleo-l073/include/board.h
index 42acbcf535b18f3dc45423c19b7514d82d1ef8f4..803bc5cb7ffa86c90c5923a840aa12bee6bfd270 100644
--- a/boards/nucleo-l073/include/board.h
+++ b/boards/nucleo-l073/include/board.h
@@ -31,7 +31,7 @@ extern "C" {
#endif
/**
- * @name xtimer configuration
+ * @name xtimer configuration
* @{
*/
#define XTIMER_DEV TIMER_DEV(0)
diff --git a/boards/nucleo-l073/include/periph_conf.h b/boards/nucleo-l073/include/periph_conf.h
index 2a7004e205e94f533d7ce47d5492e8e447d035fa..e14442e1d0b561f4d3f0ff8e158dce260575eebb 100644
--- a/boards/nucleo-l073/include/periph_conf.h
+++ b/boards/nucleo-l073/include/periph_conf.h
@@ -28,7 +28,7 @@ extern "C" {
#endif
/**
- * @name Clock system configuration
+ * @name Clock system configuration
* @{
*/
#define CLOCK_HSI (16000000U) /* internal oscillator */
@@ -52,7 +52,7 @@ extern "C" {
/** @} */
/**
- * @brief Timer configuration
+ * @name Timer configuration
* @{
*/
static const timer_conf_t timer_config[] = {
@@ -71,7 +71,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @brief UART configuration
+ * @name UART configuration
* @{
*/
static const uart_conf_t uart_config[] = {
@@ -104,7 +104,7 @@ static const uart_conf_t uart_config[] = {
/** @} */
/**
- * @brief PWM configuration
+ * @name PWM configuration
* @{
*/
static const pwm_conf_t pwm_config[] = {
@@ -124,7 +124,7 @@ static const pwm_conf_t pwm_config[] = {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
*
* @note The spi_divtable is auto-generated from
* `cpu/stm32_common/dist/spi_divtable/spi_divtable.c`
@@ -164,7 +164,7 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name ADC configuration
+ * @name ADC configuration
* @{
*/
#define ADC_NUMOF (0)
@@ -172,14 +172,14 @@ static const spi_conf_t spi_config[] = {
/**
- * @name DAC configuration
+ * @name DAC configuration
* @{
*/
#define DAC_NUMOF (0)
/** @} */
/**
- * @name RTC configuration
+ * @name RTC configuration
* @{
*/
#define RTC_NUMOF (0U)
diff --git a/boards/nucleo-l476/include/periph_conf.h b/boards/nucleo-l476/include/periph_conf.h
index 650d95097cfd5a5f56c9047338de39dc53fcb016..4962c50f22b8e13acbaa121011e91ecbfa804a10 100644
--- a/boards/nucleo-l476/include/periph_conf.h
+++ b/boards/nucleo-l476/include/periph_conf.h
@@ -28,7 +28,7 @@ extern "C" {
#endif
/**
- * @name Clock system configuration
+ * @name Clock system configuration
* @{
*/
/* 0: no external high speed crystal available
@@ -66,7 +66,7 @@ extern "C" {
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
static const timer_conf_t timer_config[] = {
@@ -85,7 +85,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @brief UART configuration
+ * @name UART configuration
* @{
*/
static const uart_conf_t uart_config[] = {
@@ -141,7 +141,7 @@ static const uart_conf_t uart_config[] = {
/** @} */
/**
- * @brief PWM configuration
+ * @name PWM configuration
* @{
*/
static const pwm_conf_t pwm_config[] = {
@@ -181,7 +181,7 @@ static const pwm_conf_t pwm_config[] = {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
*
* @note The spi_divtable is auto-generated from
* `cpu/stm32_common/dist/spi_divtable/spi_divtable.c`
@@ -221,14 +221,14 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name ADC configuration
+ * @name ADC configuration
* @{
*/
#define ADC_NUMOF (0)
/** @} */
/**
- * @name DAC configuration
+ * @name DAC configuration
* @{
*/
#define DAC_NUMOF (0)
diff --git a/boards/nucleo144-common/include/board_common.h b/boards/nucleo144-common/include/board_common.h
index 42a76af692400fe771329d5f1e6cd8457360c379..0d02b61f27a001ca8f095e5e5cefb882d54cd74b 100644
--- a/boards/nucleo144-common/include/board_common.h
+++ b/boards/nucleo144-common/include/board_common.h
@@ -32,7 +32,7 @@ extern "C" {
#endif
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(PORT_B, 0)
diff --git a/boards/nucleo144-f207/include/periph_conf.h b/boards/nucleo144-f207/include/periph_conf.h
index f0c6c64b0c3ea58fdc4586fbffd5fdca92eb8865..0121e448afda27fb61a9478ebfe527b93571dae0 100644
--- a/boards/nucleo144-f207/include/periph_conf.h
+++ b/boards/nucleo144-f207/include/periph_conf.h
@@ -28,7 +28,7 @@ extern "C" {
#endif
/**
- * @name Clock system configuration
+ * @name Clock system configuration
* @{
*/
#define CLOCK_HSE (8000000U) /* external oscillator */
@@ -71,7 +71,7 @@ static const pwm_conf_t pwm_config[] = {
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
static const timer_conf_t timer_config[] = {
@@ -105,8 +105,9 @@ static const timer_conf_t timer_config[] = {
#define TIMER_NUMOF (sizeof(timer_config) / sizeof(timer_config[0]))
/** @} */
+
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
static const uart_conf_t uart_config[] = {
@@ -167,7 +168,7 @@ static const uart_conf_t uart_config[] = {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
*
* @note The spi_divtable is auto-generated from
* `cpu/stm32_common/dist/spi_divtable/spi_divtable.c`
@@ -217,7 +218,7 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name I2C configuration
+ * @name I2C configuration
* @{
*/
#define I2C_NUMOF (1U)
@@ -247,7 +248,7 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name ADC configuration
+ * @name ADC configuration
*
* We need to define the following fields:
* PIN, device (ADCx), channel
@@ -262,14 +263,14 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name DAC configuration
+ * @name DAC configuration
* @{
*/
#define DAC_NUMOF (0)
/** @} */
/**
- * @brief RTC configuration
+ * @name RTC configuration
* @{
*/
#define RTC_NUMOF (1)
diff --git a/boards/nucleo144-f303/include/periph_conf.h b/boards/nucleo144-f303/include/periph_conf.h
index 279662af9c4134c14cd32a9c49f7101095e80730..f0c85f379c5a26efbd91450f63e2e762d77c844a 100644
--- a/boards/nucleo144-f303/include/periph_conf.h
+++ b/boards/nucleo144-f303/include/periph_conf.h
@@ -26,7 +26,7 @@ extern "C" {
#endif
/**
- * @name Clock system configuration
+ * @name Clock system configuration
* @{
*/
#define CLOCK_HSE (8000000U) /* external oscillator */
@@ -46,7 +46,7 @@ extern "C" {
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
static const timer_conf_t timer_config[] = {
@@ -65,7 +65,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
static const uart_conf_t uart_config[] = {
@@ -124,7 +124,7 @@ static const uart_conf_t uart_config[] = {
/** @} */
/**
- * @brief PWM configuration
+ * @name PWM configuration
* @{
*/
static const pwm_conf_t pwm_config[] = {
@@ -144,7 +144,7 @@ static const pwm_conf_t pwm_config[] = {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
*
* @note The spi_divtable is auto-generated from
* `cpu/stm32_common/dist/spi_divtable/spi_divtable.c`
@@ -185,7 +185,7 @@ static const spi_conf_t spi_config[] = {
/**
- * @name I2C configuration
+ * @name I2C configuration
* @{
*/
#define I2C_NUMOF (0U)
@@ -199,7 +199,7 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name DAC configuration
+ * @name DAC configuration
* @{
*/
#define DAC_NUMOF (0)
diff --git a/boards/nucleo144-f413/include/board.h b/boards/nucleo144-f413/include/board.h
index 8740c3e87b9b1063ba3429a0ea60990cbc1c61a9..6de395122be3bb54d8517e7d7f91810dba18592d 100644
--- a/boards/nucleo144-f413/include/board.h
+++ b/boards/nucleo144-f413/include/board.h
@@ -30,7 +30,7 @@ extern "C" {
#endif
/**
- * @name xtimer configuration
+ * @name xtimer configuration
* @{
*/
#define XTIMER_DEV TIMER_DEV(0)
diff --git a/boards/nucleo144-f413/include/periph_conf.h b/boards/nucleo144-f413/include/periph_conf.h
index a47fb1d92e776a3e1419ef536abd0bb1103d0299..d7e0a82aa4e87689ed4f6de522bccb16be7f3140 100644
--- a/boards/nucleo144-f413/include/periph_conf.h
+++ b/boards/nucleo144-f413/include/periph_conf.h
@@ -28,7 +28,7 @@ extern "C" {
#endif
/**
- * @name Clock system configuration
+ * @name Clock system configuration
* @{
*/
#define CLOCK_HSE (8000000U) /* external oscillator */
@@ -51,7 +51,7 @@ extern "C" {
/** @} */
/**
- * @brief Timer configuration
+ * @name Timer configuration
* @{
*/
static const timer_conf_t timer_config[] = {
@@ -70,7 +70,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
static const uart_conf_t uart_config[] = {
@@ -129,7 +129,7 @@ static const uart_conf_t uart_config[] = {
/** @} */
/**
- * @brief PWM configuration
+ * @name PWM configuration
* @{
*/
static const pwm_conf_t pwm_config[] = {
@@ -169,7 +169,7 @@ static const pwm_conf_t pwm_config[] = {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
*
* @note The spi_divtable is auto-generated from
* `cpu/stm32_common/dist/spi_divtable/spi_divtable.c`
@@ -192,8 +192,6 @@ static const uint8_t spi_divtable[2][5] = {
}
};
-
-
static const spi_conf_t spi_config[] = {
{
.dev = SPI1,
@@ -210,9 +208,8 @@ static const spi_conf_t spi_config[] = {
#define SPI_NUMOF (sizeof(spi_config) / sizeof(spi_config[0]))
/** @} */
-
/**
- * @name I2C configuration
+ * @name I2C configuration
* @{
*/
#define I2C_NUMOF (1U)
@@ -240,21 +237,21 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name ADC configuration
+ * @name ADC configuration
* @{
*/
#define ADC_NUMOF (0)
/** @} */
/**
- * @name DAC configuration
+ * @name DAC configuration
* @{
*/
#define DAC_NUMOF (0)
/** @} */
/**
- * @name RTC configuration
+ * @name RTC configuration
* @{
*/
#define RTC_NUMOF (1)
diff --git a/boards/nucleo144-f429/include/board.h b/boards/nucleo144-f429/include/board.h
index 6dd94f7de00f4750ec70a1a0383144b460a50048..27c88a1b4dbdfac36f2dbd46fbab6bd7bae44aa1 100644
--- a/boards/nucleo144-f429/include/board.h
+++ b/boards/nucleo144-f429/include/board.h
@@ -28,7 +28,7 @@ extern "C" {
#endif
/**
- * @name xtimer configuration
+ * @name xtimer configuration
* @{
*/
#define XTIMER_DEV TIMER_DEV(0)
diff --git a/boards/nucleo144-f429/include/periph_conf.h b/boards/nucleo144-f429/include/periph_conf.h
index 14144736a2b16aa5cf57a8421d7510341e9be7e8..2cd6b1112f73d03750b8c47d525093ec2b7a81b4 100644
--- a/boards/nucleo144-f429/include/periph_conf.h
+++ b/boards/nucleo144-f429/include/periph_conf.h
@@ -26,7 +26,7 @@ extern "C" {
#endif
/**
- * @name Clock system configuration
+ * @name Clock system configuration
* @{
*/
#define CLOCK_HSE (8000000U) /* external oscillator */
@@ -49,7 +49,7 @@ extern "C" {
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
static const timer_conf_t timer_config[] = {
@@ -68,7 +68,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
static const uart_conf_t uart_config[] = {
@@ -127,7 +127,7 @@ static const uart_conf_t uart_config[] = {
/** @} */
/**
- * @brief PWM configuration
+ * @name PWM configuration
* @{
*/
static const pwm_conf_t pwm_config[] = {
@@ -157,7 +157,7 @@ static const pwm_conf_t pwm_config[] = {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
*
* @note The spi_divtable is auto-generated from
* `cpu/stm32_common/dist/spi_divtable/spi_divtable.c`
@@ -196,9 +196,8 @@ static const spi_conf_t spi_config[] = {
#define SPI_NUMOF (sizeof(spi_config) / sizeof(spi_config[0]))
/** @} */
-
/**
- * @name I2C configuration
+ * @name I2C configuration
* @{
*/
#define I2C_NUMOF (1U)
@@ -226,17 +225,17 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name ADC configuration
+ * @name ADC configuration
* @{
*/
#define ADC_NUMOF (0)
/** @} */
/**
- * @name DAC configuration
+ * @name DAC configuration
* @{
*/
-#define DAC_NUMOF (0)
+#define DAC_NUMOF (0)
/** @} */
#ifdef __cplusplus
diff --git a/boards/nucleo144-f446/include/board.h b/boards/nucleo144-f446/include/board.h
index cf7f93dc8f58466d0e2e9cae1739700f96b309f6..94a322f80aa21bbab8810442c955f87f4113b74c 100644
--- a/boards/nucleo144-f446/include/board.h
+++ b/boards/nucleo144-f446/include/board.h
@@ -28,7 +28,7 @@ extern "C" {
#endif
/**
- * @name xtimer configuration
+ * @name xtimer configuration
* @{
*/
#define XTIMER_DEV TIMER_DEV(0)
diff --git a/boards/nucleo144-f446/include/periph_conf.h b/boards/nucleo144-f446/include/periph_conf.h
index 8c08db6783728cbabec3d501ebec7098af38fd06..fae5da30972905492144e8165622dd6942a69abb 100644
--- a/boards/nucleo144-f446/include/periph_conf.h
+++ b/boards/nucleo144-f446/include/periph_conf.h
@@ -26,7 +26,7 @@ extern "C" {
#endif
/**
- * @name Clock system configuration
+ * @name Clock system configuration
* @{
*/
#define CLOCK_HSE (8000000U) /* external oscillator */
@@ -49,7 +49,7 @@ extern "C" {
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
static const timer_conf_t timer_config[] = {
@@ -68,7 +68,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
static const uart_conf_t uart_config[] = {
@@ -127,7 +127,7 @@ static const uart_conf_t uart_config[] = {
/** @} */
/**
- * @brief PWM configuration
+ * @name PWM configuration
* @{
*/
static const pwm_conf_t pwm_config[] = {
@@ -167,7 +167,7 @@ static const pwm_conf_t pwm_config[] = {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
*
* @note The spi_divtable is auto-generated from
* `cpu/stm32_common/dist/spi_divtable/spi_divtable.c`
@@ -206,9 +206,8 @@ static const spi_conf_t spi_config[] = {
#define SPI_NUMOF (sizeof(spi_config) / sizeof(spi_config[0]))
/** @} */
-
/**
- * @name I2C configuration
+ * @name I2C configuration
* @{
*/
#define I2C_NUMOF (1U)
@@ -236,17 +235,17 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name ADC configuration
+ * @name ADC configuration
* @{
*/
#define ADC_NUMOF (0)
/** @} */
/**
- * @name DAC configuration
+ * @name DAC configuration
* @{
*/
-#define DAC_NUMOF (0)
+#define DAC_NUMOF (0)
/** @} */
#ifdef __cplusplus
diff --git a/boards/nucleo32-l031/include/periph_conf.h b/boards/nucleo32-l031/include/periph_conf.h
index 5c66efa9c009afc7ab4dd9449a700d49e7563a9c..3559af3a52841a4f2b56710373e3b8db761dda69 100644
--- a/boards/nucleo32-l031/include/periph_conf.h
+++ b/boards/nucleo32-l031/include/periph_conf.h
@@ -28,7 +28,7 @@ extern "C" {
#endif
/**
- * @name Clock system configuration
+ * @name Clock system configuration
* @{
*/
#define CLOCK_HSI (16000000U) /* internal oscillator */
@@ -52,7 +52,7 @@ extern "C" {
/** @} */
/**
- * @brief Timer configuration
+ * @name Timer configuration
* @{
*/
static const timer_conf_t timer_config[] = {
@@ -71,7 +71,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @brief UART configuration
+ * @name UART configuration
* @{
*/
static const uart_conf_t uart_config[] = {
@@ -93,7 +93,7 @@ static const uart_conf_t uart_config[] = {
/** @} */
/**
- * @brief PWM configuration
+ * @name PWM configuration
* @{
*/
static const pwm_conf_t pwm_config[] = {
@@ -113,7 +113,7 @@ static const pwm_conf_t pwm_config[] = {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
* @{
*/
static const uint8_t spi_divtable[2][5] = {
@@ -150,22 +150,21 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name ADC configuration
+ * @name ADC configuration
* @{
*/
#define ADC_NUMOF (0)
/** @} */
-
/**
- * @name DAC configuration
+ * @name DAC configuration
* @{
*/
#define DAC_NUMOF (0)
/** @} */
/**
- * @name RTC configuration
+ * @name RTC configuration
* @{
*/
#define RTC_NUMOF (0U)
diff --git a/boards/opencm904/include/board.h b/boards/opencm904/include/board.h
index 4fb218f24a393a8cf71865cebc0d8d0f0c1e7c01..badeb5bfb74d7df7acdf4fc2d2275ea605cfbea2 100755
--- a/boards/opencm904/include/board.h
+++ b/boards/opencm904/include/board.h
@@ -67,7 +67,7 @@ extern "C" {
#define UART_STDIO_DEV UART_DEV(0)
/**
- * @brief Override with ROBOTIS Bluetooth antenna baudrate for STDIO
+ * @name Override with ROBOTIS Bluetooth antenna baudrate for STDIO
* @{
*/
#ifndef UART_STDIO_BAUDRATE
diff --git a/boards/openmote-cc2538/include/board.h b/boards/openmote-cc2538/include/board.h
index a7d658b94893a3b7fc6855b83e210e5b6e89076d..43e57e380c814acad3bb2dcc30f21d1240a9e228 100644
--- a/boards/openmote-cc2538/include/board.h
+++ b/boards/openmote-cc2538/include/board.h
@@ -29,7 +29,7 @@
#endif
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(2, 4)
@@ -61,7 +61,7 @@
/** @} */
/**
- * @name xtimer configuration
+ * @name xtimer configuration
* @{
*/
#define XTIMER_DEV (0)
@@ -74,7 +74,7 @@
/** @} */
/**
- * @name Flash Customer Configuration Area (CCA) parameters
+ * @name Flash Customer Configuration Area (CCA) parameters
* @{
*/
#ifndef UPDATE_CCA
@@ -87,7 +87,7 @@
/** @} */
/**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
diff --git a/boards/openmote-cc2538/include/periph_conf.h b/boards/openmote-cc2538/include/periph_conf.h
index 88b9fa8e3b467d6183052fe12d71fe2e9de88614..aadf637d9d6f5d3661a21f137d3fd71d98f01c4f 100644
--- a/boards/openmote-cc2538/include/periph_conf.h
+++ b/boards/openmote-cc2538/include/periph_conf.h
@@ -27,14 +27,14 @@
#endif
/**
- * @name Clock system configuration
+ * @name Clock system configuration
* @{
*/
#define CLOCK_CORECLOCK (32000000U) /* desired core clock frequency, 32MHz */
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
static const timer_conf_t timer_config[] = {
@@ -65,7 +65,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
#define UART_NUMOF (1U)
@@ -82,7 +82,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @name I2C configuration
+ * @name I2C configuration
* @{
*/
#define I2C_NUMOF 1
@@ -120,7 +120,7 @@ static const spi_clk_conf_t spi_clk_config[] = {
};
/**
- * @name SPI configuration
+ * @name SPI configuration
* @{
*/
static const spi_conf_t spi_config[] = {
@@ -137,7 +137,7 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name Radio peripheral configuration
+ * @name Radio peripheral configuration
* @{
*/
#define RADIO_IRQ_PRIO 1
diff --git a/boards/pca10000/include/board.h b/boards/pca10000/include/board.h
index d2a6349f2d32f44c4cd37715eb8975a5c833a9f2..d743a81fb64d8fdd5b8f373409ce8fdfb80f2402 100644
--- a/boards/pca10000/include/board.h
+++ b/boards/pca10000/include/board.h
@@ -29,7 +29,7 @@ extern "C" {
#endif
/**
- * @brief Xtimer configuration
+ * @name Xtimer configuration
* @{
*/
#define XTIMER_DEV (0)
@@ -39,7 +39,7 @@ extern "C" {
/** @} */
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(0, 21)
diff --git a/boards/pca10000/include/periph_conf.h b/boards/pca10000/include/periph_conf.h
index 606bf6fe85a001accc8c7904e01a75832cc14450..d95e9a79306340cd96e8d75fc017792b999bc0dc 100644
--- a/boards/pca10000/include/periph_conf.h
+++ b/boards/pca10000/include/periph_conf.h
@@ -44,7 +44,7 @@ extern "C" {
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
static const timer_conf_t timer_config[] = {
@@ -68,7 +68,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
#define UART_NUMOF (1U)
@@ -81,7 +81,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @name ADC configuration
+ * @name ADC configuration
*
* The configuration consists simply of a list of channels that should be used
* @{
@@ -90,7 +90,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @name Radio device configuration
+ * @name Radio device configuration
*
* The radio is not guarded by a NUMOF define, as the radio is selected by its
* own module in the build system.
diff --git a/boards/pca10005/include/board.h b/boards/pca10005/include/board.h
index b65a0711bb2d91ac8378e8a8e8784971c6c94141..54e3dd4eec2f13d38af2bac2e442e4cd9f937f67 100644
--- a/boards/pca10005/include/board.h
+++ b/boards/pca10005/include/board.h
@@ -29,7 +29,7 @@ extern "C" {
#endif
/**
- * @brief Xtimer configuration
+ * @name Xtimer configuration
* @{
*/
#define XTIMER_DEV (0)
@@ -39,7 +39,7 @@ extern "C" {
/** @} */
/**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
diff --git a/boards/pca10005/include/periph_conf.h b/boards/pca10005/include/periph_conf.h
index 77b68e6c771181ddbf46d3a7a9821087b35deb4d..26c290f075dcee76bf0316ee1a27d384f927937c 100644
--- a/boards/pca10005/include/periph_conf.h
+++ b/boards/pca10005/include/periph_conf.h
@@ -44,7 +44,7 @@ extern "C" {
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
static const timer_conf_t timer_config[] = {
@@ -58,7 +58,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
#define UART_NUMOF (1U)
@@ -78,7 +78,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
* @{
*/
static const spi_conf_t spi_config[] = {
@@ -100,7 +100,7 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name ADC configuration
+ * @name ADC configuration
*
* The configuration consists simply of a list of channels that should be used
* @{
@@ -110,7 +110,7 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name Radio device configuration
+ * @name Radio device configuration
*
* The radio is not guarded by a NUMOF define, as the radio is selected by its
* own module in the build system.
diff --git a/boards/pic32-clicker/include/board.h b/boards/pic32-clicker/include/board.h
index eb1c1b5d40c1a87c1bf248df4d3e85db6bd8f6f7..ef31b0635556612bc559e0267d7f19c940293bc4 100644
--- a/boards/pic32-clicker/include/board.h
+++ b/boards/pic32-clicker/include/board.h
@@ -25,8 +25,8 @@
* @author Neil Jones <Neil.Jones@imgtec.com>
*/
-#ifndef _BOARD_H_
-#define _BOARD_H_
+#ifndef BOARD_H
+#define BOARD_H
#ifdef __cplusplus
extern "C" {
@@ -35,13 +35,13 @@ extern "C" {
#include "vendor/p32mx470f512h.h"
/**
- * @brief Set how many increments of the count register per uS
- * needed by the timer code.
+ * @brief Set how many increments of the count register per uS
+ * needed by the timer code.
*/
#define TICKS_PER_US (48)
/**
- * @brief We are using an External Interrupt Controller (all pic32 devices use this mode)
+ * @brief We are using an External Interrupt Controller (all pic32 devices use this mode)
*/
#define EIC_IRQ (1)
@@ -55,5 +55,5 @@ void board_init(void);
#endif
-#endif /* _BOARD_H_ */
+#endif /* BOARD_H */
/** @} */
diff --git a/boards/pic32-clicker/include/periph_conf.h b/boards/pic32-clicker/include/periph_conf.h
index 209f929619e3e517215e337c2c528586d9f6605d..66fa70bc0c0f4005030f26c45da9c5debce5ad8c 100644
--- a/boards/pic32-clicker/include/periph_conf.h
+++ b/boards/pic32-clicker/include/periph_conf.h
@@ -17,11 +17,11 @@
* @file
* @brief peripheral configuration for the MikroE PIC32 Clicker
*
- * @author Neil Jones <Neil.Jones@imgtec.com>
+ * @author Neil Jones <Neil.Jones@imgtec.com>
*/
-#ifndef _PERIPH_CONF_H_
-#define _PERIPH_CONF_H_
+#ifndef PERIPH_CONF_H
+#define PERIPH_CONF_H
#ifdef __cplusplus
extern "C" {
@@ -29,14 +29,14 @@ extern "C" {
/**
- * @brief The peripheral clock is required for the UART Baud rate calculation
- * It is configured by the 'config' registers (see pic32_config_settings.c)
- * Note 120MHz is the max F for this device.
+ * @brief The peripheral clock is required for the UART Baud rate calculation
+ * It is configured by the 'config' registers (see pic32_config_settings.c)
+ * Note 120MHz is the max F for this device.
*/
#define PERIPHERAL_CLOCK (96000000) /* Hz */
/**
- * @brief Timer definitions
+ * @name Timer definitions
* @{
*/
#define TIMER_NUMOF (1)
@@ -44,7 +44,7 @@ extern "C" {
/** @} */
/**
- * @brief UART Definitions
+ * @name UART Definitions
* There are 4 UARTS available on this CPU.
* We route debug via UART3 on this board,
* this is the UART connected to the MikroBUS
@@ -61,5 +61,5 @@ extern "C" {
}
#endif
-#endif
+#endif /* PERIPH_CONF_H */
/** @} */
diff --git a/boards/pic32-wifire/include/board.h b/boards/pic32-wifire/include/board.h
index 02c4db1dcdfaf0a15d8374944a64a6387c07f944..de5b7cba80122f2e7946096513422e4bf4dcdd71 100644
--- a/boards/pic32-wifire/include/board.h
+++ b/boards/pic32-wifire/include/board.h
@@ -35,18 +35,18 @@ extern "C" {
#include "vendor/p32mz2048efg100.h"
/**
- * @brief Set how many increments of the count register per uS
- * needed by the timer code.
+ * @brief Set how many increments of the count register per uS
+ * needed by the timer code.
*/
#define TICKS_PER_US (100)
/**
- * @brief We are using an External Interrupt Controller (all pic32 devices use this mode)
+ * @brief We are using an External Interrupt Controller (all pic32 devices use this mode)
*/
-#define EIC_IRQ (1)
+#define EIC_IRQ (1)
/**
- * @brief Board level initialisation
+ * @brief Board level initialisation
*/
void board_init(void);
diff --git a/boards/pic32-wifire/include/periph_conf.h b/boards/pic32-wifire/include/periph_conf.h
index d53ea72b45b1564d8cb35ec5af9a5a702c511b91..8a50a797e1f42faf7c46fa9b3f67700037a33527 100644
--- a/boards/pic32-wifire/include/periph_conf.h
+++ b/boards/pic32-wifire/include/periph_conf.h
@@ -27,13 +27,13 @@ extern "C" {
#endif
/**
- * @brief The peripheral clock is required for the UART Baud rate calculation
- * It is configured by the 'config' registers (see pic32_config_settings.c)
+ * @brief The peripheral clock is required for the UART Baud rate calculation
+ * It is configured by the 'config' registers (see pic32_config_settings.c)
*/
#define PERIPHERAL_CLOCK (100000000) /* Hz */
/**
- * @brief Timer definitions
+ * @name Timer definitions
* @{
*/
#define TIMER_NUMOF (1)
@@ -41,7 +41,7 @@ extern "C" {
/** @} */
/**
- * @brief UART Definitions
+ * @name UART Definitions
* There are 6 UARTS available on this CPU.
* We route debug via UART4 on this board,
* this is the UART connected to the FTDI USB <-> UART device.
diff --git a/boards/qemu-i386/include/board.h b/boards/qemu-i386/include/board.h
index bafb3d9549f7c214b050817d0a829a0df3e95eda..c9d63b9e93aea371d5259b529c4b667c6dbce27c 100644
--- a/boards/qemu-i386/include/board.h
+++ b/boards/qemu-i386/include/board.h
@@ -26,7 +26,7 @@ extern "C" {
#endif
/**
- * @brief Serial port configuration
+ * @name Serial port configuration
* @{
*/
#define UART_PORT (COM1_PORT) /* IO port to use for UART */
diff --git a/boards/remote-pa/include/board.h b/boards/remote-pa/include/board.h
index 50827805dea641a5a999cec2a95383c18d116097..3a165453f9387834b8c18b52adcc6f05d837082c 100644
--- a/boards/remote-pa/include/board.h
+++ b/boards/remote-pa/include/board.h
@@ -31,7 +31,7 @@
#endif
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(3, 2)
@@ -56,14 +56,16 @@
/** @} */
/**
- * @name User button pin definition
+ * @name User button pin definition
* @{
*/
#define BTN0_PIN GPIO_PIN(0, 3)
/** @} */
/**
- * @name 2.4GHz RF switch controlled by SW
+ * @name Radio configuration
+ *
+ * 2.4GHz RF switch controlled by SW
* @{
*/
#define RF_SWITCH_PORT GPIO_D
@@ -74,7 +76,7 @@
/** @} */
/**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
diff --git a/boards/remote-pa/include/periph_conf.h b/boards/remote-pa/include/periph_conf.h
index d82249a62d9379aadcf8274430fb182f4c186caf..eeb5e1a14959b4274fd34ed2bc1480be87dbb4f1 100644
--- a/boards/remote-pa/include/periph_conf.h
+++ b/boards/remote-pa/include/periph_conf.h
@@ -28,7 +28,7 @@
#endif
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
#define UART_NUMOF (1U)
@@ -42,11 +42,10 @@
/* UART 0 pin configuration */
#define UART_0_TX_PIN GPIO_PA1
#define UART_0_RX_PIN GPIO_PA0
-
/** @} */
/**
- * @name I2C configuration
+ * @name I2C configuration
* @{
*/
#define I2C_NUMOF 1
@@ -84,7 +83,7 @@ static const spi_clk_conf_t spi_clk_config[] = {
};
/**
- * @name SPI configuration
+ * @name SPI configuration
* @{
*/
static const spi_conf_t spi_config[] = {
diff --git a/boards/saml21-xpro/include/board.h b/boards/saml21-xpro/include/board.h
index 739d40a98d29505838991815066222379c036a67..794a03e401ab00872e33d3192d3024b48095b1dd 100644
--- a/boards/saml21-xpro/include/board.h
+++ b/boards/saml21-xpro/include/board.h
@@ -28,7 +28,7 @@ extern "C" {
#endif
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(1, 10)
@@ -42,12 +42,12 @@ extern "C" {
/** @} */
/**
- * @brief User button pin
+ * @brief User button pin
*/
#define SW0_PIN GPIO_PIN(PA, 2)
/**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
diff --git a/boards/saml21-xpro/include/periph_conf.h b/boards/saml21-xpro/include/periph_conf.h
index b4d2d2d0447b4c020a7e1db6eef253c31dbcb49c..6f8c3cdb2843e44836f8334d2070022abd717758 100644
--- a/boards/saml21-xpro/include/periph_conf.h
+++ b/boards/saml21-xpro/include/periph_conf.h
@@ -30,12 +30,12 @@ extern "C" {
#endif
/**
- * @brief GCLK reference speed
+ * @brief GCLK reference speed
*/
#define CLOCK_CORECLOCK (16000000U)
/**
- * @name Timer peripheral configuration
+ * @name Timer peripheral configuration
* @{
*/
#define TIMER_NUMOF (1U)
@@ -49,7 +49,7 @@ extern "C" {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
#define UART_NUMOF (1U)
@@ -71,7 +71,7 @@ extern "C" {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
* @{
*/
static const spi_conf_t spi_config[] = {
@@ -93,14 +93,14 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name I2C configuration
+ * @name I2C configuration
* @{
*/
#define I2C_NUMOF (0)
/** @} */
/**
- * @name RTC configuration
+ * @name RTC configuration
* @{
*/
#define RTC_NUMOF (1)
@@ -110,7 +110,7 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name RTT configuration
+ * @name RTT configuration
* @{
*/
#define RTT_FREQUENCY (32768U)
diff --git a/boards/samr21-xpro/include/board.h b/boards/samr21-xpro/include/board.h
index 373cb35e3461ef0678d89e7766c7b141e5b2da19..fbb71133a96479fb91efbd63b794eb85356f3c9c 100644
--- a/boards/samr21-xpro/include/board.h
+++ b/boards/samr21-xpro/include/board.h
@@ -31,7 +31,7 @@ extern "C" {
#endif
/**
- * @brief xtimer configuration
+ * @name xtimer configuration
* @{
*/
#define XTIMER_DEV TIMER_1
@@ -39,7 +39,7 @@ extern "C" {
/** @} */
/**
- * @name AT86RF233 configuration
+ * @name AT86RF233 configuration
*
* {spi bus, spi speed, cs pin, int pin, reset pin, sleep pin}
*/
@@ -51,7 +51,7 @@ extern "C" {
.reset_pin = GPIO_PIN(PB, 15)}
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(0, 19)
@@ -65,7 +65,7 @@ extern "C" {
/** @} */
/**
- * @name SW0 (Button) pin definitions
+ * @name SW0 (Button) pin definitions
* @{
*/
#define BUTTON_PORT PORT->Group[0]
@@ -74,7 +74,7 @@ extern "C" {
/** @} */
/**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
diff --git a/boards/samr21-xpro/include/periph_conf.h b/boards/samr21-xpro/include/periph_conf.h
index 29f47cd2cd1f204d72d5a4c6e5e87c09cc298552..ffde8992453d5ded5324b185bdc3d6f7fdeb0ef4 100644
--- a/boards/samr21-xpro/include/periph_conf.h
+++ b/boards/samr21-xpro/include/periph_conf.h
@@ -32,7 +32,7 @@ extern "C" {
#endif
/**
- * @brief External oscillator and clock configuration
+ * @name External oscillator and clock configuration
*
* For selection of the used CORECLOCK, we have implemented two choices:
*
@@ -79,7 +79,7 @@ extern "C" {
/** @} */
/**
- * @name Timer peripheral configuration
+ * @name Timer peripheral configuration
* @{
*/
#define TIMER_NUMOF (2U)
@@ -100,7 +100,7 @@ extern "C" {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
static const uart_conf_t uart_config[] = {
@@ -130,7 +130,7 @@ static const uart_conf_t uart_config[] = {
/** @} */
/**
- * @name PWM configuration
+ * @name PWM configuration
* @{
*/
#define PWM_0_EN 1
@@ -165,7 +165,7 @@ static const pwm_conf_t pwm_config[] = {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
* @{
*/
static const spi_conf_t spi_config[] = {
@@ -197,7 +197,7 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name I2C configuration
+ * @name I2C configuration
* @{
*/
#define I2C_NUMOF (1U)
@@ -219,7 +219,7 @@ static const spi_conf_t spi_config[] = {
#define I2C_0_MUX GPIO_MUX_D
/**
- * @name RTC configuration
+ * @name RTC configuration
* @{
*/
#define RTC_NUMOF (1U)
@@ -227,7 +227,7 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name RTT configuration
+ * @name RTT configuration
* @{
*/
#define RTT_NUMOF (1U)
diff --git a/boards/seeeduino_arch-pro/include/board.h b/boards/seeeduino_arch-pro/include/board.h
index 95600fb5b8401b86d201de97e56b9247e2a8be81..8aa7d4bb1a4b397a0839970af3ca32d29d4e9576 100644
--- a/boards/seeeduino_arch-pro/include/board.h
+++ b/boards/seeeduino_arch-pro/include/board.h
@@ -34,7 +34,7 @@ extern "C" {
#endif
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(1, 18)
@@ -63,7 +63,7 @@ extern "C" {
/** @} */
/**
- * @brief Initialize board specific hardware, include clocks, LEDs and stdio
+ * @brief Initialize board specific hardware, include clocks, LEDs and stdio
*/
void board_init(void);
diff --git a/boards/seeeduino_arch-pro/include/periph_conf.h b/boards/seeeduino_arch-pro/include/periph_conf.h
index be960be8abd6b875b83482e56daf4754c006b803..3ef04c16f4210fffbbf05a6520d38cb87aa5d24d 100644
--- a/boards/seeeduino_arch-pro/include/periph_conf.h
+++ b/boards/seeeduino_arch-pro/include/periph_conf.h
@@ -25,7 +25,7 @@ extern "C" {
#endif
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
#define TIMER_NUMOF (1U)
@@ -45,7 +45,7 @@ extern "C" {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
#define UART_NUMOF (2U)
diff --git a/boards/slwstk6220a/include/board.h b/boards/slwstk6220a/include/board.h
index 33b2e7e937ea942302e62530a01897205c87a989..fc5d9df89153618eb829b86383515bc85a8489c4 100644
--- a/boards/slwstk6220a/include/board.h
+++ b/boards/slwstk6220a/include/board.h
@@ -36,7 +36,7 @@ extern "C" {
#define HW_TIMER TIMER_DEV(0)
/**
- * @brief Connection to the on-board temperature/humidity sensor (Si7021)
+ * @name Connection to the on-board temperature/humidity sensor (Si7021)
* @{
*/
#define SI7021_I2C (I2C_0)
@@ -50,7 +50,7 @@ extern "C" {
#define BC_PIN GPIO_PIN(PA,12)
/**
- * @brief User button pin definitions
+ * @name User button pin definitions
* @{
*/
#define PB0_PIN GPIO_PIN(PE,3)
@@ -58,7 +58,7 @@ extern "C" {
/** @} */
/**
- * @brief LED pin definitions
+ * @name LED pin definitions
* @{
*/
#define LED0_PIN GPIO_PIN(PF, 6)
@@ -74,7 +74,7 @@ extern "C" {
/** @} */
/**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
diff --git a/boards/slwstk6220a/include/periph_conf.h b/boards/slwstk6220a/include/periph_conf.h
index 002e79de7c5944c948cb2d1e91075b5f25e39d0c..f9f8396cd4b9d0f12468c090c20dc2c2279bc593 100644
--- a/boards/slwstk6220a/include/periph_conf.h
+++ b/boards/slwstk6220a/include/periph_conf.h
@@ -28,7 +28,7 @@ extern "C" {
#endif
/**
- * @brief Clock configuration
+ * @name Clock configuration
* @{
*/
#define CLOCK_RCOSC (14000000) /* internal RC oscillator speed */
@@ -49,7 +49,7 @@ extern "C" {
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
static const timer_conf_t timer_config[] = {
@@ -67,7 +67,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
static const uart_conf_t uart_config[] = {
diff --git a/boards/sodaq-autonomo/include/board.h b/boards/sodaq-autonomo/include/board.h
index eff9e336cfaaae2acf0f2af3e445d45967218ac6..74d5299d39e3f1ff64be294db843c648d9dddd25 100644
--- a/boards/sodaq-autonomo/include/board.h
+++ b/boards/sodaq-autonomo/include/board.h
@@ -30,7 +30,7 @@ extern "C" {
#endif
/**
- * @brief xtimer configuration
+ * @name xtimer configuration
* @{
*/
#define XTIMER TIMER_1
@@ -38,7 +38,7 @@ extern "C" {
/** @} */
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(PA, 18)
@@ -52,7 +52,7 @@ extern "C" {
/** @} */
/**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
diff --git a/boards/sodaq-autonomo/include/periph_conf.h b/boards/sodaq-autonomo/include/periph_conf.h
index 456196ef0d5a2592965dc55e8fb8ad101ad1e6fa..c4a272ef5271e308d01211af9d4c47200235e075 100644
--- a/boards/sodaq-autonomo/include/periph_conf.h
+++ b/boards/sodaq-autonomo/include/periph_conf.h
@@ -29,7 +29,7 @@ extern "C" {
#endif
/**
- * @brief External oscillator and clock configuration
+ * @name External oscillator and clock configuration
*
* For selection of the used CORECLOCK, we have implemented two choices:
*
@@ -76,7 +76,7 @@ extern "C" {
/** @} */
/**
- * @name Timer peripheral configuration
+ * @name Timer peripheral configuration
* @{
*/
#define TIMER_NUMOF (2U)
@@ -97,7 +97,7 @@ extern "C" {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
* See Table 6.1 of the SAM D21 Datasheet
*/
@@ -146,7 +146,7 @@ static const uart_conf_t uart_config[] = {
/** @} */
/**
- * @name PWM configuration
+ * @name PWM configuration
* @{
*/
#define PWM_0_EN 1
@@ -181,7 +181,7 @@ static const pwm_conf_t pwm_config[] = {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
* @{
*/
static const spi_conf_t spi_config[] = {
@@ -202,7 +202,7 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name I2C configuration
+ * @name I2C configuration
* @{
*/
#define I2C_NUMOF (1U)
@@ -224,7 +224,7 @@ static const spi_conf_t spi_config[] = {
#define I2C_0_MUX GPIO_MUX_C
/**
- * @name RTC configuration
+ * @name RTC configuration
* @{
*/
#define RTC_NUMOF (1U)
@@ -232,7 +232,7 @@ static const spi_conf_t spi_config[] = {
/** @} */
/**
- * @name RTT configuration
+ * @name RTT configuration
* @{
*/
#define RTT_NUMOF (1U)
diff --git a/boards/telosb/include/board.h b/boards/telosb/include/board.h
index 4e700d9779e00e26d6b0347480f6e431b83000a6..f245040ce84ef3a388b32a821a5b732776f27299 100644
--- a/boards/telosb/include/board.h
+++ b/boards/telosb/include/board.h
@@ -42,7 +42,7 @@ extern "C" {
#endif
/**
- * @brief Override default baudrate for STDIO
+ * @name Override default baudrate for STDIO
* @{
*/
#ifndef UART_STDIO_BAUDRATE
@@ -51,7 +51,7 @@ extern "C" {
/** @} */
/**
- * @brief Xtimer configuration
+ * @name Xtimer configuration
* @{
*/
#define XTIMER_DEV (0)
@@ -61,11 +61,10 @@ extern "C" {
/** @} */
/**
- * @brief CPU core configuration
- *
- * @todo Move this to the periph_conf.h
+ * @name CPU core configuration
* @{
*/
+/** @todo Move this to the periph_conf.h */
#define MSP430_INITIAL_CPU_SPEED 2457600uL
#define F_CPU MSP430_INITIAL_CPU_SPEED
#define F_RC_OSCILLATOR 32768
@@ -74,7 +73,7 @@ extern "C" {
/** @} */
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(4, 0)
diff --git a/boards/telosb/include/periph_conf.h b/boards/telosb/include/periph_conf.h
index 39ecfcfe5f2a57dd48e5bc593d5f212899b14262..55fbc0928e87b5f5d8bf230ada24b284c37cacd8 100644
--- a/boards/telosb/include/periph_conf.h
+++ b/boards/telosb/include/periph_conf.h
@@ -26,17 +26,17 @@ extern "C" {
#endif
/**
- * @brief Clock configuration
- *
- * @todo Move all clock configuration code here from the board.h
+ * @name Clock configuration
+ * @{
*/
+/** @todo Move all clock configuration code here from the board.h */
#define CLOCK_CORECLOCK (2457600U)
#define CLOCK_CMCLK CLOCK_CORECLOCK /* no divider programmed */
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
#define TIMER_NUMOF (1U)
@@ -47,7 +47,7 @@ extern "C" {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
#define UART_NUMOF (1U)
@@ -68,7 +68,7 @@ extern "C" {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
* @{
*/
#define SPI_NUMOF (1U)
diff --git a/boards/udoo/include/board.h b/boards/udoo/include/board.h
index 26f247b9c9d03447f002a1e1a309370784db4cdf..958ec382f78c90cb48f89a815a85e4438524f025 100644
--- a/boards/udoo/include/board.h
+++ b/boards/udoo/include/board.h
@@ -29,7 +29,7 @@ extern "C" {
#endif
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(PB, 27)
@@ -43,7 +43,7 @@ extern "C" {
/** @} */
/**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
diff --git a/boards/udoo/include/periph_conf.h b/boards/udoo/include/periph_conf.h
index d9a729ece450aa98a40ca9343bb1cf70c4593ccb..c00e34921effb9570acc8dd54b9f96d2433a9990 100644
--- a/boards/udoo/include/periph_conf.h
+++ b/boards/udoo/include/periph_conf.h
@@ -1,4 +1,4 @@
-/*
+ /*
* Copyright (C) 2014-2015 Freie Universität Berlin
*
* This file is subject to the terms and conditions of the GNU Lesser
@@ -26,7 +26,7 @@ extern "C" {
#endif
/**
- * @name Clock configuration
+ * @name Clock configuration
* @{
*/
/* targeted system core clock */
@@ -46,7 +46,7 @@ extern "C" {
/** @} */
/**
- * @name Timer peripheral configuration
+ * @name Timer peripheral configuration
* @{
*/
static const timer_conf_t timer_config[] = {
@@ -62,7 +62,7 @@ static const timer_conf_t timer_config[] = {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
static const uart_conf_t uart_config[] = {
@@ -83,7 +83,7 @@ static const uart_conf_t uart_config[] = {
/** @} */
/**
-* @name SPI configuration
+* @name SPI configuration
* @{
*/
static const spi_conf_t spi_config[] = {
diff --git a/boards/waspmote-pro/include/board.h b/boards/waspmote-pro/include/board.h
index 1243fb6b934d2c2d37f12c9b5b8b40c732f14621..107728a67fab925c367a8686999cccbc9fc3c6e3 100644
--- a/boards/waspmote-pro/include/board.h
+++ b/boards/waspmote-pro/include/board.h
@@ -30,15 +30,14 @@ extern "C" {
#endif
/**
-* @brief As the CPU is too slow to handle 115200 baud, we set the default
-* baudrate to 9600 for this board
+* @brief As the CPU is too slow to handle 115200 baud, we set the default
+* baudrate to 9600 for this board
*/
#define UART_STDIO_BAUDRATE (9600U)
-/** @} */
/**
- * @brief Use the UART 0 for STDIO on this board, if the XBee socket is not
- * being used
+ * @brief Use the UART 0 for STDIO on this board, if the XBee socket is not
+ * being used
*/
#ifdef XBEE_UART
#if XBEE_UART == 0
@@ -48,10 +47,8 @@ extern "C" {
#endif
#endif
-/** @} */
-
/**
- * @name LED pin definitions
+ * @name LED pin definitions
* @{
*/
#define LED0_PORT PORTD
@@ -61,7 +58,7 @@ extern "C" {
/** @} */
/**
- * @name Macros for controlling the on-board LEDs.
+ * @name Macros for controlling the on-board LEDs.
* @{
*/
#define LED0_ENABLE_PORT DDRD |= (1 << DDD6)
@@ -84,7 +81,7 @@ extern "C" {
/** @} */
/**
- * @name Macros for controlling the on-board MUXes.
+ * @name Macros for controlling the on-board MUXes.
* @{
*/
#define MUX_PW_PORT PORTD
@@ -146,12 +143,10 @@ extern "C" {
#define SET_MUX_SOCKET0 MUX_PW_ENABLE_PORT; MUX_PW_ON; \
MUX_USB_XBEE_ENABLE_PORT; \
MUX_USB_XBEE_ON
-
-
/** @} */
/**
- * Context swap defines
+ * @brief Context swap defines
* Setup to use PB5 which is pin change interrupt 5
* This emulates a software triggered interrupt
**/
@@ -166,7 +161,7 @@ extern "C" {
/** @endcond */
/**
- * @brief xtimer configuration values
+ * @name xtimer configuration values
* @{
*/
#define XTIMER_WIDTH (16)
@@ -176,7 +171,7 @@ extern "C" {
/** @} */
/**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
diff --git a/boards/waspmote-pro/include/periph_conf.h b/boards/waspmote-pro/include/periph_conf.h
index b7171a474c1d9c3a59a66fb7d9cdcc082cd3c4af..a6c46a9c7eb34f8d880af8e783e800c6b338b5c2 100644
--- a/boards/waspmote-pro/include/periph_conf.h
+++ b/boards/waspmote-pro/include/periph_conf.h
@@ -26,14 +26,14 @@ extern "C" {
#endif
/**
- * @brief Clock configuration
+ * @name Clock configuration
* @{
*/
#define CLOCK_CORECLOCK (14745600L)
/** @} */
/**
- * @name Timer peripheral configuration
+ * @name Timer peripheral configuration
*
* The ATmega1281 has 6 timers. Timer0 and Timer2 are 8 Bit Timers,
* Timer0 has special uses too and therefore we'll avoid using it.
@@ -60,9 +60,8 @@ extern "C" {
#define TIMER_1_ISRC TIMER4_COMPC_vect
/** @} */
-
/**
- * @name UART configuration
+ * @name UART configuration
*
* The UART devices have fixed pin mappings, so all we need to do, is to specify
* which devices we would like to use and their corresponding RX interrupts. See
@@ -85,11 +84,10 @@ extern "C" {
#define UART_4800 (191)
#define UART_9600 (95)
#define UART_115200 (7)
-
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
*
* The atmega1281 has only one hardware SPI with fixed pin configuration, so all
* we can do here, is to enable or disable it...
diff --git a/boards/weio/include/board.h b/boards/weio/include/board.h
index 59fd00116aa81aaf963b8b24c7c8d7a577002b35..624256c6e3c03af2abd38354f1777b7c17d43ad1 100644
--- a/boards/weio/include/board.h
+++ b/boards/weio/include/board.h
@@ -31,7 +31,7 @@ extern "C" {
#endif
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(1, 13)
@@ -57,7 +57,7 @@ extern "C" {
/** @} */
/**
- * @brief Initialize board specific hardware, include clocks, LEDs and stdio
+ * @brief Initialize board specific hardware, include clocks, LEDs and stdio
*/
void board_init(void);
diff --git a/boards/weio/include/periph_conf.h b/boards/weio/include/periph_conf.h
index d971d18b611dbf52904b74a00721058aff866e1c..2a69bd147aace53455fce47ed87f9b7faa644e48 100644
--- a/boards/weio/include/periph_conf.h
+++ b/boards/weio/include/periph_conf.h
@@ -27,14 +27,14 @@ extern "C" {
#endif
/**
- * @brief Clock configuration
+ * @name Clock configuration
* @{
*/
#define CLOCK_CORECLOCK (48000000U)
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
#define TIMER_NUMOF (1U)
@@ -53,7 +53,7 @@ extern "C" {
/* @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
#define UART_NUMOF (1U)
@@ -78,7 +78,7 @@ extern "C" {
/* @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
* @{
*/
static const spi_conf_t spi_config[] = {
@@ -98,7 +98,7 @@ static const spi_conf_t spi_config[] = {
/* @} */
/**
- * @brief PWM configuration
+ * @name PWM configuration
* @{
*/
static const pwm_conf_t pwm_config[] = {
diff --git a/boards/wsn430-common/include/board_common.h b/boards/wsn430-common/include/board_common.h
index ab800b49d55014f98be908c73034af21a901e3a1..fba4a06ebaf2807bbe71e549b9f18e32139fa9b9 100644
--- a/boards/wsn430-common/include/board_common.h
+++ b/boards/wsn430-common/include/board_common.h
@@ -29,12 +29,12 @@ extern "C" {
#endif
/**
- * @brief Address of the info memory
+ * @brief Address of the info memory
*/
#define INFOMEM (0x1000)
/**
- * @brief Xtimer configuration
+ * @name Xtimer configuration
* @{
*/
#define XTIMER_DEV (0)
@@ -44,7 +44,7 @@ extern "C" {
/** @} */
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(4, 4)
diff --git a/boards/wsn430-common/include/periph_conf.h b/boards/wsn430-common/include/periph_conf.h
index 2acd0553b783a3be4910c4454f5c6a2670e071ae..21fbf7b3e16f2d0d0caa294f13d43bc8088a1ac3 100644
--- a/boards/wsn430-common/include/periph_conf.h
+++ b/boards/wsn430-common/include/periph_conf.h
@@ -26,17 +26,17 @@ extern "C" {
#endif
/**
- * @brief Clock configuration
- *
- * @todo Move all clock configuration code here from the board.h
+ * @name Clock configuration
+ * @{
*/
+/** @todo Move all clock configuration code here from the board.h */
#define CLOCK_CORECLOCK (8000000U)
#define CLOCK_CMCLK CLOCK_CORECLOCK /* no divider programmed */
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
#define TIMER_NUMOF (1U)
@@ -47,7 +47,7 @@ extern "C" {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
#define UART_NUMOF (1U)
@@ -68,7 +68,7 @@ extern "C" {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
* @{
*/
#define SPI_NUMOF (1U)
diff --git a/boards/wsn430-v1_3b/include/board.h b/boards/wsn430-v1_3b/include/board.h
index b779f45481f27676649577d1bd164839b91b9161..7256f2d83e8abd9cd66c75b5d0106debaebd37b6 100644
--- a/boards/wsn430-v1_3b/include/board.h
+++ b/boards/wsn430-v1_3b/include/board.h
@@ -42,11 +42,10 @@ extern "C" {
#endif
/**
- * @brief CPU core configuration
- *
- * @todo Move this to the periph_conf.h
+ * @name CPU core configuration
* @{
*/
+/** @todo Move this to the periph_conf.h */
#define MSP430_INITIAL_CPU_SPEED 800000uL
#define F_CPU MSP430_INITIAL_CPU_SPEED
#define F_RC_OSCILLATOR 32768
diff --git a/boards/wsn430-v1_4/include/board.h b/boards/wsn430-v1_4/include/board.h
index c3df1c46ab1f87651928d06d1f93b0bc271f4c0a..d2055666708637a18ba66f2246bb13eb2e6fa32d 100644
--- a/boards/wsn430-v1_4/include/board.h
+++ b/boards/wsn430-v1_4/include/board.h
@@ -42,11 +42,10 @@ extern "C" {
#endif
/**
- * @brief CPU core configuration
- *
- * @todo Move this to the periph_conf.h
+ * @name CPU core configuration
* @{
*/
+/** @todo Move this to the periph_conf.h */
#define MSP430_INITIAL_CPU_SPEED 800000uL
#define F_CPU MSP430_INITIAL_CPU_SPEED
#define F_RC_OSCILLATOR 32768
diff --git a/boards/yunjia-nrf51822/include/board.h b/boards/yunjia-nrf51822/include/board.h
index 42fad7f4fd5fbdb5dc07c0dacdfd0cf9cd44b46b..3075640bcea280222c884ec6a64ce8fd52bf7383 100644
--- a/boards/yunjia-nrf51822/include/board.h
+++ b/boards/yunjia-nrf51822/include/board.h
@@ -28,7 +28,7 @@ extern "C" {
#endif
/**
- * @brief Xtimer configuration
+ * @name Xtimer configuration
* @{
*/
#define XTIMER_DEV (0)
diff --git a/boards/z1/include/board.h b/boards/z1/include/board.h
index 1646253bf38722669c6518b0b01e12db951acab3..0b40bcc64f9430d9d853c8e52bf323b5d1be5ea2 100644
--- a/boards/z1/include/board.h
+++ b/boards/z1/include/board.h
@@ -45,7 +45,7 @@ extern "C" {
#endif
/**
- * @brief Xtimer configuration
+ * @name Xtimer configuration
* @{
*/
#define XTIMER_DEV (0)
@@ -55,11 +55,10 @@ extern "C" {
/** @} */
/**
- * @brief CPU core configuration
- *
- * @todo Move this to the periph_conf.h
+ * @name CPU core configuration
* @{
*/
+/** @todo Move this to the periph_conf.h */
#define MSP430_INITIAL_CPU_SPEED 8000000uL
#ifndef F_CPU
#define F_CPU MSP430_INITIAL_CPU_SPEED
@@ -70,7 +69,7 @@ extern "C" {
/** @} */
/**
- * @brief LED pin definitions and handlers
+ * @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(4, 0)
@@ -95,9 +94,8 @@ extern "C" {
#define LED2_TOGGLE (LED_OUT_REG ^= LED2_MASK)
/** @} */
-
/**
- * @brief User button configuration
+ * @name User button configuration
* @{
*/
#define USER_BTN_PxIN P2IN
diff --git a/boards/z1/include/periph_conf.h b/boards/z1/include/periph_conf.h
index 02bc391e3add132c73b2a5dea072e121603cdfb8..ad0cb8f9fbfd29ca55341debfc4fa3a5edda992e 100644
--- a/boards/z1/include/periph_conf.h
+++ b/boards/z1/include/periph_conf.h
@@ -26,17 +26,17 @@ extern "C" {
#endif
/**
- * @brief Clock configuration
- *
- * @todo Move all clock configuration code here from the board.h
+ * @name Clock configuration
+ * @{
*/
+/** @todo Move all clock configuration code here from the board.h */
#define CLOCK_CORECLOCK (8000000U)
#define CLOCK_CMCLK CLOCK_CORECLOCK /* no divider programmed */
/** @} */
/**
- * @name Timer configuration
+ * @name Timer configuration
* @{
*/
#define TIMER_NUMOF (1U)
@@ -47,7 +47,7 @@ extern "C" {
/** @} */
/**
- * @name UART configuration
+ * @name UART configuration
* @{
*/
#define UART_NUMOF (1U)
@@ -68,7 +68,7 @@ extern "C" {
/** @} */
/**
- * @name SPI configuration
+ * @name SPI configuration
* @{
*/
#define SPI_NUMOF (1U)