Teledyne LeCroy STX M6-1 SAS_SATA Protocol Analyzer User Manual - Manual (Page 394)

LeCroy Corporation Sierra Trainer Generation Language
392 Sierra M6‐4 SAS/SATA Protocol Analyzer User Manual
Sierra Trainer Generation Language
The Sierra Trainer File Generation Language is an API that allows you to separate traffic
into text commands. These commands are used construct primitives and frames that are
sent to the host or the device.
File Structure
Traffic Generation files (*.ssg) should have the following structure:
Declarations
 Global generation settings
 Constants
 Data patterns
 Chain of symbols (primitives, raw data)
 Packet templates
Note:
Some declared objects could be used in further declarations as long as they are previously
declared. No forward declarations are allowed at this time.
Generation Blocks
 List of generation instructions
Note: It is possible to create many generation blocks, but currently only a block with the name
'Generation' executes. (Calls of some blocks from another blocks are not currently allowed.)
Language
Comments
#' is the Comment symbol. The line remainder after this symbol is ignored.
/*' '*/' is a Comment Block. All the text between '/' '*' and '*' '/' is ignored.
/*
This is an example of a block of comments.
*/
Includes
The directive %include “FileName.inc” includes the file FileName.inc. This lets you add
common definitions and templates into new scripts.
The language parser makes sure the same file is not included more than once.
Example:
%include “SomeInc.inc”
# This directive actually includes file 'SomeInc_1.inc'.
%inline is the same as %include, but without the Language parser check.