beautypg.com

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

Page 40

background image


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

Connecting to the Board 40

Finalize initialization by calling “InitializeSystem ()”.

Call the InitializeSystem function of the SAS General Service object in the main class. Set the

parameter to the path of your SAS/SATA Protocol Suite or STX software.
(Refer to TestCaptureProject -> TestCaptureProject.cpp -> InitInstance ().)

m_pIGeneralSrvPtr->InitializeSystem (bstrCurrentDir)
[can be a NULL string also]

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, you must know three parameters:

Connection Type (yConnectionType): Connection type can be either USB or TCP. The

values for this parameter can be specified using pre-defined constants
(APIHeader.h), such as 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. This parameter is Variant, and so it needs a
conversion from string form of Device Id to Variant. This conversion can be done
using:
AfxConvertStringArrayToVariant (&vDeviceId,

astrDeviceId);