Description

The library, and the administration tool gpib_config read their configuration information from the file gpib.conf. By default, file is located in the sysconfdir directory configured when linux-gpib was compiled. The sysconfdir is typically set to /etc or /usr/local/etc. A template gpib.conf file can be found in the util/templates/ subdirectory of the linux-gpib package.

The default config file may be overriden by setting the IB_CONFIG environment variable to a custom file path.

The configuration file must contain one 'interface' entry for each of the board minors that are going to be used unless all the 'required' options are specified in the command-line invocation of the administration tool gpib_config to configure that minor. The file must contain an 'interface' entry with the 'name' option set if you wish to open the board desciptor with ibfind() instead of directly using the minor as the board descriptor. If there is no entry for the minor in the configuration file, the required command-line options are 'board_type' and 'pad'. Additionally the 'system-controller' must be scpecified if the board is to be system-controller, which is the normal case. For example:

  gpib_config --minor 8 --board-type ni_usb_b --pad 0 --system-controller

The configuration file can contain zero or more 'device' entries. 'device' entries are only required if you wish to open device descriptors with ibfind() instead of using ibdev(). Each 'device' entry must have at least the 'minor', 'pad' and 'name' options specified. The 'minor' of a 'device' entry must have a corresponding 'interface' entry.

Several example entries, and a table summarizing the possible options follow.

  /*  This comment style is permitted */

  // This is an alternate comment style
  
interface {
	minor = 0
	board_type = "ni_pci"
	pad = 0
	master = yes
}

interface {
	minor = 1
	board_type = "ines_pci"
	name = "joe"
	pad = 5
	sad = 0
	timeout = T10s
	pci_bus = 0
	pci_slot = 0xd
	master = no
}

interface {
	minor = 2
	board_type = "pcII"
	pad = 3
	sad = 0x62
	eos = 0x0d
	set-reos = yes
	set-bin = no
	set-xeos = no
	set-eot = yes
	base = 0x300
	irq  = 5
	dma  = 0
	master = no
}

device {
	minor = 0
	name = "counter"  // name that can be used with ibfind
	pad = 24
}

device {
	minor = 0
	name = "voltmeter"
	pad = 7
	sad = 110
	eos = 0xa
	set-reos = yes
	set-bin = no
	set-xeos = yes
	set-eot = no
	timeout = T1s
}