aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--source/bootloader.rst22
1 files changed, 20 insertions, 2 deletions
diff --git a/source/bootloader.rst b/source/bootloader.rst
index cebc671..d946fe4 100644
--- a/source/bootloader.rst
+++ b/source/bootloader.rst
@@ -708,7 +708,25 @@ You can also run the following to get usage information::
python.exe stm32loader.py -h
If all goes well, you'll see a bunch of output, then "Verification
-OK". If something goes wrong, the `forum`_ is probably your best bet
-for obtaining help, with IRC (server irc.freenode.net, channel
+OK". Your board now has a fresh bootloader installed.
+
+The first time you upload a program after installing a new bootloader,
+there is no need to select a serial port in the :ref:`IDE <ide>`
+[#fbootser]_. Perform this first upload with no serial port selected.
+The IDE will emit a warning about not finding a serial port, but the
+upload will still succeed. In subsequent uploads, select a serial
+port as you normally would.
+
+If something goes wrong, the `forum`_ is probably your best bet for
+obtaining help, with IRC (server irc.freenode.net, channel
#leafblowers) being another option. If all else fails, you can always
`contact us directly`_!
+
+.. rubric:: Footnotes
+
+.. [#fbootser] This is because immediately after installing a new
+ bootloader, the only program on your board is the
+ bootloader itself. Unlike a normal sketch, the
+ bootloader is not enumerated as a virtual serial port
+ (it uses DFU instead; see :ref:`above
+ <bootloader-rev3>` for more details).