.

troubleshooting.md

@@ -0,0 +1,29 @@
+---
+layout: default
+title: "Troubleshooting Steps"
+---
+
+{{ page.title }}
+================
+
+# Cannot Flash a Firmware
+
+## List of Symptoms:
+
+### Thonny shows error while flashing firmware (or Micropython) using Windows
+Possible causes:
+  - Windows is blocking access to Espressif Serial device
+
+### On Linux, the DevBoard device shows briefly and then disappears; the command ls /dev shows no DevBoard device
+Possible causes:
+  - USB-C resiptacle wasn't soldered properly; some pins have poor connection
+  - ESP32-S3 Module wasn't soldered properly; some pins have poor connection
+
+### Device manager alternates visibility of DevBoard device from connected to disconnected
+Possible causes:
+  - Strapping pins pull-up resistors or capacitors are incorrect
+
+### Issues during uploading the firmware
+Possible causes:
+  - ESP32-S3 Module was not properly soldered; some pads have poor connection. Consider re-flowing/re-soldering
+  - USB-C reciptacle was not properly soldered; some pads have poor connection. Consider re-flowing/re-soldering