Input/Output

Input and Output components handle input and output for circuits. Inputs include A/D converters, TTL inputs, and Trigger inputs. Outputs include D/A converters and TTL outputs. Use circuit components from this group to connect a circuit to the physical world.

This group includes the following components:

• AdcIn
• BitIn
• BitOut
• DacOut
• StereoAdc
• StereoDac
• TimeStamp
• TrgIn
• WordIn
• WordOut

This group also includes the following components, if RPvdsEx Device Setup is configured for a high performance device, such as the RXn or RZn:

• MCAdcIn
• MCDacOut
• MCeStim

AdcIn

Description:

Feeds the signal stream with A/D input channel specified. Converts 24 bit integer input to floating point value. Also scaled and shifted to yield calibrated voltage level.

A parameter input allows users to dynamically change the channel number.

Name	Description	Data Type
Output	Output values from ADC channel	Floating Point
Channel	Parameter input to dynamically change the channel number	Integer

Equation:

F_o = ADC channel D₁

Example(s):

Scale and Add, Scale and Add.

Butterworth Coefficients, ButCoef.

BitIn

Description:

Feeds the signal chain with bit(s) from the digital input port. BitIn will logic 'OR' all bits of the input port specified in Mask to produce a single logic high or low.

Name	Description	Data Type
Output	Logic value after bit-masked OR	Logic
M	Bit-Mask value for port; if any of those port values are high BitIn goes high	Floating Point

Standard integer values for addressing digital bits are provided in the table below.

Digital Bit	Bit Mask (M=__)
Bit 0	1
Bit 1	2
Bit 2	4
Bit 3	8
Bit 4	16
Bit 5	32
Bit 6	64
Bit 7	128

Note:

There is a two cycle delay when using the BitIn component.

Equation:

L_o = If (Digital Input Port && D₁)

Example(s):

If Digital Input Port = 7 and D₁ = 3 Then L_o = 1

If Digital Input Port = 8 and D₁ = 3 Then L_o = 0

BitOut

Description:

Sets or clears bits of the digital output port based on the inputs logic level. All bits specified in Mask will be set when the input is high else the bits will be cleared.

Name	Description	Data Type
Input	Logic value	Logic
M	When logic goes high all port values set with the bit-mask go high	Floating Point

Standard integer values for addressing digital bits are provided in the table below.

Digital Bit	Bit Mask (M=__)
Bit 0	1
Bit 1	2
Bit 2	4
Bit 3	8
Bit 4	16
Bit 5	32
Bit 6	64
Bit 7	128

Note:

There is a three cycle delay when using the BitOut component.

Important:!

Circuits that contain both BitOut and WordOut the Bitmasks cannot overlap. For example, a circuit where the BitOut and WordOut both use bit 2 (BitMask=4) the circuit will set the value based on the last component in the circuit.

Equation:

Digital Output Port = L_i masked by D₁

Example(s):

If L_i = 1 and D₁ = 3 then Digital Output Port bits 0 and 1 = 1

If L_i = 0 and D₁ = 3 then Digital Output Port bits 0 and 1 = 0

DacOut

Description:

Converts floating point signal input to integer value and sends to specified D/A output channel. The value is scaled and shifted to provide calibrated voltage output.

A parameter feed allows users to change the channel output dynamically.

Name	Description	Data Type
Input	Input	Floating Point
Channel #	Changes the channel number dynamically	Integer

Equation:

DAC channel D₁ = F_i

Example(s):

See ScaleAdd.

MCAdcIn

Description:

This component is a multi-channel version of the AdcIn component. MCAdcIn feeds the circuit with the multi-channel input from a high performance device, such as the RX5. With the RX5, analog signals are digitized on a preamplifier and sent to the base station via its fiber optic ports (Amp-A, Amp-B, Amp-C, and Amp-D). The channel offset (ChanOS) can be used to specify acquisition channels, such as channels from a specific amplifier. For example, to acquire signal data from Amp-B you would set the channel offset to 17. The number of channels fed to the multi-channel output is specified by nChan.

