Home

Generator User Manual

1. All breakpoints in the script are removed 3 12 Compiling a Script To compile a script 1 Open a script file as described in section 3 4 Opening a File or Open a new script file and save it or Select Script Compile in the menu The USB Explorer 280 compiles the script 1 0 3470 If the compilation is successful a Compilation Succeeded message will appear in the Output pane If the compilation is unsuccessful error messages will appear in the Output pane ellisys User Interface Reference 33 of 79 To find an error in a compiled script 1 Compile a script as described above Compilation errors are listed in the Output pane under the Message column Message File Line Column Parameter RawData is mandatory C Program Files Ellisys Ellisvs USB Explorer 260 20 z 2 Double click on the desired error message in the Output pane The line that contains the errors is highlighted in the main script pane 3 13 Running a Script To select a generator 1 Select Script Select a Generator in the menu The Available Generators menu appears Available Generators Please select a generator USB Explorer 280 Ex280 12347 Use this generator by default 2 Select the desired generator and click on OK Y It is advisable to select a generator as the default generator by click the Use this generator by default check box This will stop the Available Generators dialog from appearing ever
2. Emulate a SuperSpeed Host or Device Emulate a USB 2 0 Host or Device Perform functional validation and stress testing of protocol stacks Inject errors at the physical link and protocol layers Create scripts from exported analyzer traces 8 of 79 Generator Overview ellisys 2 Installing the Application Before installing the software application for the USB Explorer 280 Generator please ensure the computer system on which it will reside meets the following requirements 2 1 Microsoft Windows XP SP1 or later Microsoft Windows Installer 3 0 or later If the installation does not run smoothly or if the system indicates a version error update your Windows installer Microsoft NET Framework version 2 0 or later Intel Core 1 5 GHz or compatible processor or better 512 MB RAM or more 1280 x 1024 screen display resolution with 65 536 colors or better USB 2 0 EHCI Host Controller Software Prerequisites The USB Explorer 280 Generator requires several software components Ellisys recommends that you visit the following web pages as needed to update your versions of Microsoft NET Framework and Windows www microsoft com net to download the Microsoft NET Framework version 2 0 www update microsoft com to update your version of Windows When using the Windows update service it will automatically download and install the Microsoft NET Framework version 2 0 See your system administrator for more informa
3. 42 of 79 Language Reference ellisys 4 12 Timers Timers are useful for example to measure or generate precise timing sequences Several timers are available in the generator Timers can be started stopped or modified It is possible to wait until a timer reaches a specified value or to change the current value of a timer The example below shows a script that measure the duration of a trigger pulse and generates one that lasts three times this duration Timer 0 Timerl Os Wait a rising edge on the input WaitTriggerIn Condition gt RisingEdge Stace Timer0 force trigger output fie Stace timer 07 GenerateTriggerOut Mode gt ForceHigh Wait a falling edge on the input WaitTriggerIn Condition gt FallingEdge Stop TimerO Le contains now the duration Of Ene npu ELigger pulse Stop lamer 0 Start Timerl with a target value of two times Timer0O StartTimer 1 WaitTimer Index gt 1 TargetValue ia Or 2 TimingRespect gt Hard 7 7 Orce trigger output Low GenerateTriggerOut Mode gt ForceLow 4 13 Ref Keyword A ref is an abstraction between the Buffer the Usb30LastRxPacket and Inline bytes It enables writing functions that will accept both Buffer and Inline data without the need of writing the code twice When a ref contains inline data all computations must occur at compile time For example it is possible doing computations by using constants but it is not possible
4. LP 01 Un Un Un Uo Uo YU 5 20 5 21 5 22 ellisys E EE 42 PP yy E E EEE 42 MING YS PPP e o o o E 43 AA e oo nies secedeenaeauwlteneexenweances 43 on e O CO EE o 44 id a UI Ue A 44 If If Else and If Else If Statements occcccccccccccncncncncnnnnnnnn cnn 44 elen EE EE 45 Kee EE E EE 45 VS CACC EE 46 Riegel A EE 46 POM SACOM IG EE 47 Mathematical el e EEN 47 COMOIMON ale Xl CSSIONS EE 49 Hardware Instructions Set Reference cccsscsssssscsscsscesee DO ITER OGUGUIOM EE 50 CONTIOUFEG GNIGE EE 50 Ss ile Ug LI eee Em no ee ee ee 53 eil EI eg Ce a te ul Elei EE 56 Bee PUSH RaW ald EE 56 WED SOROS a A R A AA 57 USDS0PUSNPOACKS E eegene 58 EECHER EE 60 Bee ge KEE 61 SO SOV al GP ACM EE 63 HOStCOnfigureBUSPOWESS OUICE ccc cece cece cece cece eee e eee eee bebe bees ene E EEE EEE EES 64 HostConfigurel nternalVbusLevel cece cece cece eee eee eee eeeeeeeeeeeeeneeeneennenes 64 lte EE 65 IER COUN ECO WN tics ceed antes E vase e O gn acs S 66 WailtCountdownNReached ssssssssssrsrrorenrrrrrrrsrrsrrrrorrsrrrrrrrerrsrrrrerrerrrrerrerenn 66 Saile H Wi E 67 SEHR 68 SECHER eebe EE Ee 69 hg EE 69 Boo AA E nn o o E 70 A te Lg a EE 71 Generale EE eege 72 5 of 79 6 6 1 6 2 6 3 6 4 6 5 6 6 6 7 6 8 6 9 6 10 6 11 6 12 6 13 6 14 6 15 6 16 6 of 79 Special EN Usb30NextTxHeaderSeqNUM eens eens eee rr 73 Usb30LastRxPacketType sica A EEN KENE EN ENNEN REENEN EE NA NEE 73 Usb
5. Opens a folder to open a previously saved document Saves a document ellisys E lali ee Edit PP Edit po Edit 4 4 D Save All Save As CTRL SHFT S Load Sample Load Library Page Setup Print Preview Print CTRL P Exit Undo Ctrl 2 Redo Ctrl Y Cut Ctrl X Copy Ctrl C Paste Ctrl V Advanced Mark Line Modifications Highlight Current Line Show Column 80 Guide Comment Selection CTRL K CTRL C Uncomment Selection CTRL K CTRL U Make Uppercase CTRL SHFT U Make Lowercase CTRL SHFT U Bookmarks Toggle Bookmark CTRL K CTRL K Enable Bookmark CTRL K CTRL N Previous Bookmark CTRL K CTRL P Next Bookmark CTRL K CTRL L Clear Bookmarks CTRL K CTRL H Insert Code Snippet CTRL 1 ellisys Saves all documents currently open Saves a file with a new name Opens sample files provided with application Opens include libraries Opens Page Setup dialog allowing user to set page margins and other parameters Opens the Print Preview window Opens Print Options for printing a document Closes the application Undoes the previous action Redoes the previous action Cuts a text selection Copies a text selection Pastes a selection of copied or cut text Marks line modifications in the script Highlights the current line in the script Displays the column guide in the script Adds a comment to the currently selected line Removes
6. Usb30NextLinkGoodIndex 7 Usb30NextLinkCreditIndex 0 Usb30ImmediateLinkCommand Usb30ImmediateLinkCommandNextLcredit Usb30ImmediateLinkCommandNextLgood Usb30ImmediateLinkCommand Usb30ImmediateLinkCommandNextLcredit Usb30ImmediateLinkCommand Usb30ImmediateLinkCommandNextLcredit Usb30ImmediateLinkCommand Usb30ImmediateLinkCommandNextLcredit 6 13 Usb300rderedSetCounterTseq This register contains the count of consecutive TSEQ ordered sets received by the generator 78 of 79 Special Registers ellisys 6 14 Usb30O0rderedSetCounterTsl This register contains the count of consecutive TS1 ordered sets received by the generator 6 15 Usb300rderedSetCounterTs2 This register contains the count of consecutive TS2 ordered sets received by the generator 6 16 Usb300rderedSetTsLinkFunc This register contains link functionality field extracted from the last TS1 or TS2 ordered set received by the generator ellisys Special Registers 79 of 79
7. this time only Yes now and every time connect a device No not this time Click Next to continue Cancel 3 Select No not this time 4 Click on Next The Found New Hardware Wizard appears Found New Hardware Wizard Welcome to the Found New Hardware Wizard This wizard helps pon install software for Ellizys USB Explorer 80 If your hardware came with an installation CD or floppy disk insert it now What do vou want the wizard to do Install from a list or specific location Advanced Click Next to continue 5 Select Install the software automatically Recommended 6 Click on Next 18 of 79 Installing the Application ellisys The Please wait while the wizard installs the software window appears Found Hew Hardware Wizard Please wait while the wizard installs the software 2 Ellieys USB Explorer 80 ellex 80 aus TotCMalNDhwkeustem 22NDDIVERG Cancel Windows now installs the driver 7 When the installation is complete the wizard has finished installing the software screen appears Found New Hardware Wizard Completing the Found New Hardware Wizard The wizard has finished installing the software for Ellizys USE Explorer 80 Click Finish to close the wizard 8 Click on Finish The installation is complete ellisys Installing the Application 19 of 79 3 User Interface Reference The user interface of the USB Explorer 280 Generator
8. 0x00000001 conse Usbs0MastRxPackeubrrorsPackerlLrrer 0x00000002 const Usb30LastRxPacketErrorsPacketTypeError 0x00000004 const Usbs0lastRxPacketBhrrorsDabaC rch rror 0x00000008 const Usb30LastRxPacketErrorsLengthMismatch 0x00000010 Please note that when the link acknowledges are automatically sent by the generator when the rxAutoSendLinkAck Of ConfigureLink Is set to true a packet cannot be received with the Header Error bit set because a Lbad would be sent automatically and the HP would be discarded 6 10 Usb30NextLinkGoodlndex This register indicates which index will be used for the next LGOOD This register is automatically incremented in the following cases The index is incremented for each LGOOD sent after the reception of a valid header packet when Usb30ConfigureLink rxAutoSendLinkAck is enabled The index is incremented when sending a LGOOD manually by using the special register Usb30I mmediateLinkCommand This register can be written to set the next LGOOD index to be sent at the desired value 6 11 Usb30NextLinkCreditl ndex This register indicates which index will be used for the next LCRD This register is automatically incremented in the following cases The index is incremented for each LCRD sent after the handling of a valid header packet when Usb30ConfigureLink rxAutoSendLinkCredit is enabled The index is incremented when sending a LCRD manually by using the special register Usb30I mmediateLin
9. 1 5ms Sleep 80ns Parameter List Duration Description Amount of time to wait Type Time expressed in seconds Range O to 34 36 seconds with a precision of 8 nanoseconds Default No default value this parameter is mandatory Example 1 32ms means 1 320 microseconds 10ns will be floored down to 8 nanoseconds ellisys Hardware Instructions Set Reference 65 of 79 5 14 StartCountdown The StartCountdown Instruction starts a countdown timer in the generator Three countdown timers can run simultaneously It is then possible waiting a countdown timer reached zero by using the WaitCountdownReached instruction Example State Counedown fidex lt gt 0 Dura e ON OO SUS Sra rECOUMmCOWM 65538US a Parameter List Index Description Index of the countdown timer Range O to 2 Default 0 Duration Description Amount of time to wait Type Time expressed in seconds Range O to 34 36 seconds with a precision of 8 nanoseconds Default No default value this parameter is mandatory Example 1 32ms means 1 320 microseconds 10ns will be floored down to 8 nanoseconds 5 15 WaitCountdownReached The WaitCountdownReached instruction waits for the countdown timer to reach zero Example WaitCountdownReached Index gt 0 Timeout gt 500ms TimingRespect gt Hard 66 of 79 Hardware Instructions Set Reference ellisys Parameter List Index Description Range Default Timeout Descriptio
10. Generator for SuperSpeed USB 3 0 Up Down Power Link o Downstream Operating Receive Trigger Transmit When connecting USB cables DO NOT force the connector into the unit The metal part of the connector should not be inserted completely into the connection port Forcing the connector or inserting all of the metal part of the connector will break the port connection and is not covered by the warranty d Upstream Connector The Upstream Connector is usually used in Device Emulation mode to connect the Generator to a Host Under Test It can also connect to a Hub Downstream Port for the same purpose Downstream Connector The Downstream Connector is usually used in Host Emulation mode to connect the Generator to a Device Under Test It can also connect to a Hub Upstream Port for the same purpose Power LED The Power LED indicates if the unit is correctly powered from the supplied 24VDC 2A power adapter and connected to the control computer O Constant green Powered and connected ready to operate Flashing green Powered but not connected Y Flashing red Connected but not powered Ney Off Not powered and not connected The Power LED may also be off if when the unit is in power saving mode after the control computer has been turned off 14 of 79 Installing the Application ellisys Operating LED The Operating LED indicates if the unit is presently operating or not for example as protocol analyzer or as traffi
11. HSN l OxX04 O00 COO O00 O20 AO RES COO WU WOO Cx Wiis Westie Weil sae y Usb OSendPacket SNS O08 REENERT EE RES KREE EE bs Usb30NextTxHeaderSeqNumt sb O0SendPacket HSN 4 0x04 0x007 0x00 0x00 WoO 0x00 Ox21 0x00 0x00 0x00 0x00 0x00 as 0x3C 0x01 0x58 gt 6 2 Usb30LastRxPacketType This register contains the packet type field extracted from the last received packet ellisys Special Registers 73 of 79 Example void WaitPacketType in packetType Repeat d Usb30WaitPacket Eome TUS team ea Timeout gt 500ms it MarehOceurred if Usb30LastRxPacketType packetType OK we got a packet of the expected type exit 6 3 Usb30LastRxPacketSubType This register contains the packet sub type field extracted from the last received packet If the field is not applicable for the received packet then the field is reset to O Example void WaitPacketType in packetType in packetSubType repeat Usb30WaitPacket siga EE Timeout gt 500ms 1 MatchOccurred if Usb30LastRxPacketType packetType amp amp Usb30LastRxPacketSubType packetSubType OK we got a packet of the expected type and sub type exit 6 4 Usb30LastRxPacketDevAddr This register contains the device address field extracted from the last received packet If the field is not applicable for the received packet then the field is reset to O 74 of 79 Special Re
12. Hardware Instructions Set Reference 69 of 79 TargetValue Description Type Default Example Timeout Description Type Range Default Example TimingRespect Description Range Default Example Specifies the target value to wait on O to 4 294 967 295 No default value this parameter is mandatory 10500 will match when the specified timer reaches value 10 500 Timeout after which the instruction is aborted Time expressed in seconds O to 34 36 seconds with a precision of 8 nanoseconds No default value this parameter is mandatory 1 32ms means 1 320 microseconds 10ns will be floored down to 8 nanoseconds Specifies if the processor breaks if the countdown value was already reached at the time the wait was called Soft OF Hard Soft Soft to continue even if the countdown value was already reached Hard to break script execution if the countdown value was exceeded This value Hara helps detecting timing errors in scripts 5 20 CopyMemory The CopyMemory instruction copies bytes from a location of the user buffer to another location Example CopyMemory Se IA AO 5 Dst gt Burrer 200 rom lo CopyMemory STO gt Butrer 0 ror 2 best gt Burrer 700 tor CopyMemory sae gt Usb30LastRxPacket 16 for 128 DSE gt Bue O Toro 70 of 79 Hardware Instructions Set Reference ellisys Parameter List Src Description The source data to copy to the destination Type Inline b
13. and assigns the result to a a o gt gt The following example performs a left shift operation between the value of b and the value of c and assigns the result to a a o lt 48 of 79 Language Reference ellisys The following example demonstrates how to combine expressions to produce more complex results au ore 0x0 eZ ee 4 23 Conditional Expressions The hardware flags that can be tested are MatchOccurred and TimeoutOccured These two flags are set by instructions that wait specific conditions Conditional expressions can be used as condition of execution or termination with several statements including if while and do while The following example executes the specified code if a equals b die el b ee EE e here 7 The following example executes the specified code if a is different from b if a b insert code here The following example executes the specified code if a is greater than b irla gt b EE The following example executes the specified code if a is greater than or equal to b Lila gt b 1 ingert coce heres The following example executes the specified code if a is less than b irla lt b 4 ingert code here The following example executes the specified code if a is less than or equal to b Lila lt b 1 insert code here a ellisys Language Reference 49 of 79 5 Hardware Instructions Set Reference 5 1 Introduction The Ell
14. application provides various panes menus toolbars and other visual elements Mass Storage SCSI Host Emulation u30s Ellisys USB 3 0 Generator Menu Bar gt File Edit Wem Search Script Help Toolbar gt ada 3104280000 gt Mass Storage SCSI Host Emulation u30s include Usb30Host u3Osinc var deviceiddress void Main H Script ref payloadBuffer Buffer O for var payloadReceivedLength ERR preakpoint VaitDeviceindSwitchToD0 GetDeviceDescriptor deviceiddress gt 0 descriptorBuf fer gt payloadBuffer descriptorRequestedLength DescriptorSize Device descriptorReceivedLength gt payloadReceivedLength Setiddress 0 1 GetDeviceDescriptor devicelddress gt 1 descriptorBuffer payloadBuffer descriptorReceivedLength gt payloadReceivedLength GetBosDescriptor Output q Xx Registers Message Column Name LU compilation succeeded EI Rg Global Variables Y deviceAddress Re g i ste rs O u t p u t E Local Variables Y payloadReceivedLength 3 p ane pa ne E 4 Registers y Counter4 Y CounterB z CounterC CounterD Paused Ln10 Coli Chi3 1 0 3470 The Generator application has several default panes Each pane displays specific information or allows the user to interact with the software for a given task Script Editor Shows the current script The Script Editor allows for editing the script setting or clearing breakpoints and placement of bookmarks to enh
15. as long as a specified condition is true The condition is checked before the instruction is executed A while statement can be stopped with the exit keyword The example below shows a script that toggles the state of the Trigger Out connector every 200 milliseconds until the Trigger In connector presents a high logic level while true GenerateTriggerOut Mode gt Toggle WaitTriggerlIn Condition gt Highlevel Timeout gt 200ms if MatchOccurre exit 4 20 Do While Statement The do while statement executes instructions as long as a specified condition is true The condition is checked after the instruction is executed A while statement can be stopped with the exit keyword 46 of 79 Language Reference ellisys The example below shows a script that generates a pulse on the Trigger Out connector until the Trigger In connectors presents a high logic level do GenerateTriggerOut Mode gt PulseHigh WaitTriggerln Condition gt Lowlevel Timeout gt 0 while MatchOccurred 4 21 For Statement The for statement executes instructions in a loop a certain number of times A for statement can be stopped with the exit keyword The example below shows a script that generates 20 pulses on the Trigger Out connector Ona ele a Or A LTPF GenerateTriggerOut Mode gt PulseHigh 4 22 Mathematical Expressions The Ellisys script language supports the fo
16. in the screens are samples and serve as instructional purposes only Document Revision History Date Revision enge July 1 2009 Aug 12 2009 Changed Lane to Port in all instructions Nov 5 2009 EC Added new instructions and special registers Nov 19 2009 Added description of ref Ellisys Contact Details Ellisys Phone 41 22 777 77 89 Chemin du Grand Puits 38 Fax 41 22 777 77 90 CH 1217 Meyrin Geneva Email info ellisys com Switzerland Web www ellisys com 2 of 79 ellisys Conditions of Use and Limited Warranty Terms These conditions and terms are deemed to be accepted by the customer at the time the product is purchased leased lent or used whether or not acknowledged in writing Conditions of Use The customer is only authorized to use the product for its own activities whether professional or private Thus the customer is in particular forbidden to resell lease or lend the product to any third party In addition the customer has in particular no right to disassembly modify copy reverse engineer create derivative works from or otherwise reduce or alter the product The product may also not be used in any improper way Limited Warranty Coverage Ellisys warrants to the original customer of its products that its products are free from defects in material and workmanship for the warranty period Subject to the conditions and limitations set forth below Ellisys will at its option either repair o
17. in the script where the code snippet is to be inserted 2 Select Edit Insert Code Snippet in the menu or press CTRL 1 The Code Snippet list appears Insert Snippet 5 CopyMemory 5 Do while For 5 GenerateTriggerQut IF 5 If Else Z If Else if Repeat SendFrame x ellisys User Interface Reference 27 of 79 3 Select the desired code snippet from the list 4 Double click on the desired code snippet or select the desired code snippet and press ENTER The selected code snippet is inserted into the script and can be modified as needed 3 8 Advanced Editing Features All advanced editing features for the USB Explorer 280 can be accessed by clicking Edit Advanced in the menu To mark or unmark line modifications 1 Select Edit Advanced Mark Line Modifications in the menu All lines that have been modified are marked with a yellow highlight To highlight the current line 1 Select Edit Advanced Highlight Current Line in the menu The line with the cursor is highlighted To display the column 80 guide 1 Select Edit Advanced Show Column 80 Guide in the menu To comment a selection tn the script 1 Select the lines that will be commented 2 Click on Comment Selection or select Edit Advanced Comment Selection in the menu Comment markers are inserted before the selected lines To uncomment a selection in the script 1 Select the commented lines desired to be uncom
18. of the screen or pane group ellisys User Interface Reference 21 of 79 3 2 Main Toolbar The table below shows the USB Explorer 280 Generator toolbar buttons and their actions New document Open document Save document Print Print Preview Cut Copy Paste Undo Redo Find Replace Comment Selection Uncomment Selection Toggle Bookmark Previous Bookmark Next Bookmark Clear Bookmarks Compile Run Break Stop Restart Step 3 3 Main Menu Opens a new document Opens a folder to open a previously saved document Saves a document Opens Print Options for printing a document Opens the Print Preview window Cuts a text selection Copies a text selection Pastes a selection of copied or cut text Undoes the previous action Redoes the previous action Opens the find and replace window Comments out one or more lines Uncomments one or more lines Toggles a bookmark at a selected line Finds the previous bookmark Finds the next bookmark Clears all bookmarks Compiles a script Runs a stopped or paused script Pauses a running script Stops a running script Stops and restarts a script from the beginning Steps from line to line in the script The table below shows the SuperSpeed USB 280 Generator main menu options and their actions with shortcuts shown in parentheses File New CTRL N sy Open CTRL O ial Save CTRL S 22 of 79 User Interface Reference Opens a new document
19. power from an internal source The voltage of this internal source can then be further configured by using the HostConfigureInternalVbusLevel instruction Example HostConfigureBusPowerSource HostPowerSource Internal Parameter List PowerSource Description Range Default Selects the power source HostPowersource HostPowersource HostPowersource HostPowersource off no power is supplied Vbus is at OV Internal power is supplied by the generator External power is supplied from the outside OTE 5 12 HostConfigurel nternalVbusLevel The HostConfigureInternalVbusLevel instruction configures the voltage supplied by the internal power source The HostConfigureBusPowerSource Instruction must be used to select internal power source 64 of 79 Hardware Instructions Set Reference ellisys Example HostConfigureBusPowerSource HostPowerSource Internal var vbusLevel HostMaxInternalVbusLevel while vbusLevel gt HostMinInternalVbusLevel HostConfigurelInternalVbusLevel vbusLevel Sleep 1s vols leal 020 y EE Parameter List Level Description Sets the Vbus level Type Value representing 10 mV by unit Range 356 3 56 V to 543 5 43 V Example 400 means 4 00 V 500 means 5 00 V 5 13 Sleep The Sleep instruction waits a precise duration which can be specified in units of time seconds milliseconds microseconds and nanoseconds Example Sleep Duration gt
20. submenu appears Default Hex Dec Bin 2 Click on the desired numbering format Dec Hex or Bin For more information about The register numbering format is changed as selected and any values present are updated in the selected format 36 of 79 User Interface Reference ellisys 4 Language Reference 4 1 Comments Single line comments are done using the characters void Main M This as te cingle hime comment CopyMemory Src gt 0x00 0x00 Det gt Buffer DstOffset gt 200 Multi Line comments are opened using characters and closed using the characters void Main l This is a muller line comment which prevents the following instruction from being executed CopyMemory sre gt 0x00 0x00 l Dst gt Buiter DsvOrrser gt 200 E 4 2 Include Files Files can be included using the include directive The example below shows a script that calls an include file which uses the macro declared inside the file CA SM Me US Mas void main 7 Calls a function declared in My inc ae USOS me SendPulseAndWaitAnswer 10 2s 4 3 Constants Declaration Constants can be declared with the const keyword const NormalState StateMachine Running const DefaultTimeout 450ms vota marin WaitForState State gt Normalstave Timeout gt DefaultTimeout ellisys Language Reference 37 of 79 4 4 Variables Declaration Variables are instant
21. the comment from the selected line Changes selected lowercase text to uppercase Changes selected uppercase text to lowercase Toggles a bookmark at a selected line Enables the selected bookmark Finds the previous bookmark Finds the next bookmark Clears all bookmarks Opens a dialog permitting insertions of pre defined code Snippets into the script at the currently selected line User Interface Reference 23 of 79 View Output Window Registers Window Search 24 Find CTRL F Replace CTRL H Find Next F3 Find Previous SHFT F3 Go To Line CTRL G Script Compile F7 p Run F5 ij Break A Stop SHFT F5 y Restart Step F10 Toggle Breakpoint F9 Q Clear All Breakpoints CTRL SHFT F9 Select a Generator Help Ellisys website lt Contact support Check for updates About 3 4 Opening a File To open a file Opens or closes the Output window Opens or closes the Registers window Opens the Find window Opens the Replace window Searches forward to find the text previously entered into the Find window Searches backward to find the text previously entered into the Find window Opens the Go To Line window Compiles a script Runs a stopped or paused script Pauses a script when running Stops a running script Stops and restarts a script from the beginning Steps from line to line in a Script Toggles a breakpoint at a selected line Removes all br
22. txAutoComputeCrcs Description Note Default Example Specifies whether packet CRCs Header LCW and Data will be automatically computed by the generator hardware or sent as Specified by the script The default auto CRCs computation can be overridden in the Usb30PushPacket instruction True True Will result in the generator automatically computing CRC values False Will result in the generator sending the CRC value specified 52 of 79 Hardware Instructions Set Reference ellisys txAutoGenerateSkip Description Specifies whether the generator will send Skip ordered sets automatically as required by the specification Note If turned on skips will be inserted between TSEQ This parameter Should be set to False before sending out TSEQ if it is not the desired behavior Range Boolean True or False Example True will result in the generator automatically sending Skips False will result in the generator not sending Skips automatically Skips can be though inserted manually 5 3 ConfigureLink The ConfigureLink instruction configures automated link layer hardware handling to packets received or sent by the generator The automatic link layer handling permits the user to greatly simplify the development of complex scripts All link layers aspects such as link acknowledges Lgood_N Lbad link credits Lcrd_ Ai Header Sequence Numbers etc are then automatically handled by the generator hardware and the script can fo
23. using runtime registers or counters void MyOperation in data in value daca Otto 0 values vola main d Case 1 we take a ref on the Buffer and copy CounterA in it ref rerl Buffer 0 for 4 MyOperation refl CounterA ellisys Language Reference 43 of 79 Case 2 same but we copy inline data ref ref2 Buffer 0 for 4 MvOpera one AS a Case 3 we declare a ref on inline data and copy a constant A Lal ae EE EE EES ref ref3 InlineBuffer MyOperakitom rer3s 172 3 4 Case 4 we try the same but with a counter It will not work because it is not compile time ref ref4 InlineBuffer MyOperation ref3 CounterA ERROR not compile time 4 14 Stop Keyword The stop keyword stops the execution of the generator This is useful for example to stop the generator when a required condition is not met WaitTriggerln Condicion E e Eet Timeout gt 100ms it limeourOcelliited Condicion not Mek Slop execution Stop 4 15 Breakpoint Keyword The breakpoint keyword breaks the execution of the generator The execution can be resumed by the user from the breakpoint WaitTriggerlIn Condition gt FallingEdge Timeout gt 100ms it imecutoccurred Condicion nort met break execution breakpoint 4 16 If If Else and If Else If Statements The if if else and if else if statements executes instructions conditionally depending on a boolean condi
24. 10 2s The following example shows a function returning a value based on a parameter var ComputePosition index crecurcn index 85 TimerA ComputePosition CounterB 4 6 Function Calls The parameters of functions are explicit The syntax for specifying parameter values iS param gt value The parameters order is thus not relevant as the parameter is fully identified by its name The examples below show a function with two parameters parami and param2 the value 10 is assigned to param1 and the value 20 to param2 samp eMac ro T Param IO Param 20n Sample Ma cro TParam a AO E a Eeer A function having only one parameter may omit the name of the parameter For example Sleep Duration gt 10us Can also be written as ellisys Language Reference 39 of 79 Sleep 10us ji Parameters are optional when they have a default value If the parameter is not specified in the call the default value is used The example below defines a macro with two parameters Param1 IS mandatory and Param2 has a default value of O Since Param2 is not specified in the call the value O will be used as default void SeamMplerunceron Param Param 0 Sleep Param 1 E y Eet d EE EE 4 7 Enumerations Declarations Enumerations can be used to give names to known values The example below shows a script that defines several error codes enum ErrorCode NOE fio 0 Timeout 1 SequenceMismatch 2
25. 30LastRxPacketSubType EE 74 USb30LEStRX le RE e e EE 74 Usb30LastRxPacketEpPNU Mi ssivcccnsiwewdsdeavirctiasseverenntensapiarnicen widen ENEE EEN EA RENE 75 eng x Pack CEN DORA EE 75 Ueb 0laerbvbackerbavloadlengorh cece cece ee eee eee e cess nn n nr rr 75 USDSOLASURXPACKEEP el 76 EE EE EE ee 76 USDSONGEXTLINKGOOGI NOE EE 77 Usb30NextLinkCreditlNdeX 2 0 ccc ccce cece cece cece eee e eee rr 77 Usb30I MMediateLINKCOMMANGA E 78 Ueb OrderedetCountertseg eens eee rr 78 Ueb OrderedetCountertel cece eee e eee rr 79 Usb30OrderedSetCounter S2 EE 79 Usb30OrderedSetTsLinkFUNnC EE 79 ellisys About this Manual Typographic Conventions Bold is used to indicate menu commands buttons and tabs Italics are used to indicate fields pane names window names and cross references Fixed width Is used to indicate system file names text typed and code snippets A A warning symbol describes a possible critical situation and how to avoid it An information symbol tells you how to respond to a situation that may arise E A tip symbol tells you information that will help you carry out a procedure Where to Find More Help Go to the Ellisys website and the following pages for the latest information Ellisys products page Go to www ellisys com products for the latest product information and documentation Application notes and white papers Go to www ellisys com technology to find up to date information about the te
26. 4 6 4 7 4 8 4 9 4 of 79 Table of Contents Generator Overview Geeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeegeeeeeeeeeeeeeeeeeeeeeeeeeeeee 8 Kinga alt auie N EAA E E E AEE A E E O A E A E E 8 Main Feal U EE 8 Installing the Applicat On sssssissssessissisisoinsscrscrsisuroisssseessssnreans Y Software EE EE EE 9 SO Wal CNS allalON E 10 FROME PAlnGhO VerVIOW 42 ccecscausasensetadatnneteiesenekmnnb aes E E ia aaa 14 Back Hee EE 16 Connecting to the Control Computer 17 User Interface Reference c cccccsccssccsscssccssccsccssccsscsscssscsscsess 2U Organizing PANGS EE 21 uc o A 22 GER E 22 a oo o nn EE 24 a e e o o ee ee eee er 25 AA PP A 26 AA e E PS UU EII A 27 Advanc d Editing PCa EE 28 EE eege Eed 29 Working with BOOKMGEKS EEN 31 Working With BRCAKDOIDES uaciabulosiaies ccucyadisaeantemunaautncscenanepiatientoasGaawrsheedenxadaens 32 Soc en 33 Aula le te eo algo EE 34 ed aale geg EE 36 Language ET e Sole cite A rr er eee te ee ee er ere ere 37 Hara Wo TE 37 Constantes Declaration wcsscsnasentoussetcasronscehteceeiarvensestiusbamsnesd a aaa Eaa aie a 37 Ee Ee e E 38 PUNICTIONS ID Cell aOR e o 38 Sliele glate 39 Enumerations DEClaralONnSis cssssscckeus incaico 40 Namespace Declarations rr rr rr rr 41 PP e o ee o SP 41 ellisys 4 10 4 11 4 12 4 13 4 14 4 15 4 16 4 17 4 18 4 19 4 20 4 21 4 22 4 23 5 5 1 5 2 J3 5 4 5 5 5 6 5 7 5 8 5 9 11 12 13 14 15 16 17 18
27. ISYS PRODUCT EVEN IF ELLISYS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES SOME STATES OR OTHER JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES SO THE ABOVE LIMITATIONS OR EXCLUSIONS MAY NOT APPLY TO YOU Severability If any provision or any portion of any provision contained in these terms is held to be invalid illegal or unenforceable by a court of competent jurisdiction then the remaining provisions and if a portion of any provision is unenforceable then the remaining portion of such provision shall nevertheless remain in full force and effect The parties undertake to negotiate in good faith with a view to replace such invalid illegal or unenforceable provision or part thereof with another provision not so invalid illegal or unenforceable with the same or similar effect and further agree to be bound by the mutually agreed substitute provision Warranty Period The warranty begins on the date of purchase and covers a period of two 2 years Governing Law These conditions and terms shall be governed by and construed in accordance with the law of Switzerland Jurisdiction Venue The parties consent to the exclusive personal jurisdiction of and venue in the District Court of Geneva Switzerland 3 of 79 1 1 1 1 2 SC 2 1 2 2 2 3 2 4 2 5 3 3 1 3 2 3 3 3 4 3 5 3 6 3 7 3 8 3 9 3 10 3 11 3 12 3 13 3 14 4 4 1 4 2 4 3 4 4 4 5
28. Just me Click on Next The Confirm Installation screen appears CG Ellisys USB Explorer 280 Generator DER Confirm Installation ellisys The installer is ready to install Ellisys USB Explorer 280 Generator on your computer Click Nest to start the installation 7 Click on Next to continue the installation 12 of 79 Installing the Application ellisys An Installation Progress screen appears GG Ellisys USB Explorer 280 Generator Installing Ellisys USB Explorer 280 Generator ellisys Ellizvs USB Explorer 280 Generator is being installed Please wait Cancel When the software has been installed the Installation Complete screen appears 5 Ellisys USB Explorer 280 Generator ama Installation Complete ellisys Elizy USB Explorer 280 Generator has been successfully installed Click Close to exit Pleaze use Windows Update to check for any critical updates to the NET Framework 8 Click on Close The Ellisys USB Explorer 280 Generator is now installed ellisys Installing the Application 13 of 79 After installing the USB Explorer 280 Generator software a new Hardware Wizard will appear if your units are connected Refer to section 2 5 Connecting to the Control Computer for more information about installing the USB driver 2 3 Front Panel Overview The front panel of the Ellisys USB Explorer 280 Generator is shown below e isys USB EXPLORER 280 Analyzer and Traffic
29. Overview The back panel of the Ellisys USB Explorer 280 Generator is shown below eo FE CE rellays FOR OFFICE USE KI Inter equipment IN Rev B Trigger OUT Power Computer N Auxiliary Equipment Max 5VDC When connecting the USB cable DO NOT force the connector into the unit The metal part of the connector should not be inserted completely into the connection port Forcing the connector or inserting all of the metal part of the connector will break the port connection and is not covered by the warranty d Power DC jack power input The nearby LED illuminates constant green if a correct voltage is applied and illuminates constant red if the voltage is applied reversed Accepted Voltage Range 12V to 24V DC Minimum Power 18W 16 of 79 Installing the Application ellisys Computer Type B USB 2 0 connector Attaches to control computer Trigger OUT SMA connector used for sending TTL voltage level shift or pulse to external equipment Trigger IN SMA connector used for accepting TTL voltage level shift or pulse from external equipment Auxiliary Equipment Reserved for future extensions Inter equipment Reserved for future extensions 2 5 Connecting to the Control Computer The USB Explorer 280 Generator is controlled over a high speed USB 2 0 connection by a PC hosting the Generator application enabling the use of any notebook or desktop computer The USB driver must be installed bef
30. Unspecified 3 The example below shows a script that declares a unique number for each state of a state machine enum StateMachine Stopped Paused Eulalio Unspecified Mota malas d var currentState GetMachineState if currentState StateMachine Unspecified currentState StateMachine Stopped SetMachinestate CUurrenEState gt 40 of 79 Language Reference ellisys 4 8 Namespace Declarations Namespaces can be used to isolate some portions of code to avoid name collision in big scripts The example below shows a script that declares a namespace and then uses functions defined by this namespace namespace UtilityFunctions void WaitSpecialEvent Event Timeout e cy a void GenerateSpecialEvent Event Param 0 EE void WaitAndGenerate Event UtilityFunctions WaitSpecialEvent Event 50ms UtilityFunctions GenerateSpecialEvent Event EE yoic mano Went soeces dass 2 00m WaitAndGenerate Event The example below shows a script that declares two namespaces each with a function that has the same name 4 9 namespace TimingFunctions Os e EE EE namespace ProtocolFunctions void WaitAnswer Answerid 1 fe 254 lt 7 See Lee TimingFunctions WaitAnswer 400ms ProtocolFunctions WaitAnswer Handshake Inline bytes Inline data can be specified between square brackets This inline data can be copied to a memory buffer or use
31. WARRANTY OF NON INFRINGEMENT MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE ALL WARRANTIES WHETHER EXPRESS OR IMPLIED ARE LIMITED TO THE PERIODS OF TIME SET FORTH ABOVE SOME STATES OR OTHER JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES OR LIMITATIONS ON HOW LONG AN IMPLIED WARRANTY LASTS SO THE ABOVE LIMITATIONS MAY NOT APPLY TO YOU ELLISYS PRODUCTS ARE NOT AUTHORIZED FOR USE AS CRITICAL COMPONENTS IN LIFE SUPPORT EQUIPMENT OR FOR APPLICATIONS IN WHICH THE FAILURE OR MALFUNCTION OF THE PRODUCTS WOULD CREATE A SITUATION IN WHICH PERSONAL INJURY OR DEATH IS LIKELY TO OCCUR ELLISYS SHALL NOT BE LIABLE FOR THE DEATH OF ANY PERSON OR ANY LOSS INJURY OR DAMAGE TO PERSONS OR PROPERTY BY USE OF PRODUCTS USED IN APPLICATIONS INCLUDING BUT NOT LIMITED TO MILITARY OR MILITARY RELATED EQUIPMENT TRAFFIC CONTROL EQUIPMENT DISASTER PREVENTION SYSTEMS AND MEDICAL OR MEDICAL RELATED EQUIPMENT ELLISYS TOTAL LIABILITY UNDER THIS OR ANY OTHER WARRANTY EXPRESS OR IMPLIED IS LIMITED TO REPAIR REPLACEMENT OR REFUND REPAIR REPLACEMENT OR REFUND ARE THE SOLE AND EXCLUSIVE REMEDIES FOR BREACH OF WARRANTY OR ANY OTHER LEGAL THEORY TO THE FULLEST EXTENT PERMITTED BY APPLICABLE LAW ELLISYS SHALL NOT BE LIABLE TO THE CUSTOMER OF AN ELLISYS PRODUCT FOR ANY DAMAGES EXPENSES LOST DATA LOST REVENUES LOST SAVINGS LOST PROFITS OR ANY OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING FROM THE PURCHASE USE OR INABILITY TO USE THE ELL
32. ad of using the specified value Boolean True or False True True to replace the specified CRC bytes with the computed CRC False to leave the specified CRC bytes as Is Specifies if the link control word CRC 5 should be computed automatically by the hardware instead of using the specified value Boolean True or False True True to replace the specified CRC bytes with the computed CRC False to leave the specified CRC bytes as Is Specifies if the data packet CRC 32 should be computed automatically by the hardware instead of using the specified value Boolean True or False True True to replace the specified CRC bytes with the computed CRC False to leave the specified CRC bytes as Is 5 8 Usb30CommitData The Usb30CommitData instruction commits data previously pushed into the TX buffer to be transmitted on the wires Usb30CommitData Hardware Instructions Set Reference ellisys Parameter List Port Description Range Default Example Specifies the port on which data will be pushed UpstreamPort DownstreamPort DefaultPort BothPorts DefaultPort DefaultPort will select the port depending on the generator mode In Device mode the Upstream port will be selected while in Host mode the downstream port will be selected 5 9 Usb30WaitOrderedSet The Usb30WaitOrderedSet instruction waits for an ordered set matching the criteria specified Example Repeat Usb30WaitOrderedSet Pore gt Das sel S
33. ance navigation through the script Output Pane Shows messages about the script after compiling If there is an error in the script the Output pane will show an error description and the error s location file line and column Register Pane Shows the contents of variables used in the script Refer to section 3 14 Working with Registers for more information 20 of 79 User Interface Reference ellisys 3 1 Organizing Panes To open or display a pane 1 Select View in the menu and select the desired pane Output window Registers window The selected pane opens To close a pane 1 Click on Close positioned at the top right corner of the title bar of the pane The pane closes To hide a pane 1 Click on Auto Hide positioned at the top right corner of the title bar The pane is hidden and the pane s name now appears as a tab at the side of the screen To move a pane or a window 1 Click on the title bar of the desired pane or window 2 Depress and hold the left mouse button and drag the pane or window A window placer appears 3 Keep the mouse button depressed and point to one of the following Center to open a pane as a floating window in the screen Top to move the pane to the top of the screen or pane group Right to move the pane to the right of the screen or pane group Left to move the pane to the left of the screen or pane group Bottom to move the pane to the bottom
34. ansmit simple ordered sets such as TSEQ TS1 TS2 SKP BRST BERC BCNT etc but also any signature composed of any K or D symbol Example Usb30PushRawData POLT USE OLT Rawat a gt COM COM COM COM 0 DES DLO 2 DLO 2 DLO 27 DILOR TEDIN O NONN COUNT gt 32 Use O onmi eoa aO a a ea a e eE 56 of 79 Hardware Instructions Set Reference ellisys Parameter List Port Description Specifies the port on which data will be pushed Range UpstreamPort DownstreamPortL Defa ltRort BothPorts Default DefaultPort Example DefaultPort will select the port depending on the generator mode In Device mode the Upstream port will be selected while in Host mode the downstream port will be selected RawData Description Raw data to be sent Type Inline bytes Default No default value this parameter is mandatory Count Description Range Default Specifies how many times the specified raw data must be repeated 0 TO 42 294 967 295 1 5 6 Usb30PushLinkCommand The Usb30PushLinkCommand instruction commits a link command into the TX FIFO of the generator Usb30CommitData Instruction Example UsbsUPusnilaakConmand Pome gt Dos ream ort RawData gt 0x01 0x02 l EE gt true Usb UCCimiiE Daca Des valio des EH ee EES ellisys Hardware Instructions Set Reference The link command can then be committed to be transmitted by using the 57 of 79 Parameter List Port Descr
35. c generator O Constant green Unit is in use Off Unit is not in use and available Trigger LED The Trigger LED indicates input and output trigger events Flashing green Trigger event detected on the input Flashing red Trigger event generated on the output Off No trigger event Link LED The Link LED indicates the status of the generator s upstream and downstream ports Depending on the generator s state a port may be used or not Here are the ports used by the generator depending on the mode Host mode Only the Downstream port is used Device mode Only the Upstream port is used Hub mode Both Upstream and Downstream ports are used Off No receiver detected O Constant orange Receiver detected no SuperSpeed signaling detected Constant green SuperSpeed signaling detected receiver synchronized gt Ki Y Flashing red Link is unstable frequent loss of synchronization Li ellisys Installing the Application 15 of 79 Receive LED The Receive LED indicates if payload Data Packets or errors CRC invalid symbols are received on a given port Off No payload or errors detected Y Flashing green Payload detected e N Flashing red Errors detected dech amp Transmit LED The Transmit LED indicates if payload DPP or errors CRC invalid symbols are transmitted on a given port Off No data sent e O Flashing green Data Packet sent NY 2 4 Back Panel
36. chnology Distributors Go to www ellisys com sales to find a list of Ellisys distributors Technical support Go to www ellisys com support to send a question directly to the Ellisys support team ellisys Generator Overview 7 of 79 1 Generator Overview 1 1 Introduction The Ellisys USB Explorer 280 Generator is an advanced traffic generation and emulation system for SuperSpeed USB 3 0 and USB 2 0 protocols The Generator verifies product and component functionality reliability and performance by generating reproducible traffic patterns timing scenarios and various types of errors The Generator contains a specialized processor designed specifically for SuperSpeed USB and USB 2 0 protocols allowing for very fast timing interaction with the connected Device Under Test DUT The processor s instruction set enables the user to emulate any SuperSpeed system component such as a host or device The Generator is capable of sending any sequence of packets link commands or symbols The Generator recognizes incoming traffic and can make script based decisions on this traffic such as conditional branching or wait states The Generator s software application enables the user to create edit and debug scripts Traces previously captured by the Ellisys USB Explorer 280 Analyzer can be exported to a script and replayed by the Generator 1 2 Main Features The Generator includes the following major features and capabilities
37. cus on higher protocol layers Example ConfigureLink Doa gt DownstreamPort in txAutoHandleLinkAck gt true in txAutoHandleLinkCredit gt true in txAutoComputeHeaderSeqNum gt true Rrno lank ae o U0 SC This will send out automatically the Link Advertisement ConfigureLink in Port gt DownstreamPort io TrxAuTosendlimkAck gt true in rxAutosendLinkCredit gt true Parameters Port Description Specifies the port to be configured Range UpstreamPort DownstreamPort BothPorts Default BothPorts ellisys Hardware Instructions Set Reference 53 of 79 rxAutoSendLinkAck Description Range Default Configures the generator to automatically send link acknowledges Lgood_N Lbad on reception of header packets Boolean True Or False False rxAutoSendLinkCredit Description Note Range Default Configures the generator to automatically send link credits Lcrd_X on reception of packets If turned on the Lcrd_X will be sent out when the packet is handled in the script by the Usb30WaitPacket instruction Boolean True Or False False rxAutoSendLinkPolling Description Range Default Configures the generator to automatically send link pollings LUP or LDN depending on the destination port as required Boolean True Or False False txAutoHandleLinkAck Description Note Range Default Configures the generator to automatically handle link acknowledges Lgo
38. d with instructions parameters Inline data is the most efficient way of providing data to a parameter because it does not require going through the buffer memory ellisys Language Reference 41 of 79 EE co el 0 DE CopyMemory See gt 0x00 0x00 l Dat gt Burrer 200 for 4 10 Buffers The hardware contains a buffer of 8192 bytes available for memory comparison and copy operations It can be accessed with the Buffer keyword for reading as well as for writing msi o eS Oe I EE Buffer 0 for 4 CounterB Counter Burter 10 tor 4 The last received packet can be accessed with the Usb30LastRxPacket keyword Usb30astRxPacket IS read only Burrer Z to Counters UsbsllastRxPacker to Councert CounterC Usbs0MastRxPacket ale 4 11 Counters Counters are useful for example to count errors special conditions etc Several counters are available in the generator namely CounterA tO CounterH The value of the counters is indicated in the Registers window The example below shows a script that repetitively sends a pulse on the Trigger Out connector and waits for a rising edge on the input Trigger In If the rising edge is not detected within 500 milliseconds the script increments CounterA repeat 1000 GenerateTriggerOut Mode gt PuUlSehigh WaitTriggerlIn Condievom gt RisingEdge Timeout gt 500ms 1 TimeoutOccurred Keep the error count in CounterA CounterAtt
39. e ellisys But also any invalid or malformed packet A RawData length of 16 bytes will send a single Header Packet additional bytes specified will be sent in a succeeding data packet payload DPP Example Usb30PushPacket ROTE gt Nese eS HE RawData gt 0x04 0x00 0x00 0x00 0x01 EE EE ENEE 0x00 0x00 0x007 0x007 Oc o EE RE J ComputeHeaderCre gt true COompurelewcre gt CLUS ComputeDataCrc Ele WS BSUtCo mite Dave will be c rann eed ter this Parameter List Port Description Range Default Example RawData Description Type Default Example ellisys Specifies the port on which data will be pushed UpstreamPort DownstreamPort DefaultPort BothPorts DefaultPort DefaultPort will select the port depending on the generator mode In Device mode the Upstream port will be selected while in Host mode the downstream port will be selected Raw data of the packet to be sent Inline bytes or Buffer No default value this parameter is mandatory 0x01 0x22 OxFF to use these bytes for the instruction Buffer 0 for 16 to use bytes from the user buffer Hardware Instructions Set Reference 59 of 79 60 of 79 ComputeHeaderCrc Description Type Default Example ComputeLcwCrc Description Type Default Example ComputeDataCrc Description Type Default Example Example Specifies if the header CRC 16 should be computed automatically by the hardware inste
40. eakpoints in a script Opens the Available Generators window Opens the Ellisys website in the default browser Opens a form in the default browser to contact Ellisys technical support Checks online for the latest software version Opens the About window Select File Open in the menu or click on Open Document 7 24 0f 79 User Interface Reference ellisys The Open File menu appears Lookin ES O Recent El Sample_TrainingOrderedSets u30s Kl Sample_TransmitLargePacketContinuously u30s e fell Sample_UasTrafficHost ndDevice u30s TJ Desktop Mu Documents Computer Mu Network Files of type All Ellisys USB 3 0 Generator Files TP 1305 ual ze 1 Select the file required and click Open The selected file opens in the software 3 5 Saving a File To save a file 1 Select File Save in the menu or click on Save Document al The file is saved To save a file with a new name Select File Save As in the menu ellisys User Interface Reference 25 of 79 The Save As menu appears Save fis Soren TES ae Sample _MassStorageTrafficHost4ndDevice u30s S KH Sample_TrainingOrderedSets u30s Recent ed Sample TransmitLargePacketContinuously u30s tel Sample_LlasTrafficHostAndDevice W305 a K UasCommon USOsinc hel Usb30Common u3Osine EE Lish30Packets u30sinc ae UsbExplorer2 0 u30sinc ae UsbFrameworkCommon us0sinc Desktop File name MyScript 11303 k Mu Network Save az hy
41. ed from the Use drop down list a Wildcard list appears Find and Replace Sg Quick Find Find what Zero or more of any character Any single character As Quick Replace Find options Any single digit Match case Search hidden text Any one character in the set C Match whole word Search in selection Search up v Use wildcards wi Bookmark All 1 any one character not in the set 5 Select the Wildcard desired If Regular expressions has been selected from the Use drop down list a Regular expressions list appears Find and Replace Quick Find Quick Replace Find what Any single character Zero or more Find options One or more Match case Search hidden text F Match who 4 Os EE Beginning of line atch whole Wor earch in selection End of line L_ Search up UD Word boundary Use Regular expressions w Le Whitespace um Line break Find Next Bookmark All Any one character in the set Any one character not in the set Or Escape special character 6 Select the Regular expression desired 7 Select the desired Find Options check boxes 8 Click on Find Next to find the next occurrence or click on Bookmark All to bookmark all occurrences The selected search is performed To replace text 1 Click on Find Replace FA and then click on Quick Replace or Select Search Replace in the menu or press CTRL H 30 of 79 Us
42. elect Edit Bookmarks Previous Bookmark in the menu A flashing cursor appears beside the previous bookmark To remove all bookmarks 1 Click on Clear Bookmarks or Select Edit Bookmarks Clear Bookmarks in the menu All bookmarks in the script are removed 3 11 Working with Breakpoints A breakpoint is a point in a program which is used to temporarily halt the execution of that program To insert a breakpoint 1 Select a line where the breakpoint is to be inserted 2 Select Script Toggle Breakpoint in the menu or Press F9 32 of 79 User Interface Reference ellisys A breakpoint is inserted beside the selected line Sample_UVasTrafficHostAndDevice u30s Ellisys USB 3 0 Generator File Edit View Search Script Help adan A BH Sample_UasTrafficHostAndDevice u30s 1 IA AAA Z UAS SendCdbRead tag logicalBlockiddress transferLength SendCdbRead tag logicalBlockiddress transferLength SendCdbWrite tag logicalBlockiddress transferLength O SendCdblWrite ta g logicalBlockiddress re wmts w Tv A Output Message y Compilation succeeded 0x0001 0x00000028 0x0008 8 blocks a block is 512 bytes OxDOD2 0x00000030 0x0008 OxDOD3 OxD0000038 0x0008 0x0004 0x00000040 s Menor e q X Registers Column Name To remove all breakpoints Stopped LnS Col5 ch2 1 Select Script Clear All Breakpoints in the menu or Press CTRL SHFT F9
43. ellisys Better Analysis USB Explorer 280 Generator User Manual PROTOCOL TEST Version 1 3 l n Adore 19 2009 e I S y S Copyright Confidentiality and Disclaimer Statements While the information in this publication is believed to be accurate Ellisys makes no warranty of any kind to this material including but not limited to the implied warranties of merchantability and fitness for a particular purpose Ellisys shall not be liable for any errors contained herein or for incidental or consequential damages in connection with the furnishing performance or use of this material No part of this publication may be reproduced stored in a retrieval system or transmitted in any form or by any means photocopying recording or otherwise without prior written consent of Ellisys No third party intellectual property right liability is assumed with respect to the use of the information contained herein Ellisys assumes no responsibility for errors or omissions contained in this book This publication and features described herein are subject to change without notice Copyright C Ellisys 2009 All rights reserved All products or services mentioned in this manual are covered by trademarks service marks or product names as designated by the companies who market those products This manual is populated throughout with screens captured from a specific version of Ellisys Protocol Analyzer software All the information contained
44. er Interface Reference ellisys The Find Replace menu appears Find and Replace Replace with Triggered Ke Find options Match case Search hidden text Match whole word Search in selection Search up Use Replace Al 2 Enter the desired search text the Find what field 3 Enter the replacement text in the Replace with field 4 Select the desired Find options check boxes 5 Click on Find Next to find the next occurrence or click on Replace or Replace All to replace the next occurrence or all occurrences The selected replacement is performed 3 10 Working with Bookmarks A bookmark is a useful tool that allows for marking lines of code to assist the user in navigating through the script All bookmark options can be accessed by selecting Edit Bookmarks in the menu To toggle a bookmark 1 Select a line where the bookmark is to be inserted Click on Toggle Bookmark L or Select Edit Bookmarks Toggle Bookmark in the menu The bookmark is inserted beside the selected line To enable a bookmark 1 Click on the line beside the bookmark Select Edit Bookmarks Enable Bookmark in the menu ellisys User Interface Reference 31 of 79 The selected bookmark is enabled To move to the next or previous bookmark 1 Click on Next Bookmark or Select Edit Bookmarks Next Bookmark in the menu A flashing cursor appears beside the next bookmark Click on Previous Bookmark 27 or S
45. gisters ellisys Example void WaitPacketFromAddr in devAddr Ee d Usb30WaitPacket eene gt lr tec ime OLT Timeout gt 500ms if MatvehOccurred if Usb30LastRxPacketDevAddr devAddr OK we got a packet from the expected device exit 6 5 Usb30LastRxPacketEpNum This register contains the endpoint number field extracted from the last received packet field is not applicable for the received packet then the field is reset to O Example void WaitPacketFromEndpoint in devAddr in epNum Spec d Usb30WaitPacket POLE gt UPSC LEIAME OLT Timeout gt 500ms if MatehOccurred if Usb30LastRxPacketDevAddr devAddr S Usb30LastRxPacketEpNum epNum OK we got a packet from the expected endpoint number EE 6 6 Usb30LastRxPacketNumP If the This register contains the NumP number of packets field extracted from the last received packet If the field is not applicable for the received packet then the field is reset to 0 6 7 6Usb30OLastRxPacketPayloadLength This register contains the length field extracted from the last received packet ellisys Special Registers 75 of 79 Example WaitPacketType Usb30PacketType DataPacketHeader I Copy tche last PRX packet payload to the Buler at offset 0 Buffer 0 for Usb30LastRxPacketPayloadLength Eer 6 8 Usb30LastRxPacketParams This register contains some bit fields extracted from the last received packet Thi
46. iated with the var keyword Variables can be initialized at declaration with a value If no initial value is specified the variable will not be initialized Vat ny Vai Ie var myvar2 10 var myVar3 CounterB var myVar4 myVarl myVar2 Unlike with C language there is no restriction on the location of a variable declaration Variables can be declared anywhere in the script The scope of the variable depends on the declaration location var myGlobalVar D Se Mac oO lobala ar O void main E var myVar 10 COL var aie aL OS LIP My vas LS Sleep myVar 4 5 Functions Declaration Functions can be used to save typing and improve the understanding of a script Functions accept parameters and can optionally return a value Optionally parameters can be prefixed with qualifiers such as in out Or inout The purpose of these qualifiers is to ensure the user of the function will correctly pass parameters 38 of 79 Language Reference ellisys The example below shows a script that defines a function for sending a trigger pulse and waiting until an answer is received void SendPulseAndWaitAnswer in maxRetries in maxTime repeat maxRetries GenerateTriggerOut Mode gt PulseHigh WaitTriggerln Condition Rising Edge Timeout gt maxTime 1f TimeoutOccured exit void Main SendPulseAndWaitAnswer 10 2s SendPulseAndWaitAnswer 100 20ms SendPulseAndWaitAnswer
47. ion generates a condition on the Trigger Out SMA connector located on the rear of the unit Example GenerateTriggerOut Mode Parameter List Mode Description Range Default Example gt PulseHigh Specifies the trigger mode PulseHigh PulseLow ForceHigh ForceLow Toggle No default value this parameter is mandatory PulseHigh generates a positive pulse on the output ForceLow forces a low level logic low or 0 on the output Toggle inverts the current level of the output 72 of 79 Hardware Instructions Set Reference ellisys 6 Special Registers Special Registers can be used to manage the progression of a script by examining or monitoring the content of these registers 6 1 Usb30NextTxHeaderSeqNum This register stores the Header Sequence Number that will be transmitted in the next Header Packet LCW when the Header Sequence Number is computed automatically by the hardware The txAutoComputeHeaderSeqNum parameter of the ConfigLink Instruction must be set to true for this purpose This register is incremented to one for each successfully transmitted packet This register can be written to reset the Header Sequence Number after a reset or to create a Sequence number violation Example Contiogucelank in txAutoComputeHeaderSeqnum gt CEUS Usb30NextTxHeaderSegqnum 0 UsboevSendPacket EE OxX04 O00 C00 O20 Wile REES Ox00 0x00 0x00 gt 0x00 0xFB 0x3C 0x0 0xES UsbsvSendbPacket 77
48. iption Specifies the port on which data will be pushed Range UpstreamPort DownstreamPort DefaultPort BothPorts Default DefaultPort Example DefaultPort will select the port depending on the generator mode In Device mode the Upstream port will be selected while in Host mode the downstream port will be selected RawData Description Raw data of the 16 bit link command link command word to be sent Note If the CRC 5 is computed by the generator the specified CRC 5 value is not relevant and will be overwritten Type Inline bytes or Buffer Default No default value this parameter is mandatory Example 0x01 0x02 to use these bytes for the instruction Buffer 0 for 2 to use bytes from the user buffer ComputeCrc Description Specifies if the CRC should be computed automatically by the hardware instead of using the specified value Type Boolean True or False Default True Example True to replace the specified CRC bytes with the computed CRC False to leave the specified CRC bytes as Is 5 7 Usb30PushPacket The Usb30PushPacket Instruction commits a packet into the TX FIFO of the generator The packet can then be committed to be transmitted by using the Usb30CommitData Instruction Any kind of packet can be transmitted by using this instruction Link Management Packets LMP Transaction Packets TP Data Packets DP Isochronous Timestamp Packets ITP 58 of 79 Hardware Instructions Set Referenc
49. isys USB Explorer End User License Agreement READ CAREPULLY This End User License Agreement EULA is a legal agreement between you either an manadual person or a single legal entity who will be referred to in the following as you and Ellisys In the following this product refers to the software displaying this agreement accompanying sofware associated print and electronice documentation as well as sofware updates web based materials and 1 Do Not Agree 3 Read the License Agreement carefully and then select I Agree 4 Click on Next The Select Installation Folder screen appears GG Ellisys USB Explorer 280 Generator Select Installation Folder ellisys The installer wll install Ellizys USB Explorer 280 Generator to the following folder To install in this folder click Nest To install to a different folder enter it below or click Browse Folder C Program Files E lieys E leys USE Explorer 80 Generator Disk Cost Install Ellisys USB Explorer 260 Generator for yourself or for anyone who uses this computer ellisys Installing the Application 11 of 79 5 The default installation folder appears in the Folder field Ellisys recommends that you use the default folder however if you wish to change this folder click on Browse and navigate to the folder required 6 Select whether anyone or only the user currently logged on can access the software by selecting either Everyone or
50. isys generator contains a set of instructions implemented in hardware These hardware instructions are then integrated into higher level functions in order to achieve a complex task The higher lever functions are then grouped into libraries and supplied in full source code so it is easy to understand the behavior and alter it if needed Only the hardware instructions are fully documented here the higher level functions being supplied in source code Hardware instructions and functions have exactly the same syntax so it may not be easy to distinguish between both Hardware instructions are listed in this chapter All other functions are then just a group of several instructions to achieve a more complex task 5 2 ConfigureGenerator The ConfigureGenerator Instruction applies various commonly used parameters to a Script and must be called at the start of the script This instruction can be called later in a script in order to change the settings of a given parameter All parameters in this instruction are optional If a given parameter is not defined the value is not changed Example ConfigureGenerator in mode gt GeneratorMode Host in rxScramblerBypassed gt false rin rxobl0bBypassed gt false ia rxLanePolarity gt LanePolarity Normal in txEnableTransceivers gt false in txScramblerBypassed gt false in tx8b10bBypassed gt false in CxLanePolarity gt LanePolarity Normal in txAutoComputeCrcs gt true in t
51. kCommand This register can be written to set the next LCRD index to be sent at the desired value ellisys Special Registers 77 of 79 6 12 Usb30I mmediateLinkCommand This register enables sending link commands with no delay for managing link commands manually This register is a bit field and writing a one to a bit send out immediately the corresponding link command The link command is sent in priority independently of the TX FIFO content This is the main difference with the Usb30PushLinkCommand which goes through the TX FIFO and is thus sent in sequence with the other TX FIFO items This register is formatted as follow Bit 0 Send LGOOD_N A LGOOD will be sent with the current index and the index will be then incremented by one Bit 1 Send LCRD_X A LCRD will be sent with the current credit index and the credit index will be then incremented by one Bit 2 Send LDN LUP Bit 3 Send LBAD Bit 4 Send LRTY The following constants are defined in the standard Ellisys include files for convenience const Usb30ImmediateLinkCommandNextLgood Osc 00 OO O const Usb30ImmediateLinkCommandNextLceredit t 0x00000002 const Usb30ImmediateLinkCommandPolling 0x00000004 const Usb30ImmediateLinkCommandBad 0x00000008 const Usb30ImmediateLinkCommandRetry O00 COOOL Several bits can be written to 1 at the same time for example for sending LGOOD LCREDIT in a unique write Example void Usb30LinkAdvertisement
52. l WaitOrderedSetTseq gt true WaitOrderedSetTsl gt true WaitOrderedSetTs2 gt false WaitOrderedSetBrst gt false WaitOrderedSetBerc gt false WaitOrderedSetBcnt gt false WaitOrderedSetLinkCmd gt false Timeout gt 500ms ii Mat ehnOceurred OK we got either a TSEQ or TS1 proceed to next step exit Parameter List Port Description Range Default Example ellisys Specifies the port on which data will be waited UpstreamPort DownstreamPort DefaultPort DefaultPort Default will select the port depending on the generator mode In Device mode the Upstream port will be selected while in Host mode the downstream port will be selected Hardware Instructions Set Reference 61 of 79 Description Specifies if a TSEQ ordered set will match Type Boolean True or False Description Specifies if a TS1 ordered set will match Type Boolean True or False Description Specifies if a TS2 ordered set will match Type Boolean True or False Description Specifies if a BRST ordered set will match Type Boolean True or False Description Specifies if a BERC ordered set will match Type Boolean True or False Description Specifies if a BCNT ordered set will match Type Boolean True or False 62 of 79 Hardware Instructions Set Reference ellisys Timeout Description Type Range Default Example Timeout after which the instruction is aborted Time expressed i
53. llowing mathematical operators ty gt e amp e gt gt and lt lt The examples below show how to use these operators and how to combine them In all these examples a must be a variable b and c can be variables or a literals The following example assigns the value 20 to a a 20 The following example assigns the value OxAB12 43 794 in decimal to a a E The following example adds the value of b to the value of c and assigns the result to a cle E ellisys Language Reference 4 7 of 79 The following example subtracts the value of c from the value of b and assigns the result to a EN Os C The following example multiplies the value of b with the value of c and assigns the result to a aa One me The following example divides the value of b by the value of c and assigns the result to a n oe The following example divides the value of b with the value of c and assigns the rest of the integer division to a The following example performs a mathematical AND operation between the value of b and the value of c and assigns the result to a IO The following example performs a mathematical OR operation between the value of b and the value of c and assigns the result to a The following example performs a mathematical XOR operation between the value of b and the value of c and assigns the result to a The following example performs a right shift operation between the value of b and the value of c
54. mented KA 2 Click on Uncomment Selection or select Edit Advanced Uncomment Selection in the menu Comment markers are removed from the selected lines To change text case 1 Select the desired text in the script 28 of 79 User Interface Reference ellisys 2 To change lowercase to uppercase select Edit Advanced Make Uppercase to change the text s case from lowercase to uppercase or press CTRL SHFT U Or 3 To change uppercase to lowercase select Edit Advanced Make Lowercase to change the text s case from lowercase to uppercase or press CTRL U 3 9 Searching Search find and replace options can be accessed by clicking Search in the menu To search text Click on Find Replace HA or select Search Find in the menu or press CTRL F The Find Replace menu appears Find and Replace z Quick Find 45 Quick Replace Find options C Match case Search hidden text C Match whole word Search in selection C Search up Use Bookmark All 1 Enter the desired information in the Find what field or 2 Select the Use box to use Regular expressions or Wildcards LL Regular expressions or Wildcards can be selected as an option 3 If the Use box is checked select Regular expressions or Wildcards from the drop down list The Right Arrow beside the Find what field becomes enabled 4 Click on the Right Arrow gt ellisys User Interface Reference 29 of 79 If Wildcards has been select
55. n Type Range Default Example TimingRespect Description Range Default Example Index of the countdown timer O to 2 0 Timeout after which the instruction is aborted Time expressed in seconds O to 34 36 seconds with a precision of 8 nanoseconds No default value this parameter is mandatory 1 32ms means 1 320 microseconds 10ns will be floored down to 8 nanoseconds Specifies if the processor breaks if the countdown value was already reached at the time the wait was called Soft or Hard Soft Soft to continue even if the countdown value was already reached Hard to break script execution if the countdown value was exceeded This value Hara helps detecting timing errors in scripts 5 16 ConfigureTimer The ConfigureTimer instruction configures specific aspects of the timer instructions Example TimerO 0 ConfigureTimer Index gt 0 Prescaler gt 1 024m3 Stare Limer Index gt Gomer Dan o Sl2 Ee DoDataTransfer DataTransferSize StopTimer Index gt 0 var readThroughputInKBps DataTransferSize Timer0O Hardware Instructions Set Reference 6 7 of 79 ellisys Parameter List Index Description Type Default Prescaler Description Range Default Example Overflow Description Range Default Example Specifies the index of the timer to configure o to 2 No default value this parameter is mandatory Specifies how many clock counts are
56. n seconds O to 34 36 seconds with a precision of 8 nanoseconds No default value this parameter is mandatory 1 32ms means 1 320 microseconds 10ns will be floored down to 8 nanoseconds 5 10 Usb30WaitPacket The Usb30WaitPacket Instruction waits for a USB 3 0 packet for further processing Example void WaitPacketType in packetType oss EE Usb30WaitPacket POLCE gt D r EE Timeout gt 500ms if MatchOccurred if Usb30LastRxPacketType packetType OK we got a packet of the expected type exit Parameter List Port Description Specifies the port on which data will be waited Range UpstreamPort DownstreamPort DefaultPort Default DefaultPort Example DefaultPort will select the port depending on the generator mode In Device mode the Upstream port will be selected while in Host mode the downstream port will be selected ellisys Hardware Instructions Set Reference 63 of 79 Timeout Description Type Range Default Example Timeout after which the instruction is aborted Time expressed in seconds O to 34 36 seconds with a precision of 8 nanoseconds No default value this parameter is mandatory 1 32ms means 1 320 microseconds 10ns will be floored down to 8 nanoseconds 5 11 HostConfigureBusPowerSource The HostConfigureBusPowerSource Instruction configures the bus power source when the generator is configured as host The generator has the ability to supply the
57. needed to increment the timer value This is helpful for extending the range of a timer if the default range is not enough 0 to 4294967295 No default value this parameter is mandatory 1 will cause one clock count to increment the specified timer 10 will result in a timer range of O to 343 6 seconds instead of 34 36 with a precision of 80 ns instead of 8 ns Specifies the value at which the timer will restart at zero O to OxFFFFFFFF No default value this parameter is mandatory 000000FF will use force a restart after 256 clock counts 5 17 StartTimer The StartTimer instruction starts the specified timer Example Spec ler 1 68 of 79 Hardware Instructions Set Reference ellisys Parameter List Index Description Specifies the index of the timer to start Type O to 2 Default No default value this parameter is mandatory 5 18 StopTimer The StopTimer instruction stops the specified timer Example Sic Ojo lies 1 Parameter List Index Description Specifies the index of the timer to stop Type O to 2 Default No default value this parameter is mandatory 5 19 WaitTimer The WaitTimer instruction waits until the specified timer reaches the specified value Example WaitTimer Index gt l TargetValue gt 60s Parameter List I ndex Description Specifies the index of the timer to wait on Type O to 2 Default No default value this parameter is mandatory ellisys
58. od_N Lbad on transmission of Header Packets If turned on the generator will wait for the link acknowledge after transmission of a packet with Usb30PushPacket Usb30CommitData If Lbad is received the generator will automatically issue a Lretry and retransmit the Header Packet Boolean True Or False False 54 of 79 Hardware Instructions Set Reference ellisys txAutoHandleLinkCredit Description Configures the generator to automatically handle link credits Lcrd_X on transmission of Header Packets Note If turned on the generator will keep track of the Remote Rx Header Buffer Credit If the script is sending data faster than the remote port can accept packets transmissions will be paused waiting for new available credits Range Boolean True or False Default True txAutoComputeHeaderSeqNumber Description Configures the generator to automatically compute header sequence numbers within the link control word of transmitted header packets Note If turned on the header sequence number specified in header packets IS not relevant and will be overwritten by the generator Range Boolean True Or False Default True txAutoHandlel tp Description Configures the generator to automatically handle ITPs These packets will be then no more available in the RX FIFO Note This function is especially useful for upstream ports The user script is then independent of ITPs and can focus on useful packets Range Boolean True o
59. ore the Generator can be used O Although the unit can upload or download data on a full speed USB 1 1 connection Ellisys strongly recommends that you connect it to a high speed USB 2 0 port to obtain optimal performance If you experience problems with the USB Explorer 280 please ensure it is connected on a high speed USB 2 0 enabled host controller before contacting technical support Follow the steps below to install the USB driver 1 Connect a USB 2 0 cable between the Type B USB receptacle Generator back panel and the PC If attaching the Generator for the first time wait until Windows displays a message indicating that a new device has been found typically a small bubble indication at the lower right of the screen then go to step 3 2 If you want to update a previously installed device driver Open the Device Manager Start Control Panel Double Click the System icon Click on the Hardware tab Click on Device Manager Click on Ellisys protocol analyzers Right click and select Update Driver ellisys Installing the Application 17 of 79 The Hardware Update Wizard opens Hardware Update Wizard Welcome to the Hardware Update Wizard Windows will search for current and updated software by looking on your computer on the hardware installation CD or on the Windows Update Web site with your permission Read our privacy policy Can Windows connect to Windows Update to search for sofware O Yes
60. pe All Ellisys USB 3 0 Generator Files TT u ls ual ze 1 Navigate to the directory where the file is to be saved 2 Enter the desired name of the file in the File name field and click on Save The file is saved with the modified name and the original file is not modified 3 6 Printing a File Use the Page Setup option File Page Setup to setup how the file should be printed This option will depend on the printer please see your printer s documentation for more information LL A file can be very large therefore it is advisable to check the size of the file before trying to print the file To print a file 1 Select File Print in the menu or click on Print a 26 of 79 User Interface Reference ellisys The Print window appears Printer Name Microsoft XPS Document Writer wi Status Ready Type Microsoft PS Document Wnter Where Sot Comment _ Print to file Print range Copies Number of copies 1 E Selection pl pel 2 Select the printer and printer setup if required 3 Click on OK The file is printed 3 7 Editing a Script The SuperSpeed Explorer 280 Generator includes several specialized instructions Example code for these instructions can be inserted to assist in writing scripts An example code is called a code snippet A full description of specialized instructions can be found in Chapter 5 Hardware Instructions Set Reference To insert a code snippet 1 Click on the point
61. r False Default alte txAutoHandleLmp Description Configures the generator to automatically handle LMPs These packets will be then no more available in the RX FIFO Note This function is especially useful for upstream ports The user script is then independent of LMPs and can focus on useful packets Range Boolean True Or False Default Tre ellisys Hardware Instructions Set Reference 55 of 79 5 4 Usb30DetectRxTerminations The Usb30DetectRxTerminations instruction determines whether a receiver is present on the far end of the link with respect to the generator s transmitters either upstream or downstream Example Wait Remote Port Terminations repeat IHR e x le cit EE os Oe at MacchoOccecurrech Term detected proceed to next step exit Sleep 6ms J Next LISM SE PSr Parameter List Port Description Specifies on which port the Receiver Detection should be done Range UpstreamPort DownstreamPort DefaultPort BothPorts Default DefaultPort Note DefaultPort will select the port depending on the generator mode In Device mode the Upstream port will be selected while in Host mode the downstream port will be selected 5 5 Usb30PushRawData The Usb30PushRawData instruction commits raw data symbols any K or D type into the TX FIFO of the generator The data can then be committed to be transmitted by using the Usb30CommitData Instruction This instruction can be used to tr
62. r replace any part of its products that prove defective by reason of improper workmanship or materials Repaired parts or replacement products will be provided by Ellisys on an exchange basis and will be either new or refurbished to be functionally equivalent to new If Ellisys is unable to repair or replace the product it will refund the current value of the product at the time the warranty claim is made In no event shall Ellisys liability exceed the original purchase price of product Excluded Products and Problems This limited warranty does not cover any damage to this product that results from improper installation accident abuse misuse natural disaster supply mechanical or environmental conditions or any unauthorized disassembly repair or insufficient or excessive electrical abnormal modification This limited warranty also does not apply to any product on which the original identification information has been altered obliterated or removed has not been handled or packaged correctly or has been sold as second hand This limited warranty only applies to the original customer of the product for so long as the original customer owns the product This limited warranty is non transferable This limited warranty covers only repair replacement or refund for defective Ellisys products as provided above Ellisys is not liable for and does not cover under warranty any loss of data or any costs associated with determining the so
63. s register is a bit field formatted as follow Bit O End of Burst Bit 1 Endpoint Direction Bit 2 Setup TP Bit 3 Retry Data Packet The following constants are defined in the standard Ellisys include files for convenience const Usb30LastRxPacketParamsEndOfBurst 0x00000001 const Usb 0lastRxPackectraramsendpoineDit rection gt Cxd0000002 const Usb30LastRxPacketParamsIsSetup 0x00000004 const Usb30LastRxPacketParamsRetryDataPacket 0x00000008 6 9 Usb30LastRxPacketErrors This register contains the errors detected during the last packet reception This register is a bit field formatted as follow Bit 0 Header Error Any error in the HP only such as a Not enough symbols header aborted by another ordered set b Unexpected symbol such as K instead of D c Symbol error such as 10b 8b decoder error d Header CRC 16 error e LCW CRC 5 error Bit 1 Packet Error Any error in the whole packet including DPP such as f Any HP error as described above g DPP not back to back of HP h Unexpected symbol such as K instead of D 76 of 79 Special Registers ellisys Bit 2 Type Error Type field is unknown Bit 3 Payload CRC 32 Error The CRC 32 of the DPP is incorrect Bit 4 Payload Length Mismatch The length field and the actual DPP received length are not equal The following constants are defined in the standard Ellisys include files for convenience Conse UsSb30hastRxPackelLbrroersHeaderhrror
64. sult in the receiver reversing the incoming wires txEnableTransceivers Description Range Example ellisys Specifies whether the transmitter will be enabled or disabled Boolean True or False True will enable the transmitter which will then transmit DO O symbols continuously by default or other symbols when specified False will disable the transmitter which will drive the TX lines with electrical idle Hardware Instructions Set Reference 51 of 79 txScramblerBypassed Description Specifies whether the traffic sent by the generator will be scrambled or not scrambled Range Boolean True or False Example False will result in transmission of scrambled symbols True will result in transmission of non scrambled symbols tx8b10bBypassed Description Note Range Example txLanePolarity Description Specifies whether the traffic sent by the generator will go through the 8b 10b encoder This is an advanced parameter and should only be set to True for specific testing Boolean True or False False will result in transmission of encoded 10b symbols True will result in transmission of raw 10b symbols Specifies whether the traffic sent by the generator will be polarity reversed or normal polarity Range LanePolarity Normal or LanePolarity Inverted Example Normal will result in the transmitter not reversing the polarity Inverted will result in the transmitter reversing the outcoming wires
65. tion Conditions are described in section 4 23 Conditional Expressions 44 of 79 Language Reference ellisys The example below shows a script incrementing CounterA if the button is pressed and CounterB otherwise When CounterA reaches 10 CounterB is reset to 0 WaitButton Index gt 0 Timeout gt Oms Condition gt HighLevel if MatchOccurred CounterAtt else i Counter Emm if CounterA gt 10 CounterB 0 4 17 Switch Statement The switch statement executes instructions conditionally depending on the value of the specified variable The example below shows a Script incrementing CounteraA if the value of the variable is O increments CounterB if the value is 1 and resets both to zero in other cases Swiech Counter case 0 CounterAtt break Case 1 COounterB break default CounterA CounterB 0 break e 4 18 Repeat Statement The repeat statement executes instructions the specified count of times A repeat statement can be stopped with the exit keyword ellisys Language Reference 45 of 79 The example below shows a script that pulses high the state of the Trigger Out connector for 200 milliseconds every second It does this 10 times repeat 10 GenerateTriggerOut Mode gt ForceHigh Sleep 200ms GenerateTriggerOut Mode gt ForceLow Sleep 800ms 4 19 While Statement The while statement executes instructions
66. tion about updating Microsoft NET Framework and Windows ellisys Installing the Application 9 of 79 2 2 Software Installation 1 Insert the CD ROM that accompanies the product into the computer s CD ROM drive The Ellisys SuperSpeed USB 280 Generator Setup Wizard screen appears T Ellisys USB Explorer 280 Generator Welcome to the Ellisys USB Explorer 280 Generator Setup Wizard ellisys The installer wll guide you through the steps required to install Ellisys USB Explorer 280 Generator on pour computer WARNING This computer program is protected by copyright law and international treaties Unauthorized duplication or distribution of this program or any portion of it may result in severe civil or criminal penalties and will be prosecuted to the masimum extent possible under the law Cancel If the SuperSpeed USB 280 Generator Setup Wizard does not appear automatically click the START button on your Windows toolbar then RUN and type d setup exe change d to match the drive letter designation of your CD ROM drive as needed then click OK 2 Read the WARNING note and click on Next 10 of 79 Installing the Application ellisys The Ellisys USB Explorer 280 License Agreement screen appears ie Ellisys USB Explorer 280 Generator License Agreement ellisys Please take a moment to read the license agreement now IF you accept the terms below click Agee then Next Otherwise click Cancel Ell
67. urce of system problems or removing servicing or installing Ellisys products Obtaining Warranty Service To obtain warranty service you may return a defective product to the authorized Ellisys dealer or distributor from which you purchased the Ellisys product Please confirm the terms of your dealer s or distributor s return policies prior to returning the product Typically you must include product identification information including model number and serial number with a detailed description of the problem you are experiencing You must also include proof of the date of original retail purchase as evidence that the product is within the applicable warranty period The returned product will become the property of Ellisys Repaired or replacement product will be shipped at Ellisys expense Repaired or replacement product will continue to be covered by this limited warranty for the remainder of the original warranty or 90 days whichever is longer ellisys Limitations THE FOREGOING IS THE COMPLETE WARRANTY FOR ELLISYS PRODUCTS AND SUPERSEDES ALL OTHER WARRANTIES AND REPRESENTATIONS WHETHER ORAL OR WRITTEN EXCEPT AS EXPRESSLY SET FORTH ABOVE NO OTHER WARRANTIES ARE MADE WITH RESPECT TO ELLISYS PRODUCTS AND ELLISYS EXPRESSLY DISCLAIMS ALL WARRANTIES NOT STATED HEREIN INCLUDING TO THE EXTENT PERMITTED BY APPLICABLE LAW ANY WARRANTY THAT MAY EXIST UNDER NATIONAL STATE PROVINCIAL OR LOCAL LAW INCLUDING BUT NOT LIMITED TO ANY IMPLIED
68. xAutoGenerateSkip gt true Parameter List Mode Description Specifies the operating mode of the generator Range GeneratorMode Disabled or GeneratorMode Host or GeneratorMode Device or GeneratorMode Hub Example Disabled configures the generator to not send traffic Host configures the generator to send traffic on the downstream port Device configures the generator to send traffic on the upstream port Hub configures the generator to send data on both ports 50 of 79 Hardware Instructions Set Reference ellisys rxScramblerBypassed Description Specifies whether the traffic received by the generator will be descrambled or not descrambled Range Boolean True or False Example False will result in descrambling of received traffic True will result in no descrambling of received traffic rx8b10bBypassed Description Note Range Example rxLanePolarity Description Range Example Specifies whether the traffic received by the generator will go through the 8b 10 decoder or not This is an advanced parameter and should only be set to True for specific testing Boolean True or False False will result in decoding of received traffic True will result in no decoding of received traffic Specifies whether the receiver will reverse the polarity of the incoming wires or not LanePolarity Normal Or LanePolarity Inverted Normal will result in the receiver not reversing the polarity Inverted will re
69. y time the software is run The generator is selected To run a script 1 Open a script file or Create a new script file and save it 34 of 79 User Interface Reference ellisys 2 Click on Run P or Select Script Run in the menu If a generator was not selected as a default generator then the Available Generators menu appears Available Generators Please select a generator JSB Explorer 280 EX280 1 2347 Use this generator by default 3 Select the desired generator and click OK The script runs using the selected generator To break or pause a script 1 Runa script as described in section 3 13 Running a Script 2 Click on Break ii or Select Script Break in the menu The script is paused To stop a script 1 Run a script 2 Click on Stop 4 or Select Script Stop in the menu The script is stopped To restart a script 1 Click on Restart ul or Select Script Restart in the menu The script is restarted ellisys User Interface Reference 35 of 79 To step a script 1 Click on Step or Select Script Step in the menu or Press F10 The script is run command by command 3 14 Working with Registers This section describes the usage of registers within a script registers refers to section O Counters All registers are displayed in the Registers pane To select a register format 1 Right click on one of the registers in the Registers pane The Format
70. ytes max 8192 bytes or Buffer or Usb30LastRxPacket Default No default value this parameter is mandatory Example 0x00 0x09 0x00 OxEO 0x00 to copy these bytes Buffer 0 for 10 to copy bytes from the user buffer Usb30LastRxBuffer 0 for 16 to copy the header packet Dst Description The destination where the source will be copied Type Buffer Default No default value this parameter is mandatory Example Buffer 100 for to copy the source to the offset 100 of the user buffer with the length specified in the source 5 21 WaitTriggerln The WaitTriggerIn instruction waits on the trigger input SMA connector on the rear of the unit Example WaitTriggerlIn Condition gt RisingEdge Timeout gt 58 Parameter List Condition Description Specifies the trigger condition Range RisingEdge FallingEdge HighLevel LowLevel Default No default value this parameter is mandatory Example RisingEdge waits on a rising edge condition HighLevel waits on a high level logic high or 1 condition ellisys Hardware Instructions Set Reference 71 of 79 Timeout Description Type Range Default Example Timeout after which the instruction is aborted Time expressed in seconds O to 34 36 seconds with a precision of 8 nanoseconds No default value this parameter is mandatory 1 32ms means 1 320 microseconds 10ns will be floored down to 8 nanoseconds 5 22 GenerateTriggerOut The GenerateTriggerOut instruct

Generator User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents