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

2014-12-11 14:29:58 +00:00 · 2014-12-11 14:29:58 +00:00 · 0d094bec05
parent 7009a64a03
commit 0d094bec05
21 changed files with 10087 additions and 5546 deletions
--- a/doc/common/rsc/custom.css
+++ b/doc/common/rsc/custom.css
--- a/doc/common/rsc/footer_html.html
+++ b/doc/common/rsc/footer_html.html
@ -1,12 +1,21 @@
-    <li class="footer">
-      <a href="http://sourceforge.net/projects/chibios">
-        <img src="http://sflogo.sourceforge.net/sflogo.php?group_id=205897&amp;type=11"
-             border="0" width="120" height="30"
-             alt="Get ChibiOS/RT embedded RTOS at SourceForge.net. Fast,
-                  secure and Free Open Source software downloads"/>
-      </a>
-    </li>
+<!-- HTML footer for doxygen 1.8.8-->
+<!-- start footer part -->
+<!--BEGIN GENERATE_TREEVIEW-->
+<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
+  <ul>
+    $navpath
+    <li class="footer">$generatedby
+    <a href="http://www.doxygen.org/index.html">
+    <img class="footer" src="$relpath^doxygen.png" alt="doxygen"/></a> $doxygenversion </li>
  </ul>
 </div>
+<!--END GENERATE_TREEVIEW-->
+<!--BEGIN !GENERATE_TREEVIEW-->
+<hr class="footer"/><address class="footer"><small>
+$generatedby &#160;<a href="http://www.doxygen.org/index.html">
+<img class="footer" src="$relpath^doxygen.png" alt="doxygen"/>
+</a> $doxygenversion
+</small></address>
+<!--END !GENERATE_TREEVIEW-->
 </body>
 </html>
--- a/doc/common/rsc/header_chm.html
+++ b/doc/common/rsc/header_chm.html
@ -1,21 +1,55 @@
+<!-- HTML header for doxygen 1.8.8-->
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml">
 <head>
 <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
-<title>$title</title>
-<link href="$relpath$tabs.css" rel="stylesheet" type="text/css"/>
-<link href="$relpath$doxygen.css" rel="stylesheet" type="text/css"/>
+<meta http-equiv="X-UA-Compatible" content="IE=9"/>
+<meta name="generator" content="Doxygen $doxygenversion"/>
+<!--BEGIN PROJECT_NAME--><title>$projectname: $title</title><!--END PROJECT_NAME-->
+<!--BEGIN !PROJECT_NAME--><title>$title</title><!--END !PROJECT_NAME-->
+<link href="$relpath^tabs.css" rel="stylesheet" type="text/css"/>
+<script type="text/javascript" src="$relpath^jquery.js"></script>
+<script type="text/javascript" src="$relpath^dynsections.js"></script>
+$treeview
+$search
+$mathjax
+<link href="$relpath^$stylesheet" rel="stylesheet" type="text/css" />
+$extrastylesheet
 </head>
 <body>
-<div id="top"><!-- do not remove this div! -->
+<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
+
+<!--BEGIN TITLEAREA-->
 <div id="titlearea">
 <table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 56px;">
+  <!--BEGIN PROJECT_LOGO-->
+  <td id="projectlogo"><img alt="Logo" src="$relpath^$projectlogo"/></td>
+  <!--END PROJECT_LOGO-->
+  <!--BEGIN PROJECT_NAME-->
  <td style="padding-left: 0.5em;">
-   <div id="projectname">$projectname&#160;<span id="projectnumber">$projectnumber</span></div>
+   <div id="projectname">$projectname
+   <!--BEGIN PROJECT_NUMBER-->&#160;<span id="projectnumber">$projectnumber</span><!--END PROJECT_NUMBER-->
+   </div>
+   <!--BEGIN PROJECT_BRIEF--><div id="projectbrief">$projectbrief</div><!--END PROJECT_BRIEF-->
  </td>
+  <!--END PROJECT_NAME-->
+  <!--BEGIN !PROJECT_NAME-->
+   <!--BEGIN PROJECT_BRIEF-->
+    <td style="padding-left: 0.5em;">
+    <div id="projectbrief">$projectbrief</div>
+    </td>
+   <!--END PROJECT_BRIEF-->
+  <!--END !PROJECT_NAME-->
+  <!--BEGIN DISABLE_INDEX-->
+   <!--BEGIN SEARCHENGINE-->
+   <td>$searchbox</td>
+   <!--END SEARCHENGINE-->
+  <!--END DISABLE_INDEX-->
 </tr>
 </tbody>
 </table>
 </div>
