Teledyne-lecroy PETrainer Scripting Language Reference Manual Uživatelský manuál Strana 1

Protocol Solutions Group 3385 Scott Blvd., Santa Clara, CA 95054 Tel: +1/408.727.6600 Fax: +1/408.727.6622 PETrainer™ Scripting L

Teledyne LeCroy PETrainer Scripting Language 5 Parameter Values Default Value Comment Payload (XXXX,XXXX,…) Incr Random Zeros Ones Specified as

Teledyne LeCroy PETrainer Scripting Language 6 Parameter Values Default Value Comment AutoIncrementAddress Yes No No This parameter is supported

Teledyne LeCroy PETrainer Scripting Language 7 Example 2: Read 32 DWORDs of data starting from address 0x1000. PSN would accept values 0 for fi

Teledyne LeCroy PETrainer Scripting Language 8 Example 5: This example shows how to specify reserved fields in the TLP header using the Field p

Teledyne LeCroy PETrainer Scripting Language 9 3.1.1 TLPType = MRd32, MRdlk32, MWr32 Parameter Value Default Comment LastDwBe 0:15 0 Byte 7 in

Teledyne LeCroy PETrainer Scripting Language 10 3.1.2 TLPType = MRd64, MRdLk64, MWr64 Parameter Value Default Comment LastDwBe 0:15 0 Byte 7 i

Teledyne LeCroy PETrainer Scripting Language 11 3.1.3 TLPType = IoRd, IoWr Parameter Value Default Comment LastDwBe 0:15 0 Byte 7 in the TLP h

Teledyne LeCroy PETrainer Scripting Language 12 3.1.4 TLPType = Cfgrd0, Cfgwr0, Cfgrd1, Cfgwr1 Parameter Value Default Comment LastDwBe 0:15 0

Teledyne LeCroy PETrainer Scripting Language 13 3.1.5 TLPType = Msg, Msgd Parameter Value Default Comment MessageRoute ToRootComplex ByAddress

Teledyne LeCroy PETrainer Scripting Language 14 Example 1: This example shows how to send a PME_Turn_Off Power Management Message while emulati

Teledyne LeCroy PETrainer Scripting Language ii Document Disclaimer The information contained in this document has been carefully checked and is

Teledyne LeCroy PETrainer Scripting Language 15 3.1.6 TLPType = Cpl, CplLk, CplD, CplDLk Parameter Value Default Comment CompleterId (XX:XX:X)

Teledyne LeCroy PETrainer Scripting Language 16 Example 2: This example shows how to send a Completion with Data TLP. This Completion TLP retur

Teledyne LeCroy PETrainer Scripting Language 17 3.1.7 TLP Field or Payload Substitution (For Summit Z2-16 and Summit Z3-16 Trainers only) Wh

Teledyne LeCroy PETrainer Scripting Language 18 Address = ( FROM_MEM32_A, 32 ) The system takes the value of the Address field from the Mem32 A

Teledyne LeCroy PETrainer Scripting Language 19 3.2 Packet = DLLP This command initiates transmission of DLLP packets on the bus. Parameters f

Teledyne LeCroy PETrainer Scripting Language 20 Example 1: This example shows how to send a PM_Active_State_Request_L1 power management DLLP. T

Teledyne LeCroy PETrainer Scripting Language 21 3.2.1 DLLPType = Ack, Nak Parameter Values Default Comment AckNak_SeqNum 0:4095 0 Bytes 2-3 in

Teledyne LeCroy PETrainer Scripting Language 22 3.2.2 DLLPType = InitFC1_P, InitFC1_NP, InitFC1_Cpl, InitFC2_P, InitFC2_NP, InitFC2_Cpl, Update

Teledyne LeCroy PETrainer Scripting Language 23 3.2.3 DLLPType = Vendor Parameter Values Default Comment Data 0x000000:0xFFFFFF 0 Vendor speci

Teledyne LeCroy PETrainer Scripting Language 24 3.3 Packet = OrderedSet This command initiates transmission of ordered set on the bus. Parame

Teledyne LeCroy PETrainer Scripting Language iii Contents 1 Introduction... 1 1

Teledyne LeCroy PETrainer Scripting Language 25 3.3.1 SetType = TS1, TS2 Parameter Values Default Comment LinkNumber 0:255, PAD PAD Link Numbe

Teledyne LeCroy PETrainer Scripting Language 26 Example 1: The following example sends a TS1 ordered set. N_FTS is equal to 255 for all lanes.

Teledyne LeCroy PETrainer Scripting Language 27 Example 4: The following example sends a TS2 ordered set. N_FTS is equal to 255 for all lanes.

