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 0 addr 0 htime 5 ptime 0.1 eom EOI dma
sc tcs -std1 -vstd1.
The default settings for an instrument device
are:
slot 0 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. The built-in
interface is slot 0.
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-
Printed 10/17/86 1
GPCONF(1) COMMAND REFERENCE GPCONF(1)
message. Byte may be EOI, CR (carriage
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.
ptime secs Specifies the time allowed for an instrument
to respond during a serial poll. Specifying
-ptime or ptime 0 disables the timer.
[-]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.
EXAMPLES
Configure the built-in interface as a system controller at
GPIB address 30.
Printed 10/17/86 2
GPCONF(1) COMMAND REFERENCE GPCONF(1)
$ gpconf gpib0 addr 30 sc
gpib0 slot 0 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 2.
If the interface isn't already configured, gpconf sets it to
the default configuration.
$ gpconf fg5010 slot 2 addr 24 poll
gpib2 slot 2 addr 0 eom EOI sc tcs
fg5010 slot 2 addr 24 eom EOI poll
$ gpconf dm5010 slot 2 addr 16 poll
dm5010 slot 2 addr 16 eom EOI poll
Print the system configuration.
$ gpconf -a
========== slot 0 ==========
gpib0 slot 0 addr 30 eom EOI sc tcs
========== slot 2 ==========
gpib2 slot 2 addr 0 eom EOI sc tcs
dm5010 slot 2 addr 16 eom EOI poll
fg5010 slot 2 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.
you must specify a GPIB address for device
Printed 10/17/86 3
GPCONF(1) COMMAND REFERENCE GPCONF(1)
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
terminated. See intro(2) for more
Printed 10/17/86 4
GPCONF(1) COMMAND REFERENCE GPCONF(1)
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).
Printed 10/17/86 5
%%index%%
na:72,88;
sy:160,1199;
de:1359,802;
op:2161,1203;3508,2743;
ex:6251,145;6540,969;
fi:7509,393;
di:7902,845;8891,1568;
rv:10459,741;11344,51;
ca:11395,446;
se:11841,249;
%%index%%000000000202