DM84 Audio Input Commands

inact Audio input activity status
incl Audio input clipping status
indel Audio input delay
ingn Audio input gain
ingnfp Audio input Front Panel gain
iniv

Audio input phase invert status
inlb

Audio input channel label

inlv

 Audio input level (dBu RMS)
inmt Audio input mute status
inmttog Audio input mute toggle
inph

Audio input phantom power status

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

!ingn(3)?<CR>

OK ingn(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>

 

inact (input activity)

This command may be used to determine if an audio input channel is active, meaning that it has less than 3 dB of attenuation assigned to it by the automixing algorithm for some particular output channel. Two forms exist for this command:

Examples:

REQUEST

RESPONSE
QUERY

inact(5)?<CR>

OK 0<CRLF>
QUERY

inact(*)?<CR>

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

inact(5,5)?<CR>

OK 0<CRLF>
QUERY

inact(5,*)?<CR>

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

 

incl (input clipping)

This command may be used to determine if an audio input channel is clipping, meaning that it is being overdriven by the input signal to the point of saturating the analog to digital converter. The input channel is specified by using the address syntax. Addresses must be in the range 1 to 8. The data type is integer, either "1" meaning that the channel is in clipping, or "0" meaning that it is not. If the channel address is wildcarded, then the data type is an array of integer of size 8.

Examples:

REQUEST

RESPONSE
QUERY

incl(7)?<CR>

OK 1<CRLF>
QUERY

incl(*)?<CR>

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

 

indel (input delay)

This command may be used as a query to read the input delay, or as an update to set the delay. The input channel is specified by using the address syntax. Addresses must be in the range 1 to 8. The data type is integer, in the range 0 to 200, representing the time delay in one half millisecond increments. If the channel address is wildcarded, then the data type is an array of integer of size 8. In this case the value 9999 may be used in an update to indicate that a particular input delay is to remain unchanged by the command.

Examples:

REQUEST

RESPONSE
QUERY

indel(1)?<CR>

OK 42<CRLF>
QUERY

indel(*)?<CR>

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

indel(5)=30<CR>

OK<CRLF>
UPDATE

indel(*)={12,0,0,...,8,9999,9999}<CR>

OK<CRLF>

 

ingn (input gain)

This command may be used as a query to read the input channel gain, or as an update to set the gain. The input channel is specified by using the address syntax. Addresses must be in the range 1 to 8. The data type is integer, in the range -10 to +60, representing the gain in dB. If the channel address is wildcarded, then the data type is an array of integer of size 8. In this case the value 99 may be used in an update to indicate that a particular input gain is to remain unchanged by the command.

Examples:

REQUEST

RESPONSE
QUERY

ingn(1)?<CR>

OK 42<CRLF>
QUERY

ingn(*)?<CR>

OK {40,40,50,...,0,0,0}<CRLF>
UPDATE

ingn(5)=30<CR>

OK<CRLF>
UPDATE

ingn(*)={40,40,50,...,0,99,99}<CR>

OK<CRLF>

 

ingnfp (input front panel gain)

This command may be used as a query to read the input channel Front Panel gain, which is controlled by the knobs on the DM84 front panel. The input channel is specified by using the address syntax. Addresses must be in the range 1 to 8. The data type is integer, in a range determined by the Front Panel gain range setting, representing the gain in dB. If the channel address is wildcarded, then the data type is an array of integer of size 8.

Examples:

REQUEST

RESPONSE
QUERY

ingnfp(1)?<CR>

OK 15<CRLF>
QUERY

ingnfp(*)?<CR>

OK {10,-3,5,...,0,0,0}<CRLF>

 

iniv (input phase invert)

This command may be used as a query to read the input channel phase invert status, or as an update to set the status. The input channel is specified by using the address syntax. Addresses must be in the range 1 to 8. The data type is integer, either "1" meaning that the input has the audio phase inverted (shifted by 180 degrees), or "0" meaning that it is not. If the channel address is wildcarded, then the data type is an array of integer of size 8. In this case the value 99 may be used in an update to indicate that a particular input invert state is to remain unchanged by the command.

Examples:

REQUEST

RESPONSE
QUERY

iniv(3)?<CR>

OK 0<CRLF>
QUERY

iniv(*)?<CR>

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

iniv(2)=1<CR>

OK<CRLF>
UPDATE

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

OK<CRLF>

 

inlb (input channel label)

This command may be used as a query to read the input channel text label, or as an update to set the label. The input channel is specified by using the address syntax. Addresses must be in the range 1 to 8. The data type is string, with a limit of 15 characters.

Note: String arguments in commands need to be passed in quoted form, contained in a pair of double-quote (") characters. A problem arises when using the inlb command to read or write a string that already contains double-quote characters, for example: The "Hula" Room. The solution is to escape the double quotes within The "Hula" Room so that it can be passed as a string argument for the inlb command. This is done by preceding the double-quote characters with a backslash character like this: The \"Hula\" Room. Now it can be passed as a string argument to the inlb command: inlb(1)="The \"Hula\" Room". Since the backslash serves as the escape character in quoted-string arguments, it too must be escaped if it is part of the string, so "foo\bar" would become "foo\\bar" .

Examples:

REQUEST

RESPONSE
QUERY

inlb(1)?<CR>

OK "Chairman"<CRLF>
UPDATE

inlb(2)="#3 West"<CR>

OK<CRLF>

 

inlv (input level)

This command may be used as a query to read the input channel level. The input channel is specified by using the address syntax. Addresses must be in the range 1 to 8. The data type is integer, in the range -70 to +20, representing the RMS audio level in dBu as measured AFTER the input preamplifier. If the channel address is wildcarded, then the data type is an array of integer of size 8.

Examples:

REQUEST

RESPONSE
QUERY

inlv(1)?<CR>

OK -23<CRLF>
QUERY

inlv(*)?<CR>

OK {-2,4,-10,...,-53,-71,-60}<CRLF>

 

inmt (input mute)

This command may be used as a query to read the input channel mute status, or as an update to set the status. The input channel is specified by using the address syntax. Addresses must be in the range 1 to 8. The data type is integer, either "1" meaning that the input is muted, or "0" meaning that it is not. If the channel address is wildcarded, then the data type is an array of integer of size 8. In this case the value 99 may be used in an update to indicate that a particular input mute is to remain unchanged by the command.

Examples:

REQUEST

RESPONSE
QUERY

inmt(3)?<CR>

OK 1<CRLF>
QUERY

inmt(*)?<CR>

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

inmt(2)=0<CR>

OK<CRLF>
UPDATE

inmt(*)={0,0,0,...,99,99,0}<CR>

OK<CRLF>

 

inmttog (input mute toggle)

This command may be used as a simple comand to toggle the input channel mute status. The input channel is specified by using the address syntax. Addresses must be in the range 1 to 8.

Examples:

REQUEST

RESPONSE
COMMAND

inmttog(4)<CR>

OK<CRLF>

 

inph (input phantom power)

This command may be used as a query to read the input phantom power status, or as an update to set the status. The input channel is specified by using the address syntax. Addresses must be in the range 1 to 8. The data type is integer, either "1" meaning that phantom power is enabled, or "0" meaning that it is not. If the channel address is wildcarded, then the data type is an array of integer of size 8.

Examples:

REQUEST

RESPONSE
QUERY

inph(3)?<CR>

OK 1<CRLF>
QUERY

inph(*)?<CR>

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

inph(4)=0<CR>

OK<CRLF>
UPDATE

inph(*)={0,1,1,...,1,1,1}<CR>

OK<CRLF>

 

Copyright © 2006 Lectrosonics, Inc.