Teledyne LeCroy PETrainer Scripting Language 28 3.3.2 SetType = Skip Parameter Values Default Comment SkipCount 0:5 3 Number of SKIP symbols t

Teledyne LeCroy PETrainer Scripting Language 29 3.4 Packet = Raw This command initiates transmission of raw data on the bus. Parameter Values

Teledyne LeCroy PETrainer Scripting Language 30 3.5 Packet = <TemplateName> This command initiates transmission of the packet specified

Teledyne LeCroy PETrainer Scripting Language 31 4 Idle Command This command sends idle symbols (D0.0) for the time specified. Example: The f

Teledyne LeCroy PETrainer Scripting Language 32 5 Link Command All of these commands, with the exception of Link = InitFC, are controls to the

Teledyne LeCroy PETrainer Scripting Language 33 Note: Command supported only by Z3 Trainer. 5.8 Link = Detect Tells the PETrainer™ to immediat

Teledyne LeCroy PETrainer Scripting Language 34 5.15 Link = 5_0 Initiates speed switch to 5.0 GT/s data rate. The system attempts to switch if t

Teledyne LeCroy PETrainer Scripting Language iv 5.15 Link = 5_0 ... 34 5.16

Teledyne LeCroy PETrainer Scripting Language 35 6 Config Command This command configures the PETrainer™. 6.1 Config = General This command

