AMX Volume Control Card NXC-VOL4 - Manual (Page 2)

For full warranty information, refer to the AMX Instruction Manual(s) associated with your Product(s).
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
93-2024 REV: D
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.
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:
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.
• 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.
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 Channel Assignments (per port)
Port 1
Channel: Port 2
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.
NXC-VOL4 Levels
Port 1 Port 2
Level Description Level Description
1 Output #1 1 Output #3
2 Output #2 2 Output #4
NXC-VOL4 Send_Commands
PL
Ramps specified (audio)
channel(s) from current
level to a specified preset
level or percentage at the
current rate, or optionally
in a specified amount of
time. Syntax:
SEND_COMMAND <DEV> 'P<Output
Channel>L<Level>[T<Time>]'
Variables:
• Output Channel: Target audio channel number (0-2).
Output channel 0 means both channels 1 and 2.
• Level: Target level (0-255 or 0-100%). Level 0 is
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
Sets the ramp rate of the
specified channel(s)
where Time is the time to
ramp the full range both
down to up and up to
down, or optionally just
down to up or just up to
down. If Time is set to 50, it takes 5 seconds to ramp through
the full range of 0 to 255 (0-100%). It would take 2.5
seconds to ramp through half of the range and so on.
Syntax:
SEND_COMMAND <DEV> 'P<Output
Channel>R<Time>[U|D]'
Variables:
• Output Channel: Target channel number (0-2).
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).
• U|D: 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.