You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
## :fontawesome-solid-screwdriver-wrench: Compiling Firmware - using Docker
443
443
444
-
The GNSSDO Firmware can be compiled locally using Docker:
444
+
To compile the GNSSDO Firmware, you need to use the correct version of the ESP32 Arduino core and of each required Arduino library. It is tedious and error-prone. Especially on Windows. We've lost count of the number of times code compilation fails on our local machines, because we had the wrong ESP32 core installed... It is much easier to sandbox the firmware compilation using an environment like [Docker](https://www.docker.com/).
445
+
446
+
Docker is open-source. It is our new favourite thing!
447
+
448
+
Here is a step-by-step guide for how to install Docker and compile the firmware from scratch:
445
449
446
450
### Clone, fork or download the GNSSDO repo
447
451
@@ -509,3 +513,28 @@ You can then use (e.g.) the [SparkFun RTK Firmware Uploader](https://github.com/
509
513
510
514
You may find the `.elf` file useful if you are trying to debug the code with [me-no-dev's Exception Decoder](https://github.com/me-no-dev/EspExceptionDecoder).
511
515
516
+
## :fontawesome-solid-screwdriver-wrench: Uploading Firmware - using esptool
517
+
518
+
The [SparkFun RTK Firmware Uploader](https://github.com/sparkfun/SparkFun_RTK_Firmware_Uploader) contains a copy of Espressif's esptool. It is esptool that actually performs the code upload.
519
+
520
+
If you want to upload new firmware manually from the command line, here are the commands:
esptool.py --chip esp32 --port /dev/ttyUSB0 --before default_reset run
530
+
```
531
+
532
+
On Windows, you can replace `esptool.py` with `esptool.exe`. You can find a copy of `esptool.exe` in the [Utils](https://github.com/sparkfun/SparkFun_GNSSDO/tree/release_candidate/Firmware/Utils) folder.
533
+
534
+
On Windows, replace `/dev/ttyUSB0` with the name of your CH340 COM port: `COM1` or similar.
535
+
536
+
You can find copies of `RTK_Surveyor.ino.bootloader.bin`, `RTK_Surveyor_Partitions_16MB.bin` and `boot_app0.bin` in the [Firmware Uploader resource folder](https://github.com/sparkfun/SparkFun_RTK_Firmware_Uploader/tree/main/RTK_Firmware_Uploader/resource).
0 commit comments