[rtems commit] leon2_doxygen_1
Gedare Bloom
gedare at rtems.org
Tue Dec 3 03:31:56 UTC 2013
Module: rtems
Branch: master
Commit: 8d830fae236dc04bc8f38498bafb3ff5cc615a89
Changeset: http://git.rtems.org/rtems/commit/?id=8d830fae236dc04bc8f38498bafb3ff5cc615a89
Author: Radu <radustoma at yahoo.com>
Date: Mon Dec 2 14:07:35 2013 -0600
leon2_doxygen_1
---
c/src/lib/libbsp/sparc/leon2/clock/ckinit.c | 6 ++++++
c/src/lib/libbsp/sparc/leon2/console/console.c | 6 ++++++
c/src/lib/libbsp/sparc/leon2/console/debugputs.c | 6 ++++++
c/src/lib/libbsp/sparc/leon2/gnatsupp/gnatsupp.c | 6 ++++++
c/src/lib/libbsp/sparc/leon2/include/bsp.h | 7 +++++++
c/src/lib/libbsp/sparc/leon2/include/bsp/irq.h | 6 ++++++
c/src/lib/libbsp/sparc/leon2/include/cchip.h | 7 +++++++
c/src/lib/libbsp/sparc/leon2/include/leon.h | 7 +++++++
c/src/lib/libbsp/sparc/leon2/include/rasta.h | 7 +++++++
c/src/lib/libbsp/sparc/leon2/include/tm27.h | 6 ++++++
.../sparc/leon2/leon_smc91111/leon_smc91111.c | 6 ++++++
c/src/lib/libbsp/sparc/leon2/pci/pci.c | 6 ++++++
c/src/lib/libbsp/sparc/leon2/rasta/rasta.c | 6 ++++++
c/src/lib/libbsp/sparc/leon2/startup/bspdelay.c | 6 +++---
c/src/lib/libbsp/sparc/leon2/startup/bspidle.c | 6 ++++++
.../lib/libbsp/sparc/leon2/startup/bsppredriver.c | 6 ++++++
c/src/lib/libbsp/sparc/leon2/startup/bspstart.c | 6 ++++++
c/src/lib/libbsp/sparc/leon2/startup/setvec.c | 6 ++++++
c/src/lib/libbsp/sparc/leon2/startup/spurious.c | 6 ++++++
c/src/lib/libbsp/sparc/leon2/timer/timer.c | 6 ++++++
20 files changed, 121 insertions(+), 3 deletions(-)
diff --git a/c/src/lib/libbsp/sparc/leon2/clock/ckinit.c b/c/src/lib/libbsp/sparc/leon2/clock/ckinit.c
index d2d883c..b830bfd 100644
--- a/c/src/lib/libbsp/sparc/leon2/clock/ckinit.c
+++ b/c/src/lib/libbsp/sparc/leon2/clock/ckinit.c
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief Clock Tick Device Driver
+ */
+
/*
* Clock Tick Device Driver
*
diff --git a/c/src/lib/libbsp/sparc/leon2/console/console.c b/c/src/lib/libbsp/sparc/leon2/console/console.c
index e10fae8..6adefa1 100644
--- a/c/src/lib/libbsp/sparc/leon2/console/console.c
+++ b/c/src/lib/libbsp/sparc/leon2/console/console.c
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief TTY driver driver for the serial ports on the LEON console
+ */
+
/*
* This file contains the TTY driver for the serial ports on the LEON.
*
diff --git a/c/src/lib/libbsp/sparc/leon2/console/debugputs.c b/c/src/lib/libbsp/sparc/leon2/console/debugputs.c
index 452cf0a..1e3f511 100644
--- a/c/src/lib/libbsp/sparc/leon2/console/debugputs.c
+++ b/c/src/lib/libbsp/sparc/leon2/console/debugputs.c
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief 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/c/src/lib/libbsp/sparc/leon2/gnatsupp/gnatsupp.c b/c/src/lib/libbsp/sparc/leon2/gnatsupp/gnatsupp.c
index 4fe9320..b3a7c18 100644
--- a/c/src/lib/libbsp/sparc/leon2/gnatsupp/gnatsupp.c
+++ b/c/src/lib/libbsp/sparc/leon2/gnatsupp/gnatsupp.c
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief Support for gnat/rtems iterrupts and exception handling
+ */
+
/*
*
* Support for gnat/rtems interrupts and exception handling.
diff --git a/c/src/lib/libbsp/sparc/leon2/include/bsp.h b/c/src/lib/libbsp/sparc/leon2/include/bsp.h
index 19fc487..db8baca 100644
--- a/c/src/lib/libbsp/sparc/leon2/include/bsp.h
+++ b/c/src/lib/libbsp/sparc/leon2/include/bsp.h
@@ -1,3 +1,10 @@
+/**
+ * @file
+ * @defgroup sparc_leon2 Sparc Leon2 Handler
+ * @ingroup bsp_kit
+ * @brief Handles Sparc Leon2 simulator
+ */
+
/* bsp.h
*
* This include file contains all SPARC simulator definitions.
diff --git a/c/src/lib/libbsp/sparc/leon2/include/bsp/irq.h b/c/src/lib/libbsp/sparc/leon2/include/bsp/irq.h
index 709b563..acf1f7b 100644
--- a/c/src/lib/libbsp/sparc/leon2/include/bsp/irq.h
+++ b/c/src/lib/libbsp/sparc/leon2/include/bsp/irq.h
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief Interrupts definitions
+ */
+
/* LEON2 generic shared IRQ setup
*
* Based on libbsp/shared/include/irq.h.
diff --git a/c/src/lib/libbsp/sparc/leon2/include/cchip.h b/c/src/lib/libbsp/sparc/leon2/include/cchip.h
index 216d3fb..beb9f74 100644
--- a/c/src/lib/libbsp/sparc/leon2/include/cchip.h
+++ b/c/src/lib/libbsp/sparc/leon2/include/cchip.h
@@ -1,3 +1,10 @@
+/**
+ * @file
+ * @defgroup cchip Companion Chip handler
+ * @ingroup sparc_leon2
+ * @brief Register all drivers supported by the Companion Chip board
+ */
+
#ifndef __CCHIP_H__
#define __CCHIP_H__
diff --git a/c/src/lib/libbsp/sparc/leon2/include/leon.h b/c/src/lib/libbsp/sparc/leon2/include/leon.h
index 8aab12d..e3d39dc 100644
--- a/c/src/lib/libbsp/sparc/leon2/include/leon.h
+++ b/c/src/lib/libbsp/sparc/leon2/include/leon.h
@@ -1,3 +1,10 @@
+/**
+ * @file
+ * @defgroup leon1 Leon-1 Handler
+ * @ingroup sparc_leon2
+ * @brief Handlers Leon-1
+ */
+
/* erc32.h
*
* This include file contains information pertaining to the LEON-1.
diff --git a/c/src/lib/libbsp/sparc/leon2/include/rasta.h b/c/src/lib/libbsp/sparc/leon2/include/rasta.h
index 123cb22..0073ad7 100644
--- a/c/src/lib/libbsp/sparc/leon2/include/rasta.h
+++ b/c/src/lib/libbsp/sparc/leon2/include/rasta.h
@@ -1,3 +1,10 @@
+/**
+ * @file
+ * @defgroup leon2_rasta Rasta Handler
+ * @ingroup sparc_leon2
+ * @brief Handles Rasta
+ */
+
#ifndef __RASTA_H__
#define __RASTA_H__
diff --git a/c/src/lib/libbsp/sparc/leon2/include/tm27.h b/c/src/lib/libbsp/sparc/leon2/include/tm27.h
index 8e8e43c..09b3937 100644
--- a/c/src/lib/libbsp/sparc/leon2/include/tm27.h
+++ b/c/src/lib/libbsp/sparc/leon2/include/tm27.h
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief Implementations for interrupt mechanisms for Time Test 27
+ */
+
/*
* tm27.h
*
diff --git a/c/src/lib/libbsp/sparc/leon2/leon_smc91111/leon_smc91111.c b/c/src/lib/libbsp/sparc/leon2/leon_smc91111/leon_smc91111.c
index bbdd072..ad74c9a 100644
--- a/c/src/lib/libbsp/sparc/leon2/leon_smc91111/leon_smc91111.c
+++ b/c/src/lib/libbsp/sparc/leon2/leon_smc91111/leon_smc91111.c
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief SMC91111 Driver
+ */
+
#include <rtems.h>
#include <bsp.h>
diff --git a/c/src/lib/libbsp/sparc/leon2/pci/pci.c b/c/src/lib/libbsp/sparc/leon2/pci/pci.c
index 7f48b1e..2fdacd1 100644
--- a/c/src/lib/libbsp/sparc/leon2/pci/pci.c
+++ b/c/src/lib/libbsp/sparc/leon2/pci/pci.c
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief Basic PCI Io functions
+ */
+
/*
* pci.c : this file contains basic PCI Io functions.
*
diff --git a/c/src/lib/libbsp/sparc/leon2/rasta/rasta.c b/c/src/lib/libbsp/sparc/leon2/rasta/rasta.c
index 087f9be..754a6ff 100644
--- a/c/src/lib/libbsp/sparc/leon2/rasta/rasta.c
+++ b/c/src/lib/libbsp/sparc/leon2/rasta/rasta.c
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup leon2_rasta
+ * @brief GR-RASTA-IO PCI board driver
+ */
+
/*
* GR-RASTA-IO PCI board driver
*
diff --git a/c/src/lib/libbsp/sparc/leon2/startup/bspdelay.c b/c/src/lib/libbsp/sparc/leon2/startup/bspdelay.c
index cca9377..341b0c1 100644
--- a/c/src/lib/libbsp/sparc/leon2/startup/bspdelay.c
+++ b/c/src/lib/libbsp/sparc/leon2/startup/bspdelay.c
@@ -1,7 +1,7 @@
/**
- * @file
- *
- * LEON2 BSP Delay Method
+ * @file
+ * @ingroup sparc_leon2
+ * @brief LEON2 BSP Delay Method
*/
/*
diff --git a/c/src/lib/libbsp/sparc/leon2/startup/bspidle.c b/c/src/lib/libbsp/sparc/leon2/startup/bspidle.c
index 54108c3..552dea4 100644
--- a/c/src/lib/libbsp/sparc/leon2/startup/bspidle.c
+++ b/c/src/lib/libbsp/sparc/leon2/startup/bspidle.c
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief LEON2 Idle Thread
+ */
+
/*
* LEON2 Idle Thread with power-down function
*
diff --git a/c/src/lib/libbsp/sparc/leon2/startup/bsppredriver.c b/c/src/lib/libbsp/sparc/leon2/startup/bsppredriver.c
index 4084b5c..7a12c8f 100644
--- a/c/src/lib/libbsp/sparc/leon2/startup/bsppredriver.c
+++ b/c/src/lib/libbsp/sparc/leon2/startup/bsppredriver.c
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief Installs BSP pre-driver hook
+ */
+
/* Installs the BSP pre-driver hook
*
* COPYRIGHT (c) 2011
diff --git a/c/src/lib/libbsp/sparc/leon2/startup/bspstart.c b/c/src/lib/libbsp/sparc/leon2/startup/bspstart.c
index 0fbb969..eadf658 100644
--- a/c/src/lib/libbsp/sparc/leon2/startup/bspstart.c
+++ b/c/src/lib/libbsp/sparc/leon2/startup/bspstart.c
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief LEON2 Cache Snooping Support
+ */
+
/*
* LEON2 Cache Snooping Support
*
diff --git a/c/src/lib/libbsp/sparc/leon2/startup/setvec.c b/c/src/lib/libbsp/sparc/leon2/startup/setvec.c
index d5f69ee..8513380 100644
--- a/c/src/lib/libbsp/sparc/leon2/startup/setvec.c
+++ b/c/src/lib/libbsp/sparc/leon2/startup/setvec.c
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief Installs an interrupt vector on the SPARC simulator
+ */
+
/* set_vector
*
* This routine installs an interrupt vector on the SPARC simulator.
diff --git a/c/src/lib/libbsp/sparc/leon2/startup/spurious.c b/c/src/lib/libbsp/sparc/leon2/startup/spurious.c
index c0500c7..0aa6826 100644
--- a/c/src/lib/libbsp/sparc/leon2/startup/spurious.c
+++ b/c/src/lib/libbsp/sparc/leon2/startup/spurious.c
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief LEON Spurious Trap Handler
+ */
+
/*
* LEON Spurious Trap Handler
*
diff --git a/c/src/lib/libbsp/sparc/leon2/timer/timer.c b/c/src/lib/libbsp/sparc/leon2/timer/timer.c
index 999b21e..3fdb322 100644
--- a/c/src/lib/libbsp/sparc/leon2/timer/timer.c
+++ b/c/src/lib/libbsp/sparc/leon2/timer/timer.c
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief Implement a benchmark timer using timer 2
+ */
+
/* timer.c
*
* This file implements a benchmark timer using timer 2.
More information about the vc
mailing list