RATC changeGroupGet Command

Usage

The Control Groups in the ChangeGroup are polled for value changes with the command:

changeGroupGet n\r

where n is the number of changes the client wishes to read. If n is not supplied, all values that have changed, up to a maximum of 50, will be returned. If there are more changed values than are requested, subsequent changeGroupGet commands will return them.

Response

On success, RATC responds with the minimum of the number of values that have changed and number of changes that were requested, and then a value for each change. For example: 

numberOfChanges 2\r\n
valueIs "Main Gain" -15.2dB 46.1%\r\n
valueIs "Channel1Gain" -20.0dB 50.0%\r\n

In this example, there are two Control Groups in the ChangeGroup that have changed since the last query. If the command is issued again, with no Control Groups having been twiddled, or if there are no Control Groups in the ChangeGroup, the response will be:

numberOfChanges 0\r\n

Possible Error Messages

\aBadArgumentCount\r\n

\aOverflow\r\n

\aNotRunning\r\n

\aInvalidChangeGroup