boards: fixed doxygen in msp430 and x86 board.h

boards/chronos/include/board.h

@@ -27,7 +27,9 @@
 extern "C" {
 #endif
 
-/* for correct inclusion of <msp430.h> */
+/**
+ * @brief   Define the CPU model for the <msp430.h>
+ */
 #ifndef __CC430F6137__
 #define __CC430F6137__
 #endif

boards/msb-430/include/board.h

@@ -40,17 +40,25 @@
 extern "C" {
 #endif
 
-/*  for correct inclusion of <msp430.h> */
+/**
+ * @brief   Define the CPU model for the <msp430.h>
+ */
 #ifndef __MSP430F1612__
 #define __MSP430F1612__
 #endif
 
-/* MSB430 core */
+/**
+ * @brief   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
 #define MSP430_HAS_DCOR             1
 #define MSP430_HAS_EXTERNAL_CRYSTAL 0
+/** @} */
 
 #ifdef __cplusplus
 }

boards/msb-430h/include/board.h

@@ -28,17 +28,25 @@
 extern "C" {
 #endif
 
-/* for correct inclusion of <msp430.h> */
+/**
+ * @brief   Define the CPU model for the <msp430.h>
+ */
 #ifndef __MSP430F1612__
 #define __MSP430F1612__
 #endif
 
-//MSB430 core
+/**
+ * @brief   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
 #define MSP430_HAS_DCOR             1
 #define MSP430_HAS_EXTERNAL_CRYSTAL 1
+/** @} */
 
 #ifdef __cplusplus
 }

boards/qemu-i386/include/board.h

@@ -25,8 +25,13 @@
 extern "C" {
 #endif
 
+/**
+ * @brief   Serial port configuration
+ * @{
+ */
 #define UART_PORT (COM1_PORT) /* IO port to use for UART */
 #define UART_IRQ (COM1_IRQ)   /* IRQ line to use for UART */
+/** @} */
 
 #ifdef __cplusplus
 }

boards/samr21-xpro/include/board.h

@@ -31,10 +31,12 @@ extern "C" {
 #endif
 
 /**
- * Assign the hardware timer
+ * @brief   xtimer configuration
+ * @{
  */
 #define XTIMER              TIMER_1
 #define XTIMER_CHAN         (0)
+/** @} */
 
 /**
  * @name AT86RF233 configuration

boards/telosb/include/board.h

@@ -34,7 +34,9 @@
 extern "C" {
 #endif
 
-/*  for correct inclusion of <msp430.h> */
+/**
+ * @brief   Define the CPU model for the <msp430.h>
+ */
 #ifndef __MSP430F1611__
 #define __MSP430F1611__
 #endif
@@ -50,12 +52,18 @@ extern "C" {
 #define XTIMER_BACKOFF              (40)
 /** @} */
 
-/* TelosB core */
+/**
+ * @brief   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
 #define MSP430_HAS_DCOR             0
 #define MSP430_HAS_EXTERNAL_CRYSTAL 1
+/** @} */
 
 /**
  * @brief   LED pin definitions and handlers
@@ -87,7 +95,5 @@ extern "C" {
 }
 #endif
 
-#include <stdint.h>
-
 /** @} */
 #endif /*  TELOSB_BOARD_H_ */

boards/wsn430-v1_3b/include/board.h

@@ -34,17 +34,25 @@
 extern "C" {
 #endif
 
-// for correct inclusion of <msp430.h>
+/**
+ * @brief   Define the CPU model for the <msp430.h>
+ */
 #ifndef __MSP430F1611__
 #define __MSP430F1611__
 #endif
 
-//MSB430 core
+/**
+ * @brief   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
 #define MSP430_HAS_DCOR             0
 #define MSP430_HAS_EXTERNAL_CRYSTAL 1
+/** @} */
 
 #ifdef __cplusplus
 }

boards/wsn430-v1_4/include/board.h

@@ -34,17 +34,25 @@
 extern "C" {
 #endif
 
-/*  for correct inclusion of <msp430.h> */
+/**
+ * @brief   Define the CPU model for the <msp430.h>
+ */
 #ifndef __MSP430F1611__
 #define __MSP430F1611__
 #endif
 
-/* MSB430 core */
+/**
+ * @brief   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
 #define MSP430_HAS_DCOR             0
 #define MSP430_HAS_EXTERNAL_CRYSTAL 1
+/** @} */
 
 #ifdef __cplusplus
 }

boards/z1/include/board.h

@@ -37,6 +37,9 @@
 extern "C" {
 #endif
 
+/**
+ * @brief   Define the CPU model for the <msp430.h>
+ */
 #ifndef __MSP430F2617__
 #define __MSP430F2617__
 #endif
@@ -61,7 +64,12 @@ extern "C" {
 #define UART_STDIO_RX_BUFSIZE       (64U)
 /** @} */
 
-/*  MSP430 core */
+/**
+ * @brief   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
@@ -69,6 +77,7 @@ extern "C" {
 #define F_RC_OSCILLATOR             32768
 #define MSP430_HAS_DCOR             0
 #define MSP430_HAS_EXTERNAL_CRYSTAL 1
+/** @} */
 
 /**
  * @brief   LED pin definitions and handlers
@@ -97,12 +106,16 @@ extern "C" {
 /** @} */
 
 
-/*  User-button port */
+/**
+ * @brief   User button configuration
+ * @{
+ */
 #define USER_BTN_PxIN      P2IN
 #define USER_BTN_MASK      0x20
 
 #define USER_BTN_PRESSED   ((USER_BTN_PxIN & USER_BTN_MASK) == 0)
 #define USER_BTN_RELEASED  ((USER_BTN_PxIN & USER_BTN_MASK) != 0)
+/** @} */
 
 #ifdef __cplusplus
 }