+<!--END TITLEAREA-->
+<!-- end header part -->
--- a/doc/common/rsc/header_html.html
+++ b/doc/common/rsc/header_html.html
@ -1,28 +1,36 @@
+<!-- HTML header for doxygen 1.8.8-->
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml">
 <head>
 <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
-<title>$title</title>
-<link href="$relpath$tabs.css" rel="stylesheet" type="text/css"/>
-<link href="$relpath$navtree.css" rel="stylesheet" type="text/css"/>
-<script type="text/javascript" src="$relpath$jquery.js"></script>
-<script type="text/javascript" src="$relpath$navtree.js"></script>
-<script type="text/javascript" src="$relpath$resize.js"></script>
-<script type="text/javascript">
-$(document).ready(initResizable);
-</script>
-<link href="$relpath$doxygen.css" rel="stylesheet" type="text/css"/>
+<meta http-equiv="X-UA-Compatible" content="IE=9"/>
+<meta name="generator" content="Doxygen $doxygenversion"/>
+<!--BEGIN PROJECT_NAME--><title>$projectname: $title</title><!--END PROJECT_NAME-->
+<!--BEGIN !PROJECT_NAME--><title>$title</title><!--END !PROJECT_NAME-->
+<link href="$relpath^tabs.css" rel="stylesheet" type="text/css"/>
+<script type="text/javascript" src="$relpath^jquery.js"></script>
+<script type="text/javascript" src="$relpath^dynsections.js"></script>
+$treeview
+$search
+$mathjax
+<link href="$relpath^$stylesheet" rel="stylesheet" type="text/css" />
+$extrastylesheet
 </head>
 <body>
-<div id="top"><!-- do not remove this div! -->
+<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
+
+<!--BEGIN TITLEAREA-->
 <div id="titlearea">
 <table cellspacing="0" cellpadding="0">
 <tbody>
- <tr style="height: 92px;">
+ <tr style="height: 56px;">
+  <!--BEGIN PROJECT_LOGO-->
+  <td id="projectlogo"><img alt="Logo" src="$relpath^$projectlogo"/></td>
+  <!--END PROJECT_LOGO-->
+  <!--BEGIN PROJECT_NAME-->
  <td style="padding-left: 0.5em;">
-   <div id="projectname">$projectname<br><span id="projectnumber">$projectnumber</span></div>
-  </td>
-  <td style="padding-left: 3em;">
+   <div id="projectname">$projectname
+   <!--BEGIN PROJECT_NUMBER-->&#160;<span id="projectnumber">$projectnumber</span><!--END PROJECT_NUMBER-->
 <script type="text/javascript"><!--
 google_ad_client = "pub-3840594581853944";
 /* Documentation, bottom, 728x90, created 9/19/10 */
@ -34,8 +42,25 @@ google_ad_height = 90;
 <script type="text/javascript"
 src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
 </script>
+   </div>
+   <!--BEGIN PROJECT_BRIEF--><div id="projectbrief">$projectbrief</div><!--END PROJECT_BRIEF-->
  </td>
+  <!--END PROJECT_NAME-->
+  <!--BEGIN !PROJECT_NAME-->
+   <!--BEGIN PROJECT_BRIEF-->
+    <td style="padding-left: 0.5em;">
+    <div id="projectbrief">$projectbrief</div>
+    </td>
+   <!--END PROJECT_BRIEF-->
+  <!--END !PROJECT_NAME-->
+  <!--BEGIN DISABLE_INDEX-->
+   <!--BEGIN SEARCHENGINE-->
+   <td>$searchbox</td>
+   <!--END SEARCHENGINE-->
+  <!--END DISABLE_INDEX-->
 </tr>
 </tbody>
 </table>
 </div>
+<!--END TITLEAREA-->
+<!-- end header part -->
--- a/doc/common/rsc/layout.xml
+++ b/doc/common/rsc/layout.xml
@ -1,38 +1,38 @@
 <doxygenlayout version="1.0">
