beautypg.com

Connecting to the board, Connect to the board, Start trainer – Teledyne LeCroy Sierra SAS_SATA Protocol Analyzer STX API Reference Manual User Manual

Page 143

background image


Sierra SAS/SATA Protocol Suite, STX Software API Reference Manual

Using Trainer 143

CSASGeneralService::InitializeSystem ()
Prototype

BOOL InitializeSystem (BSTR bstrCurrentDirectory);

Usage

BOOL bIsInitialized = ->

InitializeSystem ();

Inputs

Current Directory String in BSTR format

Return Value BOOL (success/failure in terms of system initialization)
Description

Call the InitializeSystem () method to initialize the system at the specified

location.

Connecting to the Board

To connect to the board, use three parameters:

• Connection Type (yConnectionType):

CEI_CONNECTION_USB or CEI_CONNECTION_TCP.

• Device Id (vDeviceId): Device identification number of the board found on the label of

the Teledyne LeCroy hardware.

• Product Type (eProductType): An enumeration that specifies PROJECT_TYPE_SAS for

SAS and PROJECT_TYPE_SATA for SATA

Connect to the board using the Attach () function of the SAS General Service Object. Call this

function with the above parameters, in the same order, in the InitInstance () function of the

main class of your application.
(Refer to TestTrainerAPI -> TestTrainerAPI.cpp -> InitInstance ().)
m_pIGeneralSrvPtr->Attach (yConnectionType, vDeviceId,
eProductType);

NOTE: For a detailed explanation of function prototypes, refer to Section 2.3 Connecting to

Board.