DM84 Matrix Crosspoint Commands

xpgn Matrix crosspoint gain
xpgnst Matrix crosspoint gain step
xpmode Matrix crosspoint mix mode
xpmt Matrix crosspoint mute status
xpmttog Matrix crosspoint mute toggle

Termination: all commands are terminated with an ASCII carriage return character (hex code 0x0D), represented by <CR> in the examples below. All responses are terminated with an ASCII carriage return, line feed pair (hex codes 0x0D, 0x0A), represented by <CRLF> in the examples below. An ellipsis (...) represents members of an array that have been omitted from an example for the sake of brevity.

Verbose response: commands prefixed with an exclamation point (bang) character result in a "verbose" response containing the name of the property or action being addressed, along with the current values of the property in question. Property values are always returned in the "assignment" form, for example outmt(2)=1. This supports certain 3rd party control programming styles where the response to all responses needs to be self-describing and/or contain current property values.

Examples:

REQUEST

RESPONSE
COMMAND

!store(3)<CR>

OK store(3)<CRLF>
COMMAND

!run={1,3,5}<CR>

OK run={1,3,5}<CRLF>
QUERY

!outgn(3)?<CR>

OK outgn(3)=0<CRLF>
QUERY

!outmt(*)?<CR>

OK outmt(*)={0,1,1,0}<CRLF>
UPDATE

!ingn(3)=0<CR>

OK ingn(3)=0<CRLF>
UPDATE

!outmt(*)={0,1,1,0}<CR>

OK outmt(*)={0,1,1,0}<CRLF>

 

xpgn (crosspoint gain)

This command may be 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 2 dimensional address syntax. Addresses for the first dimension (input channel) must be in the range 1 to 8, or wildcarded. Addresses for the second dimension (mix bus) must be in the range 1 to 24, or wildcarded. If the input is wildcarded, then the command applies to the entire column of the matrix associated with the specified mix bus. If the output is wildcarded, then the command applies to the entire row of the matrix associated with the specified input channel. The data type is integer, in the range -70 to +20, representing the gain in dB. The value -70 has the special meaning Off. If an entire column is being transmitted then the data type is array of integer of size 8. If an entire row is being transmitted then the data type is array of integer of size 24. In these cases the value 99 may be used in an update to indicate that a particular crosspoint gain is to remain unchanged by the command.

Examples:

REQUEST

RESPONSE
QUERY

xpgn(1,7)?<CR>

OK -3<CRLF>
QUERY

xpgn(*,1)?<CR>

OK {0,3,0,...0,0,0}<CRLF>
QUERY

xpgn(1,*)?<CR>

OK {0,3,0,...0,0,0}<CRLF>
UPDATE

xpgn(5,2)=5<CR>

OK<CRLF>
UPDATE

xpgn(*,5)={0,5,3,...99,99,99}<CR>

OK<CRLF>
UPDATE

xpgn(5,*)={0,5,3,...99,99,99}<CR>

OK<CRLF>

 

xpgnst (matrix crosspoint gain step change)

This command is used as an update to step the gain by the amount specified, either up or down. The crosspoint is specified by using the 2 dimensional address syntax. Addresses for the first dimension (input channel) must be in the range 1 to 8, or wildcarded. Addresses for the second dimension (mix bus) must be in the range 1 to 24, or wildcarded. If the input is wildcarded, then the command applies to the entire column of the matrix associated with the specified mix bus. If the output is wildcarded, then the command applies to the entire row of the matrix associated with the specified input channel. The data type is integer, in the range -6 to +6, representing the gain step in dB. A positive value increments the gain, a negative value decrements the gain. If an entire column is being transmitted then the data type is array of integer of size 8. If an entire row is being transmitted then the data type is array of integer of size 24.

Examples:

REQUEST

RESPONSE
UPDATE

xpgnst(2,2)=2<CR>

OK<CRLF>
UPDATE

xpgnst(*,3)={2,2,2,...0,0,0}<CR>

OK<CRLF>
UPDATE

xpgnst(3,*)={-1,-1,-1,...0,0,0}<CR>

OK<CRLF>

 

xpmode (crosspoint mix mode)

This command may be 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 2 dimensional address syntax. Addresses for the first dimension (input channel) must be in the range 1 to 8, or wildcarded. Addresses for the second dimension (mix bus) must be in the range 1 to 24, or wildcarded. If the input is wildcarded, then the command applies to the entire column of the matrix associated with the specified mix bus. If the output is wildcarded, then the command applies to the entire row of the matrix associated with the specified input channel. The data type is integer, with the following values allowed:

If an entire column is being transmitted then the data type is array of integer of size 8. If an entire row is being transmitted then the data type is array of integer of size 24. In these cases 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(5,9)?<CR>

OK 3<CRLF>
QUERY

xpmode(*,1)?<CR>

OK {3,3,0,...3,3,3}<CRLF>
QUERY

xpmode(1,*)?<CR>

OK {3,3,0,...3,3,3}<CRLF>
UPDATE

xpmode(8,1)=0<CR>

OK<CRLF>
UPDATE

xpmode(*,5)={3,1,3,...99,99,3}<CR>

OK<CRLF>
UPDATE

xpmode(5,*)={3,1,3,...99,99,3}<CR>

OK<CRLF>

 

xpmt (crosspoint mute)

This command may be 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 2 dimensional address syntax. Addresses for the first dimension (input channel) must be in the range 1 to 8, or wildcarded. Addresses for the second dimension (mix bus) must be in the range 1 to 24, or wildcarded. If the input is wildcarded, then the command applies to the entire column of the matrix associated with the specified mix bus. If the output is wildcarded, then the command applies to the entire row of the matrix associated 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. If an entire column is being transmitted then the data type is array of integer of size 8. If an entire row is being transmitted then the data type is array of integer of size 24. In these cases 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(*,5)?<CR>

OK {0,0,0,...1,1,0}<CRLF>
QUERY

xpmt(5,*)?<CR>

OK {0,0,0,...1,1,0}<CRLF>
UPDATE

xpmt(1,3)=0<CR>

OK<CRLF>
UPDATE

xpmt(*,5)={0,1,0,...99,99,99}<CR>

OK<CRLF>
UPDATE

xpmt(5,*)={0,1,0,...99,99,99}<CR>

OK<CRLF>

 

xpmttog (crosspoint mute toggle)

This command may be used as a simple command to toggle the matrix crosspoint mute status. The crosspoint is specified by using the 2 dimensional address syntax. Addresses for the first dimension (input channel) must be in the range 1 to 8. Addresses for the second dimension (mix bus) must be in the range 1 to 24.

Examples:

REQUEST

RESPONSE
COMMAND

xpmttog(3,9)<CR>

OK<CRLF>

 

Copyright © 2006 Lectrosonics, Inc.