Programming Information - AMX Voltage Output/Analog Input Card NXC-VAI4 Installation Manual

NXC-VAI4 Level Assignments:
NXC-VAI4 Level Assignments
Level Description
1 I/O 1 (Output 1). The range is from 0 (min) to 255 (max).
Conflicts with channels 1, 5, 10, 14, 18, 22.
2 I/O 2 (Output 2). The range is from 0 (min) to 255 (max).
Conflicts with channels 2, 6, 11, 15, 19, 23.
3 I/O 3 (Output 3). The range is from 0 (min) to 255 (max).
Conflicts with channels 3, 7, 12, 16, 20, 24.
4 I/O 4 (Output 4). The range is from 0 (min) to 255 (max).
Conflicts with channels 4, 8, 13, 17, 21, 25.
5 A level from the VAI4 card returns the current input voltage for I/O 5 (input 1).
Range: 0 - 255 (0 - 65,535)
6 A level from the VAI4 card returns the current input voltage for I/O 6 (input 2).
Range: 0 - 255 (0 - 65535)
7 A level from the VAI4 card returns the current input voltage for I/O 7 (input 3).
Range: 0 - 255 (0 - 65535)
8 A level from the VAI4 card returns the current input voltage for I/O 8 (input 4).
Range: 0 - 255 (0 - 65535)
Notes On Levels
For levels 5 - 8, the AD MODE command is used to set the level size to 8 or 16 bits.
The VAI4 card will send a CHANNEL OFF STATUS message for any conflicting ON
channels.
The Input and output Level Values will not be sent until a 'LEVON' Command
message is received by the VAI4 card. A transmission of levels will cease after the
receipt of a 'LEVOFF' Command message.
The values of Levels 1 through 8 (inputs) will be sent at power-up or whenever the
level changes by more than the selected amount.

Programming Information

