internal static async System.Threading.Tasks.Task <ExitCodes> UpdateFirmwareAsync(
EspTool espTool,
EspTool.DeviceInfo esp32Device,
string targetName,
bool updateFw,
string fwVersion,
bool stable,
string applicationPath,
string deploymentAddress,
VerbosityLevel verbosity)
{
ExitCodes operationResult = ExitCodes.OK;
uint address = 0;
// if a target name wasn't specified use the default (and only available) ESP32 target
if (string.IsNullOrEmpty(targetName))
{
targetName = _esp32TargetName;
}
Esp32Firmware firmware = new Esp32Firmware(
targetName,
fwVersion,
stable)
{
Verbosity = verbosity
};
// need to download update package?
if (updateFw)
{
operationResult = await firmware.DownloadAndExtractAsync(esp32Device.FlashSize);
if (operationResult != ExitCodes.OK)
{
return(operationResult);
}
// download successful
}
// need to include application file?
if (!string.IsNullOrEmpty(applicationPath))
{
// check application file
if (File.Exists(applicationPath))
{
if (!updateFw)
{
// this is a deployment operation only
// try parsing the deployment address from parameter
// need to remove the leading 0x and to specify that hexadecimal values are allowed
if (!uint.TryParse(deploymentAddress.Substring(2), System.Globalization.NumberStyles.AllowHexSpecifier, System.Globalization.CultureInfo.InvariantCulture, out address))
{
return(ExitCodes.E9009);
}
}
string applicationBinary = new FileInfo(applicationPath).FullName;
firmware.FlashPartitions = new Dictionary <int, string>()
{
{
updateFw?firmware.DeploymentPartionAddress : (int)address,
applicationBinary
}
};
}
else
{
return(ExitCodes.E9008);
}
}
if (verbosity >= VerbosityLevel.Normal)
{
Console.Write($"Erasing flash...");
}
if (updateFw)
{
// erase flash
operationResult = espTool.EraseFlash();
}
else
{
// erase flash segment
// need to get deployment address here
// length must both be multiples of the SPI flash erase sector size. This is 0x1000 (4096) bytes for supported flash chips.
var flashPartition = firmware.FlashPartitions.First();
var fileStream = File.OpenRead(flashPartition.Value);
uint fileLength = (uint)Math.Ceiling((decimal)fileStream.Length / 0x1000) * 0x1000;
operationResult = espTool.EraseFlashSegment(address, fileLength);
}
if (operationResult == ExitCodes.OK)
{
if (verbosity >= VerbosityLevel.Normal)
{
Console.WriteLine("OK");
}
else
{
Console.WriteLine("");
}
if (verbosity >= VerbosityLevel.Normal)
{
Console.Write($"Flashing firmware...");
}
// write to flash
operationResult = espTool.WriteFlash(firmware.FlashPartitions);
if (operationResult == ExitCodes.OK)
{
if (verbosity >= VerbosityLevel.Normal)
{
Console.WriteLine("OK");
}
else
{
Console.WriteLine("");
}
}
}
return(operationResult);
}
public static ExitCodes BackupFlash(
EspTool tool,
EspTool.DeviceInfo device,
string backupPath,
string fileName,
VerbosityLevel verbosity)
{
// check for backup file without backup path
if (!string.IsNullOrEmpty(fileName) &&
string.IsNullOrEmpty(backupPath))
{
// backup file without backup path
return(ExitCodes.E9004);
}
// check if directory exists, if it doesn't, try to create
if (!Directory.Exists(backupPath))
{
try
{
Directory.CreateDirectory(backupPath);
}
catch
{
return(ExitCodes.E9002);
}
}
// file name specified
if (string.IsNullOrEmpty(fileName))
{
fileName = $"{device.ChipName}_0x{device.MacAddress:X}_{DateTime.UtcNow.ToShortDateString()}.bin";
}
var backupFilePath = Path.Combine(backupPath, fileName);
// check file existence
if (File.Exists(fileName))
{
try
{
File.Delete(backupFilePath);
}
catch
{
return(ExitCodes.E9003);
}
}
if (verbosity >= VerbosityLevel.Normal)
{
Console.WriteLine($"Backing up the firmware to \r\n{backupFilePath}...");
}
tool.BackupFlash(backupFilePath, device.FlashSize);
if (verbosity > VerbosityLevel.Quiet)
{
Console.WriteLine($"Flash backup saved to {fileName}");
}
return(ExitCodes.OK);
}
