From 0abfdd0a0e02f6cd14986107175738294ab324fa Mon Sep 17 00:00:00 2001 From: Frank Mori Hess Date: Tue, 2 May 2006 01:21:46 +0000 Subject: [PATCH] RTSI documentation from terry1@beam.ltd.uk (Terry Barnaby) --- doc/other.sgml | 254 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 254 insertions(+) diff --git a/doc/other.sgml b/doc/other.sgml index e712297..d417fae 100644 --- a/doc/other.sgml +++ b/doc/other.sgml @@ -1693,6 +1693,260 @@ Notes: How to specify which events cause a latch and push, and what should get latched? + + +
+ +National instruments RTSI trigger bus + + +A number of NI boards support the RTSI bus. The RTSI Bus consists of an 48 pin +IDC connector on the PCI-6143 and special bus signal lines on PXI boards. +It's primary use is to synchronise multiple DAQ cards together. +There are 8 digital signal lines that are bi-directional. Each of these signal lines +can be configured as an input or output also the signal appearing on the output +can be configured to one of many internal board timing signals. We have added +basic RSTI support to enable a board to be set as a master and other boards to +be set as slaves. To simplify the API and code we have hard-coded the actual +set of internal timing signals that appear on the RTSI lines and just provide +the ability to set the I/O direction of the lines. It would be good to add a +new configure command to set up this routing to a different setup. The COMEDI +API is provided as a Digital I/O subdevice number 10 with an extra config +command to set up the master clock mode. This provides a number of configure +commands through the COMEDI config API which can be accessed using the +comedi_do_insn(), comedi_dio_config() and comedi_dio_get_config() functions. +The config API calls are: + + + + + +API Command +Description + + + + +INSN_CONFIG_SET_RTSI_CLOCK_MODE + +This sets the boards main clock +mode. The argument defines the setting as one of: +COMEDI_RTSI_CLOCK_MODE_INTERNAL - Internal Clock. +COMEDI_RTSI_CLOCK_MODE_OUTPUT - Run from internal clock and output this +on the RTSI bus bit as RTSI_7. +COMEDI_RTSI_CLOCK_MODE_SLAVE - Run from the clock on the RTSI bus bit +RTSI_7. +COMEDI_RTSI_CLOCK_MODE_MASTER - Output the clock on the RTSI bus bit as +RTSI_7 and run from this external clock. + + + +INSN_CONFIG_DIO_OUTPUT + +Configure the "channel" bit as +an output. Channel is one of NI_RTSI_[0-6] + + + +INSN_CONFIG_DIO_INPUT + +Configure the "channel" bit as +an input. Channel is one of NI_RTSI_[0-6]. + + + +INSN_CONFIG_DIO_QUERY + +Find the direction of one of the +RTSI "channels". Channel is one of NI_RTSI_[0-6]. + + + + + + +The RTSI bus pins and default output routing is: + + + + + + +Name +Standard Routing +Pin + + + + +RTSI_0 + +NI_RTSI_STD_AI_START1 + +20 + + + +RTSI_1 +NI_RTSI_STD_AI_START2 + +22 + + + +RTSI_2 +NI_RTSI_STD_AI_CONV + +24 + + + +RTSI_3 +NI_RTSI_STD_CT1_SRC + +26 + + + +RTSI_4 +NI_RTSI_STD_CT1_GATE + +28 + + + +RTSI_5 +NI_RTSI_STD_AO_SAMP_CLOCK + +30 + + + +RTSI_6 +NI_RTSI_STD_AO_START_TRIG + +32 + + + +RTSI_7 or RTSI_CLK + +Master Clock + +34 + + + + + + + +The RTSI bus pins are available to be used as trigger inputs for many of the +COMEDI trigger functions. To use the RTSI bus pins set the source to be +TRIG_EXT and the source argument to be a value between 10 and 16 corresponding +to RTSI_0 through RTSI_6. We have provided the defines NI_EXT_PFI_[0-9] and +NI_EXT_RTSI_[0-6] to define all the available external trigger sources. + + +A simple example to set up a device as a master is given below. + + + + + +An example to slave a device from this master follows: + + + +
-- 2.26.2