Teledyne-lecroy LeCroy Analyzers File Based Decoding Manual Manual do Utilizador

For Software Version 1.2June 2006PROTOCOL SOLUTIONS GROUP3385 SCOTT BLVDSANTA CLARA, CA 95054CATC Protocol AnalyzersFile-Based DecodingUser Manual

Chapter 2: Values File-based Decoding User Manual4 LeCroy CorporationEscape SequencesThese are the available escape sequences in CSL:ListsA list can h

File-based Decoding User Manual Chapter 2: ValuesLeCroy Corporation 52.2 VariablesVariables are used to store information, or data, that can be modif

Chapter 2: Values File-based Decoding User Manual6 LeCroy CorporationLocal VariablesLocal variables are not declared. Instead, they are created as nee

File-based Decoding User Manual Chapter 3: ExpressionsLeCroy Corporation 7Chapter 3: ExpressionsAn expression is a statement that calculates a value

Chapter 3: Expressions File-based Decoding User Manual8 LeCroy Corporation3.1 select expressionThe select expression selects the value to which it eva

File-based Decoding User Manual Chapter 4: OperatorsLeCroy Corporation 9Chapter 4: OperatorsAn operator is a symbol that represents an action, such

Chapter 4: Operators File-based Decoding User Manual10 LeCroy CorporationWhen operators of equal precedence occur in an expression, the operands are e

File-based Decoding User Manual Chapter 4: OperatorsLeCroy Corporation 11Operator Symbol Description Operand TypesResult Types ExamplesIndex Operator

Chapter 4: Operators File-based Decoding User Manual12 LeCroy CorporationEquality Operators== Equal Integer-integer Integer 2 == 2String-string Intege

File-based Decoding User Manual Chapter 4: OperatorsLeCroy Corporation 13Bitwise Logical Operators~ Bitwise complementInteger-integer Integer ~0b1111

Document Disclaimer File-based Decoding User ManualLeCroy CorporationDocument DisclaimerThe information in this document has been carefully checked a

Chapter 4: Operators File-based Decoding User Manual14 LeCroy CorporationAssignment Operators (continued)&= Bitwise AND assignmentInteger-integer

File-based Decoding User Manual Chapter 4: OperatorsLeCroy Corporation 15more() Returns a non-zero value if the list iterator did not reach the bound

Chapter 4: Operators File-based Decoding User Manual16 LeCroy Corporation

File-based Decoding User Manual Chapter 5: CommentsLeCroy Corporation 17Chapter 5: CommentsComments may be inserted into scripts as a way of documen

Chapter 5: Comments File-based Decoding User Manual18 LeCroy Corporation

File-based Decoding User Manual Chapter 6: KeywordsLeCroy Corporation 19Chapter 6: KeywordsKeywords are reserved words that have special meanings wi

Chapter 6: Keywords File-based Decoding User Manual20 LeCroy Corporation

File-based Decoding User Manual Chapter 7: StatementsLeCroy Corporation 21Chapter 7: StatementsStatements are the building blocks of a program. A pr

Chapter 7: Statements File-based Decoding User Manual22 LeCroy Corporation7.4 while StatementsA while statement is written aswhile <expression>