These NetLinx Send_Commands control the NXC-VAI4:
NXC-VAI4 SEND_COMMANDs
AD MODE Even though the output is specified in the command, the for-
mat change really applies to the corresponding input. Input
Sets the format for data
level changes will be reported in this format. In 'servo' mode
reporting to either 8 or 10
commanded positions will be in this format. The reporting of
significant bits (16 bit for-
the output levels is unaffected.
mat with 10 significant bits).
SEND_COMMAND <DEV>,'AD MODE <I/O> 8|10'
The default format is 8 bits.
• I/O: Any Output I/O ('1', '2, '3', 4').
GAS When these variables are set, and a GL command is in prog-
ress, the speed output on Output <x> will be reduced to that
Sets the slowdown dis-
specified when the position as read on Output <x+4> is
tance and slowdown
within the distance specified away from the target position.
speed.
SEND_COMMAND
<DEV>,'G<OUTPUT>A<DISTANCE>S<SPEED>'
• OUTPUT: Any Output '1', '2', '3', or '4'.
• DISTANCE: 0-127.
• SPEED: 0-127.
GD The input or output level will only be reported when a change
greater than this deviation occurs. Deviation 0 is most accu-
Sets the maximum allow-
rate, but can have some oscillation
able deviation of final servo
position when executing
SEND_COMMAND <DEV>,'G<I/O>D <DEVIATION>'
the GL command. • I/O: Any input or output ('1', '2', '3', '4', '5', '6', '7'. '8').
The default is 2, (the posi- • DEVIATION: Number between 0 and 127 (default = 2).
tion as read at correspond-
ing input I/O <x+4> can be
within +/-2 from the speci-
fied position).
GL Position 0 is the low end of the potentiometer (lowest volt-
age) and position 255 (or 65535) is the high end (highest
This command puts the
voltage) with 128 (or 32768) as the middle of the range.
card in servo (positional)
control mode. Range = 0-
SEND_COMMAND
255 (if AD MODE is set to
<DEV>,'G<OUTPUT>L<POSITION>'
'8'), or 0-65535 (if AD
• I/O: Any Output ('1', '2, '3', 4').
MODE is set to '10').
• POSITION: Number between 0-255 or 0-65535 (depends
on AD MODE).
See AD MODE for details.
GS The change of speed takes place immediately even if a posi-
tional change operation is currently in progress. The voltage
Sets the speed variable to
output for speed 0 (i.e. no motion) is at the mid-point
be used for future posi-
between the Min and Max output voltages. The positive
tional (GL) commands.
speed 127 is the max and negative speed 127 is the min.
Speed '0' is slowest (no
Other speeds are scaled proportionately.
movement) and speed
'127' (default) is the fastest. SEND_COMMAND <DEV>,'G<OUTPUT>S<SPEED>'
• I/O: Any Output ('1', '2, '3', 4').
• SPEED: A fixed output value in the range of 0-127.
DEFAULT Sets all card settings (except for calibration) back to their
original factory settings.
3000 RESEARCH DRIVE, RICHARDSON, TX 75082 • 800.222.0193 • fax 469.624.7153 • technical support 800.932.6993 • www.amx.com
For full warranty information, refer to the AMX Instruction Manual(s) associated with your Product(s).
©2007 AMX. All rights reserved. AMX and the AMX logo are registered trademarks of AMX.
AMX reserves the right to alter specifications without notice at any time.
NXC-VAI4 SEND_COMMANDs (Cont.)
DEFAULT ALL
LEVOFF
LEVON
The VAI4 will not transmit
any level value messages
until after the receipt of this
command.
PC
This variable sets the
shape of the Output <x>
voltage ramps.
PE
Selects which voltage ref-
erence (if any) is to be
used for scaling of the out-
put voltage. The specified
output will then remain pro-
portional to the specified
input.
PL
Ramps the specified output
from its current level value
to the specified level value
or percentage of maximum
at the rate specified by
"CURRENT OUTPUT <x>
RAMP UP TIME" or option-
ally in the specified amount
of time.
PN
Sets the value of either the
minimum output voltage
allowed for an output, or
the minimum position volt-
age expected for an input.
PR
Sets the CURRENT OUT-
PUT <x> RAMP UP TIME
and/or CURRENT OUT-
PUT <x> RAMP DOWN
TIME of the specified Out-
put where TIME is the time
to ramp the full range.
PU
Sets the level to which this
Output is set immediately
after power-up and before
any Output is commanded.
PX
Sets the value of "I/O <x>
MAXIMUM" which is either
the maximum output volt-
age allowed for an Output,
or the maximum position
voltage expected for an
Input.
PZ
Sets one of the two "set
point"
variables "I/O <x> SET
POINT H|L". (high or low)
These variables are used
to calculate calibration
parameters for I/O <x>
(input or output).
12/07
Sets all card settings back to their original factory settings.
The VAI4 will not transmit any level value messages after the
receipt of this command until the receipt of the LEVON com-
mand.
SEND_COMMAND <DEV>,'LEVOFF'
This command is sent automatically when the
CREATE_LEVEL command is executed.
SEND_COMMAND <DEV>,'LEVON'
SEND_COMMAND <DEV>,'P<OUTPUT>C<CURVE>'
• I/O: Any Output ('1', '2', '3', or '4')
• CURVE: 'N' - Normal linear
'L' - Logarithmic
'I' - Inverted logarithmic
SEND_COMMAND <DEV>,'P<OUTPUT>E<REFERENCE
SELECTION> B|U'
• I/O: any Output ('1', '2', '3', or '4')
• Reference selection:
'N' - Normal/None: Uses no reference scaling.
'E' - External: Use the External Reference input to scale
the output.
'I' - Input: Use the corresponding <x+4> input as the
reference for the output.
• B|U: Bipolar or Unipolar (has no meaning for reference
selection 'N')
Bipolar mode sets the output voltage range to between -ref-
erence voltage and + reference voltage.
Unipolar mode sets the voltage range to between 0V and +
reference voltage.
SEND_COMMAND <DEV>,'P<OUTPUT>L<LEVEL
VALUE> [T<TIME>]'
• I/O: Any Output ('1', '2', '3', or '4')
• LEVEL VALUE: 0 - 255 or 0 - 100% (where 0 is low
voltage)
• TIME (optional): 0 - 255 in 0.1 second increments
Voltage settings are rounded to the nearest D/A or A/D code.
Voltage settings for Outputs are absolute levels and are
unaffected by any software scaling functions. Negative volt-
ages are not valid for Input 3.
SEND_COMMAND <DEV>,'P<I/O>N<level
value>'
• I/O: Any input or output ('1','2','3','4','5','6','7','8')
• LEVEL VALUE: -12.000V to +12.000V
The ramp time can be set to ramp both down to up and up to
down or just down to up or just up to down.
SEND_COMMAND
<DEV>,'P<OUTPUT>R<TIME>[U|D]'
• I/O: Any Output '1', '2', '3', or '4'
• TIME: 0 - 255 in 0.1 second increments
SEND_COMMAND <DEV>,'P<OUTPUT>U<LEVEL
VALUE>'
• I/O: Any Output ('1', '2', '3', or '4')
• LEVEL VALUE: 0-255
Voltage settings are rounded to the nearest D/A or A/D code.
Voltage settings are absolute levels and are unaffected by
any scaling functions.
Negative voltages are not valid for Inputs.
SEND_COMMAND <DEV>,'P<I/O>X<LEVEL
VALUE>'
• I/O: Any input or output ('1', '2', '3', '4', '5', '6', '7', '8')
• LEVEL VALUE: 12.000V to +12.000V
Receiving this command with no voltage specified returns
the specified set point to the default value.
SEND_COMMAND <DEV>,'P<I/O>Z<VOLTAGE>H|L'
I/O: Any input or output ('1', '2', '3', '4', '5', '6', '7', '8' plus '0' for
EREF)
VOLTAGE: The current actual/measured voltage at the I/O.
93-2025 REV: D