Lectrosonics DMTH4, Reference Manual, Page: 48 / 70

DMTH4
LECTROSONICS, INC.
48
DMTH4 Matrix Crosspoint Commands
Command Description
xpgn Matrix crosspoint gain
xpmode Matrix crosspoint mix mode
xpmt Matrix crosspoint mute status
xpmttog Matrix crosspoint mute toggle
Note: All commands are terminated with an
ASCII carriage return character (hex code 0x0D),
represented by <CR> in the examples. All
responses are terminated with an ASCII carriage
return, line feed pair (hex codes 0x0D, 0x0A),
represented by <CRLF> in the examples. An
ellipsis (...) represents members of an array that
have been omitted from an example for the sake of
brevity.
xpgn (crosspoint gain)
This command is used as a query to read the matrix
crosspoint gain, or as an update to set the gain. The
crosspoint is specified by using the two dimensional
address syntax. Addresses for the first dimension (input
channel) must be in the range 1 to 3. Addresses for the
second dimension (mix bus) must be in the range 1 to
24, or a wildcard. If the mix bus is a wildcard, then the
command applies to the entire row of the matrix associ-
ated with the specified input channel. The data type is
integer, in the range -70 to +20, representing the gain
in dB. If an entire row is being transmitted then the data
type is array of integer of size 24. In this case the value
99 may be used in an update to indicate that a particular
crosspoint gain is to remain unchanged by the com-
mand.
Examples:
Request Response
Query
xpgn(1,7)?<CR> OK -3<CRLF>
Query
xpgn(1,*)?<CR> OK{0,3,0,...,0,0,0}
<CRLF>
Update
xpgn(2,2)=5<CR> OK<CRLF>
Update
xpgn(3,*)={0,5,...
,99,99}<CR> OK<CRLF>
xpmode (crosspoint mix mode)
This command is used as a query to read the matrix
crosspoint mix mode, or as an update to set the mode.
The crosspoint is specified by using the two dimensional
address syntax. Addresses for the first dimension (input
channel) must be in the range 1 to 3. Addresses for the
second dimension (mix bus) must be in the range 1 to
24, or a wildcard. If the mix bus is a wildcard, then the
command applies to the entire row of the matrix associ-
ated with the specified input channel. The data type is
integer, with the following values allowed:
0 means that the crosspoint is in DIRECT mode
1 means that the crosspoint is in OVERRIDE mode
2 means that the crosspoint is in BACKGROUND mode
3 means that the crosspoint is in AUTO mode
If an entire row is being transmitted then the data type
is array of integer of size 24. In this case the value
99
may be used in an update to indicate that a particular
crosspoint mix mode is to
remain unchanged by the
command.
Examples:
Request Response
Query
xpmode(1,9)?<CR> OK 3<CRLF>
Query
xpmode(1,*)?<CR> OK{3,0,
...,3,3}<CRLF>
Update
xpmode(3,1)=0<CR> OK<CRLF>
Update
xpmode(2,*)={3,1,3,
...,99,99,3}<CR> OK<CRLF>
xpmt (crosspoint mute)
This command is used as a query to read the matrix
crosspoint mute status, or as an update to set the status.
The crosspoint is specified by using the two dimensional
address syntax. Addresses for the first dimension (input
channel) must be in the range 1 to 3. Addresses for the
second dimension (mix bus) must be in the range 1 to
24, or a wildcard. If the mix bus is a wildcard, then the
command applies to the entire row of the matrix associ-
ated with the specified input channel. The data type is
integer, either “1” meaning that the crosspoint is muted,
or “0” meaning that it is not muted. If an entire row is
being transmitted then the data type is array of integer
of size 24. In this case the value
99 may be used in an
update to indicate that a particular crosspoint mute is to
remain unchanged by the command.
Examples:
Request Response
Query
xpmt(3,9)?<CR> OK 1<CRLF>
Query
xpmt(2,*)?<CR> OK{0,0,
...,1,0}<CRLF>
Update
xpmt(1,3)=0<CR> OK<CRLF>
Update
xpmt(2,*)={0,1,0,
... ,99,99,99}<CR> OK<CRLF>
xpmttog (crosspoint mute toggle)
This command is used as a simple command to toggle
the matrix crosspoint mute status. The crosspoint is
specified by using the two dimensional address syntax.
Addresses for the first dimension (input channel) must
be in the range 1 to 3. Addresses for the second dimen-
sion (mix bus) must be in the range 1 to 24.
Example:
Request Response
Command
xpmttog(3,9)<CR> OK<CRLF>