man8/MBSgateTask

Table of Contents

Name

MBSgateTask - NEC Gate Generator service

Synopsis

MBSgateTask <argument list>

Description

I/O service for NEC Gate Generator, Gate Generator Mark II. CAMAC modules and Gate Generator kbuss modules.

This module is part of the Magnet Bias Sequencer system and is used to provide gating signals for various parts of an AMS system.

Arguments

Argument processing is done using Unix long argument syntax.

The values of all of the parameters listed here (whether or not they were supplied on the command line) are printed on stderr when the program starts.

--dbman_host <hn>

The host where dbman is running.

If this argument is not supplied the default is localhost.

--dev_camac <path>

The pathname to the device to open when --drv specifies a CAMAC device.

The default is: /dev/camac

--dev_kbuss <path>

The pathname to the device to open when --drv specifies a KBUSS device.

The default is: /dev/kbuss

--drv <name>

The driver key.
--cmin

The minimum crate number in CAMAC.
The minimum board number in KBUSS.

If this is not supplied it defaults to 0.

--cmax

The maximum crate number in CAMAC.
The maximum board number in KBUSS.

If this is not supplied it defaults to 99.

--show_tbl

If this is supplied then the DATA table is printed to stderr.
--help

Print the internal help information and exit.

Driver Keys used by this program

These keys are used with CAMAC:

CAMAC
CAMAC_2
CAMAC_3
CAMAC_4

CAMAC_5

In this case the program opens /dev/camac.

These keys are used with KBUSS:

KBUSS_1
KBUSS_2
KBUSS_3
KBUSS_4
KBUSS_5

KBUSS_6

In this case the program opens /dev/kbuss.

Device Types used by this program

When using CAMAC C is the crate number, and N is the slot number.

When using KBUSS C is the board number, and N is not used and may be set to any value to facilitate sorting the database reports if desired.

DevNECgate
There should be 16 DATA records of this type created for each gate generator module in the system.

Each record represents one sequencer state.

The ChNo field corresponds to the state number, i.e. ChNo=0 is the state 0 record.

Individual bits in each record decide whether a gate is on or off during a particular state. Bit 0 corresponds to Gate 1 and so forth. If the bit is set to 1 the gate will be active during the state.

DevNECgateC
This record type is only used with the MarkII and beyond modules.

The marker output on these modules may be assigned to any of the gate outputs to allow viewing the gate signal on an oscilloscope (or for any other purpose the user may imagine).

The Gate15 output may be reassigned to the 4MHz clock by setting a bit in this record. This was previously handled by jumpers on the module.

The Gate16 output may be reassigned to the CAO signal (count active output) by setting a bit in this record. This was previously handled by jumpers on the module.

There should be 1 DATA record of this type created for each gate generator module in the system.

The ChNo field should be 0.

Bits 0-3 are used for marker output assignment.

Bit 4 is used to select between gate 15 and the 4MHz clock.

Bit 5 is used to select between gate 16 and the CAO signal.

I/O polling rates

There is nothing to poll.

Examples

#
# this example services CAMAC crates 1 thru 4
# dbman is running on the same host
#
MBSgateTask --dbman_host localhost --drv CAMAC --cmin 1 --cmax 4 #
#
#
#
# this example services KBUSS modules
# dbman is running on the same host
# (the min and max board numbers aren’t specified)
#
MBSgateTask --dbman_host localhost --drv KBUSS_1

Notes

When using KBUSS the S2 line must be enabled when the driver is installed or by using the kbuss_ctl(8) utility program.

Yes, we need more info in this manual page..

See Also

kbuss(4)
kbuss_ctl(8)
nec_gate(6)

Manual page revision

$Id: MBSgateTask.8,v 1.8 2007/07/19 15:35:30 kitchen Exp $

Table of Contents