public static List <ProgrammableRegion> BuildFLASHImages(BSPEngine.IDebugStartService service, IESP8266Settings settings, BSPEngine.LiveMemoryLineHandler lineHandler)
{
var bspDict = service.SystemDictionary;
var targetPath = service.TargetPath;
string bspPath = bspDict["SYS:BSP_ROOT"];
string toolchainPath = bspDict["SYS:TOOLCHAIN_ROOT"];
Regex rgBinFile = new Regex("^" + Path.GetFileName(targetPath) + "-0x([0-9a-fA-F]+)\\.bin$", RegexOptions.IgnoreCase);
foreach (var fn in Directory.GetFiles(Path.GetDirectoryName(targetPath)))
{
if (rgBinFile.IsMatch(Path.GetFileName(fn)))
{
File.Delete(fn);
}
}
int initDataAddress = 0;
if (!string.IsNullOrEmpty(settings.InitDataAddress))
{
initDataAddress = (int)(ESP32StartupSequence.TryParseNumber(settings.InitDataAddress) ?? 0);
}
else
{
switch (settings.FLASHSettings.Size)
{
case ESP8266BinaryImage.FLASHSize.size4M:
initDataAddress = 0x7c000;
break;
case ESP8266BinaryImage.FLASHSize.size8M:
initDataAddress = 0xfc000;
break;
case ESP8266BinaryImage.FLASHSize.size16M:
case ESP8266BinaryImage.FLASHSize.size16M_c1:
initDataAddress = 0x1fc000;
break;
case ESP8266BinaryImage.FLASHSize.size32M:
case ESP8266BinaryImage.FLASHSize.size32M_c1:
case ESP8266BinaryImage.FLASHSize.size32M_c2:
initDataAddress = 0x3fc000;
break;
}
}
List <ProgrammableRegion> regions = new List <ProgrammableRegion>();
if (initDataAddress != 0)
{
string initFile = settings.InitDataFile;
if (initFile != "")
{
if (initFile == null)
{
initFile = ESPxxOpenOCDSettingsEditor.DefaultInitDataFile;
}
if (initFile.StartsWith("$$SYS:BSP_ROOT$$"))
{
initFile = bspDict["SYS:BSP_ROOT"] + initFile.Substring("$$SYS:BSP_ROOT$$".Length);
}
if (!Path.IsPathRooted(initFile))
{
initFile = Path.Combine(bspDict["SYS:PROJECT_DIR"], initFile);
}
if (!File.Exists(initFile))
{
throw new Exception("Missing initialization data file: " + initFile);
}
regions.Add(new ProgrammableRegion {
FileName = initFile, Offset = initDataAddress, Size = File.ReadAllBytes(initFile).Length
});
}
}
if (settings.FLASHResources != null)
{
foreach (var r in settings.FLASHResources)
{
if (r.Valid)
{
regions.Add(r.ToProgrammableRegion(service));
}
}
}
using (var elfFile = new ELFFile(targetPath))
{
string pathBase = Path.Combine(Path.GetDirectoryName(targetPath), Path.GetFileName(targetPath));
string status;
int appMode = ESP8266BinaryImage.DetectAppMode(elfFile, out status);
if (status != null && lineHandler != null)
{
lineHandler(status, true);
}
if (appMode == 0)
{
var img = ESP8266BinaryImage.MakeNonBootloaderImageFromELFFile(elfFile, settings.FLASHSettings);
string fn = pathBase + "-0x00000.bin";
using (var fs = new FileStream(fn, FileMode.Create, FileAccess.ReadWrite, FileShare.ReadWrite))
{
img.Save(fs);
regions.Add(new ProgrammableRegion {
FileName = fn, Offset = 0, Size = (int)fs.Length
});
}
foreach (var sec in ESP8266BinaryImage.GetFLASHSections(elfFile))
{
fn = string.Format("{0}-0x{1:x5}.bin", pathBase, sec.OffsetInFLASH);
using (var fs = new FileStream(fn, FileMode.Create, FileAccess.ReadWrite, FileShare.ReadWrite))
{
fs.Write(sec.Data, 0, sec.Data.Length);
regions.Add(new ProgrammableRegion {
FileName = fn, Offset = (int)sec.OffsetInFLASH, Size = sec.Data.Length
});
}
}
}
else
{
var img = ESP8266BinaryImage.MakeBootloaderBasedImageFromELFFile(elfFile, settings.FLASHSettings, appMode);
var header = settings.FLASHSettings;
string bspRoot, bootloader;
if (!bspDict.TryGetValue("SYS:BSP_ROOT", out bspRoot) || !bspDict.TryGetValue("com.sysprogs.esp8266.bootloader", out bootloader))
{
throw new Exception("Cannot determine bootloader image path. Please check your BSP consistency.");
}
string fn = Path.Combine(bspRoot, bootloader);
if (!File.Exists(fn))
{
throw new Exception(fn + " not found. Cannot program OTA images.");
}
byte[] data = File.ReadAllBytes(fn);
data[2] = (byte)header.Mode;
data[3] = (byte)(((byte)header.Size << 4) | (byte)header.Frequency);
fn = string.Format("{0}-0x00000.bin", pathBase);
File.WriteAllBytes(fn, data);
regions.Add(new ProgrammableRegion {
FileName = fn, Offset = 0, Size = File.ReadAllBytes(fn).Length
});
fn = string.Format("{0}-0x{1:x5}.bin", pathBase, img.BootloaderImageOffset);
using (var fs = new FileStream(fn, FileMode.Create, FileAccess.ReadWrite, FileShare.ReadWrite))
{
img.Save(fs);
regions.Add(new ProgrammableRegion {
FileName = fn, Offset = (int)img.BootloaderImageOffset, Size = (int)fs.Length
});
}
}
}
return(regions);
}
public static List <ProgrammableRegion> BuildFLASHImages(string targetPath, Dictionary <string, string> bspDict, Dictionary <string, string> debugMethodConfig, LiveMemoryLineHandler lineHandler)
{
string bspPath = bspDict["SYS:BSP_ROOT"];
string toolchainPath = bspDict["SYS:TOOLCHAIN_ROOT"];
Regex rgBinFile = new Regex("^" + Path.GetFileName(targetPath) + "-0x([0-9a-fA-F]+)\\.bin$", RegexOptions.IgnoreCase);
foreach (var fn in Directory.GetFiles(Path.GetDirectoryName(targetPath)))
{
if (rgBinFile.IsMatch(Path.GetFileName(fn)))
{
File.Delete(fn);
}
}
string freq, mode, size;
debugMethodConfig.TryGetValue("com.sysprogs.esp8266.xt-ocd.flash_freq", out freq);
debugMethodConfig.TryGetValue("com.sysprogs.esp8266.xt-ocd.flash_mode", out mode);
debugMethodConfig.TryGetValue("com.sysprogs.esp8266.xt-ocd.flash_size", out size);
List <ProgrammableRegion> regions = new List <ProgrammableRegion>();
using (var elfFile = new ELFFile(targetPath))
{
string pathBase = Path.Combine(Path.GetDirectoryName(targetPath), Path.GetFileName(targetPath));
string status;
int appMode = ESP8266BinaryImage.DetectAppMode(elfFile, out status);
if (status != null && lineHandler != null)
{
lineHandler(status, true);
}
if (appMode == 0)
{
var img = ESP8266BinaryImage.MakeNonBootloaderImageFromELFFile(elfFile, new ESP8266BinaryImage.ParsedHeader(freq, mode, size));
string fn = pathBase + "-0x00000.bin";
using (var fs = new FileStream(fn, FileMode.Create, FileAccess.ReadWrite, FileShare.ReadWrite))
{
img.Save(fs);
regions.Add(new ProgrammableRegion {
FileName = fn, Offset = 0, Size = (int)fs.Length
});
}
foreach (var sec in ESP8266BinaryImage.GetFLASHSections(elfFile))
{
fn = string.Format("{0}-0x{1:x5}.bin", pathBase, sec.OffsetInFLASH);
using (var fs = new FileStream(fn, FileMode.Create, FileAccess.ReadWrite, FileShare.ReadWrite))
{
fs.Write(sec.Data, 0, sec.Data.Length);
regions.Add(new ProgrammableRegion {
FileName = fn, Offset = (int)sec.OffsetInFLASH, Size = sec.Data.Length
});
}
}
}
else
{
var img = ESP8266BinaryImage.MakeBootloaderBasedImageFromELFFile(elfFile, new ESP8266BinaryImage.ParsedHeader(freq, mode, size), appMode);
string bspRoot, bootloader;
if (!bspDict.TryGetValue("SYS:BSP_ROOT", out bspRoot) || !bspDict.TryGetValue("com.sysprogs.esp8266.bootloader", out bootloader))
{
throw new Exception("Cannot determine bootloader image path. Please check your BSP consistency.");
}
string fn = Path.Combine(bspRoot, bootloader);
if (!File.Exists(fn))
{
throw new Exception(fn + " not found. Cannot program OTA images.");
}
byte[] data = File.ReadAllBytes(fn);
data[2] = (byte)img.Header.Mode;
data[3] = (byte)(((byte)img.Header.Size << 4) | (byte)img.Header.Frequency);
fn = string.Format("{0}-0x00000.bin", pathBase);
File.WriteAllBytes(fn, data);
regions.Add(new ProgrammableRegion {
FileName = fn, Offset = 0, Size = File.ReadAllBytes(fn).Length
});
fn = string.Format("{0}-0x{1:x5}.bin", pathBase, img.BootloaderImageOffset);
using (var fs = new FileStream(fn, FileMode.Create, FileAccess.ReadWrite, FileShare.ReadWrite))
{
img.Save(fs);
regions.Add(new ProgrammableRegion {
FileName = fn, Offset = (int)img.BootloaderImageOffset, Size = (int)fs.Length
});
}
}
}
return(regions);
}
public static CustomStartupSequence BuildSequence(BSPEngine.IDebugStartService service, ESP8266OpenOCDSettings settings, BSPEngine.LiveMemoryLineHandler lineHandler, bool programFLASH)
{
List <CustomStartStep> cmds = new List <CustomStartStep>();
cmds.Add(new CustomStartStep("mon reset halt",
"-exec-next-instruction",
"set $com_sysprogs_esp8266_wdcfg=0",
"set $vecbase=0x40000000",
"$$com.sysprogs.esp8266.interrupt_disable_command$$",
"set $ccompare=0",
"set $intclear=-1",
"set $intenable=0",
"set $eps2=0x20",
"set $icountlevel=0"));
var result = new CustomStartupSequence {
Steps = cmds
};
var bspDict = service.SystemDictionary;
var targetPath = service.TargetPath;
string val;
if (bspDict.TryGetValue("com.sysprogs.esp8266.load_flash", out val) && val == "1") //Not a FLASHless project
{
if (programFLASH)
{
string bspPath = bspDict["SYS:BSP_ROOT"];
List <ProgrammableRegion> regions = BuildFLASHImages(service, settings, lineHandler);
string loader = bspPath + @"\sysprogs\flashprog\ESP8266FlashProg.bin";
if (!File.Exists(loader))
{
throw new Exception("FLASH loader not found: " + loader);
}
var parsedLoader = new ParsedFLASHLoader(loader);
cmds.Add(new CustomStartStep("print *((int *)0x60000900)", "set *((int *)0x60000900)=0"));
cmds.Add(parsedLoader.QueueInvocation(0, settings.ProgramSectorSize.ToString(), settings.EraseSectorSize.ToString(), null, 0, 0, true));
foreach (var region in regions)
{
parsedLoader.QueueRegionProgramming(cmds, region);
}
}
var resetMode = settings.ResetMode;
if (resetMode == ResetMode.Soft)
{
try
{
using (var elfFile = new ELFFile(targetPath))
{
string pathBase = Path.Combine(Path.GetDirectoryName(targetPath), Path.GetFileName(targetPath));
string status;
int appMode = ESP8266BinaryImage.DetectAppMode(elfFile, out status);
if (appMode != 0)
{
if (service.GUIService.Prompt("The soft reset mechanism is not compatible with the OTA images. Use the jump-to-entry reset instead?"))
{
resetMode = ResetMode.Hard;
}
}
}
}
catch
{
}
}
if (resetMode == ResetMode.Soft || resetMode == ResetMode.JumpToEntry)
{
string entry = "0x40000080";
if (resetMode == ResetMode.JumpToEntry)
{
using (ELFFile elf = new ELFFile(targetPath))
{
foreach (var sec in elf.AllSections)
{
if (!sec.PresentInMemory || !sec.HasData || sec.Type != ELFFile.SectionType.SHT_PROGBITS)
{
continue;
}
bool isInRAM = false;
if (sec.VirtualAddress >= 0x3FFE8000 && sec.VirtualAddress < (0x3FFE8000 + 81920))
{
isInRAM = true;
}
else if (sec.VirtualAddress >= 0x40100000 && sec.VirtualAddress <= (0x40100000 + 32768))
{
isInRAM = true;
}
if (isInRAM)
{
cmds.Add(new CustomStartStep(string.Format("restore {0} binary 0x{1:x} 0x{2:x} 0x{3:x}", targetPath.Replace('\\', '/'),
sec.VirtualAddress - sec.OffsetInFile, sec.OffsetInFile, sec.OffsetInFile + sec.Size))
{
CheckResult = true, ErrorMessage = "Failed to program the " + sec.SectionName + " section"
});
}
}
}
entry = "$$DEBUG:ENTRY_POINT$$";
}
cmds.Add(new CustomStartStep("set $ps=0x20",
"set $epc2=" + entry,
"set $sp=$$DEBUG:INITIAL_STACK_POINTER$$",
"set $vecbase=0x40000000",
"$$com.sysprogs.esp8266.interrupt_disable_command$$",
"set $intclear=-1",
"set $intenable=0",
"set $eps2=0x20",
"set $icountlevel=0"));
result.InitialHardBreakpointExpression = "*$$DEBUG:ENTRY_POINT$$";
}
else
{
cmds.Add(new CustomStartStep("mon reset halt"));
}
}
else
{
cmds.Add(new CustomStartStep("load",
"set $ps=0x20",
"set $epc2=$$DEBUG:ENTRY_POINT$$",
"set $sp=$$DEBUG:INITIAL_STACK_POINTER$$",
"set $vecbase=0x40000000",
"$$com.sysprogs.esp8266.interrupt_disable_command$$",
"set $ccompare=0",
"set $intclear=-1",
"set $intenable=0",
"set $eps2=0x20",
"set $icountlevel=0"));
}
return(result);
}
public CustomStartupSequence BuildSequence(string targetPath, Dictionary <string, string> bspDict, Dictionary <string, string> debugMethodConfig, LiveMemoryLineHandler lineHandler)
{
bool isOpenOCD = debugMethodConfig.ContainsKey("com.sysprogs.esp8266.openocd.iface_script");
List <CustomStartStep> cmds = new List <CustomStartStep>();
cmds.Add(new CustomStartStep(isOpenOCD ? "mon reset halt" : "maint packet R",
"-exec-next-instruction",
"set $com_sysprogs_esp8266_wdcfg=0",
"set $vecbase=0x40000000",
"$$com.sysprogs.esp8266.interrupt_disable_command$$",
"set $ccompare=0",
"set $intclear=-1",
"set $intenable=0",
"set $eps2=0x20",
"set $icountlevel=0"));
var result = new CustomStartupSequence {
Steps = cmds
};
string val;
if (bspDict.TryGetValue("com.sysprogs.esp8266.load_flash", out val) && val == "1") //Not a FLASHless project
{
if (debugMethodConfig.TryGetValue("com.sysprogs.esp8266.xt-ocd.program_flash", out val) && val != "0")
{
string bspPath = bspDict["SYS:BSP_ROOT"];
List <ProgrammableRegion> regions = BuildFLASHImages(targetPath, bspDict, debugMethodConfig, lineHandler);
string loader = bspPath + @"\sysprogs\flashprog\ESP8266FlashProg.bin";
if (!File.Exists(loader))
{
throw new Exception("FLASH loader not found: " + loader);
}
var parsedLoader = new ParsedFLASHLoader(loader);
cmds.Add(new CustomStartStep("print *((int *)0x60000900)", "set *((int *)0x60000900)=0"));
cmds.Add(parsedLoader.QueueInvocation(0, "$$com.sysprogs.esp8266.xt-ocd.prog_sector_size$$", "$$com.sysprogs.esp8266.xt-ocd.erase_sector_size$$", null, 0, 0, true));
foreach (var region in regions)
{
parsedLoader.QueueRegionProgramming(cmds, region);
}
}
if (!debugMethodConfig.TryGetValue("com.sysprogs.esp8266.xt-ocd.flash_start_mode", out val))
{
val = "soft_reset";
}
if (val == "soft_reset")
{
try
{
using (var elfFile = new ELFFile(targetPath))
{
string pathBase = Path.Combine(Path.GetDirectoryName(targetPath), Path.GetFileName(targetPath));
string status;
int appMode = ESP8266BinaryImage.DetectAppMode(elfFile, out status);
if (appMode != 0)
{
if (System.Windows.Forms.MessageBox.Show("The soft reset mechanism is not compatible with the OTA images. Use the jump-to-entry reset instead?", "VisualGDB", System.Windows.Forms.MessageBoxButtons.YesNo, System.Windows.Forms.MessageBoxIcon.Warning) == System.Windows.Forms.DialogResult.Yes)
{
val = "entry_point";
}
}
}
}
catch
{
}
}
if (val == "soft_reset" || val == "entry_point")
{
string entry = "0x40000080";
if (val == "entry_point")
{
using (ELFFile elf = new ELFFile(targetPath))
{
foreach (var sec in elf.AllSections)
{
if (!sec.PresentInMemory || !sec.HasData || sec.Type != ELFFile.SectionType.SHT_PROGBITS)
{
continue;
}
bool isInRAM = false;
if (sec.VirtualAddress >= 0x3FFE8000 && sec.VirtualAddress < (0x3FFE8000 + 81920))
{
isInRAM = true;
}
else if (sec.VirtualAddress >= 0x40100000 && sec.VirtualAddress <= (0x40100000 + 32768))
{
isInRAM = true;
}
if (isInRAM)
{
cmds.Add(new CustomStartStep(string.Format("restore {0} binary 0x{1:x} 0x{2:x} 0x{3:x}", targetPath.Replace('\\', '/'),
sec.VirtualAddress - sec.OffsetInFile, sec.OffsetInFile, sec.OffsetInFile + sec.Size))
{
CheckResult = true, ErrorMessage = "Failed to program the " + sec.SectionName + " section"
});
}
}
}
entry = "$$DEBUG:ENTRY_POINT$$";
}
cmds.Add(new CustomStartStep("set $ps=0x20",
"set $epc2=" + entry,
"set $sp=$$DEBUG:INITIAL_STACK_POINTER$$",
"set $vecbase=0x40000000",
"$$com.sysprogs.esp8266.interrupt_disable_command$$",
"set $intclear=-1",
"set $intenable=0",
"set $eps2=0x20",
"set $icountlevel=0"));
result.InitialHardBreakpointExpression = "*$$DEBUG:ENTRY_POINT$$";
}
else
{
cmds.Add(new CustomStartStep(isOpenOCD ? "mon reset halt" : "maint packet R"));
}
}
else
{
cmds.Add(new CustomStartStep("load",
"set $ps=0x20",
"set $epc2=$$DEBUG:ENTRY_POINT$$",
"set $sp=$$DEBUG:INITIAL_STACK_POINTER$$",
"set $vecbase=0x40000000",
"$$com.sysprogs.esp8266.interrupt_disable_command$$",
"set $ccompare=0",
"set $intclear=-1",
"set $intenable=0",
"set $eps2=0x20",
"set $icountlevel=0"));
}
return(result);
}