171 def load_ram(esp, args):  argument
172     image = LoadFirmwareImage(esp.CHIP_NAME, args.filename)
194 def read_mem(esp, args):  argument
195     print("0x%08x = 0x%08x" % (args.address, esp.read_reg(args.address)))
198 def write_mem(esp, args):  argument
199     esp.write_reg(args.address, args.value, args.mask, 0)
200     print("Wrote %08x, mask %08x to %08x" % (args.value, args.mask, args.address))
203 def dump_mem(esp, args):  argument
204     with open(args.filename, "wb") as f:
205         for i in range(args.size // 4):
206             d = esp.read_reg(args.address + (i * 4))
210                     "%d bytes read... (%d %%)" % (f.tell(), f.tell() * 100 // args.size)
217 def detect_flash_size(esp, args=None):  argument
220         if args is not None and args.flash_size == "detect":
230     if args is not None and args.flash_size == "detect":
239         args.flash_size = flash_size
243 def _update_image_flash_params(esp, address, args, image):  argument
255     if (args.flash_mode, args.flash_freq, args.flash_size) == ("keep",) * 3:
282     sha_appended = args.chip != "esp8266" and image[8 + 15] == 1
284     if args.flash_mode != "keep":
285         flash_mode = FLASH_MODES[args.flash_mode]
288     if args.flash_freq != "keep":
289         flash_freq = esp.parse_flash_freq_arg(args.flash_freq)
292     if args.flash_size != "keep":
293         flash_size = esp.parse_flash_size_arg(args.flash_size)
338 def write_flash(esp, args):  argument
342     if args.compress is None and not args.no_compress:
343         args.compress = not args.no_stub
345     if not args.force and esp.CHIP_NAME != "ESP8266" and not esp.secure_download_mode:
348             for address, _ in args.addr_filename:
357         for _, argfile in args.addr_filename:
414     if args.encrypt or args.encrypt_files is not None:
439         files_to_encrypt = args.addr_filename if args.encrypt else args.encrypt_files
449         if not do_write and not args.ignore_flash_encryption_efuse_setting:
455         if not args.force and esp.CHIP_NAME != "ESP8266":
482         flash_size_bytes(args.flash_size)
483         if args.flash_size not in ["detect", "keep"]
500         for address, argfile in args.addr_filename:
510     if args.erase_all:
511         erase_flash(esp, args)
513         for address, argfile in args.addr_filename:
549         (offs, filename, args.encrypt) for (offs, filename) in args.addr_filename
556     if args.encrypt_files is not None:
558             (offs, filename, True) for (offs, filename) in args.encrypt_files
568         compress = args.compress
584         if args.no_stub:
595             image = _update_image_flash_params(esp, address, args, image)
743         if args.compress and not last_file_encrypted:
748     if args.verify:
756         if args.encrypt or args.encrypt_files is not None:
760         if not args.encrypt:
761             verify_flash(esp, args)
764 def image_info(args):  argument
774         title = "{} image header".format(args.chip.upper())
813         if args.chip != "esp8266":
815             title = "{} extended image header".format(args.chip.upper())
959     with open(args.filename, "rb") as f:
974         if args.chip == "auto":
985                         args.chip = rom.CHIP_NAME
990                 args.chip = "esp8266"
994     image = LoadFirmwareImage(args.chip, args.filename)
996     if args.version == "2":
1038 def make_image(args):  argument
1039     print("Creating {} image...".format(args.chip))
1041     if len(args.segfile) == 0:
1043     if len(args.segfile) != len(args.segaddr):
1047     for seg, addr in zip(args.segfile, args.segaddr):
1051     image.entrypoint = args.entrypoint
1052     image.save(args.output)
1053     print("Successfully created {} image.".format(args.chip))
1056 def elf2image(args):  argument
1057     e = ELFFile(args.input)
1058     if args.chip == "auto":  # Default to ESP8266 for backwards compatibility
1059         args.chip = "esp8266"
1061     print("Creating {} image...".format(args.chip))
1063     if args.chip != "esp8266":
1064         image = CHIP_DEFS[args.chip].BOOTLOADER_IMAGE()
1065         if args.chip == "esp32" and args.secure_pad:
1067         if args.secure_pad_v2:
1069         image.min_rev = args.min_rev
1070         image.min_rev_full = args.min_rev_full
1071         image.max_rev_full = args.max_rev_full
1072         image.ram_only_header = args.ram_only_header
1076             image.append_digest = args.append_digest
1077     elif args.version == "1":  # ESP8266
1079     elif args.version == "2":
1084     image.flash_mode = FLASH_MODES[args.flash_mode]
1086     if args.flash_mmu_page_size:
1087         image.set_mmu_page_size(flash_size_bytes(args.flash_mmu_page_size))
1090     image.segments = e.segments if args.use_segments else e.sections
1091     if args.pad_to_size:
1092         image.pad_to_size = flash_size_bytes(args.pad_to_size)
1093     image.flash_size_freq = image.ROM_LOADER.parse_flash_size_arg(args.flash_size)
1094     image.flash_size_freq += image.ROM_LOADER.parse_flash_freq_arg(args.flash_freq)
1096     if args.elf_sha256_offset:
1098         image.elf_sha256_offset = args.elf_sha256_offset
1100     if args.ram_only_header:
1115     if args.output is None:
1116         args.output = image.default_output_name(args.input)
1117     image.save(args.output)
1119     print("Successfully created {} image.".format(args.chip))
1122 def read_mac(esp, args):  argument
1135 def chip_id(esp, args):  argument
1141         read_mac(esp, args)
1144 def erase_flash(esp, args):  argument
1145     if not args.force and esp.CHIP_NAME != "ESP8266" and not esp.secure_download_mode:
1159 def erase_region(esp, args):  argument
1160     if not args.force and esp.CHIP_NAME != "ESP8266" and not esp.secure_download_mode:
1170     esp.erase_region(args.address, args.size)
1174 def run(esp, args):  argument
1188 def flash_id(esp, args):  argument
1198 def read_flash_sfdp(esp, args):  argument
1201     sfdp = esp.read_spiflash_sfdp(args.addr, args.bytes * 8)
1203     for i in range(args.bytes):
1209 def read_flash(esp, args):  argument
1210     if args.no_progress:
1223     data = esp.read_flash(args.address, args.size, flash_progress)
1228             len(data), args.address, t, speed_msg
1232     with open(args.filename, "wb") as f:
1236 def verify_flash(esp, args):  argument
1239     for address, argfile in args.addr_filename:
1243         image = _update_image_flash_params(esp, address, args, image)
1258             if getattr(args, "diff", "no") != "yes":
1277 def read_flash_status(esp, args):  argument
1278     print("Status value: 0x%04x" % esp.read_status(args.bytes))
1281 def write_flash_status(esp, args):  argument
1282     fmt = "0x%%0%dx" % (args.bytes * 2)
1283     args.value = args.value & ((1 << (args.bytes * 8)) - 1)
1284     print(("Initial flash status: " + fmt) % esp.read_status(args.bytes))
1285     print(("Setting flash status: " + fmt) % args.value)
1286     esp.write_status(args.value, args.bytes, args.non_volatile)
1287     print(("After flash status:   " + fmt) % esp.read_status(args.bytes))
1315 def get_security_info(esp, args):  argument
1390 def merge_bin(args):  argument
1392         chip_class = CHIP_DEFS[args.chip]
1396             if args.chip == "auto"
1404     input_files = sorted(args.addr_filename, key=lambda x: x[0])
1408     if first_addr < args.target_offset:
1414     if args.format == "uf2":
1417             args.output,
1418             args.chunk_size,
1419             md5_enabled=not args.md5_disable,
1424                 image = _update_image_flash_params(chip_class, addr, args, image)
1431     elif args.format == "raw":
1432         with open(args.output, "wb") as of:
1436                 of.write(b"\xff" * (flash_offs - args.target_offset - of.tell()))
1441                 image = _update_image_flash_params(chip_class, addr, args, image)
1443             if args.fill_flash_size:
1444                 pad_to(flash_size_bytes(args.fill_flash_size))
1449     elif args.format == "hex":
1461             image = _update_image_flash_params(chip_class, addr, args, image)
1464         out.write_hex_file(args.output)
1471 def version(args):  argument