Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

boards: add cli-flashing-with-openocd #117

Draft
wants to merge 2 commits into
base: dev
Choose a base branch
from
Draft

boards: add cli-flashing-with-openocd #117

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
9e0b166
boards/machine: unify procedures for each OS
sago35 Sep 18, 2020
9982006
boards: add cli-flashing-with-openocd
sago35 Sep 18, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 9 additions & 14 deletions content/microcontrollers/feather-m4.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ The [Adafruit Feather M4](https://www.adafruit.com/product/3857) is a tiny ARM d

The Feather M4 comes with the [UF2 bootloader](https://github.com/Microsoft/uf2) already installed.

### CLI Flashing on Linux
### CLI Flashing

- Plug your Feather M4 into your computer's USB port.
- Flash your TinyGo program to the board using this command:
Expand All @@ -37,27 +37,22 @@ The Feather M4 comes with the [UF2 bootloader](https://github.com/Microsoft/uf2)

- The Feather M4 board should restart and then begin running your program.

### CLI Flashing on macOS
### CLI Flashing with openocd

- Plug your Feather M4 into your computer's USB port.
- Plug the openocd debugger into your computer's USB port and connect it to the Feather M4.
- Flash your TinyGo program to the board using this command:

```shell
tinygo flash -target=feather-m4 [PATH TO YOUR PROGRAM]
```

- The Feather M4 board should restart and then begin running your program.

### CLI Flashing on Windows

- Plug your Feather M4 into your computer's USB port.
- Flash your TinyGo program to the board using this command:

```shell
tinygo flash -target=feather-m4 [PATH TO YOUR PROGRAM]
tinygo flash -target=feather-m4 -programmer cmsis-dap [PATH TO YOUR PROGRAM]
tinygo flash -target=feather-m4 -programmer jnlik [PATH TO YOUR PROGRAM]
tinygo flash -target=feather-m4 -programmer stlink-v2 [PATH TO YOUR PROGRAM]
tinygo flash -target=feather-m4 -programmer stlink-v2-1 [PATH TO YOUR PROGRAM]
```

- The Feather M4 board should restart and then begin running your program.
- In some cases, restart fails on TinyGo 0.15, but when you press reset, begin running your program.
- This issue will be fixed in TinyGo 0.16

### Troubleshooting

Expand Down