GpibLocal Procedure

Causes a specified GPIB device to switch into local mode of operation.

Syntax

[ lStatus = ] GpibLocal ( lBoardDevice )

The GpibLocal procedure syntax has the following parts:

 

Name

Type

Description

lStatus

Long

Status

lBoardDevice

Val Long

Board to Device address

Comments

This function causes the specified device to obey commands from its front panel control switches by performing the Go To Local GPIB function (GTL). If lBoardDevice specifies only a board address, the Remote Enable (REN) line is de-asserted, placing all devices connected in local mode.

The hexadecimal format of lBoardDevice should be as follows:

lBoardDevice = 0xBBPPSS

Where:

 

BB

Board address (1 - 9)

PP

Device Primary address (0 - 31) - 0 if not used (bus address), 31 used for Primary address of 0

SS

Device Secondary address (0 - 31) - 0 if not used (bus address or device without Secondary address), 31 used for Secondary address of 0      

When PPSS is 0, lBoardDevice specifies a board address.

The value of lBoardDevice may be obtained using the GetDriverAddress function.

The function returns 0 on success and -1 on failure.

Example

The following command sets an oscilloscope into local mode:

GpibLocal(GetDriverAddress("SCOPE"))

See Also

GpibLLockout, GpibRemote