git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@717 35acf78f-673a-0410-8e92-d51de3d6d3f4

15 files changed, 87 insertions, 34 deletions

diff --git a/ports/ARM7/chcore.c b/ports/ARM7/chcore.c
index 9ffe94ac5..fd7661373 100644
--- a/ports/ARM7/chcore.c
+++ b/ports/ARM7/chcore.c
@@ -18,6 +18,8 @@
 */

 

 /**

+ * @file ports/ARM7/chcore.c

+ * @brief ARM7 architecture port code.

  * @addtogroup ARM7_CORE

  * @{

  */

diff --git a/ports/ARM7/chcore.h b/ports/ARM7/chcore.h
index 41efb7f7e..9f75df2cb 100644
--- a/ports/ARM7/chcore.h
+++ b/ports/ARM7/chcore.h
@@ -18,6 +18,8 @@
 */

 

 /**

+ * @file ports/ARM7/chcore.h

+ * @brief ARM7 architecture port macros and structures.

  * @addtogroup ARM7_CORE

  * @{

  */

diff --git a/ports/ARM7/chcoreasm.s b/ports/ARM7/chcoreasm.s
index e8fd2881d..9c24de407 100644
--- a/ports/ARM7/chcoreasm.s
+++ b/ports/ARM7/chcoreasm.s
@@ -17,8 +17,11 @@
     along with this program.  If not, see <http://www.gnu.org/licenses/>.

 */

 

-/*

- * ARM7 port system code.

+/**

+ * @file ports/ARM7/chcoreasm.s

+ * @brief ARM7 architecture port low level code.

+ * @addtogroup ARM7_CORE

+ * @{

  */

 

 #include <chconf.h>

@@ -225,3 +228,5 @@ _port_thread_start:
 jmpr4:

         bx      r4

 #endif /* !THUMB_NO_INTERWORKING */

+

+/** @} */

diff --git a/ports/ARM7/chtypes.h b/ports/ARM7/chtypes.h
index faf0ee0fc..570c719da 100644
--- a/ports/ARM7/chtypes.h
+++ b/ports/ARM7/chtypes.h
@@ -18,6 +18,8 @@
 */

 

 /**

+ * @file ports/ARM7/chtypes.h

+ * @brief ARM7 architecture port system types.

  * @addtogroup ARM7_CORE

  * @{

  */

diff --git a/ports/ARM7/crt0.s b/ports/ARM7/crt0.s
index c5a341793..b910293b9 100644
--- a/ports/ARM7/crt0.s
+++ b/ports/ARM7/crt0.s
@@ -17,8 +17,11 @@
     along with this program.  If not, see <http://www.gnu.org/licenses/>.

 */

 

-/*

- * Generic ARM7 startup file for ChibiOS/RT.

+/**

+ * @file ports/ARM7/crt0.s

+ * @brief Generic ARM7 startup file for ChibiOS/RT.

+ * @addtogroup ARM7_CORE

+ * @{

  */

 

 .set    MODE_USR, 0x10

@@ -189,3 +192,5 @@ hwinit0:
 .thumb_func

 hwinit1:

         bx      lr

+

+/** @} */

diff --git a/ports/ARMCM3/chcore.c b/ports/ARMCM3/chcore.c
index 8edbb658a..5f4b87dee 100644
--- a/ports/ARMCM3/chcore.c
+++ b/ports/ARMCM3/chcore.c
@@ -18,6 +18,8 @@
 */

 

 /**

+ * @file ports/ARMCM3/chcore.c

+ * @brief ARM Cortex-M3 architecture port code.

  * @addtogroup ARMCM3_CORE

  * @{

  */

diff --git a/ports/ARMCM3/chcore.h b/ports/ARMCM3/chcore.h
index 638995f1c..b45da04bb 100644
--- a/ports/ARMCM3/chcore.h
+++ b/ports/ARMCM3/chcore.h
@@ -18,6 +18,8 @@
 */

 

 /**

+ * @file ports/ARMCM3/chcore.h

+ * @brief ARM Cortex-M3 architecture port macros and structures.

  * @addtogroup ARMCM3_CORE

  * @{

  */

