Receive Function

Owning Palette: GPIB 488.2 Functions

Requires: Base Development System

Reads data bytes from a GPIB device.

Refer to GPIB Function Defaults for more information about the timeout and address defaults.

Details  

Add to the block diagram

Find on the palette

	bus The function addresses the interface indicated by bus as a Listener. bus refers to the GPIB bus number. If you have only one GPIB interface in your computer, the default bus number is 0. Refer to the software installation instructions included with your GPIB controller for additional GPIB interfaces.
	address contains the primary address of the GPIB device with which the function communicates. If a secondary address is required, use the MakeAddr function to format the primary and secondary addresses.
	mode selects the method that signals the end of the data. The default is 0. If mode is a value from decimal 0 through 255, the ASCII character that corresponds to it is the termination character, and the function stops the read when it detects the character. If mode is not wired, or is decimal 256, the function stops the read when it detects END.
	count is the maximum number of data bytes to return from the device in data string.
	error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
	data string contains count data bytes from the GPIB device.
	status is a Boolean array in which each bit describes a state of the GPIB Controller. If an error occurs, the function sets bit 15. GPIB error is valid only if bit 15 of status is set. The following table shows the numeric value and symbolic status of each bit in status. This table also includes a description of each bit. Status Bit Numeric Value Symbolic Status Description 0 1 DCAS Device Clear state 1 2 DTAS Device Trigger State 2 4 LACS Listener Active 3 8 TACS Talker Active 4 16 ATN Attention Asserted 5 32 CIC Controller-In-Charge 6 64 REM Remote State 7 128 LOK Lockout State 8 256 CMPL Operation Completed 12 4096 SRQI SRQ Detected while CIC 13 8192 END EOI or EOS Detected 14 16384 TIMO Timeout 15 -32768 ERR Error Detected
	byte count refers to the number of bytes that pass over the GPIB.
	error out contains error information. This output provides standard error out functionality.

Receive Details

Receive terminates when the function does one of the following:

• Reads the number of bytes requested
• Detects an error
• Exceeds the time limit
• Detects the END message (EOI asserted)
• Detects the EOS character (assuming the value supplied to mode has enabled this option)