summaryrefslogtreecommitdiff
path: root/bsps
diff options
context:
space:
mode:
Diffstat (limited to 'bsps')
-rw-r--r--bsps/include/bsp/fatal.h15
-rw-r--r--bsps/shared/cache/cacheimpl.h9
-rw-r--r--bsps/shared/doxygen.h8
-rw-r--r--bsps/shared/rtems-version.c9
-rw-r--r--bsps/sparc/include/bsp/gnatcommon.h15
-rw-r--r--bsps/sparc/include/bsp/gr_leon4_n2x.h9
-rw-r--r--bsps/sparc/include/drvmgr/leon2_amba_bus.h9
-rw-r--r--bsps/sparc/leon3/clock/ckinit.c9
-rw-r--r--bsps/sparc/leon3/console/printk_support.c9
-rw-r--r--bsps/sparc/leon3/start/bspstart.c9
-rw-r--r--bsps/sparc/leon3/start/cache.c9
-rw-r--r--bsps/sparc/leon3/start/cpucounter.c9
-rw-r--r--bsps/sparc/leon3/start/eirq.c9
-rw-r--r--bsps/sparc/shared/doxygen.h8
-rw-r--r--bsps/sparc/shared/irq/bsp_isr_handler.c9
15 files changed, 145 insertions, 0 deletions
diff --git a/bsps/include/bsp/fatal.h b/bsps/include/bsp/fatal.h
index 3430effb18..983cef2f9c 100644
--- a/bsps/include/bsp/fatal.h
+++ b/bsps/include/bsp/fatal.h
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsFatal
+ *
+ * @brief This header file provides interfaces of the
+ * BSP fatal codes.
+ */
+
/*
* Copyright (c) 2012, 2018 embedded brains GmbH. All rights reserved.
*
@@ -6,6 +15,12 @@
* http://www.rtems.org/license/LICENSE.
*/
+/**
+ * @defgroup RTEMSBSPsFatal BSP fatal codes
+ *
+ * @ingroup RTEMSBSPs
+ */
+
#ifndef LIBBSP_SHARED_BSP_FATAL_H
#define LIBBSP_SHARED_BSP_FATAL_H
diff --git a/bsps/shared/cache/cacheimpl.h b/bsps/shared/cache/cacheimpl.h
index 16fe59d804..3783cd2aa3 100644
--- a/bsps/shared/cache/cacheimpl.h
+++ b/bsps/shared/cache/cacheimpl.h
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup CACHE_MGR
+ *
+ * @brief This header file provides interfaces of the
+ * RTEMS Cache Manager.
+ */
+
/*
* Cache Manager
*
diff --git a/bsps/shared/doxygen.h b/bsps/shared/doxygen.h
index d3679c2f3d..fa16512d45 100644
--- a/bsps/shared/doxygen.h
+++ b/bsps/shared/doxygen.h
@@ -1,4 +1,12 @@
/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines Doxygen groups.
+ */
+
+/**
* @defgroup RTEMSBSPs Board Support Packages
*
* @brief This group contains the Board Support Packages (BSPs).
diff --git a/bsps/shared/rtems-version.c b/bsps/shared/rtems-version.c
index b12504a1c9..258f420dec 100644
--- a/bsps/shared/rtems-version.c
+++ b/bsps/shared/rtems-version.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSAPIClassicVersion
+ *
+ * @brief This header file provides interfaces of the
+ * RTEMS versions.
+ */
+
/*
* COPYRIGHT (c) 2003, Ralf Corsepius, Ulm, Germany.
* COPYRIGHT (c) 2003, On-Line Applications Research Corporation (OAR).
diff --git a/bsps/sparc/include/bsp/gnatcommon.h b/bsps/sparc/include/bsp/gnatcommon.h
index 1a04449293..40e8829bb9 100644
--- a/bsps/sparc/include/bsp/gnatcommon.h
+++ b/bsps/sparc/include/bsp/gnatcommon.h
@@ -1,3 +1,18 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplGnat
+ *
+ * @brief This header file provides interfaces of the
+ * gnat/rtems interrupts and exception handling.
+ */
+
+/**
+ * @defgroup RTEMSImplGnat GNAT/RTEMS interrupts and exception handling
+ *
+ * @ingroup RTEMSImpl
+ */
+
#ifndef __GNATCOMMON_H
#define __GNATCOMMON_H
diff --git a/bsps/sparc/include/bsp/gr_leon4_n2x.h b/bsps/sparc/include/bsp/gr_leon4_n2x.h
index 9a8041202a..7f67d7b297 100644
--- a/bsps/sparc/include/bsp/gr_leon4_n2x.h
+++ b/bsps/sparc/include/bsp/gr_leon4_n2x.h
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This header file provides interfaces of the
+ * GR-CPCI-LEON4-N2X (NGFP) PCI Peripheral driver
+ */
+
/* GR-CPCI-LEON4-N2X (NGFP) PCI Peripheral driver
*
* COPYRIGHT (c) 2013.
diff --git a/bsps/sparc/include/drvmgr/leon2_amba_bus.h b/bsps/sparc/include/drvmgr/leon2_amba_bus.h
index 1b35413c30..4bf22cc7e1 100644
--- a/bsps/sparc/include/drvmgr/leon2_amba_bus.h
+++ b/bsps/sparc/include/drvmgr/leon2_amba_bus.h
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsSPARCLEON2
+ *
+ * @brief This header file provides interfaces of the
+ * LEON2 Hardcoded bus driver interface.
+ */
+
/* LEON2 Hardcoded bus driver interface.
*
* COPYRIGHT (c) 2008.
diff --git a/bsps/sparc/leon3/clock/ckinit.c b/bsps/sparc/leon3/clock/ckinit.c
index 4f7fa7ab78..17b653571c 100644
--- a/bsps/sparc/leon3/clock/ckinit.c
+++ b/bsps/sparc/leon3/clock/ckinit.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This source file contains a definition of
+ * the Clock Tick Device Driver.
+ */
+
/*
* Clock Tick Device Driver
*
diff --git a/bsps/sparc/leon3/console/printk_support.c b/bsps/sparc/leon3/console/printk_support.c
index b2e9850eb5..7e66627d7d 100644
--- a/bsps/sparc/leon3/console/printk_support.c
+++ b/bsps/sparc/leon3/console/printk_support.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This source file contains a definition of
+ * the TTY driver for the serial ports on the LEON.
+ */
+
/*
* This file contains the TTY driver for the serial ports on the LEON.
*
diff --git a/bsps/sparc/leon3/start/bspstart.c b/bsps/sparc/leon3/start/bspstart.c
index 373121e0ba..373a9ebfca 100644
--- a/bsps/sparc/leon3/start/bspstart.c
+++ b/bsps/sparc/leon3/start/bspstart.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This source file contains a definition of
+ * a set of routines which start the application.
+ */
+
/*
* This set of routines starts the application. It includes application,
* board, and monitor specific initialization and configuration.
diff --git a/bsps/sparc/leon3/start/cache.c b/bsps/sparc/leon3/start/cache.c
index e507e66e7e..8b3b209d92 100644
--- a/bsps/sparc/leon3/start/cache.c
+++ b/bsps/sparc/leon3/start/cache.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This source file contains a definition of
+ * LEON3 CPU cache support.
+ */
+
/*
* Copyright (c) 2014 embedded brains GmbH. All rights reserved.
*
diff --git a/bsps/sparc/leon3/start/cpucounter.c b/bsps/sparc/leon3/start/cpucounter.c
index e20684aa56..b822efb5bb 100644
--- a/bsps/sparc/leon3/start/cpucounter.c
+++ b/bsps/sparc/leon3/start/cpucounter.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This source file contains a definition of
+ * LEON3 CPU counter support.
+ */
+
/*
* Copyright (c) 2014, 2018 embedded brains GmbH. All rights reserved.
*
diff --git a/bsps/sparc/leon3/start/eirq.c b/bsps/sparc/leon3/start/eirq.c
index 0dedc66d95..5b8366492b 100644
--- a/bsps/sparc/leon3/start/eirq.c
+++ b/bsps/sparc/leon3/start/eirq.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This source file contains a definition of
+ * the GRLIB/LEON3 extended interrupt controller.
+ */
+
/*
* GRLIB/LEON3 extended interrupt controller
*
diff --git a/bsps/sparc/shared/doxygen.h b/bsps/sparc/shared/doxygen.h
index 100a9b6c18..82e5feb023 100644
--- a/bsps/sparc/shared/doxygen.h
+++ b/bsps/sparc/shared/doxygen.h
@@ -1,4 +1,12 @@
/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines Doxygen groups.
+ */
+
+/**
* @defgroup RTEMSBSPsSPARC SPARC
*
* @ingroup RTEMSBSPs
diff --git a/bsps/sparc/shared/irq/bsp_isr_handler.c b/bsps/sparc/shared/irq/bsp_isr_handler.c
index 1541aa236f..60fa5309ec 100644
--- a/bsps/sparc/shared/irq/bsp_isr_handler.c
+++ b/bsps/sparc/shared/irq/bsp_isr_handler.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This source file contains a definition of
+ * ::_SPARC_Interrupt_dispatch.
+ */
+
/*
* COPYRIGHT (c) 2015
* Cobham Gaisler