diff --git a/ports/ARMCM3/chtypes.h b/ports/ARMCM3/chtypes.h
index 4f00eb65f..7373b9823 100644
--- a/ports/ARMCM3/chtypes.h
+++ b/ports/ARMCM3/chtypes.h
@@ -17,6 +17,13 @@
     along with this program.  If not, see <http://www.gnu.org/licenses/>.

 */

 

+/**

+ * @file ports/ARMCM3/chtypes.h

+ * @brief ARM Cortex-M3 architecture port system types.

+ * @addtogroup ARMCM3_CORE

+ * @{

+ */

+

 #ifndef _CHTYPES_H_

 #define _CHTYPES_H_

 

@@ -29,15 +36,15 @@
 #include <stdint.h>

 #endif

 

-typedef int32_t         bool_t;

-typedef uint8_t         tmode_t;

-typedef uint8_t         tstate_t;

-typedef uint32_t        tprio_t;

-typedef int32_t         msg_t;

-typedef int32_t         eventid_t;

-typedef uint32_t        eventmask_t;

-typedef uint32_t        systime_t;

-typedef int32_t         cnt_t;

+typedef int32_t         bool_t;         /**< Fast boolean type. */

+typedef uint8_t         tmode_t;        /**< Thread flags. */

+typedef uint8_t         tstate_t;       /**< Thread state. */

+typedef uint32_t        tprio_t;        /**< Thread priority. */

+typedef int32_t         msg_t;          /**< Inter-thread message. */

+typedef int32_t         eventid_t;      /**< Event Id. */

+typedef uint32_t        eventmask_t;    /**< Events mask. */

+typedef uint32_t        systime_t;      /**< System time. */

+typedef int32_t         cnt_t;          /**< Resources counter. */

 

 #define INLINE inline

 #define PACK_STRUCT_STRUCT __attribute__((packed))

@@ -45,3 +52,5 @@ typedef int32_t         cnt_t;
 #define PACK_STRUCT_END

 

 #endif /* _CHTYPES_H_ */

+

+/** @} */

diff --git a/ports/ARMCM3/crt0.s b/ports/ARMCM3/crt0.s
index d31b36475..72b104a0c 100644
--- a/ports/ARMCM3/crt0.s
+++ b/ports/ARMCM3/crt0.s
@@ -17,8 +17,11 @@
     along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
 
-/*
- * Generic ARM-CortexM3 startup file for ChibiOS/RT.
+/**
+ * @file ports/ARMCM3/crt0.s
+ * @brief Generic ARM Xortex-M3 startup file for ChibiOS/RT.
+ * @addtogroup ARMCM3_CORE
+ * @{
  */
 
 .set    CONTROL_MODE_PRIVILEGED, 0
@@ -111,3 +114,5 @@ hwinit0:
 .weak hwinit1
 hwinit1:
         bx      lr
+
+/** @} */
diff --git a/ports/AVR/chcore.c b/ports/AVR/chcore.c
index ee35f3459..41888ca3f 100644
--- a/ports/AVR/chcore.c
+++ b/ports/AVR/chcore.c
@@ -18,6 +18,8 @@
 */

 

 /**

+ * @file ports/AVR/chcore.c

+ * @brief AVR architecture port code.

  * @addtogroup AVR_CORE

  * @{

  */

diff --git a/ports/AVR/chcore.h b/ports/AVR/chcore.h
index ab2d2f6d5..44f7b3506 100644
--- a/ports/AVR/chcore.h
+++ b/ports/AVR/chcore.h
@@ -18,6 +18,8 @@
 */

 

 /**

+ * @file ports/AVR/chcore.h

+ * @brief AVR architecture port macros and structures.

  * @addtogroup AVR_CORE

  * @{

  */

diff --git a/ports/AVR/chtypes.h b/ports/AVR/chtypes.h
index 91e8ee055..e5920746c 100644
--- a/ports/AVR/chtypes.h
+++ b/ports/AVR/chtypes.h
@@ -17,6 +17,13 @@
     along with this program.  If not, see <http://www.gnu.org/licenses/>.

 */

 

+/**

+ * @file ports/AVR/chtypes.h

+ * @brief AVR architecture port system types.

+ * @addtogroup AVR_CORE

+ * @{

+ */

+

 #ifndef _CHTYPES_H_

 #define _CHTYPES_H_

 

@@ -29,15 +36,15 @@
 #include <stdint.h>

 #endif

 

