Add support for ESP32-C3 (#167)

Author: josesimoes

nanoFirmwareFlasher.Library/Esp32Firmware.cs

@@ -50,8 +50,10 @@ public Esp32Firmware(
             _partitionTableSize = partitionTableSize;
         }
 
-        internal async System.Threading.Tasks.Task<ExitCodes> DownloadAndExtractAsync(int flashSize)
+        internal async System.Threading.Tasks.Task<ExitCodes> DownloadAndExtractAsync(Esp32DeviceInfo deviceInfo)
         {
+            int flashSize = deviceInfo.FlashSize;
+
             if (_partitionTableSize is not null)
             {
                 // if specified, partition table size overrides flash size.
@@ -64,7 +66,7 @@ internal async System.Threading.Tasks.Task<ExitCodes> DownloadAndExtractAsync(in
             {
                 if (Verbosity >= VerbosityLevel.Detailed)
                 {
-                    Console.WriteLine($"There is no firmware available for ESP32 with {Esp32DeviceInfo.GetFlashSizeAsString(flashSize)} flash size!{Environment.NewLine}Only the following flash sizes are supported: {string.Join(", ", SupportedFlashSizes.Select(size => size >= 0x10000 ? $"{ size / 0x100000 }MB" : $"{ size / 0x400 }kB."))}");
+                    Console.WriteLine($"There is no firmware available for ESP32 with {Esp32DeviceInfo.GetFlashSizeAsString(flashSize)} flash size!{Environment.NewLine}Only the following flash sizes are supported: {string.Join(", ", SupportedFlashSizes.Select(size => size >= 0x10000 ? $"{size / 0x100000}MB" : $"{size / 0x400}kB."))}");
                 }
 
                 return ExitCodes.E4001;
@@ -80,8 +82,8 @@ internal async System.Threading.Tasks.Task<ExitCodes> DownloadAndExtractAsync(in
                 // get ESP32 partitions
                 FlashPartitions = new Dictionary<int, string>
                 {
-				    // bootloader goes to 0x1000
-				    { 0x1000, Path.Combine(LocationPath, BootloaderPath) },
+				    // bootloader goes to 0x1000, except for ESP32_C3 which goes to 0x0
+				    { deviceInfo.ChipType == "ESP32-C3" ? 0x0 : 0x1000, Path.Combine(LocationPath, BootloaderPath) },
 
 				    // nanoCLR goes to 0x10000
 				    { CLRAddress, Path.Combine(LocationPath, "nanoCLR.bin") },

nanoFirmwareFlasher.Library/Esp32Operations.cs

@@ -126,7 +126,8 @@ public static async System.Threading.Tasks.Task<ExitCodes> UpdateFirmwareAsync(
 
             // perform sanity checks for the specified target against the connected device details
             if (esp32Device.ChipType != "ESP32" &&
-                esp32Device.ChipType != "ESP32-S2")
+                esp32Device.ChipType != "ESP32-S2" &&
+                esp32Device.ChipType != "ESP32-C3")
             {
                 // connected to a device not supported
                 Console.ForegroundColor = ConsoleColor.Yellow;
@@ -175,6 +176,19 @@ public static async System.Threading.Tasks.Task<ExitCodes> UpdateFirmwareAsync(
                             revisionSuffix = "REV0";
                         }
 
+                        if (esp32Device.ChipName.Contains("ESP32_C3"))
+                        {
+                            if (esp32Device.ChipName.Contains("revision 2"))
+                            {
+                                revisionSuffix = "REV2";
+                            }
+                            else
+                            {
+                                // all the others (rev3 and rev4) will take rev3
+                                revisionSuffix = "REV3";
+                            }
+                        }
+
                         // compose target name
                         targetName = $"ESP32{psRamSegment}{otherSegment}_{revisionSuffix}";
                     }
@@ -194,6 +208,36 @@ public static async System.Threading.Tasks.Task<ExitCodes> UpdateFirmwareAsync(
 
                     return ExitCodes.E9000;
                 }
+                else if (esp32Device.ChipType == "ESP32-C3")
+                {
+                    string revisionSuffix;
+
+                    if (esp32Device.ChipName.Contains("revision 2"))
+                    {
+                        revisionSuffix = "REV2";
+                    }
+                    else if (esp32Device.ChipName.Contains("revision 3") || esp32Device.ChipName.Contains("revision 4"))
+                    {
+                        // all the others (rev3 and rev4) will take rev3
+                        revisionSuffix = "REV3";
+                    }
+                    else
+                    {
+                        Console.ForegroundColor = ConsoleColor.Red;
+
+                        Console.WriteLine("");
+                        Console.WriteLine($"Unsupported ESP32_C3 revision.");
+                        Console.WriteLine("");
+
+                        Console.ForegroundColor = ConsoleColor.White;
+
+                        return ExitCodes.E9000;
+                    }
+
+                    // compose target name
+                    targetName = $"ESP32_C3_{revisionSuffix}";
+                }
+
 
                 Console.ForegroundColor = ConsoleColor.Blue;
 
@@ -265,7 +309,7 @@ public static async System.Threading.Tasks.Task<ExitCodes> UpdateFirmwareAsync(
             // need to download update package?
             if (updateFw)
             {
-                operationResult = await firmware.DownloadAndExtractAsync(esp32Device.FlashSize);
+                operationResult = await firmware.DownloadAndExtractAsync(esp32Device);
 
                 if (operationResult != ExitCodes.OK)
                 {

nanoFirmwareFlasher.Library/EspTool.cs

@@ -252,10 +252,16 @@ public Esp32DeviceInfo GetDeviceDetails(
                 // FEATHER_S2's have PSRAM, so don't even bother
                 psramIsAvailable = PSRamAvailability.Yes;
             }
+            else if (name.Contains("ESP32-C3"))
+            {
+                // all ESP32-C3 SDK config have support for PSRAM, so don't even bother
+                psramIsAvailable = PSRamAvailability.Undetermined;
+            }
             else
             {
-                // if a target name was provided, don't bother to check PSRAM
-                if (targetName == null)
+                // if a target name wasn't provided, check for PSRAM
+                // except for ESP32_C3
+                if (targetName == null && !name.Contains("ESP32-C3"))
                 {
                     psramIsAvailable = FindPSRamAvailable();
                 }

version.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://raw.githubusercontent.com/dotnet/Nerdbank.GitVersioning/master/src/NerdBank.GitVersioning/version.schema.json",
-  "version": "2.3",
+  "version": "2.4",
   "assemblyVersion": {
     "precision": "minor"
   },