Home

Choose what sample depth you would likekeeping in mind

1. Fields 3 Start 1x h HOST 1x 1 h CMD Fields 3 Start 1x h HOST 1x 1 h CMD Fields 3 Start 1x h HOST 1x 1 h CMD All of the App Command packets Fields 3 Start 1x h HOST 1x 1 h ACMD Fields 3 Start 1x h HOST 1x 1 h ACMD Fields 3 Start 1x h HOST 1x 1 h ACMD Fields 3 Start 1x h HOST 1x 1 h ACMD Fields 3 Start 1x h HOST 1x 1 h ACMD Fields 3 Start 1x h HOST 1x 1 h ACMD Fields 3 Start 1x h HOST 1x 1 h CMD The R6 response packet Fields 7 R6 Start 1x h DEVICE 1x 0 The R3 response packet Fields 6 R3 Start 1x h DEVICE 1x 0 The R2 response packet Fields 5 R2 Start 1x h DEVICE 1x 0 The R1 response packet Fields 4 Rl1l Start 1x h DEVICE 1x 0 OUT OF RANGE 1x tft ADDRESS ERROR 1x tft BLOCK LEN ERROR 1x tft ERASE SEQ ERROR 1x tft ERASE PARAM 1x tft WP_VIOLATION 1x tft CARD _IS_LOCKED 1x tft LOCK UNLOCK FAILED 1x tft COM CRC_ERROR 1x tf ILLEGAL COMMAND 1x CARD ECC FAILED CC_ERROR 1x tf ERROR 1x tft UNDERRUN 1 t OVERRUN 1x tft CID CSD_OVERWRITE 1x tft WP ERASE SKIP 1x tft CARD ECC DISABLE 1x tft ERASE _REST 1x tft CURRENT STATE 4x L READY FOR DATA 1x tff nul 2x i APP CMD 1x tft nud lt i xs AKE SEQ ERROR 1x tft RSV_2 1x i RSV_TEST MODE 2x i CURRENT STATE Idle SReady SIdent SStby Tran Data Rcv Prg Dis S
2. Document WordPad _ e TT File Edit View Insert Format Help Cel 6 amp 4 amp ame amp B Arial 10 Westem gt BZU i DIR Time 623 9798ms Write False Layer USBBUS Time 624 0195ms IN z 624 0217ms Write True TX_LENGTH_ADR 624 0443ms Write False TX_BUFFER_ADR ADDRES zg EE xB1 1 1 o 1 1 z 624 3685ms Read False S Ed EA Eg 0 0 0 625 1273ms Read False RX_IRQ STATUS_ADR 0 yer CYPRESSRFIC z 625 1572ms Write True TX_LENGTH_ADR yer CYPRESSRFIC z 625 1798ms Write False TX_BUFFER_ADR o 1 1 o 1 1 625 2065ms Read False yer CYPRESSRFIC ADDRES KO PDE sog Eg EE i o 0 625 9643ms Read False RX_IRQ STATUS_ADR CYPRESSRFIC ADD 625 9978ms Read False z 626 017ms Read False WRITEDATA 626 0917ms Write True TX_LENGTH_ADR 626 1143ms Write False TX_BUFFER_ADR 30 yer CYPRESSRFIC ADDRE o 1 1 1 o 1 i 626 1405ms Read False TX_IRQ STATUS_ADR 1 ADDRE RXBI For Help press Alot In order to maintain correct position of the graphical portions of the RTF file all spaces are converted Up to the character and set to the background color Viewed or printed in the RTF format will look correct as above If you copy only the text of this output you will want to search and replace every Up with a space COPYING PACKETPRESENTER OUTPUT TO OTHER PROGRAMS You can copy the contents of the PacketPresenter output window to ot
3. M Doinine Anaya uss J s r sme iwe ez smes J os J can Y sei J poria Y Custom search sonio Signal Selection ClockEdge DAT lines Bytes Per Block Data Format Rising C 1 DATO D Decimal Falling 4 DATO DAT3 2 z Hex ASCI On the above dialog box select the signals you plan to use for the SDIO protocol Also set the appropriate sampling edge for the CMD and DAT lines how many DAT lines to use and the size of the data blocks Also choose the output format for the traffic USBee QX User s Manual 7i RFR TAr Ten COG 2222 NOODBOL aon nan 2333 tTro lt saor MOU namea w w w N ane efiseese gamowos tk Di o o in o SNS moo vo sor ASSSSRS Mocvevegsne Zsnssge SPesneeerergert ANLO ONU on GRSRSEBSRSSAST ome oe roo8 Sa wr on SERITSASARLSeASSH EELEE EET Tran Pocket 35 Tane 71 64us ai o SEND STATUS M S010 0 Layer Pecket 36 Tame 11 64us 1 WRITE MULTIPLE BLOCK O9 04 CE 90 m 5010 0 Layer Packet 37 Tine 10 32us RI O WRITE MULTIPLE BLOCK Tran onto Layer SDIO O Ptonn stotu Oo AMFOOTIONGENM oTT DONTON MESE LANGotoonmm eARSsnrsseassz8 yw ERAGASAASESR ANG KONTO OTOLGR omy E OHAN OL OO i OONN w SRARSSSASESRHAY SRRIRSZALSSBAS Lwonyonotueooowlh KA BWR OMOCLNYLOGLeeD EBRRSSRSLESFAS ESSYSALSSESLISSSO i FSSRENSRESELSO KR OrAMNKooOwMos KONONMWOCOMone a
4. The next line lets you find states or ranges of states on the digital signals First select if you are looking for the digital states to include the values are or not include the values are not that follow Then specify the states of all of the digital lines by clicking on each individual signal to change from O 1 and X don t care If you are looking for a single set of digital states leave the second set of signals at all X If you want to find a range of states enter the ending value as the second set of signals The matched range will then include all values from the first set to the second set inclusive USBee QX User s Manual 103 Below shows a search that finds all occurrences of when the Digital 2 signal is logic 0 B So eS ee ed 7 Channel Settings Oo ovan iiao Se oe ao eT a Search 4 4 E Al Event i If digital signals are XXXXXXXXXXXXXOXX Digital 0 If Digita gnal dg ppe mes Digital 1 If Analog Signal CH1 3 edge at voltage threshold lt Vo ppens tin Digital 2 while Digital 3 z Bus Digital 2 decoded data is Detweer 15 fand 99 and SPI 2 v Digital Signal States are Y F EES BOO OOOtx 04 0 to F LOOX eeaeee 0 and a Digitar4 A Analog Signal CH1 10 0 Volt ie and PC5 pa This Event happening betwee n L mmediate fter the previous event Digitare gt E Digital 7 x fa Followed By x Event 2 Async 6 as
5. Dim SignalToUse As Double Val Params 1 Dim Data As Integer Dim LevelHigh1 As Integer Dim LevelLow1 As Integer Dim LevelHigh2 As Integer Dim LevelLow2 As Integer LevelLow1 amp H200 128 LevelLow2 amp H200 256 LevelHigh1 amp H200 128 LevelHigh2 amp H200 256 Const LOOKING_FOR_START As Integer 1 Const LOOKING_FOR_HIGH_END As Integer 2 Const LOOKING_FOR_LOW_END As Integer 3 Dim DecodeState As Integer LOOKING_FOR_START Holds what state of the decoder we are in Dim ByteAccumlator As Integer Holds the accumulated bits for each byte Dim BitCounter As Integer Holds how many bits we have accumulated in this byte so far Dim ByteStartSample As Int64 Holds the sample at the start of the byte For Sample To NumberOfSamples 1 Data SampleDataCH1 Sample If DecodeState LOOKING_FOR_START Then If Data gt LevelHigh2 Then DecodeState LOOKING_FOR_HIGH_END ByteStartSample Sample End If If Data lt LevelLow2 Then DecodeState LOOKING_FOR_LOW_END ByteStartSample Sample End If ElseIf DecodeState LOOKING_FOR_HIGH_END Then If Data lt LevelHigh1 Then DecodeState LOOKING_FOR_START WriteEntry BW ByteStartSample Sample 0 If PPOn Then SendDataToPacketPresenter ByteStartSample 1 1 End If ElseIf DecodeState LOOKING_FOR_LOW_END Then If Data gt LevelLow1 Then DecodeState LOOKING_FOR_START WriteEntry BW ByteStartSample Sample 1 If PPOn Then SendDataToPacketPr
6. Setup the Analog input channels SetAnalogChannelSettings 1 6 DC_COUPLED SetAnalogChannelSettings 2 6 DC_COUPLED SetAnalogChannelSettings 3 6 DC_COUPLED SetAnalogChannelSettings 4 6 DC_COUPLED printf Reading Input Channels n for int x x lt 10 x unsigned char D to7 unsigned char D8to15 unsigned char D16toC GetDigitalSignalsQx amp D to7 amp D8to15 amp D16toC printf D 7 02X D8 15 82X D16 C 02X n float CH1Volts AnalogLiveVoltage 1 float CH2Volts AnalogLiveVoltage 2 float CH3Volts AnalogLiveVoltage 3 float CH4Volts AnalogLiveVoltage 4 printf CH1 f n CH1Volts printf CH2 f n CH2Volts printf CH3 f n CH3Volts printf CH4 f n CH4Volts printf Generating Analog Waveform n unsigned char samplebuffer 128 for int x x lt 128 x samplebuffer x x GenerateAnalogwaveformQX 100 128 samplebuffer for int x x lt 20 x printf CH1 f n AnalogLiveVoltage 1 D to7 D8to15 D16toC USBee QX User s Manual printf Generating PWM Waveforms on 16 and 17 n GeneratePWMWaveformQX 1000 50 GeneratePWwMWaveformQX 1 20000 25 printf Generating Digital Waveform on D2 thru D7 n LoadDigitalWaveformQX 128 samplebuffer GenerateDigitalWaveformQX xFC 1 1 0 3000000 printf Reading Edge Counts and Frequencies n DisableCountsQx ClearCo
7. g USBee Advanced Suite USBee QX Connected C cwav USBee Test Files qx4analogsecond usbeerx File View SpeedandSamples Trigger Setup Help v Contro Panel 400us div 0 400us 4 248ms 0 003979000 0 003992000 0 004078000 0 004099000 0 004185000 0 004208000 0004293000 004327000 0004339000 0 004425000 0 004454000 0 004539000 0 004574000 0 004579000 0 004666000 0 005113000 0007242000 Cursors PacketPresenter File Edit Larger Smaller Search Filter Layer 5 Layer ASYNC_6 Packet 2 Time 1 32msj EBECJED EE EF FO F1 1M samples 1Msps Capture Once Capture Many 1 3 56 dY 6 98V CN mauee USBEE QX USERS MANUAL CWAV In www usbee com 0 004763000 Async 6 RX FA 0 004851000 Async 6 RX FB 0 004938000 Async 6 RX FC 0 005025000 Async 6 RX FD 9 007230000 12 T Ons X1 3 98ms X2 458ms dX 598us 1 dX 1 672kHz Pees 346 86 1Hz Duty Cycle 9 93 4 Nidth 2 865ms SDA S Start SDA A2 Write SDA ACK SDA 00 SDA ACK SDA F7 SDA ACK SDA S Start SDA A3 Read SDA ACK SDA 80 12C 5 SDA NACK 12C 5 SDA P Stop Async 6 TX F8 Async 6 TX F9 rN a win Win in in i NNNNNNE rs vung OOO ie Ww Async 6 RX FE C5 SDA S Start 5 SNA AT USBee QX User s Manual USBEE QX USERS MANUAL CWAV Inc www usbee com 951 694 6808 support usbee com USBee QX User s Manual 3 USBee QX Suite License Agreement The f
8. First select if you are looking for the analog voltages to include the values is or not include the values is not that follow Then specify the voltage range start and end in volts The matched range will then include all values from the first set to the second set inclusive Below shows a search that finds all times that the analog signal CH1 is between 1 1V and 4 3V UsBee Suite Pro USBee DX Connected Iga memme gs File View Speed and Samples Trigger Setup Help lt aS 1000us div _ 19 084833ms re lt gt in ac Digitar 0 a Digital 1 EV i Analog Signal CH1 has rising edge at voltage threshold 2 V Digital 2 Oagaea Digital 3 n e h R s between i3 and 99 and Digita Signal States are F R OAX gt BO OO OO aX ORG 0 to F ROOIX PO OOO OIX aE OL and V Analog Signal CH1 v is 1 1 Voltsto 43 Volts SPI2 Digital 4 Digital S 2Cc5 Digital 6 Digital 7 Followed By n h e e N eR Async 6 Event 2 Followed By Event 3 Followed By Event 4 Followed By Event 5 Followed By Cissore Event 6 USBee Capture Once Capture Many a Use PacketPresenter Definition File name is below E l Logic Analyzer Oscilloscope T Apply f U USBee QX User s Manual 105 Below shows a search that finds all times that the analog signal CH1 is NOT between 1 1V and 4 3V File View Speedand Samples Trigger Setup Help lt 1000us d
9. 1132 744mV which is the input 16 bits in msbfirst order 0x30C times the gain of 1 5 plus the offset of 37 256 output in decimal format plus the mV string CONDITIONAL PACKET FORMAT Using the Conditional input modifier many different field arrangements can be defined for the same packet Common uses are for parameter fields that exist for different types of commands If packets contain commands that determine what the remaining fields are this syntax defines what those remaining fields are Below is an example of various packet formats based on a single command field Fields Command 4m 0 h Address 8m h Fields Command 4m 2 h Address 8m h Data 8m h Fields Command 4m 4 h Paraml 8m h Param2 8m h Param3 8m h For an input packet as follows 0010 00011101 00001000 USBee QX User s Manual 145 Followed by a packet 0100 00011101 00001000 11111110 The output would be 2 fo fos Command f Param f Param2 f Param3 E EC Ce i which are the fields associated with the Command 2 and Command 4 Field Lines STRING LOOKUP Fields that can be better expressed as text strings can be outputted as such using a Lookup table Below is an example of a field that uses a lookup table Fields Fields StartByte 8 H CommandByte 8 L EndByte 8 H Lookup CommandByte 0 SRead 1 SWrite 2 SSeek 3 SLoc 4 SSize For an input packet as follows 00100001 00000001 00001000 The output would be StartByt
10. Demo Measurements T Xl X2 dX 1 dX Ons 1 581625ms 1 895708ms 314 083us 3 183868kHz Copyright 2009 CWAV Inc Obviously much more complicated protocols can be decoded using these simple methods of parameter passing and Entry displaying BUILDING THE CUSTOM DECODER To implement a custom decoder you must create a Class Library CustomUSBeeSuiteDecoderQx DLL using the code below as an example This example code is also included when you install the USBee QX Suite software in the Program Files CWAV Inc USBee QX Suite CustomUSBeeSuiteDecoderQx directory You can build this Class Library using the free Microsoft Visual Studio 2010 Express or newer Our example is in Visual Basic but can easily be ported to C or other language supported in VS2010 The main function of a Custom Decoder code is below 1 Receive parameters for the protocol from the User Interface 2 Access the sample data and decode the protocol based on the parameters 3 Output Entries that consist of a Start Sample End Sample and a Text String 4 Optionally Output data and events to the PacketPresenter for further protocol processing Once you create your own CustomUSBeeSuiteDecoderQx DLL file you simply copy your new file over the one that was provided with the original install in the Program Files CWAV Inc USBee QX Suite directory You may need to locate this file on your system and have administrator rights in order to replace it USBee QX User s Manu
11. Followed By a lt Event 3 Followed By v Event 4 Followed By v Event 5 Followed By Cason v Event 6 U S Bee Capture Once Capture Many Logic Analyzer Oscilloscope m Below shows a search that finds all occurrences of when the Digital 2 and Digital 3 signals are 0 0 0 1 and 1 0 The range starts at the first setting and increments until the second setting pe res Pro USBee DX Connects d Ee Channel Setting js eee O O O REE J a Coma O on sa Y e T an T Search a fi ie 2 3 a E 3 Al Event 1 If digital signals are XXXXXXXXXXXXX00X to XXXXXXXXXXXXX10X Digitaro Digitar 1 If Analog Signal CH1 has ising edge n Digital 2 while Digital 3 ILI Bus Vigital lt decoded data is between 42 and 72 and 4 Digital Signal States are F 0 to F 0 and Digital 4 s amp j F Anal a i N Digital 5 5 and RCs s This Event happening between Y us and 10 s mmediate after he nena n pigas Digital 7 x 8B Followed By Async 6 v Event 2 n Followed By x 0 v Event 3 Followed By vi Event 4 Followed By v Event 5 Followed By ETT Event 6 USBee Capture Once Capture Many r Definition hle name is below i Logic Analyzer Oscilloscope i 104 USBee QX User s Manual ANALOG SIGNAL STATES AND RANGES The next line lets you find voltage ranges on the analog signals if your USBee has them
12. HELLOWORLD and NECIR Each decoder processes the data differently and outputs different results based on the algorithms You can also supply additional parameters in the text string as well as we do in the CHANGE and RISE decoders The additional parameter in these examples indicates which signal to use to decode Again the definition and use of the Parameter string is entirely up to you but provides an easy to use and simple to implement way to control the behavior of your decoder 92 USBee QX User s Manual ACCESSING SAMPLE DATA TO PERFORM DECODE To access each individual sample stored in the sample buffer you use the SampleData or FindNextEdge calls as shown above This returns a 64 bit value that includes all of the channels levels at that sample time The format of the 64 bits is as follows MSB LSB 22221111 111111 00000000wwwwwwwwzzzzzzzz321098760 XXXXXXXXYYYYYYYY5432109876543210 where wwwwwwww is Channel 4 Analog value 0 6V 255 6V ZZZZZZZZ 18 Channel 3 Analog value 0 6V 255 6V XXXXXXXX is Channel 2 Analog value 0 6V 255 6V YYYYYYYY is Channel 1 Analog value 0 6V 255 6V 23 is logic level 0 or 1 for channel C 22 is logic level 0 1 tor channel T 21 is logic level 0 or 1 for channel 21 20 is logic level 0 1 for channel 20 O is logic level 0 or 1 for channel 0 Decoding any given protocol then entails going through the samples from beginning to end and masking off the channels yo
13. Software Setup Activate the below Channel Settings Dialog by clicking the grey tab on the left of the signal names on the main application screen a Channel Settings tS Search Signats us s c Asme iwe s2 Signal Selection 01282956789 ABMMDEF 2 Show Value Data Format Off C Decimal On Hex ASCH Binary Use PacketPresenter Definition File name is below Save Cancel On the above dialog box select the signals you want to display by checking the associated check box choose whether to show the value of the selected signals and what format you would like the values The signal traffic will be shown as in the following screen The SS line shows a single signal with the values turned on The MOSI line shows a combination of three different signals and the resulting value of those signals The associated settings dialog box is shown 62 USBee QX User s Manual Parallel m c ae r Signal Selection 0 i 56789 AG Di E iE VMOVIMIDoe EE El r Show Value p Data Format Of Decimal On Hex O ASCII Binary Trigger Settings m USBee QX User s Manual 120us Width 82 1us f A2 Write A o 63 CAN BUS SETUP The CAN Bus Decoder takes the captured data from a CAN bus 11 or 29 bit identifier supported formats it and allows you to save the data to disk or export it to another application using
14. use falling edge of SCK to sample data on MISO 1 use rising edge e Delimeter 0 no delimiter 1 Comma delimeter 2 Space delimeter e Showall 0 Only show the data payload 1 show all packet details e Hex 0 display data in decimal 1 display data in hex e UseSS 0 don t use an SS signal 1 use the SS signal e BytesPerLine How many output words are on each output line e ProtocolDefinitionFilename filename for the Protocol Definition File to use to create a PacketPresenter file If this value is O then the PacketPresenter feature is turned off e ProtocolOutputFilename filename that is created for the output of the PacketPresenter e ErrorString string that holds an error description of the routine returns an error 194 USBee QX User s Manual Return Value TRUE No Error during processing e FALSE Error while processing The ErrorString contains a description of the error to present to the user _DECODEI2C This routine decodes bus traffic and outputs the data to an output file This routine works ona sample buffer captured using the StartCapture routine Calling Convention CWAV_IMPORT int CWAV_API DecodeI2C unsigned __int64 reservedi unsigned char OutFilename unsigned char InlineSDAFilename __int64 StartSample __int64 EndSample long Rate unsigned long SDA unsigned long SCL long Showack long delimiter long showall long hex char ProtocolDefinitionFilename char ProtocolOutput
15. waitT unsigned char Trising unsigned char externalclock unsigned char Crising unsigned long samplespersecond e Channelmask which channels to use for the output of the digital pattern generator Bit O is channel 16 and Bit 7 is channel C 1 output digital pattern on this channel 0 no output e GenerateOn 1 to turn on the pattern generator O turns it off e Loop 1 loop the pattern at the end 0 No loop e waitT Waits to start the pattern until the T signal shows an edge e Trising indicates the T signal must be a rising edge 1 or falling edge 0 to trigger the pattern e External Clock 1 indicates to use the digital input C to clock out the pattern instead of the internal sample clock e Crising 1 indicates the external clock C rising edge O falling edge e Samplespersecond is the number of samples per second to clock out the digital pattern for internal clocking mode 1 to 100 000 000 Return Value e 1 Successful 0 Failure FREQUENCY AND PULSE COUNTER FUNCTIONS The following API describes the routines that control the frequency and pulse counter functionality of the USBee QX Test Pod CLEARCOUNTSQX This routine clears the frequency and pulse counts Calling Convention CWAV_IMPORT unsigned long CWAV_API ClearCountsQX void Return Value 1 Successful 0 Failure _ENABLECOUNTSQX This routine enables the frequency and pulse counting Calling Convention USBee QX User s
16. 0 Monitor the status of the capture in progress unsigned char Full unsigned char Triggered unsigned char Running 1 while Running CaptureStatusQX amp Full amp Triggered amp Running printf CaptureStatus Full d Triggered d Running d n Full Triggered Running Sleep 18 TriggerNowRX To trigger now and store data to the end of the buffer StopCaptureRX To stop capture in progress and discard the data Now that the capture completed properly end the capture and get the data __int64 ActualNumberOfSamples __int64 TriggerSamplePosition Completes the capture and transfers all of the stored data to the PC EndCaptureQxX amp ActualNumberOfSamples amp TriggerSamplePosition printf Number Of Samples 164d Trigger Sample Position 164d n ActualNumberOfSamples TriggerSamplePosition Now access samples captured using SampleDigitalData and AnalogSampleVoltage for int x 100 x lt 12000 x 100 printf Sample 2d Digital 8X CH1 0 2f CH2 0 2f CH3 0 2f CH4 2f n x SampleDigitalData x AnalogSampleVoltage 1 x AnalogSampleVoltage 2 x AnalogSampleVoltage 3 x AnalogSampleVoltage 4 x USBee QX User s Manual 209 __int64 NextSampleWithEdge FindNextEdge 1234567 xFFFF 1 PowerOffAnalogQX Turn off the power to the Analog channels CH1 CH2 CH3 and CH4 printf Press any key to exit n getch return
17. Automatic Mode Single Capture and Multiple Capture Normal mode will wait for the trigger event to occur before capturing Automatic Mode will wait a set time for the trigger and will automatically trigger if it is not found Single Capture mode performs a one shot capture of the signals Multiple Capture repeatedly captures and displays the signals 28 USBee QX User s Manual DISPLAY MODES The USBee QX Suite lets you widen the trace waveforms display the analog waveforms as vectors or single sample points and persist the display from one trace to the next EE Ustee Suite Pro USBee DX Connected File View SpeedandSamples Trigger Setup Help Digitalo Digital Digital 2 Digital 3 Digitals Digitals Digital6 Digital7 DSSEEEEa8 Analog Penod frequency Duty Cycle One amtmity ANALOG CHANNELS SCALING The USBee QX Suite provides a scaling ability to convert the analog voltages into other units of measurement Digital Logic Threshold Oscilloscope Probes 1x 10x 4X 10X CHi Units v CH2 Units v 7i CHi Scale CH2Scaie i CH1 Offset 0 CH2Ofse o 6V 60V 6V 6 0V OV 0 0V 6V 6 0V USBEE SUITE DATA FILE IMPORTING USBee QX User s Manual 29 The USBee QX AX or ZX running the USBee Suite software saves files in their own file format These older files can be imported into the USBee QX Suite BROWSER LIKE NAVIGATION The USBee QX Suite adds browser like Forward and Back
18. ByVal Filename As String ByVal Sample As Int64 ByVal Data As Integer ByVal Bits As Integer ByVal Channel As Integer ByVal Index As Integer As Integer Declare Function ClosePacketPresenter Lib usbeeadvste dl1l Alias ClosePacketPresenter YGHXZ As Integer The SampleData routine returns a 8 byte value that contains a single sample of all the signals The format of the 64 bits returned is as follows MSB LSB 22221111 Di i a 0000000 0wWwWwWwwwWZzZZZZZZZ32109876 XXXXXXXXYYYYYYYY5432109876543210 where f wwwwwwww is Channel 4 Analog value 6V 255 6V 3 zzzzzzzZ is Channel 3 Analog value 6V 255 6V 3 XXXXXXXX is Channel 2 Analog value 6V 255 6V YYYYYYYY is Channel 1 Analog value 6V 255 6V 23 is logic level or 1 for channel C 22 is logic level or 1 for channel T i 21 is logic level or 1 for channel 21 20 is logic level or 1 for channel 20 is logic level or 1 for channel FindNextEdge routine scans quickly through the sample buffer starting at the start sample number to find the next sample that sees an edge on any of the masked channels Mask bits are aligned as above with a 1 being considered being ignored direction 1 forward backward FindNextEdge should be used instead of SampleData whenever possible since it is much faster Return value is the sample number at the next edge or 1 if there is no more edges in that direction Dim GTriggerSa
19. CAPTURESTATUSQX This routine checks the status of the data capture in progress Calling Convention CWAV_IMPORT unsigned long CWAV_API CaptureStatusQX unsigned char Full unsigned char Triggered unsigned char Running e Running 1 Acquisition is still running 0 Acquisition has completed Triggered 1 Trigger has occurred 0 still waiting for the trigger e Full The percentage of the buffer that is currently filled Ranges from O to 100 Return Value 0 Failed 1 Success STOPCAPTUREQX This routine terminates a pending capture and discards the sample data Calling Convention CWAV_IMPORT unsigned long CWAV_API StopCaptureQX void Return Value e 1 Capture Stopped e 0 Stop Failed _TRIGGERNOWQX This routine immediately triggers a pending capture Calling Convention CWAV_IMPORT unsigned long CWAV_API TriggerNowQXx void Return Value e 1 Trigger Occurred e 0 Trigger Failed USBee QX User s Manual 189 _ENDCAPTUREQX This routine completes the capture and transfers all of the stored data to the PC This routine should be called once a capture is completed CaptureStatusQX Running is 0 Calling Convention CWAV_IMPORT unsigned long CWAV_API EndCaptureQxX __int64 ActualNumberOfSamples __int64 TriggerPosition e ActualNumberOfSamples specifies how many samples were captured at the given sample rate e TriggerPosisition specifies which sample in the captured buffer contai
20. EXTERNALLY PROCESSING THE DISK STREAM The capture file can be post processed externally by your external programs This section defines the format of the sample file The stream file is located at C Users Username AppData Local USBeeSuite streamout bin 218 USBee QX User s Manual 7 SIGNAL CAPTURE MODE The below hex dump is from a 7 signal capture where each byte contains a sample as described below The stream starts with a 00 00 00 00 which indicates this is a 7 signal capture Following these 4 bytes are the streamed samples This is a capture of an approximately 228 5kHz signal on channel 4 M File Edit View Operations Template Aerial Tools Window Help i led D1 amp Ga A Ww Ba oo Ae PA asc deat OY PB E IR 0 0 P P Se Me fg 440 00 0 000 00000000 0 0 Length 14 000 The format of the samples in the streaming file is a simple runlength encoded pattern When sampling in seven signal mode DO D6 each byte is a sample with the MSB indicating if it is a RLE count or not If the eighth bit is set to a one the low 7 bits is a RLE count If bit eight is a zero then the low bits are the digital state of those signals for that one clock sample DO D6 For example a 0x00 followed by a 0x85 is six samples with all digital channels DO D6 at logic level zero And since each sample is taken at 100 8 MHz you can compute the time by counting the samples RLE counts can be concatenated as many times as nee
21. The available options for exporting are e Save the Signal Data to a Binary File e Save the Signal Data to a Text CSV File Save the Bus Data to a Text CSV file peaks 10 529167ms Period Frequency Ons infinity You can specify the range of samples to export by using the All X1 to X2 or Screen versions Screen will output all samples viewed on the current screen X1 to X2 will output all samples between the X1 and X2 cursor and All will output all samples in the sample buffer Choosing All will create VERY large files so use with caution USBee QX User s Manual 79 EXPORT SIGNAL DATA TO BINARY FILE When exporting signal data to a binary file each sample is made up of 8 bytes Each sample was taken at the sample rate that was set at the time of capture A single sample 8 bytes is formatted as follows Digital channels 0 to 7 Isb signal 0 msb signal 7 Digital channels 8 to 15 Isb signal 8 msb signal 15 3 Channel 1 Analog voltage ewaovasn OOOO 4 Channel 2 Analog voltage t ewm OOOO Channel 3 Analog voltage t emos OOO 7 Channel 4 Analog voltage T ews OOO EXPORT SIGNAL DATA TO TEXT CSV FILE When exporting signal data to a text csv file each sample is output to a single line with each signal separated by a comma Each sample was taken at the sample rate that was set at the time of capture An example output file is formatted as follows showing a header that specifies the column
22. lines It also adds a decoder line to the screen with this data decoded as below 509 167us 909 167us poloo Digital 6 Digital 7 e e e e h h e e URANU USBee e Logic Analyzer Oscilloscope T Xl X2 dX 1 dX Period Frequency Duty Cycle Ons Ons Ons Ons infinity Ons infinity The Quick Setup 12C configures the signals 4 and 5 to be an 12C bus with the SDA and SCL lines It also adds a decoder line to the screen with this data decoded as below USBee QX User s Manual 43 Digital 0 Digital I Digital 2 Emm visitas Digital 6 e e e e e h h h e Digital 7 Cursors XE USBee Capture m Measurements Logic Analyzer Oscilloscope T Xi X2 dX 1 dX erik Frequency Duty Cy Ons Ons Ons Ons infinity 10 85975ms 92 083151Hz 99 3 The Quick Setup ASYNC configures the signals 6 and 7 to be a full duplex ASYNC bus with the TX and QX lines You will need to change the baud rate data bits and parity to match your bus It also adds a decoder line to the screen with this data decoded as below BE USbee Suite USBee DX Connected E nce 1 095375ms 1 195375ms Digital 0 Digitalt Digital 2 tk R k k R k R M eS ETET NN USBee Capture A Measurements Logic Analyzer Oscilloscope ae ee Se ee ae ava Period Frequency Duty C Ons Ons Ons Ons infinity 10 85975ms 92 083151Hz 99 3 44 USBee QX User s Manual HOT KEYS The USBee QX
23. lt lt E 400us div 1 6ms 1 2ms 800us 400us 100us 400us 800us 1 2ms 1 6ms Digitat 0 Ee s i j Digitat1 7B Digitat 2 7B 3 Sgar a ld UUN i E R A A i i j ULN pra sPL2 E9 F HH WHE E HH 8 ee 8 ga ee see 8 OR 668 ite O SS a S Digita 5 lED 0 G E GO AA CD E Digitat 6 x Digitat7 7B A Async 6 om UJ Cursors X1 PacketPresenter File Edit Layer SPI 2 Packet 8 Time 1 38ms MOSIDATA MISODATA Fr rr eri7e 24 24 SLAVEADDRESS 51 a ADDRESS Layer SPI_2 Packet 1 Time 1 76ms MOSIDATA MISODATA SLAVEADDRESS P Write 00 19 Packet 9 Time 1 695ms Layer ASYNC 6 Packet 10 Time 2 485ms LES T 0ns en X1 1 404ms Yi 289v s areas ag X2 1 696ms Y2 1 58V pete ten bE ne Ail Rights Reserved er Bee Width Ons pei A aT oh USA i oe dY 1 31V Penod i Ons US Patent 7 911 970 and other pemg OVERVIEW Using the USBee QX Suite application it is normal for users to debug communication that is being transmitted between ICs or system components This debugging can be performed by viewing the waveforms on the screen or by viewing decoded bus traffic for the various types of busses For example users can see the voltage versus time waveforms of an ASYNC bus Tx and Rx lines or decode the waveform into a byte stream using the standard bus definition ASYNC for example that is then displayed
24. owes Digital 5 hee h ee LLLI LI Js Digital 6 aitat Cursors a USBee RX Suite Capture Once Capture Mary Logic Analyzer Oscilloscope aw Coopepragta 200 1 ONAM De AR Rights Rinses ragez me Marertetren ordy im coe LA UE Dutert 190 ten pt preg r USBee Suite Pro USBee RX Connected C cwav USBee Test Files ProtocolSetup usbeerx LS File View Speed and Samples Trigger Setup Help A USBee RX Control Pane S Semple Cockis 2400000 spe Sample Clock is external on Cinput Digital 0 Digital 1 e e ee jita Diit 1 Eoo Digital 5 h ee h ee ALLL I Jh Digital 6 aital 172 USBee QX User s Manual ARBITRARY DIGITAL PATTERN GENERATOR Each digital output channel can be configured as an arbitrary digital pattern You specify the pattern by using e Comma Delimited File CSV that specifies the Sample Rate in Hz O to 100000000 and each of the samples Each pattern can have from 1 to 65535 samples A CSV file can be created using a simple text editor or as an output of a program such as Excel on Files DigSiaGen esy Edit Samples Loaded 62116 J Loop WaitForT _ T Rising Semple Clockis 2400000 sps _ Sample Clock is extemal on C input Digital Generator SPECIFYING THE PATTERN WITH A CSV FILE To create a digital pattern you need to make comma delimited text file The first item on the first line of the file is the desired
25. you would like to stop the capture before it is completed just press the same button again which reads STOP during a capture After a trace is captured the waveform data is gathered decoded if needed and displayed in the waveform window VIEWING CAPTURED DATA SCROLLING ZOOMING AND PANNING WAVEFORMS The Waveform display area is where the measured signal information is shown Itis displayed with time increasing from left to right and voltage increasing from bottom to top F fal amp USBee Suite Pro USBee RX Connected C cwav USBee Test Files ProtocolSetup usbeerx SEN File View SpeedandSamples Trigger Setup Help v USBee RX Control Parel saj 300us div 12m5 500us 600us 300us 291us 300us 600us S00us Lims 1 sms Digitaro Digital Digital2 7 eooas mn miun mn ae EJ EE 78 84 24 FF FF FEJ FF So JS 6S 090 UUS TUS H e OM aS OEE oc RCS Bg azii aA AALEN Digitare Digitar7 Async 6 19 1A 18 1c 1D 1 f1F Analog IOO aje USBee RX Suite Logic Analyzer Oscilloscope Frequency 3 221kHe W727 Buy nac S14 271 V Pir Ss CT E EE Copyright ZIL CAWAN line AR Rights Reserved mthe USN US Patert 2911 570 and other paters pereiiny 52 USBee QX User s Manual The position of the waveform defaults to show the actual trigger position in the center of the screen after a capture However you can move the display to see what happened before or aft
26. 0 000338000 SPI 3 MISO FF 0 000437167 SPI 3 MOSI 18 0 000437167 SPI 3 MISO FF 0 000542667 12C 5 SDA S Start 0 000558500 12C 5 SDA A2 Write 0 000640333 12C 5 SDA ACK 0 000661167 12C 5 SDA 00 0 000743000 12C 5 SDA ACK 0 000763667 I2C 5 SDA 0D 0 000845500 12C 5 SDA ACK 0 001098833 I2C 5 SDA P Stop PRINTING To print an image of the current screen choose File Print from the menu CREATING SCREEN SHOTS An easy way to create documentation is to take screen shots or portions of the screen image and save them to graphics files You can save the entire USBee QX Suite application window to a file using the File Save USBee QX Suite Screenshot menu item This lets you save the image as a BMP JPG PNG GIF TIF or WMF file to be used by your favorite graphics program You can use the File Save Screenshot Section menu item to select just a portion of the screen to save Use the left mouse button to start a rectangle that selects the region to save When you let up on the button it will prompt you for the filename to save the image as USBee QX User s Manual 81 B USBee Suite USBee DX Connected SOFTWARE UPDATES New versions of the USBee QX Suite software are posted on the USBee com web site To have the USBee QX Suite software check if a new version exists use the Help Check for Updates menu item It will connect to the USBee com server and determine if there is a newer version available for download If you are up to d
27. 005 Then Great Valid Header Format Look for bits from this point on Write out a Header Marker remove this if you don t need the header WriteEntry BW Sample tEdge2 Lead Code DecodeState LOOKING_FOR_BITS Sample tEdge2 Initialize the Byte Accumulation variables ByteStartSample Sample ByteAccumlator BitCounter Continue For ElseIf tPulseWidth gt 0 002 And tPulseWidth lt 0 003 Then Great Valid Repeat Format Find the next falling edge to complete the Repeat tEdge2 FindNextEdge tEdge2 SignalMask 1 Write out a Repeat Marker remove this if you don t need the Repeat WriteEntry BW Sample tEdge2 Repeat Sample tEdge2 Continue For Else Pulse is not the right size so bail and keep looking Sample tEdge2 Continue For End If Else No edges at all So we are done Exit For End If Else Pulse is not the right size so bail and keep looking Sample tEdge1 Continue For End If Else No edges at all So we are done Exit For End If End If ElseIf DecodeState LOOKING_FOR_BITS Then If BitCounter 8 Then We have an entire byte worth of data so output the information WriteEntry BW ByteStartSample tEdge2 Hex ByteAccumlator BitCounter ByteAccumlator 0 End If If Data lt gt Then We found a High which starts the bit Now look for the next edge tEdgel FindNextEdge Sample SignalMask 1 If tEdge1 gt Then Check to see if this fal
28. 12C 5 SCL 00 18015250 12C 5 SCL ACK 18049208 12C 5 SCL 4A 18131292 12C 5 SCL ACK 18179375 1I2C 5 SCL S Start 18195083 I2C 5 SCL A3 Read 18277167 1I2C 5 SCL ACK 18328333 I2C 5 SCL 61 18410417 1I2C 5 SCL NACK 18470208 1I2C 5 SCL P Stop 18633208 Async 0 TX 4A 19509083 SPI 19509083 SPI 19733167 SPI OSI 96 ISO 6A Ca SS IRR SS TR A A SA DE I ED TR OR AD O OS A A a Se RN gt Dt GD a GD a a le O SD ae T T e GO G G OO EDT a SD SS G a O a a aG a TR Se Ta a A GS De TD O a 18728542 Async 0 TX 4B 18826583 Async 0 0X 4C 18921958 Async 0 QX 4D 19017333 Async 0 QX 4E 19112708 Async 0 QX 4F 19208042 Async 0 QX 50 19417042 SPI 2 MISO FF 19417042 SPI 2 MOSI 16 2 2 2 M M MISO FF M M Relative Timestamps display the time difference since the last bus transaction and the current transaction You can turn on Relative Timestamps using the menu item View Decoder Timestamps Relative USBee QX User s Manual 121 122 82 51 82 FIIs 160 29 OOK 98 99 95 FID 95 N On 90 n ON O n N Un N Un 042 167 042 875 315 042 3 15 333 375 375 s SPI us SPI 2 MI s SPI 25 083us SPI s SPI 2 MOSI 91 042us SPI s SPI 92 042us SPI Sy SEPI U U U U U U U U U U
29. 2 SSeek 3 SLoc 4 SSize The Lookup Tables are only associated to the specific Protocol they are contained in Therefore you can have a CommanaByte lookup table in ProtocolA that is different from a CommandByte lookup table in ProtocolB Within a single Protocol you need to make sure that the Fieldnames are unique for all Lookup Tables so that the PacketPresenter can determine which table to use 144 USBee QX User s Manual EXAMPLES OF FIELD LINES AND FIELDS JUST PLAIN DATA Fields contain data that may or may not be of interest to the user Many times the data is information that just needs to be output to the viewer Being binary data each field may need to be translated numerically to mean something To output a field of data you can specify the radix if it should be shown in Hex Decimal binary as well as a gain and offset to scale the data Finally you can add a string to the field to complete the information All scaling is performed first using floating point and then the output formatting is applied Below is an example of a field to just output the data Fields Volts 16m qd 1 5 37 256 mV This Field Line contains one field named Volts which is 16 bits long in msbit first order The output is to be displayed in decimal format multiplied by 1 5 offset by 37 256 and finally appended with mV before output to the PacketPresenter screen For an input packet as follows 0000001100001100 The output would be
30. 210 USBee QX User s Manual USBEE QX SUITE PRO MODULE The USBee QX Suite Pro Module is an optional module that provides additional features to the USBee QX Suite The optional USBee QX Suite Pro software module adds the following features to the platform e Spectrum Analyzer Protocol Field Graphing REGISTERING THE MODULE In order to register software modules you must have USBee QX Suite software suite installed on the PC e USBee QX pod connected and functioning on the PC Internet access on the PC The software module is linked to the USBee QX pod and not the PC You can install the USBee QX Suite software and add on modules on as many PCs as you want The add on module will only function with the USBee QX pod that it was initially register with Finally you can not register the module without the USBee QX plugged in First to enable the USBee QX Suite Pro Module select the Setup Register USBee QX Suite Module menu This brings up the following screen Already Registered Modules USBee QX Standard Module USBee QX Pro Module USBee QX Stream Module Please Enter a Product Key here to activate the registration Next copy and paste the Product Key you received into the box and press OK You will have received the Product Key on your on line invoice when you purchased the module The software will contact our servers to validate the Product code and return with the following screen on success T
31. ANALOG CHANNELS SCALING The USBee QX Suite provides a scaling ability to convert the analog voltages into other units of measurement By default each analog channel is set to display the measurements in Volts where 1V is shown as 1V on the display Sometimes the measurement might actually mean a different thing than voltage The menu item Setup Analog Channel Settings lets you specify the units of measurement as well as a scale factor Below shows the default setting for the analog channels showing a gain value of 1 offset of 0 and units of Volts USBee QX User s Manual 119 BROWSER LIKE NAVIGATION The USBee QX Suite adds browser like Forward and Back buttons that let you quickly navigate through your trace display EE USBee Suite Pro USBee DX Connected File View Speed and Samples Trigg amp 20 Veit D feliecjma Each time you stop at a certain point when viewing your waveforms the location is saved to the history buffer This allows you to quickly jump back to the previous locations within your trace without having to scroll pan or zoom Press the Back Button Cyan oval with lt lt lt to go backwards in the history buffer Press the Forward Button Cyan oval with gt gt gt to go forward in the history buffer 120 USBee QX User s Manual RELATIVE TIME DECODE The USBee QX Suite also adds a Relative Time or Absolute Time setting for the decoded data lists T USBee Suite Pro USBee SX Dem
32. Addr 7L d EP 4L d CRC5 5 i Sync 8 i PID 8 L InData NL h CRC16 16 i Data Synew 8s HS 85 s Handshake OUT Fields Sync 8 i PID 8 10000111b L Addr 7L d EP 4L d CRC5 5 i Sync 8 i PID 8 L OutData NL h CRC16 16 i Data Sync 8 i HS 8 L Handshake Catch all Fields Data NL h Lookup Type 1 SDevice 2 SConfig 3 String Lookup PID 11000011b SDATAO 11010010b SDATA1 01001011b SACK 01011010b SNAK 01111000b SSTALL 10110100b SSETUP 10000111b SOUT 10010110b SIN 10100101b SSOF Lookup HS 01001011b SACK 01011010b SNAK 01111000b SSTALL USBee QX User s Manual 165 a PS2 Protocol Definition File This file defines the transfers from a PS2 device Protocol name PS2Bus bytewise DEBUG DebugOn Uncomment this to turn on Debug Packets Packet Start type next Every byte is the start of the next packet CHANNELXORY Either Device to Host or Host To Device End type TIMEOUT TIMEOUT 5000 End of command after 5msec Decode Fields Setting LEDs after command Fields 1 Device To Host S Key Down Scancode 8x h 2 SHost To Device HostCommand 8y EDh Set LEDs Ack 8x i Parameter 5y i Caps 1l1y tf Num 1y tf Scroll ly tf Ack 8x i Fields 1 Device To Host Key Down Scancode 8x h 2 SHost To Device HostCommand 8y h Ack 8x i Parameter 8y h Ack 8x 1 Device to Host Fields 1 Device To Host Key Up Release 8x FO0h h Scancod
33. CRC 8 h These fields are used by Dallas Serial Number iButtons Fields ROMCommand 8 33h Read Rom Family 8 h SerialNumber 48 h CRC 8 h Fields ROMCommand 8 0Fh Read Rom Family 8 h SerialNumber 48 h CRC 8 h by 1 Wire EEPROMS These packets are u sed Fields ROMCommand 8 33h S Read Rom Family 8 h SerialNumber 48 h CRC 8 h Fields ROMCommand 8 h MemoryCommand 8 0Fh Write Scratchpad Address 16 h Data N h Fields ROMCommand 8 h MemoryCommand 8 AAh SRead Scratchpad Address 16 h ES 8 h Data N h Fields ROMCommand 8 h MemoryCommand 8 55h SCopy Scratchpad AuthCode 24 h Fields ROMCommand 8 h MemoryCommand 8 F0Oh SRead Memory Address 16 h Data N h USBee QX User s Manual 161 PARALLEL PROTOCOL EXAMPLE Sample Parallel Protocol Definition File This file defines the transfers to from an unique device Protocol name ADevice bytewise DEBUG DebugOn Packet Start type signal signal 14 level 0 End type length Bytelength 21 Decode Fields Fields StartByte 8m d 2 4 mV CommandByte 81 L FLength 8m h SlaveAddress m h RW 1 L Long 32m h 8Bytes 64m h NextLayer Nm h Protocol name NextLayer bytewise Packet Start type next End type Event End of a packet is signaled by a event event 127 Means the end of the data only for higher layers Decode Fields Fields Rest N h
34. Cut and Paste Hardware Setup To use the Decoder you need to connect the USBee Test Pod to your hardware using the test leads You can either connect the test leads directly to pin headers on your board or use the test clips for attaching to your components The CAN Bus Decoder connects to the digital side of your CAN bus transceiver and only needs to listen to the receiving side of the transceiver such as the QXD pin on the Microchip MCP2551 CAN bus transceiver chip Use signal 0 as the QXD data line and connect the GND line to the digital ground of your system Connect these signals to the CAN bus transceiver IC using the test clips provided Software Setup Activate the below Channel Settings Dialog by clicking the grey tab on the left of the signal names on the main application screen r Channel Settings Signal Selection o dee 56789 A DEF CAN Rx Data Bit Rate bps Minimum ID hex r Maximum ID hex 250000 0 FFFFFFFF Save Cancel On the above dialog box select the CAN data signal what speed the bus is operating at and what filter value for the ID you want if any The bus traffic will be decoded as in the following screen O IDIZ RTRO Cth08 Data 00 11 22 33 44 35 66 77 CROOBD4 ACKO heen 64 USBee QX User s Manual USB BUS SETUP The USB Bus Decoder decodes Low and Full Speed USB It does NOT decode High Speed USB Hardware Setup To use the Decoder yo
35. Manual 203 CWAV_IMPORT unsigned long CWAV_API EnableCountsQX void Return Value e 1 Successful e O Failure DISABLECOUNTSQX This routine disables the frequency and pulse counting Calling Convention CWAV_IMPORT unsigned long CWAV_API DisableCountsQX void Return Value 1 Successful O Failure GETFREQUENCYANDCOUNTSQX This routine returns the frequency and pulse counting values Calling Convention CWAV_IMPORT unsigned long CWAV_API GetFrequencyAndCountsQX unsigned long edgecounts unsigned long edgecounts1 unsigned long edgecounts2 unsigned long edgecounts3 unsigned long freq4 unsigned long freq5 unsigned long freq6 unsigned long freq7 j e Edgecounts0O how many edges were counted on digital channel 0 e Edgecounts1 how many edges were counted on digital channel 1 e Edgecounts2 how many edges were counted on digital channel 2 e Edgecounts3 how many edges were counted on digital channel 3 e Freq4 the frequency measured on digital channel 4 e Freq5 the frequency measured on digital channel 5 e Freq6 the frequency measured on digital channel 6 e Freq7 the frequency measured on digital channel 7 Return Value e 1 Successful 0 Failure 204 USBee QX User s Manual EXAMPLE C CODE The following code listing is an example in very simple C that calls the DLL functions It isa Command Prompt program that generates the following output when run C cwav USBee Advance
36. PID 8 10000111b L Addr 7L d EP 4L d CRC5 5 i Sync 8 i HS 8 01011010b L Handshake Setup Fields Sync 8 i PID 8 10110100b L Addr 71 d EP 41 d CRC5 5 i Sync 8 i PID 8 L Rtype 8 i bRequest 8L 1 SClear Feature bValue 16L h bIndex 16L H bLength 16L H CRC16 16 i Sync 8 i HS 8 L Fields Sync 8 i PID 8 101 Syne 8 i PID 8 L bRequest 8L 0 S Get bLength 16L H CRC 10100b L Addr 71 0 BPs4l 0 CRCS lt 3 1 R S 6 Fields Sync 8 i PID 8 1011 R C 6 type 8 i tatus bValue 16L h bindex 16L H 16 i Sync 8 i HS 8 L 0100b L Addr 71 d EP 41l d CRC5 5 i type 8 i Sy c 8 1i PID 8 L bRequest 8L 8 SGet Configuration bValue 16L h bIndex 16L H bLength 16L H CRC16 16 i Sync 8 i HS 8 L Fields Sync 8 i PID 8 10110100b L Addr 71 d EP 41 d CRC5 5 i Sync 8 i PID 8 L Rtype 8 i bRequest 8L 6 Get Descriptor bValueL 8L I Type 8L L bIndex 16L H bLength 16L H CRC16 16 i Sync 8 i HS 8 L Fields Sync 8 i PID 8 10110100b L Addr 7l d EP 41 d CRC5 5 i Sync 8 i PID 8 L Rtype 8 i bRequest 8L 16 SGet Interface bValue 16L h bIndex 16L H bLength 16L H CRC16 16 i Sync 8 i HS 8 L Fields Sync 8 i PID 8 10110100b L Addr 71 d EP 41 d CRC5 5 i Sync 8 i PID 8 L Rtype 8 i bRequest 8L 5 SSet Address Address 16L h bLength 16L i bLength
37. PS 2 BUS SETUD prinia AEE TE ANT NEO TAANA 76 SETTING VIEWING PREFERENCES io scxciasis ites acu eitic E E A a a udeeeoes 77 GUTS OF COLO S orrie E E E havc de E ete oatama dunt bids 77 BGGCKOVOUNG COLON pecs EA E AE ea acres canis AA EE ee a see 77 GIGSS APD CGIAR CO ra e tae havicGvdestades EE taunted 77 PIE OPERATIONS ina omaceume warcer T oumemmaeeiacedes A tated ormanaeteaes 78 CREATING O NEWFIE nediritan a EEOAE EEO 78 Saving CAPTUTrE FI Ci savnciravtecencckan leds iseeuselecoadutre seeaaudanad REENE 78 Open ang Existing Capture FNE six ecu EE T TT NT 78 RECCNEY Used Fre LIS oaran waters vata AT T A AE 78 Exporting Capt red Data to a Fle sirnane aE OA OET 78 Export Siena Data to Binary File na ina a NRN N a aN 80 USBee QX User s Manual Export Sighal Data to Tex CSV File ihan a 80 Export Bus Data to Text CSV File nunenenarminnnananennnenne nne aa 80 PRINTING i cnscuirtote dey sonatintaiedudecaeddatagee der nen E EE EEEE EO E a 81 CREATING SCREEN SHOTS urari a r aT T 81 SOFTWARE UPDATES oeron an EE O AA 82 DEVELOPING YOUR OWN CUSTOM DECODERS cssccsscesecesccescesccescceseceeceuceeseeaeeneeaes 83 USING INE Cus tont DCCOG EM ierann e a A E E 83 Bullaing the CUSTOM DECOGEN esaer as annar EE EER TARR 85 Example Closs LIDrary COO Cy corse AET T 86 Custom Decoder Parameter Sinerien NNN NEERA 92 Accessing Sample Data to Perform De COdEC cccsescccccsssecceceeeeccecaeeeceesaueeeeeseaaeses 93 Outputting Entries tha
38. Show the Start of capture buffer Show the end of the capture buffer Insert a new waveline below the current line Delete the current waveline Capture Once Go to the X1 cursor Go to the X2 cursor Zoom out to view all of the capture buffer Open the Waveline settings dialog box Toggle the Decoder List window Zoom In Zoom Out Go to the Trigger position USBee QX User s Manual SMART SEARCH USBee QX Suite Smart Search highlights the sections of your trace matching your areas of interest so that you don t need to waste time hunting for the data you need You can specify up to 32 levels of search events that are any combination of bus decoded traffic states or edges of digital or analog signals inside or outside of analog voltage ranges and or digital ranges and all validated by time specific windows Once specified you can pan through the occurrences of your searched items with the click of the mouse and see the total number of times the searched events occur BB UsBee Suite Pro USBee DX Connected File View Speed and Samples Trigger Setup Help e SOus div 293s 2 Digitaro x danmi r ar BE LS vnga Digital3 s 5 SP12 Digital 4 Digital s p BB Channel Settings or Single Signal Digital 7 z A Event 1 If CHi has a falling edge at voltage threshold 4V while n Digital 2 decoded bus data contains ED followed by 1D E Async 6 If Analog Signal CH1 has falling edge at voltage threshol
39. Suite USBee DX Connected File View Speed and Samples Trigger Setup Help lt oN Cursors USBee Capture A Measurements Lagic Analyzer Oscilloscope T Xi X2 dX ax Ons Ons Ons Ons infinity Now we will add an SPI bus which is made up of the first 4 signals We press the small sign near the MISO label to insert the waveline below that line We then get the Channel Settings Dialog and choose the SPI tab The following screen is then displayed we ste ae ne A4 64 FF FF FF Eo BE GBEE rnn From here we select the parameters for this bus shown above and press Save Once we press Save the line is added to the screen the current trace is decoded and the decoded information is shown on the waveline We then add the 12C bus using the Channel Settings dialog box as below with the resulting waveline Aaaa fer yrr irr F909 LIEIL EEE EVE WIE We then add the Async bus using the Channel Settings dialog box as below with the resulting waveline 58 USBee QX User s Manual BB Chane Settings m here PS 2 SMBus S Single Signe Signet Selection TX Data o RX Data o Data Bits p Parity Dats Format TX and RX Baud Rate 6 w None Decimal are Inverted z Even Hex are not Inverted a R O Odd ASCE 250000 80 9010 BCsd OC Bajr o ue A Scans USBee m Logic Analyost Ox ikarspe T xt m2 dX UK Urs Ons Uns Ons intenty Each bus type has various pa
40. USBee QX User s Manual 5 QUICK Setup CONFIGUIGTION mirror ese nates dayaee ETN EEA 41 FHOLINCVS saiceqadiauavattreaacee aad EA E E O Ala 45 SIGIIOIINGQIIES eeni nsa a i 45 Buffer Sizes and Sample Rate settings senceres a ensieee ade 45 Setting SIMPIC Triggers mirae naa aa E OAA EET EA 49 Setting Complex Triggers siz szessarcics lod iceeusavoccedutes speasutahaddedlvdudacelaiaedncceeceucleats 50 CAPTURING WAVEFORM DAT As sist occsansemtiecacn ose a E EEE A EAAS 52 VIEWING CAPTURED DATA toi dicurrenserturdcadeinsenctustabosiiiesortaWvancedteenenattaesmasdere sexsavaaswende 52 Scrolling ZOOMING ANA PANNING Waveforms 1 cccccsseeseceenaeeseececneesecsssaeesees 52 MOGILVING Wave HINCS carnin E E 54 DECOGING BUS Trafic NIINE deen na aaa 56 Decoded Data Ct erare aT E T E E NE 59 Manual Measurements and Cursors sssscccsseeeccsessccnaescccsesecsausecssauseesauaseees 59 Moto Measurements sererek ree T A a a a a as 60 BUS DECODING OPTIONS zirrara a a A E 62 GENCE SIGNG SCUUD arrien a or EA EOE E EO Coe 62 CAN BUSSE UD E ET TOAT O T O AT 64 USB BUS SCC seri E EEN EA AN 65 2C BUS SCLUD arai a A N Ar 66 ASVAC BUS SCUD KEE E E OT E EE AE heer 67 POlOUE BUS SETUD orii e nE RORE AE OTEN OONN 68 LWI E BUS SETUD aoan once tease ET E A TEE EAO oaens 69 SMBUS SETUD eM A O O TI A T A EOT he iaes 70 SIO BUS SETUD rE ETEEN EET NOE 71 SM BUS BUS SCUD are aE EAT E OEE E IAE 73 Serial BUS Set poren a a a E Mabie 74 29 BUS SE UDr i a S 75
41. VIEWING THE PACKETPRESENTER OUTPUT The PacketPresenter output is shown in a window below the waveform screen This window can be shown using the menu item View Show PacketPresenter Window or by clicking and dragging the thin bar between the waveform and PacketPresenter window 126 USBee QX User s Manual SAVING PACKETPRESENTER DATA TO TEXT OR RTF FILES The PacketPresenter output can be saved to either a Text file or an RTF file Rich Text Format The text file output is a textual representation of the packets as seen below Access these features through the File Save As Text or File Save As RTF menu items Layer CYPRESSRFIC DIR INC ADDRESS READDATA Time 615 2797ms Read False CHANNEL ADR 0 Layer USBBUS PID ADDR EP PID INDATA HS Time 616 0198ms IN 2 0 DATAO 22 2A 00 07 05 81 03 08 ACK Layer USBBUS PID ADDR EP PID INDATA HS Time 617 0197ms IN 2 0 DATA1 00 OA 09 04 01 00 01 03 ACK Layer USBBUS PID ADDR EP PID INDATA HS Time 618 0197ms IN 2 0 DATAO 01 02 00 09 21 11 01 00 ACK Layer USBBUS PID ADDR EP PID INDATA HS Time 619 0197ms IN 2 0 DATA1 01 22 D1 00 07 05 82 03 ACK Layer USBBUS PID ADDR EP PID INDATA HS Time 620 0197ms IN 2 O DATAO 040008 ACK USBee QX User s Manual 127 Saving data to an RTF file format saves the graphical nature of the packets and can be read by many word processing programs such as Microsoft Word and WordPad Below is a screenshot of data saved to an RFT file and viewed using WordPad
42. Visual Studio 2010 which can be downloaded from the Microsoft web site 182 USBee QX User s Manual INSTALLING THE USBEE QX TOOLBUILDER The USBee QX Toolbuilder software is included as part of the installation with the USBee QX Suite software and can be downloaded from www usbee com Run the setup exe install program in the downloaded file to install from the web The install program will install the following USBee Toolbuilder files and drivers into their correct location on your system Other files will also be installed but are not necessary for Toolbuilder operation USBEE QX TOOLBUILDER PROJECTS The USBee QX example Toolbuilder projects are located in Program Files USBee QX Suite USBee QX Toolbuilder USBeeQxXToolbuilderInC and Program Files USBee QX Suite USBee QX Toolbuilder USBeeQxXToolbuilderInVB The USBee QX Toolbuilder depends on the files in the directories for proper operation so if you want to relocate the projects to somewhere else you must maintain the entire file directory structure USBee QX User s Manual 183 USBEE QX TOOLBUILDER FUNCTIONS This section details the functions that are available in the usbeeadvste dll and defines the parameters to each call The calling conventions are shown for the C language but you can find the definitions for Visual Basic in the example file as well INITIALIZING THE USBEE QX POD INITIALIZEQX This routine initializes the USBee QX Pod This routine must be called bef
43. as in the following screen 74 USBee QX User s Manual 25 BUS SETUP The 12S Bus Decoder takes the captured data from an 12S bus Hardware Setup To use the Decoder you need to connect the USBee Test Pod to your hardware using the test leads You can either connect the test leads directly to pin headers on your board or use the test clips for attaching to your components The 12S Bus Decoder uses any one of the 24 digital signal lines O thru 21 T and C for the Clock Data and Word Align signal and the GND ground line Connect the Clock Data and Word Align to your digital bus using the test leads and clips Connect the GND line to the digital ground of your system Software Setup Activate the below Channel Settings Dialog by clicking the grey tab on the left of the signal names on the main application screen Channel Settings e J swe Ys cw seat Porates Signal Selection 0128 56789 Ag BE cE Word Align OC Clock gt Data fo Rising Rising msb First Falling Falling Isb First Clock Edge sce gt BitOrder Bits Per Word r Bit Offset On the above dialog box select the signals you plan to use for the I2S Bus protocol Select the start edge for the external word align signal the Bits Word and the Clock sampling edge Choose the bit ordering The bus traffic will be decoded as in the following screen USBee QX User
44. buttons that let you quickly navigate through your trace display Digital DUERI COMPLEX TRIGGERING The USBee QX Suite adds a multi level hardware trigger to capture the events you need to see to solve your problems ZE X X XKAN X X X X X XES X X X p mem 30 USBee QX User s Manual RELATIVE TIME DECODE The USBee QX Suite also adds a Relative Time or Absolute Time setting for the decoded data lists iera 3 TE 5 USBee Suite Pro USBee SX Demo Mode File View SpeedandSamples Trigger Setup Help j P 1 616125ms 1 216125ms 0 001983625 I2C 5 SCL OB docis S Ae 82 083us I2C5 SCL ACK 48 042us I2C 5 SCL S Start 15 75us I2C5 SCL A3 Read 82 042us I2C 5 SCL ACK 51 167us I2C 5 SCL 22 82 042us I2C 5 SCL NACK 59 875us I2C 5 SCL P Stop 160 292us Async 0 TX OB Async 0 TX OC Async 0 RX OD Al 3 Async 0 RX OE na iia 95 333us Async O RX OF 95 375us Async O RX 10 95 375us Async O RX 11 210us SPI2 MISO FF Ons SPI2 MOSI 94 90us SPI2 MISO FF Ons SPI2 MOSI 54 225 083us MISO E8 las x N u x x Ons SPI2 N 91 042us SPI2 MISO 58 Cursors Ons SPI2 MOSI FF USBee Demo Capture Many fr urements Logic Analyzer Oscilloscope T Xi x2 dX 1 dX Period Frequency Duty Cy PE a Ons 1 581625ms 1 895708ms 314 083us 3 183868kHz 10 875us 91 954023kHz 50 2 USBee QX User s Manual 31 USBEE QX CONTROL PANEL The
45. changes state The signal to use for the detection is specified in the Parameters as the second parameter Dim Params Parameters Split CChar Dim SignalToUse As Double Val Params 1 Dim SignalMask As Integer 1 lt lt CInt SignalToUse Make the mask that will mask off the channel we want in the sample Now go from the start of the samples to the end and process the decoder For Sample To NumberOfSamples 1 This example decoder places a label at every transition of digital signal 0 Dim DigitalChannel As UInteger CUInt SampleData Sample And SignalMask If DigitalChannel lt gt OldSample And OldSample Then WriteEntry BW Sample Sample 100 Rise End IF OldSample DigitalChannel Next ElseIf CBool InStr Parameters ToUpper HELLOWORLD Then Simplest Decoder Possible Print Hello World at the start of the buffer WriteEntry BW 100 Hello World WriteEntry BW GTriggerSample GTriggerSample 100 Trigger Is Here WriteEntry BW GX1Sample GX1Sample 100 X1 Is Here WriteEntry BW GX2Sample GX2Sample 100 X2 Is Here ElseIf CBool InStr Parameters ToUpper NECIR Then NEC IR Decoder 3 0 WriteEntry BW 100 NEC IR Decoder 3 0 Dim Params Parameters Split CChar Dim SignalToUse As Double Val Params 1 Dim SignalMask As Integer 1 lt lt CInt SignalToUse Make the mask that will mask off the channel we want in the sample Const LOOKING_FO
46. channel unsigned unsigned unsigned unsigned unsigned unsigned unsigned unsigned unsigned unsigned unsigned unsigned unsigned unsigned unsigned unsigned unsigned long CWAV_API PowerOnAnalogQx Turn on the Power to the Analog Channels long CWAV_API PowerOffAnalogQx Turn off the Power to the Analog Channels long CWAV_API GenerateAnalogWaveformQX unsigned long SamplesPerSecond unsigned char SamplesPerCycle unsigned char samples long CWAV_API GeneratePWMWaveformQX unsigned char channel unsigned long samplespersecond unsigned char dutycycle long CWAV_API LoadDigitalWaveformQxX unsigned long numberofsamples unsigned char samples long CWAV_API GenerateDigitalWaveformQX unsigned char channelmask unsigned char GenerateOn unsigned char loop unsigned char waitT unsigned char Trising unsigned char externalclock unsigned char Crising unsigned long samplespersecond long CWAV_API GetFrequencyAndCountsQx unsigned long edgecounts unsigned long edgecounts1 unsigned long edgecounts2 unsigned long edgecounts3 unsigned long freq4 unsigned long freq5 unsigned long freq6 unsigned long freq7 ys long CWAV_API ClearCountsQX void long CWAV_API EnableCountsQX void long CWAV_API DisableCountsQX void long CWAV_API SetTriggersQxX int TrigXEnabled int TrigYEnabled int TrigXorYEnabled int TrigXandYEnabled int TrigXthenYEnabled int TrigYthenXEnabled int TrigX_DigitalEd
47. ck Setup 16 Digital and 2 Analog Channe Quick Setup SPI Bus on Signals 0 1 2 and 3 Quick Setup I2C on Signals 4 and 5 ick Setup Async on Signals 6 and 7 ooj fa A FE M 09 fis l 30 O aO A i g i A r iH A V js 116 17 18 Cursors T USBee RX Suite S Logic Analyzer Oscilloscope Copyright 2032 OWAN te Ail tighe Reserve D d arat Mearnatacturwet andy in the LISA UE Aera TILLE aai phe pants peretirgy The FAST button sets the Sample Rate and buffer size to give the fastest screen update rates Below are examples of the application in various modes a Us m he yida EEEa Contd tan Tas Bee a pan ce Vita whe Jee e ea Coen Taw nea an pak eM Me Am admisa Tyi ten IME Me Am admite Tygi i gt Iae p ano e iP UP tA Re aweue we p USBee RX Sulte a ee pee cage Laine Need de pt nag 16 Digital 2 Analog Channels 8 Digital O Analog Channels 42 USBee QX User s Manual Usha Sw ee Coen en a ee tee gaan E d Ta US m de Jidat DEEE Coen Mit ae Eroa pak a Ma Am smitare Wy un Iide Me Am astara Wy uns Iide CERTA ane Sanit USBee RX Suite MGR i gt sigan epee Swine pasa Y s 5 Gl 8 Digital 1 Analog Channels 0 Digital 2 Analog Channels There are also three other Quick Setup features that let you instantly setup an 12C SPI or ASYNC decoder line The Quick Setup SPI configures the first 4 lines to be an SPI bus with the SS SCK MOSI and MISO
48. connected via USB This mainly concerns systems where the target circuit AND the PC are plugged into AC power outlets If your target system OR the PC Laptop are battery powered there is no issue If your PC and target circuit have different ground reference levels connecting them together using the USBee GND signal can damage the devices To ensure both your PC and target system share the same ground reference do the following Use polarized power cords for both the PC and target and plug them into the same AC circuit If you use non polarized power cords or use separate power circuits the PC and target system may have different ground references which can damage the USBee target and or PC Ensure that a GND signal on the USBee is connected to the target ground and not another voltage level Or use the USBee in WiFi connected mode This gives a galvanically isolated setup Also As with all electronic equipment where you are working with live voltages it is possible to hurt yourself or damage equipment if not used properly Although we have designed the USBee QX pod for normal operating conditions you can cause serious harm to humans and equipment by using the pod in conditions for which it is not specified Specifically ALWAYS connect at least one GND line to your circuits ground NEVER connect the digital signal lines O thru 21 T and C to any voltage other than between 60 to 60 Volts NEVER connect the analog signal
49. e AlignValue When using word aligning bus value which is used for aligning the serial stream to byte boundaries AlignEdge When using an external signal for aligning O falling edge 1 rising edge e AlignChannel When using an external signal for aligning which signal 0 15 to use for the align signal USBee QX User s Manual 199 e UseAlignChannel 0 use word aligning 1 use external align signal e ClockChannel Which signal 0 15 to use for the clock signal e CLKEdge 0 use falling edge of the Clock to sample data 1 use rising edge e BitsPerValue how many bits are in each word of the serial stream MSBFirst O LSBit is sent first 1 MSBit is sent first Delimeter 0 no delimiter 1 Comma delimeter 2 Space delimeter e Showall 0 Only show the data payload 1 show all packet details e Hex 0 display data in decimal 1 display data in hex e BytesPerLine How many output words are on each output line e ProtocolDefinitionFilename filename for the Protocol Definition File to use to create a PacketPresenter file If this value is O then the PacketPresenter feature is turned off e ProtocolOutputFilename filename that is created for the output of the PacketPresenter e ErrorString string that holds an error description of the routine returns an error Return Value TRUE No Error during processing e FALSE Error while processing The ErrorString contains a descriptio
50. edge is stored in 2 samples The samples are taken at 100Msps giving a sample resolution of 10ns The onboard 32MSample buffer is also used as a FIFO buffer that allows for bursts of high throughput transactions For example capturing a 100 utilized 12C bus running at 100kHz SCL would have the following bandwidth Each SDA clock is 2 edges giving 200k edges sec Each edge is stored in 2 samples giving 400k samples sec If we capture in the 15 Digital Channels mode that is 2 bytes per sample giving a needed bandwidth of 800k Bytes second bandwidth This bandwidth is easily achievable on any PC system The resulting storage duration then is the disk file size limit divided by 800k For a disk file of size 100G you can store this bus for 125 000 seconds or 34 7 hours Obviously if the bus is not operating continuously the capture time will be longer proportional to the amount of utilization As another example 50MHz SDIO can also be captured and streamed to disk Although the instantanious capture bandwidth of the transactions is beyond the write bandwidth of many hard disks gt 200Mbytes sec the onboard 32Msps buffer can store the fast samples and be used as an elasticity buffer As long as the average bus utilization is within the streaming bandwidth it can store the transactions USBee QX User s Manual 215 REGISTERING THE MODULE In order to register software modules you must have e USBee QX Suite software suite installed on the P
51. either connect the test leads directly to pin headers on your board or use the test clips for attaching to your components The Serial Bus Decoder uses any one of the 24 digital signal lines O thru 21 T and C for the Clock Data and optional Word Align signal and the GND ground line Connect the Clock Data and Word Align to your digital bus using the test leads and clips Connect the GND line to the digital ground of your system Software Setup Activate the below Channel Settings Dialog by clicking the white box on the left of the signal names on the main application screen E Channel Settings m i f Singe signal uss f s c async __ Ps2 smuss os cmn Sei Signal Selection org Word Align 56789 AG DEF Clock C Data ce Clock Edge gt Align Mode AlignEdge gt BitOrder r Bits q Align Value hex Rising Signal Rising msb First fa Falling Value Falling Isb First z Cancel On the above dialog box select the signals you plan to use for the Serial Bus protocol Select whether you have an external word align signal Align Mode Signal or if your serial data has an embedded sync word in the data stream Align Mode Value The Bits Word is the size of the Sync word as well as the output word size Choose the bit ordering as well as the output format of the traffic The bus traffic will be decoded
52. ewan acme emanates 149 IPIVENEINE DECOC Sie wucaes na aN N NENNE 149 EXD ANGING Decoder cnno A 149 USBee QX User s Manual COMPFESSING Decoder arana 150 WiUITIPlE DEGOGENS urninenaria n E renee bane eatee eae 151 PacketPresenter Definition File DEDUQGGING ccsssseseccceseeseceesaneseesseaeeseesees 151 PacketPresenter SDCCITICOLIONS evncscctoratyce cavned sebdegianvervosdtebivelssdtetoes mehiselorvsiae 152 Example Protocol Files and Output EXOMPIesS csssscccccssessecccneeeseeesaneesees 153 ASV Protocol Example norrena res EA AEEA unsere ETEA anaes 153 I2C Protocol Examples uscccwsccs n E eines 154 SPIMPLOLOCOM EX aM ple paira T E E 155 GAN Protocol Example innari a TNA EA NA ASEN 157 SDIO Protocol Example aeiia a a 157 LAW VIE Protocol EXaMPlE sssaaa rE ns Atm ead apenas 161 Patallel PEOlLOCOMEX ain suse cscsaneancccerticscsepbin nes E oem eie oes 162 Serial Protocol EXamplesrccccank ernie A aawties 163 WSB Protocol Example sicastinwicheen emma emanate 164 PS2PROLOCO IE X alii Enana NENNEN ENAN 166 USBEE QX ANALOG SIGNAL GENERATOR csccscscsccscscsscscscsscscscsccscscescecs 167 USBEE QX LOGIC PROBE AND DIGITAL VOLTAGE METER sccscscsscscsecees 169 USBEE DIGITAL LOGIC THRESHOLD sesesessscesescscesescecesescecesescesesescscesesosseso 170 USBEE QX DIGITAL SIGNAL GENERATOR csccscscsccscsccccscscsccscscescscscescecs 171 PULSE WIDTH MODULATORS racire ei Uonous a a Aluaeinw
53. files and automatically close 180 USBee QX User s Manual Below is a batch file that executes a single Capture to a file echo off REM USBee QX Suite Automation REM NOTE Requires USBee QX Suite version 1 3 11 or later REM Description The USBee QX Suite has automation built in that let s you setup your configuration and use REM it repeatedly to start capture trigger export CSV data export screenshots and exit without user intervention REM To use automation you first need to create a capture file that has all of the configuration and settings you REM desire To do this run the Software and setup the way you need including triggers decoding sample rate size REM search etc Finally Capture and save this file by using the file menu Save As and name the file setup usbeeqx REM or something similar It would probably be easiest if you saved this file into the directory where the program REM is located ie C Program Files x86 CWAV Inc USBee QX Suite REM Next to use automation open a command prompt and navigate to the above directory and use the following REM command line format REM USBee Suite exe lt intput filename gt lt output base filename gt lt flags gt REM lt input filename gt is the complete filename including extension that will be loaded and used for capture REM lt output base filename gt is the first part of the output file names that will be generated after the capture is complete REM lt flags gt
54. first dropdown box Then choose the edge you want to search for rising falling or either rising or falling Next enter the voltage threshold at which you consider the edge occurring This value can be anywhere between 10 and 10 and can include decimal places Finally choose how many edges you need to find consecutively If you want to find areas that have NO edges you can specify 0 Below shows a search that finds all rising edges of the analog signal CH1 with a threshold set at 2 0 Volts Since the waveform display below is zoomed out the match is shown as simply a line Zooming in on the search will show the details l Pro USBee DX Connes d u a J E Channel Settings File View Speed and Samples Trigger Setup Help SingleSigal Y uss spr mc Async 500us div _ 14645667ms_ aaa SMBus s can seii Parallel Search ze Al Event 1 If CH1 has a rising edge at voltage threshold 2V Digital 0 IL If Digital Signal Digita has sing edge happen times or Digital I v If Analog Signal CH1 has rising v edge at voltage threshold 2 Voltshappens 1 times og 319 Digital 2 while Digital 3 SPL2 00 and and Digital 4 Digital S RCs Digital 6 Digital7 Speen Async 6 Event 2 Followed By Event 3 Followed By Event 4 Followed By vl Event 5 Followed By t 6 Cursors Even Capture Once Capture Many Measi USBee opire nre apie vany Use PacketPresenter Definition File na
55. foot USB cable USB 3 0 or USB 2 0 compatible e CH1 CH2 CH3 CH4 O O O O Analog Input Channels BNC connectors for standard oscilloscope probes 60V tolerant Sampled at up to 100MHz e Digital Inputs Connector O O O O O 18 pins 9x2 2 Ground G and 16 Digital inputs 0 15 0 1 spaced 0 025 square header pins 60V tolerant inputs Connects to 1x2 pin Ground test lead set and 2 4x2 pin signal test lead sets Sampled at up to 600MHz e Digital Input Outputs connector O O O O O O O 8 pins 8 Digital Inputs or Outputs 16 21 plus T and C Mode is set from USBee QX Suite Control Panel 0 1 spaced 0 025 square header pins Digital Output pins are 0 2 5V logic with 600ohm series current limiting resistor Outputs clocked at up to 100MHz 6V tolerant inputs Inputs sampled at up to 600MHz Connects to 4x2 pin test lead set Analog Outputs connector O O O 3 pins 1 Ground GND 1 Analog Aout 1 5V Supply 0 1 spaced 0 025 square header pins 5V output actually VBus connected directly to the USB VBus signal from the PC through a resettable fuse or from the included power supply 1 Aout analog output pin used by the Analog Signal Generator function 0 3V levels Connects to single leads Grey Red Green USBee QX User s Manual WARNING The USBee is galvanically isolated when connected via WiFi but is NOT galvanically isolated when
56. i Hatara Digital 7 Digitals Digitar s pann nia Digitale igital 6 a Digilal 7 Mpigi To Move a Waveline simply click on the gray tab on the left and drag it to the new position Below shows the Digital O signal moved to the bottom MES Usi Cuers EEE F h Com E m Rie Yew Soest pnd Stn bl jerisi Hep Oh E Re View SoredardSoncks Trigger Setup Help g a usid aid tiin situs at Latins 20s di ue ott nigra a jigit Digitar Digital 3 Jicjitail 4 Jaita 4 Digital S Digital s Digital 6 Higitar6 Vgitar7 Digitaro Consens UsB e oe Lage Arahrentecizerspe Eag xx on Ore Teo Ou Cra infeaty To Add a Waveline click on the small sign above where you want to insert the new waveline Below you see a new waveline inserted after the first waveline jigit Digital 1 Digital 3 Bie 3 ital 4 Jigi 4 IAA Digitals jigiars Digital 6 igitar 7 anes hd jigital giay Digitaro Digitaro we When you insert a new waveline the Channel Selection dialog box appears for you to choose the settings for that waveline Below shows the Channel Settings Dialog Box E Channel Settings a 4 a 3 Ps 2 Parallel Single Signal 012 56789AR Signal to Display Save Cancel Once you select the properties of the new waveline it will be displayed with the other signals Below shows a new line added that shows the Digital 2 single signal USBee QX User s Manual 5
57. in text in line with the waveform The PacketPresenter feature runs alongside of the existing bus decoders of the USBee QX Suite The PacketPresenter takes the output of raw binary data from the bus decoder and parses the stream according to users PacketPresenter Definition File for the intent of displaying the communications in easily understood graphical displays The resulting packets are then displayed in a window below the waveforms USBee QX User s Manual 123 To Show the PacketPresenter window choose the menu item View Show PacketPresenter Window To resize the window click and drag the thin bar between the PacketPresenter window and the waveforms Protocols are defined using a text file called a PacketPresenter Definition File which specifies the fields within the protocol and how to display that information on the screen It is intended to be generic enough that customers can create their own protocol decoders for their own custom bus types Initially all bus types use a generic PacketPresenter file to display the bus data for that bus You can then create and customize your own PacketPresenter file for any bus It is assumed that each PacketPresenter Definition File will correspond to one single bus type and that the incoming bytes from that bus will be inputs for the decoding process This steam of data is called an incoming Data Stream and it is handled by a Protocol Processor Each Protocol Processor takes a single inc
58. int CWAV_API APIDecode char Protocol char bitIn char bitsOut char reset static everyother 0 if stremp Protocol COMPRESS if reset Reset the state of the decoder if reset TRUE everyother 0 if everyother bitsOut bitin return 1 Indicates that there is 1 return data bit everyother 0 else everyother 1 return 0 Indicates that there are no return data bits else if strcemp Protocol EXPAND bitsOutt bitin bitsOutt t bitin return 2 Indicates that there is 2 return data bits No matching decoder label found so just loopback the data bitsOut bitIn return 1 PACKETPRESENTER DEFINITION FILE DEBUGGING Creating your PacketPresenter Definition File can be made simpler using the Debug mode To turn on Debug mode use the DebugOn keyword in ALL DEBUG sections of the Definition File Protocol name I2CKKPROM DEBUG DebugOn Turns On Debug Mode Comment it out to turn it off Packet When debug mode is on each packet is output twice in its raw form showing the data values as well as the events from the bus The first debug line is the initial bus data The second line is the bus data after any decoding is completed Following the debug lines are the PacketPresenter output packets from this same data Below is a screen shot that shows the PacketPresenter that has Debug turned on USBee QX U
59. key to making the USBee the best embedded development tool on the market Email us at support usbee com or Call us at 951 694 6808 USBee QX User s Manual 221 Copyright 2015 CWAV All Rights Reserved Printed in the USA Version 1 5 222 USBee QX User s Manual
60. labels and which signal is associated Time 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 1 C CH1 CH2 CH3 CH4 0 008739333 1 1 1 0 1 1 1 1 1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0 1 02 2 56 0 01 0 01 0 008739500 1 1 1 0 1 1 1 1 1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0 1 02 2 56 0 01 0 01 0 008739667 1 1 1 0 1 1 1 1 1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0 1 02 2 56 0 01 0 01 0 008739833 1 1 1 0 1 1 1 1 1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0 1 02 2 56 0 01 0 01 0 008740000 1 1 1 0 1 1 1 1 1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0 1 02 2 56 0 01 0 01 0 008740167 1 1 1 0 1 1 1 1 1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0 1 02 2 56 0 01 0 01 0 008740333 1 1 1 0 1 1 1 1 1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0 1 02 2 56 0 01 0 01 0 008740500 1 1 1 0 1 1 1 1 1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0 1 02 2 56 0 01 0 01 0 008740667 1 1 1 0 1 1 1 1 1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0 1 02 2 56 0 01 0 01 0 008740833 1 1 1 0 1 1 1 1 1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0 1 02 2 56 0 01 0 01 EXPORT BUS DATA TO TEXT CSV FILE 80 USBee QX User s Manual When exporting bus data to a text csv file each decoded element is output to a single line with each field separated by acomma An example output file is formatted as follows showing a header that specifies the column labels and which signal is associated Time seconds Bus Name Signal Name Data 0 000007167 SPI 3 MOSI FF 0 000007167 SPI 3 MISO 24 0 000106333 SPI 3 MOSI FF 0 000106333 SPI 3 MISO A4 0 000238667 SPI 3 MOSI 48 0 000238667 SPI 3 MISO FF 0 000338000 SPI 3 MOSI A8
61. lt gt 5 Then Add this bit to the accumulators LSB first ByteAccumlator ByteAccumlator gt gt 1 Shift the Accumulator ByteAccumlator ByteAccumlator And amp H7F Clear out the MSBit Mark the start of the byte if so If BitCounter Then ByteStartSample Sample Next Bit next time BitCounter BitCounter 1 90 USBee QX User s Manual End If tNumberOfOnes Sample tEdge2 ElseIf tPulseWidth gt 0 000012 And tPulseWidth lt 0 000019 Then The bit is al tNumberOfOnes tNumberOfOnes 1 We are already at the start of the next bit Write out a bit data marker WriteEntry BW Sample tEdge1 1 9 09 Add this bit to the accumulators LSB first ByteAccumlator ByteAccumlator gt gt 1 Shift the Accumulator ByteAccumlator ByteAccumlator Or amp H8 Set the MSBit Mark the start of the byte if so If BitCounter Then ByteStartSample Sample Next Bit next time BitCounter BitCounter 1 Sample tEdge1 Else Pulse is not the right size so bail and keep looking WriteEntry BW Sample tEdge1 x 900 WriteEntry BW Sample Sample 10 Bogus Sample tEdge1 DecodeState LOOKING_FOR_START tBits 0 Continue For End If Else No edges at all So we are done Exit For End If End If Next ElseIf CBool InStr Parameters ToUpper ARINC429 Then NEC IR Decoder 3 0 WriteEntry BW 100 ARINC 429 Decoder Dim Params Parameters Split CChar
62. ly h TXB15 1ly h TXB8 1y h TXB1 ly h TXBERR ly h TXC ly h TXE ly h QX BUFFER ADR Read and Write Command Fields Dir ly 0 L Tnevly ete Address 6y 21h L Dummy 8x i OXData Nx h Fields Dir ly 1 L IMe ly tt Address 6y 21h L QOXData Ny h TX BUFFER ADR Read and Write Command Fields Dir ly 0 L Iinc ly tt Address 6y 20h L Dummy 8x i TxData Nx h Fields Dir ly 1 L Imes ystt Address 6y 20h L TxData Ny h Fields Dir ly 0 L Inc ly tf Address 6y L Dummy 8x i ReadData Nx h Fields Dir ly 1 L Inc ly tf Address 6y L WriteData Nmy h Lookup Dir 0 SRead 1 SWrite Lookup Address 00h CHANNEL_ ADR 01h TX_LENGTH_ADR 02h TX_CTRL_ADR 03h TX_CFG_ADR 04h TX_IRQ STATUS ADR 05h SQX CTRL ADR 06h QX CFG ADR O7h SQX IRQ STATUS ADR 08h SQX STATUS ADR 09h SQX COUNT ADR Oah SQX LENGTH ADR Obh PWR_CTRL_ ADR Och SXTAL_ CTRL ADR Odh SIO CFG ADR Oeh SGPIO CTRL ADR Ofh XACT CFG ADR 10h FRAMING CFG ADR 11h DATA32_ THOLD ADR 12h DATA64 THOLD ADR 13h SRSSI_ADR 14h SEOP CTRL ADR 15h SCRC SEED LSB ADR 16h SCRC SEED MSB ADR 17h TX_CRC_LSB_ADR 18h TX_CRC_MSB ADR 19h QX_CRC_LSB ADR USBee QX User s Manual 155 lah QX CRC_MSB ADR 1bh TX OFFSET LSB ADR 1ch TX OFFSET MSB ADR 1dh MODE_OVERRIDE ADR leh QX_ OVERRIDE ADR 1fh TX OVERRIDE ADR 26h XTAL CFG ADR 27h CLK_ OVERRIDE ADR 28h SCLK_EN ADR 29h QX_ ABORT ADR 32h SAUTO CAL TIME ADR 35h SAUTO CAL OFFSET
63. one byte X for every one byte Y Each sample of all channels is the data word sent to channel X The data stream contains the Sync PIDs data fields and CRCs Table 1 Channel X and Channel Y Definitions Per Bus Type PACKET SECTION USBee QX User s Manual The Packet section defines how a packet is bounded and what if any preprocessing needs to be done on the packet before the fields can be processed Packet Start How does a packet start End How does a packet end Decode What decoding needs to be done to get real data START AND END SECTIONS The Start and End sections define how a packet is bounded The available packet bounding Types are defined below For START Next The next byte or bit is assumed the start of a packet Signal An external signal indicates the start of a packet Value A specific value in the data indicates the start of a packet Event A bus specific bus Event or Events indicates the start of a packet For END Next The next byte or bit is assumed the end of a packet Signal An external signal indicates the end of a packet Value A specific value in the data indicates the end of a packet Length A specific or calculated length determines the end of a packet Event A bus specific bus Event or Events indicates the end of a packet Timeout A packet ends after a set timeout without data or events TYPE NEXT The start or end of a packet is the n
64. right size so bail and keep looking WriteEntry BW Sample tEdgei x 900 Sample tEdge1 tBits 0 Continue For End If Else No edges at all So we are done Exit For End If ElseIf DecodeState LOOKING_FOR_BITS Then Now look for the next edge If BitCounter 8 Then We have an entire byte worth of data so output the information WriteEntry BW ByteStartSample Sample Hex ByteAccumlator If PPOn Then SendDataToPacketPresenter PPInFilename ByteStartSample ByteAccumlator 8 1 BitCounter ByteAccumlator 0 End If tEdge1 FindNextEdge Sample SignalMask 1 If tEdge1 gt Then We found the next edge Check to see if this falling edge is in the right timeframe tPulseWidth tEdge1l Sample SamplingRate If tPulseWidth gt 000004 And tPulseWidth lt 0011 Then The bit is a which starts the byte stream Now get us to the start of the next bit tEdge2 FindNextEdge tEdge1 SignalMask 1 Validate that the duration from the previous edge to this edge is within limits tPulseWidth tEdge2 tEdge1 SamplingRate If tPulseWidth gt 0 000011 Or tPulseWidth lt 0 000004 Then WriteEntry BW Sample Sample 10 Bogus 2 Sample tEdge2 DecodeState LOOKING_FOR_START tBits Continue For End If Write out a bit data marker WriteEntry BW Sample tEdge2 9 09 Now check to see if we need to ignore this bit due to bit stuffing If tNumberOfOnes
65. the width of the Decoded Bus Listing window by clicking and dragging the vertical line to the left of the window MANUAL MEASUREMENTS AND CURSORS The main reason for using an oscilloscope or logic analyzer is to measure the various parts of a waveform The USBee QX Suite uses cursors to help in these measurements USBee QX User s Manual 59 a USBee Suite Pro USBee RX Connected C cwav USBee Test Files ProtocolSetup usbee La Pm iv USB E JJus 24us ibus us Bus 1 us 24us 32us 4 us f vo Digitaro m amp Digital T Digitar 7 Ea Digitars 4 ie Digitar6 Digitar7 Async o BS BAZES S BBS a x a aM sample 20M Capture Once Capture Many G a g Tua a r ah Tagger Settings j i Y AT TS The X1 and X2 Cursors are placed on any horizontal sample time This lets you measure the time at a specific location or the time between the two cursors To place the X cursors move the mouse to the gray Cursors box just below the waveform When you move the mouse in this window you will see a temporary line that indicates where the cursors will be placed Place the X1 cursor by left clicking the mouse at the current location Place the X2 cursor by right clicking the mouse at the current location These cursors will snap to the exact edge of a digital signal when the mouse moves close to the edge This lets you easily get exact measurements between edges of signals In the Measurement win
66. usbeerx r File View Speed and Samples Trigger Setup Help A USBee RX Control Pane Digital Generator or FilenDigSigGencsy Edit Samples Loaded 2116 J toop WatforT T Rising iSempececkis 24000000 ime Sample Cock is extemal on Cinput 1 Capture Once Capture Many UE Potent 7 91 570 and sabas paes prety 168 USBee QX User s Manual USBEE QX LOGIC PROBE AND DIGITAL VOLTAGE METER The USBee QX constantly monitors the state of all of the digital inputs and the voltage levels of the CH1 and CH2 inputs This way you can see the state of the channels even at times you are not capturing waveforms using the Mixed Signal Oscilloscope These levels are updated every 500msecs USBee QX User s Manual 169 USBEE DIGITAL LOGIC THRESHOLD The USBee QX features variable Digital Logic Thresholds that can range from 1V to 2V Set this logic threshold to define the voltage level that indicates the change from a logic O to a logic 1 If this level is set incorrectly or too close to either the top or bottom of your logic range you will see inconsistent waveforms and this level will need to be adjusted 170 USBee QX User s Manual USBEE QX DIGITAL SIGNAL GENERATOR The USBee QX has a Digital Signal Generator built in It outputs a digital voltage pattern on the 16 through 21 T and C signals out the side of the Pod To specify what waveform pattern is generated on each of the output signa
67. 16L i CRC16 16 i Sync 8 i HS 8 L Fields Sync 8 i PID 8 10110100b L Addr 71 d EP 41 d CRC5 5 i Sync 8 i PID 8 L Rtype 8 i bRequest 8L 9 SSet Configuration Config 16L h bLength 16L i bLength 16L i CRC16 16 i Sync 8 i HS 8 L Fields Sync 8 i PID 8 10110100b L Addr 71 d EP 41 d CRC5 5 i Sync 8 i PID 8 L Rtype 8 i bRequest 8L 7 SSet Descriptor bValue 16L h bIndex 16L H bLength 16L H CRC16 16 i Sync 8 i HS 8 L Fields Sync 8 i PID 8 10110100b L Addr 71 d EP 41 d CRC5 5 i Sync 8 i PID 8 L Rtype 8 i bRequest 8L 3 SSet Feature bValue 16L h bIndex 16L H bLength 16L H CRC16 16 i Sync 8 i HS 8 L 164 USBee QX User s Manual Fields Sync 8 i PID 8 10110100b L Addr 71 d EP 41 d CRC5 5 i Sync 8 i PID 8 L Rtype 8 i bRequest 8L 10 SGet Interface bValue 16L h bIndex 16L H bLength 16L H CRC16 16 i Sync 8 i HS 8 L Fields Sync 8 i PID 8 10110100b L Addr 71 d EP 41 d CRC5 5 i Sync 8 i PID 8 L Rtype 8 i bRequest 8L 11 SSet Interface AltSetting 16L h Interface 16L H bLength 16L H CRC16 16 1 Synec 8 i HS 8 L Fields Sync 8 i PID 8 10110100b L Addr 71 d EP 41 d CRC5 5 i Sync 8 i PID 8 L Rtype 8 i bRequest 8L 12 SSync Frame bValue 16L h bIndex 16L H bLength 16L H CRC16 16 i Sync 8 i HS 8 L IN Fields Sync 8 i PID 8 10010110b L
68. 2 Fields Fieldi 1 Field2 If there is a start bit between the 2 fields then that Field Line will be processed And use the following to require that a Start Bit is NOT present between field1 and field2 Fields Fieldi 1 Field2 If there is a start bit between the 2 fields then that Field Line will not be processed The Bus Events are defined in Error Reference source not found LOOKUP TABLES Often fields contain values that mean something unrelated to the actual number of the data Lookup Tables provide a way to output a string of text instead of a data value for a field For each field wanting to use a lookup table use the L output modifier in the field format and then define the table in the FIELDS section using the LOOKUP keyword The format of the Lookup table is as follows LOOKUP Fieldname valuel Sstringl value2 Sstring2 Fieldname is the name of the field associated with this lookup table va uen refers to the actual data value of the field stringn is the text string that is output instead of the valuen If a lookup entry is not present for the data value not found in the Lookup Table or the Lookup Table does not exist then the data value is output For example the following table will assign the text strings for various values of the data for the CommanaByte field When the field CommandByte 8 L is processed the strings are output instead of the value Lookup CommandByte 0 SRead 1 SWrite
69. 26 200ksps O 105 100ksps e Signal Which signal 0 15 to use for the 1 Wire signal e Delimeter 0 no delimiter 1 Comma delimeter 2 Space delimeter e Showall 0 Only show the data payload 1 show all packet details e Hex 0 display data in decimal 1 display data in hex e ProtocolDefinitionFilename filename for the Protocol Definition File to use to create a PacketPresenter file If this value is O then the PacketPresenter feature is turned off e ProtocolOutputFilename filename that is created for the output of the PacketPresenter e ErrorString string that holds an error description of the routine returns an error Return Value USBee QX User s Manual 197 TRUE No Error during processing e FALSE Error while processing The ErrorString contains a description of the error to present to the user _DECODEPARALLEL This routine decodes bus traffic and outputs the data to an output file This routine works ona sample buffer captured using the StartCapture routine Calling Convention CWAV_IMPORT int CWAV_API DecodeParallel unsigned __int64 reservedi unsigned char OutFilename unsigned char InlineFilename int64 StartSample __int64 EndSample long Rate unsigned long Channels unsigned long Clock unsigned long UseCLK long CLKEdge unsigned long delimiter unsigned long hex long BytesPerLine char ProtocolDefinitionFilename char ProtocolOutputFilename char ErrorString
70. 4000000 24Msps Parameters User defined string passed from the USBee Suite user interface Channel Setting for the custom decoder 3 Use this string to pass in any parameters that your decoder needs to know such as what channels to use i in decoding which protocol if you have multiple protocols supported here and how you want the data formatted Below is an example set of a few Custom Protocol decoders that show how to access the sample buffer and how to generate output that get sent to the screen through WriteEntry and through the PacketPresenter through SendDataToPacketPresenter and SendEventToPacketPresenter Setup the File Stream that stores the Output Entry Information Dim FS As New FileStream OutFilename FileMode Append FileAccess Write Dim BW As New BinaryWriter FS Dim Sample As Int64 SampleData Initializes the sample retrieval 86 USBee QX User s Manual Since this file supports many different custom decoders we need to see which one to run for this pass based on the Parameters string This Parameters is a string that the use enters in the Suite GUI for this Custom waveline The entire string contains all of the paramers for the decode and therefore needs to be parsed to extract any parameter settings for this decode If CBool InStr Parameters ToUpper CHANGE Then Sample Decoder that just detects when a signal changes state The signal to use for the detection is specified in the Parameters
71. 5 CMD36 CMD37 ERASE CMD39 CMD40 CMD41 LOCK_UNLOCK CMD43 CMD44 CMD45 6 7 8 SCMD4 SCMD4 SCMD4 SCMD49 SCMD50 SCMD51 SCMD52 SCMD53 SCMD54 SAPP_CMD SGEN_CMD SCMD57 SCMD58 SCMD59 SCMD60 SCMD61 SCMD62 SCMD63 Lookup ACMD 6 13 23 42 22 41 SSET BUS WIDTH SSD_STATUS SEND_NUM WR BLOCKS SSET WR BLK ERASE COUNT SD_APP OP COND SET CLR CARD DETECT 5 USBee SEND_SCR QX User s Manual 159 160 USBee QX User s Manual 1 WIRE PROTOCOL EXAMPLE One Wire Protocol Definition File This file defines the transfers to from some 1 Wire devices using the 1 Wire bus F Protocol name OneWireBus bytewise DEBUG DebugOn Uncomment this to turn on Debug Packets Packet Start type event event 2 Presence Pulse End type event event 1 Reset Pulse Decode Fields These fields are used by Maxim Dallas Digital Thermometers Fields ROMCommand 8 FOh Search Rom Data N h Fields ROMCommand 8 33h Read Rom Family 8 h SerialNumber 48 h CRC 8 h Fields ROMCommand 8 55h Match Rom Family 8 h SerialNumber 48 h CRC 8 h Fields ROMCommand 8 CCh Skip ROM Function 8 44h SConvertTemp Fields ROMCommand 8 CCh Skip ROM Function 8 BEh SRead Scratchpad Temp 16 d TH 8 h TL 81 h Rsvd 16 i Remain 8 h CpC 8 h
72. 5 Digia Digitar BIS 3 2 gitar Nital 3 IAA N Jie EL gitar y gitar Digital 6 j Digital 6 x ELEA EEE A Digital 0 j f Digital 0 Lax a iwgan Tsy tele tom ot tex Ore tro n ira infenty IDEI Jdi VEER Ore iro r Cro im asty We will go through creating Bus wavelines that decode bus traffic in line in the next section To Modify an Existing Waveline click on the grey tab on the left of the waveline This will bring up the Channel Settings dialog box and allow you to change the settings for that line Below we modified the last line to show Digital 2 signal instead of the Digital O signal B B Eses Suite Bos OX Scmeced T E E re a had eae he be Bo ee tt 00 gt ory nia Digitar Digitar gitar Digital 2 x Digitals IAA igital4 z yiga Digitas Digital 6 Digitare ELERA Digital a Digital 0 Digitar s Eao Ore io n fra ieFesty DECODING BUS TRAFFIC INLINE The USBee QX Suite software can decode certain types of serial busses automatically and display that information in line with the waveforms Below is an example of a screen that shows 3 different serial bus decoders at the same time one SPI one 12C and one full duplex ASYNC channel 56 USBee QX User s Manual a USBee Suite USBee DX Connected File View Speed andis 1 023ms 1 323ms e e e A 5 8 3 j e 5 0 000438500 SPI2 MOSI FF ki 0 000544667 I2C 5 SDA S Sta
73. 64 InputDecodeBuffer unsigned char OutFilename unsigned char InlineFilename __int64 StartSample __int64 EndSample unsigned long Rate unsigned long Channel unsigned long BitRate unsigned long maxID unsigned long minID long delimiter long showall long Phex char ProtocolDefinitionFilename char ProtocolOutputFilename char ErrorString USBee QX User s Manual 207 CWAV_IMPORT int CWAV_API DecodeParallel unsigned __int64 reservedi1 unsigned char OutFilename unsigned char InlineFilename __int64 StartSample __int64 EndSample long Rate unsigned long Channels unsigned long Clock unsigned long UseCLK long CLKEdge unsigned long delimiter unsigned long hex long BytesPerLine char ProtocolDefinitionFilename char ProtocolOutputFilename char ErrorString CWAV_IMPORT int CWAV_API DecodeSetName char name define DC_COUPLED 1 define AC_COUPLED 2 int _tmain int argc _TCHAR argv printf USBee QX Toolbuilder Example in C n printf Initializing USBee QX n if InitializeQx else 208 printf No USBee QX Found n printf USBee QX Found and Initialized n PowerOnAnalogQx Turn on the power to the Analog channels CH1 CH2 CH3 and CH4 printf Setting Digital Outputs n SetSignalsQx 255 SetSignalsQxX 255 OxFF SetSignalsQx 255 xAA SetSignalsQx 255 0x55 printf Setting Digital Logic Threshold n SetLogicThresholdQx 1 5
74. ADR 39h SANALOG CTRL ADR 20h TX BUFFER _ADR 21h QX BUFFER ADR 22h SOP_ CODE ADR 23h SDATA CODE ADR 24h PREAMBLE ADR 25h SMFG_ID ADR Protocol name QxXData bytewise DEBUG DebugOn Packet Start type next End type event event 127 All Data passed in Decode Fields QX IRQ STATUS ADR Read and Write Command Fields ReceiveData N h 156 USBee QX User s Manual CAN PROTOCOL EXAMPLE CAN Protocol Definition File This file defines the transfers to from a custom CAN device over a the CAN bus f Protocol name CANBus bitwise DEBUG DebugOn Uncomment this to turn on Debug Packets Packet Start type event event 1 Start of CAN packet End type event event 2 End of CAN packet Decode Fields Extended Frame Format Fields SOF 1 i IDA 11 h SRR 1 h IDE 1 1 h IDB 18 h RTR 1 h Rsrv 2 i Length 4 h Data N h CRC 15 h CRCDel 1 h ACK 1 h ACKDel 1 h EOF 7 h Base frame format Fields SOF 1 i ID 11 h RTR 1 h IDE 1 0 h Rsrv 1 i Length 4 h Data N h CRC 15 h CRCDel 1 h ACK 1 h ACKDel 1 h EOF 7 h cee PROTOCOL EXAMPLE SDIO Protocol Definition File This file defines the transfers to from a custom device Protocol name SDIO 0 bytewise Debug DebugOn Uncomment this to turn on Debug Packets Packet Start type
75. C e USBee QX pod connected and functioning on the PC Internet access on the PC The software module is linked to the USBee QX pod and not the PC You can install the USBee QX Suite software and add on modules on as many PCs as you want The add on module will only function with the USBee QX pod that it was initially register with Finally you can not register the module without the USBee QX plugged in First to enable the USBee QX Suite Pro Module select the Setup Register USBee QX Suite Module menu This brings up the following screen Already Registered Modules USBee QX Standard Module USBee QX Pro Module USBee QX Stream Module Please Enter a Product Key here to activate the registration E Next copy and paste the Product Key you received into the box and press OK You will have received the Product Key on your on line invoice when you purchased the module The software will contact our servers to validate the Product code and return with the following screen on success The module is now installed and ready to be used USING DISK STREAMING To setup a streaming capture select the Streaming to Disk menu You can specify on this menu one of 2 channel modes to capture Digital 0 7 mode uses one byte per sample and Digital 0 15 mode uses 2 bytes per sample Then to start a capture select Streaming to Disk Capture Stream to Disk menu item The following dialog box is then displayed 216 USBee QX Us
76. CKY NOTES Sticky Notes are editable text blocks that look like sticky notes They can be positioned anywhere in the application window Sticky Notes are placed using the View Add Sticky Note menu item Once you select this menu item your cursor changes to 4 way arrows and a Sticky Note moves wherever you move the cursor To place the note position it where you want it and then press the left mouse button You can edit the text within the Sticky Note by clicking on the text and typing in the new text You can hit Enter to add more lines As you add text the marker will expand to fit the text To move the Sticky Note click on the Move at the top of the note Once you have it moved to the new location use the left mouse button to place it To delete the Sticky Note click on the X at the top of the note You can delete all Sticky Notes using the menu item View Delete All Sticky Notes la F USBee Suite Pro USBee SX Demo Mode fon ex File View Speed and Samples Trigger Setup Help lt div 4us Digital 0 Sticky Note Number 1 Digital 1 Sticky Note Number 2 Multiline Digital 5 Digital 6 Sticky Note Number 3 All sorts of Random Text can go in here Put descriptions of your setup test senario or results for others to see when they review your files Cursors USBee Demo Capture Many Measurements Logic Analyzer Oscilloscope T XL X2 dX dX Period Freqit ycle
77. DIR INC ADDRESS READDATA Packet 3 Time 7 356833ms Read False RSSI_ADR 20 Layer CYPRESSRFIC DIR INC ADDRESS QXOW SOPDET Packet 4 Time 9 189167ms Read False QX_IRQ_STATUS_ADR 0 1 Layer CYPRESSRFIC DIR INC ADDRESS Packet 5 Time 9 198833ms Read False QX_BUFFER_ADR Layer QXDATA RECEIVEDATA Packet 6 Time 9 204667ms 08 82 1E 99 A7 28 2A 8A 12 88 9E 58 18 CA CO CO Layer CYPRESSRFIC DIR INC ADDRESS READDATA Packet 7 Time 9 265167ms Read False CHANNEL ADR 0 SEARCHING FOR PACKETS QXB16 QXB8 QXB1 QXBERR QXC QXE 0 1 1 0 1 1 QXDATA 08 82 1E 99 A7 28 2A 8A 12 88 9E 58 18 CA CO CO Once displayed you can search for the next packet that contains certain fields that match your criteria Below is the Search Packet dialog box that is shown by using the View Packet Search menu item B Search Packet Cancel In the leftmost textboxes type the Field Label Then select the comparator operator equals not equals less than greater than and finally the value that the field is to be compared against Finally if there is more than one field in the search list choose whether to AND or OR the search terms When you click Find the next packet in the list starting from the top of the window will be placed at the top of the window You can search forward or backward by selecting the appropriate radio button on the right USBee QX User s Manual 129 FILTERING PACKETS Once displayed you can filter the ou
78. Dim tEdge2 As Int64 Where the second edge is Dim tPulseWidth As Double The pulsewidth in seconds Dim tBits As Integer Dim tNumberOfOnes As Integer Used to remove Bit stuffing Now go from the start of the samples to the end and process the signal Find the first edge of the data signal assumes that it is the start edge of a bit Sample Data CUInt FindNextEdge Sample SignalMask 1 And SignalMask tBits 0 For Sample Sample To NumberOfSamples 1 If DecodeState LOOKING_FOR_START Then Now look for the next edge tEdge1 FindNextEdge Sample SignalMask 1 If tEdge1 gt Then We found the next edge Check to see if this falling edge is in the right timeframe tPulseWidth tEdge1 Sample SamplingRate If tPulseWidth gt 000004 And tPulseWidth lt 0 000011 Then tBits tBits 1 The bit is a which starts the byte stream Now get us to the start of the next bit tEdge2 FindNextEdge tEdge1 SignalMask 1 Write out a bit data marker WriteEntry BW Sample tEdge2 9 e90 If tBits gt 12 Then Only start looking for a after a few bit times to remove junk at front of packets DecodeState LOOKING_FOR_START_BIT_2 End If Initialize the Byte Accumulation variables ByteStartSample Sample ByteAccumlator BitCounter 1 tNumberOfOnes Reset the bit stuffing removal Sample tEdge2 ElseIf tPulseWidth gt 0 000012 And tPulseWidth lt 0 000019 Then The
79. ECO OOIX AR 0 to F ROOIX BOOS COX bOO4 0 and E Analog Signal CH1 S 10 Voltsto 10 Volts Event hanpenina t happening Followed By Event 2 Followed By Event 3 Followed By Event 4 Followed By Event 5 Followed By Event 6 Use PacketPresenter Definition File name is below i see I cor By USBee QX User s Manual Below shows a search that finds all decoded data that is between 15 and 99 i Pro Onnected a w Channel Settings a ic AASIAA EAA ny er Fle View Speesand Samples Trigger Setup Help Sse e sey ee ewe e a oad ae a us os on f a T o a a Search n C902 Event 1 If Digital 2 decoded bus data is between 15 and 99 Digital 0 has edge happen Digital I SA DEET E If Analog Signal CH1 has rising edge at voltage threshold igita Digital 3 while Se ee ee m igital 2 is b 15 99 SPL2 x 16 96 Gal 4 Bus Digital2 decoded data is etween and and FAF AN EA E Digita s are F Eee PESS ax TORA i0 to m RIK Pee TT TESA 10 and 10 Volts to 10 Volts Digital 4 Digital S RCS IEDIG Digital 6 Followed By h k k e te Digital 7 Async 6 Event 2 Followed By Event 3 Followed By Event 4 Followed By Event 5 Followed By Cursors Event 6 USBee Capture Oncel Capture Many A Measu 7 Use PacketPres Definition File name is below l gt ELENE Logic Analyzer Oscilloscope aa Apply I
80. Filename char ErrorString e OutFilename pointer to the filename string to write the decoded data to e StartSample the index of the first sample to start decoding e EndSample the index of the last sample to decode e Rate is as follows O 69 600 Msps O 39 300 Msps O 29 200 Msps O 108 100 Msps O 58 50 Msps O 28 20 Msps O 107 10 Msps O 57 5 Msps O 27 2Msps O 106 1 Msps O 56 500ksps O 26 200ksps O 105 100ksps e SDA Which signal 0 15 to use for the SDA signal SCL Which signal 0 15 to use for the SCL signal e ShowAck 0 Do not show each byte ACK values 1 show the ACK value after each byte e Delimeter 0 no delimiter 1 Comma delimeter 2 Space delimeter e Showall 0 Only show the data payload 1 show all packet details e Hex 0 display data in decimal 1 display data in hex e ProtocolDefinitionFilename filename for the Protocol Definition File to use to create a PacketPresenter file If this value is O then the PacketPresenter feature is turned off e ProtocolOutputFilename filename that is created for the output of the PacketPresenter e ErrorString string that holds an error description of the routine returns an error USBee QX User s Manual 195 Return Value TRUE No Error during processing e FALSE Error while processing The ErrorString contains a description of the error to present to the user _DECODECAN This routine decodes bus tr
81. Just print out all the bytes 162 USBee QX User s Manual Serial Protocol Definition File This file defines the transfers from a serial device Protocol name SerialBus bitwise DEBUG DebugOn Uncomment this to turn on Debug Packets Packet Start type value Look for a value in the data to start the packet value 6211h NOTE This value is assumed MSbit first in the data stream bits 16 mask FFFFh End type length bitlength 64 End of command after 64 bits Decode Fields Send out the bits of the packet Fields Start 16 h Nine 9 h Seven 7 h Rest N b USBee QX User s Manual 163 USB Bus Protocol Definition File This file defines the transfers to from a custom USB device r Protocol name USBBus bitwise DEBUG DebugOn Uncomment this to turn on Debug Packets Packet Start type event event 1 Setup In or Out found End type event event 6 ACK NAK or Stall found or no handshake found Decode Fields Any Packet No Response Fields Sync 8 i PID 8 L Addr 7Vl d EP 41 d CRC5 5 i Token 4 No Handshake Setup Nakd Token Fields Sync 8 i PID 8 10110100b L Addr 71 d EP 41 d CRC5 5 i Sync 8 i HS 8 01011010b L Handshake IN Nakd Fields Sync 8 i PID 8 10010110b L Addr 7L d EP 4L d CRC5 5 i Sync 8 i HS 8 01011010b L Handshake OUT Nakd Fields Sync 8 i
82. Letters S B and or R indicating S Save Screenshot JPG file B Bus Data to CSV file or R Raw Signal data to CSV file REM Files that are output are REM output usbeeqx Captured USBee QX Suite Trace File REM output csv Raw Sample CSV file if flag R is included on command line REM outputBus csv Decoded Bus Data CSV file if flag B is included on command line REM output jpg Screenshot image file if flag S is included on command line REM GUI will only stay open as long as the capture is not finished The program will write the files and REM automatically close REM Below is the actual command line call to load the setup usbeeqx file perform a capture and save the capture file and a screenshot USBee Suite exe setup usbeeqx output S pause USBee QX User s Manual 181 USBEE QX TOOLBUILDER OVERVIEW The USBee QX Test Pod System consists of the USBee QX Test Pod connected to a Windows PC SuperSpeed 3 0 or High Speed USB 2 0 port through the USB cable and to your circuit using the multicolored test leads and clips Once connected and installed the USBee can then be controlled using either the USBee QX Suite Windows Software or your own USBee QX Toolbuilder software The USBee QX Test Pod is ideal for students or designers that need to get up and running with Super Speed USB immediately With a USB connector on one end and signal pin headers on the other this simple pod will instantly USB 3 0 Super Speed enable your des
83. NTENTS INTRODUCING THE USBEE OX POD wssssssscscvssiccstensiccccuctaccessesicestessiesensssseecaedeiiess 12 THE WS DEE CX MEST F OD iren e E EE E EEA E OEEO 14 PC SYTEM REOUIREIMENT Sicceccvanceinatntysescessuneuaicemaenesduactaccienenetnoseanascimanreusdusyaceaecers 16 EACH PACKAGE INCLUDES ccs casansanasiviautnnngasudhanedacebnsaGniessincwbanlanacnieulsmactacuionachsasanneiaunnnrene 16 INTRODUCING THE USBEE QX SUITE ccscscsscscsccscscsscscsccccscsccscscncescscnsess 18 LISBEE OX SUITE OVERVIEW rioria i s E E E Ea 18 See the information you want FAST ccscccccsssecceceeeeeceeseesecesseaeeeeeeeeaes 19 Data ACQUISITION over USB 3 0 oi scesscuvosannescnvecadareanusce aves tssir tiine NE EE E 19 Superior Quality Design Professional Results ccccccsseseceeeceeeeecesenees 19 Fast and Detailed Waveform Viewing cccccsssssseeccceeeesseecceeseueeeeeeesseaees 19 AE UE E arare ears parse paneer sav E EAA E E OEA EENE 20 Fully configurable Look and Feel snnnossnnnssssenesssenessreressseressreressreressseerese 20 Serial Bus Analysis cccccsssscccccesseccccessececceesecccsaeeceesueeceeeaeesecessaneeeeesanaes 21 Data ONES aa E AA TEE N E RS 23 Pack tPresente aisinn EA AES 24 Fast Pan Bus VISWiINg ccccu sues sacnceebenenutatoeencndteeupedvbsatbenebacspes oboucniedbananatendespeses 25 PO C Cy E E TN 26 SMAN Seano a de sep a heen dee renee 27 Sample and Smart Markers cccccccsssscccceeseece
84. Ons Ons Ons Ons infinity Ons infinity USBee QX User s Manual 115 ACQUISITION CONTROL The USBee QX Suite adds more trace acquisition and triggering controls such as Normal Mode Automatic Mode Single Capture and Multiple Capture ia USBee Suite Pro USBee RX Connected Ciewav USBee Test Files ProtocotSetupusbeerx Mia mo e a OOOO bale File View iSpeed nd Samples jingga iip Hepes USBee RX Controi Pane r Dositia a D Normal Mode Digitaro r v Auto Mode Digitar Digitar Digitals SP12 mrs Digitars res Digitar6 Bus Async o Ss 82888 8 1 de When the USBee QX Suite is first started no acquisition is taking place You need to press one of the acquisition buttons Capture Once or Capture Many at the bottom of the window to capture data The Capture Many button performs an infinite series of traces one after the other This lets you see frequent updates of what the actual signals are doing in real time If you would like to stop the updating just press the same button again now reading Stop and the updating will stop This mode is great for signals that repeat over time The Capture Once button captures a single trace and stops This mode is good for detailed analysis of a single event rather than one that occurs repeatedly The USBee QX Suite adds the ability to have either Normal Mode default in the Standard version or Automatic Mode triggering This determines when the signals s
85. PRESENTER orioneu e aT EE A AE 123 QU CTV I OW rorat En E EE E E O E E 123 Seting Up tne PACKCtPIeseNte rr orenera ane aT O TOA 126 Viewing the PacketPresenter OUtPUC cccsssccccseeecccneeeccsssecsasccessuseessuases 126 USBee QX User s Manual 7 Saving PacketPresenter Data to Text or RTF FIICS sccccseseccesecceeccceseeeeees 127 Copying PacketPresenter Output to Other Programs scccseseceeeeeeceseeeeeees 128 SEGNCHING FOF POCKCLS arana 129 PILCOTIIG POCKCUS te sie ers tunes setae eich Garnet ne sinc tie Met inet ules earn ie 130 PacketPresenter to Waveform ASSOCIATION USING CUISOLPS ccsssseeeeeeeeeeeeees 131 PacketPresenter Definition File Format cccccssscccsesececcesececesecesesececseseseeeeess 132 Comments in the PacketPresenter Definition File cccceccccessseeceeeeeeeeeeeaeeeeeees 132 Constants in the PacketPresenter Definition File cssscccccccceeesseeeeceeeaeeeeeeees 132 PacketPresenter Definition File Sections ccccceseecceceeeececeeeeceecaeeeceesaeaeeeessuaeses 133 Protocol SECO rair TEENE AE EEA 133 Byte wise busses VS Bit wise DUSSES ccccssecccesececeececeeececeeecetauecetenecetanesens 133 BUS EVENTS 2c ur E T AA TE caa tat auncen eae reine ene ee 134 Data Channels and Multiple Data Signals cccssscccccssseececeeseceeeeesceeseeesees 136 Packet SOCEIOM sn 136 Start and End SOCOM asrar ateni aa iTi A Eea 137 type SIN OXG mrn i E tes een e
86. Problems Using patented technology the USBee QX has 4 analog and 24 digital channels 100MHz to 600MHz sampling depending on channels used 896 million sample internal buffers Quad 10 bit ADC s independent 100Msps 8 channel Digital Signal Generator 7Msps Analog Signal Generator 60V protection on all inputs Variable Logic Thresholds and USB over current protection That s just the hardware Mixed Signal Multi level Protocol Decoding Combined with the USBee QX Suite software the USBee QX becomes a multi layer protocol decoder for many of today s serial and parallel busses letting you debug at the waveform bus data or packet level In Field Upgradable System Supports Addition of New Features Based on a proprietary design that allows the software firmware and hardware to be dynamically reconfigured using web based software downloads the USBee QX and its ever growing list of Applications ensures that you will always have the most current tools available for years to come With a single USB connection to your laptop or PC the USBee QX gives you the power to design prototype test and validate your mixed signal electronic designs with seamless ease Built upon the popular award winning and patented USBee mixed signal Oscilloscope Logic Analyzer Signal 12 USBee QX User s Manual Generator and Protocol Analyzers the USBee QX takes full advantage of the powerful debug capabilities of the USBee QX Suite software to solve your p
87. ProtocolDefinitionFilename filename for the Protocol Definition File to use to create a PacketPresenter file If this value is O then the PacketPresenter feature is turned off e ProtocolOutputFilename filename that is created for the output of the PacketPresenter e ErrorString string that holds an error description of the routine returns an error 196 USBee QX User s Manual Return Value TRUE No Error during processing e FALSE Error while processing The ErrorString contains a description of the error to present to the user _DECODE1WIRE This routine decodes bus traffic and outputs the data to an output file This routine works ona sample buffer captured using the StartCapture routine Calling Convention CWAV_IMPORT int CWAV_API DecodeiWire unsigned __int64 reserved1 unsigned char OutFilename unsigned char InlineFilename _int64 StartSample __int64 EndSample long Rate unsigned long Signal long delimiter long Showall long hex char ProtocolDefinitionFilename char ProtocolOutputFilename char ErrorString e OutFilename pointer to the filename string to write the decoded data to e StartSample the index of the first sample to start decoding e EndSample the index of the last sample to decode e Rate is as follows O 69 600 Msps O 39 300 Msps O 29 200 Msps O 108 100 Msps O 58 50 Msps O 28 20 Msps O 107 10 Msps O 57 5 Msps O 27 2Msps O 106 1 Msps O 56 500ksps O
88. R_HEADER As Integer 1 Const LOOKING_FOR_BITS As Integer 2 Dim DecodeState As Integer LOOKING_FOR_HEADER Holds what state of the decoder we are in Dim ByteAccumlator As Integer Holds the accumulated bits for each byte Dim BitCounter As Integer Holds how many bits we have accumulated in this byte so far Dim ByteStartSample As Int64 Holds the sample at the start of the byte Dim Data As UInteger Holds the state of the signal at the current sample Dim tEdge1 As Int64 Where the first edge is Dim tEdge2 As Int64 Where the second edge is Dim tPulseWidth As Double The pulsewidth in seconds Now go from the start of the samples to the end and process the signal For Sample To NumberOfSamples 1 Data CUInt SampleData Sample And SignalMask If DecodeState LOOKING_FOR_HEADER Then If Data lt gt Then We found a High which starts the Header Now look for the next edge tEdgel FindNextEdge Sample SignalMask 1 If tEdge1 gt Then Check to see if this falling edge is in the right timeframe tPulseWidth tEdge1 Sample SamplingRate If tPulseWidth gt 0 008 And tPulseWidth lt 0 01 Then USBee QX User s Manual 87 88 Now look for the rising edge tEdge2 FindNextEdge tEdge1 SignalMask 1 If tEdge2 gt Then Check to see if this rising edge is in the right timeframe tPulseWidth tEdge2 tEdge1 SamplingRate If tPulseWidth gt 0 004 And tPulseWidth lt 0
89. S S S S s Asyn s Asyn s Asyn s Asyn s Asyn s Asyn 210us SPI 2 MISO FF I2C I2C I2C I2C 5 SCL ACK 5 SCL 22 5 SCL NACK 5 SCL P Stop 2us Async 0 TX 0B c 0 TX 0C 0 QX 0D 0 QX 0E QX OF TOX 10 c 0 0X 11 gt OO O 2 MOSI 94 SO FF 2 MOSI 54 2 MISO E8 FF 2 MOSI FF 2 MISO 58 2 MISO B8 2 MOSI FF 114 292us I2C 5 SCL S Start 15 708 82 323 82 33 82 48 15 82 Sil 083 667 042 958 042 083 708 083 167 U U U U U U U U U U S S S S S S S S S S I2C I2C I2C I2C TZE T2 I2C I2C I2C I2C 5 SCL A2 Write 5 SCL ACK 5 SCL 00 57 SCL ACK 5 SCL 12 5 SCL ACK 5 SCL S Start 5 SCL A3 Read 5 SCL ACK 5 SCL 29 USBee QX User s Manual PACKETPRESENTER The USBee QX Suite adds the PacketPresenter feature that runs alongside of the existing bus decoders The PacketPresenter takes the output of raw binary data from the bus decoders and parses the stream according to users PacketPresenter Definition File for the intent of displaying the communications in easily understood graphical displays B T USBee Suite Pro USBee RX Demo Mode C Program Files x86 CWAV Inc USBee RX Suite RXDemo usbeer Lo File View Speed and Samples Trigger Setup Help USBee RX Control Panel A
90. Settings Setting the Analog Channels sssccceesseeeeeees 184 PowerOnAnalogQxX Turning On Power to the Analog Channels ccceeeceee 185 PowerOffAnalogQxX Turning Off Power to the Analog Channels ccc seeceee 185 AnalogLiveVoltage Reading the Voltage on the Analog Channels 00068 186 Reading and Setting Signal States cccssscccsssscccsseecccaeseccccesecssussecsaessesaaases 186 SetSignalsQX Setting the USBee QX Output Signals cccccsssseceeeeseeeeeeeeeeeeees 186 GetDigitalSignalsQX Reading the USBee QX Input Signals 187 GenerateAnalogWaveformQxX Controlling the AOUT Signal ccccccesseeeeeees 187 Logic Analyzer and Oscilloscope FUNCTIONS cccceeeccneseceeseceeeececesceeeneceaeees 188 SAN CAPU OX socnccuesccucadsvensseeetenvinnerensceunccdancews beans ease aactvexcwetevedanocnwetanis ole canvcmiausenes 188 Capture Stal SOAN EA ton acca ems oueue A een a ae eecoeer 189 SLOP Cap UTEK EE NE N ASAN TN N N OR 189 RIB GET INOWOX coincer N N N 189 EndCapture OX visiere aerian iie inie Ean e AAEE EAA AAT 190 SaIMPle DIC al Dalane a E E A EA 190 AnalogSarople Vot ag Eosen ainen ENEE ET EERE OEA 190 PIPING XCE GSC aria A AA 191 SEINE BELSON ar irs N AEE EN AA A E N a 191 PSC OCS YS Berane N AE NEN 192 Decode SP lirie SESS 194 Decode PCG oaan a A E E an eer nee tere eee 195 Decode CAN aired vrwetecociaus eE AE EE E EEE eies 196 Decode TWI E erani a
91. Successful e 0 Failure GENERATEANALOGWAVEFORMQX CONTROLLING THE AOUT SIGNAL This routine sets up the Analog waveform generator that produces a waveform on the AOUT signal Calling Convention CWAV_IMPORT unsigned long CWAV_API GenerateAnalogWaveformQxX unsigned long SamplesPerSecond unsigned char SamplesPerCycle unsigned char samples e SamplesPerSecond is the sample rate of the output samples and ranges from 1 to 300 000 e SamplesPerCycle is the number of samples that make up a complete cycle in the analog waveform and ranges from 1 to 128 samples e samples points to a buffer of samples Each sample is a digital value representing the analog output voltage using the formula Vout samples 61 429 Vout range is from 0 to 3 0V Return Value 1 Successful USBee QX User s Manual 187 LOGIC ANALYZER AND OSCILLOSCOPE FUNCTIONS The following API describes the routines that control the Logic Analyzer and Oscilloscope functionality of the USBee QX Test Pod STARTCAPTUREQX This routine starts the pod capturing data at the specified trigger and sample rates Calling Convention CWAV_IMPORT unsigned long CWAV_API StartCaptureQX unsigned long buffersize unsigned char TriggerPosition float SampleRate unsigned long channelmaskA unsigned long channelmaskB unsigned char ExternalClockingOn unsigned char CompressionOn _ e Buffersize is how many 64 bit samples are taken and ranges from 65536 to 33554432 e Tr
92. TPRESENTER Your custom decoder can also send data and events to the PacketPresenter for processing and display in the PacketPresenter system As seen in the example code once the system is initialized you can call the SendDataToPacketPresenter and SendEventToPacketPresenter routines to pass the data SendDataToPacketPresenter sends data bits to be run through the PacketPresenter The routine takes a filename which is passed in from the calling function a sample number equating to a relative timestamp of this data the data to send how many bits are included which channel to data is for X or Y and a reserved parameter called Index set to 0 SendDataToPacketPresenter ByVal Filename As String ByVal Sample As Into4 ByVal Data As Integer ByVal Bits As Integer ByVal Channel As Integer ByVal Index As Integer SendEventToPacketPresenter send events to be run through the PacketPresenter The routine takes a filename which is passed in from the calling function a sample number equating to a relative timestamp of this data the event to send which channel to data is for X or Y and a reserved parameter called Index set to 0 SendEventToPacketPresenter ByVal Filename As String ByVal Sample As Int64 ByVal Data As Integer ByVal Channel As Integer ByVal Index As Integer Events typically indicate bus states that are not contained in the data for example a START bit on the I2C bus Your custom decoder can define and use the Events
93. This is specifically to eliminate the creation of multiple 100G files on your drives Each stream is displayed and sections can be saved to disk as non streamed captures using the Save As File menu USBee QX User s Manual 217 VIEWING THE DISK STREAM Once the capture stream is processed the first block of the stream is loaded and displayed as seen below anel 518 1ms Digital 0 h m Digital 1 Digital 2 W w Digital 3 Digital 4 Digital 5 Digital 6 w Digital 7 Digital 8 o 1 2 3 4 5 6 7 8 9 W N n M w n ee e EE T Digital 9 H Digital 10 E Digital 11 y N igital 12 j w Digital 13 wy D Digital 14 Digital 15 _ Et samples 100Msps j 4 A i Frequency infinity _ Fast F if fi a gt 5 Duty Cycle n a ey E 1 dX infinity Width Ons al 2 Period Ons The bars at the top of the screen show the complete stream available on the disk and what portion of that stream is in RAM and shown on the waveform To load different portions of the stream you can click on the disk image bar to load that portion of the stream or you can click on the left lt lt or right gt gt buttons to load the previous or next sections The Disk bar is color coded to show relative capture activity at that time during the stream IE You can then use any of the USBee Suite features including Save Capture to save off that portion of the stream capture
94. US SETUP The SM Bus Decoder takes the captured data from an SM bus Hardware Setup To use the Decoder you need to connect the USBee Test Pod to your hardware using the test leads You can either connect the test leads directly to pin headers on your board or use the test clips for attaching to your components The SM Bus Decoder uses any one of the 24 digital signal lines 0 thru 21 T and C for the SM Clock and SM Data and the GND ground line Connect the SM Clock and SM Data to your digital bus using the test leads and clips Connect the GND line to the digital ground of your system Software Setup Activate the below Channel Settings Dialog by clicking the white box on the left of the signal names on the main application screen E E Channel Settings Single Signai__ Signal Selection 012 Clock 56789 AB Data O Save Cancel On the above dialog box select the signals you plan to use for the SM Bus protocol The bus traffic will be decoded as in the following screen HE awie JA 0 JA C E JA GC ARa jA USBee QX User s Manual 73 SERIAL BUS SETUP The Serial Bus Decoder takes the captured data from a Serial bus The serial data can be from any clocked serial bus and can be aligned using a hardware signal or an embedded sync word Hardware Setup To use the Decoder you need to connect the USBee Test Pod to your hardware using the test leads You can
95. USBee QX Suite contains a Control Panel that controls many of the features of the USBee QX system including the Variable Logic Threshold Analog channel scaling Current Logic and Analog levels Analog Signal Generator Digital Signal Generator PWM controllers Pulse Counters and Frequency Counters py Ela E i O TUUT a 20 9 a J q b s E E 32 USBee QX User s Manual QUICK START This section goes through installing the software for your USBee QX and getting you using the USBee QX quickly PC SYSTEM REQUIREMENTS The USBee QX Suite requires the following minimum PC features e Windows XP SP3 Vista or Windows 7 8 32 bit or 64 bit operating system e NET Framework 4 0 or greater This is installed automatically during installation if not already on your PC e Pentium or higher processor One USB 3 0 High Speed enabled port It will not run on USB 1 1 Full Speed ports e 32MBytes of RAM e 125MBytes of Hard disk space e Internet Access for software updates and technical support 802 11 B G Wireless network for WiFi USBee QX User s Manual 33 SOFTWARE INSTALLATION To ensure that you are using the latest version of USBee QX software you can download the software from our web site at www usbee com You must install the software on the PC before you plug in the USBee QX device A quick guide to install the software follows 34 Download the USBee QX Software from http www u
96. Ustee Suite Pro USBee RX Co Bus AO a B7 a Capture Once I Capture Many DEMO MODE In the Demo mode you can see an example trace capture by clicking the Demo button This loads a trace that includes a number of serial busses and lets you see how the USBee QX Suite can decode the bus traffic manipulate the waveform data and use the features of the USBee QX Suite The USBee QX Suite display shows the USBee connection status in the title bar of the application Ifa USBee QX is connected to the computer when the application starts the title bar indicates the connection status If you run the software with no pod attached it will run in demonstration mode and simulate data so that you can still see how the software functions If you are running in Demo mode and you want to connect to your USBee QX pod you must exit the USBee QX Suite connect the USBee QX and then rerun the USBee QX Suite software USBee QX User s Manual 39 TESTING YOUR CIRCUIT USING THE USBEE QX In order to quickly get up and running using The USBee QX Suite application here is a step by step list of the things you need to do to view a waveform trace after you have installed the software and hardware e Plug in the USBee QX Pod Plug the USBee into your computer USB port e Connect Ground Connect the GND wire to the Ground of your circuit you would like to test You can either use the socket to plug onto a header post or connect i
97. Y all bits on channel Y not used by other fields OutputModifiers are a string of characters that represent how to output the contents of this data Output Modifiers are as follows Ignore no output entire field is ignored for output D Decimal output H Hexadecimal output B Binary output A Ascii output TF True nonzero or False zero TFT True nonzero or False zero but only show if True TFF True nonzero or False zero but only show if False L Look up the text string to print out in a matching Lookup line Value or Value a value to multiply Divide the output value by Value or Value a value to offset the output value by Sstring string to print after the data or in place of the data if the i flag is used String must be the last item in a field No commas quotes semicolons or parenthesis allowed in the string BUS EVENTS IN THE MIDDLE OF A PACKET Sometimes a specific bus event plays a role in the packet format To specify that a specific bus event needs to occur at a specific time in the field sequence place the single Bus Event value inside brackets in the Field Line Multiple events in a single value are not allowed however consecutive events are allowed To indicate the absence of a specific bus event in the protocol use the Not operator USBee QX User s Manual 143 For example if the bus is 12C use the following to require that a Start Bit is present between field1 and field
98. ace 3 Even 4 Odd 5 Ignore DataBits Number of data bits 4 to 24 Delimeter 0 no delimiter 1 Comma delimeter 2 Space delimeter e Showall 0 Only show the data payload 1 show all packet details e Invert 1 invert the logic of the signal before processing e Hex 0 display data in decimal 1 display data in hex e ASCII 0 show byte values 1 show ASCII equivalent e BytesPerLine How many output words are on each output line e ProtocolDefinitionFilename filename for the Protocol Definition File to use to create a PacketPresenter file If this value is O then the PacketPresenter feature is turned off e ProtocolOutputFilename filename that is created for the output of the PacketPresenter e ErrorString string that holds an error description of the routine returns an error Return Value TRUE No Error during processing e FALSE Error while processing The ErrorString contains a description of the error to present to the user DECODESETNAME This routine sets the string that is output during any of the above decoders and can represent a unique identifier for that bus Calling Convention CWAV_IMPORT int CWAV_API DecodeSetName char name DIGITAL PATTERN GENERATOR FUNCTIONS The following API describes the routines that control the digital pattern generator functionality of the USBee QX Test Pod GENERATEPWMWAVEFORMQX USBee QX User s Manual 201 This routine se
99. affic and outputs the data to an output file This routine works ona sample buffer captured using the StartCapture routine Calling Convention CWAV_IMPORT int CWAV_API DecodeCAN unsigned __int64 reservedi unsigned char OutFilename unsigned char OutFilename _ int64 StartSample int64 EndSample unsigned long Rate unsigned long Channel unsigned long BitRate unsigned long maxID unsigned long minID long delimiter long Showall long Phex char ProtocolDefinitionFilename char ProtocolOutputFilename char ErrorString e OutFilename pointer to the filename string to write the decoded data to e StartSample the index of the first sample to start decoding e EndSample the index of the last sample to decode e Rate is as follows O 69 600 Msps O 39 300 Msps O 29 200 Msps O 108 100 Msps O 58 50 Msps O 28 20 Msps O 107 10 Msps O 57 5 Msps O 27 2Msps O 106 1 Msps O 56 500ksps O 26 200ksps O 105 100ksps e Channel Which signal 0 15 to use for the CAN signal e BitRate The value of the bit rate in bits per second for 250kbps use 250000 e MaxID 0 show all packets otherwise this is the maximum ID to display MinID 0 show all packets otherwise this is the minimum ID to display Delimeter 0 no delimiter 1 Comma delimeter 2 Space delimeter e Showall 0 Only show the data payload 1 show all packet details e PHex 0 display data in decimal 1 display data in hex e
100. ak the data stream into packets and how to parse out the fields in each of the packets Multiple Protocol Sections can be defined for passing data from one Protocol Section to another Each Protocol Section has the following syntax that specifies the packetizing and parsing into fields Protocol name ProtocolName Packet packet processing settings Fields packet field processing settings packet field processing settings packet field processing settings The ProtocolName is a label that uniquely identifies this protocol processor This name is used in the Field definitions to define which Protocol to route a field of data for use by multilayer protocols The highest level Protocol is the first protocol in the file This is the Protocol Processor that is sent the incoming data stream from the bus as defined in the Channel Settings Dialog Box for that waveform BYTE WISE BUSSES VS BIT WISE BUSSES Some busses are by nature byte oriented while others are bit oriented The following table shows the type of bus Bytewise Busses Bitwise Busses e Async e Serial e I2C e I2S e Parallel e OneWire SPI CAN e PS2 e USB e SDIO USBee QX User s Manual 133 BUS EVENTS Each bus type also can have certain bus events that may be significant in the decoding of a protocol One such event is an 12C Start Bit While the Start bit is not an actual bit in the data stream it does signify to the I2C slave that a certain transaction is ta
101. al Next Bit next time BitCounter BitCounter 1 Sample tEdge2 Continue For Else Pulse is not the right size so bail and keep looking DecodeState LOOKING_FOR_HEADER Sample tEdge2 Continue For End If Else No edges at all So we are done Exit For End If Else Pulse is not the right size so bail and keep looking Sample tEdge1 DecodeState LOOKING_FOR_HEADER Continue For End If Else No edges at all So we are done Exit For End If End If End If Next ElseIf CBool InStr Parameters ToUpper BIPHASE Then BiPhase Decoder WriteEntry BW 100 BiPhase Decoder Dim Params Parameters Split CChar Dim SignalToUse As Double Val Params 1 Dim SignalMask As Integer 1 lt lt CInt SignalToUse Make the mask that will mask off the channel we want in the sample Const LOOKING_FOR_START As Integer 1 Look for a Const LOOKING_FOR_BITS As Integer 2 Then look for a 1 starts the 7E Const LOOKING_FOR_START_BIT_2 As Integer 3 Dim DecodeState As Integer LOOKING_FOR_START Holds what state of the decoder we are in Dim ByteAccumlator As Integer Holds the accumulated bits for each byte Dim BitCounter As Integer Holds how many bits we have accumulated in this byte so far Dim ByteStartSample As Int64 Holds the sample at the start of the byte Dim Data As UInteger Holds the state of the signal at the current sample Dim tEdge1 As Int64 Where the first edge is
102. al 85 EXAMPLE CLASS LIBRARY CODE Below is our example Class Library source code that performs a few different protocol decodes and displays the results on the waveline A version that includes an actual NEC IR decoder is installed with the USBee QX Suite Use this example to start your own Imports System IO Public Class CustomUSBeeSuiteDecoderQx Declare Function SampleData Lib usbeeadvste d1ll Alias LoggedData YG_J_J Z ByVal Index As Int64 As Integer Declare Function SampleDataCH1 Lib usbeeadvste d1ll Alias LoggedDataCH1 YGJ_J Z ByVal Index As Int64 As Integer Declare Function SampleDataCH2 Lib usbeeadvste d1ll Alias LoggedDataCH2 YGJ_J Z ByVal Index As Int64 As Integer Declare Function FindNextEdge Lib usbeeadvste dll Alias FindNextEdge YG_J_JKK Z ByVal start As Int64 ByVal Mask As Integer ByVal direction As Integer As Int64 Declare Function InitializePacketPresenter Lib usbeeadvste d1l Alias InitializePacketPresenter YGHPAD Z ByVal PPInFilename As String ByVal PPOutFilename As String ByVal PPError As Byte As Integer Declare Function SendEventToPacketPresenter Lib usbeeadvste d1ll Alias SendEventToPacketPresenter YGHPAD_JJJIJ Z ByVal Filename As String ByVal Sample As Int64 ByVal Data As Integer ByVal Channel As Integer ByVal Index As Integer As Integer Declare Function SendDataToPacketPresenter Lib usbeeadvste d1ll Alias SendDataToPacketPresenter YGHPAD_JJJJIJ Z
103. allation Connect the USBee QX first and then run the USBee QX Suite software Open up the control panel by clicking the arrow next to the words Control Panel Control Panel Digital Digital Digital Next type in the SSID of the wireless network that the USBee QX and PC will be networked on If necessary type in the passphrase of the network All network security protocols are supported Click the Connect WiFi If you are unsure of the SSID you can choose the Setup Scan for WiFi Networks to see a display of the available WiFi networks that are within range of the USBee QX pod WiFi Scan WiFi Scan Reults ay WiFi Networks your USBee OX can see 22222 belkin e94 22222 belkin e94 quests Connect WiFi Note If you do not see the WiFi network you want to use you need to either move closer to the wireless router or use a WiFi network whose router is closer to the USBee OX Close SSID myNevor PaSSDTSSE eeenenenee i a IF Address LOO Once you press the Connect WiFi button the USBee QX Suite software will store the network information in the USBee QX Pod Next the USBee QX will attempt to connect to Network If successful the USBee QX Suite will display the IP address that was given to the USBee QX This IP address is stored with the settings of the USBee QX Suite It is best if you can use the PC that is intended to connect wirelessly to the USBee QX for thi
104. am value valuel value that the data needs to be to start End value value2 value that the data needs to be to start End value value3 value that the data needs to be to start End bits 8 how many bits in the start End word You can use the EXCLUDE keyword in the END section to leave the end data on the data stream for the next packet This is useful for when there is no indication of the end of a packet except for the arrival of the next packet TYPE LENGTH Only valid in the END section the end of a packet can be indicated by a certain length of data You use the BitLength or the ByteLength keywords to specify how long the packet is The length can either be a fixed length expressed as a constant or variable length based on the contents of a packet in the data stream type length End of a packet is based k on a length Bytelength length How many bytes per packet or Bitlength length How many bits per packet To use the contents of one of the fields as the packet length you use the name of the field defined in the Fields section You can also do simple arithmetic on the field value to compute the final packet size 138 USBee QX User s Manual type length End of a packet is based on a length Bytelength fieldname 2 2 field holding packet size or a constant optional or a constant optional If present the or must come before the or offset and is executed fir
105. and select the Graph tab as below oe x f Digital Signals Analog Signals Spectrum Analyzer Use se Y wc Async twie Ps2 J smous J 2s Y can J serial J Parana Y sosoo Y custom search Graph Use this waveline setting to graph the values of decoded bus data as a graph Enter the Protocol Name and Field Name for the values you want graphed Both of these are defined in the PacketPresenter Definition file Protocol Name to Graph MOVEMENT Field Name to Graph X Data Format Decimal O Hex Use PacketPresenter Definition File name is below Browse Edit Enter the Protocol Name to Graph This is the label that is displayed at the start of each PacketPresenter packet and comes directly from the PacketPresenter Definition file that was used to decode the traffic USBee QX User s Manual 213 Next enter the Field Name to graph This is the top label of the field that you want to graph In the above example we used the X Y or Z fields one for each graphed line Finally select whether the field data is in Hex or Decimal format The graph line is then computed and displayed The scaling of the graph is automatic to fit all points within the display area Hovering the cursor over the graph will place a marker and show the value of the point at that location 214 USBee QX User s Manual USBEE QX STREAMING MODULE The USBee QX Streaming Module is an optional module that greatly enhances the capture dur
106. annel int TrigY AnalogQualifierFrom int TrigY AnalogQualifierTo int Trigy AnalogTriggerLevel long TrigY DigitalQualifierChannelMask long TrigY DigitalQualifierFrom long TrigY DigitalQualifierTo Vs e TriggerYEnabled 1 Trigger when Trig Y is present e TriggerXEnabled 1 Trigger when Trig X is present e TrigXorYEnabled 1 Trigger when Trig X or Y is present e TrigXandYEnabled 1 Trigger when Trig X and Y is present e TrigXthenYEnabled 1 Trigger when Trig X followed by Y is present e TrigYthenXEnabled 1 Trigger when Trig Y followed by X is present Return Value e 1 Trigger Set successful e O Trigger Set Failed _DECODEUSB This routine decodes bus traffic and outputs the data to an output file This routine works ona sample buffer captured using the StartCapture routine Calling Convention CWAV_IMPORT int CWAV_API DecodeUSB unsigned __int64 reserved1 unsigned char OutFilename unsigned char InlineFilename __int64 StartSample __int64 EndSample long ShowEndpoint long ShowAddress long DPlus long DMinus long Speed long Rate long SOF long delimiter long showall long hex char ProtocolDefinitionFilename char ProtocolOutputFilename char ErrorString e OutFilename pointer to the filename string to write the decoded data to e StartSample the index of the first sample to start decoding e EndSample the index of the last sample to decode e ShowEndpoint 999 show all traffic otherwise sho
107. anual FAST PAN BUS VIEWING The USBee QX Suite Fast Pan Bus Viewing lets you quickly pan through a busses decoded data For each bus there is a left and right pan button on the left side of the screen Simply press these buttons to page to the next or previous bus transactions r BE USBee Suite Pro USBee DX Connected C cwav USBee Test Files DXDemo usbeecomp j A C or File View SpeedandSamples Trigger Setup Help lt i CNE a 200us div 151 833us 351 833us 551 833us 751 833us 951 833us 1 151833ms 1 351833ms 1 551833ms Digitaro Digital Digital Digitar 3 SP2 o gig G G wey gf o fce Digitara Digital s pes FEAA Digitare Digitar 7 Async 6 s 5 pma B Spr mc _ UART Analog Cors Capture Oncel Capture Many Measurements L Oscilloscope T Xi X2 dX 1 dX Period Frequency Duty Cycle Ons Ons Ons Ons infinity Ons infinity Inc All Rights Reserved Dasigned and Manufactures only in the USA USBee QX User s Manual 25 HOT KEYS The USBee QX has a full set of hot keys that lets you drive the acquisition of samples setup configuration and quickly view your data using the keyboard Key Left Arrow Right Arrow Shift Left Arrow Shift Right Arrow Up Arrow Down Arrow Home End Ins Del WN O e9 O oO HO UW PNR 26 Function Previous Edge Packet Next Edge Packet Pan Left Pan Right Previous Waveline Next Waveline
108. any way that is required It is up to you to define any events your protocol needs to help packetize and process your data in the PacketPresenter For example the following screen shot shows the PacketPresenter definition file Custom waveline settings and the resulting capture from running the above example code on a toggling line 94 USBee QX User s Manual Z USBee QX Suite USBee QX Demo Mode C cwav USBee Test Files QXCustomTesting usbeeqx Channet Settings Em File View SpeedencSempies Tagger Setup Heip _ Digtal Signals _Ansiog Snot Spectrom Anaher J USB J sm vc async 1 Wee Chooi E 100 1980476 2003975 Cassels 7252 332ms 100 156us bisar mtis if Ps2 Mbus es can Seist Partei SOOO Custom Search Groph Jigital 0 A Use PacketPresenter Definition Fite name is a B Bi a a H a a A z Save Cancel CAcwere USB ee Test Filev detadtByte ba Tae defaultByte txt Notepad CHANGING THE BACKGROUND COLOR OF OUTPUTTED ENTRIES You can control the background color of the entire WriteEntry item by embedding a color code anywhere into the text string Color codes are in the following format RGB Where R is the Red value and is a single digit of O thru 9 G is the Green value and is a single digit of O thru 9 B is the Blue value and is a single digit of O thru 9 For example To output an Entry that has a bright green background us
109. as the second parameter Dim Params Parameters Split CChar Dim SignalToUse As Double Val Params 1 Dim SignalMask As Integer 1 lt lt CInt SignalToUse Make the mask that will mask off the channel we want in the sample Now go from the start of the samples to the end and process the decoder For Sample To NumberOfSamples 1 This example decoder places a label at every transition of a digital signal Dim NextEdge FindNextEdge Sample SignalMask 1 If NextEdge gt Then Edge was found Write out a waveline bubble with text This text will be displayed inline with all of the waveforms as the user scrolls and zooms WriteEntry BW NextEdge NextEdge 100 Changed S amp Sample amp N amp NextEdge Send this data to the PacketPresenter to further process this protocol In this case we just send a 1 or based on rising or falling edge Not terribly useful by itself but shows how you can send a bit byte strem through the PacketPresenter from this custom decoder Dim DataToSend As Integer If SampleData NextEdge And SignalMask Then DataToSend 1 Else DataToSend End If If PPOn Then SendDataToPacketPresenter PPInFilename NextEdge DataToSend 8 1 Send the data to the Packet Presenter Else There are no more edges so end Exit For End If Sample NextEdge 1 Next ElseIf CBool InStr Parameters ToUpper RISE Then Sample Decoder that just detects when a signal
110. ate the following screen will appear GG Version Updates gt i You have the most recent version You have version 1 0 25 installed 82 USBee QX User s Manual DEVELOPING YOUR OWN CUSTOM DECODERS The USBee QX Suite allows you to create your own custom protocol decoders Your custom decoder can process the raw signals both analog and or digital and output waveline bubbles with text as seen below and even route the data or events through the PacketPresenter for further processing See the chapter on the PacketPresenter on how to utilize this powerful feature To implement a custom decoder you must create a Class Library DLL using the code below as an example You can build this Class Library using the free Microsoft Visual Studio 2008 Express or newer Our example is in Visual Basic but can easily be ported to C or other language supported in Visual Studio We will first show how to use a Custom Decoder and then show how to design one USING THE CUSTOM DECODER Using the Custom Decoder that you build is simple To select to use your Custom Decoder you select the Custom tab in the Channel Settings dialog box You can then enter a set of parameters that are sent to your decoder These parameters can specify anything you may need to determine how to decode your protocol including which protocol which signals to use baud rates inversions etc and is purely defined by you Below is the Channel Setting screen showing that we
111. ation of certain signals by streaming sample data directly to disk This module has been requested by many customers who want to capture signals for hours and analyze their data that won t fit in the interal 32M sample buffer The USBee QX Streaming Module compresses the sample stream and sends it to the PC to store on the hard disk This lets the sample buffer to be up the the size of the hard disk 100 s of GBytes instead of the onboard 32 M sample buffer The only limitation is that the bandwidth needed must be achievable This is explained below STREAMING BANDWIDTH The key to successful sample streaming is the overall bandwidth that your setup can achieve versus the signals being captured As long as the bandwidth needed is less than what can be achieved then your stream can last until your disk limit is reached During streaming capture you will see the overall average transfer bandwidth as well as if any data was lost due to a bandwidth mismatch The bandwidth your system can achieve is based on the slowest of following e USB Transfer Speed USB 3 0 connection gets typically 150 250Mbytes sec e Disk Write Speed Hard Disks SSD or RAM disks have their own write limitations For fastest captures use SSD or RAM disk drives The bandwidth your captured signals require is based on the following e Number of channels captured 7 Digital 1 Byte sample or 15 Digital 2 Bytes sample e The number of edges on your signals Each
112. be found For example if you want to find when two falling edges occur within 10usecs of each other specify This Event happening between Os and 10us anytime For the Events 2 32 both anytime and immediately are available Anytime specifies a time period minimum and maximum in which the entire event must occur for a match to be found The match can occur anytime after the previous event but must occur within the time window For example if you want to find when two falling edges occur within 10usecs of each other specify This Event happening between Os and 10us anytime after the previous event Below shows a diagram for the anytime setting As long as Event 2 is at least Minimum and at most Maximum time it is considered a match y Immediately specifies a time period relative to the end of the previous event in which the entire event must occur for a match to be found For example if you want to find when two falling edges occur within 10usecs of each other immediately following the previous event specify This Event happening between Os and 10us immediately after the previous event Below shows a diagram for the immediately setting As long as Event 2 occurs between the Minimum time and the Maximum time it is considered a match Event 1 Event 2 USBee QX User s Manual 107 Below shows an example of applying a time window The first search line shows all occurrences of when the analog CH1 is outside the range OV to 4V Th
113. bit is a 1 We are already at the start of the next bit Write out a bit data marker WriteEntry BW Sample tEdge1 1 Sample tEdge1 tBits tBits 1 Else USBee QX User s Manual Pulse is not the right size so bail and keep looking WriteEntry BW Sample tEdge1 x 900 Sample tEdge1 tBits 0 Continue For End If Else No edges at all So we are done Exit For End If ElseIf DecodeState LOOKING_FOR_START_BIT_2 Then Now look for the next edge tEdge1 FindNextEdge Sample SignalMask 1 If tEdge1 gt Then We found the next edge Check to see if this falling edge is in the right timeframe tPulseWidth tEdge1 Sample SamplingRate If tPulseWidth gt 0 000004 And tPulseWidth lt 0 000011 Then The bit is a which means we are not aligned But this may be the that starts the 7E so stay in this level to see if next bit is a 1 Now get us to the start of the next bit tEdge2 FindNextEdge tEdge1 SignalMask 1 ByteStartSample Sample Sample tEdge2 ElseIf tPulseWidth gt 0 000012 And tPulseWidth lt 0 000019 Then The bit is al DecodeState LOOKING_FOR_BITS ByteAccumlator 128 Bits are shifted in from the MSBit BitCounter 2 tNumberOfOnes 1 Reset the bit stuffing removal We are already at the start of the next bit Write out a bit data marker WriteEntry BW Sample tEdgei 1 Sample tEdge1 tBits tBits 1 Else Pulse is not the
114. ccescceceeecceeseesecessenseeeseagaes 27 Annotations and Sticky Notes cccccccsssseccecessecceseeseceeseeseceeeaeeseeesaaneeees 28 PC CUISITION Control xs pacccrastecnuincsecossnetetbusndpedesnntathwsussaussutseztwensneaiesesdaatesesees 28 Display Modes asec tances esa enact nce a aai 29 Analog Channels SCalii es ccewssserccsessssaseassceesreaiinepaasdeasieusiiacpaasdensieanienaneantens 29 USBee Suite Data File IMPOrting cccccccccccssssseeeeceeeeeeeeececessaaeeeeeeeeeees 29 Browser like NaVigatiOn ccsscccccccccessseececccceeeseececessuaeseececessuaueeeeeeeseaees 30 Complex TRICE MNG sansurin ninan E aR A 30 Relative Time Decode sicscscecenicntsancesacscnvsdesnerwnansaansadevandeaneseanideietensvuseruiewutes 31 US BEETA CONTROL PANEL wo sanaieessnmanceatamnslondusgaaaadsnansiedeaneoanaianaihwsuancpemtiseriineddanataassee 32 OUK STAR aa a 33 PC SYSTEM REQUIREMENTS spestcceSacaticeccsantaccsantsnsaannedosdsasetessmaneietiientestecasadeatdesetmornsaes 33 SOFTWARE NSTALLATION sessenseneeeeoosrreeseoesorrserneoesoresrenseeeoresnensensorrsneneeeeoresneneeeeone 34 Detailed Software Installation cccccccssessecccssesecccecaessecescauseecessaunsecessaenseeseas 35 DEMO NIOD arere E E E A E 39 TESTING YOUR CIRCUIT USING THE USBEE QX cccceccecescecescesesceeeeeeeneeeeeeeeeseueeseeeess 40 USING THE USBEE QX SUITE MIXED SIGNAL OSCILLOSCOPE csceceees 41 PAVE ST OP a a A EE aintuen E AAN 41
115. coder takes the captured data from an SPI bus Hardware Setup To use the Decoder you need to connect the USBee Test Pod to your hardware using the test leads You can either connect the test leads directly to pin headers on your board or use the test clips for attaching to your components The SPI Bus Decoder uses any one of the 24 digital signal lines O thru 21 T and C for the SS slave select SCK clock MISO data in MOSI data out and the GND ground line Connect the SS SCK MISO and MOSI to your digital bus using the test leads and clips Connect the GND line to the digital ground of your system Software Setup Activate the below Channel Settings Dialog by clicking the grey tab on the left of the signal names on the main application screen B Channel Settings n t f x Single Signal uss f si i rc asme iwe Signal Selection 012 56789 A DEF Enable Clock O MOOO MOSI Data MISO Data OO O O MOSI Samples gt MISO Samples gt Use Enable Enable Active r Bits Per Word Rising Rising Enable On Active Low gt Falling Falling Enable Off Active High C Save Cancel On the above dialog box select the signals you plan to use for the SPI protocol Also set the appropriate sampling edges for both data lines and if you would like to use the SS slave select signal If you turn off the SS all clocks are considered
116. d Voltshappens 1 times while J Bus Digital2 v decoded data contains x the value ED followed by the value 1D followed by anything and x X XIIA X x XX XES XX x Cursa USBee Capture Once Capture Many as Use PacketPresenter Definit j tnam Logic Analyzer Oscilloscope SAMPLE AND SMART MARKERS Placing markers in your traces can help detail what is happening in your design There are two types of markers that can be used The first marker type locks itself to a sample on a waveform and lets you specify the text The second is a Smart Marker that automatically measures the pulse width frequency period or duty cycle of the waveform at the marker location Smart Marker Automatic Measurement 8 667us USBee QX User s Manual 27 ANNOTATIONS AND STICKY NOTES The USBee QX Suite adds Sticky Notes which you can use to further detail your traces for documentation purposes You can also add Title and Footer text to your display that is saved with the trace file Le a ee as E USBee Suite Pro USBee DX Connected File View Speed and Samples Trigger Setup AD aa RQ ee OU LL 6 1 t 2 Gag z 5 s T t s Bd gt 5 F Cursors USBee Capture Once Logic Analyzer Oscilloscope ee Copyright 2009 CWAV Inc T Capture Many i oa Ons eet ACQUISITION CONTROL The USBee QX Suite adds more trace acquisition and triggering controls such as Normal Mode
117. d l B fo Digital 0 Digitali Digita Leje The USBee QX Suite maintains its last configuration and will reload that configuration when it is run again This configuration is located in your Users NAME AppData Local USBeeSuite directory where NAME is your username To reset the software to the initial state you can delete the files in that directory ANALYZER SETUP QUICK SETUP CONFIGURATION The USBee QX Suite can capture all of the input channels on the USBee QX With a QX plugged in it can capture 24 channels of digital 22 data lines Clock and Trigger signals and 4 channels of analog at the same time Although you can individually show each signal there are a number of Quick Configurations that let you instantly select just the channels you need To select a configuration click Setup on the menu and select the Quick Setup configuration of your choice Below shows the available Quick Setup options for the USBee QX USBee QX User s Manual 41 F USBee Suite Pro USBee RX Demo Mode C Program Files x86 CWAV Inc USBee RX Suite derno usbeecomp Cn Fie View Speedand 5amples Trigger Setup Help v USBee AX Control Pane Quick Setup 8 Digital Channels f 192u Quick Setup 16 Digital Channels Quick Setup 1 Analog Channe ck Setup 2 Analog Channels A V Quick Setup 8 Digital and 1 Analog Channe Quick Setup 8 Digital and 2 Analog Channels Quick Setup 16 Digital and 1 Analog Channe
118. d Suite USBee Advanced Suite Code USBeeQXToolbuil Z USBee GY Toolbuilder Example in C Initializing USBee Qk USBee Qa Found and Initialized petting Digital Outputs Setting Digital Logic Threshold Reading Input Channels D 15 88 D amp 15 88 D8 i5 A6 D8 i5 A6 D8 i5 A D8 i5 88 D8 1i5 88 D8 15 88 D8 15 88 D8 15 A6 DA 7 34 De 34 DA 7 34 Da 7 34 DA 7 34 DO 7 34 DO 7 34 DA 7 34 DO 7 34 DO 7 34 Di 6 C 55 Di6 C 55 Di 6 C 55 Di 6 CG 55 Di6 C 55 Di6 C 55 Di6 C 55 Di6 C 55 Di6 C 55 Di6 C 55 CH1 828775 H2 8 821774 CH3 H H64773 CH4 8 107386 pn naa Analog Waveform CHA 821289 CHi 6 018727 CHi 6 616165 CH1 6 818727 CH1 6 623851 CHi 831537 CH1 6 823851 CHi 841785 CH1 6 828975 CH1 6 828975 GH1 H 826414 CHi 4 626414 CH1 H 828975 TPE z0 028975 CH1 0 018727 CH1 0 031537 CHi 6 831537 CHI 6 023851 CHi 24 621287 Generating PWM Waveforms on 16 and i Generating Digital Waveform on D2 thru DY Reading Edge Counts and Frequencies Edge Counts A 4884 Edge Counts 1 4 Edge Counts 2 124914 Edge Counts 3 20258 Frequency 4 Frequency 5 Frequency 6 Frequency 7 6 Setting Logic Threshold Starting a Capture CaptureStatus Full 36 Triggered 4 Running 1 CaptureStatus Full 113 Triggered 1 Running 1 CaptureStatus Full 127 Triggered 1 Running Number Of Samples 4192256 Trigger Sample Positio
119. d you can pan through the occurrences of your searched items with the click of the mouse and see the total number of times the searched events occur E USBee Suite Pro USBee DX Connected ao e amp File View Speed and Samples Trigger Setup Help JD SOus div 2s a Search f lt f gt ps vigan Dga SP12 jital 4 Digitar s BB Channel Settings ron E Event 1 If CHi has a falling edge at voltage threshold 4V while Digital7 a eS Digital 2 decoded bus date contains ED followed by 1D E Async 6 Y If Analog Signal CH1 has faling edge at voltage threshold Voltshappens 1 times Analo 3 while Jl Bus Digitai2 v decoded data contains the value ED followed by the value 1D followed by anything and XXX XX XX XXESEX X XE Cursa USBee Capture Once Capture Many ggj cence Definst j File sme e Logic Analyzer Oscilloscope ADDING A SEARCH LINE To add a Smart Search line on the display click on the grey tab to the left of the line you want to change or click the sign to add a new wave line Once you click on the Search Tab you will see the Channel Settings dialog box as below USBee QX User s Manual 97 F Channel Settings Followed By Event 2 Followed By Event 3 Followed By Event 4 Followed By Event 5 Use PacketPresenter Definition File name is below When you specify a Smart Search and click on Save the new Search line w
120. data event received USBee QX User s Manual 139 CHANNELX CHANNELY OR CHANNELXORY CHANNELX CHANNELY or CHANNELXorY specifies what channel is used when an event or data is defined for starting or ending a packet Channel X and Channel Y are different based on what the physical bus is and can be found in Table 1 Channel X and Channel Y Definitions Per Bus Type If it does not matter which channel the data or event occurs on it could be either use the CHANNELXorY keyword Packet Start type value Start of a packet is based on a data value value 41h value of data that starts the packet bits 8 channelX data event must be received on channel X or channelY data event must be received on channel Y OF channelxXory data event must be received on either channel X or Y DECODE SECTION Each packet can have encoding on the data that needs to be removed in order to see the real data This section defines what decoding should be done to the packet The entire packet from start to end is sent through the decoders If only select parts of the packet needs to be decoded you must create your own Add In decoder using the ADDIN keyword Available decoding types are Keyword Definition NRZI A bit change on the input means a 1 bit on the output no changea 0 MANCHESTER Remove Manchester encoding from data INVERT Invert all bits ZBI5 Zero Bit Insertion removal removes the 0 added after 5 1s ZBI6 Zero Bit Ins
121. ded USBee QX User s Manual 219 15 SIGNAL CAPTURE MODE The below hex dump is from a 15 signal capture where two bytes contain a sample as described below The stream starts with a 01 00 00 00 which indicates this is a 15 signal capture Following these 4 bytes are the streamed samples This is a capture of an approximately 228 5kHz signal on channel 4 X File Edit View Operations Template Aerial Tools Window Help FU 3R 42 BORA w S so 42 MI ASCII default A Da o go cA E E 0 01 1 001 00000001 A O O Length 120004 The format of the samples in the streaming file is a simple runlength encoded pattern When sampling in 15 signal mode DO D14 each byte is a sample with the MSB indicating if it is a RLE count or not If the MS bit is set to a one the low 15 bits is a RLE count If the MS bit is a zero then the low bits are the digital state of those signals for that one clock sample DO D14 For example a Ox0000 followed by a 0x8005 is six samples with all digital channels DO D14 at logic level zero And since each sample is taken at 100 8 MHz you can compute the time by counting the samples RLE counts can be concatenated as many times as needed 220 USBee QX User s Manual GETTING HELP We are always eager to help you to get the most out of all USBee products If you have any questions comments bug reports or suggestions please contact us We actively improve our product line and your feedback is the
122. detail your traces for documentation purposes You can also add Title and Footer text to your display that is saved with the trace file i USBee Suite Pro DX Connected File View Speed and Samples Trigger Setup r a Pe sien EZ f T RX RST Ax RQ RK ras 54 EiL CN UIT 6 1 z gt s T Gd F Cursors USBee cote once Copyright 2003 CWAV Ine USBee QX User s Manual 113 ANNOTATIONS Annotation Text Boxes are editable text blocks that are located at the Top and Bottom of the USBee QX Suite window Annotation Text Boxes are enabled and disabled using the View Annotation Text Boxes menu item To edit the text simply select the box and edit the text This text is then saved with your capture files G E USBee Suite Pro USBee SX Demo Mode kodla Setup Help lt i B a File View Speed and Samples Trigger Here is the top Annotation Text Box 5 601333ms 9 601333ms 13 601333ms 17 601333ms 21 601333ms D x 2 pu k n K e pH e pu k pH R HH orci Tm a mmm em ne em Tn nr tT i LO CK C4 HOU RUN HUTT CH VU CHC A T_T LTT R e e H E NENEN SSSR NEN Here is the Bottom Annotation Text Box Demo Capture Many Measurements USBee Logic Analyzer Oscilloscope Drawing MISO E e X2 dX 1 dX Period Freq ee es Ons 10 7005ms 10 710667ms 10 167us 98 360656kHz 423345ms 23 6 114 USBee QX User s Manual STI
123. dow you will see the various measurements made off of these cursors e X1 Position time at the X1 cursor relative to the trigger position e X2 Position time at the X2 cursor relative to the trigger position e QX time difference between X1 and X2 cursors e 1 QX the frequency computed using the period between X1 and X2 cursors INSTA MEASUREMENTS The Insta Measure feature lets you quickly and accurately measure events and levels by simply hovering the mouse over a signal and without placing cursors Inta Measurements available are as follows Analog Insta Measurements e Voltage At Cursor Digital Insta Measurements e Width Period Frequency and Duty Cycle 60 USBee QX User s Manual Screen Shots USBee QX User s Manual 61 BUS DECODING OPTIONS The USBee QX Suite software has a powerful embedded bus decoder feature that allows you to quickly analyze the contents of embedded communications captured by the pod This section details each of the available bus types and the parameters required for proper setup GENERIC SIGNAL SETUP The default trace shown on a waveline is a voltage versus time waveform representation of an input wire on the USBee QX Hardware Setup To use the generic signal display you need to connect the USBee Test Pod to your hardware using the test leads You can either connect the test leads directly to pin headers on your board or use the test clips for attaching to your components
124. e Command EndByte a e be which is the text associated with the Command Field 4 bits in msbfirst order 0010b 2 CONDITIONAL ROUTE OF DATA TO ANOTHER PROTOCOL Many embedded protocols support multiple layers of protocol where each protocol layer handles a different set of services or functions In these multilayer protocols a field of data from one protocol layer may be the input data to another layer of protocol Routing this field of data to a new Protocol is as easy as naming the Field the same name as the Protocol If the Field name matches any protocol the entire data for that field is passed to that Protocol for processing 146 USBee QX User s Manual Below is an example that shows a field being sent to a new layer Layer2 of protocol when the command field is a 1 Protocol name Layerl Packet Decode Fields Fields Command 4 0 h Address 8 h Fields Command 4 1 h Layer2 48 h Protocol name Layer2 Packet Decode Fields Fields L2Command 4 0 Fields L2Command 4 1 Fields L2Command 4 2 sDgRool d QoS 16 d ral h h Layer3 44 h USBee QX User s Manual 147 PACKETPRESENTER ADD IN API The USBee QX PacketPresenter automatically processes many types of data streams However it cannot decode custom coded data streams Using the PacketPresenter Add In API the data stream can be decoded to the basic data values for any custom coding The USBee QX software package includes a samp
125. e Nx h All other scancodes Fields 1 Device To Host Key Down Scancode Nx H Host to Device Fields 2 SHost To Device Command Ny h 166 USBee QX User s Manual USBEE QX ANALOG SIGNAL GENERATOR 2 USBee Suite Pro USBee RX Connected C cwav USBee Test Files ProtocolSetup usbeer The USBee QX has an Analog Signal Generator built in It outputs a voltage pattern on the Aout signal out the side of the Pod To specify what waveform pattern is generated you use the Analog Generator section of the USBee QX Control Panel as seen below There are 5 types of analog signals that can be generated by selecting the associated radio button e Sine e Triangle Ramp e Square and DC You can also select the frequency generated by using the slider to the right of the Frequency line The minimum and maximum voltages are also specified using the sliders from OV to 3 0V USBee QX User s Manual 167 Below are a few of the waveforms available F 2 USBee Suite Pro USBee RX Connected C cwav USBee Test Files ProtocolSetup usbeer gt a Sa File View Speed and Samples Trigger Setup Help A USBee RX Control Pane BSemplecockis 24000000 ips Sample Cock is external on C ineut Conpgragts KI ONAY da AF Rigter imensi Qraper me Marectertrent ordy m e LN UE Potent 7 911 570 aed shan peres pareing Tagger Settings r a USBee Suite Pro USBee RX Connected C cwav USBee Test Files ProtocolSetup
126. e OutFilename pointer to the filename string to write the decoded data to e StartSample the index of the first sample to start decoding e EndSample the index of the last sample to decode e Rate is as follows 69 600 Msps O 39 300 Msps O 29 200 Msps O 108 100 Msps O 58 50 Msps O 28 20 Msps O 107 10 Msps O 57 5 Msps O 27 2Msps O 106 1 Msps O 56 500ksps O 26 200ksps O 105 100ksps e Channels Bit mask which represents which signals are part of the parallel data bus Bit O is Pod signal 0 Bit 15 is pod signal F e Clock Which signal 0 15 to use for the clock signal e UseCLK 0 don t use the Clock signal above 1 use the Clock signal above to qualify the samples e CLKEdge 0 use falling edge of the Clock to sample data 1 use rising edge e Delimeter 0 no delimiter 1 Comma delimeter 2 Space delimeter e Showall 0 Only show the data payload 1 show all packet details e Hex 0 display data in decimal 1 display data in hex e BytesPerLine How many output words are on each output line e ProtocolDefinitionFilename filename for the Protocol Definition File to use to create a PacketPresenter file If this value is O then the PacketPresenter feature is turned off e ProtocolOutputFilename filename that is created for the output of the PacketPresenter 198 USBee QX User s Manual e ErrorString string that holds an error description of the routine returns an e
127. e QX Suite application These PacketPresenter Definition files are in text format and are easily created using a simple text editor Each bus defined in the USBee QX Suite application can have a different PacketPresenter Definition File The intent of the PacketPresenter is to produce a series of 2 dimensional arrays of labels and values to be displayed as below by the user interface Read RSSI 14 34 It is the PacketPresenter Definition File that defines how the data is to be parsed and displayed COMMENTS IN THE PACKETPRESENTER DEFINITION FILE Comments are started with a semicolon and go until the end of the line CONSTANTS IN THE PACKETPRESENTER DEFINITION FILE Constants are fixed numbers anywhere in the file These constants can be expressed as decimal hex or binary using suffixes after the value Decimal has no suffix Hex uses the suffix h Binary uses the suffix b So 16 10h 10000b 244 F4h 11110100b Gain and offset values used in the Fields section are always in decimal and can contain decimal places 132 USBee QX User s Manual PACKETPRESENTER DEFINITION FILE SECTIONS Each PacketPresenter Definition File has the following syntax that separates the file into sections that correspond to the Channel definition and each of the Protocol Processors Protocol Protocol Protocol PROTOCOL SECTION Each Protocol Section defines what the incoming data stream looks like how to bre
128. e era ee N 137 EVO SIG Malai cancers eae anes T E 138 types Vile 2 coc caier achat E acaemeoiatenole 138 tpe Lene tuine n EANA EANA NAA N 138 type EVENT ie aee AE EDET E SE 139 TV Se TCO Tauroa a a a 139 CHANNELX CHANNELY or CHANNELXOTrY sseeecccceeeeeseeeceeeeeeeeeeeees 140 Decode SECTION sis vececcsescuricvarsarscie aunaueratieceasas E EA 140 SUBSTITUTIONS ai E eras E N EES 141 Fields SECO erra NEN NN ANANIN 141 Field INES PEOCESSIN Gs rnch vsracaccroartassratoneeseeabnueaneacarsscetuienaese 141 Unconditional Field Lines cccccccsssscccecessececceesececeeeseceeseeeecessueeeeees 142 CORGIEIOM SI Field NGS ms sasccescs scan a cece steeds ees 142 Fed ne FOMA reren aaa EE EEE 142 Feld FOMA terere ase a a EEA O 142 Bus Events in the middle of a packet cccccsseeccccesseeeeceeseecesaeesceeseeaeees 143 LOOKUD Tales asan N ene aeree 144 Examples of Field Lines and Fields ccccccssssecccceseceeeeeeecceeaeeeceeseeneees 145 JoseP Dataene aan esaeutec ees eaase ieacatee oseateeiwaerteeesereies 145 Conditional Packet FORM al eresien a veered 145 SHINS LOOKUDparcecaretsaseacerrecsaeparesteceacas a cracaes AE 146 Conditional Route of data to another Protocol cccccccssssseeeeeeeeeeeeeseeeeeeas 146 P cketPresenter AGGAIN APL uc4 ten tile da eae 148 Sample PacketPresenter Add In Decoders c ccsecccesececeececeececeeeceteuececsueceeanecs 149 LoGb back DECODE o nu E a
129. e second search line is the same criteria with the addition of a time window applied Only matches that are between 274us and 10seconds are displayed If you are looking for occurrences that are less than a specific time set the first entry to Os and the second to the upper limit File View Speed and Samples Trigger Setup Help lt 800us div _ 8 883167ms 8 083167ms 7 283167ms 6 483167ms 5 683167ms 4 883167ms 4 083167ms CHIZ gt 0 tov f cHi lt sotoav Be f Cursors i So Logic Analyzer Oscilloscope F x2 dX 1 dX Period Frequency Duty Cycle be on oe Ons eee 8 373333ms 274 5us 3 642987kHz Ons i a Event 1 If CH1 voltage is not between OV and 4V and happens between 274 us and 10s if Digital Signal pick one as rising edge happen times or E i f Analog Signa CHi has ising edge at voltage threshold 2 Volts happens while IL Bus pick one decoded data is anyth ant V Analog Signal CHL is not 0 Voltsto 4 Volts and V This Event happening between 274 jus X and 10 s hg anytime after the previous event Use PacketPresenter Definition File n s below of Apply ir me For Events other than the first Event 2 32 you can also specify immediately to indicate that the event must happen between the first time and second time starting at the end of the previous event 108 USBee QX User s Manual The following example shows two search lines The first search line shows all occurrenc
130. e the following WriteEntry OutFile 0 100 Hello World 090 To output an Entry that has a dark red background use the following WriteEntry OutFile 0 100 Hello World 400 Some common color codes are as follows USBee Suite Pro USBee SX Demo Mode C cwew USBee Surte Logic Anshyzer USSee Suite US8ee Suite bin x86 Debug demousbeecomp o Ser File View SpeedandSamples Trigger Setup Help lt ake k J 10us div AAEM 6 424E25mM5 EAlLE2Ems SAMEISMS 63546253M 6 354625mM5 637465 E 364625m5 6354625ms 5 354EI5ms 63346254 304625ms Cursors _ oe USBee Demo Capture Many A Measurements Logic Analyzer Osolloscope xt x2 dX eX Penod Frequency Duty Cycie Ons 1 581625ms 1495705ms 314 083us 3 183868kHZ IUST Sus ULMI SHOR Copprght 2110 OMAN re Agee Reserves Cenigres sre Marsares srh i Pe UAL USBee QX User s Manual 95 If you do not embed a color code the background color will be a light cyan 96 USBee QX User s Manual SMART SEARCH The USBee QX Suite Smart Search highlights the sections of your trace matching your areas of interest so that you don t need to waste time hunting for the data you need You can specify up to 32 levels of search events that are any combination of bus decoded traffic states or edges of digital or analog signals inside or outside of analog voltage ranges and or digital ranges and all validated by time specific windows Once specifie
131. e versus time waveform Just place the cursor over the decoded traffic and get a see through image that shows you the wiggles that made that byte AC awie JA C o JA 12C Transaction ee E a He as a SETUP Add J GET DESCRIPTOR DEVICE M ACK USB Transaction USBee QX User s Manual 21 i eas gee aE ood Se el ed ot a TO ote t t t l TTT cee es es on Rs Lom i eta ous eee Oe T ao ee PS2 Transaction SUuS S av eh SEU EES Parallel 7 Bus 4 D4 BA T 12S Decode D 125 RTR 0 Cth08 Data 00 11 22 33 44 55 66 77 CRCOBD4 ACKO CAN Transaction 22 USBee QX User s Manual Serial Bus Setup is simple and straightforward simply choose the signals for the bus and set how the bus is configured Not sure how your design works Nota problem You can try different configuration settings and the busses will be decoded using those settings on the fly so you can get it right h i ry Fee ee Te Jee J ac ie i E a IE i i fe eeh ae MOSI Data E A a i K a k E J k A a Y T I Pa ee ce ee a a a MSO Data DOO W OG GE S S t l S a i r MOSI Samples r MISO Samples Use Enable r Enable Active r Bits Per Word Rising Rising Enable On Active Low a O Falling O Falling Enable Off Active High Save Cancel USBee SX options shown above DATA STORAGE Save your entire data capture to file quickly using the USBee QX Suite data format to be read back in later for
132. earch using the first dropdown box This box is filled with only the single signals that are displayed on the screen Then choose the edge you want to search for rising falling or either rising or falling Finally choose how many edges you need to find consecutively If you want to find areas that have NO edges you can specify 0 Below shows a search that finds all rising edges of the signal Digital 1 Search Event 1 If Digital 1 has a rising edge Digitaro A TIEI Digital 1 v If Digital Signal Digital iy has rising edge happen 1 times or igi AaS G Digital 2 E If Analo xg Signal CH1 has sing edge at voltage threshold 2 Volts happens 1 times Digital 3 while x tk k k E Bus pick one decoded data is anything 00 and and tal Signal States ere F WOOUx RECESS x FIM fo co 1 PRR x BESS S SX FSS 10 and SPL2 Digital 4 Digital S 2C5 Digital 6 Digital 7 Followed By x tk e k k k Async 6 Digital 6 Event 2 Digital 7 Followed By Event 3 Followed By Event 4 Followed By Event 5 Followed By Garces Event 6 USBee Capture Once Capture Many Measurement Use PacketPresenter Definition File name is below Logic Analyzer Oscilloscope dx Apply 100 USBee QX User s Manual The second line lets you find edges on the analog signals if your USBee has them First select the Analog channel you want to search using the
133. elds and what to do with the field data FIELD LINES PROCESSING During processing the Fields Section is processed one Field Line at a time in the order that they are listed in the FIELDS section Each Field Line is parsed against the incoming data packets Once a single Field Line is successfully processed and output the PacketPresenter starts over at the top of the Filed Lines list for the next packet This ensures that there is only one output packet for each input packet for a given protocol There are 2 types of Field Lines A Field Line can be conditional or unconditional Unconditional Field Lines are processed for any packet Conditional Field Lines are only processed if certain fields match a specific value Any Unconditional Field Line no conditionals generates an output line on the PacketPresenter screen Any Conditional Field Line that evaluates to True generates an output line on the PacketPresenter screen Any Conditional Field Line that evaluates to False is skipped and produces no output line on the PacketPresenter screen The Field Lines should be listed with the conditional field lines first followed by an unconditional field line to catch all packets that are not explicitly defined in the conditional field lines USBee QX User s Manual 141 UNCONDITIONAL FIELD LINES Unconditional Field lines are parsed and decoded data is output for every packet that is input The Fields specify how to interpret the data and how to o
134. elimiter long showall long hex char ProtocolDefinitionFilename char ProtocolOutputFilename char ErrorString CWAV_IMPORT int CWAV_API DecodeI2S unsigned __int64 reservedi1 unsigned char OutFilename unsigned char InlineFilename __int64 StartSample __int64 EndSample unsigned long Rate unsigned long Channel long BitOffset unsigned long AlignValue unsigned long AlignEdge unsigned long AlignChannel unsigned long UseAlignChannel unsigned long ClockChannel unsigned long ClockEdge unsigned long BitsPerValue unsigned long MSBFirst unsigned long delimiter unsigned long hex long BytesPerLine char ProtocolDefinitionFilename char ProtocolOutputFilename char ErrorString CWAV_IMPORT int CWAV_API DecodeASYNC unsigned __int64 reservedi1 unsigned char OutFilename unsigned char OutTxFilename unsigned char OutRxFilename __int64 StartSample __int64 EndSample long Rate unsigned long TxChannel unsigned long RxChannel unsigned long BaudRate unsigned long Parity unsigned long DataBits unsigned long Invert unsigned long delimiter unsigned long hex unsigned long ascii long BytesPerLine char ProtocolDefinitionFilename char ProtocolOutputFilename char ErrorString CWAV_IMPORT int CWAV_API DecodePS2 unsigned __int64 reservedi unsigned char OutFilename unsigned char HostFilename unsigned char DeviceFilename __int64 StartSample __int64 EndSample long Rate unsigned long DataChannel unsigned long ClockC
135. er s Manual Streaming Capture takes samples of the channels at 100Msps compresses them and streams them to a disk file Once the capture is stopped you can view the traces and page between portions of the capture to save sections of interest Maximum Disk Space Used 10 0 ot GBytes Stop Streaming Process and View Capture Stored Trace CAPTURE RUNNING Capture Size 3MB Total Time 3 9 secs Avg MBps 0 7 Enter the size limit on the file you want to store to your drive This will stop the capture when this limit is reached Then press the Start Streaming Capture button Streaming will begin and the Capture Size Mbytes Total Time and Average Mbytes second stored will be displayed If data has been dropped due to insufficient write bandwidth you will see an OVERFLOW message as well Once the capture completes or you press Stop it will display a READY for PROCESSING message Since stored files can be 100 s of GBytes it is not automatically processed as it can take many minutes to process large files To process a capture for display press the Process and View Stored Trace button It will read the entire trace and prepare the system for displaying the trace You can also choose to process the streamed file at a later time If the stream trace has already been processed previously the data is loaded and displayed Only one stream file is maintained at a time Once a new stream is started the previous stream is removed
136. er the trigger position To Scroll the Waveforms in Time left and right you can click on the overview bar above the knobs scroll the Pan knob click and drag or mouse wheel on the knob or you can simply click and drag the waveform itself with the left mouse button To Scroll the Analog Waveform in Voltage up and down you can simply click and drag the waveform itself by selecting and dragging using the mouse or use the analog offset knob to the left of the analog waveforms To Zoom In or Zoom Out or otherwise change the number of Seconds per Division you can use the scroll wheel or single click on the waveform You can also use the Zoom knob click and drag or mouse wheel on the knob To zoom in scroll up or click the left mouse on the waveform window To zoom out in time scroll down or click the right mouse button on the waveform window To change the number of Volts per Division for an analog channel use the V div knob click and drag or mouse wheel on the knob highlight the channel you want to change or you can hold the left mouse button down and use the scroll wheel You can also highlight the signal and use the slider bar to the left of the waveform To view the entire capture buffer on the display press the All button The screen below shows all of the collected samples on a single screen for that trace USBee QX User s Manual 53 i a USSee Suite Pro USBee RX Connected C cwav USBee Test Files Protocotset
137. ertion removal removes the 0 added after 6 1s ADDIN Call your own packet decoder using the PacketPresenter API routine APIDecode substring Substitute bytes in the stream no spaces allowed Multiple decoders can be used and are processed in the order listed 140 USBee QX User s Manual SUBSTITUTIONS Substitutions allow a sequence of bytes up to 3 to be replaced with a different set Same size or less of bytes They can only be used on bytestreams not bitstreams Substrings define the bytes input and the bytes output The Substrings must not contain any spaces Examples of this are below 1 2 Replaces all 1s with 2s 1 2 3 Replaces all 1 immediately followed by 2 with 3 1 2 3 4 Replaces all 1 immediately followed by 2 with 3 immediately followed by 4 1 2 3 4 Replaces all 1 2 3 with 4 1 2 3 4 A INVALID the number of output bytes must be less than or equal to the input As an example the HDLC protocol uses the byte value 7Eh as the start and end flag of the packets and replaces all 7Eh in the data with the bytes 7Dh followed by 5Eh It also replaces all 7Dh in the data with the bytes 7Dh followed by 5Dh To remove this coding you would use the lines Once the packet is delineated and decoded by the previous sections it is ready to be displayed by the PacketPresenter Since each packet is made up of fields the Fields section defines how the packet is broken up into its fi
138. es of the CH1 being between OV and 4V The second search line shows all occurrences of when the Digital 0 line has a falling edge within 100usecs of the end of the first search File View Speed and Samples Trigger Setup Help 3 E 300us div 115 689667ms 115 989667ms l 116 289667ms 116 589667ms 116 889667ms 117 189667ms 117 489667ms chovov gt BB Ea SS 332 a i CHI D0 falling Digital 2 k Channel Settings Eem Single Signal Ps2 SMBus s can Serai Paralel v Event i If CH1 voltage is between OV and 4V S Digital 3 Digital 4 Digital S Digital 6 h h e te Digital 7 Followed By a Event 2 If Digital 0 has a falling edge and happens between 0 us and 100 us from the previous event Analog X If Digital Signal Digital O has falling X edge happen 1 times or E If Analog Signal CH1 has rising edge at voltage threshold 2 Volts happens 1 times while ck one ecoded data is anything 00 and and Digital Signal States are F KOCIX FESS Oax EEA 0 to IF KOOIX FOOSE EEGA 10 and E Analog Signal CH1 Cursors g gt 9 and USBee V This Event happening between 0 us and 100 us w immediately z after the previous event Logic Analyzer Oscilloscope Copyright 2009 CWAV Ine USBee QX User s Manual 109 FAST PAN BUS VIEWING The USBee QX Suite Fast Pan Bus Viewing lets you quickly pan through a busses decoded data For each bus there
139. esenter ByteStartSample 1 1 1 End If End If Next USBee QX User s Manual End If Close the Output File FS Close Catch ex As Exception End Try Close the PacketPresenter output file If PPOn Then ClosePacketPresenter End Sub Public Sub WriteEntry ByRef BW As BinaryWriter ByVal StartSample As Int64 ByVal EndSample As Int64 ByRef TextString As String DO NOT CHANGE THIS ROUTINE This routine writes the Entry in the file format that is used by the Custom Decoder This entry specifies the Start Sample End Sample and the text string to display TEY BW Write StartSample BW Write EndSample Write the length of the string in bytes include the at the end in the count Dim tStrLen As UInt32 tStrLen CUInt TextString Length 1 BW Write tStrLen Now write out the characters one byte at a time and put a at the end For x As Integer To CInt tStrLen 2 BW Write CByte Asc TextString Chars x Next BW Write CByte Catch ex As Exception End Try End Sub End Class As you can see in the above code the Parameter string that is passed from the User Interface to your decoder can be used for a number of purposes First it can specify which decoder to run If you have more than one protocol that you want your decoder to handle you can select which decoder runs using this text string For example in our example Custom Decoder we have a few decoders possible CHANGE RISE
140. etesscccenctosasevscmsvesatineiecvenseaonseeerdexe ncavatet a aa 218 EXTERNALLY PROCESSING THE DISK STREAM cccecccceccccececccccccaceceaceceaceceacecenceeeaceceas 218 F SIGNGI CODCUE VIO Cs correr eiio A E E tin purse eased 219 E5SIGNO Capture VIO C raetice cc cncis E A can once snen ae nee 220 GETING HELP ainina aac ceneeauc sews ecac nan ve cate ace pans ves avueeeenescac meu secetousevcvenseseeeee 221 USBee QX User s Manual 11 INTRODUCING THE USBEE QX POD Solve Bugs Faster and Easier The Only Deep Trace Analyzer That Shows You t Everything from the Wire to Custom Protocol Fields e USB 3 0 or WiFi Connected Oscilloscope Logic Analyzer Signal Generator Protocol Decoder Packet Analyzer EFEFEF Meet Our Most Powerful Fast Sampling Monster Buffer Packets to Wire on en k pno ji KE USBee QX Platform Up to 600 Msps 896 M Samples Edges 60V 240 OV 2 al 10 bit 100MHz Oscilloscope 8D x 1A Signal Generator Protocol Decoder for 12C SPI 12S Async CAN USB 1 plus others including Custom Busses and Fully Custom Packet Analyzer The Tools You Need All In One Place Introducing the Ultimate PC Based Programmable Multifunction Mixed Signal Oscilloscope Logic Analyzer with 12C SPI Async SDIO 1 Wire CAN protocol decoders Digital Signal Generators Frequency Counter and integrated Protocol Analyzers in a compact and easy to use USB Test Pod Designed to Solve Your Toughest
141. ettings Dialog by clicking the grey tab on the left of the signal names on the main application screen ee Y ms P oa a le 0112 56789AB TX Data OOCOOCOOOQOOO0OOC0OCOOC0Q0OO RX Data O DOOOOOOOOOCOOOO Data Bits p Parity Data Format TX and RX Baud Rate None Decimal are Inverted Even Hex are not Inverted Odd ASCI O Mark O Space On the above dialog box select the channels you want to observe Each channel can be attached to a different async channel Also enter the baud rate from 1 to 24000000 the number of data and parity bits and what output format you want the traffic USBee QX User s Manual 67 PARALLEL BUS SETUP The Parallel Bus Decoder takes the captured data from a parallel bus The Parallel Bus decoder is also a way to capture the data using an external clock Hardware Setup To use the Decoder you need to connect the USBee Test Pod to your hardware using the test leads You can either connect the test leads directly to pin headers on your board or use the test clips for attaching to your components The Parallel Bus Data decoder uses the 24 digital signal lines O thru 21 T and C the GND ground line Connect the GND line to the digital ground of your system Software Setup Activate the below Channel Settings Dialog by clicking the white box on the left of the signal names on the main application screen Ez Channel Settings Single Signat USB S
142. event event 1 Start of Packet channelxory End type event event 2 End of Packet channelxory Decode Fields Data Packets Fields 8 Data Ny h Do all of the Command Packets Fields 3 Start 1x h HOST 1x 1 h CMD 6x 4 L DSR 16x h Fields 3 Start 1x h HOST 1x 1 h CMD 6x 7 L RCA 16x h Fields 3 Start 1x h HOST 1x 1 h CMD 6x 9 L RCA 16x h Fields 3 Start 1x h HOST 1x 1 h CMD 6x 10 L RCA 16x h Fields 3 Start 1x h HOST 1x 1 h CMD 6x 13 L RCA 16x h Fields 3 Start 1x h HOST 1x 1 h CMD 6x 15 L RCA 16x h Fields 3 Start 1x h HOST 1x 1 h CMD 6x 16 L BLOCK LEN 32x h Fields 3 Start 1x h HOST 1x 1 h CMD 6x 17 L Address 32x h Fields 3 Start 1x h HOST 1x 1 h CMD 6x 18 L Address 32x h Fields 3 Start 1x h HOST 1x 1 h CMD 6x 24 L Address 32x h Fields 3 Start 1x h HOST 1x 1 h CMD 6x 25 L Address 32x h Fields 3 Start 1x h HOST 1x 1 h CMD 6x 28 L Address 32x h Fields 3 Start 1x h HOST 1x 1 h CMD 6x 29 L Address 32x h Fields 3 Start 1x h HOST 1x 1 h CMD 6x 30 L Address 32x h Fields 3 Start 1x h HOST 1x 1 h CMD 6x 32 L Address 32x h USBee QX User s Manual 157 Lookup Lookup 158 UO A WN FO O ODA ADA OF WBN EF OO
143. ext byte or bit to arrive Packet Start or End type Next Start End of a packet is the next byte bit to arrive You can use the EXCLUDE keyword in the END section to leave the end data on the data stream for the next packet This is useful for when there is no indication of the end of a packet except for the arrival of the next packet USBee QX User s Manual 137 TYPE SIGNAL The start or end of a packet can be indicated by a separate signal such as a chip select or a frame signal using the signal setting Packet Start or End type signal Start End of a packet is based on a signal signal signalvalue Signal number 0 15 level 1 level the signal needs to be TYPE VALUE The start or end of a packet can be indicated by a certain data value contained in the data using the value setting Multiple values can be used where any one match starts or ends a packet All bits in the Value are included in the resulting packet at the start of the packet You must also specify the number of bits that the value covers defaults to 8 bits if not specified using the bits keyword You can specify a mask value to apply to the start data and values When the mask value has a bit that is a 1 that bit in the value and data are compared All values are assumed MSB first Packet Start or End type value Start End of a packet is based on a data value mask bitmask Bitmask to apply to the data stre
144. g to your components The I C Bus Decoder connects to the SDA and SCL lines of the IC bus Use one signal as the SDA data line and one signal as the SCL clock line Also connect the GND line to the digital ground of your system Connect these signals to the I C bus using the test clips provided Software Setup Activate the below Channel Settings Dialog by clicking the grey tab on the left of the signal names on the main application screen T om Channel Settings an ee _ d A x J Signal Selection 012 5678 9 AG WEF Clock Data i Save Cancel On the above dialog box select the SDA and SCL signals The bus traffic will be decoded as in the following screen AC wtr 00 JA C fF JA amp AsRead JA 66 USBee QX User s Manual ASYNC BUS SETUP The Async Bus Decoder takes the captured data from an asynchronous bus UART Hardware Setup To use the Decoder you need to connect the USBee Test Pod to your hardware using the test leads You can either connect the test leads directly to pin headers on your board or use the test clips for attaching to your components The Async Bus Data decoder uses one or more of the 24 digital signal lines 0 thru 21 T and C and the GND ground line Connect any of the 24 signal lines to an Async data bus Connect the GND line to the digital ground of your system Software Setup Activate the below Channel S
145. ga low Trigger Out Semple Clock is extemal on Cinext a BL gi Width 16 65us USBee QX Control Panel Visible SEE THE INFORMATION YOU WANT FAST Setup of the USBee QX Suite is fast Capturing the data you need to solve your problems is just as fast You can see your design in action with just one click thanks to the easy to use trigger settings color coded signals and automatic buffer and sample rate settings DATA ACQUISITION OVER USB 3 0 Capture from 100 to 600 million samples per second for sample buffer depths of up to 32 million samples or 16 million transitions SUPERIOR QUALITY DESIGN PROFESSIONAL RESULTS The USBee QX Suite takes full advantage of the power the USBee QX Test Pod Each USBee QX comes with the best color coded highly flexible test leads the best test clips and our signature small and sleek design that can fit right in your pocket We are proud to say the entire USBee product line is designed and manufactured in the USA FAST AND DETAILED WAVEFORM VIEWING The USBee QX Suite lets you capture a huge amount of data Go exactly to the section of that data you want using the Quick Zoom with your mouse scroll wheel or use the Overview bar to rip through your millions of samples or hone in on a specific section USBee QX User s Manual 19 MEASURE IT Should that pulse be 10ms Measure it using our super easy edge snapping timing cursors Better yet you can use our Insta Measure feature to instantly ca
146. ge the colors back to their original state use the View Reset Colors to Default menu item Color Basic colors Hi EERE f f be FF EF Fe fF b eg FEF FF see FF Ff FF Euu uu E Custom colors BEE EHH BEE ff ff Custom Colors BACKGROUND COLOR The background of the waveform screen can be set to white or black using the View Background White or View Background Black menu items GLASS APPEARANCE Windows has added the ability to have a Glassy appearance on applications If your system is capable of this glassy look you can use the View Show Glass If Possible menu item to turn it on If it is not possible or you turn off Glass the display shows a grey background ae nebes Fi a E EH E E E a With Glass On With Glass Off USBee QX User s Manual 77 FILE OPERATIONS Using the File menu you can start a New file Save trace data Open previously saved traces and Export trace data to other file formats CREATING A NEW FILE To start a new file choose File New This will configure the screen to the default state with all available channels enabled SAVING A CAPTURE FILE After capturing a trace you can save it to disk using the File Save As menu item This saves all trace data cursor positions and screen format The files can be saved in either Uncompressed format usbeesuite extension or in Compressed format usbeecomp extension to reduce drive space requirements Saving a
147. geEnabled int TrigX_AnalogEdgeEnabled int TrigX_QualifyDigitalEnabled int TrigX_QualifyAnalogEnabled int TrigX_QualifyTimeEnabled int TrigX_InvertDigitalQualifierEnabled int TrigX_InvertAnalogQualifierEnabled int TrigX_InvertTimeQualifierEnabled int TrigX_DigitalEdgeChannel int TrigX _DigitalEdgeRising int TrigX _AnalogEdgeChannel int TrigX_AnalogEdgeRising int TrigX_AnalogQualifierChannel int TrigX_AnalogQualifierFrom int TrigX _AnalogQualifierTo int TrigX_AnalogTriggerLevel long TrigX _DigitalQualifierChannelMask long TrigX_DigitalQualifierFrom long TrigxX_DigitalQualifierTo int TrigY DigitalEdgeEnabled int TrigY AnalogEdgeEnabled int TrigY QualifyDigitalEnabled int TrigY QualifyAnalogEnabled int TrigY QualifyTimeEnabled int TrigY InvertDigitalQualifierEnabled int TrigY_InvertAnalogQualifierEnabled int TrigY_InvertTimeQualifierEnabled int TrigY DigitalEdgeChannel int TrigY DigitalEdgeRising int TrigY AnalogEdgeChannel int TrigY AnalogEdgeRising int TrigY AnalogQualifierChannel int TrigY AnalogQualifierFrom int TrigY AnalogQualifierTo int TrigY AnalogTriggerLevel long TrigY DigitalQualifierChannelMask long TrigY DigitalQualifierFrom long TrigY DigitalQualifierTo long CWAV_API StartCaptureQX unsigned long buffersize unsigned char TriggerPosition float SampleRate unsigned long channelmaskA unsigned long channelmaskB unsigned char ExternalClockingOn unsigned char CompressionOn long CWAV_API CaptureStatu
148. hannel unsigned long MSBFirst long hex char ProtocolDefinitionFilename char ProtocolOutputFilename char ErrorString CWAV_IMPORT int CWAV_API DecodeUSB unsigned __int64 reservedi unsigned char OutFilename unsigned char InlineFilename __int64 StartSample __int64 EndSample long ShowEndpoint long ShowAddress long DPlus long DMinus long Speed long Rate long SOF long delimiter long showall long hex char ProtocolDefinitionFilename char ProtocolOutputFilename char ErrorString CWAV_IMPORT int CWAV_API DecodeSPIVariable unsigned __int64 reservedi unsigned char OutFilename unsigned char InlineMOSIFilename unsigned char InlineMISOFilename __int64 StartSample __int64 EndSample long Rate unsigned long SS unsigned long SCK unsigned long tMOSI unsigned long tMISO unsigned long MISOEdge unsigned long MOSIEdge unsigned long delimiter unsigned long hex unsigned long UseSS unsigned long SSLevel long BytesPerLine long BitsPerByte char ProtocolDefinitionFilename char ProtocolOutputFilename char ErrorString CWAV_IMPORT int CWAV_API DecodeI2C unsigned __int64 reservedi unsigned char OutFilename unsigned char InlineSDAFilename __int64 StartSample __int64 EndSample long Rate unsigned long SDA unsigned long SCL long showack long delimiter long showall long hex char ProtocolDefinitionFilename char ProtocolOutputFilename char ErrorString CWAV_IMPORT int CWAV_API DecodeCAN unsigned __int
149. has a full set of hot keys that lets you drive the acquisition of samples setup configuration and quickly view your data using the keyboard Key Left Arrow Right Arrow Shift Left Arrow Shift Right Arrow Up Arrow Down Arrow Home End Ins Del WN O a9 O a HO U0WPNPR SIGNAL NAMES Function Previous Edge Packet Next Edge Packet Pan Left Pan Right Previous Waveline Next Waveline Show the Start of capture buffer Show the end of the capture buffer Insert a new waveline below the current line Delete the current waveline Capture Once Go to the X1 cursor Go to the X2 cursor Zoom out to view all of the capture buffer Open the Waveline settings dialog box Toggle the Decoder List window Zoom In Zoom Out Go to the Trigger position To change the names shown for a signal click on the signal name and enter a new name BUFFER SIZES AND SAMPLE RATE SETTINGS The USBEE QX SUITE captures the behavior of the digital and analog signals and displays them as traces in the waveform window The Speed and Samples menu lets you choose how the traces are captured Below shows the Speed and Samples menu Sample Rate 20Msps Buffer Size a 1M samples Sample Compression On Sample Compression Off External Clocking using the C input v Internal Clocking Minimum Capture Time 005 seconds Digital 4 amp USBee QX User s Manual 45 The Buffer Size lets you select the size of the Sample Buffe
150. he module is now installed and ready to be used Registration was successful Thank you Currently Registered Products USBee QX Pro Module You are licensed to use this software only on unmodified hardware provided by CWAV Inc which is enforceable by USA and International laws Violators will be prosecuted USBee QX User s Manual 211 SPECTRUM ANALYZER The Spectrum Analyzer feature displays the FFT Spectrum Analysis of the selected Analog Channel Once the analog channel you want to analyze is captured you can add a Spectrum Analyzer waveline To setup a Spectrum Analyzer waveline click the grey tab at the left of a waveline or add a new one by pressing the symbol and select the Spectrum Analyzer tab as below P Ss r a x es f smen Tus can T sein Paone sovsoio Custom sewn J Caph Ji Vertical Units View Mode Windowing Mode Reference Waveform db Normal v Peak Hold Average The spectrum can be displayed in a variety of formats e Normal Displays the FFT analysis of the analog channel waveform section that is displayed on the screen e Average Displays the average of the spectrum of 128 consecutive traces e Peak Displays the Peak value of the last 128 consecutive traces e Volts Displays the graph in linear Volts units e dB Displays the graph in logarithmic dB units e Rectangular Hanning Hamming Flat Top and Blackmann Harris The windowing algori
151. her programs in a number of ways First you can copy the screenshot of the window by selecting the window and pressing Alt PrtScr on your keyboard This copies the image of the window to the Windows clipboard and you can paste that image into any program that accepts images You can also use the Edit Copy as Text or Edit Copy as RTF menu items All packets are copied to the clipboard in the format specified Below is a sample of packets copied in RTF format and pasted into Word 128 USBee QX User s Manual 2 CYPRESSRFIC ADDRESS WRITEDATA Packet 1 Time 7 339333ms Write False CHANNEL ADR 0 CYPRESSRFIC Packet 2 Time 7 347833ms ADDRESS WRITEDATA 82 Write False QX CTRL ADR CYPRESSRFIC ADDRESS Packet 3 Times 7 256833ms Read False RSSI_ADR CYPRESSRFIC ADDRESS Packet 4 Time 9 189167ms Read False QX IRQ STATUS ADR CYPRESSREIC Packet 5 Time 9 199833ms Read False QX_BUFFER_ADR r XDATA E Packet 6 Time 9 204667ms 08 82 1E 99 A7 28 2A 8A 12 88 9E 58 18 CA CO CO Layer CYPRESSRFIC 9 265167ms READDATA Read False CHANNEL ADR Packet 7 Time 0 1 0 A 0 1 1 Below is a sample of packets copied in Text format and pasted into Notepad Layer CYPRESSRFIC DIR INC ADDRESS WRITEDATA Packet 1 Time 7 339333ms Write False CHANNEL ADR 0 Layer CYPRESSRFIC DIR INC ADDRESS WRITEDATA Packet 2 Time 7 347833ms Write False QX_CTRL_ADR 82 Layer CYPRESSRFIC
152. ifies forward 1 in time or backward 0 in time Return Value Sample number where the edge was found _SETTRIGGERSQX This routine sets the trigger condition to use during the next capture Calling Convention CWAV_IMPORT unsigned long CWAV_API SetTriggersQxX int TrigXEnabled int TrigYEnabled int TrigXorYEnabled int TrigXandYEnabled int TrigxXthenYEnabled int TrigYthenXEnabled int TrigX_DigitalEdgeEnabled int TrigX AnalogEdgeEnabled int TrigX_QualifyDigitalEnabled int TrigX QualifyAnalogEnabled int TrigX QualifyTimeEnabled int TrigX_InvertDigitalQualifierEnabled int TrigX_InvertAnalogQualifierEnabled int TrigX_InvertTimeQualifierEnabled int TrigX_DigitalEdgeChannel int TrigX_DigitalEdgeRising int TrigX AnalogEdgeChannel int TrigX _AnalogEdgeRising int TrigX AnalogQualifierChannel int TrigX_AnalogQualifierFrom int TrigX_AnalogQualifierTo int TrigX AnalogTriggerLevel long TrigX_DigitalQualifierChannelMask long TrigX DigitalQualifierFrom long TrigX_DigitalQualifierTo USBee QX User s Manual 191 int TrigY DigitalEdgeEnabled int Trigy AnalogEdgeEnabled int TrigY QualifyDigitalEnabled int TrigY QualifyAnalogEnabled int TrigY QualifyTimeEnabled int TrigY_InvertDigitalQualifierEnabled int TrigyY_InvertAnalogQualifierEnabled int TrigY InvertTimeQualifierEnabled int TrigY DigitalEdgeChannel int TrigY DigitalEdgeRising int Trigy AnalogEdgeChannel int TrigY AnalogEdgeRising int TrigY AnalogQualifierCh
153. iggerPosition what percent of the buffer should be prestored before the trigger e channelmaskA represent which samples to take Bit 0 1 Sample Digital O signal O ignore this channel Bit 1 1 Sample Digital 1 signal O ignore this channel Etc Bit 15 1 Sample Digital F signal O ignore this channel O O O Bit 16 23 255 Sample Analog channel 1 O ignore analog channel 1 O Bit 24 31 255 Sample Analog channel 2 0 ignore analog channel 2 e channelmaskB represent which samples to take Bit 0 1 Sample Digital 16 signal O ignore this channel Bit 1 1 Sample Digital 17 signal O ignore this channel Etc Bit 5 1 Sample Digital 21 signal O ignore this channel Bit 6 1 Sample Digital T signal O ignore this channel Bit 7 1 Sample Digital C signal O ignore this channel Bit 8 15 255 Sample Analog channel 3 0 ignore analog channel 3 O O O O O O O Bit 16 23 255 Sample Analog channel 4 0 ignore analog channel 4 O Bit 24 31 0 reserved e SampleRate is how many samples per second to capture Valid rates are in units of samples per second ranging from 10 to 100 000 000 e ExternalClockOn specifies whether to use the external clock input pin C to capture samples 1 or the internal sample clock as specified above 0 e CompressionOn specifies whether to use sample compression 1 or not 0 Return Value 0 Failed 1 Success 188 USBee QX User s Manual
154. igital outputs available on the digital channels 16 thru 21 and T and C Calling Convention CWAV_IMPORT unsigned long CWAV_API SetSignalsQX unsigned long mask unsigned long value e mask is the mask for setting each of the 8 USBee digital Output signals 16 through 21 and T and C A signal is not changed if the corresponding bit is a 0 A signal is changed if the corresponding bit is a 1 Channel 16 is bit O Isb and C is bit 7 e value is the digital level driven on the output signals A signal is driven high 2 5V if the corresponding bit is a1 A signal is driven low OV if the corresponding bit is a 0 Channel 16 is bit O Isb and C is bit 7 Return Value 186 USBee QX User s Manual 1 Successful e 0 Failure _ GETDIGITALSIGNALSQX READING THE USBEE QX INPUT SIGNALS This routine gets the current value of the digital input signals Calling Convention CWAV_IMPORT unsigned long CWAV_API GetDigitalSignalsQxX unsigned char digital to7 unsigned char digital8to15 unsigned char digital16toC e After this call the variable pointed to by digitalOto7 will hold the digital logic value read on the input signals O through 7 e After this call the variable pointed to by digital8to15 will hold the digital logic value read on the input signals 8 through 15 e After this call the variable pointed to by digital16toC will hold the digital logic value read on the input signals 16 through C Return Value 1
155. ign Then using the source code libraries drivers and DLL s that are included you can write your own PC application to control and monitor the signal pins on the pod SYSTEM SOFTWARE ARCHITECTURE The USBee QX Pod is controlled through a set of Windows DLL function calls These function calls are defined in following sections and provide initialization and data transfer routines This DLL can be called using a variety of languages including Visual BASIC C C etc We have included a sample application in C and VB that show how you can use the calls to setup and control the pod You can port this example to any language that can call DLL functions C Delphi Lab View After installing the USBee QX Suite software on your computer you can then plug in the USBee QX pod Immediately after plugging in the pod the operating system finds the INF file installed during installation This file specifies which driver to load for that device which is the Windows provided WINUSB driver This driver then remains resident in memory until you unplug the device Once you run your USBee Toolbuilder application it will call the functions in the USBEEADVSTE DLL file which is installed in the Windows System32 directory for 32 bit Windows or Windows SysWOW directory for 64 bit windows This DLL will then make the correct calls to the WINUSB driver to perform the USB transfers that are required by the pod Both example projects are built using Microsoft
156. ignal Selection 0 oe Signals Ew x ik NVI Clock Signal Clock Edge Rising Falling Save Cancel On the above dialog box select the channels you want to include in the parallel data bus You can also use any one of the 16 digital signals as an external clock Choose if you want to use the external clock signal and the external clock edge polarity The bus traffic will be decoded as in the following screen Paraltiel Coe a TIE i oo 68 USBee QX User s Manual 1 WIRE BUS SETUP The 1 Wire Bus Decoder takes the captured data from a 1 Wire bus Hardware Setup To use the Decoder you need to connect the USBee Test Pod to your hardware using the test leads You can either connect the test leads directly to pin headers on your board or use the test clips for attaching to your components The 1 Wire Bus Data decoder uses any one of the 24 digital signal lines O thru 21 T and C the GND ground line Connect the GND line to the digital ground of your system Software Setup Activate the below Channel Settings Dialog by clicking the grey tab on the left of the signal names on the main application screen if fs can seia Parallel_ Single Signal uss s c asme Wire 012 56789 AG DE F i Wire Signal OOOCOOCOOOOCOCOO On the above dialog box select the signal running your 1 Wire protocol USBee QX User s Manual 69 SPI BUS SETUP The SPI Bus De
157. ill be added to the display If your captured data matches these events anywhere in the trace it will display a bar at that location and mark it with a unique number The trace below has found 480 matches and the display is showing match 1 through 7 on the first line T 7 a _ USBee Suite Pro USBee DX Connected File View Speed and Samples Trigger Setup Help lt lt e 10us div 14 498917ms 14 488917ms 14 478917ms 14 468917ms 14 458917ms 14 448917ms 14 438917ms 14 428917ms Search 8 lt l gt 480 found o 0 Digital 0 Digital 1 Digital 2 Digital 3 xs h e e H SPL2 Digital 4 k Digitals 2C5 Digital 6 Digital 7 eth e k Async 6 _ _ gt Cursors USBee Capture Once capture Many Measurements Logic Analyzer Oscilloscope T Xi X2 dX dX Period Frequency Duty Cycle A Ons Ons Ons Ons infinity 1 970417ms 507 506872Hz 99 6 VIEWING SEARCH MATCHES Once a search has been entered and processed you can pan through the found matches by using the left and right arrow buttons on the search line You can also see the total number of matches by hovering over the line 98 USBee QX User s Manual ENTERING A SMART SEARCH The Smart Search uses the specification that you choose in the channel settings Search window to determine what to highlight on the waveform display The search can be made up of up to 32 consecutive Even
158. ine is defined using the following syntax and contains no spaces FieldName InputModifiers value OutputModifiers FieldName is the name of the field No spaces commas semicolons brackets dollar signs periods or quotes are allowed in the fieldname Input and output modifiers change the way incoming data and output data are formatted InputModifiers are a string of characters that represent how many bits are in the field and how the input data is to be handled First is the number of bits in the field or N if the field is a variable length Next is any of the following 142 USBee QX User s Manual M native bit order from that which came off of the bus default L inverted bit order from that which came off of the bus B invert the Byte order of this multibyte field X or Y which channel the data is on for multiline busses Value Indicates that this field MUST be this value for the entire line to be processed Conditional Each modifier is a single character and multiple format modifiers can be combined There can only be one Variable length field using the N input modifier for each channel x or y for any given packet Example input modifiers are as follows 8 8 bits 8L 8 bits Isb first 8X 8 bits from channel X 8Y 8 bits from the Y channel 8 47h 8 bits that must equal 47 hex If they do not then this line is ignored N all bits of the packet on channel X not used by other fields N
159. is a left and right pan button on the left side of the screen Simply press these buttons to page to the next or previous bus transactions r T BE USBee Suite Pro USBee DX Connected C cwav USBee Test Files DXDemo usbeecomp ks oe File View Speed and Samples Trigger Setup Help lt i E pS m aiin ai o gt gt 200us div 151 833us 351 833us 551 833us 751 833us 951 833us 1 151833ms 1 351833ms 1 551833ms Digitaro Digitar T Digitar 2 Digitar3 SP12 C0 EDEDED tat oc Digitara Digital s EE EDLC AE CEN Digitare Digitar7 Async 6 58 59 E BOM iE Ri a Cufors Capture Oncel Capture Many Measurements I Oscilloscope T Xi X2 dX i dX Period Frequency Duty Cycle Ons Ons Ons Ons infinity Ons infinity i Inc All Rights Reserved Dasignes and Manufactures only in the USA 110 USBee QX User s Manual SAMPLE AND SMART MARKERS Placing markers in your traces can help detail what is happening in your design There are two types of markers that can be used The first marker type locks itself to a sample on a waveform and lets you specify the text The second is a Smart Marker that automatically measures the pulse width frequency period or duty cycle of the waveform at the marker location D UU U J p s Smart Marker Automatic Measurement 8 667us SAMPLE MARKERS Click to Edit Text Markers that are locked to a specific sample a
160. it INVERTING DECODER This Add In inverts the packet data out Not in CWAV_EXPORT unsigned int CWAV_API APIDecode char Protocol char bitIn char bitsOut char reset if bitIn bitsOut 0 else bitsOut 1 return 1 Indicates that there is 1 return data bit EXPANDING DECODER This Add In shows how to convert a stream to a larger stream expanding the bits In this case each bit becomes two output bits CWAV EXPORT unsigned int CWAV API APIDecode char Protocol char bitin char bitsout char reset bitsOutt bitin bitsOutt bitin return 2 Indicates that there is 2 return data bits USBee QX User s Manual 149 COMPRESSING DECODER This Add In shows how to remove bits from a stream compressing the bits In this case each bit pair becomes a single bit basically throwing away the first bit CWAV_EXPORT unsigned int CWAV_API APIDecode char Protocol char bitIn char bitsOut char reset static everyother 0 if reset Reset the state of the decoder if reset TRUE everyother 0 if everyother bitsOut bitin return 1 Indicates that there is 1 return data bit everyother 0 else everyother 1 return 0 Indicates that there are no return data bits 150 USBee QX User s Manual MULTIPLE DECODERS This Add In shows how to use the Protocol string to selectively decode different types of packets CWAV_EXPORT unsigned
161. iv 10 084833ms Search Digitaro Digital 1 Digital 2 Digital 3 SPI2 Digital 4 Digital 5 2C5 Digital 6 Digital7 K thk k h k k Async 6 Cursors USBee Capture Once Capture Many Lagic Analyzer Oscilloscope 106 Ct Channel Settings Single Signal us f so Y c Fase Yt wire ps 2 mus os cn se poa com s Al Event 1 If CH1 voltage is not between 1 1V and 4 3V Ef Digital Signal Digital 1 has ising E If Analog Signal CH1 has rising eshold 2 Volts happens 1 times voltage thr m while ga a anc 7 anc F KOAX OOO OOIX BERG 0 and E Bus Digital 2 decoded data is between Digital Signal States ere F AOAO FECES x MOMA 0 to CH1 z is not z 11 Voltsto 4 3 Volts S Analog Signal and us event Followed By lt Event 2 Followed By lt Event 3 Followed By lt Event 4 Followed By lt Event 5 Followed By lt Event 6 s below Use PacketPresenter Definition File name USBee QX User s Manual TIME WINDOW QUALIFIER The final line of each Event specifies a time window for the event to occur There are two selections to specify a time window immediately or anytime For the first Event only anytime is available This specifies a time period in which the entire event must occur for a match to
162. king place These bus events are inserted into the data stream and can be used or ignored by the protocol processors The list of Bus Events supported is in the following table Bus Type Event Async 1 Parity Error I2C 1 Start Bit 2 Stop Bit 4 ACK 8 NACK SPI 1 SS Active 2 SS Inactive Note You MUST have SS On in the channels settings for these events to occur USB 1 SETUP IN OUT Received 2 ACK NACK Stall Received 4 No Handshake received CAN 1 Start of CAN packet 2 End Of CAN packet 1 Wire 1 Reset Found 2 Presence Found Parallel Serial PS 2 1 Device to Host byte follows 2 Host to device byte follows 12S 1 WordSelect Active 2 WordSelect InActive SMBus 1 Start Bit 2 Stop Bit 134 USBee QX User s Manual SDIO 1 Start of Packet 2 End of Packet 3 APP CMD packet 4 R1 response packet 5 R2 response packet 6 R3 response packet 7 R6 response packet 8 Data Packet 9 R4 response packet 0 R5 response packet A Bus Event of 127 7Fh is a special event that occurs at the end of a packet of data that is sent from one protocol to another This can be used to end the packet sent to the new layer using the END section and the type event in the new protocol level USBee QX User s Manual 135 DATA CHANNELS AND MULTIPLE DATA SIGNALS Some buses can also have more than one data signal used in the protocol One example of this is the SPI b
163. lculate the width period frequency and duty cycle of the waveform under the cursor 1 5852292mM5 1 985229 2mM5 f fo FF FF FF FF FFI F GP AF A Measurements T Xl Ke Period Frequency Duty Cycle Ons L566833ms 27 170375ms 601 542us 34 708us 28 811575kHz 251 FULLY CONFIGURABLE LOOK AND FEEL View your signals like you like them Want to add decoded bus traffic to the waveforms Done Want to delete waves from the screen Done Want to reorder waveforms for easier readability Done Want to resize the screen for easier reading or more data per screen Done And you like Magenta Well you can change cursor colors to suite your desires Waveform backgrounds can also be customized and you can even give the entire application that cool Glassy look that Vista has made so popular Then again if you like simple white and black are also available It s good that white ink cartridges are free 20 USBee QX User s Manual 1 USBee Suite Pro USBee RX Connected C cwav USBee Test Files ProtocolSetup usbeerx Use j OK Lams 900us Digitaro Digital 1 gita 2 gitar SPI2 Digitars 2C5 Digitare Digitar7 Async 6 D el USBee QX Suite showing SPI 12C and Async decoding SERIAL BUS ANALYSIS USBee QX Suite has decoding support for your favorite serial busses such as 12C SPI and Async Bus traffic is decoded in line with the waveforms and can be displayed on top of underneath or instead of the voltag
164. le DLL project in Microsoft VC6 format in the installation directory of the USBee QX software called Addin that allows you to customize a decoder for your data streams The DLL library called usbeeai dll USBee Add In has the following interface routine that is called by the PacketPresenter if the ADDIN keyword is used in the DECODE section of the PacketPresenter Definition File CWAV EXPORT unsigned int CWAV API APIDecode char Protocol char bitin char amp bitOut char reset This routine is called for each bit of data in the data stream Protocol is the string name of the Protocol being processed and allows you to create an add in that handles many different kinds of decoding The parameter reset is set to a 1 for the first bit of a packet and O for all bits following The next bit from the stream is passed in using the parameter bitin 1 or 0 After your code decodes the stream you can either send back no data return value of 0 or send new bits back using the bitOut pointer one bit per char and a return value of the number of bits returned The default Add In routine simply is a pass through so that the output data stream equals the input data stream Start with this library source code to add your custom decoding 148 USBee QX User s Manual SAMPLE PACKETPRESENTER ADD IN DECODERS Custom decoders can perform complicated decryption and byte or bit manipulation Ignoring the actual algorithm that is e
165. lines CH1 CH2 CH3 CH4 to any voltage other than between 60 and 60 Volts The USBee QX actively drives Pod signals AOUT and 16 through 21 and T and C Make sure that these pod test leads are either unconnected or connected to signals that are not also driving There is a current limiting series resistor 680 ohm in each of these lines in case of short Plug in the USBee QX Pod into a powered PC BEFORE connecting the leads to your design USBee QX User s Manual 15 PC SYSTEM REQUIREMENTS The USBee QX Test Pod requires the following minimum PC features e Windows XP Vista 7 or 8 32 bit or 64 bit operating system e MAC OSX running VFusion or Parallels with one of the above e Pentium or higher processor e One USB 3 0 Super Speed or USB2 0 High Speed enabled port It will not run on USB 1 1 Full Speed ports 32MBytes of RAM e 125MBytes of Hard disk space e Internet Access for software updates and technical support e 802 11 B G Wireless network for WiFi operation EACH PACKAGE INCLUDES The USBee QX contains the following in each package e USBee QX Test Pod e 4 100M oscilloscope probes with x1 and x10 selection e One 8 lead 9 inch signal generator cable set e Two 8 lead 9 inch logic analyzer cable sets e One 2 lead Ground cable set e 3 lead 9 inch analog cable set e 24 high performance micro grabber test clips e 6 foot USB cable e Power supply adapter USBee QX Suite Software downloaded USBee QX S
166. ling edge is in the right timeframe tPulseWidth tEdge1 Sample SamplingRate If tPulseWidth gt 0 0005 And tPulseWidth lt 0 0007 Then Good start of a bit Now look for the rising edge tEdge2 FindNextEdge tEdge1 SignalMask 1 If tEdge2 gt Then Check to see if this rising edge is in the right timeframe for a logic 9 tPulseWidth tEdge2 tEdge1 SamplingRate If tPulseWidth gt 0 0004 And tPulseWidth lt 0 6 Then Great Valid Bit Format Write out a Bit Marker remove this if you don t need the bit WriteEntry BW CUInt Sample CUInt tEdge2 e Add this bit to the accumulators LSB first ByteAccumlator ByteAccumlator gt gt 1 Shift the Accumulator ByteAccumlator ByteAccumlator And amp H7F Clear out the MSBit Mark the start of the byte if so If BitCounter Then ByteStartSample Sample Next Bit next time BitCounter BitCounter 1 Sample tEdge2 Continue For ElseIf tPulseWidth gt 0 001 And tPulseWidth lt 0 002 Then Great Valid 1 Bit Format Write out a Bit Marker remove this if you don t need the bit WriteEntry BW CUInt Sample CUInt tEdge2 1 Add this bit to the accumulators LSB first ByteAccumlator ByteAccumlator gt gt 1 Shift the Accumulator ByteAccumlator ByteAccumlator Or amp H8 Set the MSBit Mark the start of the byte if so If BitCounter Then ByteStartSample Sample USBee QX User s Manu
167. ls you use the section of the USBee QX Control Panel as seen below a L 1000 50 1000 50 1000 50 1000 50 1000 50 1000 50 1000 50 1000 50 a a a a a a e SigGe A E EC JEK J E E EWE A EE E O E E E A EE E E E E O A E JEC J A E E G Each of the 8 digital lines can have one of 6 different modes by selecting the associated radio button above e The signal line is sampled as an input e The output of the Arbitrary Digital Signal Generator e Pulse Width Modulator e Logic High Level e Logic Low Level e Trigger Out signal The Logic Low level outputs OV on the signal The Logic High level outputs 3 3V on the signal The Trigger Out level outputs OV before the trigger event and 3 3V after the trigger event This can be used to trigger other equipment to synchronize the captures of data PULSE WIDTH MODULATORS Each digital output channel can be configured as a Pulse Width Modulator You specify the frequency in Hz O to 390000 desired as well as the duty cycle in percent 0 to 100 of the waveform The following shows two examples of a PWM signal with different duty cycles USBee QX User s Manual 171 6 USBee Suite Pro USBee RX Connected C cwav USBee Test Files ProtocolSetup usbeerx lt x File View Speed and Samples Trigger Setup Help A USBee RX Control Pane a Semple Cockis 2400000 sps Sample Cock is etemal on C inout 338 78us Digital 0 Digitar e ee nga 3
168. me is below Logic Analyzer Oscilloscope T USBee QX User s Manual 101 BUS DATA The next line lets you find values of decoded bus data if your waveform display includes them You can specify specific values to find values to exclude or ranges of values First select the decoded bus channel you want to search using the first dropdown box Then choose if you want to find values between equals or not between not equals the value s that follow Next enter the actual value of decoded data you are interested in If it is a single value leave the second field blank If you are interested in a range of values specify the end of the range in the second field Below shows a search that finds all decoded data that equals a fixed value of 16 z a D File View Speed and Samples Trigger Setup Help m gt j 300us div 14 2805ms Search as Dijao Digital 1 Digital 2 Digital 3 SPI2 Digital 4 Digital 5 2C5 Digital 6 Digital 7 mn h tk te te ee Async 6 x USBee Logic Analyzer Oscilloscope a6 25 FF Ga Ga Bite ey Digital 6 Digital 7 Cursors Capture Once Capture Many Measu T Xi Ons Ons 102 a r i a a som Tho a N Al Event i If Digital 2 decoded bus data is 16 If Digital Signal Uigital 1 while V Bus Digital2 decoded data is between v 16 and and Digital Signal States are F KEE B
169. mp Cooctnrn THorscos EHULOOCONTOOWMHOS ERVRSSARSSHSSASS ee 2ssssaasssass3 wR NeoOTHTOGR os qi Susoeaanantteoou BRBLSSAASSRSSRS p SSBLSSRINASSSS Sssesssunsessss net Tr entre mass DSOSOSNTH ANEO MA S2USLSSRASRSIZE maseseunezessn Sbeseseszasseszs SLASSSSARRSASS RSALSISSYSSSSLO SRSRSSSASSSAgS Qwoortorooraowon 8 zaocoooowouomoongo Seetchaeersiaeisce DNGONDHALOCOCBDNEO SERSLRSRSSLSHSe SSISSSRISSRROSeS eenesesnussesngs ROnGADSHoouLon RROSSSRBASE RRS SAtoeSSeon nang Packet 38 Tame 126nsj04 2 ote 233313223490 LOMODOOTOrG 0uWmNm inno O O W DND O OMM 32533373832238 ESSSSSCSSASSEAVS w DasaSnwetsagne geeenursazesens OwMmADTaonwouw m b SROSLISSSSISSRE eUSVEnssssessys eSsngasssrzssse SRSSESSnssasss 2 S8RRtSn2SESS BSRORASEALSSS3 SSsetogomtonss LOOOENTOONSOOS NOGHaTMNAN TT Oe ts geseessresesd tSSRERIessissss eggeeeanasessss F FF FFF f a Loonen Tori i A DN D w AN O i D N OO DAO u nDO mM ANA A T a T ESRSSSRSRESESSa oo ESILLRSSIsage5 SSstseanssasss P2essrsengascass SSSSESasnssases YSSSESVSGsessss SeSSesssnaassas Senszeersuar mag OONN ALO an ov lt SASS SnSsersssce SCRE DELTE REIA SSseesygsens a3 SAOTVVLTCOVVIIH TIS eteemmIaas Suva ooeo nn w RAgsge w ANONkoOnRG m on SRSSRSRSSSNGFS OHO satTeentn ana S o ow O S m o 232228232 awn Ate MDOH i et 09 Ons Width USBee QX User s Manual 72 SM BUS B
170. mple As Int64 Dim GX1Sample As Int64 Dim GX2Sample As Int64 Public Sub SetCaptureParameters ByVal TriggerSample As Int64 ByVal X1Sample As Int64 ByVal X2Sample As Int64 This routine is called right at the end of a capture to pass the positions of the Trigger and X1 and X2 Cursors to the custom decoding process GTriggerSample TriggerSample GX1Sample X1Sample GX2Sample X2Sample End Sub Public Sub DecodeCustom ByVal OutFilename As String ByVal NumberOfSamples As Int64 ByVal SamplingRate As Integer ByVal Parameters As String ByVal PPInFilename As String ByVal PPOutFilename As String ByRef PPError As Byte Dim OldSample As UInteger Dim PPOn As Boolean False Determine if there is a PacketPresenter definition file associated with this waveline If so initialize the PacketPresenter system to output the packet information to the output file If PPInFilename lt gt Then Dim retval InitializePacketPresenter PPInFilename PPOutFilename PPError If PPError lt gt Then Exit Sub End If PPOn True Else PPOn False End If Try This is a custom bus decoder Processing Routine The passed in variables are as follows OutFilename the file that all of the decoded Entries get written to This is the file that the USBee Suite 4 will read to display the data on the waveline ActualNumberOfSamples How many samples are in the sample buffer SamplingRate The rate that the samples were taken in sps 2
171. must be set at 10x o 60 60V probe switch must be set at 10x e DCCoupled sets the coupling for that channel O AC coupled 1 DC coupled Return Value 1 Successful e O Failure _POWERONANALOGQX TURNING ON POWER TO THE ANALOG CHANNELS This routine turns on the power to all of the analog channels This uses the maximum current of the device so turn off the Analog Channel power when not in use to reduce power consumption and heat Calling Convention CWAV_IMPORT unsigned long CWAV_API PowerOnAnalogQx Return Value e 1 Successful e O Failure _POWEROFFANALOGQX TURNING OFF POWER TO THE ANALOG CHANNELS This routine turns off the power to all of the analog channels The Analog channels uses the maximum current of the device so turn off the Analog Channel power when not in use to reduce power consumption and heat USBee QX User s Manual 185 Calling Convention CWAV_IMPORT unsigned long CWAV_API PowerOffAnalogQx Return Value e 1 Successful 0 Failure ANALOGLIVEVOLTAGE READING THE VOLTAGE ON THE ANALOG CHANNELS This routine reads the voltage on an analog channel Calling Convention CWAV_IMPORT float CWAV_API AnalogLiveVoltage unsigned long channel channel is which analog channel 1 CH1 2 CH2 3 CH3 4 CH4 READING AND SETTING SIGNAL STATES SETSIGNALSQX SETTING THE USBEE QX OUTPUT SIGNALS This routine sets the digital output state of the 8 d
172. n 2097093 Sample 166 Digital BAVS6H39 CH1 8 88 CH2 6 18 CHS 8 85 CH4 8 65 sample 206 Digital BH7 7HB3D CH1 H 88 CH2 6 11 CH3 8 18 CH4 8 13 Sample 366 Digital BAVBRRS9 CH1 8 83 CH2 8 18 CH3 8 89 CH4 8 12 Sample 466 Digital BAVFRBID CH1i 8 82 CH2 6 11 CHS 8 186 CH4 8 11 Sample SAH Digital BAZFARSD CH1 8 8H CH2 8 11 CH3 8 11 CH4 8 12 Sanple 604 Digital 68030001 CHi 80 CH2 18 CH3 0 10 CH4 14 USBee QX User s Manual 205 File USBeeQXToolbulderiInC cpp USBeeQXToolbuilderInC cpp ti include stdafx h include conio h include windows h Defines the entry point for the console application define CWAV_API _ stdcall define CWAV_EXPORT __declspec dllexport define CWAV_IMPORT __declspec dllimport CWAV_IMPORT CWAV_IMPORT CWAV_IMPORT CWAV_IMPORT CWAV_IMPORT CWAV_IMPORT CWAV_IMPORT CWAV_IMPORT CWAV_IMPORT CWAV_IMPORT CWAV_IMPORT CWAV_IMPORT CWAV_IMPORT CWAV_IMPORT CWAV_IMPORT CWAV_IMPORT CWAV_IMPORT CWAV_IMPORT CWAV_IMPORT CWAV_IMPORT CWAV_IMPORT CWAV_IMPORT 206 unsigned unsigned unsigned unsigned long CWAV_API InitializeQXx void long CWAV_API SetSignalsQxX unsigned long mask unsigned long value long CWAV_API SetAnalogChannelSettings unsigned long channel unsigned long DCCoupled long CWAV_API SetLogicThresholdQx float Thresh 3 float range 3 float CWAV_API AnalogLiveVoltage unsigned long
173. n E A E a devaneadinnetees 197 Decode Paralle koninin NN N 198 DECOCSSE Lal Sian seasecacus sacs bavas S A AARAA NA 199 DISCOS YING vorra I O 200 DECOGSSEUIN ANTE aaae e a a a A 201 Digital Pattern Generator Functions cccseccccssescccsessccsaesecesansccsaeescssaussessaes 201 GenerateP WM Wave6lormOX Aistien A 201 LoadDigitalWaveformQX sical visasidcdvacdicendwpeviatde dione teeny eavnidedvnad deedorevadadoasd Getigedvddaduncd donates 202 Generate DigitalWavetormoOX oink sidvitedeee Bie ie ie ek ais 202 Frequency and Pulse Counter FUNCTIONS ccccecccseseecseccceececesecceseceenecseesesees 203 CIE ARCOWUMTS ON saci tat aeictoeincaceieatea anata NO 203 Ela le COUNES OX cocaina er E E N om Gute eM ce Ree 203 DISADISCOUMUS OK sirna anen E T EE AE E E A 204 GetFreguencyAndCouNtSAN cosuri E A E E Eia 204 EXAMPLE C CODE soaren S eera E EE E E E ES 205 USBEE OX SUITE PRO MODULE iisissesssacanvercecauvescedanvenvanesweesoseudensecyevesseteuvessuass 211 10 USBee QX User s Manual REGISTERING THE MODULE ssiasvcacceiwacu a a a a a a a a aad 211 SPECTRUM ANALYZER sanra a a a a a a a a Ta 212 PROTOCOL FIELD GRAPHING riiiinarrererin iann a eari 213 USBEE QX STREAMING MODULE cccccccccccccccccccccccccccccccccccccccccecccccccs 215 STREAMING BANDWIDTH einu A ATTE rece 215 REGISTERING THE MODUE a a a 216 USING DISK STREAMING assessors sats catencvenstaganceeeaamntestabientenaeusantenues amen arani 216 VIEWING THE DISK STREAM Sxesed
174. n external clock using the C input to gather each sample instead of the internal sample clock To turn on External Clocking select External Clocking using the C Input on the Speed and Samples menu The external clock can run up to 1OOMHz When external Clocking is enabled Sample Compression is not available 48 USBee QX User s Manual SETTING SIMPLE TRIGGERS The USBee QX Suite uses a Trigger mechanism to allow you to capture just the data that you want to see For a Digital trigger you can specify the digital states for any of the digital signals that must be present on the digital lines before it will trigger Below shows the trigger settings to the right of the Signal labels This example shows that we want to trigger on a falling edge of Signal O which is represented by a high level followed by a low level To change the level of any of the trigger settings just click the level button to change from don t care to rising edge to falling edge BE USBee Suite USBee DX Connected File View SpeedandSamples Trigger Setup Help lt Digital 0 Digital I Digital 2 x Digital 3 x Digital 4 s a Digital 5 Digital 6 tr x Digital 7 Analog U S Bee SOTE a T Logic Analyzer Oscilloscope T Xi X2 dX i dX Period Frequency Duty Cycle ae Ons Ons Ons Ons infinity Ons infinity The waveforms are shown with a trigger position which represents where the trigger occurred This sample p
175. n of the error to present to the user _DECODEASYNC This routine decodes bus traffic and outputs the data to an output file This routine works ona sample buffer captured using the StartCapture routine Calling Convention CWAV_IMPORT int CWAV_API DecodeASYNC unsigned __int64 reserved1 unsigned char OutFilename unsigned char OutTxFilename unsigned char OutRxFilename __int64 StartSample __int64 EndSample long Rate unsigned long TxChannel unsigned long RxChannel unsigned long BaudRate unsigned long Parity unsigned long DataBits unsigned long Invert unsigned long delimiter unsigned long hex unsigned long ascii long BytesPerLine char ProtocolDefinitionFilename char ProtocolOutputFilename char ErrorString e OutFilename pointer to the filename string to write the decoded data to e StartSample the index of the first sample to start decoding e EndSample the index of the last sample to decode e Rate is the rate at which samples were taken during StartCapture 69 600 Msps O 39 300 Msps O 29 200 Msps O 108 100 Msps O 58 50 Msps O 28 20 Msps O 107 10 Msps O 57 5 Msps 200 USBee QX User s Manual O 27 2Msps O 106 1 Msps O 56 500ksps O 26 200ksps O 105 100ksps e TX and RX Channels Bit mask which represents which signal to decode Bit O is Pod signal 0 Bit 15 is pod signal F e BaudRate Baud Rate in bits per second 19 2K 19200 Parity 0 No parity 1 Mark 2 Sp
176. n the left of the waveform The following figures show a trace captured on each of the edges USBee Suite Pro USBee DX Connected Fie View SpeedandSsmples Trigger Setup Hep Analog Trigger Slope Rising Edge Analog Trigger Slope Falling Edge The Trigger position is placed where the actual signal crosses the trigger voltage with the proper slope The USBee pods allow for huge sample buffers which means that you can capture much more data than can be shown on a single screen Therefore you can scroll the waveform back and forth on the display to see what happened before or after the trigger SETTING COMPLEX TRIGGERS The USBee QX Suite also allows you to set more complex triggers using the Triggers Dialog box as shown below 50 USBee QX User s Manual There are two levels of triggers available X and Y Each trigger event X or Y can have any combination of analog or digital edges which can be qualified using digital patterns or analog voltage levels USBee QX User s Manual 51 CAPTURING WAVEFORM DATA Press the Capture buttons to start capturing the waveform data from your hardware design If you are running in Demo mode the button reads Demo Capture Once performs a single capture while Capture Many repeatedly captures and displays consecutive traces Pee m Trigger Settings Each capture will look for the trigger condition fill the buffer with samples of the signals and stop If
177. nd Opening large buffer sizes can take a while to perform the compression and saving but can greatly reduce disk space OPEN AND EXISTING CAPTURE FILE To view a previously saved capture file us the File Open menu item This will load the trace data and screen format including decoder setup Opening files with large buffer sizes can take a while to decompress and display RECENTLY USED FILE LIST The USBee QX Suite maintains a recently used file list that allows you to quickly load any of the last 5 previously used files Simply click on the file name in the File Recently Used file list to open it EXPORTING CAPTURED DATA TO A FILE Since the compressed trace files are not in easily useable format you can use the File Export menu items to save the trace and decoded data into formats that are easy to use 78 USBee QX User s Manual BB UsBee Suite USBee DX Connect File New Open Save Capture Export Print Save USBee Suite Screenshot Save Screenshot Section Exit al Capture A ERMENE 2 s T dX 1 dX Ons 34 581333ms 34 581333ms Ons infinity e gt ed 9 329167ms 9 729167ms 10 129167ms gnal data to Binary File All gnal data to Binary File X1 to X2 gnal data to Binary File Screen gnal data to Text CSV File All gnal data to Text CSV File X1 to X2 gnal data to Text CSV File Screen Bus data to Text CSV File All Bus data to Text CSV File X1 to X2 Bus data to Text CSV File Screen
178. nes 171 ARBITRARY DIGITAL PATTERN GENERATOR ccsscescceccecceccscesceeccecssceeeceeceeceeceseeeeeaees 173 Specifying the Pattern With a CSV File scccccccsseseecccssssscccecassecessaseecssaaens 173 Sample CLOCKING acct sarc a E E EO OTA 174 Waveform Generation CONE iisiciscssiees cesaissedhe suasakicusanssn vanatiaivdiosesasauhoanedeae 174 USBEE QX EDGE PULSE COUNTERS cccssccossssccsssccnsssccesscccessecesssecesseeececs 176 WSBEE QX FREQUENCY COUNTERS se sesesesescesescscesescscesescscesescscesescscesesoscese 177 USBEE OX WIFI MODE sisi cisctssssectcnsnstscstascnctcansbacstssanctasiwsbeasiostendicsssbaactosteasets 178 WIFI IVIOGC SetuP i cicraiapesdescasecoskteutaatnen Ree aaag ida can vbecaiaaeati peewee aaa 178 AUTOMATION inienn a AEA 180 USBEE OX TOOLBUILDER scrissi saariin naa a a aaa 182 OVERVEIE E cansuasieeieunecen needy aga tue anunercaeaiaiarennieutesntets 182 System Software ArcMtect TE er EE T ees ou eeCe al eeu astone 182 INSTALLING THE USBEE QX TOOLBUILDER winssc sstvinscessevenasstesbadsncesscqaadsetedesievicens vassue 183 USBee OX TOOIDUIGEr Projects ironinen ean AAT EO 183 USBEE QX TOOLBUILDER FUNCTIONS sis senqsosncaceudytenatounnidoueascanstounniacnedssesgenadeubnces 184 USBee QX User s Manual 9 Initializing the USBCC OX POO iriiri Ea rA EE EA 184 HEPA ZOO X TA NNA N NN AIN T 184 SetLogicThresholdQX Setting the Digital Logic Threshold cccsseceeeesseeeeees 184 SetANALOGChannel
179. ns the trigger event referenced from the beginning of the samples Return Value 1 End successful e O Trigger Failed SAMPLEDIGITALDATA This routine returns the digital signals of a particular sample Calling Convention CWAV_IMPORT unsigned long CWAV_API SampleDigitalData __int64 index e Index sample number to return Return Value Value of all of the channels of the given sample The low 3 bytes contain the 24 digital channels 0 thru 21 and T and C ANALOGSAMPLEVOLTAGE This routine returns the analog voltage of a particular sample Calling Convention CWAV_IMPORT float CWAV_API AnalogSampleVoltage unsigned long channel __int64 index e Channel which analog channel to return 1 2 3 or 4 e Index sample number to return 190 USBee QX User s Manual Return Value The voltage at that sample in Volts _FINDNEXTEDGE This routine scans through the sample buffer and finds the next edge on a given channel This routine should be used in the cases of compressed data instead of individual SampleDigitalData calls Calling Convention CWAV_IMPORT __int64 CWAV_API FindNextEdge __int64 UCSample unsigned long long channelmask unsigned long direction UCSample is the sample number at which to start looking for an edge Channelmask is which channels to look for an edge on A 1 in a bit position specifies to use that channel Bit O digital channel O Bit 15 digital channel 15 Direction spec
180. o Mode bakais File View SpeedandSamples Trigger Setup Help 400us div _ 1 916125ms 1 216125ms 816 125us 416 125us 4 0 001983625 I2C 5 SCL OB 82 083us 12C 5 SCL ACK J 48 042us I2C 5 SCL S Start cey 15 75us 2C 5 SCL A3 Read f 82 042us 1205 S 51 167us 122C5 SCL 22 82 042us I2C 5 SCL NACK 59 875us I2C 5 SCL P Stop 160 292us Async 0 TX OB 95 375us Async O TX OC 98 042us Async 0 RX OD al est GaN en ee Oe i 4 nite Aa 95 333us Async O RX OF 95 375us Async O RX 10 95 375us AsyncO RX 11 ten 210us SPI2 MISO FF 0B 0c Ons SPI2 MOSI 94 Ne a 90us SPI2 MISO FF ca Scat tel ca ee Ons SPI2 MOSI 54 225 083us SPI2 MISO E8 Ons SPI MOSI FF 91 042us SPI2 MISO 58 PL MOSI FF CMI ncn pa i Ma Li x x x x x x x tk k Demo Capture Many A Measurements USBee Logic Analyzer Oscilloscope F XE X2 dX 1 dX Period Frequency Duty Cy gt AAS EA Ons 1 581625ms 1 895708ms 314 083us 3 183868kHz 10 875us 91 954023kHz 90 2 Absolute Timestamps display the sample time for each decoded bus transaction relative to the trigger location You can turn on Absolute Timestamps using the menu item View Decoder Timestamps Absolute 17596417 SPI 2 MISO 4A 17596417 SPI 2 MOSI FF 17688458 SPI 2 MISO AA 17688458 SPI 2 MOSI FF 17802750 I2C 5 SCL S Start 17818458 12C 5 SCL A2 Write 17900542 12C 5 SCL ACK 17933167
181. oint is marked on the waveform display with a Vertical red cursor line and a T in the horizontal cursors bar You can use the Trigger Position menu setting to specify how much of the data that is in the sample buffer comes before the actual trigger position If you place the Trigger Position all the way to the left most of the samples taken will be after the trigger sample If you place Trigger Position all the way to the right most of the samples taken will be before the Trigger sample This control lets you see what actually happened way before or way after the trigger occurred Trigger Position to the Right Trigger Position to the Left USBee QX User s Manual 49 For an Analog trigger you must specify the Channel to use Rising or Falling Edge and the Trigger Level Click on the Trigger Settings Box to the right of the waveline delete X repeatedly to toggle through Channel 1 Rising Channel 1 Falling Channel 2 Rising Channel 2 Falling etc and None You then specify the trigger voltage level 6V to 6V by using the vertical slider on the left hand side of the analog waveform display The trigger level edge and value will be shown as you scroll this level underneath the Volts Div and Secs Div labels within the waveform area For an analog trigger the trigger position is where the waveform crossed the Trigger Voltage level that you have set at the specified slope To move the trigger voltage level just move the slider o
182. ollowing License Agreement is a legal agreement between you either an individual or entity the end user and CWAV Inc makers of the USBee Test Pods and USBee QX Suite software You have received or downloaded the USBee QX Suite Package Software which consists of the USBee QX Suite Software and Documentation If you do not agree to the terms of the agreement do not install and run this software By installing this USBee QX Suite software you agree to be bound by the terms of this Agreement Grant of License CWAV provides royalty free Software both in the USBee Package and on line at www usbee com for use with the USBee Test Pods and grants you license to use this Software under the following conditions a You may use the USBee Software only in conjunction with a USBee Test Pod or in demonstration mode with no USBee Pod connected b You may not use this Software in conjunction with any pod providing similar functionality made by other than CWAV Inc and c You may not sell rent transfer or lease the Software to another party Copyright No part of the USBee Package including but not limited to Software manuals labels USBee Pod or accompanying diskettes may be reproduced stored in a retrieval system or transcribed in any form or by any means electronic mechanical photocopying recording or otherwise without the prior written permission of CWAV Inc with the sole exception of making backup copies of the Software for rest
183. oming Data Stream that is broken into Packets parsed into Fields and either displayed as a field on the screen ignored and or sent to a new Protocol for further processing as in an N layer protocol Each Protocol Processor defines how to break the stream into Packets and how to break the Packets into Fields These Fields can then be displayed or sent to another Data Stream for further processing 124 USBee QX User s Manual Below shows a sample PacketPr esenter output screen USBee Suite Pro USBee RX Demo Mode C Program Files x86 CWAV Inc USBee R File View SpeedandSamples Trigger Setup Help v USBee RX Control Panel f o Digitar 0 PacketPresenter File Layer SPI 2 Packet 1 Time 1 7 Layer SPI 2 Packet 2 Time l Layer SPI 2 Packet 3 Time 1l Packet 4 Time 788us 400us divous Cursors Edit MOSIDATA MISODATA MOSIDATA MISODATA PILP Pe RESS SLAVEADDRESS Layer ASYNC 6 Packet 5 Time 9ns 19 Layer SPI 2 Packet 6 Time 728us Layer SPI 2 Packet 7 Time 1 Layer SPI 2 Packet 8 Time Packet 9 Time l Layer ASYNC_ 1A 1B 1C 1D 1E 1F MOSIDATA MISODATA MOSIDATA MISODATA MOSIDATA MISODATA PPR SLAVEADDRESS RW ADDRESS SLAVEADDRESS RW DATA Lt Ne Psi durite o0 19 30 USBee RX Suite Logic Analyzer Oscilloscope Copyright 2012 CWA Inc All Rights Reserved sa Desaned and Manufactured only in the USA US Patent 7 911 970 and other
184. oration purposes on your own machine You may not reverse engineer decompile disassemble merge or alter the USBee Software or USBee Pod in any way Limited Warranty The USBee Software and related contents are provided as is without warranty of any kind either expressed or implied including but not limited to the implied warranties of merchantability and fitness for a particular purpose with the sole exception of manufacturing failures in the USBee Pod or diskettes CWAV warrants the USBee Pod and physical diskettes to be free from defects in materials and workmanship for a period of 12 twelve months from the purchase date If during this period a defect in the above should occur the defective item may be returned to the place of purchase for a replacement After this period a nominal fee will be charged for replacement parts You may however return the entire USBee Package within 30 days from the date of purchase for any reason for a full refund as long as the contents are in the same condition as when shipped to you Damaged or incomplete USBee Packages will not be refunded Software Updates The information in the Software and Documentation is subject to change without notice and except for the warranty does not represent a commitment on the part of CWAV CWAV cannot be held liable for any mistakes in these items and reserves the right to make changes to the product in order to make improvements at any time The Software will change f
185. ore calling any other USBee QX functions Calling Convention CWAV_IMPORT unsigned long CWAV_API InitializeQXx void Return Value 0 Pod Not Found 1 Pod Initialized _SETLOGICTHRESHOLDQX SETTING THE DIGITAL LOGIC THRESHOLD This routine sets the digital logic threshold for all of the digital inputs Calling Convention CWAV_IMPORT unsigned long CWAV_API SetLogicThresholdQx float Thresh where Thresh is the voltage threshold from 1 0 to 2 0 Digital inputs below this threshold will be interpreted as a logic O and voltages above this threshold will be interpreted as a logic 1 Return Value 1 Successful O Failure SETANALOGCHANNELSETTINGS SETTING THE ANALOG CHANNELS This routine sets the analog channel input settings 184 USBee QX User s Manual Calling Convention CWAV_IMPORT unsigned long CWAV_API SetAnalogChannelSettings unsigned long channel float range unsigned long DCCoupled channel is which analog channel 1 CH1 2 CH2 3 CH3 4 CH4 e range is the input measured range Using the smallest range for your input signal gives the highest resolution measurements 0 75 0 75V probe switch must be set at 1x O 1 5 1 5V probe switch must be set at 1x O 3 3V probe switch must be set at 1x o 6 6V probe switch must be set at 1x O 7 5 7 5V probe switch must be set at 10x O 15 15V probe switch must be set at 10x o 30 30V probe switch
186. patents pending gt ea a USBee QX User s Manual i Trigger Settings 125 SETTING UP THE PACKETPRESENTER Each digital waveform on the screen can be defined as a different bus 12C SPI etc in the Channel settings dialog box by clicking on the white box to the left of the signal name Below shows the Channel Settings dialog box ps2 smeus s can seia Parallel Custom Single Signal uss sm c Asme 1 Wire f Signal Selection Clock OOOGOOCOOCOOO00OOCO MOSI Data OOOOGOGCOOOOOOOC MISO Data OOOO O OOOO Rising D Falling Rising Enable On Active Low Falling Enable Off Active High is a r MOSI Samples E Samples gt gt Use Enable Enable Active Bits Per Word Use PacketPresenter Definition File name is below Browse Edit CAcwav USBee Test Files SPI CYRFIC PPD txt All busses will use a default PacketPresenter internal file to display the bus data until a custom file is defined by the user To enable a custom PacketPresenter file for this channel check the Use PacketPresenter definition file name is below checkbox Then choose the PacketPresenter definition file by clicking the Browse button to the right Once you choose the file you can edit the contents by clicking the Edit File button Once the PacketPresenter is enabled all bus decodes will be processed through the PacketPresenter as well as the original bus decoder
187. r that is used For each trace the buffer is completely filled and then the waveform is displayed You can choose buffers that will capture the information that you want to see but remember that the larger the buffer the longer it will take to fill display and decode 46 USBee QX User s Manual You can also choose the Sample Rate that you want samples taken You can choose from 100ksps samples per second to up to 600 Msps At up to 100Msps all channels can be sampled At higher sample rates a subset of channels is available The table below shows how many channels are available for the given sample rates Available Channels and resulting Sample Rate for each channel Sample Rate Setting in lt 100M 1 m m 5 a lle h h i me e e e WINIe O a A h i yan Ul m Re 0o jN a O d H H N a m USBee QX User s Manual 47 The USBee QX can use sample compression to lengthen the capture time In Sample Compression mode only the transitions are stored effectively removing the samples between inactivity To turn on Sample Compression select Sample Compression On in the Speed and Samples menu The Sample Compression works on just the channels that are shown on the screen so for the longest trace buffers only display the signals that you are interested in All other channels will be masked out and not captured You can also use a
188. rameters that can be tailored to get the data out of your bus the way you need it DECODED DATA LIST You can see the decoded list data in vertical format using the View Show Decode Bus Listing menu item This opens a window on the right side of the screen that displays the decoded data in vertical format The data shown is the data that is decoded from the left side of the waveform screen This data is synchronized to the waveforms as you pan and zoom Sie an 376 5us 576 5us 776 5us 976 5us SO FF 64 0 00007 5 Be IS FF 0 000179375 FF 000179375 S SO C8 0 000253625 FF 0 000253625 SPI 2 SO 68 0 000328375 FF E 0 000328375 SPI2 MISO 98 voginn Gat 0 000406375 I2C 5 SDA S Start r a a 0 000419375 2C 5 SDA A2 Write Miso Fey kafe a S SDA Ack 0 000496375 SDA 00 0 000556500 I2C5 SDA ACK 0 000573250 2C 5 SDA OF 0 000633375 I2C5 SDA ACK 0 000651875 I2C 5 SDA S Start 0 000664875 I2C5 SDA A3 Read 0 000725125 I2C 5 SDA ACK 0 000742625 I2C 5 SDA 18 0 000802875 I2C 5 SDA NACK 0 000823375 IC 5 SDA P Stop 0 000826500 Async 0 TX OE 0 000891500 Async 0 TX OF 0 000956875 Async 0 RX 10 0 001021875 Async 0 RX 11 ma 0 0010868 x n h me t me S amp E ttu me tee Ot Async 0 BiS U S Bee Capture A Measurements Logic Analyzer Oscilloscope T X X2 dX i dX Period Frequency Duty Cycle k Be S 10 59425ms 94 390825Hz 99 7 2009 CWAV Inc You can hide or change
189. re placed using the View Add Sample Marker menu item Once you select this menu item your cursor changes to 4 way arrows and a Sample Marker moves wherever you move the cursor To place the marker position it where you want it and then press the left mouse button Another faster way to place Sample Markers is to press the middle mouse button at the location you want it placed You can edit the text within the marker by clicking on the text and typing in the new text You can hit Enter to add more lines As you add text the marker will expand to fit the text When the waveforms then redraw then marker is positioned to remain locked to the correct sample To move the marker click on the Move at the top of the marker Once you have it moved to the new location use the left mouse button to place it The Mode at the top of the marker changes the direction of the marker Click on Mode to change from Left pointing marker to Right pointing marker and vice versa To hide all of the markers without deleting them uncheck the menu item View Show Marker Labels To turn on the markers make sure this menu item is checked To delete the marker click on the X at the top of the marker You can delete all markers using the menu item View Delete All Markers This will delete all Sample Markers and Smart Markers USBee QX User s Manual 111 SMART MARKERS MM Click to Edit Text 3 833uU5 Smart Markers are locked to a specific sample and mea
190. reserved 1x F X Sreserved Sreserved oF W N Sreserved Sreserved Sreserved Sreserved CMD GO_IDLE STATE CMD1 J SALL_SEND_ CID SSEND_ RELATIVE ADDR J SSET_DSR CMD5 6x 33 L Address 32x h 6x 55 L RCA 16x h 6x 56 L nua 31x i RD WR 1 h 6x 6 L nua 30x i BUS WIDTH 2 h 6x 13 L 6x 23 L nua 9x i BLOCKS 23 h 6x 41 L OCR 32 h 6x 42 L nua 30x i SET _ CD 1 h 6X L 6x L CMD 6x L RCA 16x h STATUS 16x h CMD 6x L OCR 32x h CMD 6x L DATA 128x h CMD 6x L USBee QX User s Manual WO CO NJN OD o xx nan OF W DN 21 29 20 22 23 24 23 26 27 28 SSWITCH_FUNC SSEL DESEL_ CARD SSEND_IF_COND SSEND_ CSD 10 11 SVOLTAGE SWITCH SSEND_ CID SSTOP_ TRANSMISSION SSEND_ STATUS SCMD14 GO_INACTIVE STATE SSET_BLOCKLEN READ_ SINGLE BLOCK SREAD_ MULTIPLE BLOCK SSEND_ TUNING BLOCK SSPEED CLASS CONTROL SCMD21 S CMD22 SSET BLOCK COUNT SWRITE BLOCK SWRITE MULTIPLE BLOCK SCMD26 SPROGRAM CSD SSET WRITE PROT SCLR_WRITE PROT SEND_ WRITE PROT SCMD31 A A A A A A A OrAIaA oF WN FP 50 51 52 53 54 55 56 57 58 59 60 61 62 63 SERASE WR BLK START SERASE WR BLK END CMD34 CMD3
191. roblems fast The USBee QX Test Pod does not need an external power supply The USB bus supplies the power to the pod so your PC will be supplying the power The Pod does however require a self powered hub not bus powered if a hub is used between the PC and Pod The included power supply is required for WiFi use Analog Generator Om Ose OF OM One Frequency 229 174 Nj a Max Vots 30V Digital Generator or BZ Samples Loaded 0 C Loop C Wait For T C T Rising Sampie Clock is 100000000 amp C Semple Clock is extemal on C input O 1X 10x He aco x Units vo Scale Offset 0 gt d d I oooooooo oooooooo eeeeeeeo e e e e 0 o e 0 SigGen C O r r r a eeeoeeeeo C O r O r C O r r E r N eB E oOo oo 0 000014280 SPI 2 MOSI 0 000014280 SPI 2 MISO 0 000322710 SPI 2 MOSI 0 000322710 SPI 2 MISO 0 000659860 SPI 2 MOSI 0 000659860 SPI 2 MISO 0 000967780 SPI 2 MOSI 0 000967780 SPI 2 MISO 0 001276210 SPI 2 MOSI 0 001276210 SPI 2 MISO 0 001599600 12C 5 SDA S Start 0 001613110 12C 5 SDA A2 Write 0 001699300 12C 5 SDA ACK 0 001721630 12C 5 SDA 00 0 001807820 12C 5 SDA ACK 0 001829980 12C 5 SDA 1B 0 001916180 12C 5 SDA ACK 0 001948440 12C 5 SDA S Start NOM1O619050 197 5 COA A Road Patan re Capture Many USBee QX User s Manual 13 THE USBEE QX TEST POD The USBee QX Test Pod has four sets of connectors 14 USB O Connects to the PC via 6
192. rom time to time to add new functionality fix bugs and disable the use of non CWAV made products that attempt to use this Software Liability IN NO EVENT WILL CWAV BE LIABLE TO YOU FOR DAMAGES DIRECT INDIRECT INCIDENTAL OR CONSEQUENTIAL INCLUDING DAMAGES FOR ANY LOST PROFITS LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE SUCH USBEE POD SOFTWARE AND DOCUMENTATION EVEN IF CWAV HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR FOR ANY CLAIM BY ANY OTHER PARTY SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE ABOVE LIMITATION MAY NOT APPLY TO YOU IN NO EVENT WILL CWAV S LIABILITY FOR DAMAGES TO YOU OR ANY OTHER PERSON EVER EXCEED THE AMOUNT OF THE PURCHASE PRICE PAID BY YOU TO CWAV TO ACQUIRE THE USBEE REGARDLESS OF THE FORM OF THE CLAIM Term This license agreement is effective until terminated You may terminate it at any time by returning the USBee Package together with the USBee Pod Software and Documentation to CWAV It will also terminate upon conditions set forth elsewhere in this agreement or if you fail to comply with any term or condition of this agreement You agree that upon such termination you will return the USBee Package together with the USBee Pod Software and Documentation to CWAV USBee QX User s Manual Version 1 5 Copyright 2015 CWAV All Rights Reserved 4 USBee QX User s Manual CO
193. rrently have installed Driver Name Status CWAV Inc WinUSB Ready to use USBee QX User s Manual 37 Follow the instructions clicking NEXT each time on the screen to install the USBee QX Suite software on your hard drive This may take several minutes When completed you will see the following screen Installation Complete USBee RX Suite has been successfully installed Click Close to exit Please use Windows Update to check for any critical updates to the NET Framework e Click CLOSE and the USBee QX Suite software is now installed To run the USBee QX Suite software choose the USBee QX Suite icon from the Windows Start Menu or click on the USBee QX icon on the desktop If no USBee QX is plugged in or installed you will see the following screen running in Demo Mode see the top title bar BB Usbeee Suite Pro USBee RX Demo Mod a h A K USI a Digitaro Gi 7 tai 4 p Digital s a Digitals ta Digitat7 z Digitare 7 Digital K Digitar a B E p gita P Digptal o Digitale pun Digital F thon oh ee ee eee eee eee ee ee 55 OC TOC 38 USBee QX User s Manual e If you have a USBee QX plugged in and installed correctly you will see a screen with all available channels shown Below is the USBee QX version showing 16 digital channels and 2 analog channels You can also see that the device is connect and not in demo mode in the top title bar BB
194. rror Return Value TRUE No Error during processing e FALSE Error while processing The ErrorString contains a description of the error to present to the user DECODESERIAL This routine decodes bus traffic and outputs the data to an output file This routine works ona sample buffer captured using the StartCapture routine Calling Convention CWAV_IMPORT int CWAV_API DecodeSerial unsigned __int64 reservedi unsigned char OutFilename unsigned char InlineFilename int64 StartSample __int64 EndSample unsigned long Rate unsigned long Channel unsigned long AlignValue unsigned long AlignEdge unsigned long AlignChannel unsigned long UseAlignChannel unsigned long ClockChannel unsigned long ClockEdge unsigned long BitsPerValue unsigned long MSBFirst unsigned long delimiter unsigned long hex long BytesPerLine char ProtocolDefinitionFilename char ProtocolOutputFilename char ErrorString e OutFilename pointer to the filename string to write the decoded data to e StartSample the index of the first sample to start decoding e EndSample the index of the last sample to decode e Rate is the rate at which samples were taken during StartCapture 69 600 Msps O 39 300 Msps O 29 200 Msps O 108 100 Msps O 58 50 Msps O 28 20 Msps O 107 10 Msps O 57 5 Msps O 27 2Msps O 106 1 Msps O 56 500ksps O 26 200ksps O 105 100ksps e Channel Which signal 0 15 to use for the serial signal
195. rt A2ICOEOH IGG 0 000560333 I2C 5 SDA A2 Write 0 000642333 12C 5 SDA ACK 0 000663000 12C 5 SDA 00 0 000745000 12C 5 SDA ACK n 0 000765500 2C 5 SDA 5C ese a ee ee 0 000847500 I2C 5 SDA ACK 5E X 5F X60 G8 0 000872000 eae S Start 0 000887833 I2C 5 SDA A3 Read 0 000969667 I2C 5 SDA ACK 0 000991500 2C 5 SDA 18 0 001073333 I2C5 SDA NACK 001100833 I2C 5 SDA P a _ 11101833 X2 Cursor l 0 001101833 Async 0 TX sc 0 001188500 Async 0 k e tk e e e in BE Analog CH1 CH2 H 0 001362333 Async 0 0 001449000 Async 0 0 001535667 Async 0 0 001622333 Async 0 X1 X2 I 0 014513833_SPI2 MOSI SE j p Capture IM asur ments f Logic Analyzer Oscilloscope T Xi X2 dX 1 dX Period Frequency Duty Cycle Ons 533 167us 1 101833ms 568 667us 1 758499kHz Ons infinity 2 e E SES CS We will go through an example that shows how to setup various busses We start with a capture of 8 digital lines that have a number of busses included USBee Suite USBee DX Connected File View Speed and Samples Trigger Setup Help lt ha Digital 0 Digitar Digital 2 Mdigitar3 i E S pi iars E eich E Di itar7 E USBee Capture A Measurements Logic Analyzer Oscilloscope E Xi X2 dX 1 dX Period Frequency Ons Ons Ons Ons infinity 10 70125ms 93447027Hz 9 In this example we will name the bus signals first to make it easier to reference USBee QX User s Manual 57 zE USBee
196. s Manual 75 PS 2 BUS SETUP The PS 2 Bus Decoder takes the captured data from a PS 2 bus Hardware Setup To use the Decoder you need to connect the USBee Test Pod to your hardware using the test leads You can either connect the test leads directly to pin headers on your board or use the test clips for attaching to your components The PS 2 Bus Decoder uses any one of the 24 digital signal lines O thru 21 T and C for the Clock and Data signals and the GND ground line Connect the Clock and Data to your PS 2 bus using the test leads and clips Connect the GND line to the digital ground of your system Software Setup Activate the below Channel Settings Dialog by clicking the grey tab on the left of the signal names on the main application screen E X Signal Selection 012 56789 AR DEF PS 2 Data s PS 2 Clock 0 Save Cancel On the above dialog box select the signals you plan to use for the PS 2 Bus protocol The bus traffic will be decoded as in the following screen Si as epee ee a AN Basa orem he Re ae Se a pe PTA ot a Se ea at a Tee a ee 76 USBee QX User s Manual SETTING VIEWING PREFERENCES The USBee QX Suite has many ways that you can customize the display of your data beyond the placement of the waveforms CURSOR COLORS You can change the color of the Trigger X1 and X2 cursors using the View Menu When chosen you will see the Color Selection dialog box below To chan
197. s not have a valid digital signature that verifies its How can decide what software to nun USBee QX User s Manual e The first part of the installation installs Microsoft requirements including Microsoft NET Frameworks Version 4 0 If you do not have this on your PC it will install it for you as shown below click Accept to install the NET Frameworks This installation takes a LONG time so please be patient since it is worth the wait If you already have it installed you will automatically see the Welcome to the USBee QX Suite Setup Wizard screen e You will see the Welcome to the USBee QX Suite Setup Wizard screen as shown below The installer will guide you through the steps required to install USBee RX Suite on your 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 maximum extent possible under the law e During the installation you will see a driver installation dialog box that will install the USBee QX drivers Click Finish to complete the installation after the drivers have been successfully installed as below Completing the Device Driver Installation Wizard The device driver installation wizard did not update any of your software for your hardware devices because it was not better than the software you cu
198. s set to 1 8V the T transitions to logic 1 at 1 8V 174 USBee QX User s Manual USBee QX User s Manual 175 USBEE QX EDGE PULSE COUNTERS The USBee QX can independently measure the number of edges that occur on four of the digital input signals 0 through 3 The number of edges counted is shown in the USBee QX Suite control panel as below p pa LE a 4 a Counting occurs when the Count checkbox is selected To clear the counts press the Clear Counts button Remember that the counts are affected by the Digital Logic Threshold setting so you must set this correctly for the signals you are measuring for accurate counts Since each Pulse is made up of a rising edge and falling edge pair you can compute the number of pulses by dividing the Number of Edges by 2 176 USBee QX User s Manual USBEE QX FREQUENCY COUNTERS The USBee QX can independently measure the frequency of four of the digital input signals 4 through 7 The frequency measured is shown in the USBee QX Suite control panel as below Remember that the measurements are affected by the Digital Logic Threshold setting so you must set this correctly for the signals you are measuring for accurate counts USBee QX User s Manual 177 USBEE QX WIFI MODE WIFI MODE SETUP To setup the USBee QX for WiFi operation you must first connect the pod with the USB cable to a PC with the USBee QX Suite Software installed For more information see Software Inst
199. s setup and if they are both on the Network that you want to use so that the IP address can be used for future wireless connections 178 USBee QX User s Manual A note about IP addresses your router will assign an address and that address is valid for at least 24 hours Every time the USBee QX is powered with the AC adapter it may receive a new address The USBee QX Suite software will attempt to connect to the address first and then search the network for the pod It is possible that the USBee QX Suite software will be unable to locate the pod on the network and the WiFi setup procedure using the USB cable will have to be repeated After successful WiFi setup close the USBee QX Suite software and unplug the USB cable from the PC and USBee QX Next use the supplied AC adapter to power the USBee QX When the USBee QX detects no USB signal it will connect to the wireless network The Wireless LED will illuminate on the case Now you can run the USBee QX Suite software and perform tests as before WiFi data transmissions are substantially slower than USB 3 0 transmissions As such you should try to limit the size of your captures to minimize the data download latency USBee QX User s Manual 179 AUTOMATION The USBee QX Suite has automation built in that lets you setup your configuration and use it repeatedly to start capture trigger export CSV data export screenshots and exit without user intervention To use automation you fir
200. sQX unsigned char Full unsigned char Triggered unsigned char Running long CWAV_API StopCaptureQX void long CWAV_API TriggerNowQxX void long CWAV_API EndCaptureQxX __int64 ActualNumberOfSamples __int64 TriggerPosition long CWAV_API GetDigitalSignalsQXx unsigned char digital to7 unsigned char digital8to15 unsigned char digital16toC USBee QX User s Manual CWAV_IMPORT unsigned long CWAV_API SampleDigitalData _ int64 index CWAV_IMPORT float CWAV_API AnalogSampleVoltage unsigned long channel __int64 index CWAV_IMPORT __int64 CWAV_API FindNextEdge __int64 UCSample unsigned long long channelmask unsigned long direction Protocol Decoders CWAV_IMPORT int CWAV_API DecodeSerial unsigned __int64 reserved1 unsigned char OutFilename unsigned char InlineFilename __int64 StartSample __int64 EndSample unsigned long Rate unsigned long Channel unsigned long AlignValue unsigned long AlignEdge unsigned long AlignChannel unsigned long UseAlignChannel unsigned long ClockChannel unsigned long ClockEdge unsigned long BitsPerValue unsigned long MSBFirst unsigned long delimiter unsigned long hex long BytesPerLine char ProtocolDefinitionFilename char ProtocolOutputFilename char ErrorString CWAV_IMPORT int CWAV_API DecodeiWire unsigned __int64 reservedi unsigned char OutFilename unsigned char InlineFilename _int64 StartSample __int64 EndSample long Rate unsigned long Signal long d
201. sample rate that each of the samples will be clocked out at To specify the file to use select the browse button and choose the file The file will be parsed and the number of samples loaded and sample rate will be sent to the Digital Signal Generator The file format of the CSV files is as follows 500000 Sample Rate 23 First sample 51 Second sample 84 Last Sample Only the first field of each line is considered as a sample This allows you to use a spreadsheet that computes the samples in the first column A sample Excel spreadsheet and the resulting CSV file is included in the Program Files CWAV Inc USBee QX Suite directory for you to use For 65535 samples it takes about 30 seconds to download Each sample is a decimal value that represents an 8 bit value from value 0 to 255 These 8 bits are tied to each of the 8 digital outputs Bit O of the sample value goes to the 16 output pin Bit 7 of the value goes to the C output pin and so on When the pattern is being generated all 8 digital outputs are changed at the same time to the 8 digital values represented by the sample value USBee QX User s Manual 173 For example if the sample value is 85 55 hex then at that single sample time the outputs will be from C to 16 O 1 O 1 O 1 O 1 Since each of the actual output pins can be independently configured to be Sig Gen PWM High Low or Trigger out you must make sure the channel is set to Sig Gen in order to
202. sbee com download htm and open the usbeeQxXsuitesw zip file Run the SETUP EXE Follow the instructions on the screen to install the USBee QX software on your hard drive This may take several minutes Now plug the included USB A to USB Superspeed cable into the USBee QX and the other end into a free USB 3 0 High Speed port on your computer You will see a dialog box indicating that it found new hardware and is installing the software for it Follow the on screen directions to finish the driver install The USBee QX Software is now installed Run the USBee QX Suite software by going to the Start Program Files USBee QX Suite If your PC does not already have NET Frameworks version 4 0 or greater you will be notified to download and install this from the Microsoft web site USBee QX User s Manual DETAILED SOFTWARE INSTALLATION The USBee QX Suite software is available for download from www usbee com download htm It will run in a demonstration mode if you do not have a USBee QX Pod installed and attached To install the USBee QX Suite software Click the USBee QX Suite Software link at http www usbee com download htm and click SAVE to save the software to a known directory Name usbeesuitesw zip Type Compressed zipped Folder 862KB From usbee com Always ask before opening this type of file While files from the Intemet can be useful some files can potentially 2 ham your compu
203. see the output of the Signal Generator SAMPLE CLOCKING The CSV file specifies the desired sample rate of the clocked out digital samples You can then modify the sample rate by changing the frequency in the sps text box from 0 to 100000000 You can also specify to use the external C input as the sample clock by selecting the associated radio button Make sure you select C as an input in the Signal Generator section Note that this will reduce your number of digital outputs by 1 Every cycle of the C input will clock out the next sample in the sequence WAVEFORM GENERATION CONTROL The Wait for T checkbox and the associated T Rising checkbox to specify the polarity makes the USBee QX wait for the T input to have an edge before starting the pattern This allows for synchronizing the pattern generation with an external event Make sure you select T as an input in the Signal Generator section Note that this will reduce your number of digital outputs by 1 The Loop checkbox allows you to loop the generated pattern If the Wait for T checkbox is selected each cycle waits for the T to be asserted before starting the generation The following screenshot shows the Digital Signal Generator configured to generate 291 samples each time the T signal has a rising edge In this case the T signal is tied to the CH1 analog signal The Loop selection makes it repeat but only after the T signal sees another rising edge Since the Digital Logic Threshold i
204. ser s Manual 151 File Edit View Window f fm Packet Debug EVENT DATA DATA EVENT eT fon eC lo layer Packet Debug EVENT DATA DATA EVENT Mace 5 Tne oosfor rr as oa Layer CYPRESSRFIC DIR INC ADDRESS WRITEDATA Packet _6 Time 15 6035ms Write False TX CFGADRJO a ee ang r Packet Debu EVENT DATA DATA DATA DATA EVENT cere O ca A ER A eE m Packet Debug EVENT DATA DATA DATA DATA EVEN CT Ce EEE E H Layer CYPRESSRFIC DIR INC ADDRESS READDATA Pocket 10 Time 156118330 Read False rss aor 20 Cz Packet PACKETPRESENTER SPECIFICATIONS The PacketPresenter system has the following limits regarding file size packets fields lookup tables etc e 100K bytes per PacketPresenter Definition File 64K Data Records per Packet min 64K bits max 64K bytes e 7 Protocols e 1024 Field Lines per Protocol e 128 Fields per Field Line e 64 Lookup Tables per Protocol e 256 Lookup entries per Lookup Table e 256 Decoder Substitutions per Protocol 3 Bytes per Substitution input or output e 4 PacketPresenter Windows e 2 1B bytes per PacketPresenter Output File 152 USBee QX User s Manual EXAMPLE PROTOCOL FILES AND OUTPUT EXAMPLES _ASYNC PROTOCOL EXAMPLE Async Protocol Definition File This file defines the transfers to from a custom device over an ASYNC bus Protocol name ASYNCBus bytewise DEBUG DebugOn Uncomment this to t
205. sors is shown in the Measurement Window Conversely if you place the X1 and X2 cursor in the Waveform display using the Cursors Bar the cursors are moved in the PacketPresenter window and it is scrolled to show that location in the packet list USBee Suite Pro USBee RX Demo Mode C Program Files x86 CWAV Inc USBee RX Suite RXDemo usbeerx r v USBee RX Control Panel E 300usftiixy 300us 300us ey elie Re File View Speed and Samples Trigger setup Help 1 a Digital I Digital 2 3 o rE SPL2 lt gt Bo n O S pigias RCS h h h h am ee e969 W Digital 6 Digital 7 Async 6 Darg Cursos X1 X2 J PacketPresenter File Edit Packet 4 Time 788us T Layer ASYNC_6 Packet 5 Time Onsj19 1Aj1B 1C 1D lE 1F x Layer SPI 2 MOSIDATA MISODATA Packet 6 Time 728us Layer SPI 2 MOSIDATA MISODATA Packet 7 Time 1 08ms OC 8C x2 Layer SPI 2 MOSIDATA MISODATA Packet 8 Time 1 38ms FF FF FFI78 84 24 SLAVEADDRESS Ry Logic Analyzer Oscilloscope Copyright 2022 CWA Inc All Rights Reserved Designed and Manufactured only in the USA Trigger Settings ta ae US Patent 7 911 970 and other patents pending USBee QX User s Manual 131 PACKETPRESENTER DEFINITION FILE FORMAT Each PacketPresenter Definition file defines how the incoming data stream is represented in the PacketPresenter screen of the USBe
206. st For example if fieldname Field has the contents of 16 then the following is true fieldname 2 2 16 2 2 34 fieldname 2 16 2 18 fieldname 2 2 16 2 2 6 fieldname 2 16 2 8 fieldname 2 2 invalid must come before offset fieldname 2 2 invalid must come before offset The length of the packet includes ALL of the data from each of the data channels for that bus If the bus contains only one data channel such as 12C the length counts all data on that one bus If the bus has two data channels the length refers to all data on both channels combined TYPE EVENT The start or end of a packet can be indicated by the reception of any of the bus specific Events For example in 12C you get a Bus Event for each Start Bit and a Bus Event for each Stop Bit In USB you get a Bus Event for each Sync word and a Bus Event for each EOP The event value is a bitmask that includes all events that you want to use If any of the events occur a packet will be started or ended type Event Start End of a packet is Signaled by event event 1 Use Event 1 Available events depend on bus type or event 3 Use either Event 1 or Event 2 TYPE TIMEOUT The end of a packet is determined by a timeout since the last valid data or event on the bus The timeout is defined in units of microseconds Packet Start type timeout End is after timeout timeout 45 microseconds since last
207. st need to create a capture file that has all of the configuration and settings you desire To do this run the Software and setup the way you need including triggers decoding sample rate size search etc Finally Capture and save this file by using the file menu Save As and name the file setup usbeeqx or something similar It would probably be easiest if you saved this file into the directory where the program is located ie C Program Files x86 CWAV Inc USBee QX S Next to use automation open a command prompt and navigate to the above directory and use the following command line format USBee Suite exe lt intput filename gt lt output base filename gt lt flags gt lt input filename gt is the complete filename including extension that will be loaded and used for capture lt output base filename gt is the first part of the output file names that will be generated after the capture is complete lt flags gt Letters S B and or R indicating S Save Screenshot JPG file B Bus Data to CSV file or R Raw Signal data to CSV file Files that are output are e output usbeeqx Captured USBee QX Suite Trace File e output csv Raw Sample CSV file if flag R is included on command line e outputBus csv Decoded Bus Data CSV file if flag B is included on command line e output jpg Screenshot image file if flag S is included on command line The GUI will only stay open as long as the capture is not finished The program will write the
208. sure the waveform underneath They are placed using the View Add Smart Marker menu item Once you select this menu item your cursor changes to 4 way arrows and a Smart Marker moves wherever you move the cursor To place the marker position it where you want it and then press the left mouse button You can edit the text within the marker by clicking on the text and typing in the new text You can hit Enter to add more lines As you add text the marker will expand to fit the text When the waveforms then redraw then marker is positioned to remain locked to the correct sample To move the marker click on the Move at the top of the marker Once you have it moved to the new location use the left mouse button to place it The Mode at the top of the marker changes the measure mode of the marker Click on Mode to cycle through No Measurement Width Frequency Period and Duty Cycle An arrow shows the measured area and the measurement shows up as the last line of the marker To hide all of the markers without deleting them uncheck the menu item View Show Marker Labels To turn on the markers make sure this menu item is checked To delete the marker click on the X at the top of the marker You can delete all markers using the menu item View Delete All Markers This will delete all Sample Markers and Smart Markers 112 USBee QX User s Manual ANNOTATIONS AND STICKY NOTES The USBee QX Suite adds Sticky Notes which you can use to further
209. t to one of the mini grabber clips and then attach it to the Ground e Connect Signals Connect any of the USBee inputs on the USBee pod to your circuit you would like to test You can either use the socket to plug onto a header post or connect it to one of the mini grabber clips and then attach it to your signal of choice e Run USBee QX Suite Run the USBee QX Suite Application from the Start Menu e Press the Capture Once button This will capture and display the current activity on all of the signals e View the Waveforms You can then scroll the display either by using the slider bars or by clicking and dragging on the waveform itself You can also change the knobs to zoom the waveform e Make Measurements You can make simple measurements by using the Cursors area gray bars under the waves Click the left mouse button to place one cursor and click the right mouse button to place the second The resulting measurements are then displayed in the Measurements section of the display 40 USBee QX User s Manual USING THE USBEE QX SUITE MIXED SIGNAL OSCILLOSCOPE This section details the operation of the Mixed Signal Oscilloscope Logic Analyzer and Protocol Analyzer features of the USBee QX Suite application that runs on the USBee QX Test Pod When the USBee QX Suite is first run you will see a screen containing all of the available input signals for the USBee QX Pod plugged into the PC HBB Us8ee Suite Pro USBee RX Connecte
210. t will get displayed on the SCreCN cccceseceseceeeeeeees 93 Sending Data and Events that will get displayed on the PacketPresenter 94 Changing the Background Color of Outputted ENtri s c ccccccccseseccceesecenenes 95 SIVIART SEARCH ovien a tans ies testes demesceceenaussanctue sates EENT TEE 97 AG GING GSCI CH LING correire na van taae es ATO TOE 97 Viewing Search Matches eraccccsoxddocelocsscesoticnakdaeiaddssavesodeleansaeaticnsmieiansamebioets 98 EATCHING G SIMGVE Search eira a A euane ated aoeaeasie ries 99 Dieta Siena FACES tiscsc cis E E E EE 100 Analog Sienai Ede ESsruaine e E A 101 BUS Dalaene nnie a ENA A ENE A A EA ENO NA N ENA AN 102 Digital Signal States and RAM COS iiisu se yacaccsesciext A 103 Analog Signal States and Ranges ccccsssssccccsssseccceesecceseeeeceseeeseeessuaecessueaeeessages 105 TMe Wind OW QUANG scxcmewienen cesta euna aea 107 FAST PAN BUS VIEWING iusvicstter sorsi E E aan ache tadandues O OAA 110 SAMPLE AND SMART MARKERS orreri a OA T TT 111 Sample Markers oreren aa E E A a 111 SMO MAIKOTS cette a Ea 112 ANNOTATIONS AND STICKY NOTE Sucreniizrontoii i i E ON T T 113 ANDOALONS erian vena EE O T TTE AT 114 SUCKYNOE S sotto ra EE EET EO A N E 115 ACQUISITION CONTRO areas aa a E E A 116 DISPLAY MODES asrini unsa a o ates a a EE 117 ANALOG CHANNELS SCALIN Grios mearain E A outers 119 BROWSER GIKE NAVIGATION sop insaor i eT O E E 120 RELATIVE HME DECODE orenian a a aa a a 121 PACKET
211. tRead Printout this label if match SlaveAddress 7m h RW 1 1 1 Control Byte ReadData Nm h Read Data Variable number N Random Read Fields SRandomRead Printout this label if match SlaveAddress 7m h RW 1 0 i Control Byte Address 8m h 1 byte address als START Condition SlaveAddress 7m i RW 1 1 1 Control Byte ReadData Nm h Read Data Variable number N 154 USBee QX User s Manual Cypress RF IC Protocol Definition File This file defines the transfers to from a CY6936 RF IC using the SPI bus Protocol name CypressRFIC bytewise DEBUG DebugOn Packet Start type event event 1 SS goes active End type event event 2 SS goes inactive Decode Fields QX IRQ STATUS ADR Read and Write Command Fields Dir ly 0 L Inc ly tf Address 6y 07h L Dummy 8x i QXOW 1x h SOPDET 1x h QXB16 1x h QXB8 1x h QXB1l 1x h QXBERR 1x h QXC 1x h QOXE 1x h Fields Dir ly 1 L Inc ly tf Address 6y 07h L QXOW 1ly h SOPDET 1y h QXB16 ly h QXB8 ly h QXB1 ly h QXBERR 1ly h QXC ly h QXE ly h TX_IRQ STATUS ADR Read and Write Command Fields Dir ly 0 L Inc ly tf Address 6y 04h L Dummy 8x i OS 1x h LV 1x h TXB15 1x h TXB8 1x h TXB1 1x h TXBERR 1x h TXC 1x h TXE 1x h Fields Dir ly 1 L Inc ly tf Address 6y 04h L OS 1ly h LV
212. tart getting sampled once you press the Capture buttons You specify the trigger event by selecting one of the USBee signals to trigger on rising or falling edge Normal mode will wait for the trigger event to occur before capturing Select this option using the Trigger Normal Mode menu item If the trigger event does not occur you can press the Stop button to terminate the capture Automatic Mode will wait a set time for the trigger and will automatically trigger if it is not found Select this option using the Trigger Automatic Mode menu item If the trigger event does not occur within a specified time it will automatically start a capture of whatever is on the signals at the time You can press the Stop button to terminate the capture 116 USBee QX User s Manual DISPLAY MODES The USBee QX Suite lets you widen the trace waveforms display the analog waveforms as vectors or single sample points and persist the display from one trace to the next HBB Ussee Suite Pro USBee DX Connected aloka File View Speed and Samples Trigger Setup Help Digitalo Digital Digital 2 Digitals Digital 4 Digitals Digital Digital 7 e e we mee wee wee we Analog USBee Logic Analyzer Oscillascope The Wide setting shows the waves using a wider pixel setting This makes the waves easier to see You can toggle this setting using the menu item View Wide Lines The Vectors setting draws the waveforms as a line bet
213. ter f you do not trust the source do not open or k gave this file What s the risk Download complete Th Download Complete usbeesuitesw zip from usbee com o Downloaded 862KB in 3 sec Download to C Downloads usbeesuitesw zip Transfer rate 20 KB Sec If you receive messages such as below press ALLOW or CONTINUE ANYWAY to continue with installation of the software USBee QX User s Manual 35 36 This program will open outside of Protected mode Internet Explorer s Protected mode helps protect your computer If you do not trust this website do not open this program Name Windows Explorer Publisher Microsoft Windows E Do not show me the warning for this program again Run the SETUP EXE file that is included in the ZIP file that you downloaded to start the installation a Organize vy 2 Views Y E Extract all files 0 oe Seen ee Mea i usbeesuiteswzip wtp Search a l gt Favorite Links E hed na Windows Install E Pictures Music E setup exe Application More Folders d Public jE Computer amp Local Disk C J SRECYCLE BIN d ADOBEAPP J BACKUP d Boot A FIBA A i i 2 items Publisher Unknown Publisher Name Local Temp Temp10_usbeesuitesw zip setup exe Type Application From C Users Tim AppData Local Temp Tempi0_usbe publisher You should only run software from publishers you trust B This file doe
214. thm applied to the spectrum You can adjust the display using the Scaling and Offset knobs on the left to move the waveform where you need it You can also press the Auto button to auto scale the wavefrom to fit completely in the window Hovering the cursor over the waveform will place a marker with the measured level and frequency The top three peaks are also found and marked automatically 212 USBee QX User s Manual PROTOCOL FIELD GRAPHING CEA 1 NM samples SMsps ET f OF Cocture Once C M MAUN EE Cocture Once H Cope Mary let gt it i Protocol Field Graphing gives you a visual display of any of the protocol fields in line with your traces This allows you to see the values of acceleration temperature audio or any other digital data contained in your bus protocols The above screenshot shows the graphing of the X Y and Z acceleration of two accelerometers on the opposite side of an impact The data that is graphed comes directly from the PacketPresenter output for a decoded bus line As seen in the above screenshot the PacketPresenter is showing decoded packets that contain the fields that we want to graph For setting up the PacketPresenter refer to the PacketPresenter chapters Once the PacketPresenter is decoding the fields you want to graph you can add a graphing waveline To setup a Protocol Graphing waveline click the grey tab at the left of a waveline or add a new one by pressing the symbol
215. tput to only show packets that contains certain fields that match your criteria Below is the Filter Packet dialog box that is shown by selecting the View Packet Filter along with the resulting PacketPresenter output PacketPresenter Filter Control INC v Enter Field Name x Enter Field Name v Filter On ano Filter Off Clear Cancel FALSE In the leftmost textboxes type the Field Label Then select the comparator operator equals not equals less than greater than and finally the value that the field is to be compared against Finally if there is more than one field in the search list choose whether to AND or OR the search terms When you click Filter On only the packets matching the criteria are displayed To turn off the filtering click on the Filter Off button 130 USBee QX User s Manual PACKETPRESENTER TO WAVEFORM ASSOCIATION USING CURSORS The PacketPresenter output and waveform display are synchronized using the Cursors This feature allows you to correlate what is shown in the PacketPresenter window to the actual waveform on the logic analyzer that created that packet You can place the cursors using the PacketPresenter window by using the left and right mouse buttons Place the mouse over the packet you want to place the cursor on and click the left or right mouse button The cursors are placed at the beginning of the packets The resulting difference between cur
216. ts Each Event is a selection of various bus analog and or digital states To edit an Event click on the expander to show the Event details as below a Channel Setting Soe E If Digital Signal pick one has rising edge happen 1 times or L F Analog Signal CH1 has rising edge at voltage threshold 2 Volts happens 1 times while E Bus pick one decoded data is anything 00 and and C Digital Signal States are F 0 to F 0 and E Analog Signal CH1 is 10 Volts to 10 Volts and C This Event happening between 0 us and 10 s immediately after the previous event Followed By l Event 2 Use PacketPresenter Definition File name is below To enable a line in the Event search click on the checkbox to the left of the items you want to include in your search You can specify any combination of the available lines in a search Event All search criteria in a single Event must occur simultaneously for an event to be considered a match For example if you are looking for an edge on a digital signal and looking for an analog voltage range the edge must occur while the voltage is inside the range to be considered a match The following sections detail the available search items for each event and how they function USBee QX User s Manual 99 DIGITAL SIGNAL EDGES The first line lets you find edges on the digital signals First select the Digital line you want to s
217. ts the digital output channel specified to a PWM pulse width modulator signal Calling Convention CWAV_IMPORT unsigned long CWAV_API GeneratePWMWaveformQX unsigned char channel unsigned long samplespersecond unsigned char dutycycle e Channel which channel 16 to C to setup as a PWM output O channel 16 7 channel C e Samplespersecond how many samples per second for the PWM signal 1 to 390000 e Dutycycle a value from 0 to 100 for the low to high percentage of the PWM signal Return Value 1 Successful e O Failure LOADDIGITALWAVEFORMQX This routine sets the digital output channel specified to a PWM pulse width modulator signal Calling Convention CWAV_IMPORT unsigned long CWAV_API LoadDigitalWaveformQX unsigned long numberofsamples unsigned char samples _ e Numberofsamples a value from 1 to 61000 indicating the number of samples in the pattern e Samples a pointer to the buffer of samples Each sample is a byte and are clocked out on consecutive sample clocks Bit O of each byte is output channel 16 bit 7 is output channel C Return Value e 1 Successful O Failure 2 GENERATEDIGITALWAVEFORMQX This routine sets the digital output channel specified to a PWM pulse width modulator signal Calling Convention CWAV_IMPORT unsigned long CWAV_API GenerateDigitalWaveformQX unsigned char channelmask unsigned char GenerateOn unsigned char loop unsigned char 202 USBee QX User s Manual
218. u need to connect the USBee Test Pod to your hardware using the test leads You can either connect the test leads directly to pin headers on your board or use the test clips for attaching to your components Connect two of the digital signals to the D and D of your embedded USB bus preferably at the IC of the USB device or the connector that the USB cable plugs into Software Setup Activate the below Channel Settings Dialog by clicking the grey tab on the left of the signal names on the main application screen i Channel Settings 7 1 xX Single Signal sm rec asme iwe Signal Selection O1202356789 AB BEF D MOOO D Oe Speed Address gt r Endpoint J Low Speed Full Speed Cancel L Save On the above dialog box select the D and D signals and what speed the bus is operating at You can also specify a specific USB Address or Endpoint you want to see All other transactions will be filtered out Leave the fields blank to see all transactions The bus traffic will be decoded as in the following screen PU Aeae Lengthoi4 a ACK USBee QX User s Manual 65 I2C BUS SETUP The I2C Bus Decoder takes the captured data from an 12C bus Hardware Setup To use the Decoder you need to connect the USBee Test Pod to your hardware using the test leads You can either connect the test leads directly to pin headers on your board or use the test clips for attachin
219. u need to decode accumulating decoded bits bytes along the way and determining what the result is that you want to display Since the USBee QX uses sample compression there may be trillions of actual samples Therefore it is best and will result in faster decoder times to use the FindNextEdge routine instead of individual SampleData calls when processing a protocol This routine understands the compression algorithm and does not waste time processing compressed samples OUTPUTTING ENTRIES THAT WILL GET DISPLAYED ON THE SCREEN Once your decoder has determined the result of the decoded data that you want displayed on the screen you call the WriteEntry routine above This gets passed the Start Sample End Sample and Text String Entries appear as rounded rectangles on the screen on the associated wave line and are locked to the samples that you specify For example the following call places the Hello World string on the screen stretching from the first sample to the 100 sample WriteEntry OutFile 0 100 Hello World The output is as follows USBee QX User s Manual 93 E USBee Suite USBee SX Demo Mode DigitaO E te fielloworld DW Hello World SR Digital 2 DEE Digital 4 Digital s Digitale Digital7 A Measurements T Xi X2 dX WdX Period Frequency Duty Cycle Ons Ons Ons Ons infinity Al7ns 24 0MHz 104857500 SENDING DATA AND EVENTS THAT WILL GET DISPLAYED ON THE PACKE
220. uite Manuals downloaded 16 USBee QX User s Manual USBee QX User s Manual 17 INTRODUCING THE USBEE QX SUITE gt amp Digitaro Digital 1 igital d gitars SPL2 FF F 18 FF FF gt q q Digitars RCS BE Mico aN EAE Digitare Digitar7 Async 6 19 1A 18 jac 10 J 1E J1 A Mpe 20Msps Capture Many The USBee QX Suite is powerful electronic signal analysis software for your USBee QX Test Pod It starts out as an easy to use Logic Analyzer Oscilloscope Signal Generator Frequency Counter and PWM Controller and adds serial bus decoding and world class configurability that lets you solve your electronic problems quickly This chapter details the operation of the USBee QX Test Pod running the USBee QX Suite software USBEE QX SUITE OVERVIEW The USBee QX Suite is a powerful mixed signal analyzer that on the USBee QX Test Pod Itis available for free from USBee com and will run without restriction The USBee QX Suite Standard will run in Demo mode without a USBee or on any USBee QX Test Pod It will not work on any other USBee test Pod model 18 USBee QX User s Manual B USBee Suite Pro USBee RX Connected C cwav USBee Test Files ProtocolSetup usbeerx we S SigGen 9 PWM High Low _ Tigger y M Freq 1000 Duy Gyi 50 i 3 Analog Genernor SigGen PWM High Low Tigger Gut Free 1000 DutyGyiee 50 Loop WaitForT T Rising o Sample Clockis 24000000 Sas o SgGen PWM Hi
221. untsQx EnableCountsQXx Sleep 12 unsigned long ec ec1 ec2 ec3 f4 f5 f6 f7 GetFrequencyAndCountsQx amp ec amp ec1 amp ec2 amp ec3 amp f4 amp F5 amp f6 amp f7 printf Edge Counts ld n ec printf Edge Counts 1 ld n ec1 printf Edge Counts 2 ld n ec2 printf Edge Counts 3 ld n ec3 printf Frequency 4 ld n f4 printf Frequency 5 ld n f5 printf Frequency 6 ld n f6 printf Frequency 7 ld n f7 printf Setting Logic Threshold n SetLogicThresholdQx 1 5 printf Starting a Capture n Setup the Trigger Specification SetTriggersQXx false false false false false false No trigger trigger always false false false false false false false false false 1 false 1 1 0 3 0 1 5 OxFFFF x0 00 OxFFFF Trigger X Event false false false false false false false false 0 false 1 false 1 1 0 3 0 1 5 OxFFFF 0x0000 OxFFFF Trigger Y Event Start the capture unsigned long SampleBufferSize 4 1024 1024 4 Million unsigned char TriggerPosition 50 50 percent trigger in the middle float SampleRate 100000000 10 Msps unsigned long ChannelMaskA OxFFFFFFFF Sample all channels D 15 CH1 and CH2 unsigned long ChannelMaskB xFFFFFFFF Sample all channels D16 23 CH3 and CH4 StartCaptureQx SampleBufferSize TriggerPosition SampleRate ChannelMaskA ChannelMaskB
222. up uzbeerx gi l q i 7 cm j oma File View Speedand Samples Trigger Setup Help v USBee RX Cortroi Pane 100us div Digitaro Digital I Digital 2 Digital 2 GIG PAA MAA PAP FI F 7 a 2 m C CS OO T000 AAA e a o Digitsrs TIM AA G ANG iy a St SIO OIE s 20101016 Digital 6 Digital 7 Async 6 RIA LO LAY fipyi yi fear T 68 Te G Analog Cursors AM sampe 3 OOM spe Capture Once USBee RX Suite BSG Logic Anatyzer Oxcilloscope tre Capture Many Conpypnaght MILL CHAN tone A Rights nner Dege are Marncte treet arty n ose USA US Patent 7 OLLON wet pate pares perebag To Stretch and Shrink the display you can click and drag the edges of the application to the size you want All waves will scale to fit Below you see two examples of different size displays MODIFYING WAVE LINES Each line on the display is called a Waveline Wavelines can be modified to your liking so that you see the data you need to solve your problem You can delete add move or reconfigure any waveline To Delete a Waveline from the screen press the little X near the signal name This will remove the waveline from the screen Below shows the USBee QX Suite after deleting the Digital 2 waveline 54 USBee QX User s Manual Bow Suits USE DK Connected ew SeotiendSarcle Inge Sete elp ae Digitaro ih pigitar o Wotan i igitar s Digital EEI i Je EIE Digital gt a
223. urn on Debug Packets Packet Start type value value 40h Start command mask FOh Mask out the channel number End type timeout timeout 3000 3ms timeout ends the packet Decode Fields Fields Start 4 h Channel 4 1 h Command 8 h X 16 d 20 48 25Sq Y 16 dqd 20 48 25 9g Z 16 qd 20 48 25 9g Rest N h Rest of the packet Fields Rest N h Rest of the packet USBee QX User s Manual 153 12C PROTOCOL EXAMPLE I2C EEPROM Protocol Definition File This file defines the transfers to from an I2C EEPROM with 8 bit address Protocol name I2CEEPROM bytewise DEBUG DebugOn Uncomment this to turn on Debug Packets Packet Start type event event 1 Start Bit End type event event OAh Stop Bit Or NACK Decode Fields Device Not Present Fields SDevice Not Present Printout this label if match SlaveAddress 7m h RW 1 i Control Byte Address 8m h 1 byte address 8 followed by a NACK condition Set Address Fields SSetAddressCmd Printout this label if match SlaveAddress 7m h RW 1 0 i Control Byte Address 8m h 1 byte address 2 followed by a STOP condition Write Command Fields SWriteCommand Printout this label if match SlaveAddress 7m h RW 1 0 i Control Byte Address 8m h 1 byte address 1 NO START condition WriteData Nm h Written Data Variable N Current Address Read Fields SCurren
224. us where for each byte sent on the MOSI line there is one byte received on the MISO line In the protocol definition you can specify which of the signals to expect the next field of data to be sent on In the SPI example you may get a Command and Length field on one signal followed by the read data back on the other signal The decoder would take that into account and show the command Length and Data as a single transaction Multiple signals are differentiated in the PacketPresenter using the X and Y channel specifiers These channels are specified by selecting the signals to use for that bus in the Channel Settings dialog box The following table shows which signals are the X and Y signals Bus Type Channel Setting Dialog Box setup for Channel X ASYNC Least Significant Async Channel selected SPI Signal chosen for MISO 1 Wire Data Signal 12C Data on SDA SCL bus Parallel All Data Signals sampled together Serial Serial Data CAN QX Data PS 2 Data from Device to Host USB Data on D D bus SDIO CMD traffic Channel Setting Dialog Box setup for Channel Y Next Least Significant Async Channel selected Signal chosen for MOSI Not used Not Used Not Used Not Used Not Used Data from Host To Device Not Used DAT data traffic Notes If more than 2 Async channels are selected to be decoded the additional channels are not used by the PacketPresenter Data Bytes alternate channels since there is
225. us traffic and outputs the data to an output file This routine works ona sample buffer captured using the StartCapture routine Calling Convention CWAV_IMPORT int CWAV_API DecodeSPIVariable unsigned __int64 reservedi unsigned char OutFilename unsigned char InlineMOSIFilename unsigned char InlineMISOFilename __int64 StartSample _ _int64 EndSample long Rate unsigned long SS unsigned long SCK unsigned long tMOSI unsigned long tMISO unsigned long MISOEdge unsigned long MOSIEdge unsigned long delimiter unsigned long hex unsigned long UseSS unsigned long SSLevel long BytesPerLine long BitsPerByte char ProtocolDefinitionFilename char ProtocolOutputFilename char ErrorString e OutFilename pointer to the filename string to write the decoded data to e StartSample the index of the first sample to start decoding e EndSample the index of the last sample to decode e Rate is as follows O 69 600 Msps O 39 300 Msps O 29 200 Msps O 108 100 Msps O 58 50 Msps O 28 20 Msps O 107 10 Msps O 57 5 Msps O 27 2Msps O 106 1 Msps O 56 500ksps O 26 200ksps O 105 100ksps SS Which signal 0 15 to use for the Slave Select signal SCK Which signal 0 15 to use for the clock signal e MISO Which signal 0 15 to use for the MISO signal e MOSI Which signal 0 15 to use for the MOSI signal e MOSIEdge 0 use falling edge of SCK to sample data on MOSI 1 use rising edge e MISOEdge 0
226. utput the data CONDITIONAL FIELD LINES Conditional Field Lines provide a means for defining packets whose contents vary based upon the presence of a value in another field An example of this is a packet that contains a Command Byte that determines the format of the rest of the packet A Conditional Field Line contains at least one field in the packet that includes the Value token in the input modifiers section If the data contained in the conditional fields of a packet matches the Value specified for the field the packet is parsed and the data is output If the condition field Va ue does not match the incoming data then the processor moves on to the next Field Line until it reaches the end of the Fields section FIELD LINE FORMAT Each Field Line in the Fields Section has the keyword FIELDS followed by a series of individual Fields Individual fields in a packet are separated by commas A Field line in the Fields Section defines an entire packet from start to end and has the form Fields Freldi Field2 FieldNn You can also insert a string to be printed out at that location in the packet by using the string S operator before the string to be printed Below is an example of a field line with one string added between the fields Fields Fieldi String FieldN Each field will be output with a Label and a Value For String fields the Label is blank and the Value is the String FIELD FORMAT Each field in the Field L
227. valid data bits starting at the first clock detected Also choose what output format you want the traffic The bus traffic will be decoded as in the following screen 1 582292ms 1 982292ms 9 A9 FF FF FA E5 F D eA A Measurements E Xi x2 dx Ons 1 568833ms 2 170375ms 601 542us 70 USBee QX User s Manual SDIO BUS SETUP The SDIO Bus Decoder shows the captured data from an SDIO bus Command and Data lines Hardware Setup To use the Decoder you need to connect the USBee Test Pod to your hardware using the test leads You can either connect the test leads directly to pin headers on your board or use the test clips for attaching to your components The SDIO Bus Decoder uses any one of the 24 digital signal lines O thru 21 T and C for the CMD command CLK clock DATO DAT1 DAT2 DAT3 and the GND ground line Connect the CMD CLK and DATO DATS3 lines to your digital bus using the test leads and clips Connect the GND line to the digital ground of your system Software Setup You will want to make sure that the sample rate you have chosen is at least 4 times the CLK frequency in order to recover the bus data reliably So for a CLK with a frequency of 50MHz you need at least a sample rate of 200Msps Also remember that at sample rates above 100Msps the available channels is reduced Activate the below Channel Settings Dialog by clicking the grey tab on the left of the signal names on the main application screen
228. viewing Or you can export your captured data to files that you can work with Want to import your waveform data into Excel No problem Just export it as a comma separated file and it imports directly without modification Need the data in raw binary format We ve got that too USBee QX User s Manual 23 PACKETPRESENTER The USBee QX Suite adds the PacketPresenter feature that runs alongside of the existing bus decoders The PacketPresenter takes the output of raw binary data from the bus decoders and parses the stream according to users PacketPresenter Definition File for the intent of displaying the communications in easily understood graphical displays i USBee Suite Pro US x File View SpeedandSamples Trigger Setup Help GLO O O O O O O DOO U O lt lt lt 4us div 9 175667ms 9 179667ms 9 183667ms 9 187667ms 9 191667ms 9 195667ms 9 199667ms 9 203667ms RX RST RX IRQ RX nSS RX SCK x k mosi RX MISO SPL4 RX MOSI RX MISO RX XOUT RX PACTL TX ANT TXIRQ TX nss TX SCK USBee Suite Packet Presenter File Edit View Window e e e e e Layer CYPRESSRFAC Packet 1 Time 9 189167ms Layer CYPRESSRFIC Packet 2 Time 9 198833ms e e e m RIE SPI 11 TX MOSI TX MISO TX XOUT TX PACTE x x x x i Bus USBee Logic Analyzer Oscilloscope dX Period Frequency Duty Cycle 3 8 667us 115 384615kHz 96 2 yright 2009 CWAV Inc 24 USBee QX User s M
229. w only this USB endpoint number traffic e ShowAddress 999 show all USB devices otherwise only show the USB device with this USB address e DPlus Which signal 0 15 to use for the D Plus signal 192 USBee QX User s Manual e DMinus Which signal 0 15 to use for the D Minus signal e Speed 0 Low Speed USB 1 Full Speed USB Rate is as follows 69 600 Msps O 39 300 Msps O 29 200 Msps O 108 100 Msps O 58 50 Msps O 28 20 Msps O 107 10 Msps O 57 5 Msps O 27 2Msps O 106 1 Msps O 56 500ksps O 26 200ksps O 105 100ksps SOF 0 do not show the SOF Start of Frames 1 show SOFs Delimeter 0 no delimiter 1 Comma delimeter 2 Space delimeter e Showall 0 Only show the data payload 1 show all packet details e Hex 0 display data in decimal 1 display data in hex ProtocolDefinitionFilename filename for the Protocol Definition File to use to create a PacketPresenter file If this value is O then the PacketPresenter feature is turned off e ProtocolOutputFilename filename that is created for the output of the PacketPresenter e ErrorString string that holds an error description of the routine returns an error Return Value TRUE No Error during processing e FALSE Error while processing The ErrorString contains a description of the error to present to the user USBee QX User s Manual 193 _DECODESPI This routine decodes b
230. want to use our Custom Decoder on this waveline We are also passing the text string helloworld to the decoder when it runs Channel Settings a Single Signal __psr2 Parallel Tef Custom Protocol Parameters helloworld When we press Save our Decoder is run passing the parameters to it and the resulting waveline bubbles or Entries are displayed Below is the output from our VERY simple Hello World decoder which puts a Hello World at the first sample USBee QX User s Manual 83 z m USBee Suite USBee SX Demo Mode viii Digitalo E Bus ffelloworld DW Hello World A Digital 2 DIGIE Digital 4 Digital 5 DIERA Digital 7 Demo A Measurements T Xi X2 dX dX i Frequency Duty Cycle Be Ons Ons Ons Ons infinity 1Jns 24 0MHz 104857500 Copyright On a different Waveline you can specify a different set of Parameters in this case change 3 that indicate to the Custom Decoder to perform an entirely different decode Custom Protocol Parameters change 3 S As in our example decoder this Change indicates to place an Entry at each change of state of the specified signal in this case 3 The resulting display is as follows 84 USBee QX User s Manual 597 583us 592 583us 587 583us 582 583us Use Ss Ue eH EREE i E IEE x x x x x x x x Ghange 3 Changed 9 Teer D Chani Cursors j
231. ween adjacent samples With this mode turned off the samples are shown simply as dots on the display at the sample position You can toggle this setting using the menu item View Vector based Waveforms The Persist mode does not clear the display and writes one trace on top of the other trace You can toggle this setting using the menu item View Waveform Persistence The benefits of these display modes can be seen when you are measuring fast signals and want to get more resolution out of the oscilloscope than the maximum sample rate allows See the below traces to see the difference Each trace is taken of the same signal but the second one shows much more wave detail over a short time of display updates USBee QX User s Manual 117 eea a USBee Suite Pro USBee DX Connected File View SpeedandSamples Trigger Setup Help 166 7ns diy 157 s 250ns Cursors USBee capture many aMn Logic Analyzer Oscilloscope T X X2 dX JAX Period Frequency Duty Cycle Ons Ons Ons Ons infinity Ons infinity Persist OFF Vectors ON Wide ON na USBee Suite Pro USBee DX Connected File View Speed and Samples Trigger Setup Help lt 208 3ns div 333 375 i 291 7ns USBee Capture once Logic Analyzer Oscilloscope dX 1 dX Period Frequency Duty Cycle T X2 Ons Ons Ons Ons infinity Ons infinity Persist ON Vectors OFF Wide ON 118 USBee QX User s Manual
232. xecuted these decoders may reduce enlarge or keep constant the number of bits in the data stream The following examples are intended to show how these streams can be shortened lengthened or modified Useful decoders will need to have the appropriate algorithms to compute the true values of the output bits LOOPBACK DECODER This Add In simply loops back the data out in CWAV_EXPORT unsigned int CWAV_API APIDecode char Protocol char bitIn char bitsOut char reset This will be the Add In routine that is called by the PacketPresenter when the ADDIN keyword is used in the DECODE section of the PacketPresenter Definition File This routine is called for each bit of data in a data packet The parameter reset is set to a 1 for the first bit of a packet and 0 for all bits following The next bit from the stream is passed in using the parameter bitIn 1 or 0 After your code decodes the stream you can either send back no data return value of 0 or send new bits back using the bitOut pointer one bit per char and a return value of the number of bits returned The default Add In routine is simply is a pass through so that the output data stream equals the input data stream Start with this library source code to add your custom decoding bitsOut bitIn return 1 Indicates that there is 1 return data b

Choose what sample depth you would likekeeping in mind

Contents

Download Pdf Manuals

Related Search

Related Contents