update README files and comments

git-svn-id: svn://svn.code.sf.net/p/nuttx/code/trunk@3084 42af7a65-404d-4744-a932-0658087f49c3

2 files changed, 46 insertions, 13 deletions

diff --git a/nuttx/configs/olimex-lpc1766stk/README.txt b/nuttx/configs/olimex-lpc1766stk/README.txt
index 308d704b4..10fc39170 100755
--- a/nuttx/configs/olimex-lpc1766stk/README.txt
+++ b/nuttx/configs/olimex-lpc1766stk/README.txt
@@ -248,11 +248,44 @@ LEDs
 

   - configs/olimex-lpc1766stk/src/up_leds.c - LED control logic.

 

-  The LPC1766-STK has [tbd] LEDs...

-  If CONFIG_ARCH_LEDS is defined, these LEDs will be controlled as follows for

-  NuttX debug functionality (where NC means "No Change").

-

-  [To be provided]

+  The LPC1766-STK has two LEDs.  If CONFIG_ARCH_LEDS is defined, these LEDs will

+  be controlled as follows for NuttX debug functionality (where NC means "No Change").

+  Basically,

+

+  LED1:

+  - OFF means that the OS is still initializing. Initialization is very fast so

+    if you see this at all, it probably means that the system is hanging up

+    somewhere in the initialization phases.

+  - ON means that the OS completed initialization.

+

+  LED2:

+  - ON/OFF toggles means that various events are happening.

+  - GLowing: LED2 is turned on and off on every interrupt so even timer interrupts

+    should cause LED2 to glow faintly in the normal case.

+  - Flashing. If the LED2 is flashing at about 1Hz, that means that a crash

+    has occurred.  If CONFIG_ARCH_STACKDUMP=y, you will get some diagnostic

+    information on the console to help debug what happened.

+    Will 

+

+  LED1  LED2      Meaning

+  ----- --------  --------------------------------------------------------------------

+   OFF   OFF      Still initializing and there is no interrupt activity. 

+                  Initialization is very fast so if you see this, it probably means

+                  that the system is hung up somewhere in the initialization phases.

+   OFF   Glowing  Still initializing (see above) but taking interrupts.

+   OFF   ON       This would mean that (1) initialization did not complete but the

+                  software is hung, perhaps in an infinite loop, somewhere inside

+                  of an interrupt handler.

+   OFF   Flashing Ooops!  We crashed before finishing initialization.

+ 

+   ON    OFF      The system has completed initialization, but is apparently not taking

+                  any interrupts.

+   ON    Glowing  This is the normal healthy state: The OS successfully initialized

+                  and is taking interrupts.

+   ON    ON       This would mean that (1) the OS complete initialization, but (2)

+                  the software is hung, perhaps in an infinite loop, somewhere inside

+                  of a signal or interrupt handler.

+   ON    Flashing Ooops!  We crashed sometime after initialization.

 

 Olimex LPC1766-STK Configuration Options

 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

diff --git a/nuttx/configs/olimex-lpc1766stk/include/board.h b/nuttx/configs/olimex-lpc1766stk/include/board.h
index 22d77a1dd..0d0b85809 100755
--- a/nuttx/configs/olimex-lpc1766stk/include/board.h
+++ b/nuttx/configs/olimex-lpc1766stk/include/board.h
@@ -125,14 +125,14 @@
 /* LED definitions ******************************************************************/
 
                                       /* LED1 LED2 */
-#define LED_STARTED                0  /*  OFF  OFF */
-#define LED_HEAPALLOCATE           0  /*  OFF  OFF */
-#define LED_IRQSENABLED            0  /*  OFF  OFF */
-#define LED_STACKCREATED           1  /*  ON   OFF */
-#define LED_INIRQ                  2  /*  NC   ON  */
-#define LED_SIGNAL                 2  /*  NC   ON  */
-#define LED_ASSERTION              2  /*  NC   ON  */
-#define LED_PANIC                  2  /*  NC   ON  (flashing) */
+#define LED_STARTED                0  /*  OFF  OFF = Still initializing */
+#define LED_HEAPALLOCATE           0  /*  OFF  OFF = Still initializing */
+#define LED_IRQSENABLED            0  /*  OFF  OFF = Still initializing */
+#define LED_STACKCREATED           1  /*  ON   OFF = Initialization complete */
+#define LED_INIRQ                  2  /*  NC   ON  = In an interrupt handler */
+#define LED_SIGNAL                 2  /*  NC   ON  = In a signal handler */
+#define LED_ASSERTION              2  /*  NC   ON  = In an assertion */
+#define LED_PANIC                  2  /*  NC   ON  = Oops! We crashed. (flashing) */
 
 /* Alternate pin selections *********************************************************/