#)divdZdZddlmZddlmZmZddlmZddlZddl Z ddl m Z m Z m Z mZmZmZmZmZmZmZmZddlmZGd d eZeZGd d eZGd deZdBdZdCdZdDdZGddeZ Gdde!Z"dEdZ#Gdde!Z$Gdde$Z%Gdde$Z&Gd d!e&Z'Gd"d#e&Z(Gd$d%e(Z)Gd&d'e(Z*Gd(d)e(Z+Gd*d+e(Z,Gd,d-e(Z-Gd.d/e-Z.Gd0d1e-Z/Gd2d3e(Z0Gd4d5e0Z1Gd6d7e0Z2Gd8d9e0Z3Gd:d;e0Z4Gd<d=e$Z5Gd>d?e5Z6Gd@dAe$Z7dS)Fz&Intel HEX format manipulation library.javadoc)array)hexlify unhexlify) bisect_rightN) IntTypesStrTypeStringIO array_tobytesasbytesasstr dict_items_g dict_keys dict_keys_grange_grange_l) total_sizeceZdZdS)_DeprecatedParamN)__name__ __module__ __qualname__X/var/www/menimich/repos/protonApp/venv/lib/python3.11/site-packages/intelhex/__init__.pyrr=sDrrc&eZdZdZd+dZd,dZdZd,dZdZeZ d Z d,d Z d-d Z dde dfd Zd Zdde dfdZdZdde dfdZdZdZdZdZdZdZdZdZdZeeZd.dZd/dZdZd Z d!Z!d"Z"d0d#Z#d1d%Z$d2d'Z%d3d)Z&d*Z'dS)4IntelHexz Intel HEX file reader. Ncd|_d|_i|_d|_|t |t st |ddr||dSt |tr| |dSt |trQ|j|_|jr|j |_|j |_dStddS)aH Constructor. If source specified, object will be initialized with the contents of source. Otherwise the object will be empty. @param source source for initialization (file name of HEX file, file object, addr dict or other IntelHex object) Nrreadzsource: bad initializer type) padding start_addr_buf_offset isinstancer getattrloadhexdictfromdictrcopy ValueErrorselfsources r__init__zIntelHex.__init__Fs    &'** Agffd.K.K A V$$$$$FD)) A f%%%%%FH-- A%~ $?&,&7&<&<&>&>DO"K,,..  !?@@@  rrc @|d}|sdS|ddkr tdtt|dd}n%#tt f$rt |wxYwt|}|dkrt |nt ||d}|d|zkrt||dd z|d z}|d }d|cxkrdksnt|t|}|d z}|dkrt||dkrc||j z }td d |zD]C} |j|dt!|||| |j|<|dz }DdS|dkr|dkrt#|t$|d kr:|d ks|dkrt'||d d z|dzdz|_ dS|d kr:|d ks|dkrt)||d d z|dzdz|_ dS|d krc|d ks|dkrt+||jrt/||d d z|dz|dd z|dzd|_dS|dkrh|d ks|dkrt1||jrt/|d|d dz|ddzz|dd zz|dzi|_dSdS)zDecode one record of HEX file. @param s line with HEX record. @param line line number (for error messages). @raise EndOfFile if EOF record encountered.  Nr:B)liner)addressr5)CSIPEIPi)rstriprrr TypeErrorr+HexRecordErrorlenRecordLengthErrorRecordTypeErrorsumRecordChecksumErrorr$rr#getAddressOverlapErrorEOFRecordError _EndOfFile!ExtendedSegmentAddressRecordError ExtendedLinearAddressRecordErrorStartSegmentAddressRecordErrorr" DuplicateStartAddressRecordErrorStartLinearAddressRecordError) r-sr5binlength record_lengthaddr record_typecrcis r_decode_recordzIntelHex._decode_recordes HHV    F Q43;; 0C71QRR5>>!:!:;;z* 0 0 0$$//// 0XXFzz$$////!d+++ +A a-' ( (#... .1vczCF"!f [%%%%A%%%%!t,,, ,#hh u  !88%4000 0 !   DL DQ-00  y}}T4008-dFFFF"%a& $    A  !!$$////  A  !!TQYY7TBBBBF3JQ/25DLLL A  !!TQYY6DAAAAF3JQ/58DLLL A  !!TQYY4$???? B6DAAAA%(VCZ#a&%8%(VCZ#a&%8  DOOOA  !!TQYY3>>>> B6DAAAA$s1vh'*1ve|(4'*1vcz(2(+1v(. DOOO  s 2A"A<ct|ddt|d}|j}nd}d|_d} |j} |D]}|dz }|||n#t $rYnwxYw|r |dSdS#|r |wwxYw)zLoad hex file into internal buffer. This is not necessary if object was initialized with source set. This will overwrite addresses if object was already initialized. @param fobj file name or file-like object r Nrrr4)r&opencloser$r\rN)r-fobjfcloser5decoderTs rr'zIntelHex.loadhexs 4 & & .c??DZFFF  (F $$AAIDF1dOOOO$       v  s.A5AA5 A"A5!A""A55Bc $t|dd}|t|d}|j}|j}nd} |t dt |||r |dSdS#|r |wwxYw)a%Load bin file into internal buffer. Not needed if source set in constructor. This will overwrite addresses without warning if object was already initialized. @param fobj file name or file-like object @param offset starting address offset r Nrbr3)offset)r&r_r r` frombytesrr )r-rarffreadfrbs rloadbinzIntelHex.loadbinsfd++ =T4  AFEWFFF  NN5geegg&6&677N G G G   v  s :BBc|dkr||dS|dkr||dStd|z)zLoad data file into internal buffer. Preferred wrapper over loadbin or loadhex. @param fobj file name or file-like object @param format file format ("hex" or "bin") hexrU6format should be either "hex" or "bin"; got %r insteadN)r'rjr+)r-raformats rloadfilezIntelHex.loadfilese U?? LL      u__ LL     "$*+,, ,rc&|}|d}||d=t|D]-}t|tvs|dkrt d.|j|| ||_dSdS)a"Load data from dictionary. Dictionary should contain int keys representing addresses. Values should be the data to be stored in those addresses in unsigned char form (i.e. not strings). The dictionary may contain the key, ``start_addr`` to indicate the starting address of the data as described in README. The contents of the dict will be merged with this object and will overwrite any conflicts. This function is not necessary if the object was initialized with source specified. r"Nrz+Source dictionary should have only int keys) r*rKrtyperr+r#updater")r-diktrTr"ks rr)zIntelHex.fromdicts IIKKUU<((  !,Q P PAAwwh&&!a%% !NOOO+0   !(DOOO " !rc.|D]}||j|<|dz }dS)z{Load data from array or list of bytes. Similar to loadbin() method but works directly with iterable bytes. r4N)r#)r-bytesrfbs rrgzIntelHex.frombytess4  A !DIf  aKFF  rcl||fdkr|jikrt|_d||fvrtd||fdkr|}| ||zdz }nY||z dz}|dkrtd||fzn6||}||}||kr||}}||fS)zReturn default values for start and end if they are None. If this IntelHex object is empty then it's error to invoke this method with both start and end as None. NNNzGtobinarray: you can't use start,end and size arguments in the same timer4rz8tobinarray: invalid size (%d) for given end address (%d))r#EmptyIntelHexErrorr+minaddrmaxaddr)r-startendsizes r_get_start_endzIntelHex._get_start_end!s  #;+ % %$)r//$ $  E3<'' "?@@@s||++  dlQ&d Q199$&BEI#J&OPPP} {llnns{{ %sczrct|ts@td|tdn!tdtdnd}|||||S)aS Convert this object to binary form as array. If start and end unspecified, they will be inferred from the data. @param start start address of output bytes. @param end end address of output bytes (inclusive). @param pad [DEPRECATED PARAMETER, please use self.padding instead] fill empty spaces with this value (if pad is None then this method uses self.padding). @param size size of the block, used with start or end parameter. @return array of unsigned char data. z3IntelHex.tobinarray: 'pad' parameter is deprecated.N/Please, use IntelHex.padding attribute instead.!Please, don't pass it explicitly.zAUse syntax like this: ih.tobinarray(start=xxx, end=yyy, size=zzz))r%rprint_tobinarray_reallyr-r}r~padrs r tobinarrayzIntelHex.tobinarray>s}#/00  H I I IHIIII:;;;Z[[[[C&&uc3===rcF||j}td}|jikrd||fvr|S||dkrtd||||\}}t ||dzD]0}||j||1|S)zReturn binary array.Nr3r tobinarray: wrong value for sizer4)r!rr#r+rrappendrK)r-r}r~rrrUr[s rrzIntelHex._tobinarray_reallyTs ;,CCjj 9??ts|33J   ?@@ @((T:: sA&& . .A JJty}}Q,, - - - - rct|ts@td|tdn!tdtdnd}|||||S)a Convert to binary form and return as binary string. @param start start address of output bytes. @param end end address of output bytes (inclusive). @param pad [DEPRECATED PARAMETER, please use self.padding instead] fill empty spaces with this value (if pad is None then this method uses self.padding). @param size size of the block, used with start or end parameter. @return bytes string of binary data. z1IntelHex.tobinstr: 'pad' parameter is deprecated.Nrrz?Use syntax like this: ih.tobinstr(start=xxx, end=yyy, size=zzz))r%rr_tobinstr_reallyrs rtobinstrzIntelHex.tobinstrbs}#/00  F G G GHIIII:;;;XYYYYC$$UCd;;;rcLt|||||SN)r rrs rrzIntelHex._tobinstr_reallyws$T44UCdKKLLLrct|ts@td|tdn!tdtdnd}t|ddt |d}d}nd }|||||||r|dSdS) aConvert to binary and write to file. @param fobj file name or file object for writing output bytes. @param start start address of output bytes. @param end end address of output bytes (inclusive). @param pad [DEPRECATED PARAMETER, please use self.padding instead] fill empty spaces with this value (if pad is None then this method uses self.padding). @param size size of the block, used with start or end parameter. z2IntelHex.tobinfile: 'pad' parameter is deprecated.Nrrz@Use syntax like this: ih.tobinfile(start=xxx, end=yyy, size=zzz)writewbTF)r%rrr&r_rrr`)r-rar}r~rrclose_fds r tobinfilezIntelHex.tobinfilezs#/00  G H H HHIIII:;;;YZZZZC 4$ ' ' /d##DHHH 4((S$??@@@   JJLLLLL  rc`i}||j|jr |j|d<|S)zwConvert to python dictionary. @return dict suitable for initializing another IntelHex object. r")rrr#r")r-r^s rtodictzIntelHex.todicts7   ? ."oAlOrcVt|j}||S)z~Returns all used addresses in sorted order. @return list of occupied data addresses in sorted order. )rr#sortr-aas r addresseszIntelHex.addressess%ty ! !   rcXt|j}|gkrdSt|S)zgGet minimal address of HEX content. @return minimal address or None if no data Nrr#minrs rr{zIntelHex.minaddr,ty ! ! 884r77NrcXt|j}|gkrdSt|S)zgGet maximal address of HEX content. @return maximal address or None if no data Nrr#maxrs rr|zIntelHex.maxaddrrrct|}|tvr5|dkrtd|j||jS|t krt|j}t}|rs| |j p|d}|j p |ddz}|j pd}t|||D]#}|j|} | | ||<$|Std|z)z Get requested byte from address. @param addr address of byte. @return byte if address exists in HEX file, or self.padding if no data found. rAddress should be >= 0.r4N Address has unsupported type: %s)rqrrDr#rKr!slicerrrr}stopstepr) r-rXtrihr}rrr[xs r __getitem__zIntelHex.__getitem__s JJ ==axx 9:::9==t|44 4 %ZZ!$),,IB "    2ily5Yr]1_y~A d33""A a((A} !1I>BCC Crct|}|tvr!|dkrtd||j|<dS|tkr t |t tfstd|j }|j }|j pd}d||fvrAt|||}t|t|krtdn@||fdkrtd||t|z }n||t|z}|dkrtd |dkrtd d}t|||D]} |||j| <|dz }dStd |z) zSet byte at address.rrz)Slice operation expects sequence of bytesr4Nz5Length of bytes sequence does not match address rangeryzUnsupported address rangez start address cannot be negativezstop address cannot be negativer)rqrrDr#rr%listtupler+r}rrrrFr) r-rXbyterr}rrrajr[s r __setitem__zIntelHex.__setitem__s JJ ==axx 9:::"DIdOOO %ZZdT5M22 N !LMMMJE9D9>DE4=((UD$//r77c$ii''$&()))(,.. ;<<<s4yy(s4yy(qyy BCCCaxx ABBBAUD$//  #Aw ! Q  >BCC Crct|}|tvr|dkrtd|j|=dS|tkrt |j}|rv||jp|d}|jp |ddz}|j pd}t|||D](}|j |}||j|='dSdStd|z)zDelete byte at address.rrrr4Nr) rqrrDr#rrrr}rrrrK) r-rXrrr}rrr[rs r __delitem__zIntelHex.__delitem__s JJ ==axx 9::: $ %ZZ!$),,I )    2ily5Yr]1_y~A d33))A a((A} IaL ) ) )) >BCC CrcDtt|jS)z'Return count of bytes with real values.)rFrr#)r-s r__len__zIntelHex.__len__s9TY''(((rcp|dkrdS|dkr |dkrdSdStdt|z)Nnative CRLFwin32r1zwrong eolstyle %s)r+repr)eolstyleplatforms r_get_eol_textfilezIntelHex._get_eol_textfilesL x  4   7""vt04>>ABB BrTrr<c T |dks|dkrtd|zt|dd}|r|}d}nt|d}|j}|j}t |tj}tj ddkr/ttd  } n,d d td D} |jr|rt!|j} | t%d t'd } | ddgkrd| d<d| d<d| d<d| d<|jd} | dz dz| d<| dz| d<|jd} | dz dz| d<| dz| d<t)|  dz| d<|dt+t-t/| | z|zn| dgkrd| d<d| d<d| d<d| d<|jd}|dz dz| d<|dz dz| d<|dz dz| d<|dz| d<t)|  dz| d<|dt+t-t/| | z|zn!|r |t3|jt!|j}|t7|}|r|d}|d}|dkrd}nd}d}|}d}||kr]|rt%d t'd} d| d<d| d<d| d<d| d<t9|dz }t;|d }|d| d<|d| d<t)|  dz| d<|dt+t-t/| | z|z |dz}t=|dz d|z ||z }||z}|r,t?|||t=||zdz|}||z }nd}t%d t'd d|zz} t;|d }|d| d<|d| d<d| d< t|D]}|j||z| d|z<n#t@$r|}| dd|z} YnwxYw|| d<t)|  dz| d|z<|dt+t-t/| | z|z||z }||kr ||}n|dz}nt9|dz }||krn||k]|d!|z|r |dSdS)"aWrite data to file f in HEX format. @param f filename or file-like object for writing @param write_start_addr enable or disable writing start address record to file (enabled by default). If there is no start address in obj, nothing will be written regardless of this setting. @param eolstyle can be used to force CRLF line-endings for output file on different platforms. Supported eol styles: 'native', 'CRLF'. @param byte_count number of bytes in the data field rr4zwrong byte_count value: %srNwrr9r7c3XK|]%}t|V&dSr)chrupper.0r[s r z*IntelHex.write_hex_file..Fs0AAqCFFLLNNAAAAAArr3z r@rAr:r8r6r>r?r2rBr<)r"rTFz :00000001FF)!r+r&r_rr`rrsysr version_inforvrrjoinrr"rrrr rIr rr translateInvalidStartAddressValueErrorr#rFintdivmodrrKeyError)r-riwrite_start_addrr byte_countfwriterarbeoltablekeysrUcsipeipraddr_lenr{r|need_offset_recordhigh_ofscur_addrcur_ixrwlow_addr chain_len stop_addrixr[ high_addrs rwrite_hex_filezIntelHex.write_hex_file#s   zA~~9JFGG GGT**  DFF3<> L lGmG%)""%*"HHFg%%%  WV__55CCFCFCFCF"8R<00Hx--AqTCFqTCF"3xxi50CFF3 s););!q.@(*K*KMM%'K %& WT1Y;-?%@%@AACx--AqTCFqTCFCF(!(!3!3==A'+y!'||||d||fzn|d t zt|j }|r| |d }|d } ||z|z} | |zdz|z} ttt| d z d } d| z} t|}|r|j}nd}t!| | |D]}|| |z|dg}|D]}|j ||z|}|a|d|zd|cxkrdkr&nn#|t%|m|d|d|d|dd|zdzdSdS)aDump object content to specified file object or to stdout if None. Format is a hexdump with some header information at the beginning, addresses on the left, and data on right. @param tofile file-like object to dump to @param width number of bytes per line (i.e. columns) @param withpadding print padding character instead of '--' @raise ValueError if width is not a positive integer r4z!width must be a positive integer.Nr@rArBz EIP = 0x%08X zCS = 0x%04X, IP = 0x%04X zstart_addr = %r rrr8r:z%%0%dX z %02X .z --z |rz| )r%rr+rstdoutr"rKrrr#rrrFrlrr!rrrr)r-rwidth withpaddingrrrrr{r| startaddrendaddr maxdigitstempla rangewidthrr[rTrrs rdumpz IntelHex.dumps%$$ B @AA AE  >ZF ? &$$T**B$$T**B/%%e,,C2:"* -34444BN 9RHDEEEE 0:=>>>di((  9 NN   lGmG E)U2I5(A-6GCG --1155I )F J lY77 9 9 VaZ((( S!!!# & &A ac3//A} Wq[111====S=====HHSVV,,,,HHSMMMM U+++  URWWQZZ/%788889 9 9 9 9rerrorct|tstd||urtd|dvrtd|j}|j}|D]0}||vr|dkrt d|z|dkr%||||<1|j|jkrG|j|j|_dS|jdS|dkrt d |d kr|j|_dSdSdS) a6Merge content of other IntelHex object into current object (self). @param other other IntelHex object. @param overlap action on overlap of data or starting addr: - error: raising OverlapError; - ignore: ignore other data and keep current data in overlapping region; - replace: replace data with other data in overlapping region. @raise TypeError if other is not instance of IntelHex @raise ValueError if other is the same object as self (it can't merge itself) @raise ValueError if overlap argument has incorrect value @raise AddressOverlapError on overlapped data zother should be IntelHex objectzCan't merge itself)r ignorereplacez@overlap argument should be either 'error', 'ignore' or 'replace'r zData overlapped at address 0x%XrNz Starting addresses are differentr)r%rrDr+r#rLr")r-otheroverlapthis_buf other_bufr[s rmergezIntelHex.mergeMsG"%** ?=>> > D==122 2 8 8 8122 29J  ' 'AH}}g%%-9A=???((#A,HQKK ?e. . .&"'"2!)g%%-:<<< ))&+&6DOOO / .*)rr4c|sgStdkrdddzfgSdtddddD}fdt|D}fd|D}|dfd|D}|ddd t||DS) a|Return a list of ordered tuple objects, representing contiguous occupied data addresses. Each tuple has a length of two and follows the semantics of the range and xrange objects. The second entry of the tuple is always an integer greater than the first entry. @param min_gap the minimum gap size between data in order to separate the segments r4rcg|] \}}||z  Srrrrrws r z%IntelHex.segments..s YYYFQQYYYrNrc&g|] \}}|k |Srr)rr[rmin_gaps rrz%IntelHex.segments..s"QQQAQ[[![[[rc g|] }| Srrrrwrs rrz%IntelHex.segments..s000A9Q<000rc&g|] }|dzSr4rrs rrz%IntelHex.segments..s!555i!n555rc"g|] \}}||dzf Srrrs rrz%IntelHex.segments..s$@@@VaAaC@@@r)rrFzip enumeraterinsert)r-radjacent_differencesbreaksendings beginningsrs ` @rrzIntelHex.segments}s  NN$$  5I ^^q q\9Q<>23 4YYc)CRC.)TUTVTV-6X6XYYYQQQQ),@"A"AQQQ0000000y}%%%5555f555 !Yq\***@@s:w'?'?@@@@rctj|}|tj|jz }|t|jz }|t|jz }|tj|jz }|S)z2Returns the approximate memory footprint for data.)r getsizeofr!rr"r#r$)r-ns rget_memory_sizezIntelHex.get_memory_sizesj M$   S]4< ( (( Z ( (( Z " "" S]4< ( ((rrrNNN)Trr<)r<ry)Nr<F)r r)(rrr__doc__r/r\r'rjrofromfiler)rgr _DEPRECATEDrrrrrrrr{r|rrrrr staticmethodrrrrrrrr rrr*rrrrrCs""AAAA>X X X X t8, , , , H))),: $;T>>>>,   "t4<<<<*MMM%)d $>   DDD6!D!D!DFDDD*))) C C C% %677ccccJ , , , ,    %%% " " "###  ;9;9;9;9z.7.7.7.7`AAAA&rrc:eZdZdZd dZdZdZdZdZd dZ dS) IntelHex16bitzIAccess to data as 16-bit words. Intended to use with Microchip HEX files.Nc8t|tr1|j|_|j|_|j|_|j|_n?t|t rtdt|||jdkr d|_dSdS)a/Construct class from HEX file or from instance of ordinary IntelHex class. If IntelHex object is passed as source, the original IntelHex object should not be used again because this class will alter it. This class leaves padding alone unless it was precisely 0xFF. In that instance it is sign extended to 0xFFFF. @param source file name of HEX file or file object or instance of ordinary IntelHex class. Will also accept dictionary from todict method. zWIntelHex16bit does not support initialization from dictionary yet. Patches are welcome.rrN) r%rr!r"r#r$r( IntelHexErrorr/r,s rr/zIntelHex16bit.__init__s fh ' ' ,!>DL$/DO DI!>DLL  % % ,!788 8   dF + + + <5 "DLLL ! rc|dz}|dz}|j|d}|j|d}|dkr|dkr||dzzS|dkr |dkr|jSt|)aVGet 16-bit word from address. Raise error if only one byte from the pair is set. We assume a Little Endian interpretation of the hex file. @param addr16 address of word (addr8 = 2 * addr16). @return word if bytes exists in HEX file, or self.padding if no data found. r8r4Nr)r;)r#rKr!BadAccess16bit)r-addr16addr1addr2byte1byte2s rrzIntelHex16bit.__getitem__s   eT** eT** D==Ud]]EQJ' ' D==Ud]]< V,,,,rcv|dz}t|d}|d|j|<|d|j|dz<dS)zHSets the address at addr16 to word assuming Little Endian mode. r8r7r4rN)rr#)r-r7word addr_byterws rrzIntelHex16bit.__setitem__sFQJ 4   t )!"1 )A+rc^t|j}|gkrdSt|dz S)zxGet minimal address of HEX content in 16-bit mode. @return minimal address used in this object rr4rrs rr{zIntelHex16bit.minaddr1 ty ! ! 881r77A: rc^t|j}|gkrdSt|dz S)zyGet maximal address of HEX content in 16-bit mode. @return maximal address used in this object rr4rrs rr|zIntelHex16bit.maxaddrr@rctd}|jikrd||fvr|S||dkrtd||||\}}t ||dzD]}||||S)aConvert this object to binary form as array (of 2-bytes word data). If start and end unspecified, they will be inferred from the data. @param start start address of output data. @param end end address of output data (inclusive). @param size size of the block (number of words), used with start or end parameter. @return array of unsigned short (uint16_t) data. HNrrr4)rr#r+rrr)r-r}r~rrUrXs rrzIntelHex16bit.tobinarraysCjj 9??ts|33J   ?@@ @((T:: sE3q5)) # #D JJtDz " " " " rrr,) rrrr-r/rrr{r|rrrrr2r2s~SS####8---,&&&      rr2c0 t|}nK#t$r>tjd}dt |z}t |YdSwxYw|dkrC|dkr=|dkr#|dkr|}||zdz }n|dz|kr |dz|z }nd} |||_||||nN#t$rAtjd}d|dt |}t |YdSwxYwdS)aHex-to-Bin convertor engine. @return 0 if all OK @param fin input hex file (filename or file-like object) @param fout output bin file (filename or file-like object) @param start start of address range (optional) @param end end of address range (inclusive; optional) @param size size of resulting file (in bytes) (optional) @param pad padding byte (optional) r4zERROR: bad HEX file: %sNr ERROR: Could not write to file: : ) rHexReaderErrorrexc_infostrrr{r!rIOError) finfoutr}r~rrhetxts rhex2binrP sJ SMM  LNN1 '#a&&0 c qq  t|| $;;}} $,"CCA$a$  ?AI D%%%%%  LNN1 :>$$AG c qq  1s#AAA' CADDct} |||nJ#t$r=tjd}dt |f}t |YdSwxYw ||dnN#t$rAtjd}d|dt |}t |YdSwxYwdS)aSimple bin-to-hex convertor. @return 0 if all OK @param fin input bin file (filename or file-like object) @param fout output hex file (filename or file-like object) @param offset starting address offset for loading bin r4zERROR: unable to load bin file:rl)rnrErFr)rrjrJrrHrIrr)rKrLrfrMrNrOs rbin2hexrR9s  A #v  LNN1 /Q7 c qq   e$$$$  LNN1 :>$$AG c qq  1s#'AA.-A.2B ACCrrwr9c d}||}||}ddl} t| |||||d} | tj}d| dz} || dS)aDiff 2 IntelHex objects and produce unified diff output for their hex dumps. @param ih1 first IntelHex object to compare @param ih2 second IntelHex object to compare @param tofile file-like object to write output @param name1 name of the first hex file to show in the diff header @param name2 name of the first hex file to show in the diff header @param n_context number of context lines in the unidiff output ct}|||}|}|Sr)r r getvalue splitlines)rsior liness r prepare_linesz!diff_dumps..prepare_linesas;jj  ||~~!! rrNr)r.rr)linetermr)difflibr unified_diffrrrr) ih1ih2rname1name2 n_contextrYrrwr[resultoutputs r diff_dumpsrdVs  cA cANNN '&&q!eEYac&dd e eF ~ YYv  t #F LLrceZdZdZdZeeZdZeeZdZeeZdZeeZdZ ee Z dZ ee Z dZ ee Z d S) Recordz+Helper methods to build valid ihex records.ct|dksJt| dz}td||gz}dtt t |zS)a>Takes a list of bytes, computes the checksum, and outputs the entire record as a string. bytes should be the hex record without the colon or final checksum. @param bytes list of byte values so far to pack into record. @return String representation of one HEX record r:rr3r2)rFrIrr rr r)rvrTrUs r _from_byteszRecord._from_bytestsm5zzQ%jj[E !C!%%U7=#5#56677==????rcd|cxkrdksnJdt|cxkrdksnJt||dz dz|dzdg|z}t|S)a[Return Data record. This constructs the full record, including the length information, the record type (0x00), the checksum, and the offset. @param offset load offset of first byte. @param bytes list of byte values to pack into record. @return String representation of one HEX record rr=r7rr)rFrfrh)rfrvrws rdataz Record.datasF""""U""""""3u::########## ZZ&!)U*F5L$ ?% G!!!$$$rcdS)zvReturn End of File record as a string. @return String representation of Intel Hex EOF record rrrrreofz Record.eofs }rcXdddd|dz dz|dzg}t|S)zReturn Extended Segment Address Record. @param usba Upper Segment Base Address. @return String representation of Intel Hex USBA record. r8rrrrfrh)usbarws rextended_segment_addresszRecord.extended_segment_address6 1dT1WeOT%Z 8!!!$$$rc ndddd|dz dz|dz|dz dz|dzg}t|S)zReturn Start Segment Address Record. @param cs 16-bit value for CS register. @param ip 16-bit value for IP register. @return String representation of Intel Hex SSA record. r:rr9rrrn)rrrws rstart_segment_addresszRecord.start_segment_addresssI1dRUEM2e8!eU]BuH &!!!$$$rcXdddd|dz dz|dzg}t|S)zReturn Extended Linear Address Record. @param ulba Upper Linear Base Address. @return String representation of Intel Hex ELA record. r8rr:rrrn)ulbarws rextended_linear_addresszRecord.extended_linear_addressrqrc tdddd|dz dz|dz dz|dz dz|dzg}t|S)zReturn Start Linear Address Record. @param eip 32-bit linear address for the EIP register. @return String representation of Intel Hex SLA record. r:rr6rrr<rrn)rrws rstart_linear_addresszRecord.start_linear_addresssM 1dS"WeOc2gu_1fe^SY (!!!$$$rN) rrrr-rhr0rjrlrprsrvrxrrrrfrfqs55 @ @ @,{++K % % % <  D ,s  C%%% ,|,DEE % % %)L)>??%%%+l+BCC%%%(<(<==rrfceZdZdZdS)_BadFileNotationz9Special error class to use with _get_file_and_addr_range.N)rrrr-rrrrzrzsCCDrrzc 4|tjdk}d}|r|dddkrx|dddt t d t d dzDvr|dd}|dd}|d}t|}|dkr |d}d}d}n>|d krt|d}d }||dpd}||dpd}||z||fS) zSpecial method for hexmerge.py script to split file notation into 3 parts: (filename, start, end) @raise _BadFileNotation when string cannot be safely split. Nntrr4r8r2rc,g|]}t|Sr)rrs rrz,_get_file_and_addr_range..s5d5d5dc!ff5d5d5drAZr9cV|& t|dS#t$rtwxYw|S)Nr<)rr+rz)asciis rascii_hex_to_intz2_get_file_and_addr_range..ascii_hex_to_intsA +ub>>)!+++**+Ls&) osnamerrrordsplitrFrz) rT_support_drive_letterdrivepartsr)fnamefstartfendrs r_get_file_and_addr_rangersD $!#D E QqS6S==QqTZZ\\RWW5d5dgcRUhhX[\_X`X`abXbFcFc5d5d5d-e-eeebqbEE!""A GGCLLE E AAvva aa   "!%("2d33a 0D11 ; $$rc$eZdZdZdZddZdZdS)r4z(Base Exception class for IntelHex modulezIntelHex base errorNc `||_t|D]\}}t|||dS)z9Initialize the Exception with the given message. N)rrsetattr)r-rkwkeyvalues rr/zIntelHexError.__init__ sE&r** & &JC D#u % % % % & &rc|jr|jS |j|jzS#ttt f$r>t jd}dt|dt|cYSwxYw)z%Return the message in this Exception.r4zUnprintable exception rF) r_fmt__dict__ NameErrorr+rrrHrrI)r-rNs r__str__zIntelHexError.__str__s 8 8O $9t}, ,:x0 $ $ $ q!AA7777CFFF$ $ $ $ $sAA43A4r)rrrr-rr/rrrrr4r4sB22 D&&&& $ $ $ $ $rr4ceZdZdZdZdS)rNzUsed for internal needs only.z.EOF record reached -- signal to stop read fileN)rrrr-rrrrrNrNs'' ;DDDrrNceZdZdZdS)rGzHex reader base errorNrrrrrrrrGrG s "DDDrrGceZdZdZdS)rLzCHex file has data overlap at address 0x%(address)X on line %(line)dNrrrrrLrL#s PDDDrrLceZdZdZdS)rEz1Hex file contains invalid record at line %(line)dNrrrrrErE)s >DDDrrEceZdZdZdS)rGz*Record at line %(line)d has invalid lengthNrrrrrGrG- 7DDDrrGceZdZdZdS)rHz/Record at line %(line)d has invalid record typeNrrrrrHrH0s rsD-, ''''''''                           *)))))     v     T T T T T vT T T riiiiiHiii^* * * * \    :6R>R>R>R>R>VR>R>R>j     y    % % % %v$$$$$I$$$.<<<<<<<<#####]###QQQQQ.QQQ ?????^???88888888=====n===:::::.:::11111^11188888888FFFFF(BFFFEEEEE'AEEE55555n555CCCCC%<CCCBBBBB$;BBBAAAAA'>AAA99999$;999CCCCCCCCOOOOO'OOOFFFFFFFFFFr