libbsp/arm: add doxygen to arm shared headers

c/src/lib/libbsp/arm/shared/armv7m/include/armv7m-irq.h

@@ -1,3 +1,11 @@
+/**
+  *  @file
+  *
+  *  @ingroup arm_shared
+  *
+  *  @brief ARMV7M Support
+  */
+
 /*
  * Copyright (c) 2012 Sebastian Huber.  All rights reserved.
  *

c/src/lib/libbsp/arm/shared/comm/uart.h

@@ -1,3 +1,10 @@
+/**
+  *  @file
+  *
+  *  @ingroup arm_comm
+  *
+  *  @brief UART Support
+  */
 
 /*
  * This software is Copyright (C) 1998 by T.sqware - all rights limited

c/src/lib/libbsp/arm/shared/include/arm-a9mpcore-irq.h

@@ -1,3 +1,11 @@
+/**
+ *  @file
+ *
+ *  @ingroup arm_shared
+ *
+ *  @brief ARM_A9MPCORE_IRQ Support
+ */
+
 /*
  * Copyright (c) 2013 embedded brains GmbH.  All rights reserved.
  *

c/src/lib/libbsp/arm/shared/include/arm-a9mpcore-regs.h

@@ -1,3 +1,11 @@
+/**
+ *  @file
+ *
+ *  @ingroup arm_shared
+ *
+ *  @brief ARM_A9MPCORE_REGS Support
+ */
+
 /*
  * Copyright (c) 2013 embedded brains GmbH.  All rights reserved.
  *

c/src/lib/libbsp/arm/shared/include/arm-a9mpcore-start.h

@@ -1,3 +1,11 @@
+/**
+ *  @file
+ *
+ *  @ingroup arm_shared
+ *
+ *  @brief A9MPCORE_START Support
+ */
+
 /*
  * Copyright (c) 2013 embedded brains GmbH.  All rights reserved.
  *

c/src/lib/libbsp/arm/shared/include/arm-gic-irq.h

@@ -1,3 +1,11 @@
+/**
+ *  @file
+ *
+ *  @ingroup arm_gic
+ *
+ *  @brief ARM GIC IRQ
+ */
+
 /*
  * Copyright (c) 2013 embedded brains GmbH.  All rights reserved.
  *

c/src/lib/libbsp/arm/shared/include/arm-gic-regs.h

@@ -1,3 +1,11 @@
+/**
+ *  @file
+ *
+ *  @ingroup arm_gic
+ *
+ *  @brief ARM GIC Register definitions
+ */
+
 /*
  * Copyright (c) 2013 embedded brains GmbH.  All rights reserved.
  *

c/src/lib/libbsp/arm/shared/include/arm-gic-tm27.h

@@ -1,3 +1,11 @@
+/**
+ *  @file
+ *
+ *  @ingroup arm_gic
+ *
+ *  @brief ARM GIC TM27 Support
+ */
+
 /*
  * Copyright (c) 2013 embedded brains GmbH.  All rights reserved.
  *

c/src/lib/libbsp/arm/shared/include/arm-gic.h

@@ -1,3 +1,11 @@
+/**
+ *  @file
+ *
+ *  @ingroup arm_gic
+ *
+ *  @brief ARM GIC Support
+ */
+
 /*
  * Copyright (c) 2013 embedded brains GmbH.  All rights reserved.
  *
@@ -23,6 +31,14 @@
 extern "C" {
 #endif /* __cplusplus */
 
+/**
+ *  @defgroup arm_gic ARM GIC
+ *
+ *  @ingroup arm_shared
+ *
+ *  @brief ARM_GIC Support Package
+ */
+
 #define GIC_ID_TO_ONE_BIT_REG_INDEX(id) ((id) >> 5)
 #define GIC_ID_TO_ONE_BIT_REG_BIT(id) (1U << ((id) & 0x1fU))
 

c/src/lib/libbsp/arm/shared/include/arm-pl011-regs.h

@@ -1,3 +1,11 @@
+/**
+ *  @file
+ *
+ *  @ingroup arm_shared
+ *
+ *  @brief ARM PL011 Register definitions
+ */
+
 /*
  * Copyright (c) 2013 embedded brains GmbH.  All rights reserved.
  *

c/src/lib/libbsp/arm/shared/include/arm-pl011.h

@@ -1,3 +1,11 @@
+/**
+  *  @file
+  *
+  *  @ingroup arm_shared
+  *
+  *  @brief ARM PL011 Support Package
+  */
+
 /*
  * Copyright (c) 2013 embedded brains GmbH.  All rights reserved.
  *

c/src/lib/libbsp/arm/shared/include/arm-pl050-regs.h

@@ -1,3 +1,11 @@
+/**
+ *  @file
+ *
+ *  @ingroup arm_shared
+ *
+ *  @brief ARM PL050 Register Definitions
+ */
+
 /*
  * Copyright (c) 2013 embedded brains GmbH.  All rights reserved.
  *

c/src/lib/libbsp/arm/shared/include/arm-pl050.h

@@ -1,3 +1,11 @@
+/**
+ *  @file
+ *
+ *  @ingroup arm_shared
+ *
+ *  @brief ARM PL050 Support
+ */
+
 /*
  * Copyright (c) 2013 embedded brains GmbH.  All rights reserved.
  *

c/src/lib/libbsp/arm/shared/include/arm-pl111-fb.h

@@ -1,3 +1,11 @@
+/**
+ *  @file
+ *
+ *  @ingroup arm_shared
+ *
+ *  @brief ARM PL111 FB Support
+ */
+
 /*
  * Copyright (c) 2013 embedded brains GmbH.  All rights reserved.
  *

c/src/lib/libbsp/arm/shared/include/arm-pl111-regs.h

@@ -1,3 +1,11 @@
+/**
+ *  @file
+ *
+ *  @ingroup arm_shared
+ *
+ *  @brief ARM PL111 Register definitions
+ */
+
 /*
  * Copyright (c) 2013 embedded brains GmbH.  All rights reserved.
  *