aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMarti Bolivar <mbolivar@leaflabs.com>2011-06-10 10:04:06 -0400
committerMarti Bolivar <mbolivar@leaflabs.com>2011-06-10 10:42:48 -0400
commitcd9b275805d98f9fa20ae19a59c6c9cdadb39af8 (patch)
tree3f8a39683505036bc61c12ba8bffb5941b66afd5
parent036c04bbe6c75f71a66fad90530ac1dec5e47b53 (diff)
downloadlibrambutan-cd9b275805d98f9fa20ae19a59c6c9cdadb39af8.tar.gz
librambutan-cd9b275805d98f9fa20ae19a59c6c9cdadb39af8.zip
Docs: Generalize throb()-related troubleshooting item.
The FAQ entry which explains the throbbing LED behavior is insufficiently general. Rewrite it so users can tell that throbbing generally indicates a failed assertion or some other error.
-rw-r--r--source/troubleshooting.rst14
1 files changed, 6 insertions, 8 deletions
diff --git a/source/troubleshooting.rst b/source/troubleshooting.rst
index b5f496e..3174f14 100644
--- a/source/troubleshooting.rst
+++ b/source/troubleshooting.rst
@@ -14,17 +14,15 @@ This page documents common problems and their solutions.
Hardware problems
===================
-The status LED is throbbing and I can't upload my program!
-----------------------------------------------------------
+The LED is throbbing and my program is stopped!
+-----------------------------------------------
The LED throbs when there has been a failed software :ref:`assertion
-<language-assert>`.
+<language-assert>` or some other error.
-You can still reprogram by resetting the board and uploading during
-the short window when the bootloader waits for a program.
-
-To make this window longer (it can be hard to get the timing right),
-use :ref:`perpetual bootloader mode
+There are a few issues with the bootloader which mean you might not be
+able to upload your program when this happens. You can still
+reprogram by using :ref:`perpetual bootloader mode
<troubleshooting-perpetual-bootloader>`.
My board is bricked! I can't upload via the bootloader no matter what!