Teledyne LeCroy USB Script Decode Manual - Manual (Page 7)

1
C HAPTER 1
CATC Scripting Language for USB Introduction
C
HAPTER
1: I
NTRODUCTION
CATC Scripting Language (CSL) was developed to create scripts that would allow
users to do file-based decoding with CATC USBTracer, USBMobile, and USBAd-
visor analyzers. CSL is used to edit CATC Decode Scripting (CDS) files. CATC
analyzers are equipped with built-in decoders in addition to script-based decoders
that can be modified by the users or implemented as-is. Decoding scripts for
analyzers are distributed in the /scripts directory. These scripts are tools to
decode and display transactions. Users can also add entirely new, customized
decoders.
Included with the CATC USBTracer Protocol Analyzer are USB decoder scripts for
many of the USB classes, as described in the USB specification. They are located
in the USBTracer\Scripts directory and are identifiable by the .dec and .inc exten-
sions. These scripts are tools to decode and display transactions. Users can also
add entirely new, customized decoders to fit their own, specific development needs.
USBTracer looks in the \Scripts directory and automatically loads all of the .dec
files that it finds. To prevent a particular decoder from being loaded, changed its
extension to something other than .dec or move it out of the \Scripts directory.
CSL is based on C language syntax, so anyone with a C programming background
will have no trouble learning CSL. The simple, yet powerful, structure of CSL also
enables less experienced users to easily acquire the basic knowledge needed to start
writing custom scripts.
Features of CATC Scripting Language
• Powerful -- provides a high-level API while simultaneously allowing
implementation of complex algorithms.
• Easy to learn and use -- has a simple but effective syntax.
• Self-contained -- needs no external tools to run scripts.
•
Wide range of value types -- provides efficient and easy processing of data.
• Used to create built-in script-based decoders for analyzers.
• May be used to write custom decoders.
• General purpose -- is integrated in a number of CATC products.