16 s – Grass Valley iControl Services Gateway User Manual
Page 18
Page 18 of 26
1.1.16 S
ETTING A
P
ARAMETER TO
A
V
ALUE
(
SET
[P
ARAMETER
])
Purpose:
To affect a parameter of a Service Node Access Key.
Pre-Requisites:
Short Identifier of the Node Service is known.
IP address of the Service Node is known.
TCP/IP socket port 13000 has been successfully opened at
<address>
of Service Node..
A session with the Miranda Service Node we want to control has been successfully opened with
the command <openID>[Service Node Short Identifier]</openID>
XML Syntax:
<set[param]>[type]?[value]></set[param>
Where [param] is any of the parameter tags . Ex.luma
[type]
– possible values “inc”,”dec”,”set”
[value]
– depending of [type] can be 1 to n for inc and dec or the absolute value to set.
All iControl‟s access keys start with lower-case letter. A set command for a specific parameter will be
constructed using the next rule:
“<set”+ Service Access key with first letter in capital (lowercase is also accepted) + “>” + [type] +
“?”+”value”+”</set”+ Access key with first letter in capital +“>
Ex.: Service Access Key = “luma”
set command = “<setLuma>set 60</setLuma>
or
= “<setLuma>inc 2</setLuma>
For the numeric parameters, when [type] is
“inc” or “dec” , the effect will be the increase/decrease of the
current parameter value with a quantity equal to {value]*step , where step is given by the parameterInfo
message. For example, in the case of a parameter with step = 0.5, “inc 3” will increase the current value
with 1.5.
In case of choice parameters, inc/dec will set the next/previous valid choice in the choice list.
Replies:
{…}<ack/
>{…}<[param/][value1]□[value2]□…[valueN]<param/>
where the number of [valueN] values
varies accordingly to the parameter.
{…}<nack/>
Example:
Setting the Luma of a Service Node that supports Luma.
<setLuma>inc 1</setLuma>{…}<ack/>\r{…}<luma>61?[unit]</luma>\r
<setLuma>dec 1</setLuma>{...}<ack/>\r{...}<luma>60 [unit]</luma>\r
<setLuma>set 50.0</setLuma>{...}<ack/>\r{...}<luma>50 [unit]</luma>\r
If following the execution of the set command, the parameter value did not change, only <ack/>
message is returned in response.
If [value] is out of range, the command will not be executed and only <ack/> message will be returned.
In the case of interdependent parameters, (like Luma being also part of a total gain parameter), a set
command may also change the other related parameters. The Gateway will send in return also the