forked from micropython/micropython
-
Notifications
You must be signed in to change notification settings - Fork 4
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
samd/boards/SAMD21_XPLAINED_PRO: Add specific deploy instructions.
Add instructions to install a bootloader to the board. The SAMD21 XPLAINED PRO board is shipped without a bootloader, which therefore has to be installed once before it can be used with MicroPython. Signed-off-by: robert-hh <robert@hammelrath.com>
- Loading branch information
Showing
2 changed files
with
25 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,6 +1,6 @@ | ||
{ | ||
"deploy": [ | ||
"../deploy.md" | ||
"deploy_xplained_pro.md" | ||
], | ||
"docs": "", | ||
"features": [ | ||
|
24 changes: 24 additions & 0 deletions
24
ports/samd/boards/SAMD21_XPLAINED_PRO/deploy_xplained_pro.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,24 @@ | ||
The SAMD21 Xplained Pro board is shipped without a bootloader. For use | ||
with MicroPyhton a suitable bootloader has be be installed first. The | ||
following procedure has been found to work and be simple: | ||
|
||
1. Get the bootloader from https://micropython.org/resources/firmware/bootloader-xplained-pro-v3.16.0-15-gaa52b22.hex. | ||
2. Connect your board to the debug port. A drive with the name XPLAINED | ||
shall appear. | ||
3. Copy the Intel hex file of the bootloader to that drive. | ||
4. Connect your board to the target port. A drive with the name SAMD21XPL should | ||
appear. If not, push reset twice. Then it should appear. If that does not | ||
happen, the bootloader was not properly installed or is not compatible. | ||
5. Copy the MicroPython firmware, a .uf2 file, to the SAMD21 drive. When the SAMD21 | ||
drive disappears, MicroPython is installed. | ||
|
||
From now on only steps 4 and 5 are needed to update MicroPython. You can use the | ||
usual methods to invoke the bootloader, namely: | ||
|
||
- Push Reset twice. | ||
- Call machine.bootloader(). | ||
- Use the touch 1200 procedure by switching the USB baud rate to 1200 baud and back. | ||
|
||
At the above link above there are as well .uf2 versions of the bootloader | ||
which one can install using steps 5. and 6. above once a .uf2 capable | ||
bootloader is installed. |