-typedef int8_t          bool_t;

-typedef uint8_t         tmode_t;

-typedef uint8_t         tstate_t;

-typedef uint8_t         tprio_t;

-typedef int16_t         msg_t;

-typedef uint8_t         eventid_t;

-typedef uint8_t         eventmask_t;

-typedef uint16_t        systime_t;

-typedef int8_t          cnt_t;

+typedef int8_t          bool_t;         /**< Fast boolean type. */

+typedef uint8_t         tmode_t;        /**< Thread flags. */

+typedef uint8_t         tstate_t;       /**< Thread state. */

+typedef uint8_t         tprio_t;        /**< Thread priority. */

+typedef int16_t         msg_t;          /**< Inter-thread message. */

+typedef uint8_t         eventid_t;      /**< Event Id. */

+typedef uint8_t         eventmask_t;    /**< Events mask. */

+typedef uint16_t        systime_t;      /**< System time. */

+typedef int8_t          cnt_t;          /**< Resources counter. */

 

 #define INLINE      inline

 #define PACK_STRUCT_STRUCT __attribute__((packed))

@@ -45,3 +52,5 @@ typedef int8_t          cnt_t;
 #define PACK_STRUCT_END

 

 #endif /* _CHTYPES_H_ */

+

+/** @} */

diff --git a/ports/MSP430/chcore.c b/ports/MSP430/chcore.c
index 2f147c2fc..4a9857494 100644
--- a/ports/MSP430/chcore.c
+++ b/ports/MSP430/chcore.c
@@ -18,6 +18,8 @@
 */

 

 /**

+ * @file ports/MSP430/chcore.c

+ * @brief MSP430 architecture port code.

  * @addtogroup MSP430_CORE

  * @{

  */

diff --git a/ports/MSP430/chcore.h b/ports/MSP430/chcore.h
index 9c42487f2..dd0fbc3fb 100644
--- a/ports/MSP430/chcore.h
+++ b/ports/MSP430/chcore.h
@@ -18,6 +18,8 @@
 */

 

 /**

+ * @file ports/MSP430/chcore.h

+ * @brief MSP430 architecture port macros and structures.

  * @addtogroup MSP430_CORE

  * @{

  */

diff --git a/ports/MSP430/chtypes.h b/ports/MSP430/chtypes.h
index 218617cfe..f8d7c944a 100644
--- a/ports/MSP430/chtypes.h
+++ b/ports/MSP430/chtypes.h
@@ -18,7 +18,9 @@
 */

 

 /**

- * @addtogroup Core

+ * @file ports/MSP430/chtypes.h

+ * @brief MSP430 architecture port system types.

+ * @addtogroup MSP430_CORE

  * @{

  */

 

@@ -34,15 +36,15 @@
 #include <stdint.h>

 #endif

 

-typedef int16_t         bool_t;     /* Signed boolean. */

-typedef uint8_t         tmode_t;    /* Thread mode flags, uint8_t is ok. */

-typedef uint8_t         tstate_t;   /* Thread state, uint8_t is ok. */

-typedef uint16_t        tprio_t;    /* Priority, use the fastest unsigned type. */

-typedef int16_t         msg_t;      /* Message, use signed pointer equivalent.*/

-typedef int16_t         eventid_t;  /* Event Id, use fastest signed.*/

-typedef uint16_t        eventmask_t;/* Event Mask, recommended fastest unsigned.*/

-typedef uint16_t        systime_t;  /* System Time, recommended fastest unsigned.*/

-typedef int16_t         cnt_t;      /* Counter, recommended fastest signed.*/

+typedef int16_t         bool_t;         /**< Fast boolean type. */

+typedef uint8_t         tmode_t;        /**< Thread flags. */

+typedef uint8_t         tstate_t;       /**< Thread state. */

+typedef uint16_t        tprio_t;        /**< Thread priority. */

+typedef int16_t         msg_t;          /**< Inter-thread message. */

+typedef int16_t         eventid_t;      /**< Event Id. */

+typedef uint16_t        eventmask_t;    /**< Events mask. */

+typedef uint16_t        systime_t;      /**< System time. */

+typedef int16_t         cnt_t;          /**< Resources counter. */

 

 #define INLINE      inline

 #define PACK_STRUCT_STRUCT __attribute__((packed))