+  <!-- Generated by doxygen 1.8.8 -->
  <!-- Navigation index tabs for HTML output -->
  <navindex>
    <tab type="mainpage" visible="yes" title=""/>
    <tab type="pages" visible="yes" title="" intro=""/>
    <tab type="modules" visible="yes" title="" intro=""/>
    <tab type="namespaces" visible="yes" title="">
-      <tab type="namespaces" visible="yes" title="" intro=""/>
+      <tab type="namespacelist" visible="yes" title="" intro=""/>
      <tab type="namespacemembers" visible="yes" title="" intro=""/>
    </tab>
    <tab type="classes" visible="yes" title="">
-      <tab type="classes" visible="yes" title="" intro=""/>
+      <tab type="classlist" visible="yes" title="" intro=""/>
      <tab type="classindex" visible="$ALPHABETICAL_INDEX" title=""/> 
      <tab type="hierarchy" visible="yes" title="" intro=""/>
      <tab type="classmembers" visible="yes" title="" intro=""/>
    </tab>
    <tab type="files" visible="yes" title="">
-      <tab type="files" visible="yes" title="" intro=""/>
+      <tab type="filelist" visible="yes" title="" intro=""/>
      <tab type="globals" visible="yes" title="" intro=""/>
    </tab>
-    <tab type="dirs" visible="yes" title="" intro=""/>
    <tab type="examples" visible="yes" title="" intro=""/>  
  </navindex>

  <!-- Layout definition for a class page -->
  <class>
-    <briefdescription visible="no"/>
-    <detaileddescription title=""/>
+    <briefdescription visible="yes"/>
    <includes visible="$SHOW_INCLUDE_FILES"/>
    <inheritancegraph visible="$CLASS_GRAPH"/>
    <collaborationgraph visible="$COLLABORATION_GRAPH"/>
-    <allmemberslink visible="yes"/>
    <memberdecl>
      <nestedclasses visible="yes" title=""/>
      <publictypes title=""/>
+      <services title=""/>
+      <interfaces title=""/>
      <publicslots title=""/>
      <signals title=""/>
      <publicmethods title=""/>
@ -62,9 +62,13 @@
      <related title="" subtitle=""/>
      <membergroups visible="yes"/>
    </memberdecl>
+    <detaileddescription title=""/>
    <memberdef>
+      <inlineclasses title=""/>
      <typedefs title=""/>
      <enums title=""/>
+      <services title=""/>
+      <interfaces title=""/>
      <constructors title=""/>
      <functions title=""/>
      <related title=""/>
@ -72,16 +76,17 @@
      <properties title=""/>
      <events title=""/>
    </memberdef>
+    <allmemberslink visible="yes"/>
    <usedfiles visible="$SHOW_USED_FILES"/>
    <authorsection visible="yes"/>
  </class>

  <!-- Layout definition for a namespace page -->
  <namespace>
-    <briefdescription visible="no"/>
-    <detaileddescription title=""/>
+    <briefdescription visible="yes"/>
    <memberdecl>
      <nestednamespaces visible="yes" title=""/>
+      <constantgroups visible="yes" title=""/>
      <classes visible="yes" title=""/>
      <typedefs title=""/>
      <enums title=""/>
@ -89,7 +94,9 @@
      <variables title=""/>
      <membergroups visible="yes"/>
    </memberdecl>
+    <detaileddescription title=""/>
    <memberdef>
+      <inlineclasses title=""/>
      <typedefs title=""/>
      <enums title=""/>
      <functions title=""/>
@ -100,8 +107,7 @@

  <!-- Layout definition for a file page -->
  <file>
-    <briefdescription visible="no"/>
-    <detaileddescription title=""/>
+    <briefdescription visible="yes"/>
    <includes visible="$SHOW_INCLUDE_FILES"/>
    <includegraph visible="$INCLUDE_GRAPH"/>
    <includedbygraph visible="$INCLUDED_BY_GRAPH"/>
@ -109,41 +115,44 @@
    <memberdecl>
      <classes visible="yes" title=""/>
      <namespaces visible="yes" title=""/>
-      <functions title=""/>
-      <variables title=""/>
+      <constantgroups visible="yes" title=""/>
      <defines title=""/>
      <typedefs title=""/>
      <enums title=""/>
+      <functions title=""/>
+      <variables title=""/>
      <membergroups visible="yes"/>
    </memberdecl>
