Teledyne-lecroy User-Defined Decoding (UDD) Advanced Script Langua Manuel d'utilisateur

PROTOCOL SOLUTIONS GROUP 3385 SCOTT BLVD. SANTA CLARA, CA 95054 User-Defined Decoding (UDD) Advanced Script Language (ASL) Reference Manu

7 Expression Structure An expression can be a combination of: o Logical and compare operators ( or ,and ,not, >, <, <>, =) o Arithmet

8 Advanced Script Language Programming A script contains three required sections, with only one of each type: o Product Section: Indicates the prod

9 Protocol Decoding Section [Decoding] Define Options Block Valid Ranges Block Main Block End As specified above, th

10 Valid Ranges Block ValidRanges fieldId 1 = ( Value1 , Value2 ); fieldId 2 = ( Value1 , Value2 ); ... EndValidRanges Remark This statement s

11 Main Block Main block contains statements. Block { Statement 1 ; Statement 2 ; Statement 3 ; … } ASL Decoding Statements Below

12 BitStuff BitStuff ( FieldId , n ) Remark If, in a protocol, one field transfers after bitstaffing algorithm, you can see actual value of that f

13 If If Expression Then Block1 Else If Expression Then Block2 Else If Expression Then Block3 Else Block4 R

14 Repeat Repeat Expression Block Remark This statement repeats all commands in block until Expression is TRUE. Example F1 = AddField

15 SubFieldOf SubFieldOf (FiledId [, Separeted]) Block Remark This statement specifies subfields of a specific field. Note that all AddField state

16 SetTableHeader SetTableHeader(string); SetTableHeader(OptionalFieldId); Remark This statement sets table header of interpreted data. Viewer sho

ii Document Disclaimer The information contained in this document has been carefully checked and is believed to be reliable. However, no responsibili

17 SetFieldTableHeader SetFieldTableHeader(FieldId, string); SetFieldTableHeader(FieldId, OptionalFieldId); Remark If you specify that subfields o

18 Functions LengthOf ( Data ) Remark This function returns the length of Data. Parameters Data can be INPUTDATA or can be DataId of a data segm

19 CURPOS Remark This function returns the current position of the cursor in bits of INPUTDATA. At first, CURPOS is zero and increases one field’s

20 Protocol Extraction Section The Protocol Extraction section specifies how the data is extracted from traffic to one or more endpoints. This sect

21 UDD Scripts Can Decode More Than One Command UDD scripts can decode more than one command, so it is not necessary to run more than one script at

22 ATAPI User-Defined Decoding Assigning a Script to ATAPI Commands Open a sample, then choose User defined decoding … from the Configuration pull-

23 The UDD ATAPI command can have one or more additional fields. In the following example, the UDD ATAPI command has four fields with a specific len

24 Assigning a UDD Script and Setting It as Default Script You can specify UDD items using two methods. Software User-Defined Decoding In this mode

25 Sample User Defined Decoding In this mode, you can set UDD items for the current active sample file. Changes only apply to that sample file. Wh

iii Table of Contents ASL MANUAL ...

1 ASL Manual This manual describes Advanced Script Language (ASL) for defining protocol decodes. It has sample code, documentation, and examples. I

2 User-Defined Commands User-defined commands help you add additional decoding to viewer. For example, if you have a new command with a vendor opcod

3 If application sees any syntax error in the script file, the software adds an Error In Script field to the command. The application also adds a

4 The next figure displays a trace file that contains a command with opcode 0x99. The software shows "unknown command" in the viewer

5 You can go to the Configuration > User Defined Decoding menu, check SCSI command, click browse, go to the \Examples\User Define Decoding Script

6 Language Elements Integers ASL accepts integer values in decimal, binary, or hexadecimal formats. Floating point and negative numbers are not ac