;)di]_ddlZddlZddlZddlZddlZddlZddlZddlZddlm Z ddl m Z ddl m Z ddlmZmZddlmZmZmZddlmZmZmZmZmZdd lmZdd lmZmZmZdd l m!Z!dd l"m#Z#m$Z$m%Z%m&Z&dd l"m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.dZ/dZ0dddddddZ1idddddddddddddddd d!d"d#d$d%d&dd"d'd$d(d&d)dd*dd+dddddd d"d,Z2ddd-d.d/Z3ej4ej5d0d1efd2e6d3e7d4e6d5e8d6e7d7ef d8Z9d9ed:e*d7dfd;Z:d9eddxd9edFe8d7e?e7e7e6dzffdGZ@d9ed7e6dzfdHZAdIZB dyd9edKeCe?e7e*fdLe6dMe6dNe6d7df dOZDd9ed7dfdPZEd9ed7dfdQZF dwd9edRe?e7e7e7e7e7fe6zdzd7dfdSZGdzdTZHd{d9edUe8d7dfdVZId{d9ed.check_if_stubsR *h(**+++  ) /h.A.M**844H*.H 'zDetecting chip type...endflush parsed_flagsSECURE_DOWNLOAD_ENABLEzUnexpected chip ID value .esp32s2z& Autodetection failed, trying again...F)rXwarningszUnexpected chip magic value #010xzW Failed to autodetect chip type. Probably it is unsupported by this version of esptool.)r serial_port startswith USES_RFC2217connectrr\ get_chip_idrUSES_MAGIC_VALUE IMAGE_CHIP_ID_portget_security_infosecure_download_mode _post_connectrrread_regCHIP_DETECT_MAGIC_REG_ADDRr MAGIC_VALUE) rQrRrSrTrUinstrbchip_idclssierr_msgchip_magic_valuer`s @ra detect_chipres. DD$mDDDK))*55(#'   &6$GGG i5O *$????))++ = =C# #+++s;,d-PPP++--,.~,>?W,X)$}T**""$$$ ,='<<(:;S(TD % =&&D    KKKKK    I> ? ? ?   .$     I.Bd C C C C*334        O OC' 3?22s;,d-PPP$}T**""$$$ 3 O5ENNNNGK%ON    C C C  sF%B)DJ#EJA/H%2J6A,H%"J$H%%AJJespinputc t|\}}t|j|}tj|dnd|d}tjd|dt |jdD]\}}t|j }tj |t|jd|d |j d d d | |t||j|j|j d}t|j dkr^||j d|j||j |jd|_ |dz }t|j dk^tjdtjdt|jd|d|jd d||jdS)a Load a firmware image into RAM and execute it on the ESP device. Args: esp: Initiated esp object connected to a real device. input: Path to the firmware image file, opened file-like object, or the image data as bytes. Nimage'zLoading z to RAM...r)startz Downloading bytes at rmr[...cur_iter total_itersprefixsuffixrTfinishzLoaded z segments from z to RAM, executing at rj)rrr]rstager\ enumeratesegmentslendata progress_baraddr mem_beginr ESP_RAM_BLOCK mem_block entrypoint mem_finish) rrrsourcerisegsizeseqs raload_ramrsU##LD& cmT 2 2EIKKKWWMMMMFI++++,,,EN!444338}} EN++C$CC#(CCCC      +dC$5668I38   #(mma MM#(1s'8#893 ? ? ?x 1 3 34CH 1HC#(mmaITI 2#en%% 2 2f 2 2(1 2 2 2NN5#$$$$$rcaddresscbtj|dd||ddS)z Read and display a 32-bit value from a memory address on the ESP device. Args: esp: Initiated esp object connected to a real device. address: Memory address to read from (32-bit aligned). rmz = N)rr\ry)rrs raread_memrs:I@@@3<<#8#8@@@AAAAArcvaluemaskc x||||dtjd|dd|dd|dddS)aS Write a 32-bit value to a memory address on the ESP device with optional bitmask. Args: esp: Initiated esp object connected to a real device. address: Memory address to write to (32-bit aligned). value: 32-bit value to write. mask: Bitmask specifying which bits to modify (default: all bits). rWrote rmz with mask z to rjN) write_regrr\)rrrrs ra write_memrsWMM'5$***IOuOOOtOOOwOOOOPPPPPrcroutputc <tj}tjtjd|d|d|rd|dndzt j}t |dzD]}||dzz}||}|tj d|| } | d zd ks| |kr6tj | |d |dd d | d |dt j|z }|dkr0d | |z dzdz nd} |rd|dnd} tjdtjd| d|dd|dd| | d |rQt|d5} | |dddn #1swxYwYdS|S) a Dump a block of memory from the ESP device. Args: esp: Initiated esp object connected to a real device. address: Starting memory address to dump from. size: Number of bytes to dump. output: Path to output file for binary data. If None, returns the data. Returns: Memory dump as bytes if output is None; otherwise, returns None after writing to file. zDumping bytes from rmz to file 'z'...rr*zHr#06xrjzSHA digest in image updated.z?SHA recalculation for binary failed! Expected calculated SHA: z SHA stored in binary: )rBOOTLOADER_FLASH_OFFSETrunpackESP_IMAGE_MAGICrwarningBOOTLOADER_IMAGErrverify Exceptionr] FLASH_MODESparse_flash_freq_argparse_flash_size_argrr\ data_lengthSHA256_DIGEST_LENhashlibsha256digestbytes itertoolschainr)rr flash_freq flash_moderrmagicrimg_flash_modeimg_flash_size_freq test_image sha_appendedimg_flash_freqimg_flash_size flash_params image_objectimage_data_before_shaimage_data_after_shasha_digest_calculatedimage_stored_shas ra_update_image_flash_paramsr ys. 5zzA~~ #--- J +}<< 5;M&%PRQRPR)4T4T1E1n1 ###  2W K 2 2 2    ))"*U*;*;<<    3W O 3 3 3 3 3    =I-D%-12DLV$Z0(4/NV11*==(4/NV11*==;unn~6UVVLuQqSz!! Sv}T<'H'H'K S S S S   ac \)E!""I5 ++BJu,=,=>> %&@ (@&@ A$  % (F F I I !(/D E E L L N N O%'<>R    !  $|'?,(- -  ' ( (F3C,D,D D D I4 5 5 5 5 KI.45J.K.KII.45E.F.FII    Ls7;B33-C#"C#r addr_datarrrc T7d|D}|dd}|dd7|dd}|dd} |dd} |d d} |d d} |d d} | s | s|j} | s|jd kr|js|r|D]\}}|d krt d|D]\}\}} t |j|}n"#t tjtf$rY>wxYw|j |j kr$|dnd|d}t |d|jd|j dkrd}n(|j dkrd}|j dkr |jdkrd}nd}|r|}||j ks ||j krsd|d}|d|j dzd|j dzdz }|j dkr|dz }n|d|j dzd|j dzdz }|d|dzd|dzd z }t |d!M|jd"kr|}n|}||jkrt d|d#|jd$|d%7s|d}|js|rt d&|}| |d'krt)jd(|d)d}|}|st)jd*d}7|n d+|D}|D|D]A\}\}}||jzr/|d,nd|d}t)j|d-|d)d.|jd/d}B|s| st d0n| s|jd kr|jd1krW|jrPt3|d2d3d4zdkrt d5|js7|r#|rt d6t;||}|d7vrt=|nd}|jr|}nCt?|}t=|}|r#|r!||krt)jd8|d9|d|r|rtA||n|}|T|D]Q\}\}}|tC|z|kr3|d,nd:|d}t |d;tC|d<|d=d>|d?R|rtE|n|D]\}\}}|tC|z}||j#z} | dkr&t)j$d@|d=dA|j#d)dB| d)dCt)jdD%|| z tM||j#|j#zd4z  7fdE|D}! |!dF|D}"tO|!|"zdGH}!|!D]}\}}}}#| } | rN|#rL|dInd|d}t)jdJt)jdKt)jdL|dMd} |}tC|dkrt)j|dNnd|dOtQ||#r|jndP}|js+t)jdQ||j#z} || z}dR| z|z}|js)|stS||||||}nt)jdStUj+|,}$tC|}%| r&|}&t[j.|&dT}tC|}'|}(t)j/tad4|j1d4zD]}) | r+t[j2}*|3|%|'|n|4|%||#Ud}+d},d}-tkj5}.tl}/| r|'n|%}0tC|dkrq| s7t)j7|0tC|z |0dV||-zd=dWdW|,dX|0dYZtC|dkrn#|d|j8}1| rztC|*9|1}2|-|2z }-tutltwtx|2}3|js|3}/|=|1|+|/[|jr|3}/n^|1dR|j8tC|1z zz}1|#r|>|1|+n|?|1|+|-tC|1z }-|,tC|1z },||j8d}|+d4z }+tC|dkqn#t$r|)|j1ks|#rt)jd\|jABt)jd]d^_tatD]} tkjDd4|jAEt)j|F|jrd|_|G}|(}n(#t$rt)jdd^d`YwxYwYwxYw|jrA|!dadb}4| r|4s|Hd|/cn|Id|/ctkj5|.z }.d^}5t)j/dd| r=|.dekrdf|%|.z dgzdhz didj}5t)jdk|%dl|,dm|d=dn|.dido|5d n7|.dekrdp|-|.z dgzdhz z}5t)jdk|-dq|d=dn|.dido|5d |#s|js |J||%}6|6|$kryt)jdr|$t)jds|6|6tUj+dR|%z,krt dtt dut)jdvX#t$rYewxYwt)jdwdS)xa# Write firmware or data to the SPI flash memory of an ESP device. Args: esp: Initiated esp object connected to a real device. addr_data: List of (address, data) tuples specifying where to write each file or data in flash memory. The data can be a file path (str), bytes, or a file-like object. flash_freq: Flash frequency to set in the bootloader image header (``"keep"`` to retain current). flash_mode: Flash mode to set in the bootloader image header (``"keep"`` to retain current). flash_size: Flash size to set in the bootloader image header (``"keep"`` to retain current). Keyword Args: erase_all (bool): Erase the entire flash before writing. encrypt (bool): Encrypt all files during flashing. encrypt_files (list[tuple[int, ImageSource]] | None): List of (address, data) tuples for files to encrypt individually. compress (bool): Compress data before flashing. no_compress (bool): Don't compress data before flashing. force (bool): Ignore safety checks (e.g., overwriting bootloader, flash size). ignore_flash_enc_efuse (bool): Ignore flash encryption eFuse settings. no_progress (bool): Disable progress updates. c6g|]\}}|t|fSr.0rrs ra zwrite_flash..s'JJJ*$tYt__-JJJrc erase_allFencrypt encrypt_filesNcompress no_compressforceignore_flash_enc_efuse no_progressESP8266izSecure Boot detected, writing to flash regions < 0x8000 is disabled to protect the bootloader. Use the force argument to override, please use with caution, otherwise it may brick your device!zInput does not containrz ' is not anz an z/ image. Use the force argument to flash anyway.rTz"' requires chip revision in range z[vdrj - zmax rev not set] vz] z(this chip is revision v)z). Use the force argument to flash anyway.ESP32-C3z' requires chip revision z" or higher (this chip is revision z*). Use the force argument to flash anyway.zThis chip has encrypt functionality in UART download mode disabled. This is the Flash Encryption configuration for Production mode instead of Development mode.rz%Unexpected FLASH_CRYPT_CONFIG value: rz'Flash encryption key is not programmed.c6g|]\}}|t|fSrrrs rarzwrite_flash..s'JJJjdD44)JJJrcz Input imagez (address z ) is not z% byte aligned, can't flash encrypted.zaCan't perform encrypted flash write, consult Flash Encryption documentation for more information.ESP32flash_crypt_cnt1rzWARNING: Detected flash encryption and secure download mode enabled. Flashing plaintext binary may brick your device! Use the force argument to override the warning.zWARNING: Detected flash encryption enabled and download manual encrypt disabled. Flashing plaintext binary may brick your device! Use the force argument to override the warning.)detectrzSet flash_size z, is larger than the available flash size of zFile 'z (length z ) at offset rmz will not fit in zD bytes of flash. Change the flash_size argument or flashing address.zFlash address z is not aligned to a z byte flash sector. z* bytes before this address will be erased.z1Flash will be erased from {:#010x} to {:#010x}...c(g|]\}\}}|||fSrr)rrrnamers rarzwrite_flash..s+XXX1E$ t$dG,XXXrcc>g|]\}}|gt|dRSTrrs rarzwrite_flash..s?   /;dT *IdOO *T * *   rcc|dSNrrxs razwrite_flash..s 1Q4rckey input bytes z4Compress and encrypt options are mutually exclusive.z Will flash z uncompressed.zInput bytes are empty.z ' is empty.r*zErasing flash...z>Security features enabled, so not changing any flash settings.r/)begin_rom_encryptedz Writing at r[rrr)timeoutz Lost connection, retrying...z!Waiting for the chip to reconnectrdrfrerL)rebootr6rr (r.rrz kbit/s)rz bytes (z compressed) at rrz (%.1f kbit/s)rz Input MD5: z Flash MD5: z0Write failed, the written flash region is empty.z)MD5 of file does not match data in flash!zHash of data verified.zCCannot verify written data if encrypted or in secure download mode.)LrIS_STUBr]rwget_secure_boot_enabledrrrerror RuntimeErrorr}rt max_rev_full min_rev_fullmin_revget_chip_revisionget_minor_chip_versionget_major_chip_versionget_encrypted_download_disabledget_flash_crypt_configrr\is_flash_encryption_key_validFLASH_ENCRYPTED_WRITE_ALIGNrbinrvcountget_flash_encryption_enabled_set_flash_parametersrrminr erase_flashFLASH_SECTOR_SIZEnoterrsortedr r rmd5 hexdigestzlibrrrWRITE_FLASH_ATTEMPTS decompressobjflash_defl_begin flash_beginrr rFLASH_WRITE_SIZE decompressmaxrrflash_defl_blockflash_encrypt_block flash_blockrrucloser sleeprrqrun_stubflash_defl_finish flash_finish flash_md5sumr)8rr rrrkwargsnorm_addr_datarrrrrrrrrrr(rmsguse_rev_full_fieldsrev error_strdo_writecrypt_cfg_efuse enc_key_validfiles_to_encryptrset_flash_size flash_end flash_end_str write_end bytes_over all_filesencrypted_files_flag encryptedcalcmd5uncsizeuncimagecompsizeoriginal_imageattemptrZr bytes_sent bytes_writtenrr6 image_sizeblockblock_uncompressed block_timeoutlast_file_encryptedrresrs8 @ra write_flashrsFKJ JJJNjje44IJJy%00G:@**;;MZZ E22H =%88K**We,,E#)::.F#N#N =%88K K; DS]i//8P/  & & ( ( ,   V##$W$ .8 8 OA|d )#->> l;    } 11104 ,,BWdBWBWBW!>> >>> !Q&&&+###u,,&*#&!++ 0B0B*/'&*#" ++--+++sU5G/G/G LD L L LIVU/36VV9Kc9QVVVI)U22!%88 !X 2c 9XXEKOOO   +9UYUNI&&&I%3   !G\dDT"Y..*.,S$>S>S>S    uQc==PQRR{ 1 I( ) ) ) !3#88J z !Gj(50E' 0K0K0M0M .Wj*j%EE KP   +e$$..00e**  "HM(A..E5zzH Q 81 <==R R GQ U"&!3!5!5J(((GDDDDOOGW)OTTT ! IKK))1>XXw %jjAoo&(%/#e**%<(2#Q=1H#Q#Q#Q#Q#Iz#I#IJ#I#I#I  5zzQ!!c&:":;E4.11F1Fu1M1M-N-N*%);; (++* :>I5G55666I1C11222gk'G*;<<FFHHHH(N%%PQQQI67777+     IU    oyys^D33EEG0gA2k8A8j20k2!k kk kkB)r rrcd}|d}|rL|d||d|d|d|ddS|d|ddS)z Read and display the MAC address of the ESP device. Args: esp: Initiated esp object connected to a real device. cxtj|dzddd|DdS)N:z<20c3K|]}|dV dS)02xNr)rr.s ra z.read_mac..print_mac..s&.G.Ga!zz.G.G.G.G.G.Grc)rr\join)labelmacs ra print_maczread_mac..print_macsE US[IIchh.G.G3.G.G.G&G&GIIJJJJJrcEUI64MACzBASE MACBASE_MACMAC_EXTN)read_mac)rreui64s rarrsKKK LL ! !E 3 % *cll:66777 )S\\)4455555 %j1122222rcc |}tjd|ddS#t$r/tj|jdt |YdSwxYw)z Read and display the Chip ID of the ESP device if available, otherwise fall back to displaying the MAC address. Args: esp: Initiated esp object connected to a real device. Chip ID: rmz- has no chip ID. Reading MAC address instead.N)r}rr\rrr]r)rchipids rar}r}s} ,f,,,-----  s}SSSTTT s,05A)(A)spi_connectionc d}|e|}|dkrd}n,|dkrd}n#|||\}}tjd|d|njsjd ksjr*tjd dnj}||\}}|d krtjd |dntjd |fd  fd}js< |n0#t$r#} d|dYd}~nd}~wwxYwjsn } | dvr,tj d|tj ddSdSdS#t$r}td|dd}~wwxYwdS)aS Configure and attach a SPI flash memory chip to the ESP device, verify the connection. All following flash operations will be performed on the attached flash chip. Args: esp: Initiated esp object connected to a real device. spi_connection: Custom SPI connection configuration. This can either be a tuple containing five pin numbers ``(CLK, Q, D, HD, CS)`` for manual configuration or a string (``"SPI"`` or ``"HSPI"``) representing a pre-defined config. If not provided, the default flash connection is used. c p|\}}}}}d|d|d|d|d| }|dz|dzz|dzz|d zz|z}||fS) zAPrepare SPI configuration string and value for flash_spi_attach()zCLK:z, Q:z, D:z, HD:z, CS:r7r0 r,r)rclkqrhdcsspi_config_txtrs ra_define_spi_connz&attach_flash.._define_spi_connss*Q2rEEEEEEEEEEErbBh'173qAv>Du$$rcNSPIrHSPIrzConfiguring SPI flash mode (z)...r#z"Enabling default SPI flash mode...)rrrrrz5Attaching flash from eFuses' SPI pads configuration (ctd\}}}|tkrdS|dz dz}|dz}d}|dkr|dkr|dkrd}n)|dkr|d kr|dkrd}n|d kr|d kr|d krd}|S) NFr.r@r2r#TAr6Pr4r5)r XMC_VENDOR_ID)rrrmfidcpidmatchedrs rais_xmc_chip_strictz(attach_flash..is_xmc_chip_strict s"1#u"="= 9a  % %5Q$&4 4<<t||  T\\t||  T\\t|| rccd}|r rdSd}|d}|tkrdStjddddt jdd t jd stjd tjd dS) NTrr.zIXMC flash chip boot-up failure detected! Running XMC25QHxxC startup flow.yrgMb`?gh㈵>zXMC flash boot-up fix failed.z&XMC flash chip boot-up fix successful!)read_spiflash_sfdprrrrun_spiflash_commandrr`r\) fast_checksfdp_mfid_addrmf_idrrs raflash_xmc_startupz'attach_flash..flash_xmc_startup5s  ,,..  F&&~q99 M ! ! F W      &&&   &&&   &&& 5   &&& 7!!## 9 K7 8 8 8 :;;;;;rcz3Unable to perform XMC flash chip startup sequence ().)iri?zFailed to communicate with the flash chip, read/write operations will fail. Try checking the chip connections or removing any other hardware connected to IOs.zrSome GPIO pins might be used by other peripherals, try using another combination of pins for SPI flash connection.z(Unable to verify flash chip connection () check_spi_connectionrr\flash_spi_attachr;r]rwget_chip_spi_padsrtracerrrP) rrr spi_configr spi_chip_padsrrerrs ` @ra attach_flashrs$%%%!# U " "EE v % %EE  $ $^ 4 4 4!1 0 @ @ J AAAABBB U#### [( =G # #s'? # I: ; ; ;   # # # # 1133M$4$4]$C$C !NE// -&---  >???   ' ' '*<<<<<<4  #S S       S S S IIQAQQQ R R R R R R R R S  #O O||~~H999 ; "-HP:9.-  O O OMMMMNN N O!OOs1- D88 E%E  E%0AF88 GGGctjd|dk}|dkr@t|}|tjdd}nQtjd|n9|dkr3|jrdnt|}|jstjd|Y|t||jr |j d vs't|d krtjd |rdn|S) a Configure the ESP device's flash memory parameters based on the selected flash size. Must be called after attach_flash() and before any flash read/write operations. It supports three modes of operation based on the flash_size argument: - "detect": Automatically detects the flash size (with a fallback to 4MB if detection fails) - "keep": Leaves the flash parameters unchanged in the image header, but configures the SPI flash chip with its detected size (if possible) - Explicit size (e.g., "4MB", "8MB", etc.): Directly uses the specified flash size Args: esp (ESPLoader): Initiated esp object connected to a real device. flash_size (str, optional): The flash size setting to use. Can be "detect", "keep", or an explicit flash size value (default: "keep"). Returns: str | Any: Returns "keep" if flash_size was "keep", or the flash size value used for configuration. In "detect" mode, this is the auto-detected flash size (or "4MB" as a fallback). zConfiguring flash size...rr&Nz4Could not auto-detect flash size, defaulting to 4MB.r'zAuto-detected flash size: z5In case of failure, please set a specific flash size.)zESP32-S3zESP32-P4zESP32-C5izoFlash sizes larger than than 16MB are not fully supported. Change the flash size argument in case of a failure.) rr\rrrwr;rPflash_set_parametersrr])rrrs rarLrLjs40I)***  DX&s++   KN O O OJJ I?:?? @ @ @ @ v  !5QTT;LS;Q;Q { N HL M M M   !1*!=!=>>> !$2V!V!V ,,/??? HG     )66z)rcrc|sI|jdkr>|js7|s|rt dt jt jd|jdkr|jst j dtj }| t jdt jdtj |z dd d S) z Erase the SPI flash memory of the ESP device. Args: esp: Initiated esp object connected to a real device. force: Bypass the security checks for flash encryption and secure boot. rActive security features detected, erasing flash is disabled as a safety measure. Use the force argument to override, please use with caution, otherwise it may brick your device!z/Erasing flash memory (this may take a while)...zWYou can use the erase-region command in ROM bootloader mode to erase a specific region.Trz$Flash memory erased successfully in r seconds.N) r]rwrKr<rrrr\r;rPrrN)rrrs rarNrNs  S]i//8P/  + + - - 1L1L1N1N O  IKKKI?@@@ } !!#+!  /    AOOITISTY[[1_SSSSTTTTTrcc|tjzdkrtdtjd|tjzdkrtdtjd|sI|jdkr>|js7|s|rtdtjtj dtj }|jdkr |j s| ||d n| ||tjd tj d tj |z d ddS)aZ Erase a specific region of the SPI flash memory of the ESP device. Args: esp: Initiated esp object connected to a real device. address: The starting address from which to begin erasing. size: The total number of bytes to erase. force: Bypass the security checks for flash encryption and secure boot. rz+Offset to erase from must be a multiple of rjz,Size of data to erase must be a multiple of rrzHErasing flash memory region (this may take a while depending on size)...F)loggingTrz+Flash memory region erased successfully in rrN)rrOrr]rwrKr<rrr\rr;rX erase_region)rrrrrs rarrs,,11 X):U X X X    i))Q.. .* . . .    S]i//8P/  + + - - 1L1L1N1N O  IKKKIR A } !!#+! gu5555 $'''ITITdikkAoTTTTrcc.|dS)z Execute the firmware loaded on the ESP device. Args: esp: Initiated esp object connected to a real device. N)runrs rarrsGGIIIIIrcct|\}}}tjd|dtjd|dtjd|pddS)z Read and display the SPI flash memory chip ID and related information. Args: esp: Initiated esp object connected to a real device. zManufacturer: rzDevice: 04xzDetected flash size: UnknownN)rrr\)rmanufacturer_idrrs raprint_flash_idrst.=S-A-A*OY I4444555I(((()))I?j&=I??@@@@@rccrd}tj|tjdt|zt||}ddd}||}|rtjd| |dS#t$rYdSwxYw)z Read and display the SPI flash memory chip identification and configuration details, such as the manufacturer ID, device ID, detected flash size, type, and voltage. Args: esp: Initiated esp object connected to a real device. zFlash Memory Information:=zquad (4 data lines)zoctal (8 data lines)rrzFlash type set in eFuse: N)rr\rr flash_typerget_flash_voltager)rtitlerflash_type_dictflash_type_strs rarrs (EIeIcCJJ3!!J/4JKKO$((44N@ >n>>???        sB(( B65B6rcfd|cxkrdksntdt||||dz}tjd|d||zdz dd t |D]$}tj|d zd d d |dz }%tjd S)a Read and display the Serial Flash Discoverable Parameters (SFDP) from the flash memory. Args: esp: Initiated esp object connected to a real device. address: Starting address in the SFDP region to read from. bytes: Number of bytes to read (1-4). rr*z0Invalid number of bytes to read from SFDP (1-4).r.zFlash memory SFDP[z..z]: rdr7r#04xr[N)rrrrr\r)rrrsfdprs raread_flash_sfdprs OOOO!OOOOKLLL3  ! !'519 5 5DIF7FFgo.AFFFBOOOO 5\\ TD[((((b1111qyIKKKKKrcrc ft|||rd}nd}tjtj}||||}tj|z }|dkr+dt ||z dzdz nd} |rd|d nd} tjd tjd t |d |dd|dd| | d |r?t|d5} | |dddn #1swxYwYdS|S)a~ Read a specified region of SPI flash memory of an ESP device and optionally save it to a file. Args: esp: Initiated esp object connected to a real device. address: The starting address in flash memory to read from. size: The number of bytes to read. output: The name of the file to save the read data. If None, the function returns the data. flash_size: Flash size setting, needs to be set only when the stub flasher is disabled. Options: ``"detect"``: auto-detect flash size with fallback to 4MB, ``"keep"``: auto-detect but skip setting parameters in SDM, Explicit size: use the specified flash size. no_progress: Disable printing progress. Returns: The read flash data as bytes if output is None; otherwise, returns None after writing to file. Nc Ttj||d||zddd|d|ddS)Nz Reading from rmr[rrr)rr)progresslengthoffsets raflash_progressz"read_flash..flash_progressQsX  !"Av'8AAAA7877f777       rcrrr.rrdrrTrzRead rrmrrrrjr) rLrrr read_flashrrr\rr) rrrrrrrrrrrrs rarr/s:#z***    IKKK A >>'4 8 8D aAGH3ww"))#d))a-!*;d*BCCCTVI$*2 v    HITI "D  " "wI " "!I " "  " " " " &$   1 GGDMMM               t sD$$D(+D(diffc pt||}d}|D]\}}t|\}} t|dt|||||t } | dnd| d} t jd| dd| d |d d | d ||| } tj  } | | krt jd d}|st jd| || ksJfdt| D} t jdt | d|| dzd d| D]5}|}|}t jd||zd d|dd|d6|rtddS)a Verify the contents of the SPI flash memory against the provided binary files or byte data. Args: esp: Initiated esp object connected to a real device. addr_data: List of (address, data) tuples specifying what parts of flash memory to verify. The data can be a file path (str), bytes, or a file-like object. flash_freq: Flash frequency setting (``"keep"`` to retain current). flash_mode: Flash mode setting (``"keep"`` to retain current). flash_size: Flash size setting (``"keep"`` to retain current). diff: If True, perform a byte-by-byte comparison on failure. Fr*Nr2rz Verifying rr:z ) bytes at rmz in flash against rz)Verification successful (digest matched).Tz&Verification failed (digest mismatch).c8g|]}||k|Srr)rrflashrs rarz verify_flash..s+LLLQuQx587K7Kq7K7K7KrczVerification failed: z differences, first at rrz r[rzVerification failed.)rLrr r rrr\rdrrRrSrrr)rr rrrrmismatchrrrrrexpected_digest differencesr flash_byte image_byterrs @@ra verify_flashrlsg,'sJ77JH"$S$S   ftQ* *j*e  ZZ "(.m&mmm  ? > ? ?* ? ? > ? ?39 ? ? ?   !!':66!+e,,6688 _ $ $ IA B B B H  BCCCw 33~~~~LLLLL% "3"3LLL   :C $4$4 : :+a.0 9 : : :    S SAqJqJ IQGaKQQQ QQQQQQ R R R R S1/00011rcc\tjd||ddS)z Read and print the status register value of the SPI flash memory. Args: esp: Initiated esp object connected to a real device. bytes: Number of bytes to read. zFlash memory status: rN)rr\ read_status)rrs raread_flash_statusrs2ICcooe&<&<CCCDDDDDrc non_volatilecJd|dzd}|d|dzzdz z}tjd|||ztjd||z||||tjd|||zd S) af Write a new value to the SPI flash memory status register and verify the update. Args: esp: Initiated esp object connected to a real device. value: The new status register value to write. bytes: Number of bytes to write. non_volatile: If True, allows non-volatile status register bits to be written. z0x%0rKr.rr.zInitial flash memory status: zSetting flash memory status: zAfter flash memory status: N)rr\r write_status)rrrrfmts rawrite_flash_statusrs    C aEAI&!+ ,EILcCOOE4J4J.JLLMMMI;cEk;;<<<UE<000ILcCOOE4J4J.JLLMMMMMrcc }|d}d}tj|tjdt|ztjd|dt |djrhtjd|ddfd t|dD}tjd ||d b|d Ztjd|d tjd|d |drtjd|drtjdg}tgdD]"\}}||r| |#t|dkr1tjd|D]}tjd|dntjdt |d}| ddzdkrtjdntjdd} j d krd!} tj| d"|dd#|d$rtjd%|d&rtjd'|d(} |d)} | rtjd*n| rtjd+|d,rtjd-d Sd S).z Read and display security-related information about the ESP device. Args: esp: Initiated esp object connected to a real device. rhzSecurity Information:rzFlags: {:#010x} ({})flagszKey Purposes: key_purposesz c ng|]1\}}|jkd|dj|d2S) BLOCK_KEYrUNKNOWN) EFUSE_MAX_KEY KEY_PURPOSESr)rkey_numpurposers rarz%get_security_info..sY   $GWc///SGRR(8(<(>>$%+ ())) 7 8 H IF G G G       ' 'FAsC  '##A&&& |  q I< = = =! @ @ >a>>>???? )***"./00Oc""Q&1,, -.... .///B }@I!??R(9%:???@@@)*< :;;;)*< :;;; 1M 1M4 .//// 4 2333I* ()))))**rc hard-reset reset_modec|dkr|d S|dkr+tjd|dd S|dkrtjdd S|dkrG|jr*tjd|d S|d S|d kr4tjd |jr|d d Sd Std |)a Reset the ESP device. Args: esp: Initiated esp object connected to a real device. reset_mode: Reset mode to use ( ``"hard-reset"``: perform a hard reset using the RTS control line, ``"soft-reset"``: perform a soft reset, ``"no-reset"``: stay in bootloader, ``"no-reset-stub"``: stay in flasher stub, ``"watchdog-reset"``: perform a hard reset utilizing a software watchdog. ) rz soft-resetzSoft resetting...Fz no-reset-stubzStaying in flasher stub.zwatchdog-resetzdWatchdog hard reset is not supported in Secure Download Mode, attempting classic hard reset instead.zno-resetzStaying in bootloader.TzInvalid reset mode: N) hard_resetrr\ soft_resetrwrwatchdog_resetr;r)rrs ra reset_chiprs<\!!  | # # %&&& u  & & ,----- ' ' '  # ! K9    NN         z ! ! *+++ ; ! NN4  ! !< <<===rcc |jrtjdn|jdkr)|rtjdn|js|jrtjdn|jdvrtjd|jdns |S#t$rQtj dkr?| d kr'tj tj d wxYw|S) a Load and execute the stub loader on the ESP device. If stub loading is not supported or is explicitly disabled, warnings are logged. Args: esp: Initiated esp object connected to a real device. Returns: The esp instance, either as a stub child class in a state where the stub has been executed, or in its original state if the stub loader is disabled or unsupported. ztStub flasher is not supported in Secure Download Mode, it has been disabled. Set --no-stub to suppress this warning.r!zyStub flasher is not supported on ESP32-C3 with Secure Boot, it has been disabled. Set --no-stub to suppress this warning.zYStub flasher has been disabled for compatibility, set --no-stub to suppress this warning.)z ESP32-H21zESP32-H4z%Stub flasher is not yet supported on z?, it has been disabled. Set --no-stub to suppress this warning.darwiniUzEIf issues persist, try installing the WCH USB-to-Serial MacOS driver.)rwrrr]r<r;stub_is_disabledrarsysplatform_get_pidr\rPrs rararaFsl "  L     * $ $)D)D)F)F $  L    [S1  6         LCM L L L    <<>> !   |x''CLLNNf,D,D I   Js B00AD c|dd}d}tj||\}}}}}}} } } } } }}}|dkrdS|||t|t|t|t| t| t| d| dzd| dz| dzd| dz|d kr d |zd zd nd||d S)z^ Check if correct magic word is present in the app_info and parse the app_info struct Nz0B0Bq-4' , , , ,)  rcc|dd}d}tj||\}}}}}}|dkrdS|||t|t||dS)zp Check if correct magic byte is present in the bootloader_info and parse the bootloader_info struct Nrzrfilerr offset_strline detected_chiprs ra image_inforKsz%%/ TUUU '' 3 3GAtQ((GD!)-a)<T!W)JA1q5AA3u::AA%AA/24yyAAA  IKKK IcCIIo & & & IdOOO IcCIIo & & &  8t D D     L1q5LL3u::LLLLMMM WXXX  Q4< I-2E2E2G2GIIJJJ$ mT 2 2 2 23 3 38E""a0t<<  2T222333 < IEm.A.A.C.CEE F F F-.....sD$$ E:.AE55E:rc`tj|}|d}||d}|d |d}n#t$rt dwxYw|t jtj fvrt d|dd| |d d vrt d t |d d d}tD]}||j kr |j}nt d|dn#t $rd}YnwxYw|S)z5Parse the image info header and return the chip type.r.NrrzImage is empty.z1This is not a valid image (invalid magic number: rrr8rzAppend digest field not 0 or 1.r*r+littlezUnknown image chip ID (r)rrreadseek IndexErrorrrrr IMAGE_V2_MAGICint from_bytesrrtr])rr>stream common_headerextended_headerrr}roms rarDrDs Z  FKKNNM | ++b// KKNNN,a  ,,,*+++, !- L L L L L    | r"&00 !BCCCnn_QqS%98DDG H Hc///=DE0!!F7!F!F!FGGG   DDD  KsA A:.A-D D+*D+c t||tj|d}tj|tjdt |ztjdjtjjdkr djdndtjdt jjd z}tj j |}|tjd |ntj d |d d jdz}tj j |}|tjd|ntj d|d d ttj}|*tjd|ntj djd |dkrtj|d}tj|tjdt |ztjdjd gjjkrdgngRtjdjjjjjj t3fdt5jD}tjdjd|jd n-#t<$r tjdjdYnwxYwtjdjdzdjdzdj d tjd j!dzdj!dztjd!}tj|tjdt |zd"} tj| d#d$d%d&d'tjd(d)d(d)d*d)d*d)d+ d,} d} d} tEjD]\} }|#}d-$|}d.|vr | |j%} n#d/|vrt |j%d0kr|j%} tj| | t |j%|j&|j'|tj|d1}tj|tjdt |z(}tjd2j)j)|krd3nd4|d5 d6}j*rUj+j,k}d7t[j,d89|rd3nd:}tjd;|n#t\$rYnwxYw| ryt_| }|retjd<}tj|tjdt |ztjd=|d>tjd?|d@tjdA|dBdC|dDtjdE|dFtjdG|dHtjdI|dJtjdK|dL|dMrtjdN|dMtjdO|dPdSdS| rta| }|rtjdQ}tj|tjdt |ztjdR|d@tjdG|dHtjdA|dSdSdSdS)TNz Image HeaderrzImage version: rz Entry point: z#8xzEntry point not setz Segments: rz Flash size: zInvalid flash size (z#02xr rz Flash freq: zInvalid flash frequency (z Flash mode: zInvalid flash mode (rz Extended Image HeaderzWP pin: z (disabled)zFlash pins drive settings: clk_drv: {:#02x}, q_drv: {:#02x}, d_drv: {:#02x}, cs0_drv: {:#02x}, hd_drv: {:#02x}, wp_drv: {:#02x}c3PK|] }t|ddjk|V!dS)rtN)getattrr})rr>rs rarz$_print_image_info..lsH4$775=HHHHHHrcrr:z (Unknown ID)zMinimal chip revision: vrrjz, (legacy min_rev = zMaximal chip revision: vzSegments Informationz#{:>7} {:>7} {:>10} {:>10} {:10}SegmentLengthz Load addrz File offsz Memory typesz-------rz ----------z ------------z%{:7} {:#07x} {:#010x} {:#010x} {}, DROMDRAMrz Image FooterzChecksum: {:#04x} ({})validzinvalid - calculated rz Not appendedz{} ({})Fr#invalidzValidation hash: zApplication InformationzProject name: r*z App version: r)zCompile time: r+r[rzELF file SHA256: r-z ESP-IDF: r,zMinimal eFuse block revision: r.zMaximal eFuse block revision: r/r0zMMU page size: zSecure version: r'zBootloader InformationzBootloader version: r9)1rrr\rErr)rrflash_size_freqr ROM_LOADER FLASH_SIZESrFLASH_FREQUENCYrrwp_pinWP_PIN_DISABLEDrclk_drvq_drvd_drvcs_drvhd_drvwp_drvnextrvaluesr}r] StopIterationr@rAr?rget_memory_typerrr file_offscalculate_checksumchecksum append_digest stored_digest calc_digestrAttributeErrorr6r=)r>rr flash_s_bitsflash_s flash_fr_bitsflash_frr chip_class headers_str format_str app_desc_segbootloader_desc_segidxrsegsseg_name calc_checksum digest_msgis_validapp_descbootloader_descrs @rarFrF.s dD ) )EIKKKzz|| * * *EIeIcCJJI/ //000I  q  /(.... " I03u~..00111(4/L !1!=|LLG ***++++ ?<????@@@)D0M!%"2"BMRRH +++,,,, E EEEEFFF$K1ABBJ 5!1!1!3!3556666 >5+;>>>??? y ::<<777 % #E "### *u| * * * $|u/DDDl^^"      AAG      BB  @%,..J IJ%-JJ:3GJJJ K K K K @ @ @ I>%->>> ? ? ? ? ? @  2"c) 2 2,1,>,D 2 2!& 2 2 2    G"c) G G,1,>,D G G   IKKK #EIeIcCJJ7KI xk>   IIIGIIxII8IIxIIJJJ8JLen--   S""5))99T?? T>>l28LL t^^38}}""&)h#   c3sx==#(CM8 T T    IKKKzz|| * * *EIeIcCJJ,,..MI '' N>]22A]AAA        #   8*e.??H"))u(E:::#2J I6*66 7 7 7      G"<00  G IKKK-E Ie    IcCJJ& ' ' ' IAx'?AA B B B I;hy&9;; < < < ILx'7LL(6:JLL M M M IF(3C*DFF G G G I7(9"577 8 8 8 IU:R1SUU    IU:R1SUU   ( I GH_,EGGHHH IE2B)CEE F F F F F% G G(  G01DEE  G IKKK,E Ie    IcCJJ& ' ' ' II_Y-GII J J J I>/)"<>> ? ? ? IE{'CEE F F F F F G G G Gs&AL(('MMAX$$ X10X1rawrc |dd|dd}|dd} |dd} |dvrtd |d |)|d vr%td |d  t|} n<#t$r/td|ddt dwxYwt|d}|std|dd} | krtddd| dd||dkrt| j || | 5} |D]g\}}t|\}}|dnd|d}tj d|d|ddt| |||||}| ||h dddn #1swxYwYtj d tj|dd!|d"nG|d#krJ|t%jnt)|d$ fd%}|D]K\}}||t|\}}t| |||||}|L|r|t-|}|n#|wwxYw|Kt3t$jr1tj d&|dd'dd(Stj d |dd!|d)dd(dS||d*krt7}t9|d+krtjd,|D]d\}}t7}t|\}}t| |||||}|||||e| |tj d tj|dd!|d)dd(dS)-a Merge multiple binary files into a single output file for flashing to an ESP device. Take multiple binary files along with their flash addresses and merge them into a unified binary in either raw, UF2, or Intel HEX format. Also apply necessary flash parameters and ensure correct alignment for flashing. Args: addr_data: List of (address, data) tuples specifying where to write each file or data in flash memory. The data can be a file path (str), bytes, or a file-like object. chip: Target ESP device type (e.g., ``"esp32"``). output: Path to the output file where the merged binary will be written. If None, the merged binary will be returned as bytes. flash_freq: Flash frequency to set in the image header (``"keep"`` to retain current). flash_mode: Flash mode to set in the image header (``"keep"`` to retain current). flash_size: Flash size to set in the image header (``"keep"`` to retain current). format: Output format (``"raw"``, ``"uf2"``, or ``"hex"``). Keyword Args: target_offset (int): Starting offset for the merged output. pad_to_size (str | None): If specified, pad the output to a specific flash size. chunk_size (int | None): Chunk size for UF2 format. md5_disable (bool): If True, disable MD5 checks in UF2 format. Returns: The merged binary data as bytes if output is None; otherwise, returns None after writing to file. target_offsetr pad_to_sizeN chunk_size md5_disableF)ruf2rCzInvalid format: 'z#', choose from 'raw', 'uf2', 'hex'.)rrCz#Output file must be specified with z format.Invalid chip choice: '' (choose from r]rc|dSr,rr-s rar/zmerge_bin..s !rcr0zNo input data.zOutput data target offset is rz. Input data offset z is before this.r) md5_enabledrrzAdding z at rrz bytes to file 'z/', ready to be flashed with any ESP USB Bridge.rrchd|z z zdS)Nr4)rr) flash_offsofrs rar zmerge_bin..pad_to=s2J$>$JKLLLLLrcMerged z! bytes, ready to flash to offset rjz', ready to flash to offset rCraOnly one input file specified, output may include additional padding if input file was previously merged. Please refer to the documentation for more information: https://docs.espressif.com/projects/esptool/en/latest/esptool/basic-commands.html#hex-output-format)!rrrErKeyErrorrrrQr UF2_FAMILY_IDrrr\r add_fileospathgetsizerrrrrrr_rArrrr frombytesmergewrite_hex_file)r r>rrrrrrerrrr} first_addrwriterrrrrr rroutihexrrs @@ra merge_binrsX OQ77M$jj==K#ZZ d;;J =%88K *** K K K K   ~&N22Wv||~~WWWXXX t_     RT R R$))I:N:N R R R    ynn555I +)***1aJM!! AM @ A A!+ @ A A A   foo   $  '    - ' - - d )$ v$*N F  jRZ88> IW$WWWMWWWW   ;;== I@=@@&@@,9?@@@   4  %jj y>>Q   Kv    $  JD$::D HE1.D*j*eE NN5$ ' ' ' IIdOOOO 6"""  . s%VVV9ISX9U9U9U9U9Urcz_Image has only RAM segments visible. ROM segments are hidden and SHA256 digest is not appended.rz ELF sectionsrdzSuccessfully created z image.auto_image)5rrrrrrrr\rErrrrAr@r?rrur r r rrrset_mmu_page_sizersectionsr( is_flash_addrrMMU_PAGE_SIZE_CONFr6rreversed IROM_ALIGNrrrrcrrbrr elf_sha256r sort_segmentsrmerge_adjacent_segmentsrdefault_output_namerrtuplesave)rr>rrrrrer)rAr@r?rrrrurrrrrrrbootloader_imager appdesc_segrrr0 appdesc_segsbeforedeltas ra elf2imagerts\::i++G::i++G >155L >599Lzz,66J **_e<f$$U^,,, JEJJeaiissRJJJKKK LLNNNI;djjll;;;<<< $*ND**622 edlE122T95::f;M;M N NNrcc:ddlm}tj|dS)z, Print the current esptool version. r __version__N)rdrrr\rs rar)r)# s,Ikrc)r)Nr*r)r)F)r)NrF)rrrF)rK)rKF)r)Nrrrr)NNrMr%)rVN)^rrrrrrrTrintelhexrserialrtypingr bin_imagerrr r r loaderr r rrrloggerrtargetsrrr uf2_writerrutilrrrrrrrrrrr r!rrrrr DEFAULT_PORT ESP_ROM_BAUDstrrRboolrrrrrrrrrr rBrrr}rrLrNrrrrrrrrrrvrrar6r=rKrDrFrrr)rrcrars   """"""11111111 3333333333!!!!!!                            '' % %   %   %  & & & ' ' & ' ' '  '!" %#$      /6  &&'4 hh h hh h  h  hhhh^%%)%%K%%D%%%%%%%%PB)BcBdBBBB Q Q9 Qs Q3 Qc QSW Q Q Q QCG22 2 2(+2584Z2 T\2222j,,,4,5c3QU:AU;V,,,,89t&pppl TT TE#{*+,TT T  T TTTTn3)33333(  t    $EI@O@O @O3S#s23c9TA@O @O@O@O@OF7*7*7*7*tUUYUtUUUUU:((i(#(S((RV((((VY4 A Ad A A A A )     .ST2 :: : : : $J :  :  : T\::::@ ?1?1 ?1E#{*+,?1?1 ?1  ?1  ?1 ?1?1?1?1DEE9ESEEEEEFKNN NN'*N>BN NNNN*M*9M*M*M*M*M*`%>%>I%>3%>$%>%>%>%>P0)0 0000n111h@LP3/3/ eC$456 63/>ADj3/ 3/3/3/3/l%%5%d %c%%%%PhGChGuhGhGhGhGhG\XXE#{*+,X X $JX X  X  X X T\XXXX|! lOlO lO lO $JlOd lO  lO  lO U54<& ''$.lOlOlOlO^rc