Documentation of the SPIN recovery procedure

[pierre-haessig]

Hello OwnTech,

A few weeks ago during a course lab session, I got a a student board "bricked" in the sense that the board wasn't accepting a new program with the Upload action of VSCode/PlatformIO.

Thankfully I remembered you had shown me the recovery mode, but I had to dig in the doc to find this Recovery mode procedure:

https://github.com/owntech-foundation/SPIN/blob/SPIN-V1.2/docs/getting_started.md

Using onboard buttons:
Pressing simultaneously BTN and RST will reboot the board in RECOVERY mode.

However, if we are talking of the same mode, I believe this information is not complete (and thanks @luizvilla for the live remote assitance). It should be:

1. Press simultaneously BTN and RST
2. Release the RST button (after some time?), while still pressing BTN
3. Release BTN (after some time?)

Of course, in an ideal world there would be either:

• no need to have a RECOVERY mode (i.e. the Upload action would always succeed)
• or at least the RECOVERY mode would be easier to start (only pressing RST?)

but at least, documenting is a good start

Finally, in relation to this documentation effort, I believe that the following statement should be updated:

Reset RST – Reset the board

because it's not clear what reset means (it could mean RECOVERY, except it's not!). Perhaps it means "reboot the currently running application"?