GPCONF(1) COMMAND REFERENCE GPCONF(1) NAME gpconf - display or change GPIB device configuration SYNOPSIS gpconf -a gpconf gpibn gpconf instrument gpconf device [ default ] [ slot slot ] [ addr pri[.sec] ] [ eom byte ] [ -eom ] [ htime secs ] [ ptime secs ] [ [-]dma ] [ [-]poll ] [ [-]sc ] [ [-]std1 ] [ [-]tcs ] [ [-]vstd1 ] [ [-]weoi ] gpconf device reset gpconf gpibn slot slot DESCRIPTION gpconf displays or changes the configuration of GPIB devices. The first three forms display the current configuration of all GPIB devices (-a), a GPIB interface and attached instruments (gpibn), or a single instrument. The fourth form adds or changes the configuration of the named device and prints the new configuration. The fifth form resets the configuration to the stored settings. The sixth form is used to move all the instruments attached to one interface to a different slot. The new device is configured to the the old settings; the old device is removed from the configuration. OPTIONS default Change to default configuration. The default settings for an interface device (gpibn) are: slot a addr 0 htime 5 ptime 0.1 eom EOI dma sc tcs -std1 -vstd1. The default settings for an instrument device are: slot a htime 5 ptime 0.1 eom EOI dma poll. Note that there is no default address for instruments; the address must always be specified explicitly. slot slot Specifies the interface slot to which the instrument is attached. addr pri[.sec] Specifies the GPIB address for the interface or instrument. You may not specify a secondary address for an interface. eom byte Specifies a byte to be recognized as end-of- message. Byte may be EOI, CR (carriage Printed 5/12/88 1
GPCONF(1) COMMAND REFERENCE GPCONF(1) return, hex 0D), LF (line feed, hex 0A), two hex digits, or a literal character. The usual character escape sequences (e.g. \r for carriage return) may be used, although they must be quoted to avoid interpretation by the shell. Specifying -eom is equivalent to specifying eom EOI. htime secs Specifies the time allowed for each byte of data before returning a timeout error. Specifying -htime or htime 0 disables the timer. The time displayed for this value is adjusted up or down from the user-entered value to match the clock resolution of the machine being used. ptime secs Specifies the time allowed for an instrument to respond during a serial poll. Specifying -ptime or ptime 0 disables the timer. The time displayed for this value is adjusted up or down from the user-entered value to match the clock resolution of the machine being used. [-]dma Enables [disables] DMA hardware, if present. (This flag is provided primarily for diagnostic use.) [-]poll Enables [disables] automatic polling of this instrument. See gins(4) for information about the auto-polling feature. [-]sc System controller. This interface is [is not] the system controller. [-]std1 Short T1 delay. The interface T1 delay is [is not] shortened from 2.2 us to 1.2 us. See IEEE 488-1980. [-]tcs Take control synchronously. The interface will [will not] synchronize assertion of ATN with the GPIB handshake to avoid loss of data. See IEEE 488-1980. [-]vstd1 Very short T1 delay. The interface T1 delay is [is not] shortened to 600 ns on the second and following bytes of any device-dependent message. See IEEE 488-1980. [-]weoi By default, this is turned on. If it is turned off (-weoi), the driver will not assert EOI with the last byte of the message. Printed 5/12/88 2
GPCONF(1) COMMAND REFERENCE GPCONF(1) EXAMPLES Configure the option slot b interface as a system controller at GPIB address 30. $ gpconf gpibb addr 30 sc gpibb slot b addr 30 eom EOI sc tcs Add an instrument ``fg5010'' at address 24 and an instrument ``dm5010'' at address 16 to the interface in option slot a. If the interface isn't already configured, gpconf sets it to the default configuration. $ gpconf fg5010 slot a addr 24 poll gpiba slot a addr 0 eom EOI sc tcs fg5010 slot a addr 24 eom EOI poll $ gpconf dm5010 slot a addr 16 poll dm5010 slot a addr 16 eom EOI poll Print the system configuration. $ gpconf -a ========== slot b ========== gpib0 slot b addr 30 eom EOI sc tcs ========== slot a ========== gpiba slot a addr 0 eom EOI sc tcs dm5010 slot a addr 16 eom EOI poll fg5010 slot a addr 24 eom EOI poll FILES /etc/gpibconf current configuration /etc/gpibnew temporary file /dev/gpib n GPIB interface device /dev/gpid n GPIB configuration device /dev/ instrument GPIB instruments DIAGNOSTICS device slot n addr n ... The named device has been added to the configuration. device slot argument : invalid slot number "device addr argument : invalid address" "device eom argument : invalid argument" "device htime argument : invalid time" "device ptime argument : invalid time" "device option?" gpconf couldn't understand your command. Correct the syntax and try again. Printed 5/12/88 3
GPCONF(1) COMMAND REFERENCE GPCONF(1) you must specify a GPIB address for device You must specify the GPIB address when you add a new instrument. (Only the interface address defaults to 0.) slot n address n already in use There is already some device configured at this address. Correct the configuration or use a different address. device : file or device already exists There is already a (non-GPIB) device or file by that name. Use a different name. device slot n no interface There is no GPIB interface card in the specified slot. The device will be entered in the configuration file but won't be usable until you plug in an interface or specify a different slot number. device slot n not configured The named interface is present but hasn't been configured. can't create device : too many logical units in slot n You have tried to attach more than 15 instruments to one interface. You may address additional instruments through the interface device gpibn, but cannot configure them as independent devices. Other messages are system errors. See intro(2) for more information on these. RETURN VALUE [NO_ERRS] Command completed without error. [USAGE] Incorrect command line syntax. Execution terminated. [NP_WARN] An error warranting a warning message occurred. Execution continues. [NP_ERR] An error occurred that was not a system error. Execution terminated. [P_WARN] A system error occurred. Execution continues. See intro(2) for more information on system errors. [P_ERR] A system error occurred. Execution Printed 5/12/88 4
GPCONF(1) COMMAND REFERENCE GPCONF(1) terminated. See intro(2) for more information on system errors. CAVEATS When configuring an instrument, gpconf attempts to ensure that the specified interface is configured first. This will cause address conflicts if you attempt to configure an instrument at address 0 before setting the interface address. There is no way to change the name of a device short of removing and reconfiguring it. SEE ALSO gpinit(1), gprm(1), gpstat(1), gpib(4), gpid(4), gins(4), config(8). 4300 Series Option 3J (F3J) High Speed GPIB Interface Reference & Installation Printed 5/12/88 5
%%index%% na:288,104; sy:392,1695; de:2087,894; op:2981,1386;4727,3408; ex:8495,1102; fi:9597,388; di:9985,852;11197,1644; rv:12841,718;13919,118; ca:14037,498; se:14535,493; %%index%%000000000198