,hSrSSKrSSKrSSKrSSKrSSKJr SSKJr Sr\4Sjr "SS\ 5r g) zHID Transport for U2F. This module imports the U2F HID Transport protocol as well as methods for discovering devices implementing this protocol. N)errors)hidc*USS:Xa USS:Xagg)N usage_pageiusageTF)devices %lib/third_party/pyu2f/hidtransport.pyHidUsageSelectorr s  LV#w4(?  c## [R"5H9nU"U5(dM[R"US5n[U5v M; g![a MKf=f7f)Npath)r EnumerateOpenUsbHidTransportOSError)selectorddevs r DiscoverLocalHIDU2FDevicesr#sS ==?a{{ hhqy!c""     s($A'&AA' A$ A'#A$$A'c\rSrSrSrSrSrSrSrSr Sr S r S r \ "/S Q5r\ "S /5r"S S\5r"SS\5rSSjrSrSrSrSrSrSrSrSrSrSrSrg)r.aaImplements the U2FHID transport protocol. This class implements the U2FHID transport protocol from the FIDO U2F specs. This protocol manages fragmenting longer messages over a short hid frame (usually 64 bytes). It exposes an APDU channel through the MSG command as well as a series of other commands for configuring and interacting with the device. )r"r"r"c4\rSrSrSrSrSr\S5rSr g)UsbHidTransport.InitPacketEaSRepresent an initial U2FHID packet. Represent an initial U2FHID packet. This packet contains metadata necessary to interpret the entire packet stream associated with a particular exchange (read or write). Attributes: packet_size: The size of the hid report (packet) used. Usually 64. cid: The channel id for the connection to the device. size: The size of the entire message to be sent (including all continuation packets) payload: The portion of the message to put into the init packet. This must be smaller than packet_size - 7 (the overhead for an init packet). cXl[U5S:wd US:dUS:a[R"5e[U5URS- :a[R"5eX lX0lX@lXPlg)Nr"i) packet_sizelenrInvalidPacketErrorcidcmdsizepayload)selfr*r-r.r/r0s r __init__#UsbHidTransport.InitPacket.__init__Vsh$ SQ#)tu}'')) W((1, ,''))hhilr c[S5nURUSS&URUS'[R"SUSUR 5 UR USS[UR 5-&[[[U55$)Serializes the packet.@rr(>Hr)) bytearrayr-r.struct pack_intor/r0r+listmapintr1rets r ToWireFormat'UsbHidTransport.InitPacket.ToWireFormatbsn bMcc!Ahxxc!f tS!TYY/%)\\c!ADLL! !" #c3-  r c[U5n[U5U:wa[R"5eUSSnUSn[R "S[ USS55SnUSSU-n[RXXEU5$)a7Derializes the packet. Deserializes the packet from wire format. Args: packet_size: The size of all packets (usually 64) data: List of ints or bytearray containing the data from the wire. Returns: InitPacket object for specified data Raises: InvalidPacketError: if the data isn't a valid InitPacket rr(r7r8r)) r9r+rr,r:unpackbytesr InitPacket)r*databar-r.r/r0s r FromWireFormat)UsbHidTransport.InitPacket.FromWireFormatks T?b RK '')) qGc qEc ]]4r!Aw 0 3d1QXg  ' ' #W MMr )r-r.r*r0r/N __name__ __module__ __qualname____firstlineno____doc__r2rA staticmethodrI__static_attributes__r r r rFr%Es' !NNr rFc4\rSrSrSrSrSr\S5rSr g)UsbHidTransport.ContPacketracRepresents a continutation U2FHID packet. Represents a continutation U2FHID packet. These packets follow the intial packet and contains the remaining data in a particular message. Attributes: packet_size: The size of the hid report (packet) used. Usually 64. cid: The channel id for the connection to the device. seq: The sequence number for this continuation packet. The first continuation packet is 0 and it increases from there. payload: The payload to put into this continuation packet. This must be less than packet_size - 5 (the overhead of the continuation packet is 5). cXlX lX0lX@l[ U5URS- :a[ R "5eUS:a[ R "5eg)Nr8)r*r-seqr0r+rr,)r1r*r-rWr0s r r2#UsbHidTransport.ContPacket.__init__sX$hhl W((1, ,'')) s'')) r c[UR5nURUSS&URUS'URUSS[ UR5-&[ [[U55$)r5rr(r8) r9r*r-rWr0r+r<r=r>r?s r rA'UsbHidTransport.ContPacket.ToWireFormats] d&& 'cc!Ahxxc!f%)\\c!ADLL! !" #c3-  r c[U5n[U5U:wa[R"5eUSSnUSnUSSn[R XXE5$)a7Derializes the packet. Deserializes the packet from wire format. Args: packet_size: The size of all packets (usually 64) data: List of ints or bytearray containing the data from the wire. Returns: InitPacket object for specified data Raises: InvalidPacketError: if the data isn't a valid ContPacket rr(r8N)r9r+rr,r ContPacket)r*rGrHr-rWr0s r rI)UsbHidTransport.ContPacket.FromWireFormats\ T?b RK '')) qGc qEc 12g  ' ' # GGr )r-r*r0rWNrKr r r r\rTs' *!HHr r\c,XlUR5nUR5nX4:wa[R"S5eUS:Xa[R"S5eX0lX l[R"S5Ul UR5 g)Nz6unsupported device with different in/out packet sizes.rzunable to determine packet sizezpyu2f.hidtransport) hid_deviceGetInReportDataLengthGetOutReportDataLengthr HardwareErrorr*read_timeout_secslogging getLoggerlogger InternalInit)r1r_rcin_sizeout_sizes r r2UsbHidTransport.__init__s O..0G002H  B DD!|  !B CC.##$89DKr cFUR[RU5nU$N)InternalExchanger U2FHID_MSG)r1msgrs r SendMsgBytesUsbHidTransport.SendMsgBytess o88#>A Hr cVUR[R[U/55$rl)rmr U2FHID_PROMPTr9)r1lengths r SendBlinkUsbHidTransport.SendBlinks'  !>!>!*F8!4 66r cTUR[R[/55$rl)rmr U2FHID_WINKr9)r1s r SendWinkUsbHidTransport.SendWinks  !)r1r. payload_inr0_ret_cmd ret_payloads r rm UsbHidTransport.InternalExchanges KKkCZ(8$99:kGAJ 1X %!..0g O00 0 /:: : **S/ oo03{1~3FFGG >oo122  //6 77r c[U5nURS- nUSUn[RURURU[U5U5nUSU2 U[U5-nUR U5 SnUS:arURS- nUSUnUSU2 U[U5-n[R URURUU5n UR U 5 US- nUS:aMqgg)z8Sends a message to the device, including fragmenting it.r)rr8rN)r+r*rrFr-InternalSendPacketr\) r1r.r0length_to_send max_payload first_frame first_packetrW next_frame next_packets r rUsbHidTransport.InternalSends\N""Q&K!K(K"--d.>.>#.1'lKIL+ c+&&NL) C 1 $$q(k1[)j !K- J'n#..t/?/?3/9;k k* Qhc 1 r cUR5nURRS[U5-5 URR U5 g)Nzsending packet: )rArfrrr_Write)r1packetwires r r"UsbHidTransport.InternalSendPackets>    DKK(3t945OO$r cURR5nURRS[ U5-5 U$)Nzrecv: )r_Readrfrr)r1frames r InternalReadFrame!UsbHidTransport.InternalReadFrame s6 OO "EKKhU+, Lr cUR5n[RRURU5nUR nUR [UR 5- nSnUS:aUR5n[RRURU5nURUR:waM\XWR:wa[R"S5eU[UR 5-nURUR 5 US- nUS:aMUSUR nURU4$)z?Receives a message from the device, including defragmenting it.rzPackets received out of orderr)rrrFrIr*r0r/r+r\r-rWrrbextendr.)r1 first_readrrGto_readrW next_readrs r rUsbHidTransport.InternalRecv)s''')J"--<N>N>GIk [__ $   ""#BCC[(())g kk+%%& Qhc) A+. ,## $D   d ##r )r-r_rfr*rcrN)g@)rLrMrNrOrPr}rnryrtr U2FHID_LOCKr U2FHID_SYNCr9rrobjectrFr\r2rqrvrzr~rgrmrrrrrRr r r rr.s+*+-++,+"#;<v&=N6=N~=H6=H~" 6MD  8*. "$r r) rPrdrr:rpyu2frrr rrrr r r rs;   )9 ]$f]$r