7.LW3Programmer'sReference
HDMI-TPS-TX200series–User'sManual
102
Appliedfirmwarepackage:v1.3.2b3 | LDCsoftware:v2.5.7b2
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.Themaximum lengthofavariablecanbe15charactersandtheyarestoredinanon-volatile
memory,thus,thevalueiskeptincaseofareboot.Thetypeofthevariable(textorstring)isdetermined
automaticallybasedonthevalue.Ifanoperationcannotbeperformed(e.g.addingnumbervaluetoastring-
type variable), error will be the response.
#variables
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
Value
Valuedescription
<loc>
The location of the variable
1-30
<value>
The value of the variable
Custom
Length can be max 15 characters.
Numericvariableisdefinedbetween
-2147483648and2147483647.
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
Value
Valuedescription
<loc>
The location of the variable
1-30
<operand>
The value that is added to the variable
Integer
Negativevalueisalsoaccepted
<min>
The lowest allowed value (optional)
Integer
Negativevalueisalsoaccepted
<max>
Thehighestallowedvalue(optional)
Integer
Negativevalueisalsoaccepted
Ifthevalueofthevariableishigherorequalswith
<max>
, the new value will be
<max>
.Likewise,incaseof
<min>
setting:ifthevalueofthevariableislowerorequalswith
<min>
, the new value will be
<min>
.
Examples
Changemessages(CHG)canbeseenaftereachresponseforthebetterunderstanding,whichisnotthepart
of the command, but it can be set as described in the
section.
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
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