diff options
| author | Marti Bolivar <mbolivar@leaflabs.com> | 2011-07-06 12:20:49 -0400 |
|---|---|---|
| committer | Marti Bolivar <mbolivar@leaflabs.com> | 2011-07-06 12:26:29 -0400 |
| commit | 56383840c0872dab24501c981420a500b1f4c200 (patch) | |
| tree | 5172f457baeac5ab035531fff906c3d980e12237 /source | |
| parent | 5e9c51e54457f39ea94d199572dad643065c63a0 (diff) | |
| download | librambutan-56383840c0872dab24501c981420a500b1f4c200.tar.gz librambutan-56383840c0872dab24501c981420a500b1f4c200.zip | |
bootloader: Mention lack of serial port after flashing a fresh bootloader.
After installing a fresh DFU bootloader, the board has no user code on
it, so libmaple's init() never gets run, and there's no need to select
a serial port to perform the autoreset sequence on. This caused
confusion among users who weren't able to find a serial port after
installing a new bootloader. Add some documentation to help avoid
this confusion.
Diffstat (limited to 'source')
| -rw-r--r-- | source/bootloader.rst | 22 |
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). |