From 70e8958e4f642116a7b9a714bfb366820c5ad4cc Mon Sep 17 00:00:00 2001 From: Alexander Bobkov Date: Thu, 19 Jun 2025 03:44:01 -0400 Subject: [PATCH] . --- troubleshooting.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/troubleshooting.md b/troubleshooting.md index e69de29..52225f6 100644 --- a/troubleshooting.md +++ b/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