+    <detaileddescription title=""/>
    <memberdef>
-      <functions title=""/>
-      <variables title=""/>
+      <inlineclasses title=""/>
      <defines title=""/>
      <typedefs title=""/>
      <enums title=""/>
+      <functions title=""/>
+      <variables title=""/>
    </memberdef>
    <authorsection/>
  </file>

  <!-- Layout definition for a group page -->
  <group>
-    <briefdescription visible="no"/>
+    <briefdescription visible="yes"/>
    <groupgraph visible="$GROUP_GRAPHS"/>
    <detaileddescription title=""/>
    <memberdecl>
-      <classes visible="yes" title=""/>
-      <namespaces visible="yes" title=""/>
-      <dirs visible="yes" title=""/>
      <nestedgroups visible="yes" title=""/>
+      <dirs visible="yes" title=""/>
      <files visible="yes" title=""/>
-      <functions title=""/>
-      <variables title=""/>
-      <membergroups visible="yes"/>
+      <namespaces visible="yes" title=""/>
      <defines title=""/>
+      <membergroups visible="yes"/>
      <typedefs title=""/>
+      <classes visible="yes" title=""/>
+      <functions title=""/>
      <enums title=""/>
      <enumvalues title=""/>
+      <variables title=""/>
      <signals title=""/>
      <publicslots title=""/>
      <protectedslots title=""/>
@ -154,12 +163,13 @@
    </memberdecl>
    <memberdef>
      <pagedocs/>
-      <functions title=""/>
-      <variables title=""/>
+      <inlineclasses title=""/>
      <defines title=""/>
      <typedefs title=""/>
      <enums title=""/>
      <enumvalues title=""/>
+      <functions title=""/>
+      <variables title=""/>
      <signals title=""/>
      <publicslots title=""/>
      <protectedslots title=""/>
@ -173,12 +183,12 @@

  <!-- Layout definition for a directory page -->
  <directory>
-    <briefdescription visible="no"/>
+    <briefdescription visible="yes"/>
    <directorygraph visible="yes"/>
-    <detaileddescription title=""/>
    <memberdecl>
      <dirs visible="yes"/>
      <files visible="yes"/>
    </memberdecl>
+    <detaileddescription title=""/>
  </directory>
 </doxygenlayout>
--- a/doc/hal/Doxyfile_chm
+++ b/doc/hal/Doxyfile_chm
--- a/doc/hal/Doxyfile_html
+++ b/doc/hal/Doxyfile_html
--- a/doc/hal/makechm.bat
+++ b/doc/hal/makechm.bat
@ -1,5 +1,5 @@
 del html\*.* /Q
-Doxygen Doxyfile_chm
+doxygen Doxyfile_chm
 del html\*.md5
 del html\*.map
 pause
--- a/doc/hal/makehtml.bat
+++ b/doc/hal/makehtml.bat
@ -1,5 +1,5 @@
 del html\*.* /Q
-Doxygen Doxyfile_html
+doxygen Doxyfile_html
 del html\*.md5
 del html\*.map
 pause
--- a/doc/nil/Doxyfile_chm
+++ b/doc/nil/Doxyfile_chm
--- a/doc/nil/Doxyfile_html
+++ b/doc/nil/Doxyfile_html
--- a/doc/nil/makechm.bat
+++ b/doc/nil/makechm.bat
@ -1,5 +1,5 @@
 del html\*.* /Q
-Doxygen Doxyfile_chm
+doxygen Doxyfile_chm
 del html\*.md5
 del html\*.map
 pause
--- a/doc/nil/makehtml.bat
+++ b/doc/nil/makehtml.bat
@ -1,5 +1,5 @@
 del html\*.* /Q
-Doxygen Doxyfile_html
+doxygen Doxyfile_html
 del html\*.md5
 del html\*.map
 pause
--- a/doc/rt/Doxyfile_chm
+++ b/doc/rt/Doxyfile_chm
--- a/doc/rt/Doxyfile_html
+++ b/doc/rt/Doxyfile_html
--- a/doc/rt/makechm.bat
+++ b/doc/rt/makechm.bat
@ -1,5 +1,5 @@
 del html\*.* /Q
-Doxygen Doxyfile_chm
+doxygen Doxyfile_chm
 del html\*.md5
 del html\*.map
 pause
