Teledyne LeCroy Sierra SAS_SATA Protocol Analyzer STX API Reference Manual - Manual (Page 93)

Sierra SAS/SATA Protocol Suite, STX Software API Reference Manual
Using Initiator/Host Emulator API Functions 93
After setting the Incoming error attributes, start setting Error Injection on each of the InComing
frame options, such as Handshake Errors and Defer Handshake After.
Both of the options have their respective method calls for Error Injection:
InComing Frame Error Injection
Options
Function Name
Handshake Errors ErInjSetHandshakeError ()
Defer handshake After ErInjSetSendDelayToSendHandshake
()
Example
m_pIInitiatorExerciserErrorInjection->ErInjSetHandshakeError (
iLayerID, nCommandIndex, eHandshakeTypeError,
m_ePrimitveTypeGroup, NULL, &nErrorCode);
CExerciserEngine::SetInComingErrorAttribute ()
Prototype
HRESULT SetInComingErrorAttribute (short iLayerId, int nPacketIndexInLayer,
BOOL bEnable, int nFrameType, short iFrameNumberInCommand,
int *pnErrorCode);
Usage -> SetInComingErrorAttribute
(, ,
, ,
);
Inputs Short iLayerId: layer ID of the packet
Int nPacketIndexInLayer: Index of the packet in layer
BOOL bEnable: Specifies whether to enable error injection on incoming frame
or not
Int nFrameType: Type of the frame to set error injection
Short iFrameNumberInCommand: Number of the frame in command list
Return Value Returns success/ failure status of the method in the form of an error code
Description Call SetInComingErrorAttribute () of Exerciser Engine to set all required
parameters before setting Error Injection for individual InComing frame
options.
Below are the prototypes for each of the function corresponding to every option of Error
Injection on an InComing Frame