DM84 Rear Panel Control Commands

rpingn	Rear panel audio input gain
rpingnmin	Rear panel audio input gain minimum
rpingnpre	Rear panel audio input gain preset
rpingnst	Rear panel audio input gain step
rpoutgn	Rear panel audio output gain
rpoutgnmin	Rear panel audio output gain minimum
rpoutgnpre	Rear panel audio output gain preset
rpoutgnst	Rear panel audio output gain step
rpsave	Save rear panel settings
rprest	Restore rear panel settings

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>

rpingn (rear panel audio input gain)

This command may be used as a query to read the rear panel input gain, or as an update to set the rear panel 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 -61 to 0, representing the gain in dB (the feature acts as an attenuator), where -61 has the special meaning "Off". The actual allowable range of values is determined by the gain minimum and gain preset values. If the value sent in an update request exceeds the preset, it is forced the the preset value; if the value sent is less than the gain minimum, it is forced to the gain minimum value. 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 rear panel input gain is to remain unchanged by the command.

Examples:

	REQUEST	RESPONSE
QUERY	rpingn(1)?<CR>	OK -3<CRLF>
QUERY	rpingn(*)?<CR>	OK {-13,-4,0,...,0,0,0}<CRLF>
UPDATE	rpingn(2)=0<CR>	OK<CRLF>
UPDATE	rpingn(*)={0,-5,0,...,99,99,-10}<CR>	OK<CRLF>

rpingnmin (rear panel audio input gain minimum)

This command may be used as a query to read the rear panel input gain minimum, or as an update to set the gain minimum. All rear panel audio input gains are controlled by this minimum value. The data type is integer, in the range -61 to 0, representing the minimum gain in dB (i.e. the maximum attenuation possible using rear panel gain control). The value -61 has the special meaning "Off", or infinite attenuation.

Examples:

	REQUEST	RESPONSE
QUERY	rpingnmin?<CR>	OK -30<CRLF>
UPDATE	rpingnmin=-15<CR>	OK<CRLF>

rpingnpre (rear panel audio input gain preset)

This command may be used as a query to read the rear panel input gain preset, or as an update to set the gain preset. All rear panel audio input gains are controlled by this preset value, which is the value loaded when the device is powered up. The data type is integer, in the range -60 to 0, representing gain in dB (i.e. the minimum attenuation possible using rear panel gain control).

Examples:

	REQUEST	RESPONSE
QUERY	rpingnpre?<CR>	OK 0<CRLF>
UPDATE	rpingnpre=-5<CR>	OK<CRLF>

rpingnst (rear panel input gain step change)

This command is used as an update to step the gain by the amount specified, either up or down. 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 -6 to +6, representing the gain step in dB. If the channel address is wildcarded, then the data type is an array of integer of size 8. A positive value increments the gain, a negative value decrements the gain.

Examples:

	REQUEST	RESPONSE
UPDATE	rpingnst(2)=-2<CR>	OK<CRLF>
UPDATE	rpingnst(*)={-2,-2,-2,...-2,-2,-2}<CR>	OK<CRLF>

rpoutgn (rear panel audio output gain)

This command may be used as a query to read the rear panel output gain, or as an update to set the rear panel gain. The output channel is specified by using the address syntax. Addresses must be in the range 1 to 4. The data type is integer, in the range -61 to 0, representing the gain in dB (the feature acts as an attenuator), where -61 has the special meaning "Off". The actual allowable range of values is determined by the gain minimum and gain preset values. If the value sent in an update request exceeds the preset, it is forced the the preset value; if the value sent is less than the gain minimum, it is forced to the gain minimum value. If the channel address is wildcarded, then the data type is an array of integer of size 4. In this case the value 99 may be used in an update to indicate that a particular rear panel output gain is to remain unchanged by the command.

Examples:

	REQUEST	RESPONSE
QUERY	rpoutgn(1)?<CR>	OK -3<CRLF>
QUERY	rpoutgn(*)?<CR>	OK {-13,-4,0,0}<CRLF>
UPDATE	rpoutgn(2)=0<CR>	OK<CRLF>
UPDATE	rpoutgn(*)={0,-5,0,-10}<CR>	OK<CRLF>

rpoutgnmin (rear panel audio output gain minimum)

This command may be used as a query to read the rear panel output gain minimum, or as an update to set the gain minimum. All rear panel audio output gains are controlled by this minimum value. The data type is integer, in the range -61 to 0, representing the minimum gain in dB (i.e. the maximum attenuation possible using rear panel gain control). The value -61 has the special meaning "Off", or infinite attenuation.

Examples:

	REQUEST	RESPONSE
QUERY	rpoutgnmin?<CR>	OK -30<CRLF>
UPDATE	rpoutgnmin=-15<CR>	OK<CRLF>

rpoutgnpre (rear panel audio output gain preset)

This command may be used as a query to read the rear panel output gain preset, or as an update to set the gain preset. All rear panel audio output gains are controlled by this preset value, which is the value loaded when the device is powered up. The data type is integer, in the range -60 to 0, representing gain in dB (i.e. the minimum attenuation possible using rear panel gain control).

Examples:

	REQUEST	RESPONSE
QUERY	rpoutgnpre?<CR>	OK 0<CRLF>
UPDATE	rpoutgnpre=-5<CR>	OK<CRLF>

rpoutgnst (rear panel output gain step change)

This command is used as an update to step the gain by the amount specified, either up or down. The output channel is specified by using the address syntax. Addresses must be in the range 1 to 4. The data type is integer, in the range -6 to +6, representing the gain step in dB. If the channel address is wildcarded, then the data type is an array of integer of size 4. A positive value increments the gain, a negative value decrements the gain.

Examples:

	REQUEST	RESPONSE
UPDATE	rpoutgnst(2)=-2<CR>	OK<CRLF>
UPDATE	rpoutgnst(*)={-2,-2,-2,-2}<CR>	OK<CRLF>

rprest (restore rear panel settings)

This command may be used to restore the state of rear panel settings previously saved with the rpsave command. If used as a simple command, all rear panel settings are overwritten with the saved values. If used as an update, the data type is an integer whose value serves as a mask which specifies which settings are restored and which are not. This mask has the same format as the preset mask.

Examples:

	REQUEST	RESPONSE
COMMAND	rprest<CR>	OK<CRLF>
UPDATE	rprest=1<CR>	OK<CRLF>

rpsave (save rear panel settings)

This command may be used to save the current rear panel settings so that they can be restored at some future time by use of the rprest command. In this way a "snapshot" of the current rear panel gain and mute settings can be taken prior to some temporary reconfiguration of the device.

Example:

	REQUEST	RESPONSE
COMMAND	rpsave<CR>	OK<CRLF>

Copyright © 2006 Lectrosonics, Inc.