The minimum and maximum number of channels allowed in multi-channel signals is 4 and 256, respectively. However, the user must consider their hardware configuration when setting the number of channels. For example, the maximum number of analog input channels available on the Pentusa (RX5BA-5) is 64. Therefore, the number of channels for the MCAdcIn component must not exceed 64 when using this device.

Also see Working with Multi-Channel Components.

Note:

This component is for use with only high performance processor devices, such as RXn or RZn. See the reference section for your device in the System 3 Manual for more information.

Name	Description	Data Type
Output	Multi-channel output	Floating Point
nChan	Number of channels in output signal	Integer (Static)
ChanOS	Channel offset number	Integer

MCDacOut

Description:

This component is a multi-channel version of the DacOut component. MCDacOut converts the floating-point values in the multi-channel input signal to integer values and sends them to the specified analog output channels. The values are scaled and shifted to provide calibrated voltage output.

The minimum and maximum number of channels allowed in multi-channel signals is 4 and 256, respectively. However, the user must consider their hardware configuration when setting the number of channels. For example, the maximum number of analog outputs available on the Pentusa is four. Therefore, the number of channels for the MCDacOut must not exceed four.

Note:

This component is for use with only high performance processor devices, such as RXn or RZn.

Name	Description	Data Type
Input	Multi-channel input	Floating Point
nChan	Number of channels required	Integer (Static)
ChanOS	Channel offset	Integer

MCeStim

Description:

This component is used to send digital stimulus waveforms to the IZ2 Stimulus Isolator. The total number of channels configured for stimulation is defined in the nChan parameter. A multi-channel input accepts stimulus waveforms and an eight-channel output returns the actual stimulus voltage for monitoring. The MonBank parameter selects which bank of eight channels to be monitored.

The logic input parameter VMode determines if the IZ2 acts as a constant current (0) or voltage (1) source.

Use of the IZ2_Control macro is highly recommended as it provides all of the necessary settings for the IZ2 Stimulator.

Note:

This component is for use with the IZ2 Stimulus Isolator and RZ2 high performance processor devices. See the System 3 Manual for more information.

Name	Description	Data Type
Input	Multi-channel floating point input stream of stimulus waveforms	Floating Point
Output	Eight channel floating point multichannel monitor output	Floating Point
nChan	Number of stimulus channels to send to IZ2	Integer (Static)
VMode	Configures the IZ2 to run in Voltage Mode (1) or Current Mode (0)	Logic
MonBank	Select which bank of eight channels to monitor (integer, 0-15)	Integer
OpBits	Not used at this time.	Integer

StereoAdc

Description:

Generates stereo signal from channel 1 (left) and 2 (right) ADC inputs.

Name	Description	Data Type
Output	Stereo formatted signal	Floating Point
Ch	Left channel input (must =1)	Integer (Static)

StereoDac

Description:

Plays stereo input out of channel 1 (left) and 2 (right) DAC outputs.

Name	Description	Data Type
Input	Stereo input	Floating Point
Ch	Left channel input (must = 1)	Integer (Static)

TimeStamp

Description:

TimeStamp is used with the Barracuda (RV8) and Multifunction Processor (RX6). It is a submicrosecond accurate event-timer. On each tick of the sample clock the TimeStamp waits for a trigger input. When the trigger goes high, the TimeStamp component outputs a value equal to the number of microseconds since the start of the sample period.

The TimeStamp can detect triggers on a specified digital input line. The BitNum parameter determines which digital input bit is monitored for triggers. A Reset line (Rst) resets the TimeStamp and readies it for the next event. The Enable (Enab) line enables the TimeStamp function (Yes=1 to enable). The Strobe out should be connected to a latch or buffer operation to save the TimeStamp value (see example below).