File-based Decoding User Manual Chapter 7: StatementsLeCroy Corporation 237.5 for StatementsA for statement takes the form: for (<expression1>;

File-based Decoding User Manual Table of ContentsLeCroy Corporation iiiTABLE OF CONTENTSChapter 1 Introduction 11.1 Features of CATC Scripting Langu

Chapter 7: Statements File-based Decoding User Manual24 LeCroy Corporation7.6 return StatementsEvery function returns a value, which is usually design

File-based Decoding User Manual Chapter 7: StatementsLeCroy Corporation 25because the if statement evaluates to false. This causes the first return s

Chapter 7: Statements File-based Decoding User Manual26 LeCroy Corporation

File-based Decoding User Manual Chapter 8: PreprocessingLeCroy Corporation 27Chapter 8: PreprocessingThe preprocessing command %include can be used

Chapter 8: Preprocessing File-based Decoding User Manual28 LeCroy Corporation

File-based Decoding User Manual Chapter 9: ContextLeCroy Corporation 29Chapter 9: ContextThe context is the mechanism by which transaction data is p

Chapter 9: Context File-based Decoding User Manual30 LeCroy Corporation

File-based Decoding User Manual Chapter 10: FunctionsLeCroy Corporation 31Chapter 10: FunctionsA function is a named statement or a group of stateme

Chapter 10: Functions File-based Decoding User Manual32 LeCroy CorporationAll parameters are passed by value, not by reference, and can be changed in

File-based Decoding User Manual Chapter 11: PrimitivesLeCroy Corporation 33Chapter 11: PrimitivesPrimitive functions are called similarly to regular

Table of Contents File-based Decoding User Manualiv LeCroy CorporationModule Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Chapter 11: Primitives File-based Decoding User Manual34 LeCroy CorporationFormat()Format (<format string>, <value string or integer>)Supp

File-based Decoding User Manual Chapter 11: PrimitivesLeCroy Corporation 35Format Conversion CharactersThese are the format conversion characters use

Chapter 11: Primitives File-based Decoding User Manual36 LeCroy CorporationFormatEx()FormatEx (<format_string string>, <arg_list list>)Sup

File-based Decoding User Manual Chapter 11: PrimitivesLeCroy Corporation 37Format Conversion Characters These are the format conversion characters us

Chapter 11: Primitives File-based Decoding User Manual38 LeCroy CorporationResolve()Resolve( <symbol_name string> )SupportSupported by all LeCro

File-based Decoding User Manual Chapter 11: PrimitivesLeCroy Corporation 39Trace()Trace( <arg1 any>, <arg2 any>, ...)Return valueNone.Com

Chapter 11: Primitives File-based Decoding User Manual40 LeCroy Corporation11.2 Data Manipulation PrimitivesGetBitOffset()GetBitOffset() SupportSuppor

File-based Decoding User Manual Chapter 11: PrimitivesLeCroy Corporation 41GetNBits()GetNBits (<bit_source list or raw>, <bit_offs

Chapter 11: Primitives File-based Decoding User Manual42 LeCroy CorporationNextNBits()NextNBits (<bit_count integer>)SupportSupported by all LeC

File-based Decoding User Manual Chapter 11: PrimitivesLeCroy Corporation 43PeekNBits()PeekNBits(<bit_count integer>) SupportSupported by all Le

File-based Decoding User Manual List of FiguresLeCroy Corporation vLIST OF FIGURESExecution of a for Statement . . . . . . . . . . . . . . . . . .

Chapter 11: Primitives File-based Decoding User Manual44 LeCroy Corporation11.3 List Manipulation PrimitivesRemoveAt()RemoveAt( <list_object list,

File-based Decoding User Manual Chapter 11: PrimitivesLeCroy Corporation 45SetAt()RemoveAt( <list_object list, index integer> )SupportSupported

Chapter 11: Primitives File-based Decoding User Manual46 LeCroy Corporation11.4 Transaction Decoder PrimitivesAbort()Abort()SupportSupported by Blueto

File-based Decoding User Manual Chapter 11: PrimitivesLeCroy Corporation 47AddEvent()AddEvent(<Group string>, <Value string> ) SupportSup

Chapter 11: Primitives File-based Decoding User Manual48 LeCroy CorporationComplete()Complete()SupportSupported by Bluetooth and Firewire analyzers on

File-based Decoding User Manual Chapter 11: PrimitivesLeCroy Corporation 49Pending()Pending()SupportSupported by Bluetooth and Firewire analyzers onl

Chapter 11: Primitives File-based Decoding User Manual50 LeCroy CorporationReject()Reject()SupportSupported by Bluetooth and Firewire analyzers only.R

File-based Decoding User Manual Chapter 11: PrimitivesLeCroy Corporation 5111.5 Display PrimitivesAddCell()AddCell(<name string>, <value str

Chapter 11: Primitives File-based Decoding User Manual52 LeCroy CorporationExample# Create a regular cell named Normal with a value "Cell" a

File-based Decoding User Manual Chapter 11: PrimitivesLeCroy Corporation 53AddDataCell()AddDataCell(<data_value raw, list or integer>, <addi

List of Tables File-based Decoding User Manualvi LeCroy CorporationLIST OF TABLESTable 2.1 Examples of String Literals . . . . . . . . . . . . . . .

Chapter 11: Primitives File-based Decoding User Manual54 LeCroy CorporationThe output of the example is: Figure 2: Example: Output for AddDataCell

File-based Decoding User Manual Chapter 11: PrimitivesLeCroy Corporation 55AddSeparator()AddSeparator(<additional_info any>, ...)SupportSupport

Chapter 11: Primitives File-based Decoding User Manual56 LeCroy CorporationBeginCellBlock()BeginCellBlock(<name string>, <value string>, &

File-based Decoding User Manual Chapter 11: PrimitivesLeCroy Corporation 57Example# Begin the 'red' group. For clarity these cells are red:

Chapter 11: Primitives File-based Decoding User Manual58 LeCroy CorporationThe output of the example is: Figure 4: Example: Output for BeginCellBlock

File-based Decoding User Manual Chapter 11: PrimitivesLeCroy Corporation 59EndCellBlock()EndCellBlock()SupportSupported by all LeCroy analyzers.Retur

Chapter 11: Primitives File-based Decoding User Manual60 LeCroy Corporation

File-based Decoding User Manual LeCroy Corporation 61Appendix A: PCI ExpressThe information in this appendix is specific to the PETracer™ analyzer.

File-based Decoding User Manual62 LeCroy Corporationcfg.decDescription: cfg.dec is a configuration data script decoder. Input Data Fieldsin.Data: Da

File-based Decoding User Manual LeCroy Corporation 63io.decDescription: io.dec is an IO data script decoder.Input Data Fieldsin.Data: Data block to

File-based Decoding User Manual Chapter 1: IntroductionLeCroy Corporation 1Chapter 1: IntroductionCATC Scripting Language (CSL) was developed to cre

File-based Decoding User Manual64 LeCroy Corporationmem.decDescription: mem.dec is a memory data script decoder.Input Data Fieldsin.Data: Data block

File-based Decoding User Manual LeCroy Corporation 65msg.decDescription: msg.dec is a message data script decoder.Input Data Fieldsin.Data: Data blo

File-based Decoding User Manual66 LeCroy Corporation• _TLP_MSGCODE_HP_POWER_IND_ON• _TLP_MSGCODE_HP_POWER_IND_BLINK• _TLP_MSGCODE_HP_POWER_IND_OFF•

File-based Decoding User Manual LeCroy Corporation 67Appendix B: BluetoothThe information in this appendix is specific to the Bluetooth analyzer. B

File-based Decoding User Manual68 LeCroy CorporationModule DataThere are several standard global variables that should be defined in a module which

File-based Decoding User Manual LeCroy Corporation 69DecoderDescOptional. A string that describes this decoder. Displays as a toolbar icon tool tip.

File-based Decoding User Manual70 LeCroy CorporationB.2 Input Context DataThe Merlin application decodes several layers of Bluetooth protocol and pr

File-based Decoding User Manual How to Contact LeCroyLeCroy Corporation 71How to Contact LeCroyLimited Hardware WarrantySo long as you or your autho

Limited Hardware Warranty File-based Decoding User Manual72 LeCroy CorporationWhat this Warranty Does Not CoverThis warranty does not cover damage du

File-based Decoding User Manual Limited Hardware WarrantyLeCroy Corporation 73How to Obtain Warranty ServiceTo request warranty service, you must co

Chapter 1: Introduction File-based Decoding User Manual2 LeCroy Corporation

Limited Hardware Warranty File-based Decoding User Manual74 LeCroy CorporationGeneral ProvisionsTHIS LIMITED WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS

File-based Decoding User Manual IndexLeCroy Corporation 75 IndexCCATC Technical Support 71EEmail CATC Support 71FFax number 71SServicemarks iiSupport

Index File-based Decoding User Manual76 LeCroy Corporation

File-based Decoding User Manual Chapter 2: ValuesLeCroy Corporation 3Chapter 2: ValuesThere are five value types that may be manipulated by a script