Variable-Management; Value Assignment; Addition And Subtraction (Add Method) - Lightware HDMI-TPS-TX226 User Manual

   
7.LW3Programmer'sReference
7.10. Variable-Management

DIFFERENCE: This feature and the commands are available only for SW4-TPS-TX240-Plus from FW
packagev1.3.0b6.
Customvariables(30pcs.)canbedefinedinnumberortextformatwhichareavailablealsointheEvent
Manager. The maximum length of a variable can be 15 characters and they are stored in a non-volatile
memory,thus,thevalueiskeptincaseofareboot.Thetypeofthevariable(textorstring)isdetermined
automaticallybasedonthevalue.Ifanoperationcannotbeperformed(e.g.addingnumbervaluetoastring-
type variable), error will be the response.
7.10.1. Value Assignment
Command and Response
SET·/CTRL/VARS/V<loc>.Value=<value>
ç
pw·/CTRL/VARS/V<loc>.Value=<value>
æ
Parameters
Parameter Parameterdescription
<loc> The location of the variable
<value> The value of the variable
Example
ç SET/CTRL/VARS/V1.Value=120
æ pw/CTRL/VARS/V1.Value=120
7.10.2. Addition and Subtraction (Add Method)
Thevalueofanumericvariablecanbeincreasedbyaddingapositivevalueoritcanbedecreasedbyadding
anegativevalue.Minimumandmaximumvaluescanbedefinedaslimits.
Command and Response
ç CALL·/CTRL/VARS/V<loc>:add(<operand>;<min>;<max>)
æ mO·/CTRL/VARS/V<loc>:add
Parameters
Parameter Parameterdescription
<loc> The location of the variable
<operand> The value that is added to the variable
<min> The lowest allowed value (optional)
<max> Thehighestallowedvalue(optional)
Ifthevalueofthevariableishigherorequalswith<max>, the new value will be <max>.Likewise,incaseof
<min>setting:ifthevalueofthevariableislowerorequalswith<min>, the new value will be <min>.
#variables
Value Valuedescription
1-30
Length can be max 15 characters.
Numericvariableisdefinedbetween
Custom
-2147483648and2147483647.
Value Valuedescription
1-30
Negativevalueisalsoaccepted
Integer
Negativevalueisalsoaccepted
Integer
Negativevalueisalsoaccepted
Integer
Appliedfirmwarepackage:v1.3.2b3 | LDCsoftware:v2.5.7b2
HDMI-TPS-TX200series–User'sManual
Examples
Changemessages(CHG)canbeseenaftereachresponseforthebetterunderstanding,whichisnotthepart
of the command, but it can be set as described in the
Example 1 – addition
ç GET/CTRL/VARS/V1.Value
æ pw/CTRL/VARS/V1.Value=6
ç CALL/CTRL/VARS/V1:add(1)
æ mO/CTRL/VARS/V1:add
æ CHG/CTRL/VARS/V1.Value=7
ç CALL/CTRL/VARS/V1:add(1)
æ mO/CTRL/VARS/V1:add
æ CHG/CTRL/VARS/V1.Value=8
ç CALL/CTRL/VARS/V1:add(2)
æ mO/CTRL/VARS/V1:add
æ CHG/CTRL/VARS/V1.Value=10
Example 3 – addition with 'max' value
ç GET/CTRL/VARS/V1.Value
æ pw/CTRL/VARS/V1.Value=16
ç CALL/CTRL/VARS/V1:add(2;10;20)
æ mO/CTRL/VARS/V1:add
æ CHG/CTRL/VARS/V1.Value=18
ç CALL/CTRL/VARS/V1:add(2;10;20)
æ mO/CTRL/VARS/V1:add
æ CHG/CTRL/VARS/V1.Value=20
ç CALL/CTRL/VARS/V1:add(2;10;20)
æ mO/CTRL/VARS/V1:add
æ CHG/CTRL/VARS/V1.Value=20
Subscription section.
Example 2 – subtraction
ç GET/CTRL/VARS/V1.Value
æ pw/CTRL/VARS/V1.Value=10
ç CALL/CTRL/VARS/V1:add(-2)
æ mO/CTRL/VARS/V1:add
æ CHG/CTRL/VARS/V1.Value=8
ç CALL/CTRL/VARS/V1:add(-2)
æ mO/CTRL/VARS/V1:add
æ CHG/CTRL/VARS/V1.Value=6
ç CALL/CTRL/VARS/V1:add(-10)
æ mO/CTRL/VARS/V1:add
æ CHG/CTRL/VARS/V1.Value=-4
Example 4 – subtraction with 'min' value
ç GET/CTRL/VARS/V1.Value
æ pw/CTRL/VARS/V1.Value=14
ç CALL/CTRL/VARS/V1:add(-2;10;20)
æ mO/CTRL/VARS/V1:add
æ CHG/CTRL/VARS/V1.Value=12
ç CALL/CTRL/VARS/V1:add(-2;10;20)
æ mO/CTRL/VARS/V1:add
æ CHG/CTRL/VARS/V1.Value=10
ç CALL/CTRL/VARS/V1:add(-2;10;20)
æ mO/CTRL/VARS/V1:add
æ CHG/CTRL/VARS/V1.Value=10
102