Note:

On the RV8, bits 0-15 can be monitored for triggers. On the RX6, bits 0-3 can be monitored.

Name	Description	Data Type
Output	Time in microseconds since the beginning of the current sample period	Floating Point
BitNum	The number of the digital input bit (0-15 RV8, 0-3 RX6)	Integer
Rst	Resets the timer value (logic high allows it to run continuously)	Logic
Enab	Enables the TimeStamp	Logic
Strobe	Pulses out a logical high for a tick of the clock when component is triggered (used to latch/store data)	Logic

TrgIn

Description:

Feeds the signal chain with the specified trigger source. Use to feed system triggers to various Logic inputs of counters etc. Trigger options set before run.

When the zTrigIn component is configured for a software trigger, the trigger will remain high for one sample. However, if the zTrigIn is configured for the zBusA or zBusB trigger the time high will depend upon the sample rate. For example, at 6 kHz the trigger will remain high for one sample, but at 25 kHz the trigger will remain high for 5 samples.

If you wish to use the zBusA or zBusB trigger and need a single sample trigger pulse, use an EdgeDetect component to detect the rising edge of the trigger before feeding the trigger line to enable, reset, or other triggering parameters.

Name	Description	Data Type
Output	Pulses high when triggered	Logic
Src	External Trigger: Triggers RPX through the trigger in port zBus Trigger's A and B: synchronizes Triggering to RPX connected across chasis Software Trigger 's#1-10: Sends a trigger to an RPX device via a software control on the PC	Static

Equation:

L O = If (D1)

Example:

External Trigger - This circuit uses an external trigger as an Enable line to gate a tone on and off. When the external trigger goes high, the Cos2Gate will rise with a 10 ms rise time. When the external trigger goes low, the Cos2Gate will fall with a 10 ms fall time.

WordIn

Description:

Feeds the chain with an integer representation of the digital input port. The digital input port is logic 'ANDed' with the specified Mask and the resulting value is fed to the signal chain.

Name	Description	Data Type
Output	Integer representation of digital input port	Integer
M	Bit-mask. Decimal value for desired bits on port.	Integer

Note:

There is a two cycle delay when using the WordIn component.

Equation:

Io = Digital Port In 'AND' D₁

Example(s):

If Digital Port In = 7 and D_i = 3

Then I_o =3

Also see Working with WordIn - WordOut.

WordOut

Description:

Passes an integer value to the specified bits of the digital output port. Only bits specified in the Mask will be affected on the output port. Bits not specified in the Mask will be unaffected and can be used for other things.

Name	Description	Data Type
Input	Integer value digital representation of Digital Output port.	Integer
M	Bit-mask. Decimal value for desired bits on port.	Integer (Static)

Note:

There is a three cycle delay when using the WordOut component.

Important:! Circuits that contain both BitOut and WordOut the Bitmasks cannot overlap. For example, a circuit where the BitOut and WordOut both use bit 2 (BitMask=4) the circuit will try set the value based on the last component in the circuit.

Equation:

Digital Port Out = I_i for bits specified in D₁

Example(s):

If I_i = 7 and D₁ = 3

Then Port Out =3

Also see [Working with WordIn - WordOut] ](../circuit-design/digital-io.md#working-with-wordin-wordout).

RX Support for I/O Components

The tables below compare high performance processors support of various analog input/output RPvdsEx components.

Analog Outputs

Device	DacOut
RX5	x
RX6	x
RX7	x
RX8	x

Analog Inputs

Device	AdcIn	MCAdcIn	StereoAdc †
RX5	x	x	x
RX6	x*	x**
RX7	x	x	x
RX8	x	x	x

x supported

x* channels 1-16 access optical inputs, channels 128 and 129 access audio inputs

x** component supported for access to optical inputs only (use AdcIn or StereoADC for analog input BNCs)

† The StereoAdc component is limited to ADC channels one and two only.