Home

Ellisys USB Analysis Software

1. 0x80 0x06 0x0200 0x0000 0x0009 0x0009 x09 x02 x22 x00 x01 x01 x00 xA0 x19 0x00 0x09 O0x0001 Ox0000 0x0000 Ox0000 0x21 Ox0A 0x0000 0x0000 0x0000 0x0000 0x00 0x00 0x0000 Ux0000 0x0000 0x0000 NULL j Exporting descriptors Description The descriptors can be exported to a C header or to an assembly file with format 8051 8051 ASM as shown in Figure 22 Export descriptors Export format f C header file f 5051 ASM file Exported items Call f Only filtered Back Export FS Details pa Search G Export H Options Figure 22 Export descriptors USB Analysis Software User Manual Page 53 of 68 ellisys Version 3 0 0 December 5 2007 Sample The sample below shows USB mouse descriptors export in a C header file Device 1 device descriptor static const unsigned char descriptorl d Wl Soe UKOL 0x00 VOL 0x00 0x00 0x00 0X08 Ox6D 0x04 0x02 O0xCO 0x20 0x01 0x01 0x02 0x00 0x01 bi Device 1 configuration descriptor static const unsigned char descriptor2 d 0x09 0x02 0x22 0x00 0x01 0x01 0x00 OxAD 0x19 0x09 0x04 0x00 0x00 0x01 0x03 0x01 0x02 0x00 0x09 0x21 0x00 0x01 0x00 0x01 0x22 0x48 0x00 0x07 0x05 0x81 0x03 0x08 0x00 0x0A bi Device 1 string descriptor 0 static const unsigned char descriptor3 d 0x04 0x03 0x09 0x04 bi Device 1 string descriptor 2 static const unsigned char descrip
2. Search Search for endpoints data Data Pattern 12 OL 10 01 Size 64 Destination Device 1 Endpaint Options Match case Search up Back Search JO Details 4 Search P Export L Options Figure 13 Search for endpoints data Setup requests search The Setup requests search allows you to quickly find Setup requests according to their direction Host to Device or Device to Host type Standard Class or Vendor recipient Device Interface Endpoint or Others bRequest wValue wIndex and wLength fields USB Analysis Software User Manual Page 39 of 68 ellisys Version 3 0 0 December 5 2007 Figure 14 shows a search for vendor specific Setup requests OxAO in the device s direction In addition the wValue field must match the mask Ox8FFF Search Search for setup requests Setup data Direction Dan tcare To device To host Type Dan tcare Standard Class f Vendor Recipient f Don t care 6 Device Interface Endpoint Other bRequest DxAD Use mask wu alue OxFFFF Use mask Mask wIndex wLength f Lo byte Hi byte Use mask Use mask e Custom 0 8FFF Destination Gees Device Endpoint Options Search up Back Search JO Details 4 Search P Export L Options Figure 14 Search for setup requests Search by column Searching for elements by column is an advanced search mode that allows you to find elements in acco
3. Packet id DATA1 length lt 0 gt crc16 lt 0x0000 gt speed lt LS gt time 0 585 828 Packet id lt ACK gt speed lt LS gt time 0 585 852 USB Analysis Software User Manual Page 49 of 68 ellisys Version 3 0 0 December 5 2007 Container title lt GetDescriptor Confiquration gt devicex15 endpoint lt 0 gt status lt OK gt speed lt LS gt time lt 0 595 740 Transaction type lt SETUP gt device lt l gt endpoint lt 0 gt status lt ACK gt speed lt LS gt time lt 0 595 740 gt Transaction type lt IN gt devicex15 endpoint lt 0 gt status lt ACK gt speed lt LS gt time 0 596 7325 Transaction type lt IN gt device 1 endpoint lt 0 gt status lt ACK gt speed lt LS gt time lt 0 597 724 gt Transaction type lt IN gt device 1 endpoint lt 0 gt status lt ACK gt speed lt LS gt time lt 0 598 716 gt Transaction type lt IN gt device 1 endpoint lt 0 gt status lt ACK gt speed lt LS gt time lt 0 599 708 gt Transaction type lt IN gt devicex15 endpoint lt 0 gt status lt ACK gt speed lt LS gt time lt 0 600 700 gt Transaction type lt OUT gt devicex15 endpoint lt 0 gt status lt ACK gt speed lt LS gt time lt 0 602 689 gt Container title SetConfiguration 1 gt device 1 endpoint lt 0 gt status lt OK gt speed lt LS gt time lt 0 694 274 gt Transaction type lt SETUP gt device lt l gt endpoint lt 0 gt status lt ACK gt speed lt LS gt time lt 0 694 274 gt Packet id lt SETUP gt de
4. Truncate OUT transactions to 8 bytes of payload USB Analysis Software User Manual Page 15 of 68 ellisys Version 3 0 0 December 5 2007 Please note that the custom rules override the Keep traffic from rules In the example above only traffic from Device 1 will be kept and the custom rules will be applied on the remaining traffic The custom rules are applied in the display order The custom rules are defined using the following dialog Samples values and rule summary are displayed to ease the rule creation If the specified criteria match the rule action will be applied In case of Keep transaction the transaction will be kept and stored by the software In case of Drop the transaction will be deleted and will not appear in the trace Advanced Transaction Criteria Criteria Rule action Q Keep transaction Gi Drop Device address e g 12 31 Token e g IN OUT Handshake es ACK NAK Rule Drap when Dev l 2 and Token IN OUT and Hdshk NAK Trigger tab Please note that the hardware trigger is only available with the Ellisys USB Explorer 260 or the Ellisys USB Explorer 200 Professional Edition All references to the Ellisys USB Explorer 200 Professional Edition also apply to the Ellisys USB Explorer 260 unless otherwise noted Introduction The Ellisys USB Explorer 260 and Ellisys USB Explorer 200 Professional Edition are fitted with a powerful and flexible hardware trigger It enables one to trigger
5. gt Interval Interval 94 03308 Interval Interval 632500018 Interval Interval December 5 2007 18 48 ESCH 48 244 25 167us JE 609918 3 16108 50005 167us ks 333us Page 56 of 68 ellisys Version 3 0 0 December 5 2007 Chapter 7 Software and drivers installation Install or update the analysis software Depending on the type of analyzer the analysis software s latest version is available either at http www usbexplorer com download php or http www usbtracker com download ph After you have downloaded the software installation file run it and follow the step by step installation instructions Please note that the installation requires Microsoft Windows Installer 2 0 or later If the installation does not run smoothly or if the system indicates that there is a version error update your Windows Installer Automatically install or update the device driver If the latest version of the analysis software is properly installed the driver should install automatically when the analyzer is connected If not please refer to the following paragraph Manually install or update the device driver 1 Install the latest version of the USB analysis software as explained in the previous section 2 Connect the USB analyzer 3 If you are connecting the analyzer for the first time please wait until Windows displays a message that says it discovered a new device and
6. Ellisys USB Analysis Software User Manual P Mouse ufo Ellisys Visual USB File View Search Record Help eet Ga lt A clash a n 3 Item Device Endpoint Interface Status Time Y T Y Ent T E PLON i Usage Wheel 09 38 ER GetDescriptor Device O 1 0 OK 0 060 153 583 FE 15 81 EF SetAddress 1 0 1 0 OK 0 082 650 283 x EB GetDescriptor Device 1 0 OK 0 145 161 117 Logical maximum 127 25 7F E GetDescriptor Configuration 0 OK 0 146 467 117 Report Size 8 75 08 il GetDescriptor Configuration 0 OK 0 147 536 450 GE 95 03 OK 0 149 581 450 0 OK D 150 464 950 Input Data Value Relative Bit Field 81 06 0 0 0 GEI a pua o d GetDescriptor String lang IDs GetDescriptor String iProduct OK 0 152 478 450 End Collection OK 0 153 463 783 End Collection OK 0 161 209 450 GetDescriptor String lang IDs OK 0 162 484 283 1 1 1 1 1 GetDescriptor String iProduct 1 1 1 1 OK 0 163 464 783 Input Report 0 1 1 l GetDescriptor Configuration GetDescriptor Configuration SetConfiguration 1 GetDescriptor Device SetIdle All Indefinite 0 192 100 783 GetDescriptr Report HEKS TER FESTENE pf Is Left button cick 4 456816 950 Input Report OK 5 584 893 950 TUM SST kees Input Report 14 377 493 783 HAHAH HEHE B 5 ES E E Tumhe Mak 44 MAN PAA ANA E Le G rindnext L Item Displayed Total E Transactions Count
7. 0 432 004 883 0 43 005 816 0 432 014 983 0 432 253 33 0 928 534 083 0 929 535 050 1 407 567 049 1 408 S66 949 1 568 577 983 1 569 578 099 2 224 299 533 2 224 622 066 2 224 677 300 2 274 690 766 2 224 719 900 2 224 753699 bmattributes Not supported Remotewakeup interface descriptor I UI pes mere fe i Endpoint descriptor 0 29 02 20 00 01 11 00 DO 02 FF OG OG OG 0 OS 81 03 22 04 00 04 07 OS 82 02 00 02 01 USB protocol list Dockable panes Figure 1 Overview of the analysis software Dockable panes Software panes can be moved to adapt to your needs For example the Data pane can be placed under the detail pane as in the screen shot below USB Analysis Software User Manual Page 5 of 68 ellisys Version 3 0 0 December 5 2007 To move a pane drag the pane and slide it to the desired place release the mouse button and the pane will fix itself at the desired destination In the screen dragged the Search pane and fix it under the protocol element s list 2004 01 01 Mouse ufo Ellisys Visual USB File Item Enter text here Yl El GetDescriptor Device t SetAddress 1 GetDescriptor Device E GetDescriptor Configuration Eg GetDescriptor Configuration jo ze GetDescriptor String lang IDs GetDescriptor String iProduct GetDescriptor String lang IDs GetDescriptor String iProduct GetDescriptor Device GetDescriptor Report Le
8. 00 12 00 data gt lt crcl6 gt OxuF4EO lt crcl6 gt Packet gt lt Packet id ACK speed L5S time 0 581 928 gt lt Transaction gt lt Transaction type IN device 1 endpoint 0 status ACK speed LS time 0 582 828 gt lt Transaction type IN device 1 endpoint 0 status ACK speed L5 time 0 583 820 gt Transaction type IN device 1 endpoint 0 status ACK speed L5 time 0 584 812 gt lt Transaction type 0UT device 1 endpoint 0 status ACK speed LS time 0 585 804 gt Container gt lt Container title GetDescriptor Configuration device 1 endpoint 0 status OK speed LS time 0 587 794 lt Container title GetDescriptor Configuration device 1 endpoint 0 status OK speed L5 time 0 590 775 gt lt Container title GetDescriptor Configuration device 1 endpoint 0 status OK speed L5 time 0 595 740 lt Container title2 GetDescriptor String device 1 endpoint 0 status OK speed LS time 0 604 679 lt Container title2 GetDescriptor String device 1 endpoint 0 status OK speed LS time 0 609 650 lt Container tithe GetDescriptor String device 1 endpoint 0 status OK speed LS time 0 618 589 gt lt Container title GetDescriptor String device 1 endpoint 0 status OK speed L5 time 0 623 560 gt Container title GetDescriptor Device device 1 endpoint 0 status OK speed L5 time 0 675 411 gt z Co
9. Bytes Count Bytes Total 3 040 592 bytes 3 040 592 bytes em By Device Address Addr 0 34 bytes 34 bytes Addr 1 558 bytes 558 bytes e By Endpoint Addr 0 0 IN 18 bytes 18 bytes Addr 0 0 OUT 16 bytes 16 bytes Addr 1 0 IN 254 bytes 254 bytes Addr 1 0 OUT 104 bytes 104 bytes 69 elements displayed AP NuM I5CrL 5 0 3326 0 Version 3 0 0 December 5 2007 ellisys Elisys e Chemin du Grand Puits 38 e CH 1217 Meyrin Geneva e Switzerland www ellisys com e support ellisys com ellisys Version 3 0 0 December 5 2007 Table of Contents bet Software OV AN OV ON 5 Reie elen EE 5 TT 7 Fj 40 16180 fa SONA Aa 8 Grouping of consecutive NAKs and SOFS 22222 cece wanna 9 DENS NG 10 Color coding e es e SEE EE EE EE 12 MINN 12 Chapter 2 Recording options essverersvenenevenenenenenevenensernnavenenasenenasenevevenenerere LA General el EEE EEE AA a 14 Fe dan 15 Bs 0 EE Me EE JE VE Ne 16 Chapter 3 Real time Monitoring Labanan 20 ead C 29 ICI A e EE 30 DIN Ne 31 BE 119 EE 31 Chapter 4 Protocol Summary ecsessvenenevenenvernnasenananeneneseneneveneneeenenvenanasenenesener DD MINN 33 EEE E 34 FING Fs Marte rd EE EE EE 34 Total and Displayed items Gummmmary EEN EEN GAAN NN KK KKK EEN EEN 34 REPO EEN eebe EE sea 35 Chapter 5 Searching and Post capture Filtering 36 SO
10. F5 OK 2 053 321 ESI GetDescriptor Configuration 2 0 F5 OK 2 058 321 Figure 7 Color coding of transactions Color coding transactions for didactic purposes can be very interesting For example this approach enables you to compare the traffic of a hub to that of a device during the listing process as is shown in the illustration above Options Display e Expand full details Select this check box to display full details in the Details view by default If this check box is cleared only the most frequently used fields will be displayed USB Analysis Software User Manual Page 12 of 68 ellisys Version 3 0 0 December 5 2007 e Expand low level Select this check box to display hexadecimal decimal and binary values in the Details view by default If this check box is cleared only the most readable information will be displayed e Expand tree items Select this check box to open all tree branches by default If this check box is cleared all tree items will stay closed until manually opened by the user e Show transactions packets Select this check box to show the packets contained in the transactions This enables you to watch details of each packet but consumes much more memory e Show consecutive elements subitems Select this check box to show the subitems of consecutive elements like Start of Frames This enables you to see details of each consecutive element but consumes a lot more memory Advanced e Show wrongly
11. Restart counter 1 Mo Trigger out Generate an event on the Trigger BMC connector if the criteria matches When Token Packet matches then Ma action When Data Packet matches then No action When Sequencer 0 detects Token Packet Followed by Data Packet then Trigger out Load From Default Save as Default Reset to Factory Default USB Analysis Software User Manual Page 19 of 68 ellisys Version 3 0 0 December 5 2007 Trigger examples Example 1 To generate an impulse on the BNC connector upon a High Speed Handshake event In the External Events gt Bus Conditions setup page activate the High Speed Handshake Success Then set up the Trigger Out state on the Yes position A warning is signalled when the BNC connector is set up on input Trigger Triggering is only available on the USB Explorer 200 Professional Edition 53 External Events Keep Alive Don t Care Packet Errars High Speed Handshake Success Match Frame Packets High Speed Handshake Failure Don t Care Split Packets Power Op Don t Care Taken Packets Power OFF Don t Care Data Packets z Handshake Packets Recording control No Action Bus Conditions Trigger out Yes Trigger Conditions Counters Trigger out Sequencers Generate an event on the Trigger BMC connector Configuration if the criteria matches Load From Default Save as Default When Bus Condition matches then Trigger out Warnings Bus Condition The trigger output is disabled Go to Configuration t
12. User Manual Page 32 of 68 ellisys Version 3 0 0 December 5 2007 Chapter 4 Protocol Summary Please note that the Protocol Summary view is only available with the Ellisys USB Explorer 260 Analyzer or the Ellisys USB Explorer 200 Standard and Professional Edition All references to the Ellisys USB Explorer 200 Professional Edition also apply to the Ellisys USB Explorer 260 unless otherwise noted Introduction The Summary pane shows a summary of the traffic being recorded or loaded by reporting the type of communications that occurred and the amount of bytes transferred The Summary pane can be used to get a quick overview of the number of devices transmitting the communication between the devices or the amount of errors received Summary Gi 83 Find next A Item H Transactions Count Bytes Total 1 774 1 32 kB e By Device Address Addr 58 bytes Addr 1 597 bytes Addr 2 259 706 bytes E Ze By Endpoint Addr 0 IM 26 bytes Addr 0 OUT 3 bytes Addr 1 DIN 294 bytes Addr 1 0 OUT 296 bytes Addr 1 1 IM 2 bytes Addr 2 0 IM 334 bytes Addr 2 0 OUT 136 bytes Addr 2 1 IM 236 bytes qe By Payload Length O ko 7 bytes 356 bytes 8 ko 15 bytes 1000 bytes Figure 8 Protocol Summary view USB Analysis Software User Manual Page 33 of 68 ellisys Version 3 0 0 December 5 2007 The Summary pane is organized in several sections each organized in several subsections In addition most main secti
13. actions when external events happen in case of repeated events or when specific sequences of events occur The user interface handling is very quick A text mode summary is offering a glimpse of events and defined actions USB Analysis Software User Manual Page 16 of 68 ellisys Version 3 0 0 External events December 5 2007 The hardware trigger can detect numerous conditions happening on the USB bus specifically various USB packet types electrical states error states and trigger external states USB Analysis Software Recording options y The connected unit supports advanced triggers and filters Record Wk Record and append i aaa General Filter Trigger ES External Events Packet Errors Frame Packets Split Packets Token Packets Data Packets Handshake Packets Bus Conditions Trigger Conditions Counters Sequencers Configuration Token IN PID Token OUT PID Token SETUP PID Token PING PID Device Address Endpoint Number CRE Recording control Trigger out Restart counter 0 Restart counter 1 Endpoint Number Match Don t Care Don t Care Don t Care Match if Greater than 3 Match if Equal to 2 Don t Care Ma Action Mo No No Specifies the endpoint number criteria When Token Packet matches then No action When Data Packet matches then No action When Sequencer 0 detects Token Packet Followed by Data Packet then Trigger out Load From Default Save as Default Reset to Fa
14. lt SETUP gt device lt 0 1 gt endpoint lt 0 gt status lt ACK gt speed lt LS gt time lt 0 457 092 gt Transaction type lt IN gt device lt 0 1 endpoint lt 0 gt status lt ACK gt speed lt LS gt time lt 0 458 084 gt Transaction type lt IN gt device lt 0 1 endpoint lt 0 gt status lt ACK gt speed lt LS gt time 0 459 076 Transaction type lt IN gt device lt 0 1 endpoint lt 0 gt status lt ACK gt speed lt LS gt time lt 0 460 068 gt Transaction type lt OUT gt device lt 0 1 gt endpoint lt 0 gt status lt ACK gt speed lt LS gt time lt 0 462 057 gt Reset duration lt 24 1 milliseconds gt time lt 0 463 144 Container title lt SetAddress 1 device lt 0 1 gt endpoint lt 0 gt status lt OK gt speed lt LS gt time lt 0 518 978 gt Transaction type lt SETUP gt device lt 0 1 gt endpoint lt 0 gt status lt ACK gt speed lt LS gt time 0 518 9785 Transaction type lt IN gt device lt 0 1 endpoint lt 0 gt status lt ACK gt speed lt LS gt time lt 0 519 970 gt Container title lt GetDescriptor Device gt device lt l gt endpoint lt 0 gt status lt OK gt speed lt LS gt time lt 0 581 837 gt Transaction type lt SETUP gt device lt 1l gt endpoint lt 0 gt status lt ACK gt speed lt LS gt time lt 0 58L 837 gt Packet id lt SETUP gt devAddr 1 epNum lt 0 gt crc5 lt 0x1D gt speed lt LS gt timex0 581 837 gt Packet id lt DATAO gt length lt 8 gt data lt 80 06 00 01 00 00 12
15. post capture analysis For example the user can enter a text before doing a particular command on his device under test and search later this comment to see the traffic generated by the command USB Analysis Software User Manual Page 29 of 68 ellisys Version 3 0 0 December 5 2007 General tab The General tab displays the most common statistics as the quantity of transactions the NAKed transactions the invalid transactions the detected devices and the bus usage USB traffic recording Analyzer Serial Number Ex200 18795 Duration 11 30 Total recorded 92 8 HB General Devices Frame Statistics Usetul transactions 315726 NA ed transactions 6 796 Invalid transactions 1 Frames 26087 Detected devices 4 Detected enumerations O Bus usage ratio coment USB Analysis Software User Manual Page 30 of 68 ellisys Version 3 0 0 December 5 2007 Devices tab The Devices tab displays the input output and total throughput of every detected device This tab also displays the total link throughput and detected low level errors USB traffic recording Analyzer Serial Number Ex200 18795 Duration 11 30 Total recorded 92 8 HB EEN General Devices Frame Device Total In Qut 1 O bytes s O bytes s O bytes s 2 172 kB s O bytes s 172 kB s 3 775 kB s 775 kBjs 496 bytesis 4 496 byktes s 496 byktes s O bytes s Total Thraughtput 348 kB s Error 1 Frames
16. serial number TR110 12345 to enable the Following options Export Functionality Figure 31 Software waiting for an analyzer connection USB Analysis Software User Manual Page 63 of 68 ellisys Version 3 0 0 December 5 2007 4 As soon as the analyzer is connected the software will activate the button Set Options 5 see Figure 32 Only the options displayed in the white rectangle will be activated If this does not correspond to the options you bought please contact your local distributor S Options Configurator Use this software to enable options of the USB Tracker 110 ellisys v4 Please connect the USB Tracker 110 with serial number TR110 12345 to enable the Following options Export Functionality up Set Options Figure 32 Software ready to activate optional functionality If you connect another USB analyzer an error message will be displayed see Figure 33 If you connected your analyzer and this message appeared please contact your local distributor S Options Configurator Use this software to enable options of the USB Tracker 110 ellisys Please connect the USB Tracker 110 with serial number TR110 12345 to enable the following options Export Functionality USB Tracker 110 with wrong serial number detected Figure 33 Wrong serial number detected USB Analysis Software User Manual Page 64 of 68 ellisys Version 3 0 0 December 5 2007 6 Press Set Options to activate the op
17. tab The Frame tab displays a graphical representation of the traffic in a frame The horizontal axis is the time with the origin set at the Start of Frame element The NAKed transactions the IN transactions and the OUT transactions are displayed on three separate lines The vertical axis of these three graphs is the transactions occurrence The height of the graph represents the occurrence The Frame composition graph is a combination of the three other graphs The colors are combined to have a quick understanding of the transactions nature USB Analysis Software User Manual Page 31 of 68 ellisys Version 3 0 0 December 5 2007 The example below shows the traffic of a mouse an audio speaker and a flash disk connected to an OHCI host controller The Audio speaker is using isochronous out streaming The mouse is not moved and is thus NAKing the interrupt endpoint The host is reading a file on the flash disk with a bulk endpoint We can see that the OHCI host leave some space at the beginning of the frame for the bulk traffic then schedule interrupt and isochronous traffic and then fill the space left with bulk traffic again USB traffic recording Analyzer Serial Number Ex200 18795 Duration 11 30 Total recorded 92 8 HB General Devices Frame Frame campasitian Naked transactions within a frame A IN transactians within a frame OUT transactions within a frame MM Comment EO USB Analysis Software
18. 00 crecl6 lt 0xF4E0 gt speed lt LS gt time lt 0 581 860 gt Packet id lt ACK gt speed lt LS gt time lt 0 581 928 gt Transaction type lt IN gt devicex15 endpoint lt 0 gt status lt ACK gt speed lt LS gt time lt 0 582 828 gt Packet id IN devAddr 1 epNum lt 0 gt crc5 lt 0x1D gt speed lt LS gt time lt 0 582 828 gt Packet id DATA1 length lt 8 gt data lt 12 01 10 01 00 00 00 08 crc16 0x7711 speed lt LS gt time lt 0 582 852 gt Packet id lt ACK gt speed lt LS gt time lt 0 582 921 gt Transaction type lt IN gt devicex15 endpoint lt 0 gt status lt ACK gt speed lt LS gt time lt 0 583 820 gt Packet id lt IN gt devAddr 1 epNum lt 0 gt crc5 lt 0x1D gt speed lt LS gt time lt 0 583 820 Packet id lt DATAO gt length lt 8 gt data lt 6D 04 OC CO 10 21 01 02 crel6 lt 0xC3E9 gt Speed LS time 0 583 844 Packet id lt ACK gt speed lt LS gt time 0 583 912 Transaction type lt IN gt devicex15 endpoint 0 status lt ACK gt speed lt LS gt time 0 584 812 Packet id lt IN gt devAddr 1 epNum lt 0 gt crc5 lt 0x1D gt speed lt LS gt time 0 584 8125 Packet id DATA1 length lt 2 gt data 00 015 crcl6 lt 0x8F3F gt speed lt LS gt time 0 584 836 Packet id lt ACK gt speed lt LS gt time 0 584 8735 Transaction type lt OUT gt device lt l gt endpoint lt 0 gt status lt ACK gt speed lt LS gt time lt 0 585 804 gt Packet id lt OUT gt devAddr 1 epNum lt 0 gt crc5 0O0xl1D speed lt LS gt time 0 585 804
19. 12 Figure 8 Protocol Summary view 33 Figure 9 Protocol Summary view with filtered items saaaaaaaaa aanak 35 FEIN FL 36 Figure 11 Search Tor protocol clemens saa serte eteren 37 Figure 12 Search for USB transactions ssssssseeeeeeeseeee eene hne nhan nnn 38 Figure 13 Search Tor endpoints dad EE 39 Figure 14 Search for setup requests see NNN KEREN ENN moon haa KKK KKK NB KNB KANAN ENN RN KEN KEEN NNN ENN 40 Figure 15 Search for colitis STEINS saved eee 41 Figure 16 Search of protocol errors eeeeeeeeeeerrllllliliiiese nnn haha KAKA nna emm nnn 42 FORENE 44 Figure 19 Export USB CranSaction CEET 45 Figure 19 ME ORE Sabi DC vr 48 Figure 20 Export endpoints data NNN KENNEN KEREN EEN KENNEN NNN KEEN RN KEEN EEN RN EEN KEEN ENNEN KN 51 Figure 21 EXPOr SP FA NS ES Gr 52 Figure 22 BONE 53 Figure 22 Export generator SOD EE 55 Figure 23 Updating driver from the Device Manager 58 Figure 24 Install from a list or specific location a aaa REENEN nni 59 Figure 25 Search ein une TE 60 Figure 20 Ela SANN re eee 61 Figure 27 Driver installation completed nne nennen 62 Figure 28 Icon of the unlocking software ak ENEE EE EEN nhan an nana EE EE REENEN EEN NN 62 Figure 29 Extracting compressed software a EE EE EEN EE NENNEN AA mamme rn nin 63 Figure 30 Software waiting for an analyzer Connection 63 Figure 31 Software ready to activate optional functio
20. All Setup requests of a USB mouse exported in a C header file e Mouse ufo File used as a base for all exportation samples Be aware that some exported files may become large and it is often necessary to filter transactions before exportation Instant Filter can easily suppress any redundant information See http www usbexplorer com feature02 php for more information USB Analysis Software User Manual Page 67 of 68 ellisys Version 3 0 0 December 5 2007 Chapter 9 Troubleshooting I ve finished a data acquisition and I ve noticed several CRC errors What s going on Check to make sure that the total length of the cables connected to the analyzer DUT does not exceed 3 meters Then try an analysis of a sales device before reconnecting the device that you wish to test The analysis software indicates that the devices are not correctly connected to the analyzer What should I do The devices connected to the test computer must be below the analyzer for a correct analysis to be carried out Refer to the Getting Started Manual for more information about correct connection of your analyzer The analysis software indicates that the analyzer is connected to the same controller as the device under test What should I do If you would like to use the analyzer and the device that you want to analyze on the same computer you must have at least two powerful host controllers Refer to the Getting Started Manual for more information about co
21. E GetDescriptor Sving Product ge GetDescriptor Device EZ GetDeseriptee Configuration c SLTUP transacoon SETUP packet DATAO packet t ACK packet IN transaction IN tansactjon INpackat DATA packet ACK packer gt OUT transaction EI SetCorfiguration 1 IN transaction IN transaction 470 IN transaction IN transaction 160 IN transaction IN transaction 655 Z OGD OesFesure Endpont 2 IN H 2 IN transaction IN transaction IN transaction IN transaction IN tr iniecto Ne O en pn Ke mmm ODO No data 4 bytes 04 03 09 04 4 bytes 04 03 09 04 AEE EE EEE a No data KG RAGE No date No data 4 bytes 8A F7 AF FF No data 4 bytes 82 F7 8F EF No data 4 bytes 8A F7 SF EF No data No dala No data CEL LL CALL 18 bytes 12 01 0002 9 bytes 09 02 20 00 32 bytes 09 02 20 00 34 bytes 27 03 55 00 34 bytes 22 03 55 00 18 bytes 12 01 00 02 32 bytes 09 02 20 00 U bytes 00 OG 00 NG bytes 80 06 00 Q2 32 bytes 09 02 20 00 32 bytes 09 02 20 00 512 bytes OF 14 11 1 512 bytes 13 15 15 1 512 bytes 18 1E 19 1 512 bytes 16 22 20 2 0 148 715 533 0 258 124 216 0 320 643 016 0 320 020 316 0 321 149 249 0 321 16 216 0 321 708 183 0 321 962 403 0 322 193 849 0 431 700 866 0 431 971 749 0 431 971 749 0 431 971 749 0 431 972 083 0 431 972 583 0 431 981 133 0 432 004 483 0 432 004 483
22. Manual Page 59 of 68 ellisys Version 3 0 0 December 5 2007 6 Select only Include this location in the search and type the folder path in which you have installed the software see Figure 26 Found New Hardware Wizard Please choose your search and installation options Co Search for the best driver in these locations Use the check boses below to limit or expand the default search which includes local paths and removable media The best driver found will be installed Search removable media floppy CD ROM Include this location in the search C Program Files Ellisys Wisual USBADrivers Don t search will choose the driver to install Choose this option to select the device driver from list Windows does not guarantee that the driver you choose will be the best match for your hardware Figure 26 Search for the best driver USB Analysis Software User Manual Page 60 of 68 ellisys Version 3 0 0 December 5 2007 7 Windows will find the driver and install it see Figure 27 Found New Hardware Wizard Please wait while the wizard installs the software z USB Explorer 200 e llex200 sys To CAWIN DOW S AS pastem Drivers Figure 27 Driver installation USB Analysis Software User Manual Page 61 of 68 ellisys Version 3 0 0 December 5 2007 8 After the new files have been copied the installation is completed see Figure 28 Found New Hardware Wizard Completing the Found New Ha
23. able on the USB Explorer 200 Professional Edition External Events Counters Hellege ia a Disabled Sequencers 53 Configuration sy Recording Trigger Connector Initial Recording State Specifies the initial recording state IF the initial recording state is disabled the recording will not start until a Start Recording action is fired Load From Default Save as Default When Taken Packet matches then No action When Data Packet matches then No action When Counter 0 matches then Start recording When Sequencer 0 detects Token Packet Followed by Data Packet then Start recording USB Analysis Software User Manual Page 28 of 68 ellisys Version 3 0 0 December 5 2007 Chapter 3 Real time Monitoring Please note that the real time monitoring is only available with the Ellisys USB Explorer 260 Analyzer or the Ellisys USB Explorer 200 Professional Edition All references to the Ellisys USB Explorer 200 Professional Edition also apply to the Ellisys USB Explorer 260 unless otherwise noted Overview The Ellisys USB analysis software displays powerful real time information while recording The top of the dialog displays the serial number of the unit used for recording the duration of the recording and the total recorded data Tabs provide then detailed information about the recording session A text box at the bottom of the dialog can be used to insert comments in the trace This is useful to put markers to easily find the position in
24. action When Sequencer 0 detects Token Packet Followed by Data Packet then No action User Manual Load From Default Save as Default Page 26 of 68 ellisys Version 3 0 0 December 5 2007 In the Counters gt Counter 0 setup page specify Sequencer 0 Event as a counter event We ll us a triggering value of 32 in this example however a value included between 1 and 65535 can be defined depending on one s requirements Define the Start Recording action to stop recording when the counter will hit its triggering value Trigger Triggering is only available on the USB Explorer 200 Professional Edition External Events Ex Counters Event Sequencer U Event sy Counter 0 Counter Match value 32 Counter 1 Sequencers Recording control Start Recording Configuration Trigger out No Restart counter 0 Ma Restart counter 1 Ma Recording control Controls the recording process when the criteria matches Load From Default Save as Default When Token Packet matches then Ma action When Data Packet matches then No action When Counter 0 matches then Start recording When Sequencer 0 detects Token Packet followed by Data Packet then Mo action USB Analysis Software User Manual Page 27 of 68 ellisys Version 3 0 0 December 5 2007 One must still make sure that the initial recording state is deactivated which will allow to start the recording solely when the wished for sequences count is reached Trigger Triggering is only avail
25. al Cll T TETTE 36 Instant lg EE 42 Chapter Data Nr WE ges 0 oe og EE 44 Exporthg USB ln e de EE 45 Exporthg endpoints dvale 51 EX DOFUNG Setup FNS EE 52 BONG de SEDLOR EEE EEE EE 53 USB Analysis Software User Manual Page 2 of 68 ellisys Version 3 0 0 December 5 2007 EXDOFEBJg dSenerdtor SCN dani sana PAA AA PA EE 55 Chapter 7 Software and drivers installation 57 Install or update the analysis software 57 Automatically install or update the device driver cece cece cesses ee eeeeeeeeeeeseeeeeeeggeeeneegs 57 Manually install or update the device Oriver mnm 57 Install ah optional functionality EE 62 Chapter 8 Frequently Asked Questions eese OG Chapter 9 TIU N00 Naaman pana anan OS USB Analysis Software User Manual Page 3 of 68 ellisys Version 3 0 0 December 5 2007 Table of Figures Figure 1 Overview of the analysis software NENNEN AA E EE ENNEN nas 5 Figure 2 Grouping of consecutive Start Of Frames s ssssassssnnsnssnsnunsnnannununnnnnnnnunnannnnnnannannn 9 Figure 3 Grouping of consecutive NAKed transactions ssaaaaaaaa aanak nana 9 Figure 4 Default display of tables EEN EEN EEN nn nmn nhan EEN 10 Figure 5 Tables display with full details EEN ENN EEN EEN EEN 10 Figure 6 Tables display with full details and low level values e 11 Foure 7 Color coding ol trafisact e vere
26. ced options enable you to extend data packets that include transactions SOF data packets clustered together in a single group as well as grouped NAK transactions The file that is generated in this way may be larger but it also offers the advantage of providing maximum details about the elements USB Analysis Software Export USB transactions Export format DS XML C Text Exported items C All D Only filtered Advanced options Don t export time IV Expand transactions packets M Expand consecutive elements Back Export JO Details J Search P Export dr Options Figure 18 Export USB transactions User Manual Page 45 of 68 ellisys Version 3 0 0 December 5 2007 XML format specifications lt Reset duration time expression time time expression gt lt Suspended duration time expression time time expression gt lt Power state ON OFF time time expression gt c Packet category Start of Frame 5 lt Packet id Sor speed LS FS time time expression gt frame decimal tframe lt crc5 gt hexadecimal lt crc5 gt lt Packet gt lt Packet category Token gt cPacket id A IN W W OUT VW W SETUP W Speed TELET meow time time_expression gt lt deviceAddress gt decimal lt deviceAddress gt lt endpointNumber gt decimal lt endpointNumber gt lt erc5 gt hexadecimal lt cre5 gt lt Packet gt lt 1 Packet cat
27. connected devices Select this check box to display all packets even those that belong to devices connected above the analyzer If this check box is cleared many wrong packets will be hidden if a device is not properly placed on the analyzed bus Refer to the Getting Started Manual for more information about the correct connection to your analyzer USB Analysis Software User Manual Page 13 of 68 ellisys Version 3 0 0 December 5 2007 Chapter 2 Recording options General tab The recording options of the Ellisys USB analysis software can accommodate simple and complex recording scenarios The General tab let the user configure the circular buffer the hard disk streaming the limits and the split transactions combination The hard disk streaming is a unique feature of the Ellisys analyzer The analyzed data is streamed directly from the hardware to the hard disk while recording in real time through the high performance USB 2 0 high speed connection This technique allows recording a huge quantity of data during a quite long period of time Developers use this technique to debug sporadic issues that only appear once every 24 hours or after several gigabytes of data Recording options y The connected unit supports advanced triggers and filters Record Wk Record and append General Filter Trigger Lircular Buffer Hard disk streaming Limits From Recording start w Split transactions Combine split transactio
28. ctory Default User Manual Page 17 of 68 ellisys Version 3 0 0 December 5 2007 Events Counters Powerful and flexible event counters are available They allow counting simple external events as well as events sequences Counters can be reset by any event Recording options af The connected unit supports advanced triggers and filters Record Wk Record and append General Filter Trigger External Events Counters Event Packet Error Event g Counter 0 Counter Match Value o Counter 1 E Sequencers Recording control Stop Recording Configuration Trigger out Ma Restart counter 0 No Restart counter 1 No Recording control Controls Ehe recording process when the criteria matches When Packet Error matches then No action When Counter 0 matches then Stop recording Load From Default Save as Default Reset to Factory Default USB Analysis Software User Manual Page 18 of 68 ellisys Version 3 0 0 December 5 2007 Events Sequencers Events can be sequenced to trigger actions in intricate conditions Recording options y The connected unit supports advanced triggers and filters Record Wk Record and append General Filter Trigger External Eyents Counters 15t event Token Packet Event E Sequencers 2nd event Data Packet Event ze Sequencer 0 3rd event None Sequencer 1 det event None Seguencer z Seguencer 3 Recording control Mo Action Configuration Trigger out Yes Restart counter 0 No
29. e 3 must be 0x4C Trigger Triggering is only available on the USB Explorer 200 Professional Edition 53 External Events Data DATAZ PID Dont Care Packet Errors Data MDATA PID Don t Care Frame Packets Data Size Match iF Equal to 4 Split Packets Data Pattern OG 00 CO FO O4 0F 4066 Taken Packets value 00 Mask 00 Data Packets value C0 Mask FO Handshake Packets value 08 Mask 0F Bus Conditions value 4C Mask FF Trigger Conditions value 00 Mask 00 Counters Byte 0 Sequencers Specifies a byte value and mask criteria in Configuration hexadecimal Load From Default Save as Default When Taken Packet matches then No action When Data Packet matches then No action USB Analysis Software User Manual Page 25 of 68 ellisys Version 3 0 0 December 5 2007 In the Sequencers gt Sequencer 0 setup page specify the transaction s sequence that is to say a Token Packet followed by a Data Packet in the example below Trigger External Events Counters Ej Sequencers sy Sequencer Sequencer 1 Sequencer 2 Sequencer 3 Configuration USB Analysis Software 2nd event ard event 4st event E Recording control Trigger out Restart counter 0 15t event Triggering is only available on the USB Explorer 200 Professional Edition Token Packet Even Data Packet Event None None Ma Action Mo Mo Specifies the first event of the sequence When Token Packet matches then No action When Data Packet matches then Wo
30. egory Data gt Packet id DATAO DATA speed LS FS time time expression gt lt length gt decimal lt length gt lt data gt hexadecimal data lt data gt crcl 6 hexadecimal crc16 lt Packet gt Packet category Handshake and special gt Packet id ACK NAR STALL PRE speed LS FS time time expression gt lt Transaction typa IN OUT SETUP device decimal endpoint decimal status ACK NAK STALL ERROR speed LS FS time time expression gt lt Content Packet gt Transaction ConsecutiveStartOfFrame count decimal time time expression lt l Content Packet id SOF gt lt ConsecutiveStartOfFrame gt USB Analysis Software User Manual Page 46 of 68 ellisys Version 3 0 0 lt ConsecutiveTransaction count decimal time time expression Content Transaction status NAK gt lt ConsecutiveTransaction gt lt Container title string device decimal endpoint decimal status ACK NAK STALL ERROR speed LS FS time time expression gt lt Content Transaction ConsecutiveStartofrrame gt lt Cont ine r gt lt Document title string date string gt x Content Transaction ConsecutiveStartOfFrame December 5 2007 ConsecutiveTransaction ConsecutiveTransaction Container Reset Suspended Power gt lt Docume
31. ent contains a low level error USB Analysis Software User Manual Page 8 of 68 ellisys Version 3 0 0 Grouping of consecutive NAKs and SOFs Start Of Frames are fundamental protocol elements but they make the display too cumbersome if all SOFs are displayed To prevent this inconvenience the software automatically groups consecutive Start Of Frames and indicates the count of grouped elements The following example shows an open group of Start Of Frames containing four elements Them Device Endp Status Speed T Y Y Y Y es GetDescriptor Device 1 o DE F5 M Start of Frame 4 Ss SEAN 1 Start of Frame F5 I Start of Frame F5 CI Start of Frame F5 I Start of Frame F5 SetInterface 0 Altset 01 1 o DE F5 Start of Frame 15009 F5 SetInterface 0 Altset 11 1 o DE F5 Di Start of Frame 857 F5 IN transaction 1 1 F5 fi Start of Frame F5 r IN transaction 1 1 F5 1 Start of Frame F5 December 5 2007 Comment T 18 bytes 1 1001 gt 1004 1001 1002 1003 1004 Mao data 1005 gt 1677 Mao data 1678 gt 486 Mo data 457 Mo data 455 Time 0 292 524 783 0 292 261 050 0 292 851 050 0 293 961 116 0 294 561 183 0 295 861 266 0 295 911 433 0 296 8561 333 15 307 O86 453 15 307 992 303 16 164 163 150 16 165 041 133 16 165 163 966 16 166 041 199 Figure 2 Grouping of consecutive Start Of Frames Consecutive NAK transactions are also grouped together in t
32. ficult to identify which elements belong to what transaction To prevent you from having to perform a tiresome search the analysis software allows you to color code transactions that belong to a specific device You can thus show information sent on a single device in one color whilst displaying all other traffic in another color The device address defines the background color of a transaction and the endpoint number defines the text color see Figure 7 Item Device Endpoint Speed Status Comment Time Enter te T E T En i E T T Ente T Getbortztatus 1 1 o F5 OE HORE ILE ge 4 IN transaction 4 NAKS 1 1 F5 NAE oras 3r Getbortztatus 1 1 o F5 Ok 1 525 348 ET SetPortFeature 17 1 T F5 OE 1 832 335 4 IN transaction 1 1 F5 ACE 1 byte 02 1 960 334 GetPorkstatus 14 1 o F5 OE 1 562 334 ClearPortFeature 1 il 0 F5 OK 1 666 333 GetPorkStatus r1 1 o F5 OE 1 590 332 4 IN transaction MAK 1 F5 NAE riens coser i ER rgetDescriptor Device p 0 FS ok 1 922 330 GetPorkStatus r1 1 O F5 OE 1 927 329 SetPortFeature 1 il T F5 OE 1 931 329 4 IN transaction 1 1 F5 ACK 1 byte 02 1 956 327 Getbortztatus 1 1 o F5 OE 1 959 327 ClearPortFeature 1 1 0 F5 OK 1 962 327 Set ddress 2 Of O F5 OE 1 984 326 4 IN transaction 2 NAKS 1 1 F5 NAE 1 988 325 x s GetDescriptor Device 2 T F5 OK 2 047 322 4 IN transaction NAK 1 1 F5 NAE 2 052 321 x ei GetDescriptor Configuration 2 0
33. ft button click a HID Report HID Report Right button click 4 HID Report 4 HID Report Several moves A HID Report HID Report HID Report USB Analysis Software View Search Record Help Gk emo Device 0 1 0 1 d End Y d OK OK OK OK OK OK OK OK um 7 Status Speed Time Enter text Y Wi LS LS LS LS LS LS LS L5 0 060 153 563 0 082 650 283 0 145 161 116 0 146 467 116 0 147 536 450 0 149 581 450 0 150 464 950 0 152 478 450 0 153 463 783 0 161 209 450 0 162 484 283 0 192 100 783 0 193 540 116 4 456 816 950 5 464 885 783 5 554 893 950 13 185 412 616 14 377 493 783 14 529 504 283 21 922 009 450 22 018 015 283 22 346 037 949 22 354 038 116 User Manual Eik Search shot below the user What kind of information are you looking for Protocol elements Transactions Endpoints data Setup requests Columns strings Errors JO Details 9 Search EF Options E Trigger Data 4 9 lii HE 7 00 2000 T 14 21 28 xc 74 00 69 00 6C DO 6F OO 75 00 3 UO 4F 00 20 00 F 53 00 63 oo 73 5 00 70 00 4D 00 6 42 00 00 65 2 0 1447 0 Page 6 of 68 ellisys Version 3 0 0 December 5 2007 Toolbar Record Ctri R Starts recording USB traffic an asterisk appears when the recording options are modified ie Record and Append Starts recording USB traffic and append new traffic to the curre
34. g 64 bytes of data that do not belong to device 1 Time Comment Endpoint Speed T Device Item Status transaction T The filter illustrated below enables you to display all transactions that have taken place between 0 and 200 milliseconds Status Y Time Y 0 0 2 Endpoint Speed Comment m Device T T T USB Analysis Software User Manual Page 43 of 68 ellisys Version 3 0 0 December 5 2007 Chapter 6 Data Export Introduction This software allows recorded USB transactions endpoints data Setup requests or descriptors to be exported The exporting function can be used in conjunction with instant filters for maximum versatility Export What do you vant to export USB transactions Endpoints data Setup transfers Descriptors JO Details d Search P Export L Options Figure 17 Export panel USB Analysis Software User Manual Page 44 of 68 ellisys Version 3 0 0 December 5 2007 Exporting USB transactions The exportation of USB transactions allows USB traffic to be recorded in a text or XML file The text format is often used for printing whereas the XML format may be simply scanned using a script language in order to extract very specific information You can define whether all USB transactions in a file All or only filtered transactions Only filtered must be exported see Figure 18 Advan
35. he same way Figure 3 shows a Bulk transmission for a storage device with relatively slow access Each valid transaction is preceded by several NAKs which reduces the reading performance of this device Item Device Endp Status Speed Comment Time Y Y Y Y Y Y IN transaction z 1 ACK F5 64 bytes E ut TN transaction 3 z 1 MAK F5 Mo data Hd IN transaction 2 1 DCK F5 64 bytes E 4 IN transaction 6 z 1 MAK F5 Mo data Hd IN transaction z 1 ACK F5 amp 4 bytes E Has IN transaction 3 z 1 MAK F5 Mo data 4 IN transaction z 1 ACK F5 amp 4 bytes E 4 IN transaction 4 z 1 NAK F5 Mo data Hd IN transaction z 1 ACK F5 amp 4 bytes E 4 IN transaction 17 2 1 NAK F5 Mo data 1 573 215 483 1 873 75 983 1 873 335 233 1 873 395 566 1 873 483 166 1 03 543 499 1 873 506 416 1 873 648 350 1 873 706 099 1 873 706 049 Figure 3 Grouping of consecutive NAKed transactions USB Analysis Software User Manual Page 9 of 68 ellisys Version 3 0 0 December 5 2007 Details display The details display allows you to show more information about the selected protocol element In addition to other tasks this display allows you to visualize USB descriptors requests details etc By default the software displays only high level values in the tables The least important elements are hidden to prevent the display from being overloaded see Figure 4 Device descriptor FE bDeviceClass No clas
36. ice 1 endpoint lt 0 gt status lt ACK gt speed lt LS gt time lt 0 730 139 gt Transaction type lt IN gt device lt l gt endpoint lt 0 gt status lt ACK gt speed lt LS gt time lt 0 731 130 gt Transaction type lt OUT gt device lt 1 gt endpoint lt 0 gt status lt ACK gt speed lt LS gt time lt 0 733 120 gt ConsecutiveTransaction count lt 674 gt time 0 744 0915 Power state lt OFF gt time lt 6 135 733 USB Analysis Software User Manual Page 50 of 68 ellisys Version 3 0 0 December 5 2007 Exporting endpoints data The data can be exported to a binary file raw data or to a text file text as shown in Figure 20 Export endpoints data Export format f Raw data Text Exported items C all fe only filtered Back Export FS Details pa Search G Export H Options Figure 20 Export endpoints data USB Analysis Software User Manual Page 51 of 68 ellisys Version 3 0 0 December 5 2007 Exporting Setup requests Setup requests can be exported to a C header file according to their direction Host to Device or Device to Host type Standard Class or Vendor recipient Device Interface Endpoint or Others bRequest wValue wIndex and wLength fields see Figure 21 Export setup transfers Export format f C header file Setup data Directian my C Don t care To device To host Type C Don t care Standard Li Class f Vendor Recipient De Do
37. lter out certain undesirable information What do I need to do A text zone for each column is provided for this Simply enter 2 3 in the device column to display peripherals 2 and 3 only In the same way entering 0 1 in the endpoint column hides all the endpoints except 0 and 1 The detailed view enables me to see high level textual information What do I need to do to see numeric low level information Low level information decimal hexadecimal and binary data is available by clicking on the button Show low level located at top of the frame for the packet right view The software shows a descriptor in the detailed view but it seems that some fields are missing Where are they The software hides fields that are irrelevant You can display them by clicking on the Show full details button Additional fields will appear in a slightly darker color What do consecutive SOF and NAK mean Consecutive SOF and NAK gather similar transactions to avoid overloading the screen So recording a bus with no activity for a few seconds will gather thousands of SOFs on just one line Will an invalid SOF packet be lost in a consecutive SOF No an invalid SOF will separate the group to which it belongs into two valid groups and will be placed between these two groups It will also be identified by a logo that indicates it is invalid USB Analysis Software User Manual Page 66 of 68 ellisys Version 3 0 0 December 5 2007 The software tells
38. me a device is wrongly connected What does it mean It is possible that the analyzer is connected on the same bus controller as a device being tested This configuration is not supported Please refer to the Getting Started Manual for more information on the appropriate connections I bought a software option but it is not activated What can I do Please ensure you executed the activation software sent by email through your local distributor read Chapter 7 Install an optional functionality for more information on how to install an optional functionality Please check afterwards that your software version is the latest available on the download section of our website http www usbexplorer com download ph Then restart the software with the analyzer connected How do I print from the software Printing is done using the data export feature Examples of exported data are available in the installation folder of the USB analysis software by default C Program Files Ellisys Visual USB Look for files into the Samples folder Here is a description of some of the files available in this folder e Mouse transactions txt Transactions of a USB mouse exported in text format easily printable for later analysis e Mouse transactions xml Transactions of a USB mouse exported in XML format analyzable with a custom made software e Mouse descriptors h Descriptors of a USB mouse exported in a C header file e Mouse setup requests h
39. n t care Device f Interface Endpoint Other bRequest xA Use mask e wi vw alue DxFFFF Use mask Mack wIndex wLength f Lo byte Wm fe Hi byte Use mask Use mask De Custom Ox 8FFF Exported items C All f Only filtered Back Export JO Details d Search P Export L Options Figure 21 Export setup transferts Sample The following sample shows the export of Setup requests in a C header file The array s setupRequest contains the exported setup requests The structure SETUP REQUEST contains the fields and the setup request data USB Analysis Software User Manual Page 52 of 68 ellisys Version 3 0 0 December 5 2007 struct SETUP_REQUEST ea unsigned char bmRequestType unsigned char bRequest unsigned short wValue unsigned short wIndex unsigned short wLength unsigned short cbData const unsigned char pData const struct SETUP REQUEST s setupRequest d L ehn rhm ch ca 0x00 0x05 Ox0001 0x0000 0x0000 0x0000 gt 0x80 0x06 0x0200 0x0000 0x0000 O0x0000 TM F 0x80 0x06 0x0300 0x0000 OxOOFF 0x0004 x04 x03 x09 x04 0x30 0x06 0x0302 0x0409 OxOOFF 0x002C UNXACNAXxXOSAXb5VXxXO0YXx53Xx00Xx42Vx00VxXZDXNxO0O0XVXx50Xx00Xx53XxOOXxA2E NXO0ONX32NXO0O0NX20NXOONXADNXO00NX6FVxO00XNX75NXOONXT7T3INXOONX65NX00 NX2ONXOONXAIDNXOONX2DNXOONX42NXOONXI1LNXOONXSINXOONXSTNXO0 0x80 0x06 0x0300 0x0000 OxOOFF 0x0004 x04 x03 x09 x04
40. nal Events gt Token Packets and define Token criterion We ll choose to trigger a Token IN for this example It is possible to define a peripheral or device address and a endpoint number if several peripherals devices are actually on the bus Trigger Triggering is only available an the USB Explorer 200 Professional Edition 53 External Events Packet Errors Frame Packets Split Packets Token Packets Data Packets Handshake Packets Bus Conditions Trigger Conditions Counters Sequencers Configuration Token IM PID Token OUT PID Token SETUP PID Token PING PID Device Address Endpoint Number CRC Recording control Trigger out Restart counter O Restart counter 1 Token IN PID Specifies if matches IM packets Match Don t Care Don t Care Don t Care Don t Care Don t Care Don t Care No Action Mo Ma Mo Load From Default Save as Default When Token Packet matches then No action USB Analysis Software User Manual December 5 2007 Page 24 of 68 ellisys Version 3 0 0 December 5 2007 Go to External Events gt Data Packets and define criterion We ll choose to trigger on a 4 bytes data packet with the pattern 00 00 CO 0F OA OF 4C FF that is at XXXXXXXX 1100XXXX XXXX1010 01001100 in binary This pattern signifies that the Byte 0 can have any value that the high part of the Byte 1 must be OxC the low part is masked and is not relevant that the low part of the Byte 2 must be OxA and that Byt
41. nality csse 64 Figure 32 Wrong serial number detected 224424 0044 E ENEE ENEE ENNEN NEE EE EE RENE ENEE NN 64 Figure 33 Optional functionality properly Ipstalled mmm mnn 65 USB Analysis Software User Manual Page 4 of 68 ellisys Version 3 0 0 December 5 2007 Chapter 1 Software overview Overview The Ellisys USB analysis software comprises the following elements e A list displaying USB protocol elements This list contains editable fields at the top called Instant Filters which enable you to filter out elements easily e Dockable panes You may move the panels as you wish in accordance with your preferences e A toolbar with shortcuts to the most frequently activated functions Camera USB 2 0 HS Bulk ufo Ellisys Visual USB Toolbar File Wew Search Record Help e GR epl ves i Devke Endp Status Speed Comment Wit gr Me gr vi 7 0 004 789 899 0 005 331 166 0 146 009 616 0 147 991 349 DC XR Revet 781 5 us Fa High speed Detection Handshake vg GetDeserpeee Device 0 2 NG Reset 053 4 us GetDescriptor Configuration 18 bytes 1201 0002 LM onfiguration descriptor 5 EI High speed Detection Handshake EI setaddress 2 0 2 vg GetDeserpeee Device 2 gt FG GetDescriphor Configuration amp GelDescripuor Configuration D E GetOeccriptor String lang IDs Qu Garbaserpror String Produet FG GetDescrptor saring lang IDs v U
42. ns to plain transactions Load From Default Save as Default Reset to Factory Default USB Analysis Software User Manual Page 14 of 68 ellisys Version 3 0 0 December 5 2007 Filter tab Please note that the filters are only available with the Ellisys USB Explorer 260 Analyzer or the Ellisys USB Explorer 200 Professional Edition All references to the Ellisys USB Explorer 200 Professional Edition also apply to the Ellisys USB Explorer 260 unless otherwise noted The Filter tab let the user specify basic and advanced transactions filters This is useful to reduce the quantity of recorded data in order to save file size or processing time The advanced filter features the unique partial payload filter Recording options Ti The connected unit supports advanced triggers and filters 3 Record a Record and append ZE FN General Filter Trigger Front End Basic Drop Start of Frames Drop Mak transactions Advanced Keep traffic from Devices e g 2 3 Keep traffic From Endpoints EN e g 2 IM 3 4 OUT Custom rules tule 1 Drop when Hdshk NET Rule 2 Keep when Token OUT and truncate to 8 bytes m Load From Default Save as Default Reset to Factory Default The screen shot above defines a filter that Drop all transactions with NAK handshake Keep only the traffic from Device 1 Drop all transactions with NYET handshake
43. nt document an asterisk appears when the recording options are modified e Recording options Opens the dialog permitting to configure all options related to recording like circular buffer hard disk streaming limit filters and triggers Open Ctrl O Opens a previously saved file Open and Append Appends a previously saved file at the end of the current document Save Ctrl S Saves a data acquisition in a file Group transactions Displays transactions without grouping them into transfers Group transfers Displays transactions grouped into transfers Show Hide SOFs Displays or hides Start Of Frames Show Hide NAKs Displays or hides NAKs Show Hide Split transactions Displays or hides Split transactions Show Hide bus states Displays or hides the bus and power supply states Find Shows the display enabling users to start searches Automatic Coloring Color codes transactions based on the device address and endpoint number s bo ERR Set Time Reference Set the zero on a specific protocol element Reset Time Reference Reset the zero to the original value USB Analysis Software User Manual Page 7 of 68 ellisys Version 3 0 0 December 5 2007 Protocol display The most basic USB element is the data packet but this is not always the most relevant element The transaction generally comprising several data packets is what ultimately conveys information The analysis software lists transac
44. nt gt USB Analysis Software User Manual Page 47 of 68 ellisys Version 3 0 0 December 5 2007 XML file sample The Figure 19 shows the enumeration of a USB mouse exported as a XML file in Microsoft Internet Explorer ele File mouse xml Microsoft Internet Explorer E AX Edit wiew Favorites Tools Help lt xml version 1 0 7 gt Document title Mouse ufo date 23 04 2003 11 50 04 EE E EE EE oko lt Power state 0N time 0 000 000 gt lt ExtendedSE0 duration 28 8 milliseconds time 0 011 041 lt Nodctivity duration 319 7 milliseconds time 0 042 809 z Extended SE0 duration 31 1 milliseconds time 0 362 537 gt lt Container tithe GetDescriptor Deyice device 0 1 endpoint 0 status OK speed L5 time 0 457 092 lt ExtendedSEO duration 24 1 milliseconds time 0 463 144 gt cz Container tithe Setaddress 1 device 0 1 endpoint 0 status OK speed LS time 0 518 978 gt lt Container title GetDescriptor Device device 1 endpoint 0 status OK speed L5 time 0 581 837 Transaction type SETUP device 1 endpoint 0 status ACK speed LS time 0 581 837 5 Packet id SETUP speed L5 time 0 581 837 gt zdeviceAddress 1 deviceAddress lt endpointNumber gt 0 lt endpointNumber gt zcrc5 0x1D c crc5 x Packet Packet id DATAD speed L5 time 0 581 860 lt length gt 8 lt length gt lt data gt 80 06 00 01 00
45. ntainer tithe GetDescriptor Configuration device 1 endpoint 0 status DK speed LS time 0 681 368 gt z Container title2 GetDescriptor Configuratian device 1 endpoint 0 status OK speed LS time 0 686 333 z Container title SetConfiguration 1 device 1 endpoint 0 status OK speed LS time 0 694 274 gt lt Container title SetIdle device 1 endpoint 0 status OK speed LS time 0 721 206 lt Container title GetDescriptor Report device 1 endpoint 0 status OK speed L5 time 0 724 188 gt lt ConsecutiveNak count 674 time 0 744 091 lt Power state O0FF time 6 135 733 gt T T T Documents ng My Computer Figure 19 XML export sample Text file sample The Figure 19 shows the enumeration of a USB mouse exported as a XML file in Microsoft Internet Explorer The sample below shows the enumeration of a USB mouse exported as a text file Filename Mouse ufo Date 23 04 2003 11 50 13 Power state lt ON gt timex0 000 0005 Reset duration lt 28 8 milliseconds gt time 0 011 0415 Suspended duration lt 319 7 milliseconds gt time lt 0 042 809 Reset duration lt 31 1 milliseconds gt time lt 0 362 537 gt USB Analysis Software User Manual Page 48 of 68 ellisys Version 3 0 0 December 5 2007 Container title lt GetDescriptor Device gt device lt 0 1 gt endpoint lt 0 gt status lt OK gt speed lt LS gt time lt 0 457 092 gt Transaction type
46. o enable it USB Analysis Software User Manual Page 20 of 68 ellisys Version 3 0 0 December 5 2007 In the Configuration gt Trigger Connector setup page check that the connector is activated on output It is possible to set up the output signal form depending on one s specific needs Trigger External Events Counters Output Enable VES Sequencers Polarity Active Low 53 Configuration Mode Pulse Recording sy Trigger Connector Output Enable Specifies the direction of the BNC connector Load From Default Save as Default When Bus Condition matches then Trigger out Example 2 To stop recording after detecting a certain amount of low level errors In this example well set up Packet Error events criterion then well set up a counter to stop recording USB Analysis Software User Manual Page 21 of 68 ellisys Version 3 0 0 December 5 2007 In the External Events gt Packet Errors setup page activate the Low Level Error state Do not define any actions this event is going to be used to trigger a counter in the next step Trigger Triggering is only available on the USB Explorer 200 Professional Edition 53 External Events P We Packet Errors PID Error Dont Care Frame Packets Low Level Error Match Split Packets Token Packets Recording control No Action Data Packets Trigger out Moa Handshake Packets Restart counter 0 Mo Bus Conditions Restart counter 1 ho Trigger Conditions Counters Low Level Error
47. on also totalizes the count of all subsections Categories The following categories are available in the Summary Bus States This category contains all protocol items that are not directly based on USB packets like electrical states electrical protocols etc Packets This category shows all packets listed by packets types like Token Data Handshake etc Transactions This category shows the transactions listed by various criteria like the device address the endpoint number the payload size etc Split Transactions This category shows the split transactions listed by various criteria like the split type the hub port etc Setup Transfers This category shows the setup transfers listed by various criteria like the recipient the type the request etc Errors This category shows the errors on packets on start of frames by transactions by split transactions and by LPM transactions Find Summarized Items Each event counted in a given section can be found in other panes using the Find Next and the Find Previous buttons To find a specific item select it in the Summary list and click the Find Next button in the Summary view toolbar You can also right click on the line and select Find next in the popup menu The next item that produced a count in the selected line is highlighted and displayed in the Overview pane on the left side The same procedure applies to find the previous item matching the selected summar
48. rames Transactions Split Transactions Transfers Resets Suspends Keep Alives Power Changes High Speed Hanshakes User Comments Options r Search up Back Search JO Details 4 Search P Export L Options Figure 11 Search for protocol elements Transactions search The transactions search enables you to easily find transactions according to their USB token IN OUT or SETUP their handshake ACK NAK or STALL and their destination device address and endpoint number USB Analysis Software User Manual Page 37 of 68 ellisys Version 3 0 0 December 5 2007 Figure 12 demonstrates a search for all NAKed OUT transactions for device 2 on any endpoint Search Search for transactions Token type IN M OUT SETUP Handshake type LI ASK M NAK STALL Destination Device P Endpoint Options Search up Back Search JO Details JI Search P Export Options Figure 12 Search for USB transactions Data search The data search enables you to find data in transfers and transactions You can perform a data search by entering a sequence of hex bytes or a chain of characters This method may be used with instant filters for maximum versatility USB Analysis Software User Manual Page 38 of 68 ellisys Version 3 0 0 December 5 2007 Figure 13 demonstrates a search for hex bytes 12 01 10 O1 in all data packets containing 64 bytes that was not addressed to device 1
49. rdance with the text displayed in the various columns This mode uses the same syntax that the instant filters employ Refer to the section on Error Not a valid bookmark self reference for further information USB Analysis Software User Manual Page 40 of 68 ellisys Version 3 0 0 December 5 2007 Figure 15 demonstrates a search for all NAKed OUT transactions coming from device 1 on endpoint 6 with 36 bytes of data Search Search for columns strings Columns Item Device Endpoint Status Speed Comment 36 bytes Time Options Match case Search up Back Search FS Details 4 Search P Export H Options Figure 15 Search for columns strings Errors search The erroneous elements can be easily searched thanks to this mode USB Analysis Software User Manual Page 41 of 68 ellisys Version 3 0 0 December 5 2007 Error Reference source not found shows a search for all types of errors Search Search for errors Elements type Invalid Packet Identifiers Invalid Start af Frames Invalid Transactions Invalid Split Transactians Invalid Transfers Options Search up Back Search JO Details 4 Search P Export L Options Figure 16 Search of protocol errors Instant filters The instant filters give you an easy way to filter undesirable protocol elements The filters are composed of a sequence of character chains separated by commas Wildcards can be specified in the Item Speed Sta
50. rdware Wizard The wizard has finished installing the software for c USB Explorer 200 Click Finish to close the wizard Figure 28 Driver installation completed You can then launch the USB analysis software and use it Install an optional functionality Follow the steps below to install an optional functionality on your analyzer 1 Obtain the unlocking software from your local distributor or directly from Ellisys if there is no distributor in your country see Figure 29 For a list of local distributor please go to http www ellisys com company distributors php D TR110 12345 EXE Figure 29 Icon of the unlocking software USB Analysis Software User Manual Page 62 of 68 ellisys Version 3 0 0 December 5 2007 2 If the software is embedded in a compressed file first decompress it Current operating systems should be able to decompress it without additional software see Figure 30 If not you will easily find some free software on the Web to decompress it Open Search Explore Extract All Send To k Cut Copy Create Shortcut Delete Rename Properties TR110 12345 ZIP Figure 30 Extracting compressed software 3 Launch the software It will display your analyzer serial number on which it is intended to run see Figure 31 S Options Configurator Use this software to enable options of the Iz USE Tracker 110 ellisys Please connect the USB Tracker 110 with
51. rrect connection of your analyzer When traffic is recorded in real time the software indicates that an overflow error has appeared What does this mean This error may appear when you try to analyze a device that uses a substantial amount of bandwidth such as a USB hard drive with a computer that is not very powerful or does not have a USB 2 0 connection The configuration that uses two computers is most suitably adapted for an analysis of this type of device Make sure that your analysis computer is powerful enough and has a USB 2 0 connection USB Analysis Software User Manual Page 68 of 68
52. s O i Show Full details Py bmaxPacketsizeo Jo O OO i idvendor Ellisys i idProduct 0x8001 Figure 4 Default display of tables When you click on the Show full details button the fields used less frequently appear in a slightly darker color see Figure 5 Device descriptor E Leg vald Figure 5 Tables display with full details USB Analysis Software User Manual Page 10 of 68 ellisys Version 3 0 0 December 5 2007 Clicking once on the Show low level button opens up an additional level that displays the digital equivalent of high level values in decimal hexadecimal and binary see Figure 6 Name i bLength ij bDescriptorType 1 bedusB i bDeviceClass ij bDevice SubClass ij bDeviceProtocol i bMaxPacketsize i idvendor i idPraduct ij bcdDevice ij iManufacturer i IProduct i iSeralNumber i bNumcConfiguratians A K mods f om fo suas of om Ellisys 2 46 ODA BA D xeu 32709 D xen 1 0 2 USB Tracker 110 OOOLOOL0 OOOO0001 Dog OOOO0000 Doom OOOO0000 Doom OLOO0000 00001010 10111010 10000000 00000011 00000011 10000000 00000011 N0000010 00000111 oadal Figure 6 Tables display with full details and low level values USB Analysis Software User Manual Page 11 of 68 ellisys Version 3 0 0 Color coding transactions December 5 2007 When several devices are connected at the same time the quantity of transactions being displayed can make it dif
53. s only Exported items t Al f Only filtered Back Export Figure 23 Export generator script Sample The sample below shows host packets for a GetDescritor Device request void Main d SendPacket RawData gt 0x2D 0x00 0x10 SendPacket RawData gt OxC3 0x80 0x06 0x00 0x01 0x00 OxDD 0x94 Interval gt 25 3523us WaitPacket SendPacket RawData gt 0x69 0x00 Ox10 Interval WaitPacket SendPacket RawData gt 0x69 0x00 Ox10 Interval WaitPacket SendPacket RawData gt 0x69 0x00 0x10 Interval WaitPacket SendPacket RawData gt OxD2 Interval gt 95 000us SendPacket RawData gt 0x69 0x00 0x10 Interval WaitPacket USB Analysis Software User Manual gt Interval gt 0 0 0x00 0x00 0x40 108 667us 49 000us 48 167us 22605508 Page 55 of 68 ellisys SendPacket WaitPacket SendPacket WaitPacket SendPacket SendPacket WaitPacket SendPacket WaitPacket SendPacket SendPacket SendPacket WaitPacket USB Analysis Software RawData 3 RawData La RawData RawData L7 RawData E RawData RawData RawData s Version 3 0 0 0x69 0X00 Ux10 0x69 0x00 0x10 OxD2 Interval 0x69 0x00 0x10 0x69 0x00 0x10 OxDZ Interval OXxEL 0x00 0x10 0x4B 0x00 0x00 User Manual gt
54. sequencers Matches when a Low Level Error occurs Configuration Load From Default Save as Default When Packet Error matches then No action USB Analysis Software User Manual Page 22 of 68 ellisys Version 3 0 0 December 5 2007 In the Counters gt Counter 0 setup page specify Packet Error Event as counter event We shall use a triggering value of 10 in this example however a value included between 1 and 65535 can be defined depending on one s requirements Define the Stop Recording action in order to stop recording when the counter will reach its triggering value Trigger Triggering is only available on the USB Explorer 200 Professional Edition External Events P CH Counters Event Packet Error Event sy Counter 0 Counter Match value 10 Counter 1 Sequencers Recording contral Stop Recording Configuration Trigger out No Restart counter U Ma Restart counter 1 Ma Recording control Controls Ehe recording process when the criteria matches Load From Default Save as Default When Packet Error matches then No action When Counter 0 matches then Stop recording Example 3 Starting to record after detecting a certain amount of transactions containing specific data pattern In this example we shall set up Token and Data packets criterion we ll set up a transaction sequencer and then we ll set up a counter to start up recording USB Analysis Software User Manual Page 23 of 68 ellisys Version 3 0 0 Go to Exter
55. t for example CSV The summary data will be exported to a Comma Separated Values file This is useful to open the data in spreadsheet applications like Microsoft Excel XML The summary data will be exported to a XML file This is post process the data using a custom script XML parsers are available in all major scripting languages The XML files can also be open in Internet Explorer to review its content USB Analysis Software User Manual Page 35 of 68 ellisys Version 3 0 0 December 5 2007 Chapter 5 Searching and Post capture Filtering Search The search function is used in conjunction with the software s instant filters A search for the information is only conducted in the displayed elements Several search modes are available as shown in Figure 10 Search Search What do you vant to search tor Protocol elements Transactians Endpoints data Setup requests Columns strings Errors LEN Details 4 Search P Export L Options Figure 10 Search panel Protocol elements search The protocol elements search allows you to easily find USB elements like transactions Start Of Frames Resets etc USB Analysis Software User Manual Page 36 of 68 ellisys Version 3 0 0 December 5 2007 Figure 11 demonstrates a search for Start Of Frames and transactions Search Search for protocol elements Elements type 5 3 8 z Invalid Packets Start of F
56. then jump to step 5 USB Analysis Software User Manual Page 57 of 68 ellisys Version 3 0 0 December 5 2007 4 If you want to update an already installed device driver go to the Device Manager Start Control Panel System icon Hardware tab Device Manager button Open Ellisys protocol analyzers and right click on your analyzer Select Update Driver see Figure 24 Li Device Manager File Action View Help Ed F E MARIO d Computer s Disk drives Ez Display adapters A DVDICD ROM drives Ellisys protocol analyzers USB Explorer 200 424 Floppy disk controllers H Floppy disk drives ic IDE ATAJATAPI controllers gp Keyboards Mice and other pointing devices Monitors Figure 24 Updating driver from the Device Manager USB Analysis Software User Manual Page 58 of 68 ellisys Version 3 0 0 December 5 2007 5 Select Install from a list or specific location Advanced and click next see Figure 25 Found New Hardware Wizard Welcome to the Found New Hardware Wizard This wizard helps you install software Far USB Explorer 200 E O If pour hardware came with an installation CD g3 nr floppy disk insert it now What do vou want the wizard to da CO Install the software automatically Recommended Figure 25 Install from a list or specific location It is possible that this screen and the next show up USB Tracker 110 instead of USB Explorer 200 USB Analysis Software User
57. tional functionality The software will then display a SUCcess message see Figure 34 Options Configurator Use this software to enable options of the H USB Tracker 110 ellisys Please connect the USB Tracker 110 with serial number TR110 12345 to enable the Following options Export Functionality Options have been set Thank vau Far using Ellisys products Figure 34 Optional functionality properly installed The optional functionality is now installed USB Analysis Software User Manual Page 65 of 68 ellisys Version 3 0 0 December 5 2007 Chapter 8 Frequently Asked Questions The basic component of USB is the packet but I can only see transactions and transfers Is it possible to view packets Yes packets for the selected transaction are displayed in the right hand window We have chosen this method to avoid overloading the transaction tree and because useful information is actually only transmitted when a transaction has been completed Which standard requests is the software able to decode The software decodes standard requests and descriptors but also all classes requests and descriptors primarily for Audio Mass Storage Communication Human Interface Device Still Image Printer Bluetooth HCI Video Wire Adapter Device Firmware Upgrade and Hub The software also has an extension enabling the decoding of Vendor Specific protocols The USB classes decoding is an option sold separately I would like to fi
58. tions on the left side of the display Each transaction includes the address of the device involved the endpoint number the transaction status payload and absolute time expressed in seconds All of this information is presented in a convenient column format The software analyses and decodes descriptors and requests so that they can be displayed in a format that is easier to follow In just a few seconds you can record and display all the characteristics of a device being analyzed Every element displayed in the USB list protocol holds an easily identifiable icon as follows Fi Start of frame Setup transaction ch Isochronous OUT transaction Bulk or Interrupt OUT transaction NAKed Bulk or Interrupt OUT transaction 4 Isochronous IN transaction Bulk or Interrupt IN transaction NAKed Bulk or Interrupt IN transaction Ping ACK 2 Ping NAK Start Split transaction ZE Start Split transaction erroneous Complete Split transaction Complete Split transaction erroneous Control transfer OUT Control transfer IN m High Speed Detection Handshake F in m El Extended SEO state for more than 2 microseconds k kal 15 Im m tr No activity detected for more than 3 milliseconds Power supply detected on DUT connector un Loss of power supply on DUT connector User comment 4 The element contains a warning amp The element contains an error The elem
59. tor4 d 0x2C 0x03 0x55 0x00 0x53 0x00 0x42 0x00 0x2D 0x00 0x50 0x00 0x53 0x00 0x2F 0x00 0x32 0x00 0x20 0x00 0x4D 0x00 0x6F 0x00 0x75 0x00 0x73 0x00 0x65 0x00 0x20 0x00 0x4D 0x00 0x2D 0x00 0x42 0x00 0x41 0x00 0x34 0x00 0x37 0x00 bi Device 1 class descriptor static const unsigned char descriptor5 0x05 0x01 0x09 0x02 OXAL 0x01 0x05 0x09 0x19 0x01 0x29 0x04 0x15 0x00 0x25 0x01 0x95 0x04 0x75 0x01 0x81 0x02 0x95 0x01 0x75 0x04 0x81 0x03 0x05 0x01 0x09 0x01 OxAl 0x00 0x09 0x30 0x09 0x31 0x15 0x81 0x25 0x7F 0x75 0x08 0x95 0x02 0x81 0x06 0xC0 0x09 0x38 0x95 0x01 0x81 0x06 0x09 0x3C 0x15 0x00 0x25 0x01 0x75 0x01 0x95 0x01 0xB1 0x22 0x95 0x07 0xB1 0x01 OXCO USB Analysis Software User Manual Page 54 of 68 ellisys Version 3 0 0 December 5 2007 Exporting generator scripts Description The trace can be exported to an Ellisys USB Explorer 260 Generator script This is useful to replay erroneous scenarios that were recorded with the analyzer and that are not easy to reproduce By replaying the scenario with the generator the developer has the opportunity to fix the issue and ensure it is correctly fixed with a stable setup All packets of the trace can be exported or just the packets from the host as shown in Figure 23 Export generator script Traffic to export DG Host and devices packets f Host packet
60. tus and Comment columns Ranges can be specified for the Device Endpoint and Time columns If an exclamation mark appears in front of the filter the corresponding elements will be excluded The filters are not case sensitive Start of Frames NAKs and bus states cannot be filtered using the Instant Filters Please use the buttons available on the toolbar buttons to filter out these elements The syntax of the filters is as follows filters filter filter filter string or wildcard or range wildcard string containing and characters only for Item Speed Status and Comment columns range min max only for Device Endpoint and Time columns USB Analysis Software User Manual Page 42 of 68 ellisys Version 3 0 0 December 5 2007 Examples The filter illustrated below saves all protocol elements intended for the device with address 1 or 2 Time Status Ze Endpoint Speed Comment T Device T T Y The following filter saves all elements belonging to device 1 It also excludes all endpoint 0 elements pertaining to this device Device Status Comment Time Endpoint Speed The following filter enables you to display all GetDescriptor requests that have taken place on Low Speed devices Status Comment Time Speed Device T Item 5etDescriptor Endpoint K Cc The following filter saves all transactions containin
61. vAddr 1 epNum lt 0 gt crc5 lt 0x1D gt speed lt LS gt time lt 0 694 274 gt Packet id lt DATAO gt length lt 8 gt data lt 00 09 01 00 00 00 00 00 crc16 0x2527 speed lt LS gt time lt 0 694 298 gt Packet id lt ACK gt speed lt LS gt time lt 0 694 365 gt Transaction type lt IN gt devicex15 endpoint lt 0 gt status lt ACK gt speed lt LS gt time lt 0 695 266 gt Packet id lt IN gt devAddr 1 epNum lt 0 gt crc5 lt 0x1D gt speed lt LS gt time lt 0 695 266 gt Packet id DATA1 length lt 0 gt crcl6 lt 0x0000 gt speed lt LS gt time lt 0 695 2895 Packet id lt ACK gt speed lt LS gt time lt 0 695 315 gt Container title lt GetDescriptor Report gt device lt l gt endpoint lt 0 gt status lt OK gt speed lt LS gt time lt 0 724 188 gt Transaction type lt SETUP gt device lt l gt endpoint lt 0 gt status lt ACK gt speed lt LS gt time lt 0 724 188 gt Transaction type lt IN gt devicex15 endpoint lt 0 gt status lt ACK gt speed lt LS gt time lt 0 725 179 gt Transaction type lt IN gt device 1 endpoint lt 0 gt status lt ACK gt speed lt LS gt time 0 726 171 gt Transaction type lt IN gt device 1 endpoint lt 0 gt status lt ACK gt speed lt LS gt time lt 0 727 163 gt Transaction type lt IN gt devicex15 endpoint lt 0 gt status lt ACK gt speed lt LS gt time 0 7290 1555 Transaction type lt IN gt devicex15 endpoint lt 0 gt status lt ACK gt speed lt LS gt time lt 0 729 147 gt Transaction type lt IN gt dev
62. y line The Find Previous button on the toolbar is identified by a left arrow Total and Displayed items Summary The Search is applied on the displayed items but the summary offers both the total and the displayed items count The Total column counts all the items that are available in the trace while the Displayed column only counts the items that are displayed on the screen USB Analysis Software User Manual Page 34 of 68 ellisys Version 3 0 0 December 5 2007 The Displayed column can be used to count the items matching a particular post capture filter Please refer to the chapter Searching and Post capture Filtering for more information about post capture filtering When there is a difference between the Total and the Displayed count the line is highlighted with a light background color In the following screen shot all bus states are filtered out except the user comments We can see that all counts are at 0 in the Displayed column Summary Them Displayed El ate Bus States Bytes Count 2 Total 23362 RA Reset d ZC Keep Alive 23 350 IDLE B JS Power changes ON Suspend 1 CHIRF El m4 Highspeed changes Timeout TRIE E User comment Figure 9 Protocol Summary view with filtered items Report export The Summary data can be exported to several formats Three formats are available Text The summary data will be exported to a plain text file This is useful to integrate the data into a repor

Ellisys USB Analysis Software

Contents

Download Pdf Manuals

Related Search

Related Contents