embedded-trainings-2020/embedded-workshop-book/src/flashing-program.md

# Flashing the Program

✅ Use the following command to flash the program to the device.

``` console
$ cargo flash --chip nRF52840_xxAA --bin hello
```

> NOTE: If you run into an error along the lines of "Debug power request failed" retry the operation and the error should disappear.

This subcommand will build the program first so you'll always flash the latest version.

The `cargo-flash` subcommand flashes and runs the program but won't display logs. It is a deployment tool.

**🔎 How does flashing work?**

The flashing process consists of the PC communicating with a second microcontroller on the nRF52840 DK over USB (J2 port). This second microcontroller, named J-Link, is connected to the nRF52840 through a electrical interface known as SWD. The SWD protocol specifies procedures for reading memory, writing to memory, halting the target processor, reading the target processor registers, etc.
make beginner readme into mdbook 2020-07-08 13:06:49 +00:00			`# Flashing the Program`

show a single way to flash the program this is the recommended way 2020-07-14 09:14:41 +00:00			`✅ Use the following command to flash the program to the device.`
make beginner readme into mdbook 2020-07-08 13:06:49 +00:00
			``` console
show a single way to flash the program this is the recommended way 2020-07-14 09:14:41 +00:00			`$ cargo flash --chip nRF52840_xxAA --bin hello`
make beginner readme into mdbook 2020-07-08 13:06:49 +00:00			```

didactic changes 2020-07-13 15:20:20 +00:00			`> NOTE: If you run into an error along the lines of "Debug power request failed" retry the operation and the error should disappear.`
make beginner readme into mdbook 2020-07-08 13:06:49 +00:00
show a single way to flash the program this is the recommended way 2020-07-14 09:14:41 +00:00			`This subcommand will build the program first so you'll always flash the latest version.`
make beginner readme into mdbook 2020-07-08 13:06:49 +00:00
			The `cargo-flash` subcommand flashes and runs the program but won't display logs. It is a deployment tool.

didactic changes 2020-07-13 15:20:20 +00:00			`🔎 How does flashing work?`

Update flashing-program.md The debug interface present on the nRF52 devices is actually SWD and not JTAG. 2020-07-16 23:05:16 +00:00			`The flashing process consists of the PC communicating with a second microcontroller on the nRF52840 DK over USB (J2 port). This second microcontroller, named J-Link, is connected to the nRF52840 through a electrical interface known as SWD. The SWD protocol specifies procedures for reading memory, writing to memory, halting the target processor, reading the target processor registers, etc.`