aboutsummaryrefslogtreecommitdiffstats
path: root/docs/source
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
commit6cc1ea450b288d76d2b2d66176abba78dea6e467 (patch)
tree71e84fbfdddffcb189d027fcb18931461a4bf319 /docs/source
parentdf044ee0c3a8602ac3329a86ff6c62d3ec4568b0 (diff)
downloadlibrambutan-6cc1ea450b288d76d2b2d66176abba78dea6e467.tar.gz
librambutan-6cc1ea450b288d76d2b2d66176abba78dea6e467.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.
Diffstat (limited to 'docs/source')
-rw-r--r--docs/source/troubleshooting.rst14
1 files changed, 6 insertions, 8 deletions
diff --git a/docs/source/troubleshooting.rst b/docs/source/troubleshooting.rst
index b5f496e..3174f14 100644
--- a/docs/source/troubleshooting.rst
+++ b/docs/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!