AMX NXC-VAI4 Level Assignments, Programming Information, NXC-VAI4 SENDCOMMANDs Cont, Levoff

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