Teledyne LeCroy USBTracer_Trainer - Users Manual - Manual (Page 315)

USB Protocol Suite User Manual Chapter 11: Traffic Generation (2.0)
LeCroy Corporation
301
Packet Starting Keys
pid
8 bits (0-0xFF)
or
pid string Host Generation Only.
Use this as the first key of most packets sent by the
Host (Exception: Use frame= for SOF packets).
The key should be assigned to a valid packet
identifier string per the USB specification: SETUP, IN,
OUT, DATA0, DATA1, ACK, PRE, PING, SPLIT,
DATA2, MDATA, EXT, or LPM.
Optionally, you may assign this key a raw eight bit
value to force an error condition.
Warning: If you specify PID=0xNN, you must use
raw_data=( ) to specify the rest of the packet data,
because the packet structure is unknown.
expected_pid pid string Host Generation Only.
Use this as the PID key for packets which are
expected to be sent by the device.
In IntelliFrame mode, the generator waits until this
PID has completed before sending the next
generated packet or bus condition.
The key should be assigned to a valid packet
identifier string per the USB specification: DATA0,
DATA1, ACK, NAK, STALL, NYET, DATA2, MDATA,
EXT, or LPM.
The generator engine waits forever until this
expected_pid appears, so the user may have to
hand edit the file to achieve the desired results.
For example, if a NAK comes where the
expected_pid was a DATA1, the user should edit the
.utg file to move the pid=IN command to later in the
file by inserting some frame=AUTO idle=TO_EOF
pairs before it. This allows time for the device to be
ready for the IN.
If RETRY=TRUE for this address/endpoint, the NAKs
are ignored and the SOF's are generated
automatically until the expected PID occurs.
device_pid pid string Use this as the first key of most packets sent by a
device.
The key should be assigned to a valid packet
identifier string per the USB specification: DATA0,
DATA1, ACK, NAK, STALL, NYET, DATA2, MDATA,
EXT, or LPM.
Normally, the device_pid= statement is NOT present
in a Host Generation .utg file, because the device
responses are intended to come from real devices. By
default, Host Generation files exported from Trace
Files do NOT include device_pid= statements.
Warning: If you specify PID=0xNN, you must use
raw_data=( ) to specify the rest of the packet data,
because the packet structure is unknown.
Key Code Format Description