Teledyne LeCroy PETrainer Scripting Language 36 Example 1: The following example configures PETrainer to generate traffic on an x4 link (LinkWi

Teledyne LeCroy PETrainer Scripting Language 37 6.2 Config = FCTx This command allows you to specify the policy for TLP transmission for recei

Teledyne LeCroy PETrainer Scripting Language 38 6.3 Config = FCRx This command configures automatic UpdateFC DLLP generation. Parameter Value

Teledyne LeCroy PETrainer Scripting Language 39 6.4 Config = TLP This command facilitates data integrity control. Parameter Values Default Co

Teledyne LeCroy PETrainer Scripting Language 40 6.5 Config = AckNak Parameter Values Default Comment AckNak Auto, Ack, Nak, Disable For Summ

Teledyne LeCroy PETrainer Scripting Language 41 This example shows how to configure the PETrainer to NAK only one incoming TLP packet: Config=A

Teledyne LeCroy PETrainer Scripting Language 42 6.6 Config = Transactions This command determines the behavior of PETrainer as it responds to

Teledyne LeCroy PETrainer Scripting Language 43 Config = Transactions { AutoCfgCompletion = Yes ; Automatically complete Configuration TLP reque

Teledyne LeCroy PETrainer Scripting Language 44 6.8 Config = Definitions Parameter Values Default Comment Any literal Any integer, string, pay

Teledyne LeCroy PETrainer Scripting Language v 15 Structure Command ... 75 15.1 Command Paramet

Teledyne LeCroy PETrainer Scripting Language 45 Example 2: This example shows how to use definitions in the expressions (see Page 65) and how t

Teledyne LeCroy PETrainer Scripting Language 46 6.9 Config = SendInterrupt This command is only valid for Device Emulation and allows initiati

Teledyne LeCroy PETrainer Scripting Language 47 6.10 Config = NVMe This command is only valid for Device Emulation. It starts and configures N

Teledyne LeCroy PETrainer Scripting Language 48 6.11 Config = NVMeDriveErrorInjection This command is only valid for Device Emulation. It confi

Teledyne LeCroy PETrainer Scripting Language 49 CMD_ACTION_DROP_CMD N/A Applies to NVMe commands: - Don’t read and execute the command upon

Teledyne LeCroy PETrainer Scripting Language 50 7 Wait Command This command yields script execution until condition specified is true or timeo

Teledyne LeCroy PETrainer Scripting Language 51 Wait = DLLP This command waits for a DLLP that matches the defined condition. All parameters fr

Teledyne LeCroy PETrainer Scripting Language 52 Wait = Error Parameter Values Default Comment Errors DLLPCRC TLPLCRC Delimiter Disparity Symbol

Teledyne LeCroy PETrainer Scripting Language 53 7.2 Wait = LinkCondition Parameter Values Default Comment Conditions SKIP IDLE TS1 TS2 FTS PAT

Teledyne LeCroy PETrainer Scripting Language 54 7.3 Wait = Payload This command waits for TLP payload match. Parameter Values Default Comment

Teledyne LeCroy PETrainer Scripting Language 1 1 Introduction This manual describes the scripting language used to create traffic generation fi

Teledyne LeCroy PETrainer Scripting Language 55 Example 3: The following example can be executed only on PETrainer EML. This command waits fo

Teledyne LeCroy PETrainer Scripting Language 56 7.4 Wait = User This command waits for user input. The script execution would continue when us

Teledyne LeCroy PETrainer Scripting Language 57 7.5 Wait = FastTransmitIdle Note: This command is available only for the Summit Z2-16 and Summ

Teledyne LeCroy PETrainer Scripting Language 58 7.6 Additional “Wait” Modifiers 1. Wait = <number> Unconditionally yields script execu

Teledyne LeCroy PETrainer Scripting Language 59 8 Branch Command This command enables/disables the branch procedure for the condition specifie

Teledyne LeCroy PETrainer Scripting Language 60 Example: ... Proc = Begin { ProcName = “Procedure1” } ... Proc = End ; The following stat

Teledyne LeCroy PETrainer Scripting Language 61 8.2 Branch = Disable This command disables the branch procedure that was previously enabled.

Teledyne LeCroy PETrainer Scripting Language 62 9 Proc Command This command declares the procedure to be executed for the Branch command. Proc

Teledyne LeCroy PETrainer Scripting Language 63 10 Loop Command This command causes the PETrainer™ BusEngine™ to re-execute a block of command

Teledyne LeCroy PETrainer Scripting Language 64 11 Repeat Command This command causes one or more commands to be repeated. This is not impleme

Teledyne LeCroy PETrainer Scripting Language 2 2 Command List COMMAND MODIFIERS Comment Packet TLP, DLLP, OrderedSet, Raw, <TemplateNam

Teledyne LeCroy PETrainer Scripting Language 65 11.1 Repeat = Begin This command marks the beginning of the code being repeated. Parameter Val

Teledyne LeCroy PETrainer Scripting Language 66 Example 2: The following example shows the usage of the counters in nested repeats. The count

Teledyne LeCroy PETrainer Scripting Language 67 repeat = End This command marks the end of the code being repeated. Example: Repeat = Begi

Teledyne LeCroy PETrainer Scripting Language 68 12 Template Command This command creates a template for a packet that can be used in the Packe

Teledyne LeCroy PETrainer Scripting Language 69 Example 2: The following example shows nested templates (i.e. when one template is based on ano

Teledyne LeCroy PETrainer Scripting Language 70 13 Include Command This command includes the PETrainer™ script file inline. All commands in th

Teledyne LeCroy PETrainer Scripting Language 71 14 AddressSpace Command This command reads/writes the PETrainer™ memory region. PETrainer map

Teledyne LeCroy PETrainer Scripting Language 72 14.1 AddressSpace = Read This command reads specified memory region from PETrainer and stores i

Teledyne LeCroy PETrainer Scripting Language 73 14.2 AddressSpace = Write This command writes specified memory region into PETrainer from speci

Teledyne LeCroy PETrainer Scripting Language 74 Example 2: This command writes 16 bytes, starting from address 0x1000, into the Mem64 memory re

Teledyne LeCroy PETrainer Scripting Language 3 3 Packet Command This command initiates transmission of a specified packet on the bus. 3.1 Pa

Teledyne LeCroy PETrainer Scripting Language 75 15 Structure Command This command writes the PETrainer™ memory region, allowing you to specify

Teledyne LeCroy PETrainer Scripting Language 76 Structure=NVMe { Location=Mem64 Offset = 0x1000 NVMeStructType = NVMCommand O

Teledyne LeCroy PETrainer Scripting Language 77 Location=Mem64 Offset = 0x1080 AhciStructType=PRDT DBA = 0x3F3B2048 DBAU =

Teledyne LeCroy PETrainer Scripting Language 78 15.2 Creating Errors in Structures There are several ways of inserting various errors in the N

Teledyne LeCroy PETrainer Scripting Language 79 16 FastTransmit Engine Commands Note: The commands in this section are available only for the

Teledyne LeCroy PETrainer Scripting Language 80 16.1.1 FastTransmit = Setup Begins the definition section of a FastTransmit block. 16.1.2 Fas

Teledyne LeCroy PETrainer Scripting Language 81 16.2 Send Command A Send command defines a sequence of high-performance packets to send once, a

Teledyne LeCroy PETrainer Scripting Language 82 Parameter Values Default Value Comment PayloadGrowth FixedByte FixedDWord IncrementByte Increme

Teledyne LeCroy PETrainer Scripting Language 83 16.2.1 Send = MRd32/MWr32 Parameter Value Default Comment Address 0x00000000: 0xFFFFFFFF 0 Byte

Teledyne LeCroy PETrainer Scripting Language 84 How to Contact Teledyne LeCroy Type of Service Contact Call for technical support US and Canada

Teledyne LeCroy PETrainer Scripting Language 4 Parameter Values Default Value Comment Snoop 0 indicates that hardware enforced cache coherency i