Measurement-computing GPIB-488 Manuale Utente

GPIB-488GPIB-488 Programming Reference ManualProgramming Reference ManualJuly 2006371930C-01

GPIB-488 2-1 Programming Reference Manual2Programming with the GPIB LibraryThe GPIB library contains two different and complete GPIB libraries.Origina

Appendix A Multiline Interface MessagesProgramming Reference Manual A-2 GPIB-48815 21 NAK PPU 35 53 5 MLA2116 22 SYN 36 54 6 MLA2217 23 ETB 37 55 7 ML

Appendix A Multiline Interface MessagesGPIB-488 A-3 Programming Reference Manual47 71 G MTA7 67 103 g MSA7,PPE48 72 H MTA8 68 104 h MSA8,PPE49 73 I MT

Appendix A Multiline Interface MessagesProgramming Reference Manual A-4 GPIB-48857 87 W MTA23 77 119 w MSA23,PPD58 88 X MTA24 78 120 x MSA24,PPD59 89

GPIB-488 B-1 Programming Reference ManualBIBSTAEvery GPIB library routine returns a 16-bit status word to the variable ibsta. This status word describ

Appendix B IBSTAProgramming Reference Manual B-2 GPIB-488Table B-1. Bit DefinitionsBit DescriptionERR GPIB Error. If this bit = 1, an error has occu

Appendix B IBSTAGPIB-488 B-3 Programming Reference ManualRQS Device Requesting Service. If this bit = 1, a device is requesting service. RQS is set in

Appendix B IBSTAProgramming Reference Manual B-4 GPIB-488TACS Talker. If this bit = 1, the GPIB Interface Board has been addressed as a talker. This b

GPIB-488 C-1 Programming Reference ManualCIBERRIf the ERR bit in the status word (ibsta) has been set (= 1), an error code describing the exact error

Appendix C IBERRProgramming Reference Manual C-2 GPIB-48820 ETAB The return buffer is full.23 EHDL The input handle is invalidEDVR—Driver errorCause:

Appendix C IBERRGPIB-488 C-3 Programming Reference ManualENOL—No listening device(s)Cause: The routine detected no listeners.Solution: Verify the foll

Chapter 2 Programming with the GPIB LibraryProgramming Reference Manual 2-2 GPIB-488General ConceptsThis section explains the difference between routi

Appendix C IBERRProgramming Reference Manual C-4 GPIB-488EABO—I/O operation abortedCause: I/O operation aborted. (time-out)Solution: Check that the de

Appendix C IBERRGPIB-488 C-5 Programming Reference ManualEFSO—File system errorCause: A problem was encountered while performing a file operation.Solu

Appendix C IBERRProgramming Reference Manual C-6 GPIB-488ESRQ—SRQ in "ON" positionCause: A wait for an RQS can not occur because the GPIB SR

GPIB-488 I-1 Programming Reference ManualIndexNumerics488.1library reference (table), 3-1library routinesIBASK, 3-3options (table), 3-3IBCAC, 3-6IBCLR

IndexProgramming Reference Manual I-2 GPIB-488TestSys, 4-27Trigger, 4-28TriggerList, 4-29WaitSRQ, 4-30AAllSpoll, 4-2Bbit definitions (table), B-2board

IndexGPIB-488 I-3 Programming Reference ManualIBPPC, 3-32values for P2-P0 (table), 3-32IBRD, 3-34IBRDA, 3-36IBRDF, 3-37IBRPP, 3-39IBRSC, 3-40IBRSP, 3-

IndexProgramming Reference Manual I-4 GPIB-488supported languages (table), 1-1TTestSRQ, 4-26TestSys, 4-27Trigger, 4-28TriggerList, 4-29Uutility progra

Chapter 2 Programming with the GPIB LibraryGPIB-488 2-3 Programming Reference ManualBoard l/OIn comparison, the Board I/O routines are low-level routi

Chapter 2 Programming with the GPIB LibraryProgramming Reference Manual 2-4 GPIB-488Global VariablesThe following global variables are used in all pro

GPIB-488 3-1 Programming Reference Manual3GPIB 488.1 Library ReferenceThis chapter describes each of the 488.1 GPIB library routines. A short descript

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-2 GPIB-488ibpadChange Primary addressibpctPass ControlibppcParallel Poll Configur

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-3 Programming Reference ManualIBASKReturns software configuration information.SyntaxC ibask (int boar

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-4 GPIB-488IbaEOSrd bd/dev0 = ignore EOS char during readsnon zero = terminate rea

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-5 Programming Reference ManualReturns ibsta will contain a 16-bit status word; refer to Appendix B, I

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-6 GPIB-488IBCACMakes the specified board the Active Controller.SyntaxC ibcac (int

© Copyright 1996-2006 by Measurement Computing Corporation’s licensor(s). All rights reserved.Support

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-7 Programming Reference ManualIBCLRClears a specified device.SyntaxC ibclr (int device)Parametersdev

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-8 GPIB-488IBCMDSends GPIB commands.SyntaxC ibcmd (int board, char cmnd[], long b

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-9 Programming Reference ManualExampleThis example prepares the board to talk and addresses three devi

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-10 GPIB-488IBCMDATransfers GPIB commands asynchronously from a string.SyntaxC ib

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-11 Programming Reference ManualIBCONFIGChanges configuration parameters.SyntaxC ibconfig (int boardd

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-12 GPIB-488IbcAUTOPOLL bdEnable/Disable Automatic Serial Polling. If value is 0,

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-13 Programming Reference ManualReturnsibsta will contain a 16-bit status word as described in Appendi

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-14 GPIB-488ExampleThis example illustrates how to change the timeout value for GP

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-15 Programming Reference ManualIBDEVObtains a device handle for a device whose name is unknown. It op

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-16 GPIB-488ExampleThis example opens an available device, associates it with GPIB

ConventionsThe following conventions are used in this manual:[ ] Square brackets indicate the key to be pressed.» The » symbol leads you through neste

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-17 Programming Reference ManualIBDMAEnables/Disables DMA.SyntaxC ibdma (int board, int dma)Parameters

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-18 GPIB-488IBEOSChanges or disables End-Of-String termination mode.SyntaxC ibeos

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-19 Programming Reference ManualThis call remains in effect until one of the following occurs:• Anothe

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-20 GPIB-488IBEOTEnables/Disables assertion of EOI on write operations.SyntaxC ib

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-21 Programming Reference ManualIBFINDOpens a board or device and returns the handle associated with a

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-22 GPIB-488IBGTSPuts an Active Controller in Standby mode.SyntaxC ibgts (int boa

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-23 Programming Reference ManualC int gpib1;gpib1 = ibfind ("GPIB1");ibcmd (gpib1, "?Z+

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-24 GPIB-488IBISTSets/Clears the IST (Individual Status) Bit of the GPIB board for

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-25 Programming Reference ManualIBLINESReturns the status of the GPIB control lines.SyntaxC iblines (i

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-26 GPIB-488• IFC = Interface Clear• REN = Remote Enable• SRQ = Service Request• E

controller is designated at system initialization either through the use of hardware switches or by some type of configuration software, and is not ch

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-27 Programming Reference ManualIBLNCheck that a device is present on the bus.SyntaxC ibln (int board

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-28 GPIB-488IBLOCForces the specified board/device to go to local program mode.Syn

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-29 Programming Reference ManualIBONLEnables/Disables a device/interface board for operation.SyntaxC i

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-30 GPIB-488IBPADChanges the primary address assigned to a device or interface boa

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-31 Programming Reference ManualIBPCTPasses control to another device.SyntaxC ibpct (int device)Param

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-32 GPIB-488IBPPCEnables/Disables parallel polling of the specified device.SyntaxC

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-33 Programming Reference ManualFor example, if the PPE byte 01101011 (hex 6B) is sent, the device wil

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-34 GPIB-488IBRDReads data from a device/interface board into a string.SyntaxC ib

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-35 Programming Reference ManualExampleThis example reads 90 characters of data from a device at PAD 5

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-36 GPIB-488IBRDAReads data asynchronously from a device/interface board into a st

GPIB-488 v Programming Reference Manual ContentsChapter 1GPIB Software OverviewSupported Languages...

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-37 Programming Reference ManualIBRDFReads data from the GPIB into a file.SyntaxC ibrdf (int boarddev

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-38 GPIB-488ExampleThis program sends the command "DUMP" to a device. Th

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-39 Programming Reference ManualIBRPPInitiates a parallel poll.SyntaxC ibrpp (int boarddev, char *com

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-40 GPIB-488IBRSCRequest/Release System Control.SyntaxC ibrsc (int board, int cont

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-41 Programming Reference ManualIBRSPSerial polls a device.SyntaxC ibrsp (int device, char *serialpoll

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-42 GPIB-488IBRSVChanges the serial poll response byte.SyntaxC ibrsv (int board,

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-43 Programming Reference ManualIBSADAssigns/unassigns a secondary address to a board or device.Syntax

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-44 GPIB-488IBSICAsserts IFC (Interface Clear) signal. This re-initializes the GPI

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-45 Programming Reference ManualIBSREAsserts/Unasserts the REN (Remote Enable) line.SyntaxC ibsre (int

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-46 GPIB-488IBSTOPTerminate an asynchronous operation.SyntaxC ibstop (int boarddev

ContentsProgramming Reference Manual vi GPIB-488IBPAD ...

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-47 Programming Reference ManualIBTMOChanges timeout value.SyntaxC int ibtmo (int boarddev, int timeou

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-48 GPIB-488The new timeout is used until it is redefined (by calling ibtmo again)

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-49 Programming Reference ManualIBTRGTriggers the specified device.SyntaxC ibtrg (int device)Parameter

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-50 GPIB-488IBWAITForces application program to wait for a specified event(s) to o

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-51 Programming Reference ManualExampleThis example forces your program to wait indefinitely for the s

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-52 GPIB-488IBWRTWrites data from a string to the specified device or GPIB Interfa

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-53 Programming Reference ManualIf you want to send an EOS character at the end of the data string, yo

Chapter 3 GPIB 488.1 Library ReferenceProgramming Reference Manual 3-54 GPIB-488IBWRTAWrites data asynchronously from a string to the specified device

Chapter 3 GPIB 488.1 Library ReferenceGPIB-488 3-55 Programming Reference ManualIBWRTFWrites data from a file to the specified device or GPIB Interfac

GPIB-488 4-1 Programming Reference Manual4GPIB 488.2 Library ReferenceThis chapter describes each of the 488.2 GPIB library routines. A short descript

ContentsGPIB-488 vii Programming Reference ManualSendList ...

Chapter 4 GPIB 488.2 Library ReferenceProgramming Reference Manual 4-2 GPIB-488AllSpollPerforms a serial poll on specified devices.SyntaxC AllSpoll (i

Chapter 4 GPIB 488.2 Library ReferenceGPIB-488 4-3 Programming Reference ManualDevClearClears one device.SyntaxC DevClear(int board, short address)Par

Chapter 4 GPIB 488.2 Library ReferenceProgramming Reference Manual 4-4 GPIB-488DevClearListClears specified devices.SyntaxC DevClearList(int board, sh

Chapter 4 GPIB 488.2 Library ReferenceGPIB-488 4-5 Programming Reference ManualEnableLocalPlaces specified devices in local mode (Can be "program

Chapter 4 GPIB 488.2 Library ReferenceProgramming Reference Manual 4-6 GPIB-488EnableRemoteAllow remote programming (by sending messages over the GPIB

Chapter 4 GPIB 488.2 Library ReferenceGPIB-488 4-7 Programming Reference ManualFindLstnFinds all listeners on the GPIB.SyntaxC FindLstn(int board, sho

Chapter 4 GPIB 488.2 Library ReferenceProgramming Reference Manual 4-8 GPIB-488FindRQSIdentify the device requesting service.SyntaxC FindRQS(int board

Chapter 4 GPIB 488.2 Library ReferenceGPIB-488 4-9 Programming Reference ManualPassControlMakes another device the Active Controller.SyntaxC PassContr

Chapter 4 GPIB 488.2 Library ReferenceProgramming Reference Manual 4-10 GPIB-488PpollPerforms a parallel poll.SyntaxC PPoll(int board, short *result)P

Chapter 4 GPIB 488.2 Library ReferenceGPIB-488 4-11 Programming Reference ManualPPollConfigConfigures a device for parallel polls.SyntaxC PPollConfig(

GPIB-488 1-1 Programming Reference Manual1GPIB Software OverviewThe GPIB software includes the 488.1 library, the 488.2 library, and a set of utility

Chapter 4 GPIB 488.2 Library ReferenceProgramming Reference Manual 4-12 GPIB-488PPollUnconfigUnconfigures devices for parallel polls.SyntaxC PPollUnco

Chapter 4 GPIB 488.2 Library ReferenceGPIB-488 4-13 Programming Reference ManualRcvRespMsgReads data from a previously addressed device.SyntaxC RcvRes

Chapter 4 GPIB 488.2 Library ReferenceProgramming Reference Manual 4-14 GPIB-488ReadStatusByteSerial poll a single device and read its status byte.Syn

Chapter 4 GPIB 488.2 Library ReferenceGPIB-488 4-15 Programming Reference ManualReceiveReads data from a GPIB device.SyntaxC Receive(int board, int ad

Chapter 4 GPIB 488.2 Library ReferenceProgramming Reference Manual 4-16 GPIB-488ReceiveSetupAddress a GPIB Interface Board as a Listener and a GPIB de

Chapter 4 GPIB 488.2 Library ReferenceGPIB-488 4-17 Programming Reference ManualResetSysInitializes GPIB System.SyntaxC ResetSys(int board, short addr

Chapter 4 GPIB 488.2 Library ReferenceProgramming Reference Manual 4-18 GPIB-488SendSends data to one GPIB device.SyntaxC Send (int board, short addre

Chapter 4 GPIB 488.2 Library ReferenceGPIB-488 4-19 Programming Reference ManualSendCmdsSend GPIB commands.SyntaxC SendCmds (int board, char commands[

Chapter 4 GPIB 488.2 Library ReferenceProgramming Reference Manual 4-20 GPIB-488SendDataBytesSends data to previously addressed devices.SyntaxC SendDa

Chapter 4 GPIB 488.2 Library ReferenceGPIB-488 4-21 Programming Reference ManualSendIFCClears the GPIB bus by asserting the IFC (Interface Clear) line

Chapter 1 GPIB Software OverviewProgramming Reference Manual 1-2 GPIB-488GPIB Library Utility ProgramsThe following utility programs are installed wit

Chapter 4 GPIB 488.2 Library ReferenceProgramming Reference Manual 4-22 GPIB-488SendListSends data to multiple GPIB devices.SyntaxC SendList(int board

Chapter 4 GPIB 488.2 Library ReferenceGPIB-488 4-23 Programming Reference ManualSendLLOSends Local Lockout (LLO) message to all GPIB devices.SyntaxC S

Chapter 4 GPIB 488.2 Library ReferenceProgramming Reference Manual 4-24 GPIB-488SendSetupAddresses a GPIB board as a Talker and the specified GPIB dev

Chapter 4 GPIB 488.2 Library ReferenceGPIB-488 4-25 Programming Reference ManualSetRWLSPuts all devices in Remote state with Local Lockout and address

Chapter 4 GPIB 488.2 Library ReferenceProgramming Reference Manual 4-26 GPIB-488TestSRQEvaluate state of SRQ line.SyntaxC TestSRQ(int board, short *re

Chapter 4 GPIB 488.2 Library ReferenceGPIB-488 4-27 Programming Reference ManualTestSysActivate self-test procedures of specified devices.SyntaxC Send

Chapter 4 GPIB 488.2 Library ReferenceProgramming Reference Manual 4-28 GPIB-488TriggerTriggers one device.SyntaxC Trigger(int board, short address)Pa

Chapter 4 GPIB 488.2 Library ReferenceGPIB-488 4-29 Programming Reference ManualTriggerListTriggers multiple GPIB devicesSyntaxC void TriggerList(int

Chapter 4 GPIB 488.2 Library ReferenceProgramming Reference Manual 4-30 GPIB-488WaitSRQWait until a device asserts SRQ.SyntaxC WaitSRQ(int board, shor

GPIB-488 A-1 Programming Reference ManualAMultiline Interface MessagesTable A-1. Multiline Interface Messages (Hex 00-3F)HEX DEC ASCII MSG HEX DEC AS