Merge pull request #189 from ferrous-systems/recover_patch

add nrf-recover

embedded-workshop-book/src/SUMMARY.md

@@ -69,6 +69,7 @@
     - [Dongle USB functionality is not working](./troubleshoot-usb-dongle.md)
     - [`cargo run` errors](./troubleshoot-cargo-run-error.md)
     - [`no probe was found` error](./troubleshoot-probe-not-found.md)
+    - [`location info is incomplete` error](./troubleshoot-location-info.md)
     - [DEPRECATED - `nrfutil` setup](DEPRECATED-nrfutil-setup.md)
 - [Appendix](./appendix.md)
   - [Using GDB](./gdb.md)

embedded-workshop-book/src/troubleshoot-location-info.md

@@ -0,0 +1,14 @@
+# `location info is incomplete` error
+
+Problem: Using cargo run --bin hello from within the beginner/apps folder finishes compiling and starts up probe-run. But then the following error is returned:
+
+```sh
+Running `probe-run --chip nRF52840_xxAA target/thumbv7em-none-eabihf/debug/hello`
+(HOST) WARN  (BUG) location info is incomplete; it will be omitted from the output
+Error: AP ApAddress { dp: Default, ap: 0 } is not a memory AP
+The LED5 next to the FTDI chip on the DK goes off for a split second but no program is flashed.
+```
+
+Solution: It seems like my nRF52840-DK was shipped with the MCU in some kind of protected state. Using nrfjprog from the nRF command line tools you can run nrfjprog --recover which makes the MCU exit this state and programming etc. using probe-run works fine again.
+
+Untested: using [nrf-recover](https://github.com/thalesfragoso/nrf-recover/) may also work.