--- a/doc/rt/makehtml.bat
+++ b/doc/rt/makehtml.bat
@ -1,5 +1,5 @@
 del html\*.* /Q
-Doxygen Doxyfile_html
+doxygen Doxyfile_html
 del html\*.md5
 del html\*.map
 pause
--- a/os/hal/include/hal_queues.h
+++ b/os/hal/include/hal_queues.h
@ -49,7 +49,11 @@
 */
 typedef struct io_queue io_queue_t;

-/** @brief Queue notification callback type.*/
+/**
+ * @brief   Queue notification callback type.
+ *
+ * @param[in] qp        the queue pointer.
+ */
 typedef void (*qnotify_t)(io_queue_t *qp);

 /**
--- a/os/hal/src/mmc_spi.c
+++ b/os/hal/src/mmc_spi.c
@ -289,11 +289,12 @@ static uint8_t send_command_R3(MMCDriver *mmcp, uint8_t cmd, uint32_t arg,
 * @brief   Reads the CSD.
 *
 * @param[in] mmcp      pointer to the @p MMCDriver object
- * @param[out] csd       pointer to the CSD buffer
+ * @param[out] cmd      command
+ * @param[out] cxd      pointer to the CSD/CID buffer
 *
 * @return              The operation status.
- * @retval HAL_SUCCESS   the operation succeeded.
- * @retval HAL_FAILED    the operation failed.
+ * @retval HAL_SUCCESS  the operation succeeded.
+ * @retval HAL_FAILED   the operation failed.
 *
 * @notapi
 */
--- a/os/hal/src/serial_usb.c
+++ b/os/hal/src/serial_usb.c
@ -107,6 +107,8 @@ static const struct SerialUSBDriverVMT vmt = {

 /**
 * @brief   Notification of data removed from the input queue.
+ *
+ * @param[in] qp        the queue pointer.
 */
 static void inotify(io_queue_t *qp) {
  size_t n, maxsize;
@ -138,6 +140,8 @@ static void inotify(io_queue_t *qp) {

 /**
 * @brief   Notification of data inserted into the output queue.
+ *
+ * @param[in] qp        the queue pointer.
 */
 static void onotify(io_queue_t *qp) {
  size_t n;
--- a/os/nil/include/nil.h
+++ b/os/nil/include/nil.h
@ -284,11 +284,16 @@ extern stkalign_t __main_thread_stack_base__, __main_thread_stack_end__;
 typedef struct port_intctx intctx_t;

 /**
- * @brief   Type of a structure representing a counting semaphore.
+ * @brief   Type of a structure representing a semaphore.
 */
-typedef struct {
+typedef struct nil_semaphore semaphore_t;
+
+/**
+ * @brief   Structure representing a counting semaphore.
+ */
+struct nil_semaphore {
  volatile cnt_t    cnt;        /**< @brief Semaphore counter.              */
-} semaphore_t;
+};

 /**
 * @brief Thread function.
@ -300,11 +305,6 @@ typedef void (*tfunc_t)(void *);
 */
 typedef struct nil_thread_cfg thread_config_t;

-/**
- * @brief   Type of a structure representing a thread.
- */
-typedef struct nil_thread thread_t;
-
 /**
 * @brief   Structure representing a thread static configuration.
 */
@ -316,6 +316,11 @@ struct nil_thread_cfg {
  void              *arg;       /**< @brief Thread function argument.       */
 };

+/**
+ * @brief   Type of a structure representing a thread.
+ */
+typedef struct nil_thread thread_t;
+
 /**
 * @brief   Type of a thread reference.
 */
@ -350,12 +355,17 @@ struct nil_thread {
  NIL_CFG_THREAD_EXT_FIELDS
 };

+/**
+ * @brief   Type of a structure representing the system.
+ */
+typedef struct nil_system nil_system_t;
+
 /**
 * @brief   System data structure.
 * @note    This structure contain all the data areas used by the OS except
 *          stacks.
 */
-typedef struct {
+struct nil_system {
  /**
   * @brief   Pointer to the running thread.
   */
@ -396,7 +406,7 @@ typedef struct {
   */
  const char            * volatile dbg_panic_msg;
 #endif
-} nil_system_t;
+};

 /*===========================================================================*/
 /* Module macros.                                                            */