Return Values

Commands are being executed successfully when return values are 0.
A return value consists of 16 bits, high-order 8 bits indicate the receive status of IFC and SRQ and low-order 8 bits indicate error status.

From Ver3.20, the high byte has been changed not to be added by default.
Please refer GpUpperCode when you want to use the high byte.

 

How to read return values

image\HCR_1_wmf.gif

 

High-order(8bit):

Return value

Description

0 (000H, 0)

IFC and SRQ were not received.

1 (100H, 256)

SRQ was received.

2 (200H, 512)

IFC was received.

3 (300H, 768)

SRQ and IFC were received.

 

 

 

For all devices

 

Low-order (8bit):

Return value

Description

0

Normal completion

Indicates that the command processing was completed successfully.

1

Delimiter and EOI reception complete

The status byte accompanied by EOI was received at the time of a serial pole.
Indicates that delimiter code and EOI have been received and the receive operation has been completed successfully.

2

EOI reception complete

Indicates that only EOI has been received and the receive operation has been completed successfully.

80

I/O address error

Indicates that GP-IB was initialized, but no GP-IB board was found at the specified I/O address.

82

 

Device access error

Failure to access the specified device.

*1: Common and Detailed Setup of Property may not be set properly.

*2: The device may not be recognized properly.
    Especially, it may be caused by insufficient power supply or noise in the surrounding environment when you use USB device.

*3: Device driver may not be installed properly.

*4: Driver No. may not be set properly.
   Please refer "Using More Than One Board at the Same Time" to know more details.

*5: It may be caused by failure to allocate the memory rarely.

128

Receive data overflow; "RQS bit on" could not be received

*1: Indicates that the data received without FIFO and DMA exceeded the expected amount. (The receive operation has been completed.)

    In this case, increase the number of receive data or set the number of commands to zero and try receiving the remaining data.
   (This can also occur when there is an error in delimiter code.)

*2: Indicates that "RQS bit on" could not be received during serial poll execution.

140

Asynchronous function is executing now

It shows asynchronous function is executing now.

141

141: Asynchronous function is Stopped by GpStopAsync()

It shows asynchronous function is terminated by GpStopAsync().

190

Cannot create new event object

It shows fail to create a new event object.

200

Cannot create new thread

It shows fail to create a new thread.

201

Other function is in practice.

It shows the case which carried out one of another function which are GpSetEvent or GpSrqEventEx or GpSrqEvent during operation.
There are mutually these function on relation of exclusion.

210

It was failed in initialize of a channel of DMA.

It was failed in establishment of DMA channel. Other device may use this channel.

240

ESC Key was pushed

Indicates that forcible termination occurred because GpStstop function was executed while data or commands were being sent or received.
(By establishment, it is formed not to perform a compulsory end.)

241

File input/output error

*1: Search was made, but the specified file could not be found.

*2: The residual media capacity was used up before the file saving was completed.

*3: The file specified as the one to write to is a read-only file.

*4: The media and GP-IB have the same interrupt.

242

Miss in address specified

It shows miss in address specified.

243

Miss in buffers

It shows miss in buffers of translation. In case of VB, keep the buffer as following

Ex) Keep 100bytes

*1: Dim Srbuf As String
     Srbuf = Space(100)

*2: Dim Srbuf As String * 100

244

Array size error

*1: It is shown that the number of the data blocks divided by separator is larger than the size (ArraySize) of the arrangement specified by GpCnvStrToDblArray and GpCnvStrToFltArray.

*2: It is shown that the length of the string changed rather than the length (StrSize) of the string specified by GpCnvDblArrayToStr and GpCnvFltArrayToStr is large.

252

GP-IB error

Attempted to transmit data and commands acting against GP-IB protocols.
This error occurs mostly when there is an error in the device address.

253

There is no receive data.

Indicates that only delimiter code was received. (Receive data length in bytes = 0)

254

Timeout

Indicates that the transmit or receive data operation was not completed although it waited for the time set for timeout.

255

255: Illegal call or parameter error

*1: Attempted to execute the function with a parameter outside the specification range.

*2: If this occurs in the "Set REN" function, the interrupt of GP-IB is not enabled.
   Please refer the corresponding device manual for details.

    (a) The settings for the GP-IB board and software are inconsistent.

    (b) The setting is in conflict with the interrupt level for the PC system or other peripheral (such as a hard disk or sound board).

    (c) The interrupt signal of the I/O expansion unit is not enabled.

*3: Attempted to execute commands for Master in slave mode.

*4: Attempted to execute commands for Slave in master mode.