AMX specifications NXC-VOL4 Channel Assignments, NXC-VOL4 Levels, Programming Information

NXC-VOL4 Channel Assignments:

The NXC- VOL4 has 2 ports with 2 audio "channels" in each port. The two audio "channels", which can be used as right and left, should not be confused with the channel assignments channels, which are sent to and from the card.

NXC-VOL4 Channel Assignments (per port)

Port 1	Port 2
Channel:	Channel:	Description
1	1	While channel is on, ramps the volume on audio chan-
		nels 1, 2 up (increase).
2	2	While channel is on, ramps the volume on audio chan-
		nels 1 and 2 down (decrease).
3	3	While channel is on, the volume on audio channels 1 and
		2 are muted (lowest volume), and when channel is turned
		off the volume levels are restored to their previous levels.
4	4	While channel is on, ramps the volume on audio channel
		1 up (increase).
5	5	While channel is on, ramps the volume on audio channel
		1 down (decrease).
6	6	While channel is on, the volume on audio channel 1 is
		muted
		(lowest volume), and when channel is turned off the vol-
		ume level is restored.
7	7	While channel is on, ramps the volume for audio channel
		2 up (increase).
8	8	While channel is on, ramps the volume for audio channel
		2 down (decrease).
9	9	While channel is on, volume for audio channel 2 is muted
		(lowest volume), and when channel is turned off the vol-
		ume level is restored.

Ramping a volume channel while the mute channel is on will not automatically turn off the mute channel but the ramping will still occur, and the volume change will be noticed when the mute channel is turned off.

For setting ramp rates and presets, refer to the Send_Commands. For reading current volume levels and displaying bargraphs see CREATE_LEVEL and SEND_LEVEL programming instructions. Volume (audio) channels 1 and 2 use levels 1 and 2 respectively.

Note: When controlling levels, such as with an active bargraph, there is no LED indication of volume changes.

NXC-VOL4 Levels:

Volume (audio) channels 1 and 2 use levels 1 and 2 respectively. For reading current volume levels and displaying bargraphs see CREATE_LEVEL and SEND_LEVEL. The two levels associated with each port of the NXC-VOL4 Control Card are listed in the table below:

NXC-VOL4 Levels

Port 1		Port 2
Level	Description	Level	Description
1	Output #1	1	Output #3
2	Output #2	2	Output #4

CREATE_LEVEL

This keyword creates an association between a specified level of a device and a variable that will contain the value of the level. This can only appear in the DEFINE_START section of the program.

CREATE_LEVEL DEV, Level, Value

Parameters:

•DEV: The device from which to read the level.

•Level: The level of the device to read.

•Value: Variable in which to store the level value.

•DevLev: A DEVLEV structure.

SEND_LEVEL

This keyword sends a value to a specific level on a NetLinx device/port. The syntax follows any one of the four following examples:

SEND_LEVEL DEV, Level, Value

SEND_LEVEL DEV[ ], Level, Value

SEND_LEVEL DEVLEV, Value

SEND_LEVEL DEVLEV[ ], Value

Parameters:

•DEV: Device containing the specified level

•Level: Number of the level to receive the new value

•Value: New level value

•DEV[ ]: Device array (each device contains the specified level)

•DEVLEV: Device-level to receive the new value

•DL[ ]: Device-level array (each will receive the new value)

Programming Information:

These NetLinx Send_Commands control the NXC-VOL4.

NXC-VOL4 Send_Commands

PL	Syntax:
Ramps specified (audio)	SEND_COMMAND <DEV> 'P<Output
channel(s) from current	Channel>L<Level>[T<Time>]'
level to a specified preset	Variables:
level or percentage at the	• Output Channel: Target audio channel number (0-2).
current rate, or optionally
	Output channel 0 means both channels 1 and 2.
in a specified amount of
	• Level: Target level (0-255 or 0-100%). Level 0 is
time.
	lowest volume (mute) and 255 (or 100%) is
	maximum volume.
	• Time: Specifies the amount of time (in .10-second
	increments) it takes to ramp the specified audio
	channel to the specified level.
	Example:
	SEND_COMMAND MYDEVICE1, 'P0L50%'
	SEND_COMMAND MYDEVICE2, 'P0L50%'
	Respectively, MYDEVICE1 is port 1 or channels 1 and
	2 and MYDEVICE2 is port 2 or channels 3 and 4.
	This ramps both audio channels to 50% volume at the
	current ramp rate.
PR	If Time is set to 50, it takes 5 seconds to ramp through
Sets the ramp rate of the	the full range of 0 to 255 (0-100%). It would take 2.5
specified channel(s)	seconds to ramp through half of the range and so on.
where Time is the time to	Syntax:
ramp the full range both	SEND_COMMAND <DEV> 'P<Output
down to up and up to	Channel>R<Time>[UD]'
down, or optionally just	Variables:
down to up or just up to
	• Output Channel: Target channel number (0-2).
down.
	Output channel 0 means both channels 1 and 2.
	• Time: Specifies the amount of time (in .10-second
	increments) that it would take to ramp the full range
	of 0-100% (down to up and up to down or optionally
	just down to up or just up to down).
	• UD: Ramp the specified channel(s) from down to up
	(U) or from up to down (D).
	Example:
	SEND_COMMAND MYDEVICE 'P0R50'
	Sets ramp rate of audio channels 1 and 2 to five sec-
	onds full range from down to up and up to down.

•Value: Variable in which to store the level value CREATE_LEVEL DevLev, Value.

During execution of the program, NetLinx continuously updates the variable to match the level that it represents.

For full warranty information, refer to the AMX Instruction Manual(s) associated with your Product(s). 93-2024 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