bluerobotics / ping-viewer

Ping Viewer is an open-source application to view and record data from the Blue Robotics Ping Echosounder and Ping360 Scanning Sonar.
https://docs.bluerobotics.com/ping-viewer/
GNU General Public License v3.0
42 stars 39 forks source link

docs: update device recovery instructions #984

Closed ES-Alexander closed 2 years ago

ES-Alexander commented 3 years ago

Ping1D device recovery instructions specify downloading and flashing Ping_V3.26_115kb.hex, instead of the latest firmware (currently Ping_V3.28_auto.hex).

Not super urgent since once a valid firmware is flashed then Ping-Viewer should be able to detect it again, in which case you can just update there, but it would at least be convenient to recover to the latest firmware instead of an outdated version (especially since updating once the device is connected to companion is more difficult than when it's directly connected to the computer).

ES-Alexander commented 2 years ago

Docs are also missing Mac recovery instructions. stm32flash executable seemingly isn't auto-added to PATH on installation - it should be available at /Applications/pingviewer.app/stm32flash.

May also be worth noting that Mac apparently has names for tty devices rather than numbers, and for users who aren't used to terminals it could be worth specifying they can check for available devices with